@zigrivers/scaffold 2.1.0

package/dist/state/completion.test.js

@@ -0,0 +1,246 @@
+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 { detectCompletion, checkCompletion, analyzeCrash } from './completion.js';
+const tmpDirs = [];
+function makeTempDir() {
+    const dir = path.join(os.tmpdir(), `scaffold-comp-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(dir, { 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;
+});
+function makeBaseState(overrides = {}) {
+    return {
+        'schema-version': 1,
+        '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': [],
+        ...overrides,
+    };
+}
+describe('detectCompletion', () => {
+    it('returns complete=true when all artifacts present', () => {
+        const dir = makeTempDir();
+        const artifactPath = 'docs/prd.md';
+        fs.mkdirSync(path.join(dir, 'docs'), { recursive: true });
+        fs.writeFileSync(path.join(dir, artifactPath), 'content', 'utf8');
+        const state = makeBaseState();
+        const result = detectCompletion('create-prd', state, [artifactPath], dir);
+        expect(result.complete).toBe(true);
+        expect(result.artifactsPresent).toEqual([artifactPath]);
+        expect(result.artifactsMissing).toEqual([]);
+    });
+    it('returns complete=false when artifacts missing', () => {
+        const dir = makeTempDir();
+        const state = makeBaseState();
+        const result = detectCompletion('create-prd', state, ['docs/prd.md'], dir);
+        expect(result.complete).toBe(false);
+        expect(result.artifactsPresent).toEqual([]);
+        expect(result.artifactsMissing).toEqual(['docs/prd.md']);
+    });
+    it('treats zero-byte files as present', () => {
+        const dir = makeTempDir();
+        const artifactPath = 'docs/empty.md';
+        fs.mkdirSync(path.join(dir, 'docs'), { recursive: true });
+        fs.writeFileSync(path.join(dir, artifactPath), '', 'utf8');
+        const state = makeBaseState();
+        const result = detectCompletion('create-prd', state, [artifactPath], dir);
+        expect(result.complete).toBe(true);
+        expect(result.artifactsPresent).toEqual([artifactPath]);
+        expect(result.artifactsMissing).toEqual([]);
+    });
+    it('returns lists of present and missing artifacts', () => {
+        const dir = makeTempDir();
+        const presentPath = 'docs/prd.md';
+        const missingPath = 'docs/arch.md';
+        fs.mkdirSync(path.join(dir, 'docs'), { recursive: true });
+        fs.writeFileSync(path.join(dir, presentPath), 'content', 'utf8');
+        const state = makeBaseState();
+        const result = detectCompletion('create-prd', state, [presentPath, missingPath], dir);
+        expect(result.complete).toBe(false);
+        expect(result.artifactsPresent).toEqual([presentPath]);
+        expect(result.artifactsMissing).toEqual([missingPath]);
+    });
+});
+describe('checkCompletion', () => {
+    it('returns confirmed_complete when state=completed AND artifacts present', () => {
+        const dir = makeTempDir();
+        const artifactPath = 'docs/prd.md';
+        fs.mkdirSync(path.join(dir, 'docs'), { recursive: true });
+        fs.writeFileSync(path.join(dir, artifactPath), 'content', 'utf8');
+        const state = makeBaseState({
+            steps: {
+                'create-prd': {
+                    status: 'completed',
+                    source: 'pipeline',
+                    produces: [artifactPath],
+                },
+            },
+        });
+        const result = checkCompletion('create-prd', state, dir);
+        expect(result.status).toBe('confirmed_complete');
+        expect(result.presentArtifacts).toEqual([artifactPath]);
+        expect(result.missingArtifacts).toEqual([]);
+    });
+    it('returns likely_complete when state!=completed BUT artifacts exist', () => {
+        const dir = makeTempDir();
+        const artifactPath = 'docs/prd.md';
+        fs.mkdirSync(path.join(dir, 'docs'), { recursive: true });
+        fs.writeFileSync(path.join(dir, artifactPath), 'content', 'utf8');
+        const state = makeBaseState({
+            steps: {
+                'create-prd': {
+                    status: 'pending',
+                    source: 'pipeline',
+                    produces: [artifactPath],
+                },
+            },
+        });
+        const result = checkCompletion('create-prd', state, dir);
+        expect(result.status).toBe('likely_complete');
+        expect(result.presentArtifacts).toEqual([artifactPath]);
+        expect(result.missingArtifacts).toEqual([]);
+    });
+    it('returns conflict when state=completed BUT artifacts missing', () => {
+        const dir = makeTempDir();
+        const state = makeBaseState({
+            steps: {
+                'create-prd': {
+                    status: 'completed',
+                    source: 'pipeline',
+                    produces: ['docs/prd.md'],
+                },
+            },
+        });
+        const result = checkCompletion('create-prd', state, dir);
+        expect(result.status).toBe('conflict');
+        expect(result.presentArtifacts).toEqual([]);
+        expect(result.missingArtifacts).toEqual(['docs/prd.md']);
+    });
+    it('returns incomplete when state!=completed AND artifacts missing', () => {
+        const dir = makeTempDir();
+        const state = makeBaseState({
+            steps: {
+                'create-prd': {
+                    status: 'pending',
+                    source: 'pipeline',
+                    produces: ['docs/prd.md'],
+                },
+            },
+        });
+        const result = checkCompletion('create-prd', state, dir);
+        expect(result.status).toBe('incomplete');
+        expect(result.presentArtifacts).toEqual([]);
+        expect(result.missingArtifacts).toEqual(['docs/prd.md']);
+    });
+});
+describe('analyzeCrash', () => {
+    it('returns auto_complete when all artifacts present after crash', () => {
+        const dir = makeTempDir();
+        const artifactPath = 'docs/prd.md';
+        fs.mkdirSync(path.join(dir, 'docs'), { recursive: true });
+        fs.writeFileSync(path.join(dir, artifactPath), 'content', 'utf8');
+        const state = makeBaseState({
+            in_progress: {
+                step: 'create-prd',
+                started: new Date().toISOString(),
+                partial_artifacts: [],
+                actor: 'agent-1',
+            },
+            steps: {
+                'create-prd': {
+                    status: 'in_progress',
+                    source: 'pipeline',
+                    produces: [artifactPath],
+                },
+            },
+        });
+        const result = analyzeCrash(state, dir);
+        expect(result.action).toBe('auto_complete');
+        expect(result.presentArtifacts).toEqual([artifactPath]);
+        expect(result.missingArtifacts).toEqual([]);
+    });
+    it('returns recommend_rerun when no artifacts present after crash', () => {
+        const dir = makeTempDir();
+        const state = makeBaseState({
+            in_progress: {
+                step: 'create-prd',
+                started: new Date().toISOString(),
+                partial_artifacts: [],
+                actor: 'agent-1',
+            },
+            steps: {
+                'create-prd': {
+                    status: 'in_progress',
+                    source: 'pipeline',
+                    produces: ['docs/prd.md'],
+                },
+            },
+        });
+        const result = analyzeCrash(state, dir);
+        expect(result.action).toBe('recommend_rerun');
+        expect(result.presentArtifacts).toEqual([]);
+        expect(result.missingArtifacts).toEqual(['docs/prd.md']);
+    });
+    it('returns ask_user when partial artifacts present after crash', () => {
+        const dir = makeTempDir();
+        const presentPath = 'docs/prd.md';
+        const missingPath = 'docs/arch.md';
+        fs.mkdirSync(path.join(dir, 'docs'), { recursive: true });
+        fs.writeFileSync(path.join(dir, presentPath), 'content', 'utf8');
+        const state = makeBaseState({
+            in_progress: {
+                step: 'create-prd',
+                started: new Date().toISOString(),
+                partial_artifacts: [],
+                actor: 'agent-1',
+            },
+            steps: {
+                'create-prd': {
+                    status: 'in_progress',
+                    source: 'pipeline',
+                    produces: [presentPath, missingPath],
+                },
+            },
+        });
+        const result = analyzeCrash(state, dir);
+        expect(result.action).toBe('ask_user');
+        expect(result.presentArtifacts).toEqual([presentPath]);
+        expect(result.missingArtifacts).toEqual([missingPath]);
+    });
+    it('returns recommend_rerun when in_progress is null', () => {
+        const dir = makeTempDir();
+        const state = makeBaseState({
+            in_progress: null,
+            steps: {
+                'create-prd': {
+                    status: 'pending',
+                    source: 'pipeline',
+                    produces: ['docs/prd.md'],
+                },
+            },
+        });
+        const result = analyzeCrash(state, dir);
+        expect(result.action).toBe('recommend_rerun');
+        expect(result.presentArtifacts).toEqual([]);
+        expect(result.missingArtifacts).toEqual([]);
+    });
+});
+//# sourceMappingURL=completion.test.js.map

package/dist/state/completion.test.js.map

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

package/dist/state/decision-logger.d.ts

@@ -0,0 +1,16 @@
+import type { DecisionEntry } from '../types/index.js';
+/**
+ * Append a decision entry to .scaffold/decisions.jsonl.
+ * Assigns the next sequential ID (D-001, D-002, ...).
+ * @returns The assigned decision ID.
+ */
+export declare function appendDecision(projectRoot: string, entry: Omit<DecisionEntry, 'id'>): string;
+/**
+ * Read decision entries from .scaffold/decisions.jsonl.
+ * Optionally filter by step slug or limit to last N entries.
+ */
+export declare function readDecisions(projectRoot: string, filter?: {
+    step?: string;
+    last?: number;
+}): DecisionEntry[];
+//# sourceMappingURL=decision-logger.d.ts.map

package/dist/state/decision-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-logger.d.ts","sourceRoot":"","sources":["../../src/state/decision-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AA0DtD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAC/B,MAAM,CAUR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,aAAa,EAAE,CAajB"}

package/dist/state/decision-logger.js

@@ -0,0 +1,80 @@
+import { fileExists, ensureDir } from '../utils/fs.js';
+import { decisionParseError } from '../utils/errors.js';
+import fs from 'node:fs';
+import path from 'node:path';
+const DECISIONS_FILE = 'decisions.jsonl';
+const SCAFFOLD_DIR = '.scaffold';
+function decisionsPath(projectRoot) {
+    return path.join(projectRoot, SCAFFOLD_DIR, DECISIONS_FILE);
+}
+/**
+ * Read all valid DecisionEntry objects from decisions.jsonl.
+ * Skips blank lines and emits a warning for corrupt lines (tolerant reader).
+ */
+function readAllEntries(filePath) {
+    if (!fileExists(filePath))
+        return [];
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const lines = raw.split('\n');
+    const entries = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line === '')
+            continue;
+        try {
+            entries.push(JSON.parse(line));
+        }
+        catch (err) {
+            const warning = decisionParseError(filePath, i + 1, err.message);
+            console.warn(`[scaffold] ${warning.message}`);
+        }
+    }
+    return entries;
+}
+/** Extract the numeric value from a D-NNN id string. Returns 0 if not parseable. */
+function idToNumber(id) {
+    const match = /^D-(\d+)$/.exec(id);
+    if (!match)
+        return 0;
+    return parseInt(match[1], 10);
+}
+/** Compute the next D-NNN id based on existing entries in the file. */
+function getNextId(projectRoot) {
+    const filePath = decisionsPath(projectRoot);
+    if (!fileExists(filePath))
+        return 'D-001';
+    const entries = readAllEntries(filePath);
+    if (entries.length === 0)
+        return 'D-001';
+    const max = Math.max(...entries.map(e => idToNumber(e.id)));
+    return `D-${(max + 1).toString().padStart(3, '0')}`;
+}
+/**
+ * Append a decision entry to .scaffold/decisions.jsonl.
+ * Assigns the next sequential ID (D-001, D-002, ...).
+ * @returns The assigned decision ID.
+ */
+export function appendDecision(projectRoot, entry) {
+    ensureDir(path.join(projectRoot, SCAFFOLD_DIR));
+    const id = getNextId(projectRoot);
+    const fullEntry = { id, ...entry };
+    const line = JSON.stringify(fullEntry) + '\n';
+    fs.appendFileSync(decisionsPath(projectRoot), line, 'utf8');
+    return id;
+}
+/**
+ * Read decision entries from .scaffold/decisions.jsonl.
+ * Optionally filter by step slug or limit to last N entries.
+ */
+export function readDecisions(projectRoot, filter) {
+    const filePath = decisionsPath(projectRoot);
+    let entries = readAllEntries(filePath);
+    if (filter?.step !== undefined) {
+        entries = entries.filter(e => e.prompt === filter.step);
+    }
+    if (filter?.last !== undefined) {
+        entries = entries.slice(-filter.last);
+    }
+    return entries;
+}
+//# sourceMappingURL=decision-logger.js.map

package/dist/state/decision-logger.js.map

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

package/dist/state/decision-logger.test.d.ts

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

package/dist/state/decision-logger.test.d.ts.map

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

package/dist/state/decision-logger.test.js

@@ -0,0 +1,182 @@
+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, vi } from 'vitest';
+import { appendDecision, readDecisions } from './decision-logger.js';
+const tmpDirs = [];
+function makeTempDir() {
+    const dir = path.join(os.tmpdir(), `scaffold-dl-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(dir, { 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;
+    vi.restoreAllMocks();
+});
+const baseEntry = {
+    prompt: 'create-prd',
+    decision: 'Use PostgreSQL',
+    at: '2024-01-01T00:00:00Z',
+    completed_by: 'user',
+    step_completed: true,
+};
+describe('appendDecision', () => {
+    it('appends one JSONL line to decisions.jsonl', () => {
+        const dir = makeTempDir();
+        appendDecision(dir, baseEntry);
+        const decisionsPath = path.join(dir, '.scaffold', 'decisions.jsonl');
+        expect(fs.existsSync(decisionsPath)).toBe(true);
+        const content = fs.readFileSync(decisionsPath, 'utf8');
+        expect(content.trim()).not.toBe('');
+    });
+    it('each line is valid JSON parseable independently', () => {
+        const dir = makeTempDir();
+        appendDecision(dir, baseEntry);
+        appendDecision(dir, { ...baseEntry, prompt: 'system-architecture', decision: 'Microservices' });
+        const decisionsPath = path.join(dir, '.scaffold', 'decisions.jsonl');
+        const lines = fs.readFileSync(decisionsPath, 'utf8').split('\n').filter(l => l.trim() !== '');
+        expect(lines).toHaveLength(2);
+        for (const line of lines) {
+            expect(() => JSON.parse(line)).not.toThrow();
+        }
+    });
+    it('ID format is D-NNN (monotonically increasing)', () => {
+        const dir = makeTempDir();
+        appendDecision(dir, baseEntry);
+        appendDecision(dir, { ...baseEntry, decision: 'Second' });
+        appendDecision(dir, { ...baseEntry, decision: 'Third' });
+        const entries = readDecisions(dir);
+        expect(entries[0].id).toBe('D-001');
+        expect(entries[1].id).toBe('D-002');
+        expect(entries[2].id).toBe('D-003');
+    });
+    it('returns the assigned ID string', () => {
+        const dir = makeTempDir();
+        const id1 = appendDecision(dir, baseEntry);
+        expect(id1).toBe('D-001');
+        const id2 = appendDecision(dir, { ...baseEntry, decision: 'Another' });
+        expect(id2).toBe('D-002');
+    });
+    it('creates decisions.jsonl if it does not exist', () => {
+        const dir = makeTempDir();
+        const decisionsPath = path.join(dir, '.scaffold', 'decisions.jsonl');
+        expect(fs.existsSync(decisionsPath)).toBe(false);
+        appendDecision(dir, baseEntry);
+        expect(fs.existsSync(decisionsPath)).toBe(true);
+    });
+    it('second entry gets D-002, third gets D-003', () => {
+        const dir = makeTempDir();
+        const id1 = appendDecision(dir, baseEntry);
+        const id2 = appendDecision(dir, { ...baseEntry, decision: 'Second' });
+        const id3 = appendDecision(dir, { ...baseEntry, decision: 'Third' });
+        expect(id1).toBe('D-001');
+        expect(id2).toBe('D-002');
+        expect(id3).toBe('D-003');
+    });
+    it('serializes optional fields (category, tags, review_status, depth) when provided', () => {
+        const dir = makeTempDir();
+        appendDecision(dir, {
+            ...baseEntry,
+            category: 'database',
+            tags: ['infra', 'storage'],
+            review_status: 'pending',
+            depth: 3,
+        });
+        const entries = readDecisions(dir);
+        expect(entries[0].category).toBe('database');
+        expect(entries[0].tags).toEqual(['infra', 'storage']);
+        expect(entries[0].review_status).toBe('pending');
+        expect(entries[0].depth).toBe(3);
+    });
+});
+describe('readDecisions', () => {
+    it('returns all entries parsed from JSONL', () => {
+        const dir = makeTempDir();
+        appendDecision(dir, baseEntry);
+        appendDecision(dir, { ...baseEntry, prompt: 'system-architecture', decision: 'Microservices' });
+        const entries = readDecisions(dir);
+        expect(entries).toHaveLength(2);
+        expect(entries[0].decision).toBe('Use PostgreSQL');
+        expect(entries[1].decision).toBe('Microservices');
+    });
+    it('filters by step slug', () => {
+        const dir = makeTempDir();
+        appendDecision(dir, { ...baseEntry, prompt: 'create-prd', decision: 'PRD decision' });
+        appendDecision(dir, { ...baseEntry, prompt: 'system-architecture', decision: 'Arch decision' });
+        appendDecision(dir, { ...baseEntry, prompt: 'create-prd', decision: 'Another PRD decision' });
+        const entries = readDecisions(dir, { step: 'create-prd' });
+        expect(entries).toHaveLength(2);
+        expect(entries.every(e => e.prompt === 'create-prd')).toBe(true);
+    });
+    it('returns last N entries', () => {
+        const dir = makeTempDir();
+        appendDecision(dir, { ...baseEntry, decision: 'First' });
+        appendDecision(dir, { ...baseEntry, decision: 'Second' });
+        appendDecision(dir, { ...baseEntry, decision: 'Third' });
+        const entries = readDecisions(dir, { last: 2 });
+        expect(entries).toHaveLength(2);
+        expect(entries[0].decision).toBe('Second');
+        expect(entries[1].decision).toBe('Third');
+    });
+    it('returns empty array when file does not exist', () => {
+        const dir = makeTempDir();
+        const entries = readDecisions(dir);
+        expect(entries).toEqual([]);
+    });
+    it('tolerates blank lines in JSONL file', () => {
+        const dir = makeTempDir();
+        const scaffoldDir = path.join(dir, '.scaffold');
+        fs.mkdirSync(scaffoldDir, { recursive: true });
+        const decisionsPath = path.join(scaffoldDir, 'decisions.jsonl');
+        const e1 = {
+            id: 'D-001', prompt: 'create-prd', decision: 'Use PostgreSQL',
+            at: '2024-01-01T00:00:00Z', completed_by: 'user', step_completed: true,
+        };
+        const e2 = {
+            id: 'D-002', prompt: 'create-prd', decision: 'Second',
+            at: '2024-01-02T00:00:00Z', completed_by: 'user', step_completed: false,
+        };
+        const line1 = JSON.stringify(e1);
+        const line2 = JSON.stringify(e2);
+        fs.writeFileSync(decisionsPath, `${line1}\n\n${line2}\n`, 'utf8');
+        const entries = readDecisions(dir);
+        expect(entries).toHaveLength(2);
+    });
+    it('handles corrupt lines gracefully (skips them)', () => {
+        const dir = makeTempDir();
+        const scaffoldDir = path.join(dir, '.scaffold');
+        fs.mkdirSync(scaffoldDir, { recursive: true });
+        const decisionsPath = path.join(scaffoldDir, 'decisions.jsonl');
+        const e1 = {
+            id: 'D-001', prompt: 'create-prd', decision: 'Good',
+            at: '2024-01-01T00:00:00Z', completed_by: 'user', step_completed: true,
+        };
+        const goodLine = JSON.stringify(e1);
+        fs.writeFileSync(decisionsPath, `${goodLine}\nnot-valid-json\n`, 'utf8');
+        const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const entries = readDecisions(dir);
+        expect(entries).toHaveLength(1);
+        expect(entries[0].decision).toBe('Good');
+        consoleSpy.mockRestore();
+    });
+    it('combines step filter and last N', () => {
+        const dir = makeTempDir();
+        appendDecision(dir, { ...baseEntry, prompt: 'create-prd', decision: 'PRD 1' });
+        appendDecision(dir, { ...baseEntry, prompt: 'system-architecture', decision: 'Arch 1' });
+        appendDecision(dir, { ...baseEntry, prompt: 'create-prd', decision: 'PRD 2' });
+        appendDecision(dir, { ...baseEntry, prompt: 'create-prd', decision: 'PRD 3' });
+        const entries = readDecisions(dir, { step: 'create-prd', last: 2 });
+        expect(entries).toHaveLength(2);
+        expect(entries[0].decision).toBe('PRD 2');
+        expect(entries[1].decision).toBe('PRD 3');
+    });
+});
+//# sourceMappingURL=decision-logger.test.js.map

package/dist/state/decision-logger.test.js.map

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

package/dist/state/lock-manager.d.ts

@@ -0,0 +1,18 @@
+import type { LockFile, LockableCommand } from '../types/index.js';
+import type { ScaffoldError, ScaffoldWarning } from '../types/index.js';
+/** Check whether a lock is stale (holder process no longer running). */
+export declare function isStale(lock: LockFile): boolean;
+/** Read lock file if exists; return null if absent or corrupt. */
+export declare function checkLock(projectRoot: string): LockFile | null;
+/**
+ * Attempt to acquire .scaffold/lock.json advisory lock.
+ * Returns acquired: false with warning on contention, or error on other failure.
+ */
+export declare function acquireLock(projectRoot: string, command: LockableCommand, step?: string): {
+    acquired: boolean;
+    warning?: ScaffoldWarning;
+    error?: ScaffoldError;
+};
+/** Release lock by deleting .scaffold/lock.json (only if current process holds it). */
+export declare function releaseLock(projectRoot: string): void;
+//# sourceMappingURL=lock-manager.d.ts.map

package/dist/state/lock-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/state/lock-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAoCvE,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAc/C;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAW9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,MAAM,GACZ;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAAE,CAyCzE;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAYrD"}