ferrycat 0.3.3 → 0.5.0

package/dist/fingerprint.d.ts

@@ -1,9 +1,34 @@
-import type { FileFingerprint, FilePointerInput } from './types.js';
+import { MAX_GIT_PATCH_BYTES } from './schemas.js';
+import type { ArtifactPointer, FileFingerprint, FilePointerInput } from './types.js';
+export { MAX_GIT_PATCH_BYTES };
 export declare class SecurityPolicyError extends Error {
     constructor(message: string);
 }
 export declare function assertSafePointerPath(workspaceRoot: string, rawPath: string): string;
 export declare function computeFullFileSha256(buffer: Buffer): string;
+/**
+ * Validates an optional unified git diff patch payload (FC-202):
+ *  - Non-empty UTF-8 string without binary null bytes
+ *  - Bounded to MAX_GIT_PATCH_BYTES (512KB)
+ *  - Scans diff header paths (diff --git / --- / +++) against workspace escape and sensitive file blacklists
+ *  - Requires at least one valid unified diff header (`NOT_A_UNIFIED_DIFF` if prose/empty)
+ *  - Requires every declared file block to carry at least one `@@` hunk (`EMPTY_PATCH_HUNKS`)
+ *    and at least one `+` / `-` changed content line (`EMPTY_PATCH_CONTENT`), so a header-only
+ *    patch can never stand in for a reviewable diff
+ *  - When `requiredPointers` is provided, requires `touchedPaths` to cover every pointer path (`PATCH_DOES_NOT_COVER_POINTERS`)
+ *  - Computes deterministic SHA-256 hex digest of the patch content
+ *
+ * Known limitation: mode-only changes (`old mode` / `new mode` with no hunk) and text-encoded
+ * binary diffs (`GIT binary patch`) carry no `@@` hunk and are therefore rejected. Self-contained
+ * review is a text-diff feature; use a normal on-disk contract for those cases.
+ */
+export declare function assertSafeGitPatch(gitPatch: string, requiredPointers?: Array<{
+    path: string;
+} | string>): {
+    sha256: string;
+    byteLength: number;
+    touchedPaths: string[];
+};
 export declare function computeFingerprints(workspaceRoot: string, pointers: FilePointerInput[], nowMs?: number): {
     fingerprints: FileFingerprint[];
     recentlyModified: boolean;
@@ -23,9 +48,40 @@ export declare function verifyAllPointers(workspaceRoot: string, fingerprints: F
     firstFailure?: FingerprintVerificationResult;
     dirtyFiles: PointerDriftItem[];
 };
+/**
+ * Verifies pointer files at fulfillment/pre-flight time for mutation tasks
+ * (`implementation` | `test_generation`).
+ *
+ * Unlike read-only review tasks (`code_review` | `architecture_audit`), mutation tasks
+ * are expected to modify pointer files on disk after claiming the contract. Therefore:
+ * - `SECURITY_REJECTED` (workspace escape / sensitive file / symlink escape) and
+ *   `FILE_MISSING` (deleted pointer target) remain hard failures (`valid: false`).
+ * - `SIZE_MISMATCH` and `CONTENT_CHANGED` are permitted; modified files are recorded in
+ *   `dirtyFiles` for audit visibility, and every pointer's post-mutation SHA-256 is
+ *   captured in `verifiedShaMap` so `verified_sha256` records the exact delivered state
+ *   while `pointers` preserves the pre-mutation baseline.
+ */
+export declare function verifyAndSnapshotMutationPointers(workspaceRoot: string, fingerprints: FileFingerprint[], artifacts?: Array<ArtifactPointer | string>): {
+    valid: boolean;
+    firstFailure?: FingerprintVerificationResult;
+    dirtyFiles: PointerDriftItem[];
+    verifiedShaMap: Record<string, string>;
+    noOp: boolean;
+};
+/**
+ * Verifies a COMPLETED mutation contract's on-disk files against its committed
+ * post-mutation `verified_sha256` snapshot (ADR-0006).
+ */
+export declare function verifyCommittedMutationSnapshot(workspaceRoot: string, verifiedShaMap: Record<string, string>): {
+    valid: boolean;
+    firstFailure?: FingerprintVerificationResult;
+    dirtyFiles: PointerDriftItem[];
+};
 export declare function verifySingleRun(workspaceRoot: string, fingerprints: FileFingerprint[]): FingerprintVerificationResult;
 /**
- * Verifies all file fingerprints. If a content/size mismatch is detected on the first read,
- * waits `retryDelayMs` (default 150ms) and re-checks once to rule out transient IDE buffer flushes.
+ * Verifies all file fingerprints asynchronously (FC-203).
+ * If a content/size/existence mismatch is detected on the first read,
+ * yields to the event loop for `retryDelayMs` (default 150ms) without blocking
+ * timers or I/O, then re-checks once to rule out transient IDE buffer flushes.
  */
-export declare function verifyFingerprintsWithRetry(workspaceRoot: string, fingerprints: FileFingerprint[], retryDelayMs?: number): FingerprintVerificationResult;
+export declare function verifyFingerprintsWithRetry(workspaceRoot: string, fingerprints: FileFingerprint[], retryDelayMs?: number): Promise<FingerprintVerificationResult>;

package/dist/fingerprint.js

@@ -1,6 +1,8 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
+import { MAX_GIT_PATCH_BYTES } from './schemas.js';
+export { MAX_GIT_PATCH_BYTES };
 const SENSITIVE_PATTERNS = [
     /(^|[\\/])\.env(\..+)?$/i,
     /\.(pem|key|p12|pfx)$/i,
@@ -59,6 +61,267 @@ export function assertSafePointerPath(workspaceRoot, rawPath) {
 export function computeFullFileSha256(buffer) {
     return crypto.createHash('sha256').update(buffer).digest('hex');
 }
+/**
+ * Sensitive file patterns enforced on diff headers (`diff --git`, `---`, `+++`).
+ * Uses exact sensitive basenames and key/cert extensions rather than broad `secret` / `credentials`
+ * substring matches so legitimate source files (e.g. `src/secretManager.ts`, `docs/credentials-guide.md`)
+ * are not falsely blocked. Note: this checks diff header target paths, not patch body content.
+ */
+const PATCH_HEADER_SENSITIVE_PATTERNS = [
+    /(^|[\\/])\.env(\..+)?$/i,
+    /\.(pem|key|p12|pfx)$/i,
+    /(^|[\\/])id_(rsa|dsa|ecdsa|ed25519)(\.pub)?$/i,
+    /(^|[\\/])(credentials|secrets?)(\.(json|ya?ml|toml|ini|conf|env|txt))?$/i,
+    /(^|[\\/])\.(npmrc|pypirc|netrc)$/i,
+    /(^|[\\/])\.git[\\/]config$/i,
+];
+function unquoteGitPath(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.startsWith('"') && trimmed.endsWith('"') && trimmed.length >= 2) {
+        const inner = trimmed.slice(1, -1);
+        const bytes = [];
+        for (let i = 0; i < inner.length; i++) {
+            if (inner[i] === '\\' && i + 1 < inner.length) {
+                const next = inner[i + 1];
+                if (next >= '0' && next <= '7') {
+                    const octal = inner.slice(i + 1, i + 4).match(/^[0-7]{1,3}/)?.[0] ?? next;
+                    bytes.push(parseInt(octal, 8));
+                    i += octal.length;
+                    continue;
+                }
+                i += 1;
+                if (next === 'n')
+                    bytes.push(0x0a);
+                else if (next === 'r')
+                    bytes.push(0x0d);
+                else if (next === 't')
+                    bytes.push(0x09);
+                else if (next === '\\')
+                    bytes.push(0x5c);
+                else if (next === '"')
+                    bytes.push(0x22);
+                else
+                    bytes.push(...Buffer.from(next, 'utf8'));
+            }
+            else {
+                bytes.push(...Buffer.from(inner[i], 'utf8'));
+            }
+        }
+        return Buffer.from(bytes).toString('utf8');
+    }
+    return trimmed;
+}
+function parseDiffGitHeaderPaths(rest) {
+    const tokens = [];
+    const trimmed = rest.trim();
+    if (!trimmed)
+        return tokens;
+    // Handle C-quoted paths: diff --git "a/my file.ts" "b/my file.ts"
+    if (trimmed.includes('"')) {
+        const re = /"((?:[^"\\]|\\.)*)"|(\S+)/g;
+        let m;
+        while ((m = re.exec(trimmed)) !== null) {
+            tokens.push(unquoteGitPath(m[0]));
+        }
+        return tokens;
+    }
+    // Handle unquoted paths with or without spaces: diff --git a/my file.ts b/my file.ts
+    const bSplitIdx = trimmed.indexOf(' b/');
+    if (bSplitIdx > 0 && trimmed.startsWith('a/')) {
+        tokens.push(trimmed.slice(0, bSplitIdx).trim());
+        tokens.push(trimmed.slice(bSplitIdx + 1).trim());
+        return tokens;
+    }
+    return trimmed.split(/\s+/);
+}
+function normalizeRelPointerPath(rawPath) {
+    return rawPath
+        .trim()
+        .replace(/\\/g, '/')
+        .replace(/^(\.\/)+/, '');
+}
+function assertSafePatchRelPath(rawPath) {
+    const cleaned = unquoteGitPath(rawPath).replace(/\\/g, '/');
+    if (!cleaned || cleaned === '/dev/null' || cleaned === 'dev/null') {
+        return '';
+    }
+    const stripped = cleaned.replace(/^[ab]\//, '').replace(/^(\.\/)+/, '');
+    if (!stripped || stripped === '/dev/null') {
+        return '';
+    }
+    if (stripped.startsWith('/') ||
+        /^[A-Za-z]:/.test(stripped) ||
+        /(^|\/)\.\.(\/|$)/.test(stripped)) {
+        throw new SecurityPolicyError(`Git patch rejected: diff header path "${rawPath}" escapes workspace boundary.`);
+    }
+    for (const pattern of PATCH_HEADER_SENSITIVE_PATTERNS) {
+        if (pattern.test(stripped) || pattern.test(path.basename(stripped))) {
+            throw new SecurityPolicyError(`Git patch rejected by security blacklist: diff header "${rawPath}" matches sensitive file pattern.`);
+        }
+    }
+    return stripped;
+}
+/**
+ * Statefully walks a unified diff and groups its lines into per-file blocks.
+ *
+ * Statefulness is load-bearing: a hunk body line can itself begin with `--- ` / `+++ `
+ * (a removed line whose content starts with `--`, or an added line starting with `++`).
+ * Only outside an open hunk is a `--- ` / `+++ ` line treated as a file header, so payload
+ * lines can no longer be mis-parsed as headers or injected as bogus touched paths.
+ *
+ * Hunk extents are tracked from the `@@ -l,s +l,s @@` counts rather than guessed, which is
+ * what makes the "no hunk / no changed content" gate below reliable.
+ */
+function parseGitPatchBlocks(gitPatch) {
+    const blocks = [];
+    const touched = new Set();
+    let hasDiffHeader = false;
+    let current = null;
+    let oldRemaining = 0;
+    let newRemaining = 0;
+    let inHunk = false;
+    for (const line of gitPatch.split(/\r?\n/)) {
+        if (line.startsWith('diff --git ')) {
+            hasDiffHeader = true;
+            inHunk = false;
+            oldRemaining = 0;
+            newRemaining = 0;
+            const block = { paths: [], hunks: 0, changedLines: 0 };
+            blocks.push(block);
+            current = block;
+            for (const part of parseDiffGitHeaderPaths(line.slice('diff --git '.length).trim())) {
+                const safe = assertSafePatchRelPath(part);
+                if (safe) {
+                    block.paths.push(safe);
+                    touched.add(safe);
+                }
+            }
+            continue;
+        }
+        if (inHunk) {
+            if (line.startsWith('\\'))
+                continue; // ""
+            if (line.startsWith('+')) {
+                if (newRemaining > 0)
+                    newRemaining -= 1;
+                if (current)
+                    current.changedLines += 1;
+            }
+            else if (line.startsWith('-')) {
+                if (oldRemaining > 0)
+                    oldRemaining -= 1;
+                if (current)
+                    current.changedLines += 1;
+            }
+            else {
+                if (oldRemaining > 0)
+                    oldRemaining -= 1;
+                if (newRemaining > 0)
+                    newRemaining -= 1;
+            }
+            if (oldRemaining <= 0 && newRemaining <= 0)
+                inHunk = false;
+            continue;
+        }
+        if (line.startsWith('@@')) {
+            const match = /^@@+ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/.exec(line);
+            if (!match) {
+                throw new Error(`MALFORMED_HUNK_HEADER: cannot parse hunk extent from "${line.slice(0, 60)}" (FC-202).`);
+            }
+            hasDiffHeader = true;
+            if (current === null) {
+                current = { paths: [], hunks: 0, changedLines: 0 };
+                blocks.push(current);
+            }
+            oldRemaining = match[2] === undefined ? 1 : Number(match[2]);
+            newRemaining = match[4] === undefined ? 1 : Number(match[4]);
+            current.hunks += 1;
+            inHunk = oldRemaining > 0 || newRemaining > 0;
+            continue;
+        }
+        if (line.startsWith('--- ') || line.startsWith('+++ ')) {
+            hasDiffHeader = true;
+            // A fresh `--- ` after a completed file block starts a new block (diff without `diff --git`)
+            if (current === null || (line.startsWith('--- ') && current.hunks > 0)) {
+                current = { paths: [], hunks: 0, changedLines: 0 };
+                blocks.push(current);
+            }
+            const afterPrefix = line.slice(4).trim();
+            const rawTarget = afterPrefix.startsWith('"')
+                ? (afterPrefix.match(/^"((?:[^"\\]|\\.)*)"/)?.[0] ?? afterPrefix.split('\t')[0].trim())
+                : afterPrefix.split('\t')[0].trim();
+            const safe = assertSafePatchRelPath(rawTarget);
+            if (safe) {
+                current.paths.push(safe);
+                touched.add(safe);
+            }
+            continue;
+        }
+    }
+    return { blocks, touched, hasDiffHeader };
+}
+/**
+ * Validates an optional unified git diff patch payload (FC-202):
+ *  - Non-empty UTF-8 string without binary null bytes
+ *  - Bounded to MAX_GIT_PATCH_BYTES (512KB)
+ *  - Scans diff header paths (diff --git / --- / +++) against workspace escape and sensitive file blacklists
+ *  - Requires at least one valid unified diff header (`NOT_A_UNIFIED_DIFF` if prose/empty)
+ *  - Requires every declared file block to carry at least one `@@` hunk (`EMPTY_PATCH_HUNKS`)
+ *    and at least one `+` / `-` changed content line (`EMPTY_PATCH_CONTENT`), so a header-only
+ *    patch can never stand in for a reviewable diff
+ *  - When `requiredPointers` is provided, requires `touchedPaths` to cover every pointer path (`PATCH_DOES_NOT_COVER_POINTERS`)
+ *  - Computes deterministic SHA-256 hex digest of the patch content
+ *
+ * Known limitation: mode-only changes (`old mode` / `new mode` with no hunk) and text-encoded
+ * binary diffs (`GIT binary patch`) carry no `@@` hunk and are therefore rejected. Self-contained
+ * review is a text-diff feature; use a normal on-disk contract for those cases.
+ */
+export function assertSafeGitPatch(gitPatch, requiredPointers) {
+    if (typeof gitPatch !== 'string' || gitPatch.trim().length === 0) {
+        throw new Error('git_patch must be a non-empty string when provided (FC-202).');
+    }
+    if (gitPatch.includes('\0')) {
+        throw new SecurityPolicyError('Git patch rejected: payload contains binary null bytes.');
+    }
+    const buf = Buffer.from(gitPatch, 'utf8');
+    if (buf.byteLength > MAX_GIT_PATCH_BYTES) {
+        throw new Error(`git_patch size (${buf.byteLength} bytes) exceeds maximum allowed limit of ${MAX_GIT_PATCH_BYTES} bytes (512KB) (FC-202).`);
+    }
+    const { blocks, touched, hasDiffHeader } = parseGitPatchBlocks(gitPatch);
+    if (!hasDiffHeader || touched.size === 0) {
+        throw new Error('NOT_A_UNIFIED_DIFF: git_patch must be a valid unified diff containing at least one file diff header (diff --git / --- / +++) (FC-202).');
+    }
+    // R1: a header-only patch names files without carrying any diff content. Reject it so
+    // `SELF_CONTAINED` can never be unlocked by a patch the reviewer cannot actually read.
+    const headerOnly = Array.from(new Set(blocks.filter((b) => b.paths.length > 0 && b.hunks === 0).flatMap((b) => b.paths)));
+    if (headerOnly.length > 0) {
+        throw new Error(`EMPTY_PATCH_HUNKS: git_patch file block(s) [${headerOnly.join(', ')}] declare a diff header but carry no "@@ ... @@" hunk; a header-only patch is not reviewable (FC-202).`);
+    }
+    const contentless = Array.from(new Set(blocks
+        .filter((b) => b.paths.length > 0 && b.hunks > 0 && b.changedLines === 0)
+        .flatMap((b) => b.paths)));
+    if (contentless.length > 0) {
+        throw new Error(`EMPTY_PATCH_CONTENT: git_patch file block(s) [${contentless.join(', ')}] contain hunk headers but no "+" / "-" changed content line; a context-only hunk carries no reviewable change (FC-202).`);
+    }
+    if (requiredPointers && requiredPointers.length > 0) {
+        const missingPointers = [];
+        for (const ptr of requiredPointers) {
+            const rawPtr = typeof ptr === 'string' ? ptr : ptr.path;
+            const normPtr = normalizeRelPointerPath(rawPtr);
+            if (normPtr && !touched.has(normPtr)) {
+                missingPointers.push(normPtr);
+            }
+        }
+        if (missingPointers.length > 0) {
+            throw new Error(`PATCH_DOES_NOT_COVER_POINTERS: git_patch touched [${Array.from(touched).join(', ')}] does not cover pointer file(s) [${missingPointers.join(', ')}] (FC-202).`);
+        }
+    }
+    return {
+        sha256: computeFullFileSha256(buf),
+        byteLength: buf.byteLength,
+        touchedPaths: Array.from(touched),
+    };
+}
 function extractFirstAndLastLine(content, maxLen = 48) {
     const lines = content.split(/\r?\n/);
     const nonEmpty = lines.filter((l) => l.trim().length > 0);
@@ -139,6 +402,172 @@ export function verifyAllPointers(workspaceRoot, fingerprints) {
     }
     return { valid: true, dirtyFiles: [] };
 }
+/**
+ * Verifies pointer files at fulfillment/pre-flight time for mutation tasks
+ * (`implementation` | `test_generation`).
+ *
+ * Unlike read-only review tasks (`code_review` | `architecture_audit`), mutation tasks
+ * are expected to modify pointer files on disk after claiming the contract. Therefore:
+ * - `SECURITY_REJECTED` (workspace escape / sensitive file / symlink escape) and
+ *   `FILE_MISSING` (deleted pointer target) remain hard failures (`valid: false`).
+ * - `SIZE_MISMATCH` and `CONTENT_CHANGED` are permitted; modified files are recorded in
+ *   `dirtyFiles` for audit visibility, and every pointer's post-mutation SHA-256 is
+ *   captured in `verifiedShaMap` so `verified_sha256` records the exact delivered state
+ *   while `pointers` preserves the pre-mutation baseline.
+ */
+export function verifyAndSnapshotMutationPointers(workspaceRoot, fingerprints, artifacts) {
+    const dirtyFiles = [];
+    const blockingFailures = [];
+    const verifiedShaMap = {};
+    let addedArtifactCount = 0;
+    for (const fp of fingerprints) {
+        let absPath;
+        try {
+            absPath = assertSafePointerPath(workspaceRoot, fp.path);
+        }
+        catch (err) {
+            const item = {
+                path: fp.path,
+                reason: 'SECURITY_REJECTED',
+                detail: err instanceof Error ? err.message : String(err),
+            };
+            dirtyFiles.push(item);
+            blockingFailures.push(item);
+            continue;
+        }
+        if (!fs.existsSync(absPath) || !fs.statSync(absPath).isFile()) {
+            const item = {
+                path: fp.path,
+                reason: 'FILE_MISSING',
+                detail: `File missing on worker disk: "${fp.path}"`,
+            };
+            dirtyFiles.push(item);
+            blockingFailures.push(item);
+            continue;
+        }
+        const stat = fs.statSync(absPath);
+        const buffer = fs.readFileSync(absPath);
+        const currentSha256 = computeFullFileSha256(buffer);
+        verifiedShaMap[fp.path] = currentSha256;
+        if (stat.size !== fp.size) {
+            dirtyFiles.push({
+                path: fp.path,
+                reason: 'SIZE_MISMATCH',
+                detail: `File size changed for "${fp.path}": baseline ${fp.size} bytes -> post-mutation ${stat.size} bytes`,
+            });
+        }
+        else if (currentSha256 !== fp.sha256) {
+            dirtyFiles.push({
+                path: fp.path,
+                reason: 'CONTENT_CHANGED',
+                detail: `File content SHA-256 updated for "${fp.path}": baseline ${fp.sha256.slice(0, 16)}... -> post-mutation ${currentSha256.slice(0, 16)}...`,
+            });
+        }
+    }
+    if (artifacts && artifacts.length > 0) {
+        for (const entry of artifacts) {
+            const rawArtifact = typeof entry === 'string' ? entry : entry.path;
+            if (!rawArtifact || verifiedShaMap[rawArtifact])
+                continue;
+            let absArtifact;
+            try {
+                absArtifact = assertSafePointerPath(workspaceRoot, rawArtifact);
+            }
+            catch (err) {
+                const item = {
+                    path: rawArtifact,
+                    reason: 'SECURITY_REJECTED',
+                    detail: err instanceof Error ? err.message : String(err),
+                };
+                dirtyFiles.push(item);
+                blockingFailures.push(item);
+                continue;
+            }
+            if (!fs.existsSync(absArtifact) || !fs.statSync(absArtifact).isFile()) {
+                const item = {
+                    path: rawArtifact,
+                    reason: 'FILE_MISSING',
+                    detail: `Declared artifact file missing on worker disk: "${rawArtifact}"`,
+                };
+                dirtyFiles.push(item);
+                blockingFailures.push(item);
+                continue;
+            }
+            const buffer = fs.readFileSync(absArtifact);
+            verifiedShaMap[rawArtifact] = computeFullFileSha256(buffer);
+            addedArtifactCount++;
+        }
+    }
+    if (blockingFailures.length > 0) {
+        return {
+            valid: false,
+            firstFailure: {
+                valid: false,
+                reason: blockingFailures[0].reason,
+                detail: blockingFailures[0].detail,
+            },
+            dirtyFiles,
+            verifiedShaMap: {},
+            noOp: false,
+        };
+    }
+    return {
+        valid: true,
+        dirtyFiles,
+        verifiedShaMap,
+        noOp: dirtyFiles.length === 0 && addedArtifactCount === 0,
+    };
+}
+/**
+ * Verifies a COMPLETED mutation contract's on-disk files against its committed
+ * post-mutation `verified_sha256` snapshot (ADR-0006).
+ */
+export function verifyCommittedMutationSnapshot(workspaceRoot, verifiedShaMap) {
+    const dirtyFiles = [];
+    for (const [rawPath, committedSha] of Object.entries(verifiedShaMap)) {
+        let absPath;
+        try {
+            absPath = assertSafePointerPath(workspaceRoot, rawPath);
+        }
+        catch (err) {
+            dirtyFiles.push({
+                path: rawPath,
+                reason: 'SECURITY_REJECTED',
+                detail: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        if (!fs.existsSync(absPath) || !fs.statSync(absPath).isFile()) {
+            dirtyFiles.push({
+                path: rawPath,
+                reason: 'FILE_MISSING',
+                detail: `Delivered file missing on disk: "${rawPath}"`,
+            });
+            continue;
+        }
+        const buffer = fs.readFileSync(absPath);
+        const currentSha256 = computeFullFileSha256(buffer);
+        if (currentSha256 !== committedSha) {
+            dirtyFiles.push({
+                path: rawPath,
+                reason: 'CONTENT_CHANGED',
+                detail: `Post-completion SHA-256 mismatch for "${rawPath}": expected committed ${committedSha.slice(0, 16)}..., got ${currentSha256.slice(0, 16)}...`,
+            });
+        }
+    }
+    if (dirtyFiles.length > 0) {
+        return {
+            valid: false,
+            firstFailure: {
+                valid: false,
+                reason: dirtyFiles[0].reason,
+                detail: dirtyFiles[0].detail,
+            },
+            dirtyFiles,
+        };
+    }
+    return { valid: true, dirtyFiles: [] };
+}
 export function verifySingleRun(workspaceRoot, fingerprints) {
     for (const fp of fingerprints) {
         let absPath;
@@ -183,23 +612,23 @@ export function verifySingleRun(workspaceRoot, fingerprints) {
     }
     return { valid: true };
 }
-function sleepSync(ms) {
+function sleepAsync(ms) {
     if (ms <= 0)
-        return;
-    const sab = new SharedArrayBuffer(4);
-    const int32 = new Int32Array(sab);
-    Atomics.wait(int32, 0, 0, ms);
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
 }
 /**
- * Verifies all file fingerprints. If a content/size mismatch is detected on the first read,
- * waits `retryDelayMs` (default 150ms) and re-checks once to rule out transient IDE buffer flushes.
+ * Verifies all file fingerprints asynchronously (FC-203).
+ * If a content/size/existence mismatch is detected on the first read,
+ * yields to the event loop for `retryDelayMs` (default 150ms) without blocking
+ * timers or I/O, then re-checks once to rule out transient IDE buffer flushes.
  */
-export function verifyFingerprintsWithRetry(workspaceRoot, fingerprints, retryDelayMs = 150) {
+export async function verifyFingerprintsWithRetry(workspaceRoot, fingerprints, retryDelayMs = 150) {
     const firstCheck = verifySingleRun(workspaceRoot, fingerprints);
     if (firstCheck.valid || firstCheck.reason === 'SECURITY_REJECTED') {
         return firstCheck;
     }
-    sleepSync(retryDelayMs);
+    await sleepAsync(retryDelayMs);
     return verifySingleRun(workspaceRoot, fingerprints);
 }
 //# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

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

package/dist/index.js

@@ -9,7 +9,7 @@ function loadPackageVersion() {
     try {
         const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
         const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-        return pkg.version ?? '0.3.3';
+        return pkg.version ?? '0.5.0';
     }
     catch {
         return '0.3.2';
@@ -45,8 +45,11 @@ Exposed MCP Tools (8):
   fail_contract                   Mark CLAIMED contract as terminal FAILED with reason
   inspect_mesh_state              Read-only query of contracts by status, ID, or target_agent
 
-For CLI command usage (dispatch/poll/fulfill/verify/release/extend/fail/inspect/worker), run:
-  ferrycat-cli --help`);
+CLI Subcommands (same binary: \`npx ferrycat <command>\`):
+  demo                            Zero-config sandbox walkthrough of the full lifecycle (no MCP setup)
+  init                            Detect installed MCP hosts and add FerryCat to their configs
+  dispatch | poll | verify | fulfill | release | extend | fail | inspect | worker | daemon
+  Run \`ferrycat-cli --help\` (after a global install) for the full CLI reference.`);
     process.exit(0);
 }
 const engine = new FerryCatEngine();
@@ -112,7 +115,7 @@ Retrieves and claims next available contract work for the current agent, transit
 - When work is claimed: { ok: true, has_task: true, status: 'CLAIMED', contract: { contract_id, requester_agent, target_agent, task_type, title, context_summary, workspace_root, pointers, contract_schema, claimed_at, exec_ttl_sec } }.
 - When queue is empty: { ok: true, has_task: false, message: 'No pending contracts for agent "<agent_id>"' }.`, PollNextTaskShape, async (args) => {
     try {
-        const result = engine.pollNextTask(args);
+        const result = await engine.pollNextTask(args);
         return {
             content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
         };