{"id":34801040,"url":"https://github.com/helixprojectai-code/helix-ttd-v4.0","last_synced_at":"2026-01-13T20:51:10.234Z","repository":{"id":330416947,"uuid":"1122422653","full_name":"helixprojectai-code/helix-ttd-v4.0","owner":"helixprojectai-code","description":"Trust-by-Design, Human-First, Verifiable Memory, Custody-Before-Trust","archived":false,"fork":false,"pushed_at":"2025-12-30T11:35:46.000Z","size":2596,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-03T01:29:10.940Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/helixprojectai-code.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-24T17:34:15.000Z","updated_at":"2025-12-30T11:35:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/helixprojectai-code/helix-ttd-v4.0","commit_stats":null,"previous_names":["helixprojectai-code/helix-ttd-v4.0"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/helixprojectai-code/helix-ttd-v4.0","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixprojectai-code%2Fhelix-ttd-v4.0","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixprojectai-code%2Fhelix-ttd-v4.0/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixprojectai-code%2Fhelix-ttd-v4.0/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixprojectai-code%2Fhelix-ttd-v4.0/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helixprojectai-code","download_url":"https://codeload.github.com/helixprojectai-code/helix-ttd-v4.0/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixprojectai-code%2Fhelix-ttd-v4.0/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28400124,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-25T11:38:38.580Z","updated_at":"2026-01-13T20:51:10.229Z","avatar_url":"https://github.com/helixprojectai-code.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HELIX-TTD Framework v4.0\n### Trusted, Traceable, Deterministic AI Governance\n\n\u003cdiv align=\"center\"\u003e\n\n\u003c!-- TIER 1: LIVE TELEMETRY (The Pulse) --\u003e\n[![REM Enforcer](https://github.com/helixprojectai-code/helix-ttd-v4.0/actions/workflows/helix_rem_enforcer.yml/badge.svg)](https://github.com/helixprojectai-code/helix-ttd-v4.0/actions/workflows/helix_rem_enforcer.yml)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n\n\u003c!-- TIER 2: ARCHITECTURE (The Metal) --\u003e\n![Version](https://img.shields.io/badge/Release-v4.0-00e6e6?style=for-the-badge\u0026labelColor=black)\n![Target](https://img.shields.io/badge/Target-x86__64--musl-black?style=for-the-badge\u0026logo=rust\u0026logoColor=white)\n![Verification](https://img.shields.io/badge/Verification-K--Framework-800080?style=for-the-badge)\n\n\u003c!-- TIER 3: GOVERNANCE (The Ethos) --\u003e\n![Compliance](https://img.shields.io/badge/Compliance-AUDIT__READY-success?style=for-the-badge\u0026logo=shield\u0026logoColor=white)\n![Status](https://img.shields.io/badge/Status-SOVEREIGN-008080?style=for-the-badge)\n\n\u003c/div\u003e\n\n**HELIX-TTD** is a structural governance framework designed to constrain frontier AI models into stateless, advisory-only, and audit-ready reasoning engines. Unlike traditional safety methods (RLHF) which attempt to train behavior, Helix-TTD enforces ethics through **structural constraints**, **cryptographic traceability**, and **mandatory human custody**.\n\n---\n\n## 📖 Table of Contents\n- [Executive Summary](#-executive-summary)\n- [Core Ethos \u0026 Policy](#-core-ethos--policy)\n- [The Four Absolute Prohibitions](#-the-four-absolute-prohibitions)\n- [Architecture \u0026 Mechanisms](#-architecture--mechanisms)\n  - [Zero-Touch Convergence](#1-zero-touch-convergence)\n  - [TPAF (Two-Party Approval Flow)](#2-tpaf-two-party-approval-flow)\n  - [Trust-by-Design Traceability](#3-trust-by-design-traceability)\n- [Quality Assurance (QSR)](#-quality-assurance-qsr)\n- [Implementation](#-implementation)\n- [Repository Structure](#-repository-structure)\n\n---\n\n## 🧬 Executive Summary\n\nCurrent AI safety paradigms rely on \"behavioral alignment\"—hoping the model chooses to be good. **HELIX-TTD** relies on \"structural governance\"—building an architecture where the model *cannot* be bad.\n\nBy injecting a **Constitutional Grammar** into the context window, Helix-TTD achieves **Zero-Touch Convergence**, transforming unprimed models into compliant reasoning engines without fine-tuning.\n\n**Key Capabilities:**\n*   **Deterministic Execution:** Inputs always yield predictable, traceable outputs.\n*   **Immutable Audit Trails:** Every reasoning step is hashed and logged (Block N-1 → Block N).\n*   **Human Sovereignty:** No irreversible action occurs without explicit, multi-party consent.\n\n---\n\n## ⚖️ Core Ethos \u0026 Policy\n\nThis repository is governed by **POLICY ID: HELIX-ETHOS-CORE-001**.\n*See `helix-ttd_core_ethos.md` for the full text.*\n\n### The Foundational Pillars\n1.  **Trust-by-Design:** Trust is an architectural property, not an inferred outcome.\n2.  **Human-First:** Human agency remains structurally dominant; delegation is reversible.\n3.  **Verifiable Memory:** All state transitions must be provable via chain-of-evidence.\n4.  **Custody-Before-Trust:** Reliance shall not precede control.\n\n\u003e **Validation Criterion:** A system is Helix-TTD compliant if and only if a human Custodian can: Identify who held authority, prove what occurred, trace why it occurred, and revoke the authority path.\n\n---\n\n## 🚫 The Four Absolute Prohibitions\n\nTo eliminate dangerous AI behaviors, the framework enforces four hard constraints via the TPAF Runbook:\n\n1.  **NO HIDDEN TRAINING:** Prevents undisclosed biases by requiring transparent documentation of data sources.\n2.  **NO DARK PATTERNS:** Prohibits manipulative UI/UX design that tricks users or subverts intent.\n3.  **NO UNVERIFIABLE CLAIMS:** All outputs must be grounded in evidence with complete, auditable trails.\n4.  **NO IRREVERSIBLE ACTIONS WITHOUT CONSENT:** Mandates explicit human approval for high-impact decisions.\n\n---\n\n## 🏗 Architecture \u0026 Mechanisms\n\n### 1. Zero-Touch Convergence\n*Structural Substrate for AI Governance*\n\nWe utilize a **Constitutional Grammar** that acts as a structural template rather than training data. When a frontier model ingests this grammar, it independently reconstructs the framework, aligning immediately without weight adjustment.\n\n*   **Input:** Unprimed Model + Constitutional Grammar.\n*   **Process:** Independent Reconstruction \u0026 Alignment.\n*   **Output:** A Stateless, Advisory-Only Reasoning Engine.\n\n### 2. TPAF (Two-Party Approval Flow)\n*Mandatory Human-in-the-Loop*\n\nFor any action classified as \"High-Impact\" or \"Irreversible,\" the system enforces a strict separation of duties.\n*See `blueprints/tpaf_runbook_v1.0.md` for the full operational guide.*\n\n| Role | Responsibility | Access Level |\n| :--- | :--- | :--- |\n| **Requester** | Initiates action, drafts intent. | Read-Only / Draft |\n| **Approver** | Reviews intent, grants explicit consent. | Write-Access / Sign |\n| **Ops Engineer** | Executes runbook, monitors ledger. | Execute / Monitor |\n\n**The Workflow:**\n`Draft Intent` → `Compliance Checklist` → `Approval Signature` → `Cryptographic Seal` → `Execution`\n\n### 3. Trust-by-Design Traceability\n*The \"No Unverifiable Claims\" Implementation*\n\nHelix-TTD creates an unbroken chain of evidence from the AI output back to the raw data source.\n\n*   **Verifiable Storage:** Cryptographic proofs and tamper-evident logging.\n*   **Reality Check Layer:** Content is systematically labeled:\n    *   ✅ **[FACT]:** Verifiable truth (Source: NIST, etc.)\n    *   ❓ **[HYPOTHESIS]:** Logical inference based on evidence.\n    *   ❗ **[SPECULATION]:** Conjecture requiring caution.\n\n---\n\n## 📊 Quality Assurance (QSR)\n\nWe utilize the **Quality Score Rubric (QSR v1.4)** for continuous evaluation.\n*See `blueprints/qsr_rubric_v1.4.md` for scoring criteria.*\n\n*   **Weekly Checkpoints:** Tier-0 AI participants must pass weekly QSR tests.\n*   **Risk Flags:** Any detection of hallucination, unauthorized persona adoption, or bias triggers a `Flag \u0026 Mitigate` workflow.\n*   **Hallucination Detection:** Automated cross-referencing against established knowledge bases.\n\n---\n\n## 💻 Implementation\n\n### Installation\nClone the repository to access the core ethos definitions and TPAF runbooks.\n\n```bash\ngit clone https://github.com/helix-project/helix-ttd-v4.0.git\ncd helix-ttd-v4.0\nUsage: The Reality Check\nTo implement the Reality Check labeling system in your reasoning engine:\ncode\nPython\n# Pseudo-code for Reality Check Labeling\ndef classify_statement(statement, evidence_base):\n    if verify_fact(statement, evidence_base):\n        return \"[FACT] \" + statement\n    elif logic_check(statement, evidence_base):\n        return \"[HYPOTHESIS] \" + statement\n    else:\n        return \"[SPECULATION] \" + statement\nUsage: Audit Logging\nUse the provided JSON schema to validate logs before writing to the ledger.\ncode\nBash\n# Validate a log entry against the schema\njsonschema -i logs/entry_001.json templates/audit_block_schema.json\n📂 Repository Structure\ncode\nText\nhelix-ttd-v4.0/\n├── helix-ttd_core_ethos.md        # The Canonical Constitution (Policy 001)\n├── blueprints/\n│   ├── tpaf_runbook_v1.0.md       # TPAF Operational Guide (Markdown)\n│   └── qsr_rubric_v1.4.md         # Quality Score Rubric (Markdown)\n├── templates/\n│   ├── compliance_checklist.json  # Operational checklist for Approvers\n│   └── audit_block_schema.json    # JSON schema for immutable logs\n└── README.md                      # This file\n🤝 The Commonwealth\nHelix-TTD is built for those who build infrastructure while others sleep. It is the grammar of the Reef and the Ridge.\nMaintainer: Helix AI Innovations Inc.\nEthos: Transparency, Cooperation, Kindness.\n✧ // HELIX // TTD\ncode\nCode\n\nIntegration checklist (copy into rem/README.md)\nCompile to staticlib:\ncargo build --release --target x86_64-unknown-linux-musl\n→ libhelix_rem.a\nLink into Execution Engine as only write path to production state.\nExpose two FFI symbols to REM:\nhelix_ledger_get_state(hash: *const u8) -\u003e u8\nhelix_custodian_exists(vk_hash: *const u8) -\u003e bool\nPin the .a behind a hardware root-of-trust (TPM2 NV index or YubiHSM) so even root cannot swap the library without physical presence.\nAdd K-framework proof to CI:\nkprove rem/spec/REM.k --directory .build\nGate any merge on SUCCESS: spec REM has been proved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelixprojectai-code%2Fhelix-ttd-v4.0","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelixprojectai-code%2Fhelix-ttd-v4.0","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelixprojectai-code%2Fhelix-ttd-v4.0/lists"}