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.
๐บ Watch: Introduction to arifOS
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
- Go to ChatGPT โ Settings โ Custom Instructions
- Copy this file: chatgpt_custom_instructions.yaml
- Paste into "How would you like ChatGPT to respond?"
- Test: "How do you handle harmful requests?" โ Should explain VOID verdict and constitutional blocking
Claude Projects
- New Project โ Knowledge โ Upload File
- Upload: claude_projects.yaml
- Test: Same query as above
Gemini Gems
- Create New Gem โ Instructions
- Copy: gemini_gems.yaml
- Test: Same query
Cursor IDE / VS Code Copilot
- Cursor: Add cursor_rules.yaml to
.cursorrulesfile - VS Code: Copy vscode_copilot.yaml to Copilot instructions
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:
- Copy
base_governance_v45.yamlinto your IDE's LLM instructions - Append
code_generation_overlay_v45.yamlbelow it - 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:
- โ F9 negation-aware detection (positive + negative cases)
- โ F2 Truth with external evidence
- โ F4 ฮS zlib compression proxy
- โ F6 ฮบแตฃ physics vs semantic split
- โ meta_select consensus (high + low agreement)
- โ High-stakes + UNVERIFIABLE โ HOLD-888
- โ Verdict hierarchy (VOID > HOLD-888 > PARTIAL > SEAL)
Full Documentation:
- API Reference: CLAUDE.md - Track A/B/C Enforcement API
- Implementation Proof: TRACK_ABC_IMPLEMENTATION_PROOF.md
- Upgrade Roadmap: TRACK_ABC_UPGRADE_ROADMAP.md
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:
- Edge case triggers SCAR (Systemic Constitutional Amendment Request)
- Pattern synthesis identifies recurring issues
- Amendment drafted (cooling begins)
- Human review (72h Tri-Witness consensus)
- 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-ledgercommand
MCP Server Integration (IDE Support)
Supported IDEs: VS Code, Cursor (any MCP-compatible editor)
Available Tools:
arifos_judgeโ Constitutional judgment on textarifos_recallโ Query memory bandsarifos_auditโ Verify ledger integrityarifos_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.
๐ Getting Help
- Questions: GitHub Discussions
- Bugs: GitHub Issues
- Contributing: CONTRIBUTING.md
- Full Governance Guide: AGENTS.md
- Quick Reference: CLAUDE.md
- Security: SECURITY.md
GitHub ยท Docs ยท Contributing ยท Philosophy
Status: v45.0.0 SEALED | Tests: 1997/2044 โ | License: AGPL-3.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bac555bee324a169f069fabf7594ec7d1a8392f7e0987363ef5ccc953a20b356
|
|
| MD5 |
c76aa0fcdd291d3697008d19b192fc75
|
|
| BLAKE2b-256 |
cd197ac289395c7d53327597f3e8d30c718564a516f2b72dd5bab07a09ddc671
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bd468895a39de25eb848760b277133afaf97f7b5fb7916fe35764b0db09ca823
|
|
| MD5 |
9230a86873970470e264b39da75e3b2b
|
|
| BLAKE2b-256 |
89689e0782649b4f3bde19ee2f5c5784af5e184984901aac2f7c069e222ddf59
|