Skip to content

Commit f6f3c91

Browse files
hyperpolymathclaude
andcommitted
refactor(contractiles): move k9 to svc/ per ADR-001 (2026-04-18)
Spot-fix: K9 templates + validators were sitting under `.machine_readable/contractiles/k9/` despite ADR-001 (2026-04-18) stating contractiles/ is reserved for the pure six-verb set (intend, trust, must, bust, adjust, dust) and K9 belongs at `.machine_readable/svc/k9/`. Changes: - `git mv` the entire k9/ subtree from contractiles/ to svc/ - Update MUST.contractile's validator pointer (contractiles/k9 → svc/k9) - Contractile README now points to svc/k9/ for K9 templates - New svc/README.adoc explains the ADR-001 split Scope: this is the drift I flagged before task #11; lands as its own commit for a clean diff. No behavioural change — MUST.contractile's pre-existing reference to `must-check.k9.ncl` was already stale (that file has never existed here); only the directory path is fixed. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 018a1fd commit f6f3c91

12 files changed

Lines changed: 25 additions & 5 deletions

.machine_readable/MUST.contractile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
; remain active until the feature is fully removed.
2727
;
2828
; Enforcement:
29-
; K9 validators in contractiles/k9/ machine-check MUST constraints.
29+
; K9 validators in svc/k9/ machine-check MUST constraints.
3030
; CI runs these on every PR. Violations block merge.
3131
;
3232
; ── End Definitions ──────────────────────────────────────────────
@@ -85,7 +85,7 @@
8585
; (must "# Add project-specific invariants here")
8686

8787
(enforcement
88-
(k9-validator "contractiles/k9/must-check.k9.ncl")
88+
(k9-validator "svc/k9/must-check.k9.ncl")
8989
(ci "quality.yml runs must-check on every PR")
9090
)
9191
)

.machine_readable/contractiles/README.adoc

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,10 @@ one lowercase `<verb>.ncl` runner.
1515
lifecycle hook declarations.
1616
* `adjust/` — allowed drift corrections (work in progress).
1717
* (planned) `bust/Bustfile.a2ml` — what breaks and how to react.
18-
* `k9/` — K9 self-validating contractile templates. Per ADR-001
19-
(2026-04-18) the K9 *service* belongs at `.machine_readable/svc/k9/`
20-
and this directory should only hold pure templates + examples.
18+
19+
K9 templates and validators live at `.machine_readable/svc/k9/` per
20+
ADR-001 (2026-04-18). `contractiles/` is reserved for the pure verb
21+
set.
2122

2223
== Session lifecycle
2324

.machine_readable/svc/README.adoc

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
= `.machine_readable/svc/` — Service components for 007-lang
2+
:toc:
3+
4+
Service-layer components that sit alongside the contractile trident
5+
but are not themselves verbs. Per **ADR-001 (2026-04-18)**, K9 lives
6+
here rather than under `contractiles/` so the contractile directory
7+
stays a pure six-verb set (intend, trust, must, bust, adjust, dust).
8+
9+
== Contents
10+
11+
* `k9/` — K9 self-validating templates (Kennel / Yard / Hunt tiers) +
12+
validators (methodology-guard, harvard-guard) + examples.
13+
14+
== Pointer
15+
16+
For the verb contractiles themselves, see
17+
`.machine_readable/contractiles/`. The K9 components here are imported
18+
by the verb runners (`contractiles/<verb>/<verb>.ncl`) when they need
19+
capability / authority declarations or pre-built templates.
File renamed without changes.

.machine_readable/contractiles/k9/examples/ci-config.k9.ncl renamed to .machine_readable/svc/k9/examples/ci-config.k9.ncl

File renamed without changes.

.machine_readable/contractiles/k9/examples/project-metadata.k9.ncl renamed to .machine_readable/svc/k9/examples/project-metadata.k9.ncl

File renamed without changes.

.machine_readable/contractiles/k9/examples/setup-repo.k9.ncl renamed to .machine_readable/svc/k9/examples/setup-repo.k9.ncl

File renamed without changes.
File renamed without changes.

.machine_readable/contractiles/k9/methodology-guard.k9.ncl renamed to .machine_readable/svc/k9/methodology-guard.k9.ncl

File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)