@zigrivers/scaffold 2.1.0

package/dist/state/lock-manager.js

@@ -0,0 +1,134 @@
+// src/state/lock-manager.ts
+import { ensureDir } from '../utils/fs.js';
+import { lockHeld, lockWriteFailed, lockStaleCleared } from '../utils/errors.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { execSync } from 'node:child_process';
+function getLockPath(projectRoot) {
+    return path.join(projectRoot, '.scaffold', 'lock.json');
+}
+function lockAcquisitionRace(filePath) {
+    return {
+        code: 'LOCK_ACQUISITION_RACE',
+        message: 'Lock acquisition race detected — another process acquired the lock concurrently',
+        exitCode: 5,
+        context: { file: filePath },
+    };
+}
+function getProcessStartTime(pid) {
+    try {
+        const output = execSync(`ps -o lstart= -p ${pid}`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const trimmed = output.trim();
+        if (!trimmed)
+            return null;
+        const date = new Date(trimmed);
+        return isNaN(date.getTime()) ? null : date;
+    }
+    catch {
+        return null;
+    }
+}
+/** Check whether a lock is stale (holder process no longer running). */
+export function isStale(lock) {
+    try {
+        process.kill(lock.pid, 0); // signal 0 = check liveness only
+        // PID is alive — check if it's been recycled
+        const actualStartTime = getProcessStartTime(lock.pid);
+        if (actualStartTime === null)
+            return true; // can't read start time = assume stale
+        // Compare: if actual start differs by >2s from recorded, PID was recycled
+        const recorded = new Date(lock.processStartedAt).getTime();
+        const actual = actualStartTime.getTime();
+        return Math.abs(actual - recorded) > 2000;
+    }
+    catch {
+        // ESRCH = no such process = stale
+        return true;
+    }
+}
+/** Read lock file if exists; return null if absent or corrupt. */
+export function checkLock(projectRoot) {
+    const filePath = getLockPath(projectRoot);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const raw = fs.readFileSync(filePath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        // Auto-delete corrupt lock file
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch { /* ignore */ }
+        return null;
+    }
+}
+/**
+ * Attempt to acquire .scaffold/lock.json advisory lock.
+ * Returns acquired: false with warning on contention, or error on other failure.
+ */
+export function acquireLock(projectRoot, command, step) {
+    ensureDir(path.join(projectRoot, '.scaffold'));
+    const filePath = getLockPath(projectRoot);
+    let staleClearedWarning;
+    // Check for existing lock
+    const existing = checkLock(projectRoot);
+    if (existing !== null) {
+        if (isStale(existing)) {
+            // Auto-clear stale lock
+            try {
+                fs.unlinkSync(filePath);
+            }
+            catch { /* ignore if already gone */ }
+            staleClearedWarning = lockStaleCleared(existing.holder, existing.pid);
+        }
+        else {
+            // Active lock held by another process
+            return { acquired: false, error: lockHeld(existing.holder, existing.pid, existing.command) };
+        }
+    }
+    // Build lock data
+    const lockData = {
+        holder: os.hostname(),
+        prompt: step,
+        pid: process.pid,
+        started: new Date().toISOString(),
+        processStartedAt: getProcessStartTime(process.pid)?.toISOString() ?? new Date().toISOString(),
+        command,
+    };
+    // Atomically create lock file using exclusive open (O_CREAT | O_EXCL)
+    try {
+        const fd = fs.openSync(filePath, 'wx');
+        fs.writeSync(fd, JSON.stringify(lockData, null, 2));
+        fs.closeSync(fd);
+        return { acquired: true, warning: staleClearedWarning };
+    }
+    catch (err) {
+        if (err.code === 'EEXIST') {
+            return { acquired: false, error: lockAcquisitionRace(filePath) };
+        }
+        return { acquired: false, error: lockWriteFailed(filePath, err.message) };
+    }
+}
+/** Release lock by deleting .scaffold/lock.json (only if current process holds it). */
+export function releaseLock(projectRoot) {
+    const lock = checkLock(projectRoot);
+    if (lock === null)
+        return; // no lock — no-op
+    if (lock.pid === process.pid) {
+        try {
+            fs.unlinkSync(getLockPath(projectRoot));
+        }
+        catch { /* ignore if already gone */ }
+    }
+    else {
+        // Different PID owns this lock — do not delete
+        console.warn(`[scaffold] Warning: attempted to release lock owned by PID ${lock.pid} (current PID: ${process.pid})`);
+    }
+}
+//# sourceMappingURL=lock-manager.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,190 @@
+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 { acquireLock, releaseLock, checkLock, isStale } from './lock-manager.js';
+const tmpDirs = [];
+function makeTempDir() {
+    const dir = path.join(os.tmpdir(), `scaffold-lm-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(dir, { recursive: true });
+    tmpDirs.push(dir);
+    return dir;
+}
+function writeLock(projectRoot, data) {
+    const lockDir = path.join(projectRoot, '.scaffold');
+    fs.mkdirSync(lockDir, { recursive: true });
+    fs.writeFileSync(path.join(lockDir, 'lock.json'), JSON.stringify(data, null, 2), 'utf8');
+}
+afterEach(() => {
+    for (const d of tmpDirs) {
+        try {
+            fs.rmSync(d, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    }
+    tmpDirs.length = 0;
+});
+describe('acquireLock', () => {
+    it('creates lock.json with correct fields', () => {
+        const dir = makeTempDir();
+        const result = acquireLock(dir, 'run', 'create-prd');
+        expect(result.acquired).toBe(true);
+        const lockPath = path.join(dir, '.scaffold', 'lock.json');
+        expect(fs.existsSync(lockPath)).toBe(true);
+        const lock = JSON.parse(fs.readFileSync(lockPath, 'utf8'));
+        expect(lock.holder).toBe(os.hostname());
+        expect(lock.pid).toBe(process.pid);
+        expect(lock.command).toBe('run');
+        expect(lock.prompt).toBe('create-prd');
+        expect(lock.started).toBeTruthy();
+        expect(lock.processStartedAt).toBeTruthy();
+        expect(new Date(lock.started).getTime()).not.toBeNaN();
+    });
+    it('returns acquired: true on success', () => {
+        const dir = makeTempDir();
+        const result = acquireLock(dir, 'init');
+        expect(result.acquired).toBe(true);
+        expect(result.error).toBeUndefined();
+        expect(result.warning).toBeUndefined();
+    });
+    it('returns acquired: false with error when lock exists and PID alive', () => {
+        const dir = makeTempDir();
+        // Write a lock held by the current process (alive PID)
+        const lock = {
+            holder: os.hostname(),
+            pid: process.pid,
+            started: new Date().toISOString(),
+            processStartedAt: new Date().toISOString(),
+            command: 'run',
+        };
+        writeLock(dir, lock);
+        const result = acquireLock(dir, 'skip');
+        expect(result.acquired).toBe(false);
+        expect(result.error).toBeDefined();
+        expect(result.error?.code).toBe('LOCK_HELD');
+        expect(result.error?.exitCode).toBe(3);
+    });
+    it('returns LOCK_HELD error code when lock is active', () => {
+        const dir = makeTempDir();
+        const lock = {
+            holder: 'some-host',
+            pid: process.pid,
+            started: new Date().toISOString(),
+            processStartedAt: new Date().toISOString(),
+            command: 'run',
+        };
+        writeLock(dir, lock);
+        const result = acquireLock(dir, 'run');
+        expect(result.acquired).toBe(false);
+        expect(result.error?.code).toBe('LOCK_HELD');
+    });
+    it('auto-clears stale lock and acquires successfully (LOCK_STALE_CLEARED warning)', () => {
+        const dir = makeTempDir();
+        // Use a PID that definitely does not exist
+        const deadPid = 999999;
+        const lock = {
+            holder: 'old-host',
+            pid: deadPid,
+            started: new Date(Date.now() - 60000).toISOString(),
+            processStartedAt: new Date(Date.now() - 60000).toISOString(),
+            command: 'run',
+        };
+        writeLock(dir, lock);
+        const result = acquireLock(dir, 'init');
+        expect(result.acquired).toBe(true);
+        expect(result.warning).toBeDefined();
+        expect(result.warning?.code).toBe('LOCK_STALE_CLEARED');
+        // New lock should exist with current PID
+        const newLock = checkLock(dir);
+        expect(newLock?.pid).toBe(process.pid);
+    });
+});
+describe('releaseLock', () => {
+    it('deletes lock.json when current process holds it', () => {
+        const dir = makeTempDir();
+        acquireLock(dir, 'run');
+        const lockPath = path.join(dir, '.scaffold', 'lock.json');
+        expect(fs.existsSync(lockPath)).toBe(true);
+        releaseLock(dir);
+        expect(fs.existsSync(lockPath)).toBe(false);
+    });
+    it('does not delete lock.json when different PID holds it', () => {
+        const dir = makeTempDir();
+        const lock = {
+            holder: 'other-host',
+            pid: 12345,
+            started: new Date().toISOString(),
+            processStartedAt: new Date().toISOString(),
+            command: 'run',
+        };
+        writeLock(dir, lock);
+        releaseLock(dir);
+        const lockPath = path.join(dir, '.scaffold', 'lock.json');
+        // Lock should still exist since we don't own it
+        expect(fs.existsSync(lockPath)).toBe(true);
+    });
+    it('does nothing when no lock exists', () => {
+        const dir = makeTempDir();
+        // Should not throw
+        expect(() => releaseLock(dir)).not.toThrow();
+    });
+});
+describe('checkLock', () => {
+    it('returns null when lock.json does not exist', () => {
+        const dir = makeTempDir();
+        expect(checkLock(dir)).toBeNull();
+    });
+    it('returns LockFile when lock.json exists', () => {
+        const dir = makeTempDir();
+        const lock = {
+            holder: 'test-host',
+            pid: 42,
+            started: new Date().toISOString(),
+            processStartedAt: new Date().toISOString(),
+            command: 'init',
+        };
+        writeLock(dir, lock);
+        const result = checkLock(dir);
+        expect(result).not.toBeNull();
+        expect(result?.holder).toBe('test-host');
+        expect(result?.pid).toBe(42);
+        expect(result?.command).toBe('init');
+    });
+    it('returns null and auto-deletes corrupt lock file', () => {
+        const dir = makeTempDir();
+        const lockDir = path.join(dir, '.scaffold');
+        fs.mkdirSync(lockDir, { recursive: true });
+        fs.writeFileSync(path.join(lockDir, 'lock.json'), 'not valid json {{ }}', 'utf8');
+        const result = checkLock(dir);
+        expect(result).toBeNull();
+        // Corrupt file should be auto-deleted
+        expect(fs.existsSync(path.join(lockDir, 'lock.json'))).toBe(false);
+    });
+});
+describe('isStale', () => {
+    it('returns true when PID is not running', () => {
+        const lock = {
+            holder: 'some-host',
+            pid: 999999,
+            started: new Date().toISOString(),
+            processStartedAt: new Date().toISOString(),
+            command: 'run',
+        };
+        expect(isStale(lock)).toBe(true);
+    });
+    it('returns false when PID matches current process', () => {
+        // Use the current process PID — it is definitely running
+        const lock = {
+            holder: os.hostname(),
+            pid: process.pid,
+            started: new Date().toISOString(),
+            processStartedAt: new Date().toISOString(),
+            command: 'run',
+        };
+        // Current process is alive — isStale should return false
+        const result = isStale(lock);
+        expect(result).toBe(false);
+    });
+});
+//# sourceMappingURL=lock-manager.test.js.map

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

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

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

@@ -0,0 +1,37 @@
+import type { PipelineState, StepStateEntry, InProgressRecord, DepthLevel, StepStatus } from '../types/index.js';
+import type { ScaffoldError } from '../types/index.js';
+export declare class StateManager {
+    private projectRoot;
+    private computeEligible;
+    private statePath;
+    constructor(projectRoot: string, computeEligible: (steps: Record<string, StepStateEntry>) => string[]);
+    /** Load and validate state.json from disk. Throws ScaffoldError on schema mismatch. */
+    loadState(): PipelineState;
+    /** Atomically persist state to disk (write tmp + rename). */
+    saveState(state: PipelineState): void;
+    /** Transition step to in_progress; sets in_progress record with actor. */
+    setInProgress(step: string, actor: string): void;
+    /** Transition step to completed; records outputs, actor, and depth. */
+    markCompleted(step: string, outputs: string[], completedBy: string, depth: DepthLevel): void;
+    /** Transition step to skipped; records reason and actor. */
+    markSkipped(step: string, reason: string, skippedBy: string): void;
+    /** Clear the in_progress record (null out). Used by crash recovery. */
+    clearInProgress(): void;
+    /** Return the status of a single step, or undefined if step not in state. */
+    getStepStatus(step: string): StepStatus | undefined;
+    /**
+     * Initialize a new state.json with all steps in pending status.
+     * Not in the formal interface but needed by T-033 init wizard.
+     */
+    initializeState(options: {
+        enabledSteps: Array<{
+            slug: string;
+            produces: string[];
+        }>;
+        scaffoldVersion: string;
+        methodology: string;
+        initMode: 'greenfield' | 'brownfield' | 'v1-migration';
+    }): void;
+}
+export type { ScaffoldError, InProgressRecord };
+//# sourceMappingURL=state-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/state/state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAChH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAOtD,qBAAa,YAAY;IAIrB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,eAAe;IAJzB,OAAO,CAAC,SAAS,CAAQ;gBAGf,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,MAAM,EAAE;IAK9E,uFAAuF;IACvF,SAAS,IAAI,aAAa;IA6B1B,6DAA6D;IAC7D,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKrC,0EAA0E;IAC1E,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgBhD,uEAAuE;IACvE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAc5F,4DAA4D;IAC5D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAUlE,uEAAuE;IACvE,eAAe,IAAI,IAAI;IAMvB,6EAA6E;IAC7E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAKnD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE;QACvB,YAAY,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;QACzD,eAAe,EAAE,MAAM,CAAA;QACvB,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,YAAY,GAAG,YAAY,GAAG,cAAc,CAAA;KACvD,GAAG,IAAI;CA0BT;AAGD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/state/state-manager.js

@@ -0,0 +1,125 @@
+import { atomicWriteFile, fileExists, ensureDir } from '../utils/fs.js';
+import { stateMissing, stateParseError, stateSchemaVersion, psmAlreadyInProgress } from '../utils/errors.js';
+import fs from 'node:fs';
+import path from 'node:path';
+export class StateManager {
+    projectRoot;
+    computeEligible;
+    statePath;
+    constructor(projectRoot, computeEligible) {
+        this.projectRoot = projectRoot;
+        this.computeEligible = computeEligible;
+        this.statePath = path.join(projectRoot, '.scaffold', 'state.json');
+    }
+    /** Load and validate state.json from disk. Throws ScaffoldError on schema mismatch. */
+    loadState() {
+        if (!fileExists(this.statePath)) {
+            throw stateMissing(this.statePath);
+        }
+        let raw;
+        try {
+            raw = fs.readFileSync(this.statePath, 'utf8');
+        }
+        catch (err) {
+            throw stateParseError(this.statePath, err.message);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            throw stateParseError(this.statePath, err.message);
+        }
+        const schemaVersion = parsed['schema-version'];
+        if (schemaVersion !== 1) {
+            throw stateSchemaVersion(1, schemaVersion, this.statePath);
+        }
+        // ADR-033: forward compatibility — unknown fields produce warnings (not errors) and are preserved
+        // Simply return the full parsed object without stripping extra fields
+        return parsed;
+    }
+    /** Atomically persist state to disk (write tmp + rename). */
+    saveState(state) {
+        state.next_eligible = this.computeEligible(state.steps);
+        atomicWriteFile(this.statePath, JSON.stringify(state, null, 2));
+    }
+    /** Transition step to in_progress; sets in_progress record with actor. */
+    setInProgress(step, actor) {
+        const state = this.loadState();
+        if (state.in_progress !== null) {
+            throw psmAlreadyInProgress(step, state.in_progress.step);
+        }
+        state.steps[step].status = 'in_progress';
+        state.steps[step].at = new Date().toISOString();
+        state.in_progress = {
+            step,
+            started: new Date().toISOString(),
+            partial_artifacts: [],
+            actor,
+        };
+        this.saveState(state);
+    }
+    /** Transition step to completed; records outputs, actor, and depth. */
+    markCompleted(step, outputs, completedBy, depth) {
+        const state = this.loadState();
+        state.steps[step].status = 'completed';
+        state.steps[step].at = new Date().toISOString();
+        state.steps[step].completed_by = completedBy;
+        state.steps[step].depth = depth;
+        if (outputs.length > 0) {
+            state.steps[step].artifacts_verified = true;
+        }
+        state.steps[step].produces = outputs;
+        state.in_progress = null;
+        this.saveState(state);
+    }
+    /** Transition step to skipped; records reason and actor. */
+    markSkipped(step, reason, skippedBy) {
+        const state = this.loadState();
+        state.steps[step].status = 'skipped';
+        state.steps[step].at = new Date().toISOString();
+        state.steps[step].reason = reason;
+        state.steps[step].completed_by = skippedBy;
+        state.in_progress = null;
+        this.saveState(state);
+    }
+    /** Clear the in_progress record (null out). Used by crash recovery. */
+    clearInProgress() {
+        const state = this.loadState();
+        state.in_progress = null;
+        this.saveState(state);
+    }
+    /** Return the status of a single step, or undefined if step not in state. */
+    getStepStatus(step) {
+        const state = this.loadState();
+        return state.steps[step]?.status;
+    }
+    /**
+     * Initialize a new state.json with all steps in pending status.
+     * Not in the formal interface but needed by T-033 init wizard.
+     */
+    initializeState(options) {
+        ensureDir(path.join(this.projectRoot, '.scaffold'));
+        const state = {
+            'schema-version': 1,
+            'scaffold-version': options.scaffoldVersion,
+            init_methodology: options.methodology,
+            config_methodology: options.methodology,
+            'init-mode': options.initMode,
+            created: new Date().toISOString(),
+            in_progress: null,
+            steps: {},
+            next_eligible: [],
+            'extra-steps': [],
+        };
+        for (const step of options.enabledSteps) {
+            state.steps[step.slug] = {
+                status: 'pending',
+                source: 'pipeline',
+                produces: step.produces,
+            };
+        }
+        this.saveState(state);
+    }
+}
+//# sourceMappingURL=state-manager.js.map

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

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

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

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

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

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