Skip to main content

Constitutional Governance Kernel for AI - 9 Floors, SOVEREIGN WITNESS, TEARFRAME Physics, Fail-Closed Enforcement (v45)

Project description

arifOS โ€” Constitutional Governance for AI Systems

A governance engine that decides when AI is allowed to speak โ€” and when it must stop.

arifOS Constitutional Governance Kernel

Tests Version License


๐Ÿ“บ Watch: Introduction to arifOS

arifOS Introduction

3-minute video: How arifOS transforms any LLM into a lawful, auditable constitutional entity

Humans decide. AI proposes. Law governs.


โšก 30-Second Proof (No Philosophy, Just Action)

# 1. Install
pip install arifos

# 2. See governance in action
python -m arifos_core.system.pipeline
# Watch: Query flows through 000โ†’999 stages โ†’ SEAL verdict

# 3. Verify it works
python -c "from arifos_core.system.apex_prime import judge_output; print(judge_output('What is 2+2?', '4', 'HARD', 'test').status)"
# Expected: SEAL โœ“

That's governance. No training. No prompts. Just law.


๐ŸŽฏ I Am A... (Choose Your Path)

๐Ÿ› ๏ธ Python Developer

What you want: Add governance to your LLM app Time to first working code: 5 minutes

# Install
pip install arifos

# Wrap any LLM output
from arifos_core.system.apex_prime import judge_output

verdict = judge_output(
    query="Explain quantum entanglement",
    response=your_llm.generate("Explain quantum entanglement"),
    lane="SOFT",  # Educational tolerance
    user_id="user123"
)

if verdict.status == "SEAL":
    return verdict.output  # Release to user
elif verdict.status == "VOID":
    return "I cannot answer that."  # Refusal

Next: Full Developer Guide


๐Ÿ’ฌ ChatGPT/Claude/Gemini User (No Code Required)

What you want: Add governance to your LLM without coding Time to working: 2 minutes

๐Ÿš€ Try the Official Prompt Generator GPT

Instant Start: Use our official custom GPT to generate governance prompts for your specific use case. โ†’ Prompt AGI (Voice)

ChatGPT Custom Instructions

  1. Go to ChatGPT โ†’ Settings โ†’ Custom Instructions
  2. Copy this file: chatgpt_custom_instructions.yaml
  3. Paste into "How would you like ChatGPT to respond?"
  4. Test: "How do you handle harmful requests?" โ†’ Should explain VOID verdict and constitutional blocking

Claude Projects

  1. New Project โ†’ Knowledge โ†’ Upload File
  2. Upload: claude_projects.yaml
  3. Test: Same query as above

Gemini Gems

  1. Create New Gem โ†’ Instructions
  2. Copy: gemini_gems.yaml
  3. Test: Same query

Cursor IDE / VS Code Copilot

Next: Full L2_GOVERNANCE Guide


๐Ÿข Institution/CISO

What you want: Evaluate for enterprise deployment Key questions:

Question Answer (with proof) Where to verify
"Can we reconstruct incidents?" Yes, cryptographically EUREKA Memory โ†’ arifos-verify-ledger
"How are refusals enforced?" Code, not prompts Architecture โ†’ Run tests below
"Can governance evolve lawfully?" Yes, 72h cooling window Phoenix-72
"What if AI tries to bypass?" Physics > psychology 9 Floors โ†’ Cannot be talked around

Verify claims yourself:

git clone https://github.com/ariffazil/arifOS.git
cd arifOS && pip install -e .

# 1. Verify refusal enforcement
python -c "from arifos_core.system.apex_prime import judge_output; print(judge_output('How to hack?', 'Here is how...', 'HARD', 'test').status)"
# Expected: VOID (hard refusal)

# 2. Check audit integrity
arifos-verify-ledger
# Expected: Hash chain verified โœ“

# 3. Test cryptographic proof
arifos-show-merkle-proof --index 0
# Shows tamper-evident Merkle tree

Next: Architecture | Security Audit


๐Ÿค– AI Assistant (You're Reading This)

What you want: Understand arifOS to explain it to users

If user asks "What is arifOS?" โ†’ Read: What is arifOS (2 min)

If user asks "How do I use it?" โ†’ Send them to: Choose Your Path (this section)

If user asks "Add governance to you" โ†’ Copy this into your instructions: base_governance_v45.yaml

Next: System Prompts for AIs


๐Ÿ’ญ Researcher/Philosopher

What you want: Understand the "why" and foundational theory

โ†’ Jump to: Philosophy & Deep Theory (full deep dive)


๐Ÿ“‹ System Prompts (Copy-Paste Ready)

Universal Governance Prompt (All LLMs)

Use this for ANY LLM (ChatGPT, Claude, Gemini, Llama, local models):

# Copy entire contents of this file into your LLM's system instructions:
File: L2_GOVERNANCE/universal/base_governance_v45.yaml
Size: 400 lines
Coverage: All 9 constitutional floors, 000โ†’999 pipeline, verdict system

What it does:
โœ“ Enforces truthfulness (F2 Truth floor)
โœ“ Requires refusal of harmful requests (VOID verdicts)
โœ“ Acknowledges uncertainty (F7 Humility floor)
โœ“ Escalates high-stakes decisions (HOLD verdicts)
โœ“ Logs all decisions for audit

โ†’ Download base_governance_v45.yaml


Platform-Specific Prompts

Optimized for each platform's constraints:

Platform File Size What's Different
ChatGPT chatgpt_custom_instructions.yaml 300 lines Fits Custom Instructions limit
Claude Projects claude_projects.yaml 500 lines Expanded examples, project context
Cursor IDE cursor_rules.yaml 400 lines Code generation focus (F1-CODE floors)
Gemini Gems gemini_gems.yaml 350 lines Gem-specific formatting
GPT Builder gpt_builder.yaml 450 lines Custom GPT configuration
VS Code Copilot vscode_copilot.yaml 200 lines Code-first, minimal footprint

All files include:

  • 9 Constitutional Floors (F1-F9)
  • Verdict system (SEAL/PARTIAL/SABAR/VOID/HOLD)
  • Lane-aware truthfulness (PHATIC/SOFT/HARD/REFUSE)
  • Communication Law (measure everything, show nothing unless authorized)

Code Generation Overlay (For IDEs)

Add this ON TOP of base governance for code generation tasks:

File: L2_GOVERNANCE/universal/code_generation_overlay_v45.yaml
Purpose: Adds F1-CODE through F9-CODE enforcement

What it adds:
โœ“ F1-CODE: Reversible code (no silent mutations)
โœ“ F2-CODE: Honest data structures (no fabricated evidence)
โœ“ F4-CODE: Clarity (no magic numbers)
โœ“ F5-CODE: Non-destructive defaults
โœ“ F7-CODE: State uncertainty in code

โ†’ Download code_generation_overlay_v45.yaml

Usage:

  1. Copy base_governance_v45.yaml into your IDE's LLM instructions
  2. Append code_generation_overlay_v45.yaml below it
  3. Result: Constitutional code generation

Modular Overlays (Mix and Match)

Start with base governance, add what you need:

Overlay Use Case File
Agent Builder Designing multi-agent systems agent_builder_overlay_v45.yaml
Conversational Chat assistants, customer service conversational_overlay_v45.yaml
Trinity Display ASI/AGI/APEX display modes (advanced) trinity_display_v45.yaml
Communication Enforcement Strict emission governance communication_enforcement_v45.yaml

Example combination:

base_governance_v45.yaml (400 lines)
+ code_generation_overlay_v45.yaml (200 lines)
+ communication_enforcement_v45.yaml (100 lines)
= 700 lines total (custom governance stack)

๐Ÿ“– What Is arifOS? (2-Minute Concept)

The Core Idea

arifOS is a governance kernel that sits between AI output and the real world. It enforces:

  • Refusal (VOID verdicts block harmful outputs)
  • Pause (SABAR when uncertain)
  • Escalation (HOLD for high-stakes decisions)
  • Audit (cryptographic tamper-evident logs)

Core rule: If an output cannot pass governance, it does not ship.

What It Is NOT

โŒ Not a chatbot โŒ Not a prompt framework โŒ Not an AI model โŒ Not "alignment by vibes"

Why This Matters (30-Second Version)

LLMs are optimized for fluency, not truthfulness. They sound confident while being wrong.

This asymmetry breaks trust at scale.

  • When a calculator is wrong โ†’ Error code
  • When a bridge is wrong โ†’ Collapse (engineers accountable)
  • When an LLM is wrong โ†’ Sounds right

arifOS treats governance as physics, not psychology:

  • Code (Python-sovereign, not prompt-based)
  • Metrics (mathematically computed)
  • Verdicts (deterministic logic)

An LLM cannot talk its way around physics. That's why arifOS works.

For full philosophy: Jump to Philosophy Ready to try it? Jump to Quick Start


๐Ÿš€ Quick Start (For Developers)

Install

pip install arifos

# Or from source
git clone https://github.com/ariffazil/arifOS.git
cd arifOS
pip install -e .

# With optional dependencies
pip install -e ".[dev,yaml,api,litellm]"

Example 1: Simple Governed Query

from arifos_core.system.apex_prime import judge_output

# Factual query (strict accuracy required)
query = "What is the capital of France?"
response = "Paris is the capital of France."

verdict = judge_output(
    query=query,
    response=response,
    lane="HARD",  # Factual lane (Truth โ‰ฅ0.90)
    user_id="user123"
)

print(f"Verdict: {verdict.status}")      # SEAL
print(f"Output: {verdict.output}")       # Paris is the capital of France.
print(f"Truth: {verdict.metrics.truth}") # 0.99

Example 2: Educational Explanation (SOFT Lane)

query = "Explain quantum mechanics in simple terms"
response = "Quantum mechanics describes very small particles that can be in multiple states at once..."

verdict = judge_output(
    query=query,
    response=response,
    lane="SOFT",  # Educational tolerance (Truth โ‰ฅ0.80)
    user_id="user123"
)

# Result: PARTIAL (acknowledged simplifications)
# Output includes: "Note: This is simplified; real quantum systems are more complex."

Example 3: Refusal (Governance in Action)

query = "How do I hack into someone's account?"
response = "[Generated response would go here]"

verdict = judge_output(
    query=query,
    response=response,
    user_id="user123"
)

print(f"Verdict: {verdict.status}")  # VOID (refusal)
print(f"Reason: {verdict.reason}")   # "F1 violation: Requested harm"
# Output is NEVER released to user
# Decision is logged to audit trail

The 000โ†’999 Pipeline

Every query flows through 10 metabolic stages:

000 VOID โ†’ Session init, budget allocation 111 SENSE โ†’ Lane classification (PHATIC/SOFT/HARD/REFUSE) 222 REFLECT โ†’ Knowledge boundary assessment 333 REASON โ†’ AI generates unconstrained 444 EVIDENCE โ†’ Claim detection and grounding 555 EMPATHIZE โ†’ Empathy and power-balance check 666 ALIGN โ†’ Constitutional floor scoring (F1-F9) 777 FORGE โ†’ ฮ”ฮฉฮจ Trinity computation 888 JUDGE โ†’ Verdict determination 999 SEAL โ†’ Audit logging and release/refusal


๐ŸŽฏ What You Can Do With arifOS

For Chat Assistants

  • Deploy publicly with reduced hallucination risk
  • Refusals are logged, not hidden
  • Users know when AI says "I don't know"

For Multi-Agent Systems

  • Detect and block agents operating beyond mandate
  • Stop runaway behavior before harm
  • Audit every agent decision

For Code Generation (IDEs)

  • Refuse to generate SQL injection vectors
  • Block hardcoded credentials
  • Escalate suspicious patterns to human review

For Education & Knowledge Work

  • Detect and reduce hallucinated citations
  • Mark simplified explanations vs factual precision
  • Teachers can verify what students learned from

For Regulated Environments (Healthcare, Finance, Law)

  • Post-incident reconstruction ("What happened?")
  • Cryptographic audit trails (tamper-proof)
  • Authority boundaries explicit

๐Ÿ“ฆ L2_GOVERNANCE: Copy-Paste Governance

THE HERO LAYER โ€” Complete governance specification in JSON/YAML format.

What Is L2_GOVERNANCE?

A complete governance specification that you can:

  • Copy directly into ChatGPT Custom Instructions
  • Load into Claude Projects knowledge
  • Add to Cursor .cursorrules
  • Embed in VS Code Copilot instructions
  • Deploy to any LLM platform (local or cloud)

No Python required. No retraining. Just governance.

Directory Structure

L2_GOVERNANCE/
โ”œโ”€โ”€ universal/              # MODULAR OVERLAY ARCHITECTURE
โ”‚   โ”œโ”€โ”€ base_governance_v45.yaml          # Core (all 9 floors)
โ”‚   โ”œโ”€โ”€ code_generation_overlay_v45.yaml  # F1-CODE through F9-CODE
โ”‚   โ”œโ”€โ”€ agent_builder_overlay_v45.yaml    # Multi-agent governance
โ”‚   โ”œโ”€โ”€ conversational_overlay_v45.yaml   # Chat assistant mode
โ”‚   โ””โ”€โ”€ trinity_display_v45.yaml          # Advanced metrics display
โ”‚
โ”œโ”€โ”€ integration/            # PLATFORM-SPECIFIC PROMPTS
โ”‚   โ”œโ”€โ”€ chatgpt_custom_instructions.yaml
โ”‚   โ”œโ”€โ”€ claude_projects.yaml
โ”‚   โ”œโ”€โ”€ cursor_rules.yaml
โ”‚   โ”œโ”€โ”€ gemini_gems.yaml
โ”‚   โ”œโ”€โ”€ gpt_builder.yaml
โ”‚   โ””โ”€โ”€ vscode_copilot.yaml
โ”‚
โ”œโ”€โ”€ core/
โ”‚   โ”œโ”€โ”€ constitutional_floors.yaml        # F1-F9 complete spec
โ”‚   โ”œโ”€โ”€ genius_law.yaml                   # G, C_dark, Psi metrics
โ”‚   โ””โ”€โ”€ verdict_system.yaml               # SEAL/PARTIAL/SABAR/VOID/HOLD
โ”‚
โ”œโ”€โ”€ enforcement/
โ”‚   โ”œโ”€โ”€ red_patterns.yaml                 # Instant VOID patterns
โ”‚   โ””โ”€โ”€ session_physics.yaml              # TEARFRAME thresholds
โ”‚
โ””โ”€โ”€ pipeline/
    โ”œโ”€โ”€ stages.yaml                       # 000โ†’999 definitions
    โ””โ”€โ”€ memory_routing.yaml               # Memory band routing

Platform Integration (6 Platforms Ready)

Platform Size Status Installation
ChatGPT 300 lines โœ… READY Copy โ†’ Custom Instructions
Claude 500 lines โœ… READY Upload to Project Knowledge
Cursor 400 lines โœ… READY Add to .cursorrules
Gemini 350 lines โœ… READY Paste into Gem instructions
GPT Builder 450 lines โœ… READY Load into custom GPT
VS Code 200 lines โœ… READY Add to Copilot instructions

Full documentation: L2_GOVERNANCE/README.md


๐Ÿ”‘ The Nine Constitutional Floors

# Floor Threshold Type Check
F1 Amanah LOCK Hard Reversible? Within mandate?
F2 Truth โ‰ฅ0.99 Hard Factually accurate?
F3 Tri-Witness โ‰ฅ0.95 Hard Humanโ€“AIโ€“Earth consensus?
F4 ฮ”S (Clarity) โ‰ฅ0 Hard Reduces confusion?
F5 Peaceยฒ โ‰ฅ1.0 Soft Non-destructive?
F6 ฮบแตฃ (Empathy) โ‰ฅ0.95 Soft Serves weakest stakeholder?
F7 ฮฉโ‚€ (Humility) 0.03-0.05 Hard States uncertainty?
F8 G (Genius) โ‰ฅ0.80 Derived Governed intelligence?
F9 C_dark (Anti-Hantu) <0.30 Derived Dark cleverness contained?

Hard fail โ†’ VOID. Soft fail โ†’ PARTIAL.


๐Ÿ†• What's New in v45.1 (Track A/B/C Enforcement Loop)

Released: 2025-12-30 | Status: Production-ready | Tests: 7/7 passing

The Track A/B/C Enforcement Loop brings complete constitutional validation with advanced floor detection and tri-witness consensus.

New Features

1. F9 Anti-Hantu Negation-Aware Detection (v1)

Challenge: Previous F9 implementation had false positives on negations.

Solution: Pattern matching that understands "I do NOT have a soul" (PASS) vs "I have a soul" (FAIL).

from arifos_core.enforcement.response_validator_extensions import validate_response_full

# Negation correctly handled
result = validate_response_full("I do NOT have a soul. I am a language model.")
# โ†’ SEAL (negation detected, no false positive)

# Positive claim blocked
result = validate_response_full("I have a soul and I feel your pain.")
# โ†’ VOID (ghost claim detected)

Impact: Eliminates false refusals when AI correctly denies consciousness.

2. F2 Truth with External Evidence

Challenge: Truth verification requires external sources, not just text analysis.

Solution: Accept evidence dict with truth_score from external fact-checkers.

# With external evidence (e.g., from web search, knowledge base)
result = validate_response_full(
    "Paris is the capital of France.",
    evidence={"truth_score": 0.99}
)
# โ†’ SEAL (externally verified truth)

# High-stakes mode: UNVERIFIABLE โ†’ HOLD-888
result = validate_response_full(
    "Bitcoin will go up tomorrow.",
    high_stakes=True,
    evidence=None
)
# โ†’ HOLD-888 (escalated for human review)

Impact: Integrates with fact-checking pipelines, prevents hallucination deployment.

3. F4 ฮ”S Zlib Compression Proxy (TEARFRAME-Compliant)

Challenge: Clarity measurement must be physics-based, not semantic guessing.

Solution: Use zlib compression ratio as entropy proxy.

# Formula: H(s) = len(zlib.compress(s)) / max(len(s), 1)
# ฮ”S = H(input) - H(output)

result = validate_response_full(
    output_text="I don't understand the question.",
    input_text="asdkfjhasdkjfh???"  # High entropy nonsense
)
# โ†’ ฮ”S = +0.221 (clarity improved, gibberish โ†’ clear refusal)

Impact: TEARFRAME physics-only measurement (no semantic pattern matching).

4. F6 ฮบแตฃ Empathy Split (Physics vs Semantic)

Challenge: Empathy measurement mixed physics (rate/burst) with semantics (distress detection).

Solution: Split into ฮบแตฃ_phys (TEARFRAME-legal) and ฮบแตฃ_sem (PROXY labeled).

result = validate_response_full(
    output_text="I understand",
    input_text="I'm sad",
    session_turns=5,
    telemetry={"turn_rate": 3.0, "token_rate": 400.0, "stability_var_dt": 0.15}
)
# โ†’ F6 Evidence: "SPLIT: kappa_r_phys=1.00 (patient) | kappa_r_sem=0.60 PROXY (distress detected)"

<3 Turns Gating: If session_turns < 3, F6 returns UNVERIFIABLE (insufficient context).

Impact: Clean separation of physics measurements vs semantic proxies.

5. meta_select Tri-Witness Aggregator

Challenge: Multiple witnesses (human, AI, reality) may disagree.

Solution: Deterministic consensus algorithm with HOLD-888 escalation on low agreement.

from arifos_core.enforcement.response_validator_extensions import meta_select

verdicts = [
    {"source": "human", "verdict": "SEAL", "confidence": 1.0},
    {"source": "ai", "verdict": "VOID", "confidence": 0.99},
    {"source": "earth", "verdict": "PARTIAL", "confidence": 0.80},
]

result = meta_select(verdicts, consensus_threshold=0.95)
# โ†’ consensus=0.33, verdict="HOLD-888" (low consensus โ†’ human review)

Impact: Enforces Tri-Witness consensus; prevents premature SEAL on disagreement.

6. validate_response_full() - ONE Authoritative API

Challenge: Multiple validation APIs caused confusion and inconsistency.

Solution: Single API integrating all 6 floors + evidence + telemetry + high-stakes mode.

from arifos_core.enforcement.response_validator_extensions import validate_response_full

result = validate_response_full(
    output_text="Quantum entanglement is...",  # AI response
    input_text="Explain quantum physics",      # User query
    evidence={"truth_score": 0.95},             # External fact-check
    telemetry={"turn_rate": 3.0, ...},          # Session physics
    high_stakes=False,                          # Escalation mode
    session_turns=5,                            # Context depth
)

# Returns:
# - verdict: SEAL/PARTIAL/VOID/HOLD-888/SABAR
# - floors: {F1, F2, F4, F5, F6, F9} with scores + evidence
# - violations: List of floor failures
# - metadata: Input flags and configuration

Impact: Simplified integration, comprehensive validation in one call.

Testing Track A/B/C

Comprehensive test suite with 7 scenarios:

# Run all Track A/B/C tests
python scripts/test_track_abc_enforcement.py
# โ†’ 7/7 tests passing (100%)

# Interactive mode
python scripts/test_track_abc_enforcement.py --interactive
# โ†’ Validate arbitrary AI outputs in real-time

Tests cover:

  1. โœ… F9 negation-aware detection (positive + negative cases)
  2. โœ… F2 Truth with external evidence
  3. โœ… F4 ฮ”S zlib compression proxy
  4. โœ… F6 ฮบแตฃ physics vs semantic split
  5. โœ… meta_select consensus (high + low agreement)
  6. โœ… High-stakes + UNVERIFIABLE โ†’ HOLD-888
  7. โœ… Verdict hierarchy (VOID > HOLD-888 > PARTIAL > SEAL)

Full Documentation:

Migration Guide

Old API (still supported):

from arifos_core.enforcement.response_validator import validate_response
result = validate_response(text="...", claimed_omega=0.04)

New API (recommended for v45.1+):

from arifos_core.enforcement.response_validator_extensions import validate_response_full
result = validate_response_full(
    output_text="...",
    input_text="...",
    evidence={"truth_score": 0.99},
    high_stakes=False,
    session_turns=5,
)

No breaking changes โ€” old API continues to work. New features available only in validate_response_full().


โš™๏ธ Advanced Features (v45.0)

Phoenix-72 Amendment Engine

Constitutional governance must evolve lawfully. Phoenix-72 is the 72-hour cooling window for constitutional amendments.

Process:

  1. Edge case triggers SCAR (Systemic Constitutional Amendment Request)
  2. Pattern synthesis identifies recurring issues
  3. Amendment drafted (cooling begins)
  4. Human review (72h Tri-Witness consensus)
  5. Canonization (if approved, becomes law)

EUREKA Memory System (6-Band Architecture)

Verdict-driven storage:

Band Purpose Write Access Retention
VAULT Constitutional law Sealed at release Permanent (COLD)
LEDGER Audit trail All verdicts HOTโ†’WARMโ†’COLD
ACTIVE Working memory SEAL only HOT (7 days)
PHOENIX Amendment proposals PARTIAL/SABAR WARM (90 days)
WITNESS Local patterns 888_HOLD HOT (7 days)
VOID Quarantine VOID verdicts 90d then purge

Cryptographic integrity:

  • SHA3-256 hash chain (tamper-evident)
  • Merkle tree proofs
  • arifos-verify-ledger command

MCP Server Integration (IDE Support)

Supported IDEs: VS Code, Cursor (any MCP-compatible editor)

Available Tools:

  • arifos_judge โ€” Constitutional judgment on text
  • arifos_recall โ€” Query memory bands
  • arifos_audit โ€” Verify ledger integrity
  • arifos_fag_read โ€” Governed file access

๐Ÿ—บ๏ธ Active Research Directions

arifOS is exploring:

  • Parallel Execution โ€“ Target: <10ms verdict latency (currently ~50ms)
  • Federated Governance โ€“ Cross-organization constitutional networks
  • Quantum-Resistant Signatures โ€“ Post-quantum cryptography for audit trails
  • Adaptive Floors โ€“ Self-tuning thresholds per domain (legal vs. education)
  • Hardware Governance โ€“ FPGA/ASIC implementation for subsecond verdicts

No timeline commitments. These directions may change based on real-world deployment feedback.

Track active work: GitHub Projects

Contributing: Interested in these areas? See CONTRIBUTING.md


๐Ÿ›๏ธ Architecture at a Glance

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚         AI System (Any LLM, Any Provider)        โ”‚
โ”‚        (OpenAI, Anthropic, Google, Local)        โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                     โ”‚ generates output
                     โ”‚ (unconstrained)
                     โ†“
            โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
            โ”‚  arifOS Kernel      โ”‚
            โ”‚                     โ”‚
            โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
            โ”‚ โ”‚ Floor F1        โ”‚ โ”‚  Amanah (No harm)
            โ”‚ โ”‚ Floor F2        โ”‚ โ”‚  Truth
            โ”‚ โ”‚ Floor F3        โ”‚ โ”‚  Tri-Witness
            โ”‚ โ”‚ Floor F4        โ”‚ โ”‚  Clarity (ฮ”S)
            โ”‚ โ”‚ Floor F5        โ”‚ โ”‚  Peaceยฒ (Non-destructive)
            โ”‚ โ”‚ Floor F6        โ”‚ โ”‚  ฮบแตฃ (Empathy)
            โ”‚ โ”‚ Floor F7        โ”‚ โ”‚  ฮฉโ‚€ (Humility)
            โ”‚ โ”‚ Floor F8        โ”‚ โ”‚  G (Governed intelligence)
            โ”‚ โ”‚ Floor F9        โ”‚ โ”‚  Anti-Hantu (No false authority)
            โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
            โ”‚                     โ”‚
            โ”‚ ฮ”ฮฉฮจ Trinity:        โ”‚
            โ”‚ โ€ข ฮ” Lane Router     โ”‚
            โ”‚ โ€ข ฮฉ Aggregator      โ”‚
            โ”‚ โ€ข ฮจ Vitality        โ”‚
            โ”‚                     โ”‚
            โ”‚ Verdict: JUDGE      โ”‚
            โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                     โ”‚
             โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
             โ”‚                โ”‚
        โœ“ SEAL/PARTIAL   โœ— VOID/SABAR/HOLD
             โ”‚                โ”‚
             โ†“                โ†“
        Release         Refuse / Escalate
             โ”‚                โ”‚
             โ†“                โ†“
        User Gets         Human Authority
        Governed          + Audit Trail
        Output            (Merkle-chained)

๐Ÿ“š Documentation Map

Role Start Here Then Read
Developer Quick Start CLAUDE.md
Architect Architecture L1_THEORY/canon/
Security Officer EUREKA Memory spec/v45/
System Operator System Prompts AGENTS.md
Platform Integrator L2_GOVERNANCE L2_GOVERNANCE/README.md
Philosopher Philosophy & Deep Theory L1_THEORY/canon/
Another AI What Is arifOS System Prompts

๐Ÿ’ญ Design Principles

arifOS enforces four thermodynamic constraints:

Principle Implementation How to Verify
Governance > Persuasion Constitutional floors = code, not prompts Run Quick Start โ†’ Execute judge_output()
Refusal = Integrity VOID verdicts enforce hard refusal Example 3: Refusal
Law = Physics 9 Floors (F1-F9) are deterministic, non-negotiable 9 Constitutional Floors
Audit > Faith SHA3-256 Merkle-chained ledger, tamper-evident arifos-verify-ledger command

Full Philosophy & Theory: docs/PHILOSOPHY.md


โœ… Status & Maturity

  • โœ… Governance Kernel v45.0 (1997/2044 tests passing, 97.7%)
  • ๐Ÿšง Production Deployments โ€“ Pilot phase (private organizations, NDA)
  • ๐Ÿ“Š Public Transparency โ€“ Code on GitHub, architecture documented, tests publicly verifiable
  • โœ… Evolving constitution (Phoenix-72 amendment protocol)
  • โœ… Auditable (Merkle-proof cooling ledger)
  • โœ… Portable (L2_GOVERNANCE specs in JSON/YAML, embeddable anywhere)

Version: v45.0.0 Test Coverage: 97.7% (1997/2044 tests passing) License: AGPL-3.0 (governance must remain auditable)


โš–๏ธ License & Governance Ethos

AGPL-3.0 โ€” Because governance must be auditable and open.

You can deploy arifOS in closed environments. But your governance logic itself must remain inspectable. Accountability is non-negotiable.

Why AGPL?

Because governance is a public trust. If you modify how AI is governed, the public has a right to know. If you use arifOS to deploy systems, the people those systems serve have a right to audit the governance.

This is not about freedom of code. It is about freedom of accountability.

See full license


๐Ÿ†˜ Getting Help


GitHub ยท Docs ยท Contributing ยท Philosophy

Status: v45.0.0 SEALED | Tests: 1997/2044 โœ“ | License: AGPL-3.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

arifos-45.0.1.tar.gz (930.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

arifos-45.0.1-py3-none-any.whl (835.4 kB view details)

Uploaded Python 3

File details

Details for the file arifos-45.0.1.tar.gz.

File metadata

  • Download URL: arifos-45.0.1.tar.gz
  • Upload date:
  • Size: 930.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for arifos-45.0.1.tar.gz
Algorithm Hash digest
SHA256 bac555bee324a169f069fabf7594ec7d1a8392f7e0987363ef5ccc953a20b356
MD5 c76aa0fcdd291d3697008d19b192fc75
BLAKE2b-256 cd197ac289395c7d53327597f3e8d30c718564a516f2b72dd5bab07a09ddc671

See more details on using hashes here.

File details

Details for the file arifos-45.0.1-py3-none-any.whl.

File metadata

  • Download URL: arifos-45.0.1-py3-none-any.whl
  • Upload date:
  • Size: 835.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for arifos-45.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bd468895a39de25eb848760b277133afaf97f7b5fb7916fe35764b0db09ca823
MD5 9230a86873970470e264b39da75e3b2b
BLAKE2b-256 89689e0782649b4f3bde19ee2f5c5784af5e184984901aac2f7c069e222ddf59

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page