@aperant/framework 0.6.2

package/dist/__tests__/apt-review-pass6-structure.test.js

@@ -0,0 +1,44 @@
+/**
+ * apt-review-pass6-structure.test.ts — locks the apt-review Pass 6 section
+ * (C33 AC16, AC19) plus reviewer agent-def parity.
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { describe, expect, it } from 'vitest';
+const FRAMEWORK_ROOT = resolve(__dirname, '..', '..');
+const SKILL_PATH = resolve(FRAMEWORK_ROOT, 'skills', 'apt-review', 'SKILL.md');
+const REVIEWER_AGENT = resolve(FRAMEWORK_ROOT, 'agents', 'apt-reviewer.md');
+describe('apt-review SKILL.md — Pass 6 structure', () => {
+    const skill = readFileSync(SKILL_PATH, 'utf-8');
+    it('contains Pass 6 anchor (AC16, AC19)', () => {
+        expect(skill).toMatch(/Pass 6/);
+    });
+    it('references apt-tools docs-audit (AC19)', () => {
+        expect(skill).toMatch(/apt-tools docs-audit/);
+    });
+    it('references apt-tools features-audit (AC19)', () => {
+        expect(skill).toMatch(/apt-tools features-audit/);
+    });
+    it('distinguishes flag-drift from auto-update', () => {
+        expect(skill).toMatch(/flag-drift/);
+        expect(skill).toMatch(/auto-update/);
+    });
+    it('enforces non-edit rule for flag-drift findings', () => {
+        // The SKILL must state explicitly that flag-drift findings are
+        // surfaced-only — never auto-edited.
+        expect(skill).toMatch(/never auto-edit|Never auto-edit|surfaced only|surfaced-only/i);
+    });
+    it('fix-loop section mentions iterations 1-2 handle auto-update', () => {
+        expect(skill).toMatch(/[Ii]terations? 1[\s-]*2/);
+        expect(skill).toMatch(/auto-update/);
+    });
+});
+describe('apt-reviewer agent def — 6-pass mention (AC19)', () => {
+    const agentDef = readFileSync(REVIEWER_AGENT, 'utf-8');
+    it('mentions 6 passes or docs-coherence', () => {
+        const hasSixPasses = /6 passes/.test(agentDef);
+        const hasDocsCoherence = /docs-coherence/.test(agentDef);
+        expect(hasSixPasses || hasDocsCoherence).toBe(true);
+    });
+});
+//# sourceMappingURL=apt-review-pass6-structure.test.js.map

package/dist/__tests__/apt-review-pass6-structure.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apt-review-pass6-structure.test.js","sourceRoot":"","sources":["../../src/__tests__/apt-review-pass6-structure.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AACrD,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;AAC9E,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAA;AAE3E,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACvD,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAE/C,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACzD,+DAA+D;QAC/D,qCAAqC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,8DAA8D,CAAC,CAAA;IACtF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAA;QAChD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAEtD,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC9C,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9C,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACxD,MAAM,CAAC,YAAY,IAAI,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/apt-setup-batch7-structure.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * apt-setup-batch7-structure.test.ts — locks the Batch 7 docs-policy picker
+ * and its parity with the policy defaults (C33 AC12, AC15, AC20).
+ */
+export {};
+//# sourceMappingURL=apt-setup-batch7-structure.test.d.ts.map

package/dist/__tests__/apt-setup-batch7-structure.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apt-setup-batch7-structure.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/apt-setup-batch7-structure.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/__tests__/apt-setup-batch7-structure.test.js

@@ -0,0 +1,38 @@
+/**
+ * apt-setup-batch7-structure.test.ts — locks the Batch 7 docs-policy picker
+ * and its parity with the policy defaults (C33 AC12, AC15, AC20).
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { DEFAULT_DOCS_POLICY } from '../cli/docs-audit/policy.mjs';
+const FRAMEWORK_ROOT = resolve(__dirname, '..', '..');
+const SKILL_PATH = resolve(FRAMEWORK_ROOT, 'skills', 'apt-setup', 'SKILL.md');
+describe('apt-setup SKILL.md — Batch 7 docs-policy picker', () => {
+    const skill = readFileSync(SKILL_PATH, 'utf-8');
+    it('contains a Batch 7 / Docs Policy section header (AC12, AC20)', () => {
+        expect(skill).toMatch(/Batch 7|Docs Policy/);
+    });
+    it('references .aperant/config.json.docs_policy', () => {
+        expect(skill).toMatch(/\.aperant\/config\.json\.docs_policy|docs_policy/);
+    });
+    it('includes AskUserQuestion(multiSelect: true) block', () => {
+        expect(skill).toMatch(/multiSelect:\s*true/);
+    });
+    it('mentions the numbered-input fallback for non-structured hosts', () => {
+        expect(skill).toMatch(/numbered|fallback/i);
+    });
+    it('extends the Step 8 confirmation table with a Docs Policy row', () => {
+        // The row shape: | Docs Policy | ... |
+        expect(skill).toMatch(/\|\s*Docs Policy\s*\|/);
+    });
+    it('references every default surface (AC15 drift-prevention)', () => {
+        // Each default surface from DEFAULT_DOCS_POLICY must appear in Batch 7 prose.
+        // This is the failsafe that prevents a new policy default from slipping
+        // into the JSON without being exposed to the user.
+        for (const surface of Object.keys(DEFAULT_DOCS_POLICY)) {
+            expect(skill).toContain(surface);
+        }
+    });
+});
+//# sourceMappingURL=apt-setup-batch7-structure.test.js.map

package/dist/__tests__/apt-setup-batch7-structure.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apt-setup-batch7-structure.test.js","sourceRoot":"","sources":["../../src/__tests__/apt-setup-batch7-structure.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAElE,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AACrD,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;AAE7E,QAAQ,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAChE,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAE/C,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACvE,uCAAuC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QACnE,8EAA8E;QAC9E,wEAAwE;QACxE,mDAAmD;QACnD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QACjC,CAAC;IACF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/args.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=args.test.d.ts.map

package/dist/__tests__/args.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/args.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/args.test.js

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest';
+import { parseFlags } from '../cli/util/args.mjs';
+describe('parseFlags', () => {
+    it('parses --flag value pairs into string values', () => {
+        const flags = parseFlags(['--milestone', 'fw-p0', '--phase', 'c34']);
+        expect(flags.get('milestone')).toBe('fw-p0');
+        expect(flags.get('phase')).toBe('c34');
+    });
+    it('treats a bare --flag with no following value as boolean true', () => {
+        const flags = parseFlags(['--dry-run']);
+        expect(flags.has('dry-run')).toBe(true);
+        expect(flags.get('dry-run')).toBe(true);
+    });
+    it('treats --flag followed by another --flag as boolean true', () => {
+        const flags = parseFlags(['--dry-run', '--verbose', 'false']);
+        expect(flags.get('dry-run')).toBe(true);
+        expect(flags.get('verbose')).toBe('false');
+    });
+    it('mixes boolean flags and value flags in the same call', () => {
+        const flags = parseFlags(['--force', '--milestone', 'fw-p0', '--dry-run']);
+        expect(flags.get('force')).toBe(true);
+        expect(flags.get('milestone')).toBe('fw-p0');
+        expect(flags.get('dry-run')).toBe(true);
+    });
+    it('ignores positional args that do not start with --', () => {
+        const flags = parseFlags(['positional', '--milestone', 'fw-p0', 'trailing']);
+        expect(flags.has('positional')).toBe(false);
+        expect(flags.get('milestone')).toBe('fw-p0');
+    });
+});
+//# sourceMappingURL=args.test.js.map

package/dist/__tests__/args.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.test.js","sourceRoot":"","sources":["../../src/__tests__/args.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAA;QACpE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACvE,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QACnE,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAA;QAC7D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAA;QAC1E,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;QAC5E,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/artifacts-classification.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * C56 B4 — classification contract for .aperant/ artifact lifecycle.
+ *
+ * Tests cover:
+ *   (a) Table-driven: every rule in the spec.md §B4 table classifies exactly
+ *       the class its rule declares (no cross-contamination).
+ *   (b) Scan test: every existing path under `.aperant/` in the real repo
+ *       classifies non-null. A new subpath that the rule table doesn't cover
+ *       fails this test — forcing the classifier to be updated.
+ *   (c) Negative: secrets/tokens/proof/logs/worktrees NEVER classify
+ *       committable (R-02 belt — see spec.md risk register).
+ *   (d) Shape: filterCommittable + filterEphemeral behave as array filters;
+ *       paths outside `.aperant/` return `null` and are dropped.
+ *   (e) Normalization: `./` prefixes, trailing slashes, Windows-style
+ *       backslashes all normalize consistently.
+ */
+export {};
+//# sourceMappingURL=artifacts-classification.test.d.ts.map

package/dist/__tests__/artifacts-classification.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts-classification.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/artifacts-classification.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/artifacts-classification.test.js

@@ -0,0 +1,266 @@
+/**
+ * C56 B4 — classification contract for .aperant/ artifact lifecycle.
+ *
+ * Tests cover:
+ *   (a) Table-driven: every rule in the spec.md §B4 table classifies exactly
+ *       the class its rule declares (no cross-contamination).
+ *   (b) Scan test: every existing path under `.aperant/` in the real repo
+ *       classifies non-null. A new subpath that the rule table doesn't cover
+ *       fails this test — forcing the classifier to be updated.
+ *   (c) Negative: secrets/tokens/proof/logs/worktrees NEVER classify
+ *       committable (R-02 belt — see spec.md risk register).
+ *   (d) Shape: filterCommittable + filterEphemeral behave as array filters;
+ *       paths outside `.aperant/` return `null` and are dropped.
+ *   (e) Normalization: `./` prefixes, trailing slashes, Windows-style
+ *       backslashes all normalize consistently.
+ */
+import { readdirSync, statSync } from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { ARTIFACT_CLASS, classifyArtifactPath, classifyArtifactPathDetailed, filterCommittable, filterEphemeral, listCommittableGlobs, listEphemeralGlobs, } from '../cli/artifacts/classification.mjs';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+// framework/src/__tests__ → repo root is 4 levels up
+const REPO_ROOT = resolve(__dirname, '..', '..', '..', '..');
+describe('C56 B4 — classification contract', () => {
+    describe('ARTIFACT_CLASS codomain', () => {
+        it('exposes exactly committable and ephemeral', () => {
+            expect(ARTIFACT_CLASS.COMMITTABLE).toBe('committable');
+            expect(ARTIFACT_CLASS.EPHEMERAL).toBe('ephemeral');
+            expect(Object.isFrozen(ARTIFACT_CLASS)).toBe(true);
+        });
+    });
+    describe('listCommittableGlobs / listEphemeralGlobs', () => {
+        it('returns non-empty frozen arrays', () => {
+            const committable = listCommittableGlobs();
+            const ephemeral = listEphemeralGlobs();
+            expect(committable.length).toBeGreaterThan(0);
+            expect(ephemeral.length).toBeGreaterThan(0);
+            expect(Object.isFrozen(committable)).toBe(true);
+            expect(Object.isFrozen(ephemeral)).toBe(true);
+        });
+        it('committable and ephemeral globs are disjoint sets', () => {
+            const c = new Set(listCommittableGlobs());
+            const e = listEphemeralGlobs();
+            for (const g of e)
+                expect(c.has(g)).toBe(false);
+        });
+    });
+    describe('spec.md §B4 table rows', () => {
+        // Authoritative rows from spec.md §B4 + extensions documented in
+        // classification.mjs. Each entry: [path, expectedClass].
+        const ROWS = [
+            // ── committable ───────────────────────────────────────────────
+            ['.aperant/roadmap/framework/milestones.json', 'committable'],
+            ['.aperant/roadmap/project/phases/c12.json', 'committable'],
+            ['.aperant/roadmap/framework/ROADMAP.md', 'committable'],
+            ['.aperant/context/notes/2026-04-23.md', 'committable'],
+            ['.aperant/decisions/roundtable-a.md', 'committable'],
+            ['.aperant/features/REGISTRY.md', 'committable'],
+            ['.aperant/features/desktop/terminal.md', 'committable'],
+            ['.aperant/seeds.json', 'committable'],
+            ['.aperant/project.json', 'committable'],
+            ['.aperant/project_index.json', 'committable'],
+            ['.aperant/axes.json', 'committable'],
+            ['.aperant/config.json', 'committable'],
+            ['.aperant/rationalizations/claude-opus-4-6.md', 'committable'],
+            ['.aperant/templates/rationalizations/base.md', 'committable'],
+            ['.aperant/prompts/github/pr-body.md', 'committable'],
+            ['.aperant/benchmarks/route-eval/fixtures.json', 'committable'],
+            ['.aperant/stress-tests/planner.json', 'committable'],
+            ['.aperant/roundtables/framework-roadmap-v2-20260414/notes.md', 'committable'],
+            ['.aperant/context/installed/snapshot.json', 'committable'],
+            ['.aperant/.gitignore', 'committable'],
+            // ── ephemeral ─────────────────────────────────────────────────
+            ['.aperant/state.json', 'ephemeral'],
+            ['.aperant/active.json', 'ephemeral'],
+            ['.aperant/team.json', 'ephemeral'],
+            ['.aperant/pending-effects.jsonl', 'ephemeral'],
+            ['.aperant/events/2026-04-23.jsonl', 'ephemeral'],
+            ['.aperant/team-status/agent-42.json', 'ephemeral'],
+            ['.aperant/workflows/pr-63-260423-d57f.json', 'ephemeral'],
+            ['.aperant/workflows/archive/foo.json', 'ephemeral'],
+            ['.aperant/tasks/INDEX.md', 'ephemeral'],
+            ['.aperant/tasks/23-04-26_task-id/spec.md', 'ephemeral'],
+            ['.aperant/proof/framework/foo/screenshot.png', 'ephemeral'],
+            ['.aperant/logs/route-dropped.jsonl', 'ephemeral'],
+            ['.aperant/worktrees/framework/23-04-26_task-id/packages/framework/src/foo.mjs', 'ephemeral'],
+            ['.aperant/locks/state.lock', 'ephemeral'],
+            ['.aperant/digests/2026-04-23.json', 'ephemeral'],
+            ['.aperant/quick/quick-20260411-foo/spec.md', 'ephemeral'],
+            ['.aperant/paused/task-xyz.json', 'ephemeral'],
+            ['.aperant/reviews/pr-23-260413-09ba/findings.md', 'ephemeral'],
+            ['.aperant/plans/draft.md', 'ephemeral'],
+            ['.aperant/tmp/scratch', 'ephemeral'],
+            ['.aperant/wfrun/run-abc/result.json', 'ephemeral'],
+            ['.aperant/design/tokens.json', 'ephemeral'],
+            ['.aperant/pr-reviews/pr-62/rounds/round-1/findings.md', 'ephemeral'],
+            ['.aperant/pr-reviews/pr-62/audit.json', 'ephemeral'],
+            // 2026-04 reclassification: pr-state.json + per-round snapshots
+            // are local framework coordination, not git artifacts. PID leak in
+            // lock.owner + denormalized GitHub cache → ephemeral. See
+            // docs/artifact-lifecycle.md "PR-review artifacts are local-only".
+            ['.aperant/pr-reviews/pr-62/pr-state.json', 'ephemeral'],
+            ['.aperant/pr-reviews/pr-62/rounds/round-1/pr-state-snapshot.json', 'ephemeral'],
+            ['.aperant/secrets/gh-token.txt', 'ephemeral'],
+            ['.aperant/tokens.json', 'ephemeral'],
+            ['.aperant/.gitignore.pre-c31.backup', 'ephemeral'],
+        ];
+        for (const [path, expected] of ROWS) {
+            it(`classifies ${path} → ${expected}`, () => {
+                expect(classifyArtifactPath(path)).toBe(expected);
+            });
+        }
+    });
+    describe('unknown / out-of-scope paths', () => {
+        it('returns null for paths outside .aperant/', () => {
+            expect(classifyArtifactPath('packages/framework/src/index.ts')).toBeNull();
+            expect(classifyArtifactPath('README.md')).toBeNull();
+            expect(classifyArtifactPath('apps/desktop/package.json')).toBeNull();
+        });
+        it('returns null for unknown paths under .aperant/', () => {
+            // A path under .aperant/ that doesn't match any rule — caller must decide.
+            expect(classifyArtifactPath('.aperant/unrecognized-dir/file.json')).toBeNull();
+            expect(classifyArtifactPath('.aperant/some-new-file.json')).toBeNull();
+        });
+        it('returns null for empty / non-string inputs', () => {
+            expect(classifyArtifactPath('')).toBeNull();
+            // @ts-expect-error — runtime guard
+            expect(classifyArtifactPath(null)).toBeNull();
+            // @ts-expect-error — runtime guard
+            expect(classifyArtifactPath(undefined)).toBeNull();
+        });
+    });
+    describe('R-02 belt — secrets/tokens/proof/logs/worktrees never classify committable', () => {
+        const NEVER_COMMITTABLE = [
+            '.aperant/secrets/a.txt',
+            '.aperant/secrets/nested/b.json',
+            '.aperant/tokens.json',
+            '.aperant/proof/project/x/y.png',
+            '.aperant/proof/framework/23-04-26_task/screenshots/00.png',
+            '.aperant/logs/route-dropped.jsonl',
+            '.aperant/logs/classify.jsonl',
+            '.aperant/worktrees/framework/23-04-26_task/packages/foo.ts',
+            '.aperant/worktrees/project/some-task/packages/ui/index.tsx',
+        ];
+        for (const p of NEVER_COMMITTABLE) {
+            it(`${p} does not classify committable`, () => {
+                expect(classifyArtifactPath(p)).not.toBe('committable');
+            });
+        }
+    });
+    describe('filterCommittable / filterEphemeral', () => {
+        const mixed = [
+            '.aperant/roadmap/framework/milestones.json', // committable
+            '.aperant/state.json', // ephemeral
+            'packages/framework/src/foo.mjs', // null (outside)
+            '.aperant/events/2026-04-23.jsonl', // ephemeral
+            '.aperant/project.json', // committable
+            '.aperant/unrecognized/x.json', // null (unknown)
+        ];
+        it('filterCommittable keeps only committable paths, preserves order', () => {
+            expect(filterCommittable(mixed)).toEqual([
+                '.aperant/roadmap/framework/milestones.json',
+                '.aperant/project.json',
+            ]);
+        });
+        it('filterEphemeral keeps only ephemeral paths, preserves order', () => {
+            expect(filterEphemeral(mixed)).toEqual([
+                '.aperant/state.json',
+                '.aperant/events/2026-04-23.jsonl',
+            ]);
+        });
+        it('filter functions tolerate non-array inputs', () => {
+            // @ts-expect-error — runtime guard
+            expect(filterCommittable(null)).toEqual([]);
+            // @ts-expect-error — runtime guard
+            expect(filterEphemeral(undefined)).toEqual([]);
+        });
+    });
+    describe('normalization', () => {
+        it('handles leading ./', () => {
+            expect(classifyArtifactPath('./.aperant/state.json')).toBe('ephemeral');
+            expect(classifyArtifactPath('./.aperant/project.json')).toBe('committable');
+        });
+        it('handles trailing slash on dir-like paths', () => {
+            // A trailing-slash dir path shouldn't match a glob expecting a filename;
+            // but .aperant/events/** should still match .aperant/events/foo via
+            // the normal classifier. Verify the normalization survives.
+            expect(classifyArtifactPath('.aperant/events/2026-04-23.jsonl/')).toBe('ephemeral');
+        });
+        it('handles Windows-style backslashes', () => {
+            expect(classifyArtifactPath('.aperant\\roadmap\\framework\\milestones.json')).toBe('committable');
+        });
+    });
+    describe('classifyArtifactPathDetailed', () => {
+        it('returns class + pattern + why for a known path', () => {
+            const d = classifyArtifactPathDetailed('.aperant/roadmap/framework/milestones.json');
+            expect(d).not.toBeNull();
+            expect(d?.class).toBe('committable');
+            expect(d?.pattern).toBe('.aperant/roadmap/**');
+            expect(typeof d?.why).toBe('string');
+            expect(Object.isFrozen(d)).toBe(true);
+        });
+        it('returns null for unknown path', () => {
+            expect(classifyArtifactPathDetailed('.aperant/unrecognized/x.json')).toBeNull();
+        });
+    });
+    describe('scan test — every existing .aperant/ path classifies non-null', () => {
+        // Walk the real `.aperant/` directory and assert the classifier covers
+        // every file that exists today. A new subpath added to the repo without
+        // a matching rule fails this test and forces the classifier to grow.
+        const APERANT = join(REPO_ROOT, '.aperant');
+        const IGNORED_DIRS = new Set(['worktrees']); // walk is expensive; covered by a dedicated classifier test row above
+        const files = collectFiles(APERANT, REPO_ROOT, IGNORED_DIRS);
+        // Sanity: we must have found at least a few paths to make this test
+        // meaningful. If we find zero, the walk is broken, not the classifier.
+        it('scan finds at least 10 files under .aperant/', () => {
+            expect(files.length).toBeGreaterThan(10);
+        });
+        // Use it.each so a failure names the exact offending path.
+        if (files.length > 0) {
+            it.each(files)('classifies %s non-null', (path) => {
+                expect(classifyArtifactPath(path)).not.toBeNull();
+            });
+        }
+    });
+});
+function collectFiles(root, repoRoot, ignored) {
+    const out = [];
+    walk(root, repoRoot, ignored, out);
+    return out;
+}
+function walk(dir, repoRoot, ignored, acc) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true }).map((e) => ({
+            name: e.name,
+            isDir: e.isDirectory(),
+        }));
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const abs = join(dir, entry.name);
+        const rel = relative(repoRoot, abs).split(sep).join('/');
+        if (entry.isDir) {
+            // Skip explicitly ignored top-level subdirs of .aperant/.
+            const relParts = rel.split('/');
+            if (relParts[0] === '.aperant' && relParts.length === 2 && ignored.has(relParts[1])) {
+                continue;
+            }
+            walk(abs, repoRoot, ignored, acc);
+        }
+        else {
+            try {
+                statSync(abs); // ensures symlinks-to-nowhere don't poison the walk
+                acc.push(rel);
+            }
+            catch {
+                // skip unreadable
+            }
+        }
+    }
+}
+//# sourceMappingURL=artifacts-classification.test.js.map

package/dist/__tests__/artifacts-classification.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts-classification.test.js","sourceRoot":"","sources":["../../src/__tests__/artifacts-classification.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/artifacts-self-stage.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * C56 B4 — self-staging helper tests.
+ *
+ * Covers:
+ *   (a) committable paths get staged (git add -f) in a temp git repo.
+ *   (b) ephemeral paths are dropped with reason='ephemeral'.
+ *   (c) outputs-violation paths are dropped with reason='outputs-violation'.
+ *   (d) already-staged paths are dropped with reason='already-staged'.
+ *   (e) git failure surfaces as warning, never throws.
+ *   (f) missing/invalid projectDir returns a warning, never throws.
+ *   (g) ignores paths outside the project root.
+ *   (h) absolute paths are relativized against projectDir.
+ */
+export {};
+//# sourceMappingURL=artifacts-self-stage.test.d.ts.map

package/dist/__tests__/artifacts-self-stage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts-self-stage.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/artifacts-self-stage.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}