@event4u/agent-config 14.5.0 → 14.6.0

package/dist/agent-src/skills/adr-create/SKILL.md

@@ -11,6 +11,8 @@ execution:
   command:
     - ./scripts-run
     - src/scripts/adr/regenerate_index
+    - --dir
+    - docs/decisions
 runtime_requires:
   bins:
     - bash
@@ -59,7 +61,10 @@ Do NOT use when:
     governance ADRs, 3-digit numbering (`ADR-NNN-<slug>.md`).
   - **Per-area** — `docs/adrs/<area>/`: sub-area ADRs, 4-digit
     numbering (`NNNN-<slug>.md`); `<area>` must match the canonical
-    inventory in [`scripts/audit_adr_coverage.ts`](../../../scripts/audit_adr_coverage.ts).
+    inventory in `src/scripts/audit_adr_coverage.ts` (`AREAS`). Deliberately not
+    a link: this skill is projected into `dist/agent-src/skills/`, whose sibling
+    `scripts/` directory carries six curated files and not this one, so any
+    relative href that resolves in `src/` is broken in the projection.
 - The decision is **already made** — ADRs record outcomes, they do
   not run the decision process. For unresolved trade-offs, run the
   council or consult `adversarial-review` first.
@@ -80,7 +85,7 @@ Ask one question only if both are plausible:
    `NNNN-<slug>.md` (4-digit, no `ADR-` prefix).
 3. **Unknown area** — `<area>` not in the inventory: refuse with a
    hint to add the area to `AREAS` in
-   `scripts/audit_adr_coverage.ts` in the same PR. Do not invent.
+   `src/scripts/audit_adr_coverage.ts` in the same PR. Do not invent.
 4. **In doubt** → per-area (cheaper to surface, easier to relocate).
 
 ### 2. Pick the next ADR number
@@ -134,8 +139,12 @@ date: YYYY-MM-DD
 decision: <slug>
 supersedes: — | ADR-MMM
 superseded_by: — | ADR-MMM
+amends: — | ADR-MMM          # optional — this ADR amends that one (reciprocal required)
+amended_by: — | ADR-MMM      # optional — reciprocal of `amends`
 phase: <roadmap> · <phase-id>
 review_trigger: <the CONDITION that would reopen this decision>
+protected_dimensions: [...]  # optional — purpose | security_floor | privacy_floor | external_commitment | governance | none
+reopen_policy: directional | owner | unclassified   # optional; absent → unclassified
 ---
 
 # ADR-NNN — <Decision Title>
@@ -204,7 +213,7 @@ completeness check — not on every ADR by default.
 - **Per-area numbering is 4-digit** (`NNNN-<slug>.md`); the flat
   surface stays 3-digit (`ADR-NNN-<slug>.md`). Do not mix.
 - **Area inventory is closed** — `<area>` must already exist in
-  `AREAS` in `scripts/audit_adr_coverage.ts`. Adding a new area is
+  `AREAS` in `src/scripts/audit_adr_coverage.ts`. Adding a new area is
   a separate PR with explicit reviewer sign-off.
 - Frontmatter `adr:` (flat) is the canonical number; the filename
   prefix must match. The flat regenerator fails on mismatch.
@@ -214,6 +223,19 @@ completeness check — not on every ADR by default.
   to `superseded`.
 - Never delete an ADR file — supersede it. Deletion breaks
   historical links and round-trips through git history checks.
+- **Amending is the common case; wire it in both directions.** Most reopens
+  correct one decision inside an otherwise sound ADR rather than replacing the
+  whole record. Use `## Amendment N (YYYY-MM-DD) — <topic>` plus the reciprocal
+  `amends:` / `amended_by:` pair — the validator rejects a one-sided link,
+  because a one-sided link is invisible from the stale side, and the stale side
+  is the one a reader lands on first. Where the amendment reverses text that is
+  still asserted above it, add a one-line banner there too; the frontmatter
+  alone does not stop someone quoting the reversed sentence.
+- **Who may reopen it is recorded, not assumed** — `reopen_policy` /
+  `protected_dimensions`, both optional, absent meaning `unclassified`
+  ([`adr-layout § Reopen authority`](../../../docs/contracts/adr-layout.md)).
+  Reach for `owner` only when EVERY future transition is genuinely reserved;
+  `directional` is the normal answer, and no answer is a fine answer.
 
 ## Frugality Standards
 

package/dist/agent-src/skills/decision-review/SKILL.md

@@ -280,6 +280,24 @@ in the rule; the lock catalog, fire steps, and failure modes live here.
    contract — every re-evaluated lock gets a fresh, correctly-scoped
    disposition, not a re-statement of the old one.
 
+   When the lock is an **ADR**, the disposition carries the five-field reopen
+   record from [`adr-layout § Reopen record`](../../../docs/contracts/adr-layout.md):
+   the original rationale **addressed** (not cited), what changed with tree
+   evidence, dependants and external commitments touched, the rollback path,
+   and a blast radius — `narrow | wide | irreversible` — with the evidence for
+   that call. Two clauses bind the same record: **precedent creates no
+   authority** (that a similar ADR was reopened is never grounds for this one),
+   and **one seat must argue the strongest case for keeping the decision**.
+   Both answer precedent laundering through correlated self-review, which is
+   the failure two independent council seats named for this mechanism on
+   2026-08-19: the proposer frames the evidence, correlated seats ratify, and
+   the amendment becomes authoritative input for the next review.
+
+   Proportionally: a narrow, reversible, bounded transition takes the light
+   path (record + council); `wide` or `irreversible` adds owner notification.
+   Identical ceremony for a typo-level amendment would cost more than asking
+   the owner and the mechanism would die of its own weight.
+
 ### When NOT to fire
 
 - The blocked change has no real benefit — the gate is not a lever to

package/dist/agent-src/templates/agents/agent-project-settings.example.yml

@@ -39,7 +39,7 @@ schema_version: 1
 # CI guard: a release bump of `package.json` must update this value
 # in lockstep — see scripts/check_template_pin_drift.ts (road-to-
 # portable-runtime-and-update-check P3.3).
-agent_config_version: "14.5.0"
+agent_config_version: "14.6.0"
 
 # --- Project identity ---
 project:

package/dist/cli-delegate/{chunk-ZPSXJTLI.js → chunk-P6LQDIWK.js}

@@ -213,6 +213,20 @@ var CAPSULE_SCHEMA_VERSION = 3;
 function isShortLine(value, max) {
   return typeof value === "string" && value.length > 0 && value.length <= max && !value.includes("\n");
 }
+function isPathRef(value) {
+  return typeof value === "string" && value.length > 0 && !/\s/.test(value);
+}
+function checkPathRefList(errors, field, value, max, required) {
+  checkList(errors, field, value, max, required);
+  if (!Array.isArray(value)) return;
+  if (value.some((x) => !isShortLine(x, max))) return;
+  const bad = value.filter((x) => !isPathRef(x));
+  if (bad.length === 0) return;
+  const shown = bad.slice(0, 3).map((x) => JSON.stringify(String(x))).join(", ");
+  errors.push(
+    `${field} carries ${bad.length} entr${bad.length === 1 ? "y" : "ies"} that are prose, not path refs: ${shown}${bad.length > 3 ? ", \u2026" : ""} \u2014 write the path (src/generated/api.ts, ../other-worktree/) or drop the entry; a sentence naming a file cannot be compared against a write target, and being comparable is the whole reason this is a field rather than a line of prose`
+  );
+}
 function checkList(errors, field, value, max, required) {
   if (value === void 0) {
     if (required) errors.push(`${field} is required`);
@@ -402,7 +416,7 @@ function validateRecycleEnvelope(input) {
   checkList(errors, "decisions", e["decisions"], MAX_LINE_CHARS, false);
   errors.push(...decisionTagErrors(e["decisions"]));
   checkList(errors, "constraints", e["constraints"], MAX_LINE_CHARS, false);
-  checkList(errors, "do_not_touch", e["do_not_touch"], MAX_REF_CHARS, false);
+  checkPathRefList(errors, "do_not_touch", e["do_not_touch"], MAX_REF_CHARS, false);
   checkList(errors, "open_worker_envelopes", e["open_worker_envelopes"], MAX_REF_CHARS, false);
   checkList(errors, "artifact_paths", e["artifact_paths"], MAX_REF_CHARS, false);
   checkList(errors, "suggested_skills", e["suggested_skills"], MAX_REF_CHARS, false);

package/dist/cli-delegate/cmd_conformance.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-F7DQWYR5.js";
 import {
   validateAssumption
-} from "./chunk-ZPSXJTLI.js";
+} from "./chunk-P6LQDIWK.js";
 import {
   ArgparseExit,
   STATUS_SYMBOLS,

package/dist/cli-delegate/cmd_handoff.js

@@ -21,7 +21,7 @@ import {
   scanEnvelopeDirectives,
   validateRecycleEnvelope,
   wrapAsPriorSessionData
-} from "./chunk-ZPSXJTLI.js";
+} from "./chunk-P6LQDIWK.js";
 import {
   _RAW_KEY_PREFIXES,
   hardenedSpawnEnv,

package/dist/cli-delegate/cmd_session_recycle.js

@@ -7,7 +7,7 @@ import {
 import {
   CAPSULE_SCHEMA_VERSION,
   validateRecycleEnvelope
-} from "./chunk-ZPSXJTLI.js";
+} from "./chunk-P6LQDIWK.js";
 import {
   atomic_write_json
 } from "./chunk-EJITJBJX.js";

package/dist/discovery/deprecation-report.md

@@ -1,6 +1,6 @@
 # Discovery — Deprecation Report
 
-- Generated: `2026-08-19T16:05:13Z`
+- Generated: `2026-08-20T10:01:02Z`
 - Deprecated artefacts: **0**
 
 _None. Tree is clean._

package/dist/discovery/discovery-manifest.json

@@ -335,7 +335,7 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:41a78aafb9c64bbde078d810e27e439e824ef32d42304385c01da5349ed6d6db",
+      "checksum": "sha256:155621554341e110f17d47afd05dfaec8f9296c75775f87368d6858d246c0efc",
       "install": {
         "default": true,
         "removable": false
@@ -3932,7 +3932,7 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:a00c792d3993feead1ea9cb2421e5f5050129297be3686dc03f916b91d414365",
+      "checksum": "sha256:37afea968880e81d495ce5acdd65ba3672e437321113cdd2e797f587582a3f96",
       "install": {
         "default": true,
         "removable": false
@@ -5016,7 +5016,7 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:1bdeb039465dc4495f4731e4aea95743c2a83cb17bb95fe406fff02050e66ed5",
+      "checksum": "sha256:d52238b926d239cf3a2158fafa46b0b8b7188bd0a8b2d23743c08d0d64054af2",
       "install": {
         "default": true,
         "removable": false
@@ -5875,7 +5875,7 @@
     },
     {
       "category": "rule",
-      "checksum": "sha256:5caf2e99f1c5ba9038f942eb0cacac60ebe4a14d394fb170ac4b14aa10ce96c2",
+      "checksum": "sha256:9e2c7fc0ca0e486501f9d97523b3020593a0d9cb03c867cb487f9966b06d1999",
       "install": {
         "default": true,
         "removable": false
@@ -8075,7 +8075,7 @@
     },
     {
       "category": "skill",
-      "checksum": "sha256:672f1c484a99d7ce790bc3ab2a2ccb321885bd7179de2da5c206da0406dacc52",
+      "checksum": "sha256:c214a303dabbbdc25a775fb1840618589a442384264fffd0a735a54e5d2b4f03",
       "install": {
         "default": true,
         "removable": false
@@ -9395,7 +9395,7 @@
     },
     {
       "category": "skill",
-      "checksum": "sha256:e472a98d0fca4325a390a3825aa93c62718ee3b498ebbb12ae97086d35a50c81",
+      "checksum": "sha256:e0344f1b7433b3b9c2069e51a121f284737aa6d1fec4decbf0ab3c52e73e8796",
       "install": {
         "default": false,
         "removable": true
@@ -14434,7 +14434,7 @@
       "workspaces": []
     }
   ],
-  "checksum": "sha256:ebb8ea9f229d02a7600a7b9d4da6b9bc6d4025af3e92fb900ef1d369e978ffba",
+  "checksum": "sha256:b1e2057c34ec3436902fff901299ad74fb4d36434254dbb89f1a5998c45817be",
   "deprecations": [
     {
       "key": "tier",
@@ -14578,7 +14578,7 @@
       "reason": "scaffold template for ticket-bundle tickets (ADR-101); carries no runtime frontmatter — emit-tickets fills it in per ticket"
     }
   ],
-  "generated_at": "2026-08-19T16:05:13Z",
+  "generated_at": "2026-08-20T10:01:02Z",
   "packs": [
     {
       "artefact_count": 118,

package/dist/discovery/discovery-manifest.json.sha256

@@ -1 +1 @@
-1ac599eacfebabd2c39b8f7ca9ae599d91e8be948f71c3cf96f74e1b0c4031db  discovery-manifest.json
+de82f5eaaf43261e3be41f593ad3220a2137274d149505507783869c2b54501d  discovery-manifest.json

package/dist/discovery/discovery-manifest.summary.md

@@ -1,6 +1,6 @@
 # Discovery Manifest — Summary
 
-- Generated: `2026-08-19T16:05:13Z`
+- Generated: `2026-08-20T10:01:02Z`
 - Scanner: `de0a22b4ac4c`
 - Artefacts: **609**
 - Unassigned: **0**

package/dist/discovery/dormancy-report.md

@@ -1,6 +1,6 @@
 # Discovery — Dormancy Report
 
-- Generated: `2026-08-19T16:05:13Z`
+- Generated: `2026-08-20T10:01:02Z`
 - Window: **6 months** without a commit
 
 > Dormancy triggers **review, never auto-deprecation**

package/dist/discovery/orphan-report.md

@@ -1,6 +1,6 @@
 # Discovery — Orphan Report
 
-- Generated: `2026-08-19T16:05:13Z`
+- Generated: `2026-08-20T10:01:02Z`
 - Orphan artefacts: **0**
 
 > An orphan is an artefact whose declared pack has no other members.

package/dist/discovery/packs.json

@@ -1,6 +1,6 @@
 {
-  "checksum": "sha256:ebb8ea9f229d02a7600a7b9d4da6b9bc6d4025af3e92fb900ef1d369e978ffba",
-  "generated_at": "2026-08-19T16:05:13Z",
+  "checksum": "sha256:b1e2057c34ec3436902fff901299ad74fb4d36434254dbb89f1a5998c45817be",
+  "generated_at": "2026-08-20T10:01:02Z",
   "packs": [
     {
       "always_on": false,

package/dist/discovery/trust-report.md

@@ -1,6 +1,6 @@
 # Discovery — Trust Report
 
-- Generated: `2026-08-19T16:05:13Z`
+- Generated: `2026-08-20T10:01:02Z`
 - Workspaces tracked: **10**
 - Human-review-required artefacts: **3**
 

package/dist/discovery/workspaces.json

@@ -1,6 +1,6 @@
 {
-  "checksum": "sha256:ebb8ea9f229d02a7600a7b9d4da6b9bc6d4025af3e92fb900ef1d369e978ffba",
-  "generated_at": "2026-08-19T16:05:13Z",
+  "checksum": "sha256:b1e2057c34ec3436902fff901299ad74fb4d36434254dbb89f1a5998c45817be",
+  "generated_at": "2026-08-20T10:01:02Z",
   "scanner_version": "de0a22b4ac4c",
   "workspaces": [
     {