@zigrivers/scaffold 3.16.0 → 3.17.0

package/dist/state/state-path-resolver.test.d.ts

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

package/dist/state/state-path-resolver.test.d.ts.map

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

package/dist/state/state-path-resolver.test.js

@@ -0,0 +1,78 @@
+import { describe, it, expect } from 'vitest';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { StatePathResolver } from './state-path-resolver.js';
+describe('StatePathResolver', () => {
+    const root = '/fake/project';
+    describe('root-scoped (no service)', () => {
+        const resolver = new StatePathResolver(root);
+        it('scaffoldDir is .scaffold/', () => {
+            expect(resolver.scaffoldDir).toBe(path.join(root, '.scaffold'));
+        });
+        it('statePath is .scaffold/state.json', () => {
+            expect(resolver.statePath).toBe(path.join(root, '.scaffold', 'state.json'));
+        });
+        it('lockPath is .scaffold/lock.json', () => {
+            expect(resolver.lockPath).toBe(path.join(root, '.scaffold', 'lock.json'));
+        });
+        it('decisionsPath is .scaffold/decisions.jsonl', () => {
+            expect(resolver.decisionsPath).toBe(path.join(root, '.scaffold', 'decisions.jsonl'));
+        });
+        it('reworkPath is .scaffold/rework.json', () => {
+            expect(resolver.reworkPath).toBe(path.join(root, '.scaffold', 'rework.json'));
+        });
+        it('rootScaffoldDir equals scaffoldDir for root-scoped', () => {
+            expect(resolver.rootScaffoldDir).toBe(resolver.scaffoldDir);
+        });
+        it('isServiceScoped is false', () => {
+            expect(resolver.isServiceScoped).toBe(false);
+        });
+        it('serviceName is undefined', () => {
+            expect(resolver.serviceName).toBeUndefined();
+        });
+    });
+    describe('service-scoped', () => {
+        const resolver = new StatePathResolver(root, 'api');
+        it('scaffoldDir is .scaffold/services/api/', () => {
+            expect(resolver.scaffoldDir).toBe(path.join(root, '.scaffold', 'services', 'api'));
+        });
+        it('statePath is .scaffold/services/api/state.json', () => {
+            expect(resolver.statePath).toBe(path.join(root, '.scaffold', 'services', 'api', 'state.json'));
+        });
+        it('lockPath is .scaffold/services/api/lock.json', () => {
+            expect(resolver.lockPath).toBe(path.join(root, '.scaffold', 'services', 'api', 'lock.json'));
+        });
+        it('decisionsPath is .scaffold/services/api/decisions.jsonl', () => {
+            expect(resolver.decisionsPath).toBe(path.join(root, '.scaffold', 'services', 'api', 'decisions.jsonl'));
+        });
+        it('reworkPath is .scaffold/services/api/rework.json', () => {
+            expect(resolver.reworkPath).toBe(path.join(root, '.scaffold', 'services', 'api', 'rework.json'));
+        });
+        it('rootScaffoldDir is always .scaffold/ regardless of service', () => {
+            expect(resolver.rootScaffoldDir).toBe(path.join(root, '.scaffold'));
+        });
+        it('isServiceScoped is true', () => {
+            expect(resolver.isServiceScoped).toBe(true);
+        });
+        it('serviceName is api', () => {
+            expect(resolver.serviceName).toBe('api');
+        });
+    });
+    describe('empty string service', () => {
+        const resolver = new StatePathResolver(root, '');
+        it('treats empty string as root-scoped', () => {
+            expect(resolver.scaffoldDir).toBe(path.join(root, '.scaffold'));
+            expect(resolver.isServiceScoped).toBe(false);
+        });
+    });
+    describe('ensureDir', () => {
+        it('creates the scaffold directory recursively', () => {
+            const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'spr-test-'));
+            const resolver = new StatePathResolver(tmpDir, 'my-service');
+            resolver.ensureDir();
+            expect(fs.existsSync(resolver.scaffoldDir)).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=state-path-resolver.test.js.map

package/dist/state/state-path-resolver.test.js.map

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

package/dist/state/state-version-dispatch.d.ts

@@ -0,0 +1,17 @@
+export interface MigrationContext {
+    readonly hasServices: boolean;
+}
+/**
+ * Dispatches schema-version handling on raw state JSON.
+ * - Rejects unknown / missing versions.
+ * - Bumps v1 → v2 in-place when the companion config has services[].
+ * - Does NOT run Zod full-shape validation — caller is responsible.
+ * - Mutates the input object; callers may rely on that side effect.
+ *
+ * Wave 3b will extend this module to bump v2 → v3 when per-service
+ * state fields are introduced.
+ */
+export declare function dispatchStateMigration(raw: unknown, ctx: MigrationContext, file: string): asserts raw is Record<string, unknown> & {
+    'schema-version': 1 | 2 | 3;
+};
+//# sourceMappingURL=state-version-dispatch.d.ts.map

package/dist/state/state-version-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-version-dispatch.d.ts","sourceRoot":"","sources":["../../src/state/state-version-dispatch.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAC9B;AAMD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,CAW1E"}

package/dist/state/state-version-dispatch.js

@@ -0,0 +1,27 @@
+import { stateSchemaVersion } from '../utils/errors.js';
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/**
+ * Dispatches schema-version handling on raw state JSON.
+ * - Rejects unknown / missing versions.
+ * - Bumps v1 → v2 in-place when the companion config has services[].
+ * - Does NOT run Zod full-shape validation — caller is responsible.
+ * - Mutates the input object; callers may rely on that side effect.
+ *
+ * Wave 3b will extend this module to bump v2 → v3 when per-service
+ * state fields are introduced.
+ */
+export function dispatchStateMigration(raw, ctx, file) {
+    if (!isPlainObject(raw) || typeof raw['schema-version'] !== 'number') {
+        throw stateSchemaVersion([1, 2, 3], Number(raw && raw['schema-version']), file);
+    }
+    const version = raw['schema-version'];
+    if (version !== 1 && version !== 2 && version !== 3) {
+        throw stateSchemaVersion([1, 2, 3], version, file);
+    }
+    if (version === 1 && ctx.hasServices) {
+        raw['schema-version'] = 2;
+    }
+}
+//# sourceMappingURL=state-version-dispatch.js.map

package/dist/state/state-version-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-version-dispatch.js","sourceRoot":"","sources":["../../src/state/state-version-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAMvD,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AACjE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAY,EACZ,GAAqB,EACrB,IAAY;IAEZ,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,QAAQ,EAAE,CAAC;QACrE,MAAM,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,IAAK,GAA+B,CAAC,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAC9G,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAA;IACrC,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IACpD,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACrC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC"}

package/dist/state/state-version-dispatch.test.d.ts

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

package/dist/state/state-version-dispatch.test.d.ts.map

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

package/dist/state/state-version-dispatch.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from 'vitest';
+import { dispatchStateMigration } from './state-version-dispatch.js';
+describe('dispatchStateMigration', () => {
+    it('accepts v1 state when hasServices is false (no bump)', () => {
+        const raw = { 'schema-version': 1, foo: 'bar' };
+        dispatchStateMigration(raw, { hasServices: false }, 'state.json');
+        expect(raw['schema-version']).toBe(1);
+    });
+    it('bumps v1 → v2 in place when hasServices is true', () => {
+        const raw = { 'schema-version': 1, foo: 'bar' };
+        dispatchStateMigration(raw, { hasServices: true }, 'state.json');
+        expect(raw['schema-version']).toBe(2);
+    });
+    it('accepts v2 state unchanged regardless of hasServices', () => {
+        const raw = { 'schema-version': 2, foo: 'bar' };
+        dispatchStateMigration(raw, { hasServices: true }, 'state.json');
+        expect(raw['schema-version']).toBe(2);
+    });
+    it('throws on missing schema-version', () => {
+        expect(() => dispatchStateMigration({}, { hasServices: false }, 'state.json')).toThrow();
+    });
+    it('throws on unknown schema-version', () => {
+        expect(() => dispatchStateMigration({ 'schema-version': 99 }, { hasServices: false }, 'state.json')).toThrow();
+    });
+    it('throws on non-object raw input', () => {
+        expect(() => dispatchStateMigration('not an object', { hasServices: false }, 'state.json')).toThrow();
+        expect(() => dispatchStateMigration(null, { hasServices: false }, 'state.json')).toThrow();
+    });
+    it('accepts schema-version 3 without modification', () => {
+        const raw = { 'schema-version': 3, steps: {} };
+        dispatchStateMigration(raw, { hasServices: true }, '/test/state.json');
+        expect(raw['schema-version']).toBe(3);
+    });
+    it('accepts schema-version 3 even without services', () => {
+        const raw = { 'schema-version': 3, steps: {} };
+        dispatchStateMigration(raw, { hasServices: false }, '/test/state.json');
+        expect(raw['schema-version']).toBe(3);
+    });
+});
+//# sourceMappingURL=state-version-dispatch.test.js.map

package/dist/state/state-version-dispatch.test.js.map

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

package/dist/types/config.d.ts

@@ -93,16 +93,37 @@ export interface DependencyOverride {
     replace?: Record<string, string>;
     append?: string[];
 }
-/** Project-type overlay definition (e.g., game-overlay.yml). */
-export interface ProjectTypeOverlay {
+/** Pipeline overlay definition (project-type or structural). */
+export interface PipelineOverlay {
     name: string;
     description: string;
-    projectType: ProjectType;
+    projectType?: ProjectType;
     stepOverrides: Record<string, StepEnablementEntry>;
     knowledgeOverrides: Record<string, KnowledgeOverride>;
     readsOverrides: Record<string, ReadsOverride>;
     dependencyOverrides: Record<string, DependencyOverride>;
 }
+/** Service configuration — mirrors ServiceSchema structure for manual type declarations. */
+export interface ServiceConfig {
+    name: string;
+    description?: string;
+    projectType: ProjectType;
+    backendConfig?: BackendConfig;
+    webAppConfig?: WebAppConfig;
+    researchConfig?: ResearchConfig;
+    libraryConfig?: LibraryConfig;
+    cliConfig?: CliConfig;
+    mobileAppConfig?: MobileAppConfig;
+    dataPipelineConfig?: DataPipelineConfig;
+    mlConfig?: MlConfig;
+    gameConfig?: GameConfig;
+    browserExtensionConfig?: BrowserExtensionConfig;
+    path?: string;
+    /** Pipeline step slugs this service exposes for cross-service reference. Closed by default. */
+    exports?: Array<{
+        step: string;
+    }>;
+}
 /** Project characteristics from config.yml. */
 export interface ProjectConfig {
     name?: string;
@@ -118,6 +139,7 @@ export interface ProjectConfig {
     mlConfig?: MlConfig;
     browserExtensionConfig?: BrowserExtensionConfig;
     researchConfig?: ResearchConfig;
+    services?: ServiceConfig[];
     [key: string]: unknown;
 }
 /**

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}

package/dist/types/config.test.js

@@ -33,7 +33,7 @@ describe('StepEnablementEntry type', () => {
         expect(entry.conditional).toBe('if-needed');
     });
 });
-describe('ProjectTypeOverlay type', () => {
+describe('PipelineOverlay type', () => {
     it('accepts a valid overlay', () => {
         const overlay = {
             name: 'game',
@@ -57,6 +57,18 @@ describe('ProjectTypeOverlay type', () => {
         expect(overlay.projectType).toBe('game');
         expect(overlay.stepOverrides['game-design-document']?.enabled).toBe(true);
     });
+    it('accepts a structural overlay without projectType', () => {
+        const overlay = {
+            name: 'multi-service',
+            description: 'Cross-service overlay',
+            stepOverrides: { 'service-ownership-map': { enabled: true } },
+            knowledgeOverrides: {},
+            readsOverrides: {},
+            dependencyOverrides: {},
+        };
+        expect(overlay.name).toBe('multi-service');
+        expect(overlay.projectType).toBeUndefined();
+    });
 });
 describe('KnowledgeOverride type', () => {
     it('accepts a valid knowledge override', () => {

package/dist/types/config.test.js.map

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

package/dist/types/dependency.d.ts

@@ -3,6 +3,11 @@ export interface DependencyNode {
     phase: string | null;
     order: number | null;
     dependencies: string[];
+    /** Cross-service dependency edges (informational, non-blocking). Populated from frontmatter.crossReads (Wave 3c). */
+    crossDependencies?: Array<{
+        service: string;
+        step: string;
+    }>;
     enabled: boolean;
 }
 export interface DependencyGraph {

package/dist/types/dependency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency.d.ts","sourceRoot":"","sources":["../../src/types/dependency.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC7B"}
+{"version":3,"file":"dependency.d.ts","sourceRoot":"","sources":["../../src/types/dependency.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,qHAAqH;IACrH,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5D,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC7B"}

package/dist/types/frontmatter.d.ts

@@ -114,6 +114,11 @@ export interface MetaPromptFrontmatter {
     knowledgeBase: string[];
     /** Cross-cutting artifact references beyond the dependency chain. */
     reads: string[];
+    /** Cross-service artifact references — each entry points at a foreign service:step pair (Wave 3c). */
+    crossReads?: Array<{
+        service: string;
+        step: string;
+    }>;
     /** When true, step has no completion state tracking (on-demand, always available). */
     stateless: boolean;
     /** Source category: 'pipeline' for sequential steps, 'tool' for utility commands. */

package/dist/types/frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/types/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiFT,CAAA;AAEV,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD,oDAAoD;AACpD,eAAO,MAAM,aAAa,EAErB,MAAM,CAAC,SAAS,EAAE,CAAA,OAAO,MAAM,EAAC,MAAM,CAAC,CAAC,CAAA;AAE7C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,iFAAiF;IACjF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,iHAAiH;IACjH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,qEAAqE;IACrE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,qEAAqE;IACrE,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,sFAAsF;IACtF,SAAS,EAAE,OAAO,CAAA;IAClB,qFAAqF;IACrF,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAA;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,WAAW,EAAE,qBAAqB,CAAA;IAClC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/types/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiFT,CAAA;AAEV,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD,oDAAoD;AACpD,eAAO,MAAM,aAAa,EAErB,MAAM,CAAC,SAAS,EAAE,CAAA,OAAO,MAAM,EAAC,MAAM,CAAC,CAAC,CAAA;AAE7C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,iFAAiF;IACjF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,iHAAiH;IACjH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,qEAAqE;IACrE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,qEAAqE;IACrE,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,sGAAsG;IACtG,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrD,sFAAsF;IACtF,SAAS,EAAE,OAAO,CAAA;IAClB,qFAAqF;IACrF,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAA;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,WAAW,EAAE,qBAAqB,CAAA;IAClC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC"}

package/dist/types/lock.d.ts

@@ -1,4 +1,4 @@
-export type LockableCommand = 'run' | 'skip' | 'init' | 'reset' | 'adopt' | 'complete' | 'rework';
+export type LockableCommand = 'run' | 'skip' | 'init' | 'reset' | 'adopt' | 'complete' | 'rework' | 'migration';
 export interface LockFile {
     holder: string;
     prompt?: string;

package/dist/types/lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/types/lock.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEjG,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,eAAe,CAAA;CACzB"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/types/lock.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE/G,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,eAAe,CAAA;CACzB"}

package/dist/types/state.d.ts

@@ -35,7 +35,7 @@ export interface ExtraStepEntry {
  * See state-json-schema.md.
  */
 export interface PipelineState {
-    'schema-version': 1;
+    'schema-version': 1 | 2 | 3;
     'scaffold-version': string;
     init_methodology: MethodologyName;
     config_methodology: MethodologyName;

package/dist/types/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAErF,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,UAAU,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,CAAC,CAAA;IACnB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gBAAgB,EAAE,eAAe,CAAA;IACjC,kBAAkB,EAAE,eAAe,CAAA;IACnC,WAAW,EAAE,YAAY,GAAG,YAAY,GAAG,cAAc,CAAA;IACzD,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACrC,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,aAAa,EAAE,cAAc,EAAE,CAAA;CAChC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAErF,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,UAAU,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gBAAgB,EAAE,eAAe,CAAA;IACjC,kBAAkB,EAAE,eAAe,CAAA;IACnC,WAAW,EAAE,YAAY,GAAG,YAAY,GAAG,cAAc,CAAA;IACzD,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACrC,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,aAAa,EAAE,cAAc,EAAE,CAAA;CAChC"}

package/dist/utils/artifact-path.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolve an artifact path and verify it stays within the project root.
+ *
+ * Returns the canonicalized (symlink-resolved) absolute path if the target
+ * stays inside `projectRoot`. Returns `null` if:
+ *   - `relPath` is not a non-empty string, or contains a null byte
+ *   - the project root does not exist
+ *   - the resolved target escapes the project root
+ *   - a symlink anywhere in the path chain (including above a missing leaf)
+ *     points outside the project root
+ *   - any fs error other than ENOENT/ENOTDIR surfaces during canonicalization
+ *     (EACCES, ELOOP, EINVAL, …) — we fail closed rather than guess
+ *
+ * TOCTOU note: callers MUST use the returned absolute path for all
+ * subsequent fs operations. Re-resolving `relPath` after this function
+ * returns reintroduces the race window between canonicalization and use.
+ */
+export declare function resolveContainedArtifactPath(projectRoot: string, relPath: string): string | null;
+//# sourceMappingURL=artifact-path.d.ts.map

package/dist/utils/artifact-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-path.d.ts","sourceRoot":"","sources":["../../src/utils/artifact-path.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CA2Bf"}

package/dist/utils/artifact-path.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Resolve an artifact path and verify it stays within the project root.
+ *
+ * Returns the canonicalized (symlink-resolved) absolute path if the target
+ * stays inside `projectRoot`. Returns `null` if:
+ *   - `relPath` is not a non-empty string, or contains a null byte
+ *   - the project root does not exist
+ *   - the resolved target escapes the project root
+ *   - a symlink anywhere in the path chain (including above a missing leaf)
+ *     points outside the project root
+ *   - any fs error other than ENOENT/ENOTDIR surfaces during canonicalization
+ *     (EACCES, ELOOP, EINVAL, …) — we fail closed rather than guess
+ *
+ * TOCTOU note: callers MUST use the returned absolute path for all
+ * subsequent fs operations. Re-resolving `relPath` after this function
+ * returns reintroduces the race window between canonicalization and use.
+ */
+export function resolveContainedArtifactPath(projectRoot, relPath) {
+    // State is JSON-loaded with a trust-cast, so `relPath` may be any type at
+    // runtime. Reject non-strings, empty strings (would resolve to the project
+    // root itself — never a legitimate artifact), and null-byte injections.
+    if (typeof relPath !== 'string' || relPath === '' || relPath.includes('\0')) {
+        return null;
+    }
+    const resolved = path.resolve(projectRoot, relPath);
+    let canonicalRoot;
+    try {
+        canonicalRoot = fs.realpathSync(projectRoot);
+    }
+    catch {
+        return null;
+    }
+    const canonicalPath = canonicalizeWithMissingTail(resolved);
+    if (canonicalPath === null)
+        return null;
+    if (!isContained(canonicalPath, canonicalRoot))
+        return null;
+    // Reject root-equivalent inputs ('.', './', an absolute path equal to the
+    // root, etc.). Callers never legitimately ask for the project root itself
+    // as an artifact, and accepting it would let existence-only call sites
+    // count the project root directory as a present artifact.
+    if (canonicalPath === canonicalRoot)
+        return null;
+    return canonicalPath;
+}
+/**
+ * Canonicalize a path whose leaf may not exist. Walk up until an ancestor
+ * exists, `realpathSync` it, then re-append the missing tail. This defeats
+ * symlink escape through intermediate directories even when the leaf is
+ * absent — a plain string-prefix check on the unresolved `path.resolve`
+ * output would miss this.
+ *
+ * Only climbs past ENOENT/ENOTDIR (genuine "does not exist" conditions).
+ * Any other errno (EACCES, ELOOP, EINVAL, Windows UNC/drive failures, …)
+ * returns null — we must not silently walk past a permission-denied
+ * ancestor and reach a canonical root that trivially passes containment.
+ */
+function canonicalizeWithMissingTail(target) {
+    let head = target;
+    const tail = [];
+    while (true) {
+        try {
+            const canonicalHead = fs.realpathSync(head);
+            return tail.length === 0 ? canonicalHead : path.join(canonicalHead, ...tail);
+        }
+        catch (err) {
+            const code = err instanceof Error ? err.code : undefined;
+            if (code !== 'ENOENT' && code !== 'ENOTDIR')
+                return null;
+            const parent = path.dirname(head);
+            if (parent === head)
+                return null;
+            tail.unshift(path.basename(head));
+            head = parent;
+        }
+    }
+}
+function isContained(candidate, root) {
+    // `path.relative` normalizes the comparison across platforms (POSIX `/`,
+    // Windows drive roots, UNC shares) and naturally defeats both prefix
+    // collision (`/project` vs `/project-malicious` → `../project-malicious/…`)
+    // and root-slash edge cases (`/` + `path.sep` = `//`, which a manual
+    // `startsWith` check would mishandle).
+    const rel = path.relative(root, candidate);
+    if (rel === '')
+        return true; // candidate === root
+    if (rel === '..' || rel.startsWith('..' + path.sep))
+        return false;
+    if (path.isAbsolute(rel))
+        return false; // different Windows drive
+    return true;
+}
+//# sourceMappingURL=artifact-path.js.map

package/dist/utils/artifact-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-path.js","sourceRoot":"","sources":["../../src/utils/artifact-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,WAAmB,EACnB,OAAe;IAEf,0EAA0E;IAC1E,2EAA2E;IAC3E,wEAAwE;IACxE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IAEnD,IAAI,aAAqB,CAAA;IACzB,IAAI,CAAC;QACH,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,aAAa,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAA;IAC3D,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEvC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,aAAa,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3D,0EAA0E;IAC1E,0EAA0E;IAC1E,uEAAuE;IACvE,0DAA0D;IAC1D,IAAI,aAAa,KAAK,aAAa;QAAE,OAAO,IAAI,CAAA;IAChD,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,2BAA2B,CAAC,MAAc;IACjD,IAAI,IAAI,GAAG,MAAM,CAAA;IACjB,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;YAC3C,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAAA;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAE,GAA6B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;YACnF,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAA;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACjC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAA;YAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;YACjC,IAAI,GAAG,MAAM,CAAA;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB,EAAE,IAAY;IAClD,yEAAyE;IACzE,qEAAqE;IACrE,4EAA4E;IAC5E,qEAAqE;IACrE,uCAAuC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAC1C,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA,CAAC,qBAAqB;IACjD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACjE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,0BAA0B;IACjE,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/utils/artifact-path.test.d.ts

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

package/dist/utils/artifact-path.test.d.ts.map

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