@zigrivers/scaffold 2.1.0

package/dist/core/dependency/eligibility.js.map

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

package/dist/core/dependency/eligibility.test.d.ts

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

package/dist/core/dependency/eligibility.test.d.ts.map

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

package/dist/core/dependency/eligibility.test.js

@@ -0,0 +1,198 @@
+import { describe, it, expect } from 'vitest';
+import { buildGraph } from './graph.js';
+import { computeEligible, getParallelSets } from './eligibility.js';
+// ---------------------------------------------------------------------------
+// Test helpers
+// ---------------------------------------------------------------------------
+function makeFm(name, phase, order, dependencies) {
+    return {
+        name,
+        description: `${name} step`,
+        phase,
+        order,
+        dependencies,
+        outputs: [`out/${name}.md`],
+        conditional: null,
+        knowledgeBase: [],
+        reads: [],
+    };
+}
+function makeEntry(status) {
+    return { status, source: 'pipeline' };
+}
+// Graph: a → b → d, a → c → d
+const frontmatters = [
+    makeFm('a', 'pre', 1, []),
+    makeFm('b', 'pre', 2, ['a']),
+    makeFm('c', 'modeling', 3, ['a']),
+    makeFm('d', 'modeling', 4, ['b', 'c']),
+];
+const allEnabled = new Map([
+    ['a', { enabled: true }],
+    ['b', { enabled: true }],
+    ['c', { enabled: true }],
+    ['d', { enabled: true }],
+]);
+// ---------------------------------------------------------------------------
+// computeEligible
+// ---------------------------------------------------------------------------
+describe('computeEligible', () => {
+    it('returns steps with no deps when all pending', () => {
+        const graph = buildGraph(frontmatters, allEnabled);
+        const steps = {
+            a: makeEntry('pending'),
+            b: makeEntry('pending'),
+            c: makeEntry('pending'),
+            d: makeEntry('pending'),
+        };
+        const eligible = computeEligible(graph, steps);
+        // Only 'a' has no deps
+        expect(eligible).toEqual(['a']);
+    });
+    it('returns steps whose deps are all completed', () => {
+        const graph = buildGraph(frontmatters, allEnabled);
+        const steps = {
+            a: makeEntry('completed'),
+            b: makeEntry('pending'),
+            c: makeEntry('pending'),
+            d: makeEntry('pending'),
+        };
+        const eligible = computeEligible(graph, steps);
+        // b and c both depend only on a (completed)
+        expect(eligible).toContain('b');
+        expect(eligible).toContain('c');
+        expect(eligible).not.toContain('d'); // d needs b and c
+        expect(eligible).not.toContain('a'); // a is completed
+    });
+    it('excludes in_progress steps', () => {
+        const graph = buildGraph(frontmatters, allEnabled);
+        const steps = {
+            a: makeEntry('in_progress'),
+            b: makeEntry('pending'),
+            c: makeEntry('pending'),
+            d: makeEntry('pending'),
+        };
+        const eligible = computeEligible(graph, steps);
+        // a is in_progress (not pending) → excluded
+        expect(eligible).not.toContain('a');
+        // b and c deps (a) not completed → not eligible
+        expect(eligible).not.toContain('b');
+        expect(eligible).not.toContain('c');
+    });
+    it('excludes completed steps', () => {
+        const graph = buildGraph(frontmatters, allEnabled);
+        const steps = {
+            a: makeEntry('completed'),
+            b: makeEntry('completed'),
+            c: makeEntry('completed'),
+            d: makeEntry('pending'),
+        };
+        const eligible = computeEligible(graph, steps);
+        // Only d remains pending with all deps completed
+        expect(eligible).toEqual(['d']);
+    });
+    it('treats skipped deps as satisfied', () => {
+        const graph = buildGraph(frontmatters, allEnabled);
+        const steps = {
+            a: makeEntry('skipped'),
+            b: makeEntry('pending'),
+            c: makeEntry('pending'),
+            d: makeEntry('pending'),
+        };
+        const eligible = computeEligible(graph, steps);
+        expect(eligible).toContain('b');
+        expect(eligible).toContain('c');
+    });
+    it('treats disabled steps as satisfied for dependency resolution', () => {
+        // Disable 'a'; b and c depend on it
+        const preset = new Map([
+            ['a', { enabled: false }],
+            ['b', { enabled: true }],
+            ['c', { enabled: true }],
+            ['d', { enabled: true }],
+        ]);
+        const graph = buildGraph(frontmatters, preset);
+        const steps = {
+            b: makeEntry('pending'),
+            c: makeEntry('pending'),
+            d: makeEntry('pending'),
+        };
+        const eligible = computeEligible(graph, steps);
+        // b and c should be eligible since their dep (a) is disabled
+        expect(eligible).toContain('b');
+        expect(eligible).toContain('c');
+    });
+    it('excludes disabled steps from eligible list', () => {
+        const preset = new Map([
+            ['a', { enabled: false }],
+            ['b', { enabled: true }],
+            ['c', { enabled: true }],
+            ['d', { enabled: true }],
+        ]);
+        const graph = buildGraph(frontmatters, preset);
+        const steps = {
+            a: makeEntry('pending'),
+            b: makeEntry('pending'),
+            c: makeEntry('pending'),
+            d: makeEntry('pending'),
+        };
+        const eligible = computeEligible(graph, steps);
+        expect(eligible).not.toContain('a');
+    });
+});
+// ---------------------------------------------------------------------------
+// getParallelSets
+// ---------------------------------------------------------------------------
+describe('getParallelSets', () => {
+    it('groups steps by phase', () => {
+        const graph = buildGraph(frontmatters, allEnabled);
+        const sets = getParallelSets(graph);
+        // Two phases: 'pre' and 'modeling'
+        expect(sets).toHaveLength(2);
+        const preSet = sets[0];
+        const modelingSet = sets[1];
+        expect(preSet).toContain('a');
+        expect(preSet).toContain('b');
+        expect(modelingSet).toContain('c');
+        expect(modelingSet).toContain('d');
+    });
+    it('sorts phases by PHASE_SORT_ORDER', () => {
+        const fms = [
+            makeFm('fin', 'finalization', 9, []),
+            makeFm('pre', 'pre', 1, []),
+            makeFm('plan', 'planning', 7, []),
+        ];
+        const preset = new Map([
+            ['fin', { enabled: true }],
+            ['pre', { enabled: true }],
+            ['plan', { enabled: true }],
+        ]);
+        const graph = buildGraph(fms, preset);
+        const sets = getParallelSets(graph);
+        // pre (0) < planning (6) < finalization (8)
+        const phases = sets.map(set => {
+            const slug = set[0];
+            return graph.nodes.get(slug)?.phase;
+        });
+        expect(phases).toEqual(['pre', 'planning', 'finalization']);
+    });
+    it('excludes disabled steps', () => {
+        const preset = new Map([
+            ['a', { enabled: false }],
+            ['b', { enabled: true }],
+            ['c', { enabled: true }],
+            ['d', { enabled: true }],
+        ]);
+        const graph = buildGraph(frontmatters, preset);
+        const sets = getParallelSets(graph);
+        const allSlugs = sets.flat();
+        expect(allSlugs).not.toContain('a');
+    });
+    it('sorts steps within a phase by order field', () => {
+        const graph = buildGraph(frontmatters, allEnabled);
+        const sets = getParallelSets(graph);
+        const preSet = sets[0]; // contains a (order 1) and b (order 2)
+        expect(preSet.indexOf('a')).toBeLessThan(preSet.indexOf('b'));
+    });
+});
+//# sourceMappingURL=eligibility.test.js.map

package/dist/core/dependency/eligibility.test.js.map

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

package/dist/core/dependency/graph.d.ts

@@ -0,0 +1,12 @@
+import type { DependencyGraph } from '../../types/index.js';
+import type { MetaPromptFrontmatter } from '../../types/index.js';
+/**
+ * Build a dependency graph from meta-prompt frontmatter and the preset
+ * enablement map.
+ *
+ * edges maps slug → list of slugs that depend on it (successors / downstream).
+ */
+export declare function buildGraph(metaPrompts: MetaPromptFrontmatter[], presetSteps: Map<string, {
+    enabled: boolean;
+}>): DependencyGraph;
+//# sourceMappingURL=graph.d.ts.map

package/dist/core/dependency/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/core/dependency/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,sBAAsB,CAAA;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,qBAAqB,EAAE,EACpC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GAC7C,eAAe,CA6BjB"}

package/dist/core/dependency/graph.js

@@ -0,0 +1,34 @@
+/**
+ * Build a dependency graph from meta-prompt frontmatter and the preset
+ * enablement map.
+ *
+ * edges maps slug → list of slugs that depend on it (successors / downstream).
+ */
+export function buildGraph(metaPrompts, presetSteps) {
+    const nodes = new Map();
+    const edges = new Map();
+    // Initialise nodes and empty successor lists
+    for (const mp of metaPrompts) {
+        const enabled = presetSteps.get(mp.name)?.enabled ?? true;
+        nodes.set(mp.name, {
+            slug: mp.name,
+            phase: mp.phase,
+            order: mp.order,
+            dependencies: mp.dependencies,
+            enabled,
+        });
+        edges.set(mp.name, []);
+    }
+    // Build edges: for each step, for each dep, push this step onto dep's successor list
+    for (const mp of metaPrompts) {
+        for (const dep of mp.dependencies) {
+            const successors = edges.get(dep);
+            if (successors) {
+                successors.push(mp.name);
+            }
+            // Unknown deps are caught by detectCycles → DEP_TARGET_MISSING
+        }
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=graph.js.map

package/dist/core/dependency/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/core/dependency/graph.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,WAAoC,EACpC,WAA8C;IAE9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAA;IAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IAEzC,6CAA6C;IAC7C,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,IAAI,CAAA;QACzD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;YACjB,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,OAAO;SACR,CAAC,CAAA;QACF,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACxB,CAAC;IAED,qFAAqF;IACrF,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACjC,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;YAC1B,CAAC;YACD,+DAA+D;QACjE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AACzB,CAAC"}

package/dist/core/knowledge/knowledge-update-assembler.d.ts

@@ -0,0 +1,24 @@
+export interface AssembleOptions {
+    name: string;
+    globalBody: string;
+    localOverrideContent: string | null;
+    methodology: string;
+    artifacts: string[];
+    focus: string | null;
+}
+/**
+ * Lightweight template interpolator for knowledge update prompts.
+ * Uses {{var}} substitution and {{#flag}}...{{/flag}} conditional blocks.
+ * No dependency on AssemblyEngine or pipeline concepts.
+ */
+export declare class KnowledgeUpdateAssembler {
+    private readonly template;
+    constructor(template: string);
+    assemble(options: AssembleOptions): string;
+    private resolveBlock;
+}
+/**
+ * Load the knowledge-update-template.md file from the same directory as this module.
+ */
+export declare function loadTemplate(): string;
+//# sourceMappingURL=knowledge-update-assembler.d.ts.map

package/dist/core/knowledge/knowledge-update-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-update-assembler.d.ts","sourceRoot":"","sources":["../../../src/core/knowledge/knowledge-update-assembler.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED;;;;GAIG;AACH,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAqB1C,OAAO,CAAC,YAAY;CAOrB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAIrC"}

package/dist/core/knowledge/knowledge-update-assembler.js

@@ -0,0 +1,46 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Lightweight template interpolator for knowledge update prompts.
+ * Uses {{var}} substitution and {{#flag}}...{{/flag}} conditional blocks.
+ * No dependency on AssemblyEngine or pipeline concepts.
+ */
+export class KnowledgeUpdateAssembler {
+    template;
+    constructor(template) {
+        this.template = template;
+    }
+    assemble(options) {
+        const { name, globalBody, localOverrideContent, methodology, artifacts, focus } = options;
+        let output = this.template;
+        // Simple variable substitution
+        output = output.replace(/\{\{name\}\}/g, name);
+        output = output.replace(/\{\{globalBody\}\}/g, globalBody);
+        output = output.replace(/\{\{methodology\}\}/g, methodology);
+        output = output.replace(/\{\{localOverrideContent\}\}/g, localOverrideContent ?? '');
+        output = output.replace(/\{\{artifacts\}\}/g, artifacts.join('\n\n---\n\n'));
+        output = output.replace(/\{\{focus\}\}/g, focus ?? '');
+        // Conditional blocks: {{#flag}}...{{/flag}}
+        output = this.resolveBlock(output, 'hasLocalOverride', localOverrideContent !== null);
+        output = this.resolveBlock(output, 'hasArtifacts', artifacts.length > 0);
+        output = this.resolveBlock(output, 'hasFocus', focus !== null && focus.trim() !== '');
+        return output.trim();
+    }
+    resolveBlock(text, flag, show) {
+        const pattern = new RegExp(`\\{\\{#${flag}\\}\\}([\\s\\S]*?)\\{\\{/${flag}\\}\\}`, 'g');
+        if (show) {
+            return text.replace(pattern, (_match, content) => content);
+        }
+        return text.replace(pattern, '');
+    }
+}
+/**
+ * Load the knowledge-update-template.md file from the same directory as this module.
+ */
+export function loadTemplate() {
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const templatePath = path.join(__dirname, 'knowledge-update-template.md');
+    return fs.readFileSync(templatePath, 'utf8');
+}
+//# sourceMappingURL=knowledge-update-assembler.js.map

package/dist/core/knowledge/knowledge-update-assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-update-assembler.js","sourceRoot":"","sources":["../../../src/core/knowledge/knowledge-update-assembler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAWxC;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,QAAQ,CAAC,OAAwB;QAC/B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;QAEzF,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAA;QAE1B,+BAA+B;QAC/B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA;QAC9C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAA;QAC1D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAA;QAC5D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,+BAA+B,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAA;QACpF,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAA;QAC5E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAA;QAEtD,4CAA4C;QAC5C,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,KAAK,IAAI,CAAC,CAAA;QACrF,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACxE,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAErF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;IAEO,YAAY,CAAC,IAAY,EAAE,IAAY,EAAE,IAAa;QAC5D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,UAAU,IAAI,4BAA4B,IAAI,QAAQ,EAAE,GAAG,CAAC,CAAA;QACvF,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,CAAA;QACpE,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAA;IACzE,OAAO,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;AAC9C,CAAC"}

package/dist/core/knowledge/knowledge-update-assembler.test.d.ts

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

package/dist/core/knowledge/knowledge-update-assembler.test.d.ts.map

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

package/dist/core/knowledge/knowledge-update-assembler.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect } from 'vitest';
+import { KnowledgeUpdateAssembler } from './knowledge-update-assembler.js';
+const TEMPLATE = `## Task
+Write \`.scaffold/knowledge/{{name}}.md\`.
+## Global Knowledge Entry (seed)
+{{globalBody}}
+{{#hasLocalOverride}}
+## Existing Local Override
+{{localOverrideContent}}
+{{/hasLocalOverride}}
+## Project Context
+Methodology: {{methodology}}
+{{#hasArtifacts}}
+Artifacts:
+{{artifacts}}
+{{/hasArtifacts}}
+{{#hasFocus}}
+## Focus
+{{focus}}
+{{/hasFocus}}
+## Output Instructions
+- Write the complete file.`;
+describe('KnowledgeUpdateAssembler', () => {
+    it('create mode: includes global body, no local override section', () => {
+        const assembler = new KnowledgeUpdateAssembler(TEMPLATE);
+        const result = assembler.assemble({
+            name: 'api-design',
+            globalBody: '# API Design\nUse REST.',
+            localOverrideContent: null,
+            methodology: 'deep',
+            artifacts: [],
+            focus: null,
+        });
+        expect(result).toContain('api-design');
+        expect(result).toContain('# API Design');
+        expect(result).toContain('Methodology: deep');
+        expect(result).not.toContain('Existing Local Override');
+        expect(result).not.toContain('## Focus');
+    });
+    it('update mode: includes local override section', () => {
+        const assembler = new KnowledgeUpdateAssembler(TEMPLATE);
+        const result = assembler.assemble({
+            name: 'api-design',
+            globalBody: '# API Design\nUse REST.',
+            localOverrideContent: '# Custom API\nUse GraphQL.',
+            methodology: 'deep',
+            artifacts: [],
+            focus: null,
+        });
+        expect(result).toContain('Existing Local Override');
+        expect(result).toContain('# Custom API');
+    });
+    it('includes focus section when instructions provided', () => {
+        const assembler = new KnowledgeUpdateAssembler(TEMPLATE);
+        const result = assembler.assemble({
+            name: 'api-design',
+            globalBody: 'Body.',
+            localOverrideContent: null,
+            methodology: 'mvp',
+            artifacts: [],
+            focus: 'Focus on GraphQL patterns',
+        });
+        expect(result).toContain('## Focus');
+        expect(result).toContain('Focus on GraphQL patterns');
+    });
+    it('includes artifacts when provided', () => {
+        const assembler = new KnowledgeUpdateAssembler(TEMPLATE);
+        const result = assembler.assemble({
+            name: 'api-design',
+            globalBody: 'Body.',
+            localOverrideContent: null,
+            methodology: 'deep',
+            artifacts: ['# My API Spec\nEndpoints here.'],
+            focus: null,
+        });
+        expect(result).toContain('Artifacts:');
+        expect(result).toContain('# My API Spec');
+    });
+    it('local-only mode: uses local content as seed when global body is placeholder', () => {
+        const assembler = new KnowledgeUpdateAssembler(TEMPLATE);
+        const result = assembler.assemble({
+            name: 'custom-entry',
+            globalBody: '(no global seed — this entry exists only locally)',
+            localOverrideContent: '# Custom\nLocal only.',
+            methodology: 'deep',
+            artifacts: [],
+            focus: 'Expand with more detail',
+        });
+        expect(result).toContain('no global seed');
+        expect(result).toContain('Existing Local Override');
+    });
+});
+//# sourceMappingURL=knowledge-update-assembler.test.js.map

package/dist/core/knowledge/knowledge-update-assembler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-update-assembler.test.js","sourceRoot":"","sources":["../../../src/core/knowledge/knowledge-update-assembler.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAE1E,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;2BAmBU,CAAA;AAE3B,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAA;QACxD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;YAChC,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,yBAAyB;YACrC,oBAAoB,EAAE,IAAI;YAC1B,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,IAAI;SACZ,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAA;QACxD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;YAChC,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,yBAAyB;YACrC,oBAAoB,EAAE,4BAA4B;YAClD,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,IAAI;SACZ,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAA;QACxD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;YAChC,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,OAAO;YACnB,oBAAoB,EAAE,IAAI;YAC1B,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,2BAA2B;SACnC,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAA;QACxD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;YAChC,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,OAAO;YACnB,oBAAoB,EAAE,IAAI;YAC1B,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,CAAC,gCAAgC,CAAC;YAC7C,KAAK,EAAE,IAAI;SACZ,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAA;QACxD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;YAChC,IAAI,EAAE,cAAc;YACpB,UAAU,EAAE,mDAAmD;YAC/D,oBAAoB,EAAE,uBAAuB;YAC7C,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,yBAAyB;SACjC,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/core/knowledge/knowledge-update-template.md

@@ -0,0 +1,55 @@
+## Task
+
+You are customizing the knowledge base for this project. Write the file
+`.scaffold/knowledge/{{name}}.md` with valid YAML frontmatter and a markdown body
+tailored to this project's context.
+
+The file must start with:
+```yaml
+---
+name: {{name}}
+description: <one-line description reflecting this project's context>
+topics: [<comma-separated topic keywords>]
+---
+```
+Followed by the full knowledge body as markdown.
+
+## Global Knowledge Entry (seed)
+
+{{globalBody}}
+
+{{#hasLocalOverride}}
+## Existing Local Override (update mode)
+
+The following is the current project-specific version of this entry. Preserve what
+is still accurate, revise what the Focus instructions change, and add what is missing.
+
+{{localOverrideContent}}
+{{/hasLocalOverride}}
+
+## Project Context
+
+Methodology: {{methodology}}
+
+{{#hasArtifacts}}
+Relevant project artifacts:
+
+{{artifacts}}
+{{/hasArtifacts}}
+
+{{#hasFocus}}
+## Focus
+
+{{focus}}
+
+{{/hasFocus}}
+## Output Instructions
+
+- Write the COMPLETE file — frontmatter + full body. Do not summarize or skip sections.
+- Tailor the content to this project's tech stack, conventions, and context.
+- In create mode: use the Global Knowledge Entry as the structural seed; adapt every
+  section to the project rather than keeping generic guidance verbatim.
+- In update mode: diff against the Existing Local Override; preserve project-specific
+  decisions; revise based on Focus; add anything the Focus requires.
+- Output only the file contents. No commentary before or after.
+- Output path: `.scaffold/knowledge/{{name}}.md`

package/dist/dashboard/generator.d.ts

@@ -0,0 +1,37 @@
+import type { PipelineState } from '../types/index.js';
+import type { DecisionEntry } from '../types/index.js';
+export interface DashboardData {
+    generatedAt: string;
+    methodology: string;
+    steps: {
+        slug: string;
+        status: 'pending' | 'in_progress' | 'completed' | 'skipped';
+        phase: string | null;
+        depth: number | null;
+        completedAt: string | null;
+        completedBy: string | null;
+    }[];
+    progress: {
+        total: number;
+        completed: number;
+        skipped: number;
+        pending: number;
+        inProgress: number;
+        percentage: number;
+    };
+    decisions: {
+        id: string;
+        step: string;
+        decision: string;
+        timestamp: string;
+        provisional: boolean;
+    }[];
+}
+export interface GeneratorOptions {
+    state: PipelineState;
+    decisions: DecisionEntry[];
+    methodology: string;
+}
+export declare function generateDashboardData(opts: GeneratorOptions): DashboardData;
+export declare function generateHtml(data: DashboardData): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/dashboard/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/dashboard/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGtD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAA;QAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B,EAAE,CAAA;IACH,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,OAAO,CAAA;KACrB,EAAE,CAAA;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAA;IACpB,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAsC3E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAGxD"}

package/dist/dashboard/generator.js

@@ -0,0 +1,42 @@
+import { buildTemplate } from './template.js';
+export function generateDashboardData(opts) {
+    const { state, decisions, methodology } = opts;
+    const steps = Object.entries(state.steps).map(([slug, entry]) => ({
+        slug,
+        status: entry.status,
+        phase: null,
+        depth: entry.depth ?? null,
+        completedAt: entry.at ?? null,
+        completedBy: entry.completed_by ?? null,
+    }));
+    const completed = steps.filter(s => s.status === 'completed').length;
+    const skipped = steps.filter(s => s.status === 'skipped').length;
+    const pending = steps.filter(s => s.status === 'pending').length;
+    const inProgress = steps.filter(s => s.status === 'in_progress').length;
+    const total = steps.length;
+    return {
+        generatedAt: new Date().toISOString(),
+        methodology,
+        steps,
+        progress: {
+            total,
+            completed,
+            skipped,
+            pending,
+            inProgress,
+            percentage: total > 0 ? Math.round((completed + skipped) / total * 100) : 0,
+        },
+        decisions: decisions.map(d => ({
+            id: d.id,
+            step: d.prompt,
+            decision: d.decision,
+            timestamp: d.at,
+            provisional: d.step_completed === false,
+        })),
+    };
+}
+export function generateHtml(data) {
+    const dataJson = JSON.stringify(data, null, 2);
+    return buildTemplate(dataJson, data);
+}
+//# sourceMappingURL=generator.js.map

package/dist/dashboard/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/dashboard/generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAoC7C,MAAM,UAAU,qBAAqB,CAAC,IAAsB;IAC1D,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;IAE9C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI;QACJ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,IAAqB;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,WAAW,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI;QAC7B,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;KACxC,CAAC,CAAC,CAAA;IAEH,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAA;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAA;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAA;IAChE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM,CAAA;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;IAE1B,OAAO;QACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,WAAW;QACX,KAAK;QACL,QAAQ,EAAE;YACR,KAAK;YACL,SAAS;YACT,OAAO;YACP,OAAO;YACP,UAAU;YACV,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC5E;QACD,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,EAAE;YACf,WAAW,EAAE,CAAC,CAAC,cAAc,KAAK,KAAK;SACxC,CAAC,CAAC;KACJ,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC9C,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AACtC,CAAC"}

package/dist/dashboard/generator.test.d.ts

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

package/dist/dashboard/generator.test.d.ts.map

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