From 473f216b9a9ac6996a8ee61c22b3f812b091f79d Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 19:44:19 +0000 Subject: [PATCH 1/2] docs(contractiles): verbs are discovered from their k9 components The README told consumers to read INDEX.a2ml for the verb list. Every fact the index held is already declared by each verb's .k9.ncl (semantics, tier, authority, paired_xfile), and the index's tiers had gone stale against them (Hunt / Hunt-read-only there, 'Yard in all six components). Say so, ahead of retiring the index in its own commit. Also correct two pointers into metadatastician/standards that named paths which do not exist (contractiles/CANONICAL-TEMPLATES.adoc is 1-formats/contractiles/; docs/CONTRACTILE-SPEC.adoc is standards', not this repo's), and drop "per INDEX.a2ml" from a comment in must.manifest.a2ml (deletion only; no fact added to the A2ML file). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_019a95kk88TZ1iegsBK3kox3 --- .machine_readable/contractiles/README.adoc | 16 +++++++++++----- .../contractiles/must/must.manifest.a2ml | 2 +- 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/.machine_readable/contractiles/README.adoc b/.machine_readable/contractiles/README.adoc index 5034d402..3035d4f6 100644 --- a/.machine_readable/contractiles/README.adoc +++ b/.machine_readable/contractiles/README.adoc @@ -17,8 +17,9 @@ recovery happens without losing the audit trail. The estate-level audit semantics (what each verb *means* and the minimum bar for "real contract vs template residue") are defined in -`standards/contractiles/CANONICAL-TEMPLATES.adoc`. The normative -per-file specification is `docs/CONTRACTILE-SPEC.adoc`. This README +`1-formats/contractiles/CANONICAL-TEMPLATES.adoc` in +`metadatastician/standards`. The normative per-file specification is +`docs/CONTRACTILE-SPEC.adoc` in the same repository. This README documents the local realisation. == Layout — the trident shape @@ -42,9 +43,14 @@ noun-form PascalCase in the A2ML declaration (e.g. `intend.ncl` + `Intentfile.a2ml`, `must.ncl` + `Mustfile.a2ml`). `_base.ncl` provides the shared `pedigree_schema`, `run_defaults`, and -`probe_schema` that every runner merges into. `INDEX.a2ml` is the -machine-readable registry of all verbs — consumers should read it -rather than hard-coding the verb list. +`probe_schema` that every runner merges into. + +There is no separate registry file. A verb is a directory here that +holds a `.k9.ncl`; that component declares the verb's +`semantics`, `tier`, `authority` and `paired_xfile`, so consumers +discover verbs and read those facts from the k9 components. The former +`INDEX.a2ml` registry repeated them, and its tiers had gone stale +against the components; it was retired (A2ML is retired estate-wide). == Verbs (6 + k9 exception) diff --git a/.machine_readable/contractiles/must/must.manifest.a2ml b/.machine_readable/contractiles/must/must.manifest.a2ml index c4225ad4..a954f405 100644 --- a/.machine_readable/contractiles/must/must.manifest.a2ml +++ b/.machine_readable/contractiles/must/must.manifest.a2ml @@ -2,7 +2,7 @@ # must.manifest.a2ml — Trident coherence manifest for the must verb. # Author: Jonathan D.A. Jewell # -# Third trident instance (per INDEX.a2ml). Completes the blocking-authority +# Third trident instance. Completes the blocking-authority # pair (must + trust) and sits inside the (Hunt, blocking) triple # (must + trust + bust). must is concrete + persistent invariants; trust # is concrete + ephemeral transactions. Together they gate every From d9e27d60a47eb586b840ab053eeee797af8b102c Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 19:44:19 +0000 Subject: [PATCH 2/2] chore(contractiles): retire INDEX.a2ml Owner ruling 2026-11-16 (selector): retire the contractile registry entirely, once every fact has a home. Deleted under the three-condition rule: 1. Every fact is held elsewhere or dropped on purpose (file: 5224 bytes, sha256 8d5f9892a67cf9f0c27f128b0c65e8e2f015cac2 52806b0fa4eb186c18b8530c, blob 36b9d6f3dfbd266236fc34a2ac3884dea1f4824a): - per verb (adjust, bust, dust, intend, must, trust): name -> the verb directory; semantics -> `semantics` in /.k9.ncl; tier -> `tier` there (the index's Hunt / Hunt-read-only values were stale: all six components say 'Yard); authority and gating -> `authority` there ('blocking, 'advisory, 'reporting); trident files -> `paired_xfile` there and the file roles in .manifest.a2ml; manifest path -> the file itself; cardinality -> the "Cardinality: ONE ... per repo" header of each component; status "active" -> the directory's presence; notes -> each component's `description` and header. - base_schema -> every .ncl and .k9.ncl imports ../_base.ncl. - spec -> README.adoc names docs/CONTRACTILE-SPEC.adoc in metadatastician/standards (the index's path was this repo's, where no such file exists). - the k9 exception and the removal of `lust` -> README.adoc sections "k9" and the NOTE under "Verbs". The index's k9 paths (k9/template-*.k9.ncl) do not exist; the templates are ../svc/k9/template-*.k9.ncl.in, as the README says. Dropped. - id, version, last_updated, meta_schema_status -> described the index file itself. Dropped. No mapping spec in standards 1-formats/deed/mappings/ covers this file; the owner's ruling is the authority for retiring it. 2. The homes are k9 components, not deeds; they are unchanged here and stay under the k9-validate job of dogfood-gate.yml. 3. No reader: no workflow, script, Justfile recipe or tool in this repo reads it (git grep). The one estate reader, k9-contractile.yml in standards, runs on standards' own tree only (standards A7 section 10). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_019a95kk88TZ1iegsBK3kox3 --- .machine_readable/contractiles/INDEX.a2ml | 133 ---------------------- 1 file changed, 133 deletions(-) delete mode 100644 .machine_readable/contractiles/INDEX.a2ml diff --git a/.machine_readable/contractiles/INDEX.a2ml b/.machine_readable/contractiles/INDEX.a2ml deleted file mode 100644 index 36b9d6f3..00000000 --- a/.machine_readable/contractiles/INDEX.a2ml +++ /dev/null @@ -1,133 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# INDEX.a2ml — Contractile Registry -# Author: Jonathan D.A. Jewell -# -# Machine-readable catalogue of all contractile verbs in this template set. -# Consumers (CI scripts, the contractile CLI, Hypatia rules) SHOULD read this -# file to discover available verbs rather than hard-coding the list. -# -# See: docs/CONTRACTILE-SPEC.adoc §Registry - ---- -id = "contractiles-registry" -version = "2.0.0" # 2.0.0 (2026-04-18): all 6 verbs on trident shape; verb set complete. -spec = "docs/CONTRACTILE-SPEC.adoc" -last_updated = "2026-04-18" -base_schema = ".machine_readable/contractiles/_base.ncl" -meta_schema_status = "pending — see CONTRACTILE-SPEC §validator-meta-schema" - -## Verbs - -[[verbs]] -name = "adjust" -semantics = "drift tolerances + corrective actions" -trident = [ - "adjust/Adjustfile.a2ml", - "adjust/adjust.ncl", - "adjust/adjust.k9.ncl", -] -manifest = "adjust/adjust.manifest.a2ml" -status = "active" -tier = "Yard" -authority = "advisory" -gating = "advisory (continue-with-warnings)" -cardinality = "one per repo" -notes = "Fifth trident instance (2026-04-18). First (Yard, advisory) authority pattern. Specialises in cumulative-drift catchment — tolerance bands + trend tracking across sessions. auto_fix_when_available applies deterministic patches; advisory otherwise." - -[[verbs]] -name = "bust" -semantics = "hard-stop / expiry / must-not-run declarations" -trident = [ - "bust/Bustfile.a2ml", - "bust/bust.ncl", - "bust/bust.k9.ncl", -] -manifest = "bust/bust.manifest.a2ml" -status = "active" -tier = "Hunt-read-only" -authority = "blocking" -gating = "hard (exit-nonzero)" -cardinality = "one per repo" -notes = "Fourth trident instance (2026-04-18). Completes the blocking-authority triple (must + trust + bust). Specialises in deprecated-path-reintroduction catchment. Injects failures via declared probes and verifies recovery paths." - -[[verbs]] -name = "dust" -semantics = "rollback / recovery / deprecation / audit-trail preservation" -trident = [ - "dust/Dustfile.a2ml", - "dust/dust.ncl", - "dust/dust.k9.ncl", -] -manifest = "dust/dust.manifest.a2ml" -status = "active" -tier = "Yard" -authority = "advisory" -gating = "advisory (continue-with-warnings)" -cardinality = "one per repo" -notes = "Sixth and FINAL trident instance (2026-04-18) — completes the full verb set. Specialises in audit-trail preservation + rollback-path verification. Destructive actions gated behind --apply flag + per-item approval; dry-run default." - -[[verbs]] -name = "intend" -semantics = "north-star (commitments + aspirations)" -trident = [ - "intend/Intentfile.a2ml", - "intend/intend.ncl", - "intend/intend.k9.ncl", -] -manifest = "intend/intend.manifest.a2ml" -status = "active" -tier = "Hunt" -authority = "reporting" -gating = "non-gating (continue)" -cardinality = "one per repo" -notes = "First trident instance in the estate (2026-04-18). Reports progress toward committed next-actions AND lists horizon aspirations. Absorbed the deprecated `lust` verb 2026-04-18. Never blocks. All six verbs are now complete tridents (declaration + runner + k9 component) with coherence manifests." - -[[verbs]] -name = "k9" -semantics = "trust-tier templates (EXCEPTION to one-verbfile rule)" -file_pair = [ - "k9/template-hunt.k9.ncl", - "k9/template-kennel.k9.ncl", - "k9/template-yard.k9.ncl", -] -status = "exception" -gating = "not applicable" -notes = "k9 is service-automation meta-infrastructure, not a verb contractile. Three trust-tier templates (Kennel/Yard/Hunt). Does not have a Verbfile.a2ml. See CONTRACTILE-SPEC §k9-exception." - -# [[verbs]] lust REMOVED 2026-04-18 — name had unwanted associations; -# the horizon/aspiration semantics were always meant to live inside `intend` -# (the north-star verb). The [[wishes]] schema was absorbed into -# intend/Intentfile.a2ml. Any `lust/` dir found in an estate repo is drift -# and should be deleted. - -[[verbs]] -name = "must" -semantics = "invariant assertion — release-blocking" -trident = [ - "must/Mustfile.a2ml", - "must/must.ncl", - "must/must.k9.ncl", -] -manifest = "must/must.manifest.a2ml" -status = "active" -tier = "Hunt-read-only" -authority = "blocking" -gating = "hard (exit-nonzero)" -cardinality = "one per repo" -notes = "Third trident instance (2026-04-18). Completes the blocking-authority pair with trust: must = concrete + persistent invariants; trust = concrete + ephemeral transactions. Specialises in subtle invariant-erosion (tracking per-session trend; flagging silent regression). Single failure blocks merge. Simplest and most commonly populated verb." - -[[verbs]] -name = "trust" -semantics = "security + provenance + safe-hacking" -trident = [ - "trust/Trustfile.a2ml", - "trust/trust.ncl", - "trust/trust.k9.ncl", -] -manifest = "trust/trust.manifest.a2ml" -status = "active" -tier = "Hunt" -authority = "blocking" -gating = "hard (exit-nonzero)" -cardinality = "one per repo" -notes = "Second trident instance (2026-04-18). First (Hunt, blocking) verb — hard gate. Primary defense against threat-model misclassification (B1) and 'turn off the firewall' capability-collapse (C2). Inherits on_open negotiation+accountability+translation from intend.k9.ncl v2.0.0; adds threat_model_foregrounding + block_session_close_on_critical_drift."