@zigrivers/scaffold 2.1.0

package/dist/state/state-manager.test.js

@@ -0,0 +1,240 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { describe, it, expect, afterEach } from 'vitest';
+import { StateManager } from './state-manager.js';
+const tmpDirs = [];
+function makeTempDir() {
+    const dir = path.join(os.tmpdir(), `scaffold-sm-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.mkdirSync(path.join(dir, '.scaffold'), { recursive: true });
+    tmpDirs.push(dir);
+    return dir;
+}
+afterEach(() => {
+    for (const d of tmpDirs) {
+        try {
+            fs.rmSync(d, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    }
+    tmpDirs.length = 0;
+});
+const computeEligible = () => [];
+const ENABLED_STEPS = [
+    { slug: 'create-prd', produces: ['docs/prd.md'] },
+    { slug: 'create-architecture', produces: ['docs/architecture.md'] },
+];
+const INIT_OPTIONS = {
+    enabledSteps: ENABLED_STEPS,
+    scaffoldVersion: '2.0.0',
+    methodology: 'deep',
+    initMode: 'greenfield',
+};
+describe('StateManager', () => {
+    describe('initializeState', () => {
+        it('creates valid state.json with all steps pending, schema-version 1', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            const statePath = path.join(tempDir, '.scaffold', 'state.json');
+            expect(fs.existsSync(statePath)).toBe(true);
+            const raw = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+            expect(raw['schema-version']).toBe(1);
+            expect(raw.steps['create-prd'].status).toBe('pending');
+            expect(raw.steps['create-architecture'].status).toBe('pending');
+        });
+        it('populates all 10 required top-level fields per state-json-schema.md', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            const statePath = path.join(tempDir, '.scaffold', 'state.json');
+            const raw = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+            expect(raw).toHaveProperty('schema-version');
+            expect(raw).toHaveProperty('scaffold-version');
+            expect(raw).toHaveProperty('init_methodology');
+            expect(raw).toHaveProperty('config_methodology');
+            expect(raw).toHaveProperty('init-mode');
+            expect(raw).toHaveProperty('created');
+            expect(raw).toHaveProperty('in_progress');
+            expect(raw).toHaveProperty('steps');
+            expect(raw).toHaveProperty('next_eligible');
+            expect(raw).toHaveProperty('extra-steps');
+        });
+    });
+    describe('loadState', () => {
+        it('loads existing state.json successfully', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            const state = manager.loadState();
+            expect(state['schema-version']).toBe(1);
+            expect(state['scaffold-version']).toBe('2.0.0');
+            expect(state.steps['create-prd'].status).toBe('pending');
+        });
+        it('throws STATE_MISSING when file not found', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            expect(() => manager.loadState()).toThrow();
+            try {
+                manager.loadState();
+            }
+            catch (err) {
+                expect(err.code).toBe('STATE_MISSING');
+            }
+        });
+        it('throws STATE_PARSE_ERROR on invalid JSON', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            const statePath = path.join(tempDir, '.scaffold', 'state.json');
+            fs.writeFileSync(statePath, '{ invalid json }', 'utf8');
+            expect(() => manager.loadState()).toThrow();
+            try {
+                manager.loadState();
+            }
+            catch (err) {
+                expect(err.code).toBe('STATE_PARSE_ERROR');
+            }
+        });
+        it('throws STATE_SCHEMA_VERSION on schema-version mismatch', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            const statePath = path.join(tempDir, '.scaffold', 'state.json');
+            const badState = {
+                'schema-version': 99,
+                'scaffold-version': '2.0.0',
+                init_methodology: 'deep',
+                config_methodology: 'deep',
+                'init-mode': 'greenfield',
+                created: new Date().toISOString(),
+                in_progress: null,
+                steps: {},
+                next_eligible: [],
+                'extra-steps': [],
+            };
+            fs.writeFileSync(statePath, JSON.stringify(badState, null, 2), 'utf8');
+            expect(() => manager.loadState()).toThrow();
+            try {
+                manager.loadState();
+            }
+            catch (err) {
+                expect(err.code).toBe('STATE_SCHEMA_VERSION');
+            }
+        });
+    });
+    describe('setInProgress', () => {
+        it('sets step to in_progress and populates in_progress record', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            manager.setInProgress('create-prd', 'agent-1');
+            const state = manager.loadState();
+            expect(state.steps['create-prd'].status).toBe('in_progress');
+            expect(state.in_progress).not.toBeNull();
+            expect(state.in_progress?.step).toBe('create-prd');
+            expect(state.in_progress?.actor).toBe('agent-1');
+            expect(state.in_progress?.partial_artifacts).toEqual([]);
+            expect(typeof state.in_progress?.started).toBe('string');
+        });
+        it('throws PSM_ALREADY_IN_PROGRESS when in_progress is non-null', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            manager.setInProgress('create-prd', 'agent-1');
+            expect(() => manager.setInProgress('create-architecture', 'agent-2')).toThrow();
+            try {
+                manager.setInProgress('create-architecture', 'agent-2');
+            }
+            catch (err) {
+                expect(err.code).toBe('PSM_ALREADY_IN_PROGRESS');
+            }
+        });
+        it('only one step can be in_progress at a time', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            manager.setInProgress('create-prd', 'agent-1');
+            const state = manager.loadState();
+            // Only create-prd is in_progress; create-architecture is still pending
+            expect(state.steps['create-prd'].status).toBe('in_progress');
+            expect(state.steps['create-architecture'].status).toBe('pending');
+            expect(state.in_progress?.step).toBe('create-prd');
+        });
+    });
+    describe('markCompleted', () => {
+        it('sets status to completed, records timestamp and outputs, clears in_progress', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            manager.setInProgress('create-prd', 'agent-1');
+            manager.markCompleted('create-prd', ['docs/prd.md'], 'agent-1', 3);
+            const state = manager.loadState();
+            expect(state.steps['create-prd'].status).toBe('completed');
+            expect(state.steps['create-prd'].produces).toEqual(['docs/prd.md']);
+            expect(state.steps['create-prd'].artifacts_verified).toBe(true);
+            expect(typeof state.steps['create-prd'].at).toBe('string');
+            expect(state.in_progress).toBeNull();
+        });
+        it('records completed_by and depth fields', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            manager.setInProgress('create-prd', 'agent-1');
+            manager.markCompleted('create-prd', ['docs/prd.md'], 'agent-1', 4);
+            const state = manager.loadState();
+            expect(state.steps['create-prd'].completed_by).toBe('agent-1');
+            expect(state.steps['create-prd'].depth).toBe(4);
+        });
+    });
+    describe('markSkipped', () => {
+        it('sets status to skipped with reason and timestamp', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            manager.setInProgress('create-prd', 'agent-1');
+            manager.markSkipped('create-prd', 'not needed for MVP', 'agent-1');
+            const state = manager.loadState();
+            expect(state.steps['create-prd'].status).toBe('skipped');
+            expect(state.steps['create-prd'].reason).toBe('not needed for MVP');
+            expect(state.steps['create-prd'].completed_by).toBe('agent-1');
+            expect(typeof state.steps['create-prd'].at).toBe('string');
+            expect(state.in_progress).toBeNull();
+        });
+    });
+    describe('clearInProgress', () => {
+        it('sets in_progress to null', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            manager.setInProgress('create-prd', 'agent-1');
+            manager.clearInProgress();
+            const state = manager.loadState();
+            expect(state.in_progress).toBeNull();
+        });
+    });
+    describe('getStepStatus', () => {
+        it('returns status of a step', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            expect(manager.getStepStatus('create-prd')).toBe('pending');
+        });
+        it('returns undefined for unknown step', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            expect(manager.getStepStatus('non-existent-step')).toBeUndefined();
+        });
+    });
+    describe('atomic writes', () => {
+        it('state.json.tmp does not persist after successful write', () => {
+            const tempDir = makeTempDir();
+            const manager = new StateManager(tempDir, computeEligible);
+            manager.initializeState(INIT_OPTIONS);
+            const tmpPath = path.join(tempDir, '.scaffold', 'state.json.tmp');
+            expect(fs.existsSync(tmpPath)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=state-manager.test.js.map

package/dist/state/state-manager.test.js.map

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

package/dist/types/adapter.d.ts

@@ -0,0 +1,24 @@
+import type { ScaffoldConfig } from './config.js';
+import type { MetaPromptFrontmatter } from './frontmatter.js';
+export interface AdapterContext {
+    config: ScaffoldConfig;
+    projectRoot: string;
+    outputDir: string;
+}
+export interface AdapterStepInput {
+    frontmatter: MetaPromptFrontmatter;
+    assembledPrompt: string;
+    stepIndex: number;
+    totalSteps: number;
+}
+export interface AdapterStepOutput {
+    filePath: string;
+    content: string;
+}
+export interface PlatformAdapter {
+    name: string;
+    initialize(context: AdapterContext): void;
+    generateStepWrapper(input: AdapterStepInput): AdapterStepOutput;
+    finalize(): void;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAE7D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,qBAAqB,CAAA;IAClC,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IACzC,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAAA;IAC/D,QAAQ,IAAI,IAAI,CAAA;CACjB"}

package/dist/types/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/types/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":""}

package/dist/types/assembly.d.ts

@@ -0,0 +1,89 @@
+import type { DepthLevel } from './enums.js';
+import type { MetaPromptFile } from './frontmatter.js';
+import type { ScaffoldConfig } from './config.js';
+import type { PipelineState } from './state.js';
+import type { ScaffoldError, ScaffoldWarning } from './errors.js';
+/** A knowledge base entry loaded from knowledge/. */
+export interface KnowledgeEntry {
+    name: string;
+    description: string;
+    topics: string[];
+    content: string;
+}
+/** An existing artifact from a completed step (for update mode). */
+export interface ExistingArtifact {
+    filePath: string;
+    content: string;
+    previousDepth: DepthLevel;
+    completionTimestamp: string;
+}
+/** A single artifact entry from a completed step. */
+export interface ArtifactEntry {
+    stepName: string;
+    filePath: string;
+    content: string;
+}
+/** Project context gathered for assembly. */
+export interface ProjectContext {
+    artifacts: ArtifactEntry[];
+    config: ScaffoldConfig;
+    state: PipelineState;
+    decisions: string;
+    existingOutput?: ExistingArtifact;
+}
+/** Resolved user instructions from three-layer precedence (ADR-047). */
+export interface UserInstructions {
+    global: string | null;
+    perStep: string | null;
+    inline: string | null;
+}
+/** A single named section of an assembled prompt. */
+export interface PromptSection {
+    heading: string;
+    content: string;
+}
+export type DepthProvenance = 'cli-flag' | 'step-override' | 'custom-default' | 'preset-default';
+/** Assembly metadata recorded with each assembled prompt. */
+export interface AssemblyMetadata {
+    stepName: string;
+    depth: DepthLevel;
+    depthProvenance: DepthProvenance;
+    knowledgeBaseEntries: string[];
+    instructionLayers: Array<'global' | 'per-step' | 'inline'>;
+    artifactCount: number;
+    decisionCount: number;
+    assemblyDurationMs: number;
+    assembledAt: string;
+    updateMode: boolean;
+    sectionsIncluded: string[];
+}
+/** The complete assembled prompt. */
+export interface AssembledPrompt {
+    text: string;
+    sections: PromptSection[];
+    metadata: AssemblyMetadata;
+}
+/** Options passed to AssemblyEngine.assemble(). */
+export interface AssemblyOptions {
+    config: ScaffoldConfig;
+    state: PipelineState;
+    metaPrompt: MetaPromptFile;
+    knowledgeEntries: KnowledgeEntry[];
+    /** Pre-loaded artifacts from the dependency chain (caller is responsible for loading). */
+    artifacts?: ArtifactEntry[];
+    /** Pre-formatted decisions string (caller is responsible for loading). */
+    decisions?: string;
+    instructions: UserInstructions;
+    depth: DepthLevel;
+    depthProvenance: DepthProvenance;
+    updateMode: boolean;
+    existingArtifact?: ExistingArtifact;
+}
+/** Result from AssemblyEngine.assemble(). */
+export interface AssemblyResult {
+    success: boolean;
+    prompt?: AssembledPrompt;
+    errors: ScaffoldError[];
+    warnings: ScaffoldWarning[];
+}
+//# sourceMappingURL=assembly.d.ts.map

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

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

package/dist/types/assembly.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assembly.js.map

package/dist/types/assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly.js","sourceRoot":"","sources":["../../src/types/assembly.ts"],"names":[],"mappings":""}

package/dist/types/claude-md.d.ts

@@ -0,0 +1,11 @@
+export interface ReservedSection {
+    id: string;
+    heading: string;
+    content: string;
+    tokenCount: number;
+}
+export interface SectionRegistry {
+    sections: ReservedSection[];
+    totalTokens: number;
+}
+//# sourceMappingURL=claude-md.d.ts.map

package/dist/types/claude-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md.d.ts","sourceRoot":"","sources":["../../src/types/claude-md.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;CACpB"}

package/dist/types/claude-md.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-md.js.map

package/dist/types/claude-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md.js","sourceRoot":"","sources":["../../src/types/claude-md.ts"],"names":[],"mappings":""}

package/dist/types/cli.d.ts

@@ -0,0 +1,15 @@
+import type { ScaffoldError, ScaffoldWarning } from './errors.js';
+export interface GlobalFlags {
+    format?: 'json';
+    auto?: boolean;
+    verbose?: boolean;
+    root?: string;
+    force?: boolean;
+}
+export interface CommandResult {
+    exitCode: number;
+    data?: unknown;
+    errors?: ScaffoldError[];
+    warnings?: ScaffoldWarning[];
+}
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEjE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAA;CAC7B"}

package/dist/types/cli.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/types/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":""}

package/dist/types/config.d.ts

@@ -0,0 +1,40 @@
+import type { MethodologyName, DepthLevel } from './enums.js';
+/** Per-step override in custom methodology config. */
+export interface CustomStepConfig {
+    enabled?: boolean;
+    depth?: DepthLevel;
+}
+/** Custom methodology configuration object in config.yml. */
+export interface CustomConfig {
+    default_depth?: DepthLevel;
+    steps?: Record<string, CustomStepConfig>;
+}
+/** Project characteristics from config.yml. */
+export interface ProjectConfig {
+    name?: string;
+    platforms?: Array<'web' | 'mobile' | 'desktop'>;
+    [key: string]: unknown;
+}
+/**
+ * Scaffold v2 project configuration (.scaffold/config.yml).
+ * See config-yml-schema.md.
+ */
+export interface ScaffoldConfig {
+    version: 2;
+    methodology: MethodologyName;
+    custom?: CustomConfig;
+    platforms: Array<'claude-code' | 'codex'>;
+    project?: ProjectConfig;
+    [key: string]: unknown;
+}
+/** Methodology preset definition (from methodology/deep.yml, mvp.yml, custom-defaults.yml). */
+export interface MethodologyPreset {
+    name: string;
+    description: string;
+    default_depth: DepthLevel;
+    steps: Record<string, {
+        enabled: boolean;
+        conditional?: 'if-needed';
+    }>;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE7D,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,UAAU,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CACzC;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAA;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAA;IACV,WAAW,EAAE,eAAe,CAAA;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,SAAS,EAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,CAAA;IACzC,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,UAAU,CAAA;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CACvE"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/decision.d.ts

@@ -0,0 +1,14 @@
+import type { DepthLevel } from './enums.js';
+export interface DecisionEntry {
+    id: string;
+    prompt: string;
+    decision: string;
+    at: string;
+    completed_by: string;
+    step_completed: boolean;
+    category?: string;
+    tags?: string[];
+    review_status?: 'pending' | 'approved' | 'rejected';
+    depth?: DepthLevel;
+}
+//# sourceMappingURL=decision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/types/decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,aAAa,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IACnD,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB"}

package/dist/types/decision.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decision.js.map

package/dist/types/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/types/decision.ts"],"names":[],"mappings":""}

package/dist/types/dependency.d.ts

@@ -0,0 +1,12 @@
+export interface DependencyNode {
+    slug: string;
+    phase: string;
+    order: number;
+    dependencies: string[];
+    enabled: boolean;
+}
+export interface DependencyGraph {
+    nodes: Map<string, DependencyNode>;
+    edges: Map<string, string[]>;
+}
+//# sourceMappingURL=dependency.d.ts.map

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

@@ -0,0 +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,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,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"}

package/dist/types/dependency.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dependency.js.map

package/dist/types/dependency.js.map

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

package/dist/types/enums.d.ts

@@ -0,0 +1,23 @@
+/** Methodology preset name. See config-yml-schema.md. */
+export type MethodologyName = 'deep' | 'mvp' | 'custom';
+/**
+ * Depth level scale 1-5. 1=minimal, 5=comprehensive.
+ * ADR-043: depth scale.
+ */
+export type DepthLevel = 1 | 2 | 3 | 4 | 5;
+/** Source of a pipeline step. 'extra' is Phase 2 (reserved). */
+export type StepSource = 'pipeline' | 'extra';
+/** Pipeline step lifecycle status. */
+export type StepStatus = 'pending' | 'in_progress' | 'completed' | 'skipped';
+/** CLI process exit codes. ADR-025. */
+export declare enum ExitCode {
+    Success = 0,
+    ValidationError = 1,
+    MissingDependency = 2,
+    StateCorruption = 3,
+    UserCancellation = 4,
+    BuildError = 5
+}
+/** Output mode for CLI. */
+export type OutputMode = 'interactive' | 'json' | 'auto';
+//# sourceMappingURL=enums.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;AAEvD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE1C,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,CAAA;AAE7C,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAA;AAE5E,uCAAuC;AACvC,oBAAY,QAAQ;IAClB,OAAO,IAAI;IACX,eAAe,IAAI;IACnB,iBAAiB,IAAI;IACrB,eAAe,IAAI;IACnB,gBAAgB,IAAI;IACpB,UAAU,IAAI;CACf;AAED,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAA"}

package/dist/types/enums.js

@@ -0,0 +1,11 @@
+/** CLI process exit codes. ADR-025. */
+export var ExitCode;
+(function (ExitCode) {
+    ExitCode[ExitCode["Success"] = 0] = "Success";
+    ExitCode[ExitCode["ValidationError"] = 1] = "ValidationError";
+    ExitCode[ExitCode["MissingDependency"] = 2] = "MissingDependency";
+    ExitCode[ExitCode["StateCorruption"] = 3] = "StateCorruption";
+    ExitCode[ExitCode["UserCancellation"] = 4] = "UserCancellation";
+    ExitCode[ExitCode["BuildError"] = 5] = "BuildError";
+})(ExitCode || (ExitCode = {}));
+//# sourceMappingURL=enums.js.map

package/dist/types/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAeA,uCAAuC;AACvC,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,6CAAW,CAAA;IACX,6DAAmB,CAAA;IACnB,iEAAqB,CAAA;IACrB,6DAAmB,CAAA;IACnB,+DAAoB,CAAA;IACpB,mDAAc,CAAA;AAChB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB"}

package/dist/types/enums.test.d.ts

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

package/dist/types/enums.test.d.ts.map

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

package/dist/types/enums.test.js

@@ -0,0 +1,13 @@
+import { describe, it, expect } from 'vitest';
+import { ExitCode } from './enums.js';
+describe('ExitCode enum', () => {
+    it('has correct exit code values per ADR-025', () => {
+        expect(ExitCode.Success).toBe(0);
+        expect(ExitCode.ValidationError).toBe(1);
+        expect(ExitCode.MissingDependency).toBe(2);
+        expect(ExitCode.StateCorruption).toBe(3);
+        expect(ExitCode.UserCancellation).toBe(4);
+        expect(ExitCode.BuildError).toBe(5);
+    });
+});
+//# sourceMappingURL=enums.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enums.test.js","sourceRoot":"","sources":["../../src/types/enums.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC1C,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACzC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}