@zigrivers/scaffold 2.1.0

package/dist/project/frontmatter.js

@@ -0,0 +1,236 @@
+// src/project/frontmatter.ts
+import fs from 'node:fs';
+import yaml from 'js-yaml';
+import { z } from 'zod';
+import { frontmatterMissing, frontmatterUnclosed, frontmatterYamlError, frontmatterNameInvalid, frontmatterUnknownField, fieldMissing, } from '../utils/errors.js';
+// Known valid YAML keys (for unknown field detection)
+const KNOWN_YAML_KEYS = new Set([
+    'name',
+    'description',
+    'phase',
+    'order',
+    'dependencies',
+    'depends-on',
+    'outputs',
+    'conditional',
+    'knowledge-base',
+    'reads',
+]);
+// Zod schema for frontmatter validation
+const frontmatterSchema = z.object({
+    name: z.string().regex(/^[a-z][a-z0-9-]*$/, 'name must be kebab-case'),
+    description: z.string().max(200),
+    phase: z.enum([
+        'pre',
+        'modeling',
+        'decisions',
+        'architecture',
+        'specification',
+        'planning',
+        'quality',
+        'validation',
+        'finalization',
+    ]),
+    order: z.number().int().min(1).max(36),
+    dependencies: z.array(z.string().regex(/^[a-z][a-z0-9-]*$/)).default([]),
+    outputs: z.array(z.string()).nonempty(),
+    conditional: z.enum(['if-needed']).nullable().default(null),
+    knowledgeBase: z.array(z.string()).default([]),
+    reads: z.array(z.string().regex(/^[a-z][a-z0-9-]*$/)).default([]),
+});
+/** Extract YAML text and body from file content. Throws ScaffoldError on structural issues. */
+function extractFrontmatter(content, filePath) {
+    const lines = content.split('\n');
+    if (lines[0].trim() !== '---') {
+        throw frontmatterMissing(filePath);
+    }
+    // Find the closing ---
+    let closeIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            closeIdx = i;
+            break;
+        }
+    }
+    if (closeIdx === -1) {
+        throw frontmatterUnclosed(filePath);
+    }
+    const yamlText = lines.slice(1, closeIdx).join('\n');
+    // Body is everything after the closing ---, preserving a leading newline
+    const body = lines.slice(closeIdx + 1).join('\n');
+    return { yamlText, body };
+}
+/** Parse YAML text into a raw object. Throws ScaffoldError on parse failure. */
+function parseYaml(yamlText, filePath) {
+    let parsed;
+    try {
+        parsed = yaml.load(yamlText, { schema: yaml.FAILSAFE_SCHEMA });
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw frontmatterYamlError(filePath, detail);
+    }
+    if (parsed === null || parsed === undefined) {
+        return {};
+    }
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw frontmatterYamlError(filePath, 'frontmatter must be a YAML mapping');
+    }
+    return parsed;
+}
+/** Detect unknown fields and return warnings. */
+function collectUnknownFieldWarnings(raw, filePath) {
+    const warnings = [];
+    for (const key of Object.keys(raw)) {
+        if (!KNOWN_YAML_KEYS.has(key)) {
+            warnings.push(frontmatterUnknownField(key, filePath));
+        }
+    }
+    return warnings;
+}
+/**
+ * Convert raw YAML object to normalized TypeScript shape:
+ * - knowledge-base → knowledgeBase
+ * - depends-on → dependencies (alias)
+ * - FAILSAFE_SCHEMA returns all values as strings, so we must coerce numbers
+ */
+function normalizeRawObject(raw) {
+    const normalized = { ...raw };
+    // knowledge-base → knowledgeBase
+    if ('knowledge-base' in normalized) {
+        normalized['knowledgeBase'] = normalized['knowledge-base'];
+        delete normalized['knowledge-base'];
+    }
+    // depends-on → dependencies (alias, only if dependencies not already set)
+    if ('depends-on' in normalized && !('dependencies' in normalized)) {
+        normalized['dependencies'] = normalized['depends-on'];
+    }
+    // Always remove depends-on from the object
+    if ('depends-on' in normalized) {
+        delete normalized['depends-on'];
+    }
+    // FAILSAFE_SCHEMA returns all scalars as strings — coerce order to number
+    if (typeof normalized['order'] === 'string') {
+        const n = Number(normalized['order']);
+        normalized['order'] = isNaN(n) ? normalized['order'] : n;
+    }
+    // Coerce arrays parsed via FAILSAFE_SCHEMA (values remain strings, which is correct)
+    // Arrays returned by FAILSAFE_SCHEMA are already arrays of strings — no coercion needed
+    return normalized;
+}
+/**
+ * Validate the normalized object with Zod, mapping errors to ScaffoldError.
+ * Returns validated frontmatter + array of errors.
+ */
+function zodValidate(normalized, filePath) {
+    const result = frontmatterSchema.safeParse(normalized);
+    if (result.success) {
+        // Preserve unknown fields on the returned object
+        const fm = {
+            ...normalized,
+            ...result.data,
+        };
+        return { frontmatter: fm, errors: [] };
+    }
+    const errors = [];
+    for (const issue of result.error.issues) {
+        const field = issue.path[0] ? String(issue.path[0]) : 'unknown';
+        if (issue.code === 'invalid_enum_value' || issue.code === 'too_small' || issue.code === 'too_big') {
+            // Generic field-level error — map to FIELD_MISSING-like or use fieldWrongType
+            errors.push(fieldMissing(field, filePath));
+        }
+        else if (issue.code === 'invalid_string' && field === 'name') {
+            const nameVal = String(normalized['name'] ?? '');
+            errors.push(frontmatterNameInvalid(nameVal, filePath));
+        }
+        else if (issue.code === 'invalid_type' && issue.received === 'undefined') {
+            errors.push(fieldMissing(field, filePath));
+        }
+        else {
+            // Catch-all
+            errors.push(fieldMissing(field, filePath));
+        }
+    }
+    return { frontmatter: null, errors };
+}
+/**
+ * Parse frontmatter only — throws ScaffoldError on malformed YAML or missing required fields.
+ */
+export function parseFrontmatter(filePath) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const { yamlText } = extractFrontmatter(content, filePath);
+    const raw = parseYaml(yamlText, filePath);
+    const normalized = normalizeRawObject(raw);
+    // Validate name first for clear error
+    if ('name' in normalized) {
+        const nameVal = normalized['name'];
+        if (typeof nameVal === 'string' && !/^[a-z][a-z0-9-]*$/.test(nameVal)) {
+            throw frontmatterNameInvalid(nameVal, filePath);
+        }
+    }
+    const { frontmatter, errors } = zodValidate(normalized, filePath);
+    if (errors.length > 0) {
+        throw errors[0];
+    }
+    if (!frontmatter) {
+        throw fieldMissing('frontmatter', filePath);
+    }
+    return frontmatter;
+}
+/**
+ * Parse frontmatter + body with validation.
+ * Returns errors array (empty on success) rather than throwing.
+ */
+export function parseAndValidate(filePath) {
+    const errors = [];
+    const warnings = [];
+    const emptyFrontmatter = {
+        name: '',
+        description: '',
+        phase: '',
+        order: 0,
+        dependencies: [],
+        outputs: [],
+        conditional: null,
+        knowledgeBase: [],
+        reads: [],
+    };
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        errors.push(frontmatterYamlError(filePath, detail));
+        return { frontmatter: emptyFrontmatter, body: '', errors, warnings };
+    }
+    let yamlText;
+    let body;
+    try {
+        const extracted = extractFrontmatter(content, filePath);
+        yamlText = extracted.yamlText;
+        body = extracted.body;
+    }
+    catch (err) {
+        errors.push(err);
+        return { frontmatter: emptyFrontmatter, body: '', errors, warnings };
+    }
+    let raw;
+    try {
+        raw = parseYaml(yamlText, filePath);
+    }
+    catch (err) {
+        errors.push(err);
+        return { frontmatter: emptyFrontmatter, body, errors, warnings };
+    }
+    // Collect unknown field warnings before normalizing
+    warnings.push(...collectUnknownFieldWarnings(raw, filePath));
+    const normalized = normalizeRawObject(raw);
+    const { frontmatter, errors: zodErrors } = zodValidate(normalized, filePath);
+    errors.push(...zodErrors);
+    if (frontmatter) {
+        return { frontmatter, body, errors, warnings };
+    }
+    return { frontmatter: emptyFrontmatter, body, errors, warnings };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/project/frontmatter.js.map

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

package/dist/project/frontmatter.test.d.ts

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

package/dist/project/frontmatter.test.d.ts.map

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

package/dist/project/frontmatter.test.js

@@ -0,0 +1,218 @@
+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 { parseFrontmatter, parseAndValidate } from './frontmatter.js';
+const tmpFiles = [];
+function tmpPath(ext = '.md') {
+    const p = path.join(os.tmpdir(), `scaffold-fm-test-${crypto.randomUUID()}${ext}`);
+    tmpFiles.push(p);
+    return p;
+}
+function writeTmp(content, ext = '.md') {
+    const p = tmpPath(ext);
+    fs.writeFileSync(p, content, 'utf8');
+    return p;
+}
+afterEach(() => {
+    for (const f of tmpFiles) {
+        try {
+            fs.rmSync(f, { force: true });
+        }
+        catch { /* ignore */ }
+    }
+    tmpFiles.length = 0;
+});
+const validFrontmatter = `---
+name: create-prd
+description: Create a product requirements document
+phase: pre
+order: 1
+outputs:
+  - docs/prd.md
+knowledge-base:
+  - prd-craft
+reads: []
+---
+
+This is the body.
+`;
+describe('parseFrontmatter', () => {
+    it('parses valid frontmatter and returns typed object', () => {
+        const p = writeTmp(validFrontmatter);
+        const result = parseFrontmatter(p);
+        expect(result.name).toBe('create-prd');
+        expect(result.description).toBe('Create a product requirements document');
+        expect(result.phase).toBe('pre');
+        expect(result.order).toBe(1);
+        expect(result.outputs).toEqual(['docs/prd.md']);
+        expect(result.knowledgeBase).toEqual(['prd-craft']);
+        expect(result.reads).toEqual([]);
+        expect(result.dependencies).toEqual([]);
+        expect(result.conditional).toBeNull();
+    });
+    it('rejects file without opening --- on line 1 (FRONTMATTER_MISSING)', () => {
+        const p = writeTmp('name: create-prd\n---\n');
+        expect(() => parseFrontmatter(p)).toThrowError(expect.objectContaining({ code: 'FRONTMATTER_MISSING' }));
+    });
+    it('rejects unclosed frontmatter (FRONTMATTER_UNCLOSED)', () => {
+        const p = writeTmp('---\nname: create-prd\ndescription: foo\n');
+        expect(() => parseFrontmatter(p)).toThrowError(expect.objectContaining({ code: 'FRONTMATTER_UNCLOSED' }));
+    });
+    it('rejects invalid YAML (FRONTMATTER_YAML_ERROR)', () => {
+        const p = writeTmp('---\n: invalid: yaml: [\n---\n');
+        expect(() => parseFrontmatter(p)).toThrowError(expect.objectContaining({ code: 'FRONTMATTER_YAML_ERROR' }));
+    });
+    it('validates name is kebab-case — rejects "Create PRD" (FRONTMATTER_NAME_INVALID)', () => {
+        const invalid = '---\nname: Create PRD\ndescription: desc\nphase: pre\norder: 1\noutputs:\n  - docs/prd.md\n---\n';
+        const p = writeTmp(invalid);
+        expect(() => parseFrontmatter(p)).toThrowError(expect.objectContaining({ code: 'FRONTMATTER_NAME_INVALID' }));
+    });
+    it('requires outputs field to be present and non-empty', () => {
+        const p = writeTmp('---\nname: create-prd\ndescription: desc\nphase: pre\norder: 1\n---\n');
+        expect(() => parseFrontmatter(p)).toThrow();
+    });
+});
+describe('parseAndValidate', () => {
+    it('returns errors array empty on valid frontmatter', () => {
+        const p = writeTmp(validFrontmatter);
+        const result = parseAndValidate(p);
+        expect(result.errors).toHaveLength(0);
+        expect(result.warnings.filter(w => w.code !== 'FRONTMATTER_UNKNOWN_FIELD')).toHaveLength(0);
+    });
+    it('returns body text after closing ---', () => {
+        const p = writeTmp(validFrontmatter);
+        const result = parseAndValidate(p);
+        expect(result.body.trim()).toBe('This is the body.');
+    });
+    it('emits FRONTMATTER_UNKNOWN_FIELD warning for unknown fields', () => {
+        const p = writeTmp(`---
+name: create-prd
+description: Create a product requirements document
+phase: pre
+order: 1
+outputs:
+  - docs/prd.md
+unknown-field: some-value
+---
+`);
+        const result = parseAndValidate(p);
+        const unknownWarnings = result.warnings.filter(w => w.code === 'FRONTMATTER_UNKNOWN_FIELD');
+        expect(unknownWarnings).toHaveLength(1);
+        expect(unknownWarnings[0].context?.['field']).toBe('unknown-field');
+    });
+    it('converts knowledge-base YAML key to knowledgeBase TypeScript property', () => {
+        const p = writeTmp(`---
+name: create-prd
+description: Create a product requirements document
+phase: pre
+order: 1
+outputs:
+  - docs/prd.md
+knowledge-base:
+  - prd-craft
+  - architecture-guide
+---
+`);
+        const result = parseAndValidate(p);
+        expect(result.errors).toHaveLength(0);
+        expect(result.frontmatter.knowledgeBase).toEqual(['prd-craft', 'architecture-guide']);
+    });
+    it('parses and returns reads field when present', () => {
+        const p = writeTmp(`---
+name: create-prd
+description: Create a product requirements document
+phase: pre
+order: 1
+outputs:
+  - docs/prd.md
+reads:
+  - define-scope
+  - create-goals
+---
+`);
+        const result = parseAndValidate(p);
+        expect(result.errors).toHaveLength(0);
+        expect(result.frontmatter.reads).toEqual(['define-scope', 'create-goals']);
+    });
+    it('validates order field is present, is integer, in range 1-36', () => {
+        const missingOrder = writeTmp(`---
+name: create-prd
+description: desc
+phase: pre
+outputs:
+  - docs/prd.md
+---
+`);
+        const res1 = parseAndValidate(missingOrder);
+        expect(res1.errors.some(e => e.code === 'FIELD_MISSING')).toBe(true);
+        const outOfRange = writeTmp(`---
+name: create-prd
+description: desc
+phase: pre
+order: 99
+outputs:
+  - docs/prd.md
+---
+`);
+        const res2 = parseAndValidate(outOfRange);
+        expect(res2.errors.length).toBeGreaterThan(0);
+    });
+    it('sets default empty arrays for dependencies, knowledgeBase, reads when absent', () => {
+        const p = writeTmp(validFrontmatter.replace('knowledge-base:\n  - prd-craft\nreads: []\n', ''));
+        const result = parseAndValidate(p);
+        expect(result.frontmatter.dependencies).toEqual([]);
+        expect(result.frontmatter.knowledgeBase).toEqual([]);
+        expect(result.frontmatter.reads).toEqual([]);
+    });
+    it('sets conditional to null when absent', () => {
+        const p = writeTmp(validFrontmatter);
+        const result = parseAndValidate(p);
+        expect(result.frontmatter.conditional).toBeNull();
+    });
+    it('parses depends-on as alias for dependencies', () => {
+        const p = writeTmp(`---
+name: create-arch
+description: Create architecture document
+phase: architecture
+order: 5
+outputs:
+  - docs/arch.md
+depends-on:
+  - create-prd
+---
+`);
+        const result = parseAndValidate(p);
+        expect(result.errors).toHaveLength(0);
+        expect(result.frontmatter.dependencies).toEqual(['create-prd']);
+    });
+    it('returns errors array with FRONTMATTER_MISSING when no opening delimiter', () => {
+        const p = writeTmp('name: create-prd\n---\n');
+        const result = parseAndValidate(p);
+        expect(result.errors.some(e => e.code === 'FRONTMATTER_MISSING')).toBe(true);
+        expect(result.body).toBe('');
+    });
+    it('returns errors array with FRONTMATTER_UNCLOSED when no closing delimiter', () => {
+        const p = writeTmp('---\nname: create-prd\n');
+        const result = parseAndValidate(p);
+        expect(result.errors.some(e => e.code === 'FRONTMATTER_UNCLOSED')).toBe(true);
+        expect(result.body).toBe('');
+    });
+    it('accepts conditional: if-needed', () => {
+        const p = writeTmp(`---
+name: create-prd
+description: desc
+phase: pre
+order: 1
+outputs:
+  - docs/prd.md
+conditional: if-needed
+---
+`);
+        const result = parseAndValidate(p);
+        expect(result.errors).toHaveLength(0);
+        expect(result.frontmatter.conditional).toBe('if-needed');
+    });
+});
+//# sourceMappingURL=frontmatter.test.js.map

package/dist/project/frontmatter.test.js.map

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

package/dist/project/signals.d.ts

@@ -0,0 +1,12 @@
+export type ProjectMode = 'greenfield' | 'brownfield' | 'v1-migration';
+export interface ProjectSignal {
+    category: 'package-manifest' | 'source-directory' | 'documentation' | 'test-config' | 'ci-config' | 'v1-tracking';
+    file: string;
+    detected: boolean;
+}
+export interface DetectionResult {
+    mode: ProjectMode;
+    signals: ProjectSignal[];
+    methodologySuggestion: 'deep' | 'mvp' | 'custom';
+}
+//# sourceMappingURL=signals.d.ts.map

package/dist/project/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/project/signals.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,cAAc,CAAA;AAEtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,CAAA;IACjH,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,qBAAqB,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;CACjD"}

package/dist/project/signals.js

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

package/dist/project/signals.js.map

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

package/dist/state/completion.d.ts

@@ -0,0 +1,22 @@
+import type { PipelineState } from '../types/index.js';
+export interface CompletionResult {
+    complete: boolean;
+    artifactsPresent: string[];
+    artifactsMissing: string[];
+}
+export interface CrashRecoveryAction {
+    action: 'auto_complete' | 'recommend_rerun' | 'ask_user';
+    presentArtifacts: string[];
+    missingArtifacts: string[];
+}
+/** Check whether a step's expected outputs are present on disk. */
+export declare function detectCompletion(step: string, state: PipelineState, expectedOutputs: string[], projectRoot: string): CompletionResult;
+/** Check state vs artifact existence — returns status enum. */
+export declare function checkCompletion(step: string, state: PipelineState, projectRoot: string): {
+    status: 'confirmed_complete' | 'likely_complete' | 'conflict' | 'incomplete';
+    presentArtifacts: string[];
+    missingArtifacts: string[];
+};
+/** Analyze a crashed session (non-null in_progress) and recommend recovery action. */
+export declare function analyzeCrash(state: PipelineState, projectRoot: string): CrashRecoveryAction;
+//# sourceMappingURL=completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/state/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,GAAG,iBAAiB,GAAG,UAAU,CAAA;IACxD,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,eAAe,EAAE,MAAM,EAAE,EACzB,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAkBlB;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GAClB;IACD,MAAM,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,UAAU,GAAG,YAAY,CAAA;IAC5E,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B,CA4BA;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,mBAAmB,CA6B3F"}

package/dist/state/completion.js

@@ -0,0 +1,82 @@
+import { fileExists } from '../utils/fs.js';
+import path from 'node:path';
+/** Check whether a step's expected outputs are present on disk. */
+export function detectCompletion(step, state, expectedOutputs, projectRoot) {
+    const artifactsPresent = [];
+    const artifactsMissing = [];
+    for (const output of expectedOutputs) {
+        const fullPath = path.resolve(projectRoot, output);
+        if (fileExists(fullPath)) {
+            artifactsPresent.push(output);
+        }
+        else {
+            artifactsMissing.push(output);
+        }
+    }
+    return {
+        complete: artifactsMissing.length === 0,
+        artifactsPresent,
+        artifactsMissing,
+    };
+}
+/** Check state vs artifact existence — returns status enum. */
+export function checkCompletion(step, state, projectRoot) {
+    const stepEntry = state.steps[step];
+    const expectedOutputs = stepEntry?.produces ?? [];
+    const stateCompleted = stepEntry?.status === 'completed';
+    const presentArtifacts = [];
+    const missingArtifacts = [];
+    for (const output of expectedOutputs) {
+        const fullPath = path.resolve(projectRoot, output);
+        if (fileExists(fullPath)) {
+            presentArtifacts.push(output);
+        }
+        else {
+            missingArtifacts.push(output);
+        }
+    }
+    const allPresent = missingArtifacts.length === 0;
+    if (stateCompleted && allPresent) {
+        return { status: 'confirmed_complete', presentArtifacts, missingArtifacts };
+    }
+    else if (!stateCompleted && allPresent) {
+        return { status: 'likely_complete', presentArtifacts, missingArtifacts };
+    }
+    else if (stateCompleted && !allPresent) {
+        return { status: 'conflict', presentArtifacts, missingArtifacts };
+    }
+    else {
+        return { status: 'incomplete', presentArtifacts, missingArtifacts };
+    }
+}
+/** Analyze a crashed session (non-null in_progress) and recommend recovery action. */
+export function analyzeCrash(state, projectRoot) {
+    const inProgress = state.in_progress;
+    if (!inProgress) {
+        return { action: 'recommend_rerun', presentArtifacts: [], missingArtifacts: [] };
+    }
+    const step = inProgress.step;
+    const stepEntry = state.steps[step];
+    const expectedOutputs = stepEntry?.produces ?? [];
+    const presentArtifacts = [];
+    const missingArtifacts = [];
+    for (const output of expectedOutputs) {
+        const fullPath = path.resolve(projectRoot, output);
+        if (fileExists(fullPath)) {
+            presentArtifacts.push(output);
+        }
+        else {
+            missingArtifacts.push(output);
+        }
+    }
+    if (missingArtifacts.length === 0 && presentArtifacts.length > 0) {
+        return { action: 'auto_complete', presentArtifacts, missingArtifacts };
+    }
+    else if (presentArtifacts.length === 0) {
+        return { action: 'recommend_rerun', presentArtifacts, missingArtifacts };
+    }
+    else {
+        return { action: 'ask_user', presentArtifacts, missingArtifacts };
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/state/completion.js.map

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

package/dist/state/completion.test.d.ts

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

package/dist/state/completion.test.d.ts.map

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