@matteeh/osq 0.1.0 → 0.2.1

package/dist/watcher/measures.js

@@ -0,0 +1,203 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { SCOPE_RESOLVER_VERSION, resolveScope } from '../core/run/scope.js';
+import { resolveChangeDoc } from '../core/spec/parser.js';
+import { appendHarnessEvent } from '../harness/types.js';
+const IGNORED_DIRS = new Set('node_modules dist .git .run coverage .nyc_output .vscode .idea'.split(' '));
+const SCRIPT_EXTENSION_REGEX = /\.(?:ts|tsx|js|mjs|cjs)$/;
+function countLines(content) {
+    return content.split('\n').length;
+}
+function toPosix(value) {
+    return value.split(path.sep).join('/');
+}
+function relativePosix(projectRoot, filePath) {
+    return toPosix(path.relative(projectRoot, filePath));
+}
+function hashContent(content) {
+    return `sha256:${crypto.createHash('sha256').update(content, 'utf8').digest('hex')}`;
+}
+/** Snapshot every resolved scoped file's content hash and line count in one pass. */
+export async function snapshotScope(projectRoot, scope) {
+    const hashes = {};
+    const lines = {};
+    for (const { relativePath, absolutePath } of await resolveScope(projectRoot, scope)) {
+        const content = absolutePath ? await fs.readFile(absolutePath, 'utf8').catch(() => null) : null;
+        hashes[relativePath] = content === null ? null : hashContent(content);
+        lines[relativePath] = content === null ? 0 : countLines(content);
+    }
+    return { hashes, lines };
+}
+/** Line count of every existing file in `scope`; missing files contribute nothing. */
+export async function gatherScopeCounts(projectRoot, scope) {
+    const { hashes, lines } = await snapshotScope(projectRoot, scope);
+    const files = Object.values(hashes).filter((hash) => hash !== null).length;
+    const total = Object.values(lines).reduce((sum, count) => sum + count, 0);
+    return { files, lines: total };
+}
+/** Recursively total all text files and their lines, skipping ignored directories. */
+export async function gatherRepoCounts(projectRoot) {
+    let files = 0;
+    let lines = 0;
+    const walk = async (dir) => {
+        const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!IGNORED_DIRS.has(entry.name))
+                    await walk(fullPath);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            const content = await fs.readFile(fullPath, 'utf8').catch(() => null);
+            if (content === null || content.includes('\u0000'))
+                continue;
+            files += 1;
+            lines += countLines(content);
+        }
+    };
+    await walk(projectRoot);
+    return { files, lines };
+}
+async function listTsFiles(dir) {
+    const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            files.push(...(await listTsFiles(fullPath)));
+        else if (entry.isFile() && entry.name.endsWith('.ts'))
+            files.push(fullPath);
+    }
+    return files;
+}
+function importSpecifier(fromDir, targetPath) {
+    const relative = toPosix(path.relative(fromDir, targetPath)).replace(SCRIPT_EXTENSION_REGEX, '');
+    return relative.startsWith('.') ? relative : `./${relative}`;
+}
+/** Count of non-scoped `src/**` TypeScript files that import at least one resolved scoped file. */
+export async function countImportFanIn(projectRoot, scope) {
+    const srcDir = path.join(projectRoot, 'src');
+    const scopePaths = (await resolveScope(projectRoot, scope))
+        .map((entry) => entry.absolutePath)
+        .filter((resolved) => resolved?.startsWith(srcDir + path.sep) === true);
+    const scoped = new Set(scopePaths.map((resolved) => relativePosix(projectRoot, resolved)));
+    let importers = 0;
+    for (const file of await listTsFiles(srcDir)) {
+        if (scoped.has(relativePosix(projectRoot, file)))
+            continue;
+        const content = await fs.readFile(file, 'utf8').catch(() => '');
+        if (!content)
+            continue;
+        const dir = path.dirname(file);
+        if (scopePaths.some((target) => content.includes(importSpecifier(dir, target))))
+            importers += 1;
+    }
+    return importers;
+}
+/** Whitespace-delimited word count; empty and whitespace-only input yield 0. */
+export function countWords(text) {
+    return text.split(/\s+/).filter((word) => word.length > 0).length;
+}
+/** Requirement and scenario header counts across a change's delta spec files. */
+export async function countDeltaRequirementsAndScenarios(specFolderPath) {
+    const specsDir = path.join(specFolderPath, 'specs');
+    const entries = await fs.readdir(specsDir, { withFileTypes: true }).catch(() => []);
+    let requirements = 0;
+    let scenarios = 0;
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const content = await fs
+            .readFile(path.join(specsDir, entry.name, 'spec.md'), 'utf8')
+            .catch(() => '');
+        requirements += (content.match(/^###\s+Requirement:/gm) ?? []).length;
+        scenarios += (content.match(/^####\s+Scenario:/gm) ?? []).length;
+    }
+    return { requirements, scenarios };
+}
+/** `sha256:<hex>` of a file's UTF-8 content, or `null` when it cannot be read. */
+export async function hashFileForMeasures(filePath) {
+    const content = await fs.readFile(filePath, 'utf8').catch(() => null);
+    return content === null ? null : hashContent(content);
+}
+/** Map of project-relative scoped path to its current content hash. */
+export async function snapshotScopeHashes(projectRoot, scope) {
+    return (await snapshotScope(projectRoot, scope)).hashes;
+}
+/** Map of project-relative scoped path to its current line count; missing files are 0. */
+export async function snapshotScopeLines(projectRoot, scope) {
+    return (await snapshotScope(projectRoot, scope)).lines;
+}
+/** The single emission path for both start and end measures events. */
+export async function emitMeasures(specFolderPath, taskNumber, data) {
+    await appendHarnessEvent(specFolderPath, taskNumber, {
+        type: 'measures',
+        timestamp: new Date().toISOString(),
+        data,
+    });
+}
+/** Collect the raw start-phase baselines for a task. */
+export async function gatherStartMeasures(projectRoot, specFolderPath, taskData) {
+    const proposalDoc = await resolveChangeDoc(specFolderPath);
+    const proposalContent = proposalDoc
+        ? await fs.readFile(proposalDoc.path, 'utf8').catch(() => '')
+        : '';
+    const [scopeCounts, repoCounts, importFanIn, delta] = await Promise.all([
+        gatherScopeCounts(projectRoot, taskData.scope),
+        gatherRepoCounts(projectRoot),
+        countImportFanIn(projectRoot, taskData.scope),
+        countDeltaRequirementsAndScenarios(specFolderPath),
+    ]);
+    return {
+        phase: 'start',
+        scopeResolver: SCOPE_RESOLVER_VERSION,
+        scopeFiles: scopeCounts.files,
+        scopeLines: scopeCounts.lines,
+        repoFiles: repoCounts.files,
+        repoLines: repoCounts.lines,
+        importFanIn,
+        proposalWords: countWords(proposalContent),
+        taskWords: countWords(taskData.raw),
+        deltaRequirements: delta.requirements,
+        deltaScenarios: delta.scenarios,
+    };
+}
+/** End-phase diff: changed file count, absolute line delta, and before/after hashes. */
+export async function gatherEndMeasures(startMeasures, before, projectRoot, scope) {
+    const after = await snapshotScope(projectRoot, scope);
+    const scopeHashes = {};
+    let changedFiles = 0;
+    let changedLines = 0;
+    for (const key of new Set([...Object.keys(before.hashes), ...Object.keys(after.hashes)])) {
+        const beforeHash = before.hashes[key] ?? null;
+        const afterHash = after.hashes[key] ?? null;
+        scopeHashes[key] = { before: beforeHash, after: afterHash };
+        if (beforeHash !== afterHash) {
+            changedFiles += 1;
+            changedLines += Math.abs((after.lines[key] ?? 0) - (before.lines[key] ?? 0));
+        }
+    }
+    return { ...startMeasures, phase: 'end', changedFiles, changedLines, scopeHashes };
+}
+/** Create the start/end measures emitter pair for one task run. */
+export function createTaskMeasures(projectRoot, specFolderPath, taskNumber, taskData) {
+    let start = null;
+    let before = null;
+    return {
+        async emitStart() {
+            before = await snapshotScope(projectRoot, taskData.scope);
+            start = await gatherStartMeasures(projectRoot, specFolderPath, taskData);
+            await emitMeasures(specFolderPath, taskNumber, start);
+        },
+        async emitEnd() {
+            if (!start || !before)
+                return;
+            const end = await gatherEndMeasures(start, before, projectRoot, taskData.scope);
+            await emitMeasures(specFolderPath, taskNumber, end);
+        },
+    };
+}
+//# sourceMappingURL=measures.js.map

package/dist/watcher/measures.js.map

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

package/dist/watcher/outcome.d.ts

@@ -0,0 +1,34 @@
+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;
+    /** Short HEAD commit of the project being watched, or null outside git. */
+    projectCommit?: string | null;
+}
+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;IACvB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAKD,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,131 @@
+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);
+}
+/** Frontmatter line for the watched project's commit, null when absent. */
+function formatProjectCommit(projectCommit) {
+    return projectCommit ? `project_commit: "${projectCommit}"\n` : 'project_commit: null\n';
+}
+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}"\n${formatProjectCommit(metadata.projectCommit)}exit_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;AAKnC,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,CAc7B;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,178 @@
+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 { resolveProjectCommit } from './build-project.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, projectCommit] = await Promise.all([
+        computeTaskScopeHash(projectRoot, scope),
+        resolveBuildInfo(),
+        resolveProjectCommit(projectRoot),
+    ]);
+    return {
+        scopeHash: scopeHash.hash,
+        buildStamp: buildInfo.commit,
+        projectCommit,
+        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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"}