@zigrivers/scaffold 3.4.1 → 3.5.0

package/dist/core/assembly/overlay-loader.test.js.map

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

package/dist/core/assembly/overlay-resolver.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectTypeOverlay, StepEnablementEntry } from '../../types/index.js';
+/**
+ * Apply a project-type overlay to resolved pipeline state.
+ *
+ * Pure function — no I/O, no side effects. Spreads input maps,
+ * applies overlay overrides (replace-then-append-then-dedup),
+ * and returns new pipeline state without mutating inputs.
+ */
+export declare function applyOverlay(steps: Record<string, StepEnablementEntry>, knowledgeMap: Record<string, string[]>, readsMap: Record<string, string[]>, dependencyMap: Record<string, string[]>, overlay: ProjectTypeOverlay): {
+    steps: Record<string, StepEnablementEntry>;
+    knowledge: Record<string, string[]>;
+    reads: Record<string, string[]>;
+    dependencies: Record<string, string[]>;
+};
+//# sourceMappingURL=overlay-resolver.d.ts.map

package/dist/core/assembly/overlay-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/overlay-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAIlB,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAE7B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAClC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACvC,OAAO,EAAE,kBAAkB,GAC1B;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACvC,CAqCA"}

package/dist/core/assembly/overlay-resolver.js

@@ -0,0 +1,58 @@
+/**
+ * Apply a project-type overlay to resolved pipeline state.
+ *
+ * Pure function — no I/O, no side effects. Spreads input maps,
+ * applies overlay overrides (replace-then-append-then-dedup),
+ * and returns new pipeline state without mutating inputs.
+ */
+export function applyOverlay(steps, knowledgeMap, readsMap, dependencyMap, overlay) {
+    // 1. Step overrides: deep-clone all entries so callers cannot mutate originals
+    const mergedSteps = {};
+    for (const [name, entry] of Object.entries(steps)) {
+        mergedSteps[name] = { ...entry };
+    }
+    for (const [name, override] of Object.entries(overlay.stepOverrides)) {
+        mergedSteps[name] = { ...mergedSteps[name], ...override };
+    }
+    // 2. Knowledge overrides: append + deduplicate
+    const mergedKnowledge = applyArrayOverrides(knowledgeMap, overlay.knowledgeOverrides, applyKnowledgeEntry);
+    // 3. Reads overrides: replace-then-append-then-dedup
+    const mergedReads = applyArrayOverrides(readsMap, overlay.readsOverrides, applyReplaceAppendEntry);
+    // 4. Dependency overrides: replace-then-append-then-dedup
+    const mergedDependencies = applyArrayOverrides(dependencyMap, overlay.dependencyOverrides, applyReplaceAppendEntry);
+    return {
+        steps: mergedSteps,
+        knowledge: mergedKnowledge,
+        reads: mergedReads,
+        dependencies: mergedDependencies,
+    };
+}
+/** Generic helper: copy the input map, then apply per-step overrides via a merger function. */
+function applyArrayOverrides(inputMap, overrides, merger) {
+    // Shallow-copy arrays so we never mutate the input
+    const result = {};
+    for (const [key, arr] of Object.entries(inputMap)) {
+        result[key] = [...arr];
+    }
+    for (const [step, override] of Object.entries(overrides)) {
+        const existing = result[step] ?? [];
+        result[step] = merger(existing, override);
+    }
+    return result;
+}
+/** Knowledge: append then deduplicate. */
+function applyKnowledgeEntry(existing, override) {
+    const merged = [...existing, ...override.append];
+    return [...new Set(merged)];
+}
+/** Reads / Dependencies: replace-then-append-then-dedup. */
+function applyReplaceAppendEntry(existing, override) {
+    // Step 1: apply replacements
+    const replaceMap = override.replace ?? {};
+    const replaced = existing.map((entry) => replaceMap[entry] ?? entry);
+    // Step 2: append
+    const appended = [...replaced, ...(override.append ?? [])];
+    // Step 3: deduplicate (preserves first occurrence order)
+    return [...new Set(appended)];
+}
+//# sourceMappingURL=overlay-resolver.js.map

package/dist/core/assembly/overlay-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-resolver.js","sourceRoot":"","sources":["../../../src/core/assembly/overlay-resolver.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,KAA0C,EAC1C,YAAsC,EACtC,QAAkC,EAClC,aAAuC,EACvC,OAA2B;IAO3B,+EAA+E;IAC/E,MAAM,WAAW,GAAwC,EAAE,CAAA;IAC3D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;IAClC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACrE,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAA;IAC3D,CAAC;IAED,+CAA+C;IAC/C,MAAM,eAAe,GAAG,mBAAmB,CACzC,YAAY,EACZ,OAAO,CAAC,kBAAkB,EAC1B,mBAAmB,CACpB,CAAA;IAED,qDAAqD;IACrD,MAAM,WAAW,GAAG,mBAAmB,CACrC,QAAQ,EACR,OAAO,CAAC,cAAc,EACtB,uBAAuB,CACxB,CAAA;IAED,0DAA0D;IAC1D,MAAM,kBAAkB,GAAG,mBAAmB,CAC5C,aAAa,EACb,OAAO,CAAC,mBAAmB,EAC3B,uBAAuB,CACxB,CAAA;IAED,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,eAAe;QAC1B,KAAK,EAAE,WAAW;QAClB,YAAY,EAAE,kBAAkB;KACjC,CAAA;AACH,CAAC;AAED,+FAA+F;AAC/F,SAAS,mBAAmB,CAC1B,QAAkC,EAClC,SAA4B,EAC5B,MAAqD;IAErD,mDAAmD;IACnD,MAAM,MAAM,GAA6B,EAAE,CAAA;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;IACxB,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QACnC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,0CAA0C;AAC1C,SAAS,mBAAmB,CAAC,QAAkB,EAAE,QAA2B;IAC1E,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IAChD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAC7B,CAAC;AAED,4DAA4D;AAC5D,SAAS,uBAAuB,CAAC,QAAkB,EAAE,QAA4C;IAC/F,6BAA6B;IAC7B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAA;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAA;IAEpE,iBAAiB;IACjB,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAA;IAE1D,yDAAyD;IACzD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC/B,CAAC"}

package/dist/core/assembly/overlay-resolver.test.d.ts

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

package/dist/core/assembly/overlay-resolver.test.d.ts.map

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

package/dist/core/assembly/overlay-resolver.test.js

@@ -0,0 +1,246 @@
+import { describe, it, expect } from 'vitest';
+import { applyOverlay } from './overlay-resolver.js';
+function makeOverlay(overrides = {}) {
+    return {
+        name: 'test-overlay',
+        description: 'Test overlay',
+        projectType: 'game',
+        stepOverrides: {},
+        knowledgeOverrides: {},
+        readsOverrides: {},
+        dependencyOverrides: {},
+        ...overrides,
+    };
+}
+describe('applyOverlay', () => {
+    describe('step overrides', () => {
+        it('enables new steps and disables replaced steps', () => {
+            const steps = {
+                'design-system': { enabled: true },
+                'create-prd': { enabled: true },
+            };
+            const overlay = makeOverlay({
+                stepOverrides: {
+                    'design-system': { enabled: false },
+                    'game-design-document': { enabled: true },
+                },
+            });
+            const result = applyOverlay(steps, {}, {}, {}, overlay);
+            expect(result.steps['design-system']).toEqual({ enabled: false });
+            expect(result.steps['game-design-document']).toEqual({ enabled: true });
+            expect(result.steps['create-prd']).toEqual({ enabled: true });
+        });
+        it('merges step entries instead of replacing (preserves base conditional)', () => {
+            const steps = {
+                'step-a': { enabled: true, conditional: 'if-needed' },
+            };
+            const overlay = makeOverlay({
+                stepOverrides: {
+                    'step-a': { enabled: false },
+                },
+            });
+            const result = applyOverlay(steps, {}, {}, {}, overlay);
+            expect(result.steps['step-a']).toEqual({ enabled: false, conditional: 'if-needed' });
+        });
+        it('preserves conditional field from overlay', () => {
+            const steps = {
+                'create-prd': { enabled: true },
+            };
+            const overlay = makeOverlay({
+                stepOverrides: {
+                    'optional-step': { enabled: true, conditional: 'if-needed' },
+                },
+            });
+            const result = applyOverlay(steps, {}, {}, {}, overlay);
+            expect(result.steps['optional-step']).toEqual({ enabled: true, conditional: 'if-needed' });
+        });
+    });
+    describe('knowledge overrides', () => {
+        it('appends entries to existing knowledge', () => {
+            const knowledgeMap = {
+                'tech-stack': ['tech-stack-selection'],
+            };
+            const overlay = makeOverlay({
+                knowledgeOverrides: {
+                    'tech-stack': { append: ['game-engine-selection'] },
+                },
+            });
+            const result = applyOverlay({}, knowledgeMap, {}, {}, overlay);
+            expect(result.knowledge['tech-stack']).toEqual([
+                'tech-stack-selection',
+                'game-engine-selection',
+            ]);
+        });
+        it('deduplicates when overlay appends an already-present entry', () => {
+            const knowledgeMap = {
+                'tech-stack': ['tech-stack-selection', 'game-engine-selection'],
+            };
+            const overlay = makeOverlay({
+                knowledgeOverrides: {
+                    'tech-stack': { append: ['game-engine-selection'] },
+                },
+            });
+            const result = applyOverlay({}, knowledgeMap, {}, {}, overlay);
+            expect(result.knowledge['tech-stack']).toEqual([
+                'tech-stack-selection',
+                'game-engine-selection',
+            ]);
+        });
+    });
+    describe('reads overrides', () => {
+        it('replaces targets in existing reads', () => {
+            const readsMap = {
+                'story-tests': ['ux-spec', 'user-stories'],
+            };
+            const overlay = makeOverlay({
+                readsOverrides: {
+                    'story-tests': { replace: { 'ux-spec': 'game-ui-spec' } },
+                },
+            });
+            const result = applyOverlay({}, {}, readsMap, {}, overlay);
+            expect(result.reads['story-tests']).toEqual(['game-ui-spec', 'user-stories']);
+        });
+        it('appends new reads entries', () => {
+            const readsMap = {
+                'story-tests': ['ux-spec'],
+            };
+            const overlay = makeOverlay({
+                readsOverrides: {
+                    'story-tests': { append: ['game-mechanics'] },
+                },
+            });
+            const result = applyOverlay({}, {}, readsMap, {}, overlay);
+            expect(result.reads['story-tests']).toEqual(['ux-spec', 'game-mechanics']);
+        });
+        it('deduplicates after replace and append', () => {
+            const readsMap = {
+                'story-tests': ['ux-spec', 'user-stories'],
+            };
+            const overlay = makeOverlay({
+                readsOverrides: {
+                    'story-tests': {
+                        replace: { 'ux-spec': 'user-stories' }, // replace ux-spec with user-stories (duplicate)
+                        append: ['user-stories'], // also append duplicate
+                    },
+                },
+            });
+            const result = applyOverlay({}, {}, readsMap, {}, overlay);
+            // user-stories should appear only once
+            expect(result.reads['story-tests']).toEqual(['user-stories']);
+        });
+    });
+    describe('dependency overrides', () => {
+        it('appends new dependencies', () => {
+            const dependencyMap = {
+                'user-stories': ['review-prd'],
+            };
+            const overlay = makeOverlay({
+                dependencyOverrides: {
+                    'user-stories': { append: ['review-gdd'] },
+                },
+            });
+            const result = applyOverlay({}, {}, {}, dependencyMap, overlay);
+            expect(result.dependencies['user-stories']).toEqual(['review-prd', 'review-gdd']);
+        });
+        it('replaces dependencies', () => {
+            const dependencyMap = {
+                'user-stories': ['review-prd'],
+            };
+            const overlay = makeOverlay({
+                dependencyOverrides: {
+                    'user-stories': { replace: { 'review-prd': 'review-gdd' } },
+                },
+            });
+            const result = applyOverlay({}, {}, {}, dependencyMap, overlay);
+            expect(result.dependencies['user-stories']).toEqual(['review-gdd']);
+        });
+        it('deduplicates after replace and append', () => {
+            const dependencyMap = {
+                'user-stories': ['review-prd', 'review-gdd'],
+            };
+            const overlay = makeOverlay({
+                dependencyOverrides: {
+                    'user-stories': {
+                        replace: { 'review-prd': 'review-gdd' },
+                        append: ['review-gdd'],
+                    },
+                },
+            });
+            const result = applyOverlay({}, {}, {}, dependencyMap, overlay);
+            expect(result.dependencies['user-stories']).toEqual(['review-gdd']);
+        });
+    });
+    describe('empty overlay', () => {
+        it('produces no changes when overlay has empty override objects', () => {
+            const steps = { 'create-prd': { enabled: true } };
+            const knowledge = { 'tech-stack': ['tech-stack-selection'] };
+            const reads = { 'story-tests': ['ux-spec'] };
+            const deps = { 'user-stories': ['review-prd'] };
+            const overlay = makeOverlay();
+            const result = applyOverlay(steps, knowledge, reads, deps, overlay);
+            expect(result.steps).toEqual(steps);
+            expect(result.knowledge).toEqual(knowledge);
+            expect(result.reads).toEqual(reads);
+            expect(result.dependencies).toEqual(deps);
+        });
+    });
+    describe('unknown step in overlay', () => {
+        it('silently adds step overrides for unknown steps', () => {
+            const steps = { 'create-prd': { enabled: true } };
+            const overlay = makeOverlay({
+                stepOverrides: { 'totally-new-step': { enabled: true } },
+            });
+            const result = applyOverlay(steps, {}, {}, {}, overlay);
+            expect(result.steps['totally-new-step']).toEqual({ enabled: true });
+            expect(result.steps['create-prd']).toEqual({ enabled: true });
+        });
+        it('silently adds knowledge for unknown steps', () => {
+            const overlay = makeOverlay({
+                knowledgeOverrides: {
+                    'new-step': { append: ['new-knowledge'] },
+                },
+            });
+            const result = applyOverlay({}, {}, {}, {}, overlay);
+            expect(result.knowledge['new-step']).toEqual(['new-knowledge']);
+        });
+        it('silently adds reads for unknown steps', () => {
+            const overlay = makeOverlay({
+                readsOverrides: {
+                    'new-step': { append: ['some-doc'] },
+                },
+            });
+            const result = applyOverlay({}, {}, {}, {}, overlay);
+            expect(result.reads['new-step']).toEqual(['some-doc']);
+        });
+        it('silently adds dependencies for unknown steps', () => {
+            const overlay = makeOverlay({
+                dependencyOverrides: {
+                    'new-step': { append: ['some-dep'] },
+                },
+            });
+            const result = applyOverlay({}, {}, {}, {}, overlay);
+            expect(result.dependencies['new-step']).toEqual(['some-dep']);
+        });
+    });
+    describe('immutability', () => {
+        it('does not mutate the input maps', () => {
+            const steps = { 'create-prd': { enabled: true } };
+            const knowledge = { 'tech-stack': ['tech-stack-selection'] };
+            const reads = { 'story-tests': ['ux-spec'] };
+            const deps = { 'user-stories': ['review-prd'] };
+            const overlay = makeOverlay({
+                stepOverrides: { 'create-prd': { enabled: false } },
+                knowledgeOverrides: { 'tech-stack': { append: ['new-entry'] } },
+                readsOverrides: { 'story-tests': { append: ['new-read'] } },
+                dependencyOverrides: { 'user-stories': { append: ['new-dep'] } },
+            });
+            applyOverlay(steps, knowledge, reads, deps, overlay);
+            // Original inputs should be unchanged
+            expect(steps).toEqual({ 'create-prd': { enabled: true } });
+            expect(knowledge).toEqual({ 'tech-stack': ['tech-stack-selection'] });
+            expect(reads).toEqual({ 'story-tests': ['ux-spec'] });
+            expect(deps).toEqual({ 'user-stories': ['review-prd'] });
+        });
+    });
+});
+//# sourceMappingURL=overlay-resolver.test.js.map

package/dist/core/assembly/overlay-resolver.test.js.map

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

package/dist/core/assembly/overlay-state-resolver.d.ts

@@ -0,0 +1,26 @@
+import type { ScaffoldConfig, StepEnablementEntry } from '../../types/index.js';
+import type { MetaPromptFrontmatter } from '../../types/frontmatter.js';
+import type { OutputContext } from '../../cli/output/context.js';
+export interface OverlayState {
+    steps: Record<string, StepEnablementEntry>;
+    knowledge: Record<string, string[]>;
+    reads: Record<string, string[]>;
+    dependencies: Record<string, string[]>;
+}
+/**
+ * Resolve overlay state by building maps from meta-prompt frontmatter,
+ * then optionally loading and applying a project-type overlay.
+ *
+ * Centralizes the logic previously inline in run.ts (Step 2b) so that
+ * status, next, rework, and other commands can share the same resolution.
+ */
+export declare function resolveOverlayState(options: {
+    config: ScaffoldConfig;
+    methodologyDir: string;
+    metaPrompts: Map<string, {
+        frontmatter: MetaPromptFrontmatter;
+    }>;
+    presetSteps: Record<string, StepEnablementEntry>;
+    output: OutputContext;
+}): OverlayState;
+//# sourceMappingURL=overlay-state-resolver.d.ts.map

package/dist/core/assembly/overlay-state-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-state-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/overlay-state-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAIhE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,MAAM,EAAE,cAAc,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAA;IAChE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAChD,MAAM,EAAE,aAAa,CAAA;CACtB,GAAG,YAAY,CA8Df"}

package/dist/core/assembly/overlay-state-resolver.js

@@ -0,0 +1,63 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { loadOverlay } from './overlay-loader.js';
+import { applyOverlay } from './overlay-resolver.js';
+/**
+ * Resolve overlay state by building maps from meta-prompt frontmatter,
+ * then optionally loading and applying a project-type overlay.
+ *
+ * Centralizes the logic previously inline in run.ts (Step 2b) so that
+ * status, next, rework, and other commands can share the same resolution.
+ */
+export function resolveOverlayState(options) {
+    const { config, methodologyDir, metaPrompts, presetSteps, output } = options;
+    // Build maps from meta-prompt frontmatter
+    const knowledgeMap = {};
+    const readsMap = {};
+    const dependencyMap = {};
+    for (const [name, mp] of metaPrompts) {
+        knowledgeMap[name] = [...(mp.frontmatter.knowledgeBase ?? [])];
+        readsMap[name] = [...(mp.frontmatter.reads ?? [])];
+        dependencyMap[name] = [...(mp.frontmatter.dependencies ?? [])];
+    }
+    // Start with preset defaults
+    let overlaySteps = { ...presetSteps };
+    let overlayKnowledge = knowledgeMap;
+    let overlayReads = readsMap;
+    let overlayDependencies = dependencyMap;
+    // Load and apply project-type overlay if configured
+    const projectType = config.project?.projectType;
+    if (projectType) {
+        const overlayPath = path.join(methodologyDir, `${projectType}-overlay.yml`);
+        // Only attempt overlay loading when an overlay file actually exists.
+        // Most project types (backend, cli, library, etc.) don't have overlays —
+        // silently return defaults instead of emitting misleading warnings.
+        if (!fs.existsSync(overlayPath)) {
+            return { steps: { ...presetSteps }, knowledge: knowledgeMap, reads: readsMap, dependencies: dependencyMap };
+        }
+        const { overlay, errors: overlayErrors, warnings: overlayWarnings } = loadOverlay(overlayPath);
+        for (const w of overlayWarnings) {
+            output.warn(w);
+        }
+        // Overlay errors are non-fatal — warn but continue without overlay
+        if (overlayErrors.length > 0) {
+            for (const err of overlayErrors) {
+                output.warn(`[${err.code}] ${err.message}${err.recovery ? ` — ${err.recovery}` : ''}`);
+            }
+        }
+        if (overlay) {
+            const merged = applyOverlay(overlaySteps, knowledgeMap, readsMap, dependencyMap, overlay);
+            overlaySteps = merged.steps;
+            overlayKnowledge = merged.knowledge;
+            overlayReads = merged.reads;
+            overlayDependencies = merged.dependencies;
+        }
+    }
+    return {
+        steps: overlaySteps,
+        knowledge: overlayKnowledge,
+        reads: overlayReads,
+        dependencies: overlayDependencies,
+    };
+}
+//# sourceMappingURL=overlay-state-resolver.js.map

package/dist/core/assembly/overlay-state-resolver.js.map

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

package/dist/core/assembly/overlay-state-resolver.test.d.ts

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

package/dist/core/assembly/overlay-state-resolver.test.d.ts.map

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