@matteeh/osq 0.1.0 → 0.2.0

package/dist/watcher/outcome.d.ts

@@ -0,0 +1,32 @@
+import { type Logger } from '../core/foundation/logger.js';
+import { type HarnessEvent, type RegressedEventData } from '../harness/types.js';
+import type { RunTaskFailureReason } from './failure-reason.js';
+export type { RunTaskFailureReason } from './failure-reason.js';
+export interface RunTaskResult {
+    success: boolean;
+    reason?: RunTaskFailureReason;
+    error?: string;
+}
+/** Tick `taskNumber`'s checkbox, supporting flat and grouped (`## <n>.`) numbering. Pure. */
+export declare function tickTaskCheckboxContent(content: string, taskNumber: string): string;
+export declare function tickTaskCheckbox(specFolderPath: string, taskNumber: string): Promise<void>;
+export declare function recordLifecycleEvent(specFolderPath: string, taskNumber: string, event: HarnessEvent, summary: string, logger?: Logger, level?: 'info' | 'verbose'): Promise<void>;
+export declare function recordDeadEvent(specFolderPath: string, taskNumber: string, reason: RunTaskFailureReason): Promise<void>;
+export declare function recordRegressedEvent(specFolderPath: string, target: string, data: RegressedEventData): Promise<void>;
+export declare function recordDoneEvent(specFolderPath: string, taskNumber: string): Promise<void>;
+export declare function formatReapedMarker(reason: 'crashed' | 'timeout', pid: number, startedAt: number, reapedAt?: number): string;
+export declare function writeDeadMarker(runDir: string, taskNumber: string, content: string, projectRoot?: string): Promise<void>;
+/** Write the `.run/regressed/<target>.md` marker, creating the directory when needed. */
+export declare function writeRegressedMarker(runDir: string, target: string, content: string): Promise<void>;
+export interface DoneMarkerMetadata {
+    scopeHash: string;
+    buildStamp: string;
+    exitCode: number;
+    fileHashes?: Record<string, string | null>;
+    /** Recorded deterministic resolver version; defaults to the current version. */
+    scopeResolver?: number;
+}
+export declare function writeDoneMarker(runDir: string, taskNumber: string, metadata?: DoneMarkerMetadata): Promise<void>;
+/** Task-outcome line: verified, dead, or regressed with reason and elapsed seconds. */
+export declare function formatTaskOutcomeLine(taskNumber: string, success: boolean, reason: RunTaskFailureReason | undefined, elapsedSeconds: number, symbols: boolean, extra?: string): string;
+//# sourceMappingURL=outcome.d.ts.map

package/dist/watcher/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/watcher/outcome.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,8BAA8B,CAAC;AAE1E,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA8BnF;AACD,wBAAsB,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhG;AACD,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,GAAG,SAAkB,GACjC,OAAO,CAAC,IAAI,CAAC,CAOf;AACD,wBAAsB,eAAe,CACnC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAMf;AACD,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAMf;AACD,wBAAsB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/F;AACD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAmB,GAC5B,MAAM,CAWR;AAWD,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;AACD,yFAAyF;AACzF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf;AACD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AACD,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAQf;AACD,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CASR"}

package/dist/watcher/outcome.js

@@ -0,0 +1,127 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveSymbol } from '../core/foundation/logger.js';
+import { SCOPE_RESOLVER_VERSION } from '../core/run/scope.js';
+import { appendHarnessEvent, } from '../harness/types.js';
+import { addFingerprint } from './fingerprint.js';
+/** Tick `taskNumber`'s checkbox, supporting flat and grouped (`## <n>.`) numbering. Pure. */
+export function tickTaskCheckboxContent(content, taskNumber) {
+    const target = Number.parseInt(taskNumber, 10);
+    if (Number.isNaN(target)) {
+        return content;
+    }
+    const lines = content.split('\n');
+    let sectionNumber = null;
+    let changed = false;
+    const updated = lines.map((line) => {
+        // Any `## ` heading resets the section scope; only a numeric heading
+        // associates unnumbered items with a task.
+        const headingMatch = line.match(/^##\s+(\S.*?)\s*$/);
+        if (headingMatch) {
+            const numeric = headingMatch[1].match(/^(\d+)[.)]?(?:\s|$)/);
+            sectionNumber = numeric ? Number.parseInt(numeric[1], 10) : null;
+            return line;
+        }
+        const itemMatch = line.match(/^(\s*-\s+\[)([ xX])(\]\s*)((?:(\d+)[.)]\s+)?)(.*)$/);
+        if (!itemMatch) {
+            return line;
+        }
+        const [, prefix, mark, close, numberedPrefix, itemNumber, rest] = itemMatch;
+        const identifier = itemNumber ? Number.parseInt(itemNumber, 10) : sectionNumber;
+        if (identifier !== target || mark.toLowerCase() === 'x') {
+            return line;
+        }
+        changed = true;
+        return `${prefix}x${close}${numberedPrefix}${rest}`;
+    });
+    return changed ? updated.join('\n') : content;
+}
+export async function tickTaskCheckbox(specFolderPath, taskNumber) {
+    const tasksMdPath = path.join(specFolderPath, 'tasks.md');
+    let content = '';
+    try {
+        content = await fs.readFile(tasksMdPath, 'utf8');
+    }
+    catch {
+        return;
+    }
+    const updated = tickTaskCheckboxContent(content, taskNumber);
+    if (updated !== content) {
+        await fs.writeFile(tasksMdPath, updated, 'utf8');
+    }
+}
+export async function recordLifecycleEvent(specFolderPath, taskNumber, event, summary, logger, level = 'info') {
+    await appendHarnessEvent(specFolderPath, taskNumber, event);
+    if (level === 'verbose') {
+        logger?.verbose(summary);
+    }
+    else {
+        logger?.info(summary);
+    }
+}
+export async function recordDeadEvent(specFolderPath, taskNumber, reason) {
+    await appendHarnessEvent(specFolderPath, taskNumber, {
+        type: 'dead',
+        timestamp: new Date().toISOString(),
+        data: { task: taskNumber, reason },
+    });
+}
+export async function recordRegressedEvent(specFolderPath, target, data) {
+    await appendHarnessEvent(specFolderPath, target, {
+        type: 'regressed',
+        timestamp: new Date().toISOString(),
+        data: { task: target, ...data },
+    });
+}
+export async function recordDoneEvent(specFolderPath, taskNumber) {
+    await appendHarnessEvent(specFolderPath, taskNumber, {
+        type: 'done',
+        timestamp: new Date().toISOString(),
+        data: { task: taskNumber },
+    });
+}
+export function formatReapedMarker(reason, pid, startedAt, reapedAt = Date.now()) {
+    return [
+        '---',
+        `reason: ${reason}`,
+        `pid: ${pid}`,
+        `started_at: ${new Date(startedAt).toISOString()}`,
+        `reaped_at: ${new Date(reapedAt).toISOString()}`,
+        '---',
+        `Task execution terminated by watcher reaper (${reason}).`,
+        '',
+    ].join('\n');
+}
+async function writeMarkerFile(runDir, kind, name, content) {
+    const dir = path.join(runDir, kind);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(path.join(dir, name), content, 'utf8');
+}
+export async function writeDeadMarker(runDir, taskNumber, content, projectRoot) {
+    await writeMarkerFile(runDir, 'dead', `${taskNumber}.md`, addFingerprint(content, projectRoot));
+}
+/** Write the `.run/regressed/<target>.md` marker, creating the directory when needed. */
+export async function writeRegressedMarker(runDir, target, content) {
+    await writeMarkerFile(runDir, 'regressed', `${target}.md`, content);
+}
+export async function writeDoneMarker(runDir, taskNumber, metadata) {
+    const doneDir = path.join(runDir, 'done');
+    await fs.mkdir(doneDir, { recursive: true });
+    const stamp = `${new Date().toISOString()}\n`;
+    const frontmatter = metadata
+        ? `---\nscope_resolver: ${metadata.scopeResolver ?? SCOPE_RESOLVER_VERSION}\nscope_hash: "${metadata.scopeHash}"\nbuild_stamp: "${metadata.buildStamp}"\nexit_code: ${metadata.exitCode}\nscope_files: ${JSON.stringify(metadata.fileHashes ?? {})}\n---\n`
+        : '';
+    await fs.writeFile(path.join(doneDir, taskNumber), `${frontmatter}${stamp}`, 'utf8');
+}
+/** Task-outcome line: verified, dead, or regressed with reason and elapsed seconds. */
+export function formatTaskOutcomeLine(taskNumber, success, reason, elapsedSeconds, symbols, extra) {
+    if (success) {
+        return `${resolveSymbol('✓', '[ok]', symbols)} task ${taskNumber} verified (elapsed: ${elapsedSeconds}s)`;
+    }
+    const detail = extra ? `, ${extra}` : '';
+    if (reason === 'regressed') {
+        return `${resolveSymbol('?', '[regressed]', symbols)} task ${taskNumber} regressed (reason: ${reason}${detail}, elapsed: ${elapsedSeconds}s)`;
+    }
+    return `${resolveSymbol('✗', '[dead]', symbols)} task ${taskNumber} dead (reason: ${reason}${detail}, elapsed: ${elapsedSeconds}s)`;
+}
+//# sourceMappingURL=outcome.js.map

package/dist/watcher/outcome.js.map

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

package/dist/watcher/regression.d.ts

@@ -0,0 +1,43 @@
+import type { OsqConfig } from '../core/foundation/config.js';
+import { type StaleTaskAudit } from '../core/run/scope-hash.js';
+import { type DoneMarkerMetadata, type RunTaskResult } from './outcome.js';
+export { computeTaskScopeHash } from '../core/run/scope-hash.js';
+export type { ScopeHashResult } from '../core/run/scope-hash.js';
+/** Outcome of comparing a previously completed task's scope to the tree. */
+export interface ScopeRegressionResult {
+    regressed: true;
+    taskNumber: string;
+    differingPaths: string[];
+    recordedHash: string;
+    currentHash: string;
+}
+export interface ScopeAuditOptions {
+    projectRoot: string;
+    specFolderPath: string;
+    eligibleTaskNumbers: readonly string[];
+    verifyTimeoutSeconds: number;
+    /** When false, detect and attribute only; never verify or write artifacts. */
+    record?: boolean;
+}
+export interface ScopeAuditResult {
+    stale: StaleTaskAudit[];
+}
+/**
+ * Pre-lock scope recertification audit. Compares every eligible automated done
+ * marker's recorded resolver-aware scope hash and version against the current
+ * tree in one pass, verifies each stale task under the configured timeout, and
+ * records one regression marker and typed event per stale task. Already-active
+ * regressions are reported without re-verification or duplicate writes.
+ */
+export declare function auditScopeRegressions(options: ScopeAuditOptions): Promise<ScopeAuditResult>;
+/** Legacy first-match detection export: detection only, never writes artifacts. */
+export declare function checkDoneTasksScopeHashes(projectRoot: string, specFolderPath: string, currentTaskNumber: string): Promise<ScopeRegressionResult | null>;
+/** Resolve the metadata written to the done marker after a passing task. */
+export declare function buildDoneMetadata(projectRoot: string, scope: string[]): Promise<DoneMarkerMetadata>;
+/**
+ * Defensive pre-spawn guard for direct `runTask` callers: record and report
+ * every stale earlier task without spawning. The watcher cycle audits before
+ * `runTask`; this keeps direct calls safe.
+ */
+export declare function guardScopeRegression(projectRoot: string, specFolderPath: string, currentTaskNumber: string, config: OsqConfig): Promise<RunTaskResult | null>;
+//# sourceMappingURL=regression.d.ts.map

package/dist/watcher/regression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression.d.ts","sourceRoot":"","sources":["../../src/watcher/regression.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAEL,KAAK,cAAc,EASpB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAGnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsGjG;AAQD,mFAAmF;AACnF,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAqBvC;AAED,4EAA4E;AAC5E,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,kBAAkB,CAAC,CAY7B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAkB/B"}

package/dist/watcher/regression.js

@@ -0,0 +1,175 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { SCOPE_RESOLVER_VERSION, attributeScopePaths, buildScopeRegressionMarker, computeTaskScopeHash, findDifferingPaths, listCanonicalDoneNumbers, parseActiveStaleTask, readDoneMarker, readFileChangedPaths, } from '../core/run/scope-hash.js';
+import { parseTaskMd } from '../core/spec/parser.js';
+import { compareNumericPrefix } from '../core/status/state.js';
+import { resolveBuildInfo } from './build.js';
+import { recordRegressedEvent, writeRegressedMarker, } from './outcome.js';
+import { runVerificationGateResult } from './verify.js';
+export { computeTaskScopeHash } from '../core/run/scope-hash.js';
+/**
+ * Pre-lock scope recertification audit. Compares every eligible automated done
+ * marker's recorded resolver-aware scope hash and version against the current
+ * tree in one pass, verifies each stale task under the configured timeout, and
+ * records one regression marker and typed event per stale task. Already-active
+ * regressions are reported without re-verification or duplicate writes.
+ */
+export async function auditScopeRegressions(options) {
+    const { projectRoot, specFolderPath, eligibleTaskNumbers, verifyTimeoutSeconds } = options;
+    const record = options.record ?? true;
+    const runDir = path.join(specFolderPath, '.run');
+    const doneInfo = new Map();
+    const changesByPath = new Map();
+    const completionHashes = new Map();
+    for (const number of await listCanonicalDoneNumbers(runDir)) {
+        const info = await readDoneMarker(runDir, number);
+        if (!info)
+            continue;
+        doneInfo.set(number, info);
+        completionHashes.set(number, info.scopeFiles);
+        for (const filePath of await readFileChangedPaths(specFolderPath, number)) {
+            const tasks = changesByPath.get(filePath) ?? new Set();
+            tasks.add(number);
+            changesByPath.set(filePath, tasks);
+        }
+    }
+    const stale = [];
+    for (const taskNumber of [...new Set(eligibleTaskNumbers)].sort(compareNumericPrefix)) {
+        const recorded = doneInfo.get(taskNumber);
+        if (!recorded)
+            continue;
+        const taskContent = await fs
+            .readFile(path.join(specFolderPath, 'tasks', `${taskNumber}.md`), 'utf8')
+            .catch(() => null);
+        if (taskContent === null)
+            continue;
+        const taskData = parseTaskMd(taskContent);
+        const current = await computeTaskScopeHash(projectRoot, taskData.scope);
+        if (current.hash === recorded.scopeHash && recorded.scopeResolver === SCOPE_RESOLVER_VERSION) {
+            continue;
+        }
+        // A matching aggregate hash is a version-only upgrade: report no differing
+        // path from the legacy per-file projection rather than inventing one.
+        const differing = current.hash === recorded.scopeHash
+            ? []
+            : findDifferingPaths(recorded.scopeFiles, current.fileHashes);
+        const base = {
+            differingPaths: differing.map((entry) => entry.display),
+            attribution: attributeScopePaths(taskNumber, differing, current.fileHashes, changesByPath, completionHashes),
+            recordedHash: recorded.scopeHash,
+            currentHash: current.hash,
+        };
+        const active = await fs
+            .readFile(path.join(runDir, 'regressed', `${taskNumber}.md`), 'utf8')
+            .catch(() => null);
+        if (active !== null) {
+            stale.push(parseActiveStaleTask(taskNumber, active, base));
+            continue;
+        }
+        const gate = record
+            ? await runVerificationGateResult(projectRoot, taskData.verify, verifyTimeoutSeconds, {
+                specFolderPath,
+                taskNumber,
+            })
+            : null;
+        const audit = {
+            taskNumber,
+            ...base,
+            verifyCommand: taskData.verify,
+            exitCode: gate?.exitCode ?? 1,
+            duration: gate?.duration ?? 0,
+            output: gate?.output ?? '',
+            timedOut: gate?.timedOut ?? false,
+            verificationPassed: gate?.passed ?? false,
+            alreadyActive: false,
+        };
+        if (gate) {
+            const marker = buildScopeRegressionMarker(audit).replace('\n---\n', `\nrecorded_resolver: ${JSON.stringify(recorded.scopeResolver)}\ncurrent_resolver: ${SCOPE_RESOLVER_VERSION}\n---\n`);
+            await writeRegressedMarker(runDir, taskNumber, marker);
+            await recordRegressedEvent(specFolderPath, taskNumber, {
+                reason: 'scope_regression',
+                differingPaths: audit.differingPaths,
+                attribution: audit.attribution,
+                recordedHash: audit.recordedHash,
+                currentHash: audit.currentHash,
+                command: audit.verifyCommand,
+                exitCode: audit.exitCode,
+                duration: audit.duration,
+                output: audit.output,
+                timedOut: audit.timedOut,
+                verificationPassed: audit.verificationPassed,
+                recordedResolver: recorded.scopeResolver,
+                currentResolver: SCOPE_RESOLVER_VERSION,
+            });
+        }
+        stale.push(audit);
+    }
+    return { stale };
+}
+async function eligibleEarlierTasks(runDir, currentTask) {
+    return (await listCanonicalDoneNumbers(runDir)).filter((number) => Number.parseInt(number, 10) < currentTask);
+}
+/** Legacy first-match detection export: detection only, never writes artifacts. */
+export async function checkDoneTasksScopeHashes(projectRoot, specFolderPath, currentTaskNumber) {
+    const currentTask = Number.parseInt(currentTaskNumber, 10);
+    if (Number.isNaN(currentTask))
+        return null;
+    const eligible = await eligibleEarlierTasks(path.join(specFolderPath, '.run'), currentTask);
+    const audit = await auditScopeRegressions({
+        projectRoot,
+        specFolderPath,
+        eligibleTaskNumbers: eligible,
+        verifyTimeoutSeconds: 0,
+        record: false,
+    });
+    const first = audit.stale[0];
+    return first
+        ? {
+            regressed: true,
+            taskNumber: first.taskNumber,
+            differingPaths: first.differingPaths,
+            recordedHash: first.recordedHash,
+            currentHash: first.currentHash,
+        }
+        : null;
+}
+/** Resolve the metadata written to the done marker after a passing task. */
+export async function buildDoneMetadata(projectRoot, scope) {
+    const [scopeHash, buildInfo] = await Promise.all([
+        computeTaskScopeHash(projectRoot, scope),
+        resolveBuildInfo(projectRoot),
+    ]);
+    return {
+        scopeHash: scopeHash.hash,
+        buildStamp: buildInfo.commit,
+        exitCode: 0,
+        fileHashes: scopeHash.fileHashes,
+        scopeResolver: SCOPE_RESOLVER_VERSION,
+    };
+}
+/**
+ * Defensive pre-spawn guard for direct `runTask` callers: record and report
+ * every stale earlier task without spawning. The watcher cycle audits before
+ * `runTask`; this keeps direct calls safe.
+ */
+export async function guardScopeRegression(projectRoot, specFolderPath, currentTaskNumber, config) {
+    const currentTask = Number.parseInt(currentTaskNumber, 10);
+    if (Number.isNaN(currentTask))
+        return null;
+    const eligible = await eligibleEarlierTasks(path.join(specFolderPath, '.run'), currentTask);
+    const audit = await auditScopeRegressions({
+        projectRoot,
+        specFolderPath,
+        eligibleTaskNumbers: eligible,
+        verifyTimeoutSeconds: config.timeouts.verifyTimeoutSeconds ?? 600,
+    });
+    const first = audit.stale[0];
+    return first
+        ? {
+            success: false,
+            reason: 'regressed',
+            error: `Scope of task ${first.taskNumber} changed: ${first.differingPaths.join(', ')}`,
+        }
+        : null;
+}
+//# sourceMappingURL=regression.js.map

package/dist/watcher/regression.js.map

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

package/dist/watcher/runner.d.ts

@@ -1,70 +1,8 @@
-import type { OsqConfig } from '../core/config.js';
-import { type Logger } from '../core/logger.js';
-import { type HarnessAdapter } from '../harness/types.js';
-export type RunTaskFailureReason = 'spec_conflict' | 'already_running' | 'no_result' | 'verify_red' | 'crashed' | 'timeout';
-export interface RunTaskResult {
-    success: boolean;
-    reason?: RunTaskFailureReason;
-    error?: string;
-}
-/**
- * Single-line, human-readable summary of a task outcome. Kept pure so the exact
- * shape can be tested without running the runner, and used directly beside every
- * marker write (`done/<n>` or `dead/<n>.md`) so the log and the marker agree.
- */
-export declare function formatTaskOutcomeSummary(taskNumber: string, success: boolean, reason?: RunTaskFailureReason, extra?: string): string;
-export declare function tickTaskCheckbox(specFolderPath: string, taskNumber: string): Promise<void>;
-export interface TaskHeartbeatStats {
-    elapsedSeconds: number;
-    eventCount: number;
-    totalTokens: number;
-    toolCount: number;
-    cost?: number;
-    lastToolSummary?: string;
-}
-/**
- * Snapshot of task progress. Counters are maintained in memory and advanced
- * with only the bytes appended since the previous poll; the event file may not
- * exist yet, in which case counters are zero.
- */
-export declare function computeTaskHeartbeatStats(specFolderPath: string, taskNumber: string, startTime: number): Promise<TaskHeartbeatStats>;
-/**
- * Drop the in-memory counters for a finished task so the map does not grow
- * across watcher cycles.
- */
-export declare function clearTaskHeartbeatStats(specFolderPath: string, taskNumber: string): void;
-/**
- * Single-line running status row. The logger owns the animated spinner and
- * prepends `<frame> `, so this text is truncated to leave room for that prefix
- * while fitting `terminalWidth` columns.
- */
-export declare function formatTaskStatusRow(taskNumber: string, stats: TaskHeartbeatStats, terminalWidth?: number): string;
-/** Periodic heartbeat line shared by the 1s TTY row and the non-TTY log. */
-export declare function formatTaskHeartbeatLine(taskNumber: string, stats: TaskHeartbeatStats): string;
-/**
- * Curated task-started line: a single info line carrying the task title
- * truncated so the whole line fits the terminal width. The lifecycle details
- * (pid, timeout) travel with it so the marker and the log line stay in sync.
- */
-export declare function formatTaskStartedLine(taskNumber: string, title: string, pid: number | undefined, timeoutSeconds: number, symbols: boolean, terminalWidth?: number): string;
-/**
- * Curated task-outcome line: verified or dead with the failure reason and the
- * elapsed seconds since the task began.
- */
-export declare function formatTaskOutcomeLine(taskNumber: string, success: boolean, reason: RunTaskFailureReason | undefined, elapsedSeconds: number, symbols: boolean): string;
-/**
- * Return the last text message emitted on the agent's event stream, or null
- * when the stream has no text at all. Synthesis reads exclusively from
- * first-class `text` events carrying the completed assistant message; raw
- * harness payload shapes are never inspected. The stream is the append-only
- * `.run/events/<n>.jsonl` file, so this survives a watcher restart.
- */
-export declare function extractFinalTextFromStream(specFolderPath: string, taskNumber: string): Promise<string | null>;
-/**
- * Write a result file synthesized from the agent's final stream message. The
- * frontmatter flags it as `synthesized: true` and a comment attributes it to
- * the watcher so a reader never mistakes it for an agent-authored result.
- */
-export declare function synthesizeResultFile(resultsDir: string, taskNumber: string, finalText: string): Promise<string>;
+import type { OsqConfig } from '../core/foundation/config.js';
+import type { Logger } from '../core/foundation/logger.js';
+import type { HarnessAdapter } from '../harness/types.js';
+import { type RunTaskResult } from './outcome.js';
+export type { RunTaskFailureReason, RunTaskResult } from './outcome.js';
+/** Top-level sequential task pipeline; each phase delegates to its lifecycle module. */
 export declare function runTask(projectRoot: string, specFolderPath: string, taskNumber: string, config: OsqConfig, adapter: HarnessAdapter, logger?: Logger): Promise<RunTaskResult>;
 //# sourceMappingURL=runner.d.ts.map

package/dist/watcher/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/watcher/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAGL,KAAK,cAAc,EAGpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,iBAAiB,GACjB,WAAW,GACX,YAAY,GACZ,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,oBAAoB,EAC7B,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAOR;AAED,wBAAsB,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAehG;AAmDD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuBD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CA0E7B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAGxF;AAkBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,kBAAkB,EACzB,aAAa,GAAE,MAA0E,GACxF,MAAM,CAwBR;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAE7F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,MAA0E,GACxF,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,GACf,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAmYxB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/watcher/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAU1D,OAAO,EAEL,KAAK,aAAa,EAOnB,MAAM,cAAc,CAAC;AAMtB,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAExE,wFAAwF;AACxF,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CA6JxB"}