@aperant/framework 0.6.2

package/dist/__tests__/seed-validate-cli.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * C12 — apt-tools seed validate (AC6, AC11).
+ *
+ * Exit non-zero + JSON drift report when seeds.json disagrees with any
+ * scoped milestones.json. Exit 0 on a clean state. The assign/unassign
+ * post-check runs validate internally and surfaces a drift_warning on the
+ * mutation envelope when a hand-edit has left things out of sync — the
+ * mutation itself still succeeds.
+ */
+export {};
+//# sourceMappingURL=seed-validate-cli.test.d.ts.map

package/dist/__tests__/seed-validate-cli.test.d.ts.map

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

package/dist/__tests__/seed-validate-cli.test.js

@@ -0,0 +1,149 @@
+/**
+ * C12 — apt-tools seed validate (AC6, AC11).
+ *
+ * Exit non-zero + JSON drift report when seeds.json disagrees with any
+ * scoped milestones.json. Exit 0 on a clean state. The assign/unassign
+ * post-check runs validate internally and surfaces a drift_warning on the
+ * mutation envelope when a hand-edit has left things out of sync — the
+ * mutation itself still succeeds.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { createTmpProject, runCli, seedMilestone } from '../__test-helpers/tmp-project';
+describe('C12 — seed validate CLI', () => {
+    let cleanup = null;
+    afterEach(() => {
+        if (cleanup) {
+            cleanup();
+            cleanup = null;
+        }
+    });
+    it('exits 0 when seeds.json + milestones.json agree', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        runCli(['seed', 'init', '.'], project.dir);
+        runCli(['seed', 'create', '.', '--id', 's', '--title', 'S'], project.dir);
+        runCli(['seed', 'assign', '.', '--id', 's', '--milestone', 'm1'], project.dir);
+        const result = runCli(['seed', 'validate', '.'], project.dir);
+        expect(result.status).toBe(0);
+        expect(result.json?.status).toBe('ok');
+        expect(result.json?.drift_count).toBe(0);
+    });
+    it('exits 0 on an uninitialized project (no seeds.json, no roadmap)', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        const result = runCli(['seed', 'validate', '.'], project.dir);
+        expect(result.status).toBe(0);
+    });
+    it('exits 1 and names the specific drifted milestone when seed_id is deleted by hand', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        runCli(['seed', 'init', '.'], project.dir);
+        runCli(['seed', 'create', '.', '--id', 's', '--title', 'S'], project.dir);
+        runCli(['seed', 'assign', '.', '--id', 's', '--milestone', 'm1'], project.dir);
+        // Hand-edit: strip seed_id from the milestone.
+        const mPath = join(project.dir, '.aperant/roadmap/framework/milestones.json');
+        const rm = JSON.parse(readFileSync(mPath, 'utf-8'));
+        delete rm.milestones[0].seed_id;
+        writeFileSync(mPath, `${JSON.stringify(rm, null, 2)}\n`);
+        // Also scrub the per-phase layout so phases/-preferred reads see it too.
+        // NOTE: the phases/ layout stores phase records (not milestone records),
+        // so milestone seed_id only lives on milestones.json — nothing to strip
+        // from phases/. The validator reads via loadRoadmapForScope which
+        // prefers phases/, reconstructing milestones without seed_id. That
+        // matches the hand-edited milestones.json after a phases/ migration.
+        const result = runCli(['seed', 'validate', '.'], project.dir);
+        expect(result.status).not.toBe(0);
+        expect(result.json?.status).toBe('error');
+        expect(result.json?.drift_count).toBeGreaterThan(0);
+        const drift = result.json?.drift;
+        // seeds.json still points at m1 — so missing-seed-id is the expected
+        // taxonomy entry.
+        const missing = drift.find((d) => d.kind === 'missing-seed-id');
+        expect(missing).toBeDefined();
+        expect(missing.milestone_id).toBe('m1');
+    });
+    it('exits 1 when a dangling seed_id references an unknown seed', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        runCli(['seed', 'init', '.'], project.dir);
+        // Hand-edit: set seed_id on the milestone WITHOUT creating the seed.
+        const mPath = join(project.dir, '.aperant/roadmap/framework/milestones.json');
+        const rm = JSON.parse(readFileSync(mPath, 'utf-8'));
+        rm.milestones[0].seed_id = 'ghost';
+        writeFileSync(mPath, `${JSON.stringify(rm, null, 2)}\n`);
+        const result = runCli(['seed', 'validate', '.'], project.dir);
+        expect(result.status).not.toBe(0);
+        const drift = result.json?.drift;
+        expect(drift.some((d) => d.kind === 'dangling-seed-id' && d.seed_id === 'ghost')).toBe(true);
+    });
+    it('assign post-check surfaces drift_warning when a prior hand-edit left things stale', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        // seedMilestone overwrites the whole milestones.json, so we inline a
+        // two-milestone seed rather than calling the helper twice.
+        const mPath = join(project.dir, '.aperant/roadmap/framework/milestones.json');
+        mkdirSync(dirname(mPath), { recursive: true });
+        writeFileSync(mPath, `${JSON.stringify({
+            version: 1,
+            project: 'test',
+            scope: 'framework',
+            milestones: [
+                {
+                    id: 'm1',
+                    title: 'm1',
+                    goal: 'test',
+                    scope: 'framework',
+                    phases: [
+                        {
+                            id: 'p1',
+                            title: 'p1',
+                            description: 'test',
+                            status: 'planned',
+                            owner: 'test',
+                            scope: 'framework',
+                        },
+                    ],
+                },
+                {
+                    id: 'm2',
+                    title: 'm2',
+                    goal: 'test',
+                    scope: 'framework',
+                    phases: [
+                        {
+                            id: 'p2',
+                            title: 'p2',
+                            description: 'test',
+                            status: 'planned',
+                            owner: 'test',
+                            scope: 'framework',
+                        },
+                    ],
+                },
+            ],
+        }, null, 2)}\n`);
+        runCli(['seed', 'init', '.'], project.dir);
+        runCli(['seed', 'create', '.', '--id', 's', '--title', 'S'], project.dir);
+        // Hand-edit: set seed_id on m2 to a ghost seed so the file is dirty
+        // before we run assign on m1. The assign succeeds, but the post-check
+        // should surface the pre-existing drift on m2.
+        const rm = JSON.parse(readFileSync(mPath, 'utf-8'));
+        const m2 = rm.milestones.find((m) => m.id === 'm2');
+        m2.seed_id = 'ghost';
+        writeFileSync(mPath, `${JSON.stringify(rm, null, 2)}\n`);
+        const result = runCli(['seed', 'assign', '.', '--id', 's', '--milestone', 'm1'], project.dir);
+        expect(result.status).toBe(0);
+        expect(result.json?.status).toBe('ok');
+        // Primary mutation succeeded...
+        // ...but the lingering drift from the hand-edit is reported via drift_warning.
+        expect(result.json?.drift_warning).toBeDefined();
+        const warn = result.json?.drift_warning;
+        expect(warn.drift_count).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=seed-validate-cli.test.js.map

package/dist/__tests__/seed-validate-cli.test.js.map

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

package/dist/__tests__/seeds-io.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * C12 — seeds I/O primitives: load/save + pure lookups.
+ *
+ * Covers:
+ *   (a) emptySeedsFile returns the documented {version:1, seeds:[]} shape.
+ *   (b) loadSeeds returns null when seeds.json is absent (AC9 pre-cond).
+ *   (c) saveSeeds creates the file atomically + stamps updated_at.
+ *   (d) findSeed / findSeedForMilestone are pure lookups.
+ */
+export {};
+//# sourceMappingURL=seeds-io.test.d.ts.map

package/dist/__tests__/seeds-io.test.d.ts.map

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

package/dist/__tests__/seeds-io.test.js

@@ -0,0 +1,145 @@
+/**
+ * C12 — seeds I/O primitives: load/save + pure lookups.
+ *
+ * Covers:
+ *   (a) emptySeedsFile returns the documented {version:1, seeds:[]} shape.
+ *   (b) loadSeeds returns null when seeds.json is absent (AC9 pre-cond).
+ *   (c) saveSeeds creates the file atomically + stamps updated_at.
+ *   (d) findSeed / findSeedForMilestone are pure lookups.
+ */
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { emptySeedsFile, findSeed, findSeedForMilestone, loadSeeds, loadSeedsOrEmpty, saveSeeds, seedsJsonPath, writeSeedsUnlocked, } from '../cli/seeds/io.mjs';
+let tmp;
+beforeEach(() => {
+    tmp = mkdtempSync(join(tmpdir(), 'apt-seeds-io-'));
+});
+afterEach(() => {
+    /* best-effort cleanup */
+});
+describe('C12 — seeds io', () => {
+    it('emptySeedsFile returns the documented {version:1, seeds:[]} shape', () => {
+        const empty = emptySeedsFile();
+        expect(empty.version).toBe(1);
+        expect(Array.isArray(empty.seeds)).toBe(true);
+        expect(empty.seeds).toHaveLength(0);
+        expect(typeof empty.updated_at).toBe('string');
+    });
+    it('loadSeeds returns null when seeds.json does not exist (AC9)', () => {
+        expect(loadSeeds(tmp)).toBeNull();
+    });
+    it('loadSeedsOrEmpty fills in the empty shape when the file is absent', () => {
+        const seeds = loadSeedsOrEmpty(tmp);
+        expect(seeds.version).toBe(1);
+        expect(seeds.seeds).toEqual([]);
+    });
+    it('saveSeeds writes the file atomically and stamps updated_at', () => {
+        const payload = {
+            version: 1,
+            seeds: [
+                {
+                    id: 's1',
+                    title: 'Seed 1',
+                    goal: '',
+                    status: 'active',
+                    milestones: [],
+                    created_at: '2026-04-16T00:00:00.000Z',
+                    closed_at: null,
+                },
+            ],
+        };
+        saveSeeds(tmp, payload);
+        const path = seedsJsonPath(tmp);
+        expect(existsSync(path)).toBe(true);
+        const written = JSON.parse(readFileSync(path, 'utf-8'));
+        expect(written.seeds[0].id).toBe('s1');
+        expect(written.version).toBe(1);
+        expect(typeof written.updated_at).toBe('string');
+        // updated_at should have been refreshed by saveSeeds (ISO-8601).
+        expect(written.updated_at).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+    it('saveSeeds round-trips through loadSeeds', () => {
+        saveSeeds(tmp, {
+            version: 1,
+            seeds: [
+                {
+                    id: 's-roundtrip',
+                    title: 'Roundtrip',
+                    status: 'active',
+                    milestones: [{ scope: 'framework', milestone_id: 'fw-p0-critical' }],
+                    created_at: '2026-04-16T00:00:00.000Z',
+                    closed_at: null,
+                },
+            ],
+        });
+        const loaded = loadSeeds(tmp);
+        expect(loaded).not.toBeNull();
+        expect(loaded.seeds).toHaveLength(1);
+        expect(loaded.seeds[0].id).toBe('s-roundtrip');
+        expect(loaded.seeds[0].milestones[0].milestone_id).toBe('fw-p0-critical');
+    });
+    it('loadSeeds returns null on a malformed file (no crash)', () => {
+        const path = seedsJsonPath(tmp);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, '{ not valid json');
+        // Even with a broken file, loadSeeds swallows the parse error. The CLI
+        // layer surfaces a clearer error message.
+        expect(loadSeeds(tmp)).toBeNull();
+    });
+    it('writeSeedsUnlocked writes without acquiring its own lock', () => {
+        // Just verify the write still lands — used inside an outer withFileLock
+        // in the two-sided atomic write path.
+        writeSeedsUnlocked(tmp, {
+            version: 1,
+            seeds: [
+                {
+                    id: 'unlocked',
+                    title: 'Unlocked',
+                    status: 'active',
+                    milestones: [],
+                    created_at: '2026-04-16T00:00:00.000Z',
+                    closed_at: null,
+                },
+            ],
+        });
+        const loaded = loadSeeds(tmp);
+        expect(loaded.seeds[0].id).toBe('unlocked');
+    });
+    it('findSeed returns the seed by id, undefined otherwise', () => {
+        const f = {
+            version: 1,
+            seeds: [
+                { id: 'a', title: 'A', status: 'active', milestones: [] },
+                { id: 'b', title: 'B', status: 'active', milestones: [] },
+            ],
+        };
+        expect(findSeed(f, 'a')?.title).toBe('A');
+        expect(findSeed(f, 'missing')).toBeUndefined();
+        expect(findSeed(null, 'a')).toBeUndefined();
+    });
+    it('findSeedForMilestone returns the seed that owns the (scope, id) pair', () => {
+        const f = {
+            version: 1,
+            seeds: [
+                {
+                    id: 'alpha',
+                    title: 'Alpha',
+                    status: 'active',
+                    milestones: [{ scope: 'framework', milestone_id: 'm1' }],
+                },
+                {
+                    id: 'beta',
+                    title: 'Beta',
+                    status: 'active',
+                    milestones: [{ scope: 'project', milestone_id: 'm2' }],
+                },
+            ],
+        };
+        expect(findSeedForMilestone(f, 'framework', 'm1')?.id).toBe('alpha');
+        expect(findSeedForMilestone(f, 'project', 'm2')?.id).toBe('beta');
+        expect(findSeedForMilestone(f, 'framework', 'm2')).toBeUndefined();
+    });
+});
+//# sourceMappingURL=seeds-io.test.js.map

package/dist/__tests__/seeds-io.test.js.map

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

package/dist/__tests__/seeds-render.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * C12 — `apt-tools roadmap render --seeds` (AC7).
+ *
+ * Covers:
+ *   (a) `--seeds` writes .aperant/roadmap/SEEDS.md with the seed title as H2.
+ *   (b) Auto-render on `roadmap render` (no --scope filter) when seeds.json
+ *       has entries — SEEDS.md is emitted alongside the per-scope ROADMAP.md.
+ *   (c) Dormant / completed / archived seeds render under a single collapsed
+ *       footer rather than full H2 sections.
+ *   (d) Orphan seed refs (pointing at a milestone that no longer exists)
+ *       don't crash the render — they surface as `_orphan ref_`.
+ *   (e) Missing seeds.json with `--seeds` flag is non-fatal — returns a
+ *       structured note instead of a crash.
+ *   (f) Task counts pulled from state.json active/completed maps.
+ *
+ * The deeper markdown shape is exercised by unit tests on
+ * renderSeedsMd directly; this file focuses on the CLI wiring + file I/O.
+ */
+export {};
+//# sourceMappingURL=seeds-render.test.d.ts.map

package/dist/__tests__/seeds-render.test.d.ts.map

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

package/dist/__tests__/seeds-render.test.js

@@ -0,0 +1,145 @@
+/**
+ * C12 — `apt-tools roadmap render --seeds` (AC7).
+ *
+ * Covers:
+ *   (a) `--seeds` writes .aperant/roadmap/SEEDS.md with the seed title as H2.
+ *   (b) Auto-render on `roadmap render` (no --scope filter) when seeds.json
+ *       has entries — SEEDS.md is emitted alongside the per-scope ROADMAP.md.
+ *   (c) Dormant / completed / archived seeds render under a single collapsed
+ *       footer rather than full H2 sections.
+ *   (d) Orphan seed refs (pointing at a milestone that no longer exists)
+ *       don't crash the render — they surface as `_orphan ref_`.
+ *   (e) Missing seeds.json with `--seeds` flag is non-fatal — returns a
+ *       structured note instead of a crash.
+ *   (f) Task counts pulled from state.json active/completed maps.
+ *
+ * The deeper markdown shape is exercised by unit tests on
+ * renderSeedsMd directly; this file focuses on the CLI wiring + file I/O.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { createTmpProject, runCli, seedMilestone } from '../__test-helpers/tmp-project';
+import { renderSeedsMd } from '../cli/seeds/render.mjs';
+describe('C12 — roadmap render --seeds (SEEDS.md)', () => {
+    let cleanup = null;
+    afterEach(() => {
+        if (cleanup) {
+            cleanup();
+            cleanup = null;
+        }
+    });
+    it('--seeds writes SEEDS.md with the seed title as H2 (AC7)', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        runCli(['seed', 'init', '.'], project.dir);
+        runCli(['seed', 'create', '.', '--id', 'parity', '--title', 'Close parity gaps'], project.dir);
+        runCli(['seed', 'assign', '.', '--id', 'parity', '--milestone', 'm1'], project.dir);
+        const result = runCli(['roadmap', 'render', '.', '--seeds'], project.dir);
+        expect(result.status).toBe(0);
+        expect(result.json?.status).toBe('ok');
+        const seeds = result.json?.seeds;
+        expect(seeds).not.toBeNull();
+        expect(seeds.seed_count).toBe(1);
+        const seedsMd = readFileSync(join(project.dir, '.aperant/roadmap/SEEDS.md'), 'utf-8');
+        expect(seedsMd).toContain('# Seeds');
+        expect(seedsMd).toContain('## Close parity gaps');
+        expect(seedsMd).toContain('`parity`');
+        expect(seedsMd).toMatch(/\| framework \| \*\*m1\*\*/);
+    });
+    it('plain `roadmap render` auto-emits SEEDS.md when seeds.json has entries', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        runCli(['seed', 'init', '.'], project.dir);
+        runCli(['seed', 'create', '.', '--id', 'parity', '--title', 'Close parity gaps'], project.dir);
+        runCli(['seed', 'assign', '.', '--id', 'parity', '--milestone', 'm1'], project.dir);
+        // No --seeds flag, no --scope filter → should auto-render.
+        const result = runCli(['roadmap', 'render', '.'], project.dir);
+        expect(result.status).toBe(0);
+        expect(existsSync(join(project.dir, '.aperant/roadmap/SEEDS.md'))).toBe(true);
+    });
+    it('plain `roadmap render` skips SEEDS.md when seeds.json is absent', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        const result = runCli(['roadmap', 'render', '.'], project.dir);
+        expect(result.status).toBe(0);
+        expect(existsSync(join(project.dir, '.aperant/roadmap/SEEDS.md'))).toBe(false);
+    });
+    it('--seeds on a project with no seeds.json reports non-fatal', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        const result = runCli(['roadmap', 'render', '.', '--seeds'], project.dir);
+        expect(result.status).toBe(0);
+        const seeds = result.json?.seeds;
+        expect(seeds?.path).toBeNull();
+        expect(String(seeds?.note ?? '')).toMatch(/no seeds\.json/);
+    });
+    it('dormant/completed/archived seeds render in the collapsed footer', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        runCli(['seed', 'init', '.'], project.dir);
+        runCli(['seed', 'create', '.', '--id', 'active-seed', '--title', 'Active'], project.dir);
+        runCli(['seed', 'create', '.', '--id', 'done-seed', '--title', 'Done'], project.dir);
+        runCli(['seed', 'close', '.', '--id', 'done-seed'], project.dir);
+        runCli(['roadmap', 'render', '.', '--seeds'], project.dir);
+        const seedsMd = readFileSync(join(project.dir, '.aperant/roadmap/SEEDS.md'), 'utf-8');
+        // Active — full H2.
+        expect(seedsMd).toContain('## Active');
+        // Done — footer bullet, NOT a full H2 section.
+        expect(seedsMd).toContain('## Dormant / completed / archived');
+        expect(seedsMd).toMatch(/- \*\*Done\*\* `done-seed` \(completed\)/);
+        // And not duplicated as an H2.
+        expect(seedsMd).not.toMatch(/\n## Done\n/);
+    });
+    it('renderSeedsMd (unit) surfaces orphan refs without crashing', () => {
+        // Direct call on the pure function — a seed points at (framework, m-ghost)
+        // which does not exist in any roadmap. We expect the render to include
+        // the ref with a placeholder cell rather than throwing.
+        const seedsFile = {
+            version: 1,
+            seeds: [
+                {
+                    id: 'ghost-seed',
+                    title: 'Ghost seed',
+                    status: 'active',
+                    milestones: [{ scope: 'framework', milestone_id: 'm-ghost' }],
+                },
+            ],
+        };
+        const roadmapsByScope = new Map([['framework', { scope: 'framework', milestones: [] }]]);
+        const md = renderSeedsMd(seedsFile, roadmapsByScope, { active_tasks: {} });
+        expect(md).toContain('## Ghost seed');
+        expect(md).toContain('_orphan ref_');
+    });
+    it('task counts come from state.json active + completed maps', () => {
+        const project = createTmpProject();
+        cleanup = project.cleanup;
+        seedMilestone(project.dir, 'm1', 'p1', 'framework');
+        runCli(['seed', 'init', '.'], project.dir);
+        runCli(['seed', 'create', '.', '--id', 's', '--title', 'S'], project.dir);
+        runCli(['seed', 'assign', '.', '--id', 's', '--milestone', 'm1'], project.dir);
+        // Hand-edit state.json: inject one active + two completed tasks pointing at m1.
+        const statePath = join(project.dir, '.aperant/state.json');
+        const state = JSON.parse(readFileSync(statePath, 'utf-8'));
+        state.active_tasks = {
+            't-active': { id: 't-active', scope: 'framework', milestone_id: 'm1' },
+        };
+        state.completed_tasks = [
+            { id: 't-done-1', scope: 'framework', milestone_id: 'm1' },
+            { id: 't-done-2', scope: 'framework', milestone_id: 'm1' },
+        ];
+        writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`);
+        runCli(['roadmap', 'render', '.', '--seeds'], project.dir);
+        const seedsMd = readFileSync(join(project.dir, '.aperant/roadmap/SEEDS.md'), 'utf-8');
+        // Seed-level summary.
+        expect(seedsMd).toContain('**Tasks:** 1 active / 2 completed');
+        // Per-milestone row.
+        expect(seedsMd).toMatch(/\| 1 \/ 2 \|/);
+    });
+});
+//# sourceMappingURL=seeds-render.test.js.map

package/dist/__tests__/seeds-render.test.js.map

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

package/dist/__tests__/seeds-validate.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * C12 — seeds validate: mutual-consistency audit between seeds.json and the
+ * per-scope milestones.json files. Pure-function tests (AC6 is exercised by
+ * the CLI test; this locks down the drift taxonomy).
+ */
+export {};
+//# sourceMappingURL=seeds-validate.test.d.ts.map

package/dist/__tests__/seeds-validate.test.d.ts.map

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