{"id":50592314,"url":"https://github.com/hummbl-dev/krineia","last_synced_at":"2026-06-05T11:30:18.080Z","repository":{"id":357685960,"uuid":"1222038586","full_name":"hummbl-dev/krineia","owner":"hummbl-dev","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-13T20:44:05.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-13T22:31:27.408Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/hummbl-dev.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},"funding":{"github":"hummbl-dev"}},"created_at":"2026-04-27T01:37:04.000Z","updated_at":"2026-05-13T20:44:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hummbl-dev/krineia","commit_stats":null,"previous_names":["hummbl-dev/krineia"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/hummbl-dev/krineia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fkrineia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fkrineia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fkrineia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fkrineia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hummbl-dev","download_url":"https://codeload.github.com/hummbl-dev/krineia/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fkrineia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33939225,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2026-06-05T11:30:17.045Z","updated_at":"2026-06-05T11:30:18.075Z","avatar_url":"https://github.com/hummbl-dev.png","language":"Python","funding_links":["https://github.com/sponsors/hummbl-dev"],"categories":[],"sub_categories":[],"readme":"# KRINEIA\n\n*An open standard for append-only governance receipts. Maintained by [HUMMBL Research Institute](https://hummbl.io). Formerly \"Verum\" — renamed 2026-05-13 per namespace audit.*\n\n\u003e **KRINEIA** (Greek: κρινεία — judgment, discernment) — cryptographically chained, post-mortem-only governance receipts. Proves that a decision happened, by whom, in what state, with what deviation from setpoint. Agents may **read** the chain for coordination, but chain contents NEVER feed back into any agent's reward, gradient, or policy-update path.\n\n## What's in this repo\n\n| File | Status | Purpose |\n|---|---|---|\n| [`INVARIANTS.md`](INVARIANTS.md) | v1.0-rc2 | Five governing invariants for KRINEIA receipt chains |\n| [`OPERATOR_SEMANTICS.md`](OPERATOR_SEMANTICS.md) | v0.1 | Interpretive layer mapping `append`/`project`/`cut` to *krinein* modes |\n| [`RECEIPT_SCHEMA.md`](RECEIPT_SCHEMA.md) | v0.1 | Canonical schema for receipts emitted by KRINEIA and consumed by `krineia-mcp` |\n| [`QUEUE_ARCHITECTURE.md`](QUEUE_ARCHITECTURE.md) | v0.1 | Architecture for the topic-research queue that produces canonical content |\n| [`tools/verify_chain.py`](tools/verify_chain.py) | v1.0 candidate | Standalone stdlib validator for JSONL receipt hash chains |\n| `LICENSE` | Apache-2.0 | License (full text) |\n| `README.md` | this file | What you're reading |\n\nRemaining v0.1 → v1.0 work:\n\n- `VALIDATOR.md` — algorithm + reference implementation for independent chain verification\n- `MCP_INTERFACE.md` — `krineia-mcp` tool surface (Model Context Protocol)\n- `daemon/` — reference daemon implementation (currently at `C:/Users/Owner/overnight/`, will move once stable)\n\n## Why this exists\n\nMost \"AI governance\" tooling treats audit logs as observability — a side channel that gets flushed, summarized, or eventually overwritten. KRINEIA makes the opposite bet: **the audit log is the governance**. If a tool call wasn't recorded with a verifiable hash chain back to a known-good genesis, no governance happened. Period.\n\nThe five invariants make this operational:\n\n1. **Append-only** — the log only grows. No deletes, no mutations, ever.\n2. **No reward-path self-reference** — log contents never enter any agent's reward, gradient, or training signal. (Reading for coordination is allowed; learning from the log is not.)\n3. **Minimal operators** — exactly three: `append()`, `project()`, `cut()`. Anything more is leakage.\n4. **External analysis only** — the log is post-mortem. External tools inspect; the system itself doesn't.\n5. **Trust-root separation** — the observed agent does not write its own receipts or control the receipt-generation process.\n\nThese are NOT software-engineering conventions; they are the load-bearing properties that distinguish a governance proof from a self-referential optimization target.\n\n## Status\n\n**v0.1 — DRAFT.** Schema captures the format emitted by the v0.1 reference daemon. v1.0 will be frozen ahead of the first paid pilot deployment.\n\nThis repo is the **canonical** KRINEIA spec. The reference daemon, validator, and MCP interface are tracked here (or will move here) for SPDX-resolvable provenance.\n\n## License\n\nApache License 2.0 — see [`LICENSE`](LICENSE).\n\nReceipt format and validator algorithm are intended to be implementable freely; \"KRINEIA\" the trademark / brand is not granted by this license.\n\n## About the maintainer\n\n**HUMMBL Research Institute** is a research institute incorporated as HUMMBL, LLC (Georgia, USA). The institute publishes open standards (like this one), and offers products, services, courses, and certifications building on its research.\n\nThe `hummbl-` prefix on GitHub repository paths is an organizational convention, not a product brand. Products published by the institute use their own names.\n\n## Related research from HUMMBL\n\nKRINEIA sits within a broader research stack at the institute:\n\n- **KRINEIA (theory layer)** — the governing invariants codified in this implementation. The theory predates this repo and informs all sovereignty/audit design choices.\n- **Base120 (mental models)** — 120 reasoning operators in 6 families. A KRINEIA receipt can record which Base120 operator drove a decision.\n- **BKI (Belonging as Knowledge Infrastructure)** — belonging as the structural precondition for knowledge creation. KRINEIA receipts can capture whether belonging preconditions were met before a tool call.\n\nFor the full research stack, see [hummbl.io](https://hummbl.io) (forthcoming).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhummbl-dev%2Fkrineia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhummbl-dev%2Fkrineia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhummbl-dev%2Fkrineia/lists"}