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." 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