@sabaiway/agent-workflow-memory 8.1.2 → 8.1.3

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to the memory substrate. Versions are this **package's** npm
 they are distinct from the **deployment-lineage** stamp written into a project's
 `docs/ai/.memory-version` (which tracks the shared `agent-workflow` lineage, head `4.0.0`).
 
+## 8.1.3 — the ADR navigator stamps a cap it honours (AD-167)
+
+`references/scripts/archive-decisions.mjs`: `--write-navigator` stamped `maxLines: 200` into `docs/ai/adr/log.md`
+whatever its length, and the navigator grows by one row per governing ADR, so past 162 governing ADRs the docs gate
+refused the generator's own output. The stamp is now 200 while the navigator fits and its own line count past it,
+counted the way `check-docs-size.mjs` counts. A navigator of 200 lines or fewer is written byte for byte as before, and
+`--check` still compares the whole file with a regeneration, so a hand-edited cap reads as stale. PATCH: a navigator
+of 200 lines or fewer is written as before. An upgrade keeps a deployed `scripts/archive-decisions.mjs` byte for byte,
+so a project already on the ADR store takes the fix by copying `archive-decisions.mjs` and `archive-decisions.test.mjs`
+from this package's `references/scripts/` into its `scripts/`; a project whose navigator is past 200 lines then runs
+`node scripts/archive-decisions.mjs --write-navigator` once.
+
 ## 8.1.2 — the templates carry the session close for the user (AD-159)
 
 `references/templates/agent_rules.md`: §2.5 Communication gains the last bullet `Two blocks for the user`, and §2.7

package/SKILL.md

@@ -3,7 +3,7 @@ name: agent-workflow-memory
 description: Deploy or upgrade a portable AI-agent memory substrate in any project — an entry-point `AGENTS.md` (+ `CLAUDE.md` alias) and a structured `docs/ai/` context store with cap/archive/index enforcement. Use when the user wants to bootstrap `docs/ai/`, set up the Memory Map and session protocols, install the docs-rotation pre-commit hook, or run `/agent-workflow-memory` / `/agent-workflow-memory upgrade`. Triggers on "set up the memory system", "deploy the AI memory here", "bootstrap docs/ai", "upgrade the memory substrate". This is the substrate only — the workflow methodology (plan→execute→review, queue, Cleanup) is owned elsewhere and injected into AGENTS.md by the family composition root.
 disable-model-invocation: true
 metadata:
-  version: '8.1.2'
+  version: '8.1.3'
 ---
 
 # agent-workflow-memory

package/capability.json

@@ -3,7 +3,7 @@
   "schema": 1,
   "name": "agent-workflow-memory",
   "kind": "memory-substrate",
-  "version": "8.1.2",
+  "version": "8.1.3",
   "provides": ["context"],
   "roles": {},
   "detect": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sabaiway/agent-workflow-memory",
-  "version": "8.1.2",
+  "version": "8.1.3",
   "description": "Portable, cross-agent memory substrate for AI coding agents — an AGENTS.md entry point + docs/ai context with cap/archive/index enforcement, deployable standalone or as part of the agent-workflow family. The memory layer of the agent-workflow family.",
   "keywords": [
     "ai-agents",

package/references/scripts/archive-decisions.mjs

@@ -2,7 +2,7 @@
 // One-file-per-ADR store for docs/ai/decisions.md (ADRs) — the durable replacement for the retired
 // 3-tier cascade (HOT → WARM archive → a single COLD monolith whose cap was raised release after
 // release). Every ADR beyond the HOT window becomes its OWN immutable record so no artifact is ever
-// O(n) and no cap is ever raised again.
+// O(n) and no cap is raised by hand again (the navigator stamps its own count past 200).
 //
 // HOT   (docs/ai/decisions.md)          — the active ADR window (newest at the bottom), self-bounding
 //                                         under its own frontmatter maxLines.
@@ -95,7 +95,8 @@ export const ADR_DIR_REL = 'docs/ai/adr';
 export const NAV_REL = 'docs/ai/adr/log.md';
 
 // A per-record cap (generous vs the largest real ADR ~74 lines; a body over it is a genuine smell) and
-// the navigator cap (bounded — exceeding it is the future plateau-shard trigger, Decision 8).
+// the navigator's FLOOR: the navigator stamps 200 while it fits and its own line count past it, since
+// nothing rotates a governing row out (docs/ai/specs/memory/adr-navigator.md).
 export const RECORD_CAP = 400;
 export const NAV_MAXLINES = 200;
 // How many most-recent ids the navigator's recent window carries (status-annotated, incl. supersessions).
@@ -701,8 +702,8 @@ export const computeGoverningIds = (entries) => {
   return new Set(entries.filter((e) => e.status === IN_FORCE_STATUS && !superseded.has(e.id)).map((e) => e.id));
 };
 
-const NAV_FRONTMATTER = (today) =>
-  `---\ntype: reference\nlastUpdated: ${today}\nscope: permanent\nstaleAfter: never\nowner: none\nmaxLines: ${NAV_MAXLINES}\n---\n`;
+const NAV_FRONTMATTER = (today, cap) =>
+  `---\ntype: reference\nlastUpdated: ${today}\nscope: permanent\nstaleAfter: never\nowner: none\nmaxLines: ${cap}\n---\n`;
 
 // Build docs/ai/adr/log.md from the WHOLE corpus (HOT entries ∪ adr/ records). Governing heads
 // (accepted ∧ not-superseded) sorted newest-first; superseded ADRs drop OUT (still reachable by
@@ -744,7 +745,9 @@ export const buildNavigator = (corpus, today) => {
     '',
     ...recent,
   ].join('\n');
-  return `${NAV_FRONTMATTER(today)}\n${body}\n`;
+  // The cap sits on one line whatever its value, so the count with the floor is the final count.
+  const count = lineCountOf(`${NAV_FRONTMATTER(today, NAV_MAXLINES)}\n${body}\n`);
+  return `${NAV_FRONTMATTER(today, Math.max(NAV_MAXLINES, count))}\n${body}\n`;
 };
 
 // ── snapshot (durable, pre-delete — Decision 5) ─────────────────────────────────────────

package/references/scripts/archive-decisions.test.mjs

@@ -800,6 +800,47 @@ describe('1.5 navigator — governing heads (computed), superseded drop out but
   });
 });
 
+// ── the navigator's stamped cap (docs/ai/specs/memory/adr-navigator.md) ─────────────────
+//
+// The frame is 38 lines (15 ADRs or more), so 162 governing heads make exactly 200, 163 make 201 and 170 make 208.
+
+const capOf = (text) => Number(text.match(/^maxLines: (\d+)$/m)[1]);
+const corpusOf = (n) =>
+  Array.from({ length: n }, (_, i) => {
+    const id = String(i + 1).padStart(3, '0');
+    return { id, idNum: i + 1, title: `T${id}`, status: 'accepted', supersedes: [], supersededBy: [], fileName: `AD-${id}-t.md` };
+  });
+
+describe('the navigator stamps a cap it honours', () => {
+  it('200 while it fits, its own line count past it', () => {
+    // spec:adr-navigator/S1
+    for (const heads of [2, 162]) {
+      const nav = buildNavigator(corpusOf(heads), '2026-07-09');
+      assert.equal(capOf(nav), 200, `${heads} heads keep the 200 floor`);
+    }
+    assert.equal(lineCountOf(buildNavigator(corpusOf(162), '2026-07-09')), 200);
+    // 165 entries, two superseded: 163 heads, 201 lines — a stamp from the entry count would read 203.
+    const corpus = corpusOf(165).map((e, i) => (i < 2 ? { ...e, supersededBy: ['003'] } : e));
+    const big = buildNavigator(corpus, '2026-07-09');
+    assert.equal(lineCountOf(big), 201);
+    assert.equal(capOf(big), 201, 'past the floor the stamp is the file\'s own count');
+  });
+
+  it('a written navigator past 200 lines fits its cap, --check is green, a hand-edited cap is stale', () => {
+    // spec:adr-navigator/S2
+    const root = makeRoot();
+    seedMigrated(root, { hotIds: ['901'], storeIds: corpusOf(169).map((e) => e.id) });
+    const nav = readFileSync(join(root, NAV_REL), 'utf8');
+    assert.ok(lineCountOf(nav) > 200, 'the fixture is past the floor');
+    assert.ok(lineCountOf(nav) <= capOf(nav), 'the docs gate accepts the written navigator');
+    assert.equal(run(['--check', '--today=2026-07-09'], root).code, 0);
+    writeFileSync(join(root, NAV_REL), nav.replace(/^maxLines: \d+$/m, 'maxLines: 999'));
+    const stale = run(['--check', '--today=2026-07-09'], root);
+    assert.equal(stale.code, 1);
+    assert.match(stale.errText, /log\.md is stale/);
+  });
+});
+
 // ── item (h) degrade branches on the REAL default regenerator (no injection) ───────────
 
 describe('defaultRegenerateIndex — loud-degrade branches', () => {