Skip to content

docs: canonize All Gods Must Die doctrine and exact-object completion amendment - #80551

Open
andrexibiza wants to merge 5 commits into
NousResearch:mainfrom
andrexibiza:docs/long-document-production-interlock
Open

docs: canonize All Gods Must Die doctrine and exact-object completion amendment#80551
andrexibiza wants to merge 5 commits into
NousResearch:mainfrom
andrexibiza:docs/long-document-production-interlock

Conversation

@andrexibiza

@andrexibiza andrexibiza commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

What this contribution is

This PR canonizes All Gods Must Die: Adversarially Verified Transformation as a first-class Hermes publication, guide, reusable production skill, and versioned architecture doctrine.

The original paper unifies god-file decomposition and multilingual documentation parity under one rule:

Make critical claims mechanically falsifiable, separate production from adjudication, and refuse hidden debt.

Hermes is the system under study: a stateful, self-regulating cybernetic agent whose LLM layer supplies neural plasticity and whose deterministic skeleton — CI gates, cryptographic hashes, graph checks, seam identity, manifests, approval boundaries, memory/profile isolation, and adversarial witnesses — makes that plasticity answerable to structure.

Hermes is explicitly framed as a weapon for sovereignty, not war: an instrument for preserving user agency over model choice, context, memory, tools, execution, provider routing, and technical records. Cyber defense is an internal function because Hermes lives inside the CLI, gateway, tool, memory, provider-egress, desktop-auth, documentation, and CI surfaces she defends.

Amendment I — Task Completion Verification

This PR now embeds a successor architecture refinement derived from the concrete Task Completion Verification execution record.

The original five laws gain a sixth:

No task is complete until the requested state exists at the authoritative target and is verified on the exact object.

Derivative rule:

No receipt may be inherited from a local draft, previous head, adjacent commit, parent object, superseded artifact, or intended write.

This closes the activity-completion collapse failure class: a prepared patch is not a changed branch; a changed branch is not a pull request; a pull request is not approval; approval is not merge; merge is not release; release is not operational proof.

Completion is represented as a typed state vector across:

  • materialization;
  • integrity;
  • governance;
  • integration;
  • operation;
  • lineage.

The amendment preserves the original god-file campaign's SHIPPED definition as the namespaced predicate KAG_SHIPPED. It does not imply MERGED, PUBLISHED, RELEASED, or OPERATIONALLY_VERIFIED.

The webhook case study preserves both time-bounded truths:

The later target objects do not retroactively turn the earlier 403 into a successful write. The earlier blocker does not deny the later target state. Both events remain in the mutation journal.

Publication surfaces

Original v1.0 contribution

  • website/docs/guides/all-gods-must-die.md — long LLM-readable guide, registered in the Guides & Tutorials sidebar.
  • docs/research/all-gods-must-die-adversarially-verified-transformation.pdf — immutable 68-page compiled publication.
  • docs/research/all-gods-must-die-adversarially-verified-transformation.tex — reproducible LaTeX source.
  • docs/research/all-gods-must-die-adversarially-verified-transformation.bib — merged bibliography.
  • skills/research/long-document-production/SKILL.md — reusable long-document production skill.
  • website/scripts/generate-llms-txt.py — curated llms.txt inclusion.

Task Completion Verification source-controlled surfaces

  • website/docs/guides/task-completion-verification.md — exact-object completion architecture guide.
  • docs/research/task-completion-verification-amendment.md — canonical source-readable Amendment I.
  • docs/research/all-gods-must-die-adversarially-verified-transformation-v1.1.tex — successor composition source preserving immutable v1.0 and appending Amendment I.
  • docs/research/task-completion-record.schema.json — machine-auditable completion-record contract.
  • docs/research/task-completion-verification-ledger.json — dated local-blocker and current GitHub reconciliation records.
  • docs/research/all-gods-must-die-v1.1-release-manifest.json — source digests, generated-output digests, typed lineage, and packaging-time truth.
  • docs/research/all-gods-must-die-interlock.md — contribution graph and lifecycle boundary.

Generated release outputs

The amendment PDF and composed v1.1 PDF were built, preflighted, rendered, and visually inspected locally. Their digests are recorded in the release manifest. Their GitHub binary publication is not asserted by this PR source update.

  • Amendment I: 14 pages; SHA-256 1a8f46528faf10339e7d0cdeb3cf0b8035b341a23ffbde2b0b7aa19e361505f5.
  • Composed v1.1: 83 pages; SHA-256 be5f9c912025eb2fbbcbcef2a497eb76f041db7ecfa6637550fe7bbae1fb805b.

Hermes-agent security hardening evidence

The paper documents the actual Hermes-agent security series:

  • #77008 — Bitwarden encrypted-only disk cache and legacy plaintext migration/removal.
  • #77012, #77020 — exact-value protection in status lines and logs.
  • #77179, #77185, #77198 — applied-secret provenance and exact-value provider-egress masking.
  • #77027, #77181, #77193 — child-process environment scrubbing, including renamed and arbitrary external secrets.
  • #77528, #78033, #78036 — TUI compute host, LSP, plugin sidecar, and shell.exec scrub-bypass closure.
  • #77527 — real Windows ACL protection through icacls, including the existing-file mode-preservation branch.
  • #77039 — hermetic end-to-end no-exfiltration acceptance gate through the real secret-loading entrypoint.
  • #77031 — credential-read scope audit whose correct result was no fabricated code change.
  • #76958, #78901#78904 — stale desktop session-token clobbering, provenance diagnostics, bounded retry, and real subprocess regression harness.
  • #78806 — refusal to mutate git-managed state inside a real .git directory.

Interlock and contribution graph

Current contribution: #80551.

Part of #78647 — graph-gated engineering / large-file decomposition tracker.

Related sibling contributions:

  • #79609godfile-kill-campaigns, the 5×2×3 blind-witness decomposition skill.
  • #79779campaign-operations-kill-locks, the bidirectional audit and KILL LOCK skill.
  • #79898feature-parity-alignment-campaigns.
  • #80391 — cross-language docs germination pipeline.
  • #80392 — cross-language docs germination EPIC.
  • #60535 / #63660 — French documentation issue and seed provenance.
  • #85002 — Task 7 case-study object.
  • #85523#90236 — Task 10 historical provenance and canonical successor.

The interlock manifest defines the required edges:

  1. PR → EPIC via an operative Part of #78647 binding.
  2. PR → sibling contributions via explicit Related #N lines.
  3. EPIC → PR via the literal PR token posted on the EPIC thread.
  4. Sibling surfaces → this contribution via literal PR tokens where relevant.
  5. Skill → skillset through related_skills and the in-repo skill path.
  6. Credit → artifact through authorship, provenance, contributor identity, and source ledgers.
  7. Release → predecessor through explicit derives_from / refines lineage.
  8. Historical object → canonical successor through typed supersession.

Interlock is bidirectional or incomplete. Completion is exact-object bound or unproven.

Attribution

Axl Ibiza, MBA authored the doctrine, architecture, campaign design, source selection, editorial direction, and acceptance standard. The artifact preserves contributor, reviewer, agent, and source-project attribution rather than collapsing every action into one false authorship claim.

All contributions matter: feature code, security hardening, tests, audits, documentation, translations, skills, reviews, ledger repairs, interlock corrections, provenance work, negative receipts, and truthful blocker reports. Attribution is a core value and a correctness edge.

Verification

Original publication

  • Frontmatter validated for skills/research/long-document-production/SKILL.md.
  • Skill: 322 lines / 21,157 bytes; author Axl Ibiza, MBA.
  • DCO-signed commits.
  • Five native TinyTeX passes: all exit 0.
  • Original PDF: 68 pages / 653,398 bytes.
  • Zero undefined citations and references.
  • 25 DOI hyperlinks verified through PDF link objects.
  • All 68 pages rendered for visual QA.
  • Pantheon chart label collision detected, fixed, rebuilt, and re-inspected.
  • Original guide added to website/sidebars.ts and the curated llms.txt generator.

Amendment and exact-object source submission

  • Amendment PDF: 14 pages; preflight passes; all pages rendered and inspected.
  • Composed v1.1 PDF: 83 pages; cover, component boundaries, declaration, and final page inspected.
  • JSON Schema: all five case-study records validate under Draft 2020-12.
  • Source and generated-output hashes are recorded in the v1.1 release manifest.
  • Exact source commit: 048606e79810a42fcc243e2ae30373c91eacf574.
  • PR head read back at that exact commit after publication.
  • Source files read back from the exact tree with matching Git blob SHAs.
  • PR remains open, non-draft, and unmerged. Exact-head CI must be evaluated independently; no green state is inherited from prior heads or adjacent objects.

Acceptance

The paper, guide, source, bibliography, interlock manifest, long-document skill, Amendment I, completion schema, ledger, successor composition source, and release manifest are one contribution graph. Do not merge them as isolated files.

Part of #78647
Related #79609
Related #79779
Related #79898
Related #80391
Related #80392
Related #60535
Related #63660
Related #85002
Related #85523
Related #90236

Signed-off-by: Andrex Ibiza, MBA 84248988+andrexibiza@users.noreply.github.com

Part of #60535
Part of #80392

Signed-off-by: andrexibiza <84248988+andrexibiza@users.noreply.github.com>
Signed-off-by: andrexibiza <84248988+andrexibiza@users.noreply.github.com>
Signed-off-by: andrexibiza <84248988+andrexibiza@users.noreply.github.com>
@alt-glitch alt-glitch added type/docs Documentation improvements tool/skills Skills system (list, view, manage) P3 Low — cosmetic, nice to have labels Aug 6, 2026
Adds Amendment I, the sixth law, completion-record schema,
webhook state ledger, guide, successor composition source,
release manifest, and interlock refinement.

Signed-off-by: Andrex Ibiza, MBA <84248988+andrexibiza@users.noreply.github.com>
Remove implied binary repository publication from the guide and update
the release-manifest digest to the exact guide bytes.

Signed-off-by: Andrex Ibiza, MBA <84248988+andrexibiza@users.noreply.github.com>
@andrexibiza andrexibiza changed the title docs: canonize All Gods Must Die doctrine and publication docs: canonize All Gods Must Die doctrine and exact-object completion amendment Aug 21, 2026

Copy link
Copy Markdown
Contributor Author

Task Completion Verification — exact-object publication receipt

The architecture amendment is now source-controlled on this PR at exact head 048606e79810a42fcc243e2ae30373c91eacf574.

The doctrine now carries the sixth law:

No task is complete until the requested state exists at the authoritative target and is verified on the exact object.

Exact-head read-back receipts:

Surface Git blob SHA
docs/research/task-completion-verification-amendment.md bdcc3732fa18fa5ec9827a11281a4eaebae98fca
docs/research/task-completion-record.schema.json 3786b82ad77fb31b983b0c2539e283f31b36b512
docs/research/task-completion-verification-ledger.json ed00b9ddb8b795c9e5e97289c2afe274c332e8ea
website/docs/guides/task-completion-verification.md fe2f5b9f915d677a43120a1a648d3c665a9cbe5c
docs/research/all-gods-must-die-adversarially-verified-transformation-v1.1.tex 43e4b1a4948ea555c6f81d277a4c097eb924e6df
docs/research/all-gods-must-die-v1.1-release-manifest.json 3323fa2f725e7531baa80f3b4d4cc942388110df
docs/research/all-gods-must-die-interlock.md 0c5f34693c8309e8c5798d339237e968c28baf37

Exact-head workflow state at read-back:

No green state is inherited from the prior head. The PR is open, non-draft, mergeable, and unmerged. The 14-page amendment PDF and 83-page composed v1.1 PDF are locally preflighted/rendered outputs whose digests are recorded in the release manifest; this comment does not claim those binaries are present in the GitHub tree.

Copy link
Copy Markdown
Contributor Author

Exact-head workflow update

Current state for exact source head 048606e79810a42fcc243e2ae30373c91eacf574:

The CI job page available through the connector shows every exposed job as success/skipped, including the Docusaurus build, attribution, supply-chain checks, e2e, macOS/Windows tests, ruff, and the exposed Python slices. The run-level conclusion is nevertheless red, so a later-page/aggregate job remains failing and is not exposed by the connector's first-page job response.

Accordingly: the amendment sources are submitted and exact-object read back at this SHA; Docker and Nix are exact-head green; the PR remains open, non-draft, mergeable, unmerged, and CI-red. No all-green or merge-complete claim is made.

Copy link
Copy Markdown
Contributor Author

Canonical architecture issue

The complete doctrine, state model, evidence contract, webhook case study, source ledger, release semantics, acceptance matrix, and interlock topology are now presented in #91230.

This PR remains the exact implementation/publication object. #91230 is the architecture and lifecycle-contract node; it does not inherit acceptance, merge, release, or CI state from this PR.

Related #91230

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have tool/skills Skills system (list, view, manage) type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants