@matteeh/osq 0.1.0 → 0.2.0

package/dist/core/lifecycle/done.js

@@ -0,0 +1,97 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { findSpecFolder } from '../spec/approve.js';
+import { parseTaskList } from '../spec/parser.js';
+import { getChangesDir } from '../status/layout.js';
+const CHECKLIST_LINE_REGEX = /^(\s*-\s+\[)([ xX])(\]\s*)((?:(\d+)[.)]\s+)?)(.*)$/;
+/**
+ * Tick `taskNumber`'s checkbox in `tasks.md`, supporting flat and grouped
+ * (`## <n>.`) numbering. Pure: returns the input unchanged when nothing matched.
+ */
+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) => {
+        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(CHECKLIST_LINE_REGEX);
+        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;
+}
+/** A task exists when `tasks/<n>.md` is present or `tasks.md` lists number `<n>`. */
+async function taskExists(folderPath, taskNumber) {
+    const taskFile = path.join(folderPath, 'tasks', `${taskNumber}.md`);
+    if (await fs.stat(taskFile).then(() => true, () => false))
+        return true;
+    const tasksMd = await fs.readFile(path.join(folderPath, 'tasks.md'), 'utf8').catch(() => null);
+    if (tasksMd === null)
+        return false;
+    const target = Number.parseInt(taskNumber, 10);
+    return parseTaskList(tasksMd).some((item) => item.number === target);
+}
+/**
+ * Append the typed `done_manual` lifecycle event. Written directly rather than
+ * through the harness layer so `src/core` stays free of cross-tier imports.
+ */
+async function appendDoneManualEvent(folderPath, taskNumber, reason) {
+    const eventsDir = path.join(folderPath, '.run', 'events');
+    await fs.mkdir(eventsDir, { recursive: true });
+    const eventPath = path.join(eventsDir, `${taskNumber}.jsonl`);
+    const event = {
+        type: 'done_manual',
+        timestamp: new Date().toISOString(),
+        data: { task: taskNumber, reason },
+    };
+    await fs.appendFile(eventPath, `${JSON.stringify(event)}\n`, 'utf8');
+    return eventPath;
+}
+/**
+ * Mark a task done by human decision. Writes `.run/done/<n>` carrying
+ * `manual: true` and the justification, appends a `done_manual` event, and ticks
+ * the task checkbox in `tasks.md`. This is the sole path for manual completion;
+ * archive-time verification still runs the task's `verify` command.
+ */
+export async function markTaskDoneManual(projectRoot, specIdOrPrefix, taskNumber, reason, config) {
+    const trimmedReason = reason.trim();
+    if (!trimmedReason) {
+        throw new Error('a manual completion reason is required');
+    }
+    const specsDir = getChangesDir(config.paths.openspecRoot, projectRoot);
+    const folderPath = await findSpecFolder(specsDir, specIdOrPrefix);
+    const folderName = path.basename(folderPath);
+    const specId = folderName.match(/^(\d+)/)?.[1] ?? folderName;
+    if (!(await taskExists(folderPath, taskNumber))) {
+        throw new Error(`Task "${taskNumber}" was not found in ${folderName}`);
+    }
+    const doneDir = path.join(folderPath, '.run', 'done');
+    await fs.mkdir(doneDir, { recursive: true });
+    const markerPath = path.join(doneDir, taskNumber);
+    const frontmatter = `---\nmanual: true\nreason: ${JSON.stringify(trimmedReason)}\n---\n`;
+    await fs.writeFile(markerPath, `${frontmatter}${new Date().toISOString()}\n`, 'utf8');
+    const eventPath = await appendDoneManualEvent(folderPath, taskNumber, trimmedReason);
+    const tasksMdPath = path.join(folderPath, 'tasks.md');
+    const tasksContent = await fs.readFile(tasksMdPath, 'utf8').catch(() => null);
+    if (tasksContent !== null) {
+        const updated = tickTaskCheckboxContent(tasksContent, taskNumber);
+        if (updated !== tasksContent)
+            await fs.writeFile(tasksMdPath, updated, 'utf8');
+    }
+    return { specId, folderName, folderPath, taskNumber, markerPath, eventPath };
+}
+//# sourceMappingURL=done.js.map

package/dist/core/lifecycle/done.js.map

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

package/dist/core/lifecycle/reject.d.ts

@@ -0,0 +1,26 @@
+import type { OsqConfig } from '../foundation/config.js';
+/**
+ * Explicit rejection transition. An eligible active change is moved intact into
+ * `openspec/changes/rejected/<folder>/`; the rejection reason and timestamp are
+ * then recorded beside the preserved diagnostics. Eligibility is decided before
+ * the single filesystem rename, so a refusal never moves or overwrites anything.
+ */
+export interface RejectResult {
+    readonly specId: string;
+    readonly folderName: string;
+    readonly sourcePath: string;
+    readonly destinationPath: string;
+    readonly reason: string;
+    readonly timestamp: string;
+}
+/**
+ * Move an eligible active change into rejected history.
+ *
+ * An unapproved active change is eligible. An approved change is eligible only
+ * while it has an active failure (a numeric dead or regressed marker, or a
+ * change-level regression) and no task is running. Healthy approved, complete,
+ * running, archived, already rejected, missing, and destination-colliding
+ * changes are refused before the first mutation.
+ */
+export declare function rejectSpec(projectRoot: string, specIdOrPrefix: string, reason: string, config: OsqConfig): Promise<RejectResult>;
+//# sourceMappingURL=reject.d.ts.map

package/dist/core/lifecycle/reject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reject.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/reject.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAKzD;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAyCD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,YAAY,CAAC,CAqDvB"}

package/dist/core/lifecycle/reject.js

@@ -0,0 +1,83 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { findSpecFolder } from '../spec/approve.js';
+import { getChangeRunDir, getChangesDir, getRejectedDir } from '../status/layout.js';
+import { deriveSpecState, readChangeFolder } from '../status/state.js';
+async function pathExists(target) {
+    return fs.stat(target).then(() => true, () => false);
+}
+/** JSON strings are valid YAML double-quoted scalars, so reasons round-trip safely. */
+function yamlString(value) {
+    return JSON.stringify(value);
+}
+/**
+ * Append the typed `rejected` event directly rather than through the harness
+ * layer so `src/core` stays free of cross-tier imports, mirroring `done_manual`.
+ */
+async function appendRejectedEvent(folderPath, reason, timestamp) {
+    const eventsDir = path.join(folderPath, '.run', 'events');
+    await fs.mkdir(eventsDir, { recursive: true });
+    const event = { type: 'rejected', timestamp, data: { reason } };
+    await fs.appendFile(path.join(eventsDir, 'change.jsonl'), `${JSON.stringify(event)}\n`, 'utf8');
+}
+/** Write `.run/rejected.md` carrying the same reason and timestamp as the event. */
+async function writeRejectedMarker(folderPath, reason, timestamp) {
+    const runDir = getChangeRunDir(folderPath);
+    await fs.mkdir(runDir, { recursive: true });
+    const content = `---\nreason: ${yamlString(reason)}\ntimestamp: ${yamlString(timestamp)}\n---\n`;
+    await fs.writeFile(path.join(runDir, 'rejected.md'), content, 'utf8');
+}
+/**
+ * Move an eligible active change into rejected history.
+ *
+ * An unapproved active change is eligible. An approved change is eligible only
+ * while it has an active failure (a numeric dead or regressed marker, or a
+ * change-level regression) and no task is running. Healthy approved, complete,
+ * running, archived, already rejected, missing, and destination-colliding
+ * changes are refused before the first mutation.
+ */
+export async function rejectSpec(projectRoot, specIdOrPrefix, reason, config) {
+    const trimmedReason = reason.trim();
+    if (!trimmedReason) {
+        throw new Error('a non-empty rejection reason is required');
+    }
+    // Resolve only beneath the active changes directory. Archived and rejected
+    // folders live elsewhere and therefore never match.
+    const specsDir = getChangesDir(config.paths.openspecRoot, projectRoot);
+    const sourcePath = await findSpecFolder(specsDir, specIdOrPrefix);
+    const folderName = path.basename(sourcePath);
+    const specId = folderName.match(/^(\d+)/)?.[1] ?? folderName;
+    const rejectedDir = getRejectedDir(config.paths.openspecRoot, projectRoot);
+    const destinationPath = path.join(rejectedDir, folderName);
+    if (await pathExists(destinationPath)) {
+        throw new Error(`Cannot reject ${folderName}: destination "${path.relative(projectRoot, destinationPath) || destinationPath}" already exists.`);
+    }
+    // Read running markers and approval directly so no state-precedence result
+    // can hide a live lock, and so a historical suffixed marker never reads as an
+    // active failure.
+    const snapshot = await readChangeFolder(projectRoot, sourcePath);
+    if (snapshot.runningPids.size > 0) {
+        throw new Error(`Change ${folderName} has a running task; rejection is refused.`);
+    }
+    if (snapshot.approvedHash) {
+        const state = deriveSpecState(snapshot);
+        if (state.status !== 'dead' && state.status !== 'regressed') {
+            throw new Error(`Change ${folderName} is approved and healthy; only a failed change may be rejected.`);
+        }
+    }
+    // One ISO timestamp is shared by the marker and the event.
+    const timestamp = new Date().toISOString();
+    await fs.mkdir(rejectedDir, { recursive: true });
+    await fs.rename(sourcePath, destinationPath);
+    await writeRejectedMarker(destinationPath, trimmedReason, timestamp);
+    await appendRejectedEvent(destinationPath, trimmedReason, timestamp);
+    return {
+        specId,
+        folderName,
+        sourcePath,
+        destinationPath,
+        reason: trimmedReason,
+        timestamp,
+    };
+}
+//# sourceMappingURL=reject.js.map

package/dist/core/lifecycle/reject.js.map

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

package/dist/core/lifecycle/retry-transition.d.ts

@@ -0,0 +1,23 @@
+export interface RetainFailureMarkersOptions {
+    readonly runDir: string;
+    readonly folderPath: string;
+    readonly target: string;
+    /** Shared next ordinal across retained dead and regressed failures. */
+    readonly ordinal: number;
+    readonly hasDead: boolean;
+    readonly hasRegressed: boolean;
+    /** Retire an active done marker alongside a retained regression. */
+    readonly retainDone: boolean;
+}
+/**
+ * Rename active dead, regressed, and optionally done markers into their
+ * attempt-suffixed history. Returns the retained paths relative to the change
+ * folder in the established order: regressed, dead, then done.
+ */
+export declare function retainFailureMarkers(options: RetainFailureMarkersOptions): Promise<string[]>;
+/** Append one timestamped target-scoped lifecycle event. */
+export declare function appendTargetEvent(folderPath: string, target: string, event: {
+    type: string;
+    data: unknown;
+}): Promise<void>;
+//# sourceMappingURL=retry-transition.d.ts.map

package/dist/core/lifecycle/retry-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-transition.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/retry-transition.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AASD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAED,4DAA4D;AAC5D,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACrC,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/core/lifecycle/retry-transition.js

@@ -0,0 +1,41 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+async function pathExists(target) {
+    return fs.stat(target).then(() => true, () => false);
+}
+/**
+ * Rename active dead, regressed, and optionally done markers into their
+ * attempt-suffixed history. Returns the retained paths relative to the change
+ * folder in the established order: regressed, dead, then done.
+ */
+export async function retainFailureMarkers(options) {
+    const { runDir, folderPath, target, ordinal, hasDead, hasRegressed, retainDone } = options;
+    const deadDir = path.join(runDir, 'dead');
+    const regressedDir = path.join(runDir, 'regressed');
+    const retained = [];
+    const retain = async (from, to) => {
+        await fs.rename(from, to);
+        retained.push(path.relative(folderPath, to));
+    };
+    if (hasRegressed) {
+        await retain(path.join(regressedDir, `${target}.md`), path.join(regressedDir, `${target}.${ordinal}.md`));
+    }
+    if (hasDead) {
+        await retain(path.join(deadDir, `${target}.md`), path.join(deadDir, `${target}.${ordinal}.md`));
+    }
+    if (retainDone) {
+        const donePath = path.join(runDir, 'done', target);
+        if (await pathExists(donePath)) {
+            await retain(donePath, path.join(runDir, 'done', `${target}.${ordinal}`));
+        }
+    }
+    return retained;
+}
+/** Append one timestamped target-scoped lifecycle event. */
+export async function appendTargetEvent(folderPath, target, event) {
+    const eventsDir = path.join(folderPath, '.run', 'events');
+    await fs.mkdir(eventsDir, { recursive: true });
+    const line = JSON.stringify({ ...event, timestamp: new Date().toISOString() });
+    await fs.appendFile(path.join(eventsDir, `${target}.jsonl`), `${line}\n`, 'utf8');
+}
+//# sourceMappingURL=retry-transition.js.map

package/dist/core/lifecycle/retry-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-transition.js","sourceRoot":"","sources":["../../../src/core/lifecycle/retry-transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAkB7B,KAAK,UAAU,UAAU,CAAC,MAAc;IACtC,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CACzB,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoC;IAEpC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC3F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,EAAE,IAAY,EAAE,EAAU,EAAiB,EAAE;QAC/D,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC;IACF,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,MAAM,CACV,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,MAAM,KAAK,CAAC,EACvC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,MAAM,IAAI,OAAO,KAAK,CAAC,CACnD,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,MAAc,EACd,KAAsC;IAEtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC;AACpF,CAAC"}

package/dist/core/lifecycle/retry.d.ts

@@ -0,0 +1,18 @@
+import type { OsqConfig } from '../foundation/config.js';
+export interface RetryResult {
+    readonly specId: string;
+    readonly folderName: string;
+    readonly folderPath: string;
+    readonly target: string;
+    readonly reason: string;
+    /** Following execution attempt; the next started event carries this number. */
+    readonly attempt: number;
+    readonly retainedMarkers: string[];
+    readonly recertification?: 'passed' | 'requeued';
+}
+export interface RetryOptions {
+    /** True when the watcher, rather than a human, requested this retry. */
+    readonly automatic?: boolean;
+}
+export declare function retrySpec(projectRoot: string, specIdOrPrefix: string, target: string, config: OsqConfig, options?: RetryOptions): Promise<RetryResult>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/lifecycle/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/retry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAsBzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAClD;AAED,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAkCD,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAqKtB"}

package/dist/core/lifecycle/retry.js

@@ -0,0 +1,179 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import YAML from 'yaml';
+import { computeTaskScopeHash, readDoneMarker, } from '../run/scope-hash.js';
+import { SCOPE_RESOLVER_VERSION } from '../run/scope.js';
+import { runVerificationCommand } from '../run/verification.js';
+import { findSpecFolder } from '../spec/approve.js';
+import { hashChangeFolder } from '../spec/hasher.js';
+import { parseFrontmatter, parseTaskMd } from '../spec/parser.js';
+import { getChangeRunDir, getChangesDir } from '../status/layout.js';
+import { appendTargetEvent, retainFailureMarkers } from './retry-transition.js';
+// Retry renames active failure markers into attempt-suffixed history; a numeric
+// scope regression with an automated done marker is recertified by re-running
+// its verify without an agent.
+const CHANGE_TARGET = 'change';
+const NUMERIC_TARGET = /^\d+$/;
+const SCOPE_REGRESSION = 'scope_regression';
+async function pathExists(target) {
+    return fs.stat(target).then(() => true, () => false);
+}
+async function listDir(dir) {
+    return fs.readdir(dir).catch(() => []);
+}
+function retainedOrdinal(entries, target) {
+    const escaped = target.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(`^${escaped}\\.(\\d+)\\.md$`);
+    let highest = 0;
+    for (const entry of entries) {
+        const match = entry.match(pattern);
+        if (!match)
+            continue;
+        const ordinal = Number.parseInt(match[1], 10);
+        if (ordinal > highest)
+            highest = ordinal;
+    }
+    return highest;
+}
+function markerReason(content, fallback) {
+    const { data } = parseFrontmatter(content);
+    const reason = typeof data.reason === 'string' ? data.reason.trim() : '';
+    return reason || fallback;
+}
+// Validate approval, running state, and active failure before verification or
+// mutation, then either recertify a scope regression or preserve the failure.
+export async function retrySpec(projectRoot, specIdOrPrefix, target, config, options = {}) {
+    const rawTarget = target.trim();
+    if (rawTarget !== CHANGE_TARGET && !NUMERIC_TARGET.test(rawTarget)) {
+        throw new Error(`Invalid retry target "${target}": expected a numeric task or "change".`);
+    }
+    const specsDir = getChangesDir(config.paths.openspecRoot, projectRoot);
+    const folderPath = await findSpecFolder(specsDir, specIdOrPrefix);
+    const folderName = path.basename(folderPath);
+    const specId = folderName.match(/^(\d+)/)?.[1] ?? folderName;
+    const runDir = getChangeRunDir(folderPath);
+    // Approval integrity is checked before any marker or event is touched.
+    const approvedHash = await fs
+        .readFile(path.join(runDir, 'approved'), 'utf8')
+        .then((value) => value.trim())
+        .catch(() => '');
+    if (!approvedHash) {
+        throw new Error(`Change ${specId} is not approved. Run \`osq approve ${specId}\` before retrying.`);
+    }
+    if ((await hashChangeFolder(folderPath)) !== approvedHash) {
+        throw new Error(`Change ${specId} no longer matches its approved hash. Run \`osq approve ${specId}\` before retrying.`);
+    }
+    // A running target is never retried; never mutate under a live lock.
+    const runningDir = path.join(runDir, 'running');
+    if (rawTarget === CHANGE_TARGET) {
+        const running = (await listDir(runningDir)).filter((entry) => entry.endsWith('.pid'));
+        if (running.length > 0) {
+            throw new Error(`Change ${specId} has a running task; retry is refused.`);
+        }
+    }
+    else if (await pathExists(path.join(runningDir, `${rawTarget}.pid`))) {
+        throw new Error(`Task ${rawTarget} is running; retry is refused.`);
+    }
+    const deadDir = path.join(runDir, 'dead');
+    const regressedDir = path.join(runDir, 'regressed');
+    const deadEntries = await listDir(deadDir);
+    const regressedEntries = await listDir(regressedDir);
+    const deadPath = path.join(deadDir, `${rawTarget}.md`);
+    const regressedPath = path.join(regressedDir, `${rawTarget}.md`);
+    // Only a task can be dead; the change target accepts a change-level regression.
+    const hasDead = rawTarget !== CHANGE_TARGET && (await pathExists(deadPath));
+    const hasRegressed = await pathExists(regressedPath);
+    if (!hasDead && !hasRegressed) {
+        const label = rawTarget === CHANGE_TARGET ? 'change-level regression' : `task ${rawTarget}`;
+        throw new Error(`No active failure marker for ${label} in ${folderName}; retry is refused.`);
+    }
+    // Regression takes state precedence over dead for retry context.
+    const reason = hasRegressed
+        ? markerReason(await fs.readFile(regressedPath, 'utf8'), 'regressed')
+        : markerReason(await fs.readFile(deadPath, 'utf8'), 'dead');
+    const ordinal = Math.max(retainedOrdinal(deadEntries, rawTarget), retainedOrdinal(regressedEntries, rawTarget)) + 1;
+    // A scope regression with an automated done marker is recertified from core
+    // rather than handing the trusted completion back to an agent.
+    const done = rawTarget !== CHANGE_TARGET && hasRegressed && !hasDead && reason === SCOPE_REGRESSION
+        ? await readDoneMarker(runDir, rawTarget)
+        : null;
+    let recertification;
+    let recertificationEvent;
+    if (done) {
+        const taskData = parseTaskMd(await fs.readFile(path.join(folderPath, 'tasks', `${rawTarget}.md`), 'utf8'));
+        const marker = parseFrontmatter(await fs.readFile(regressedPath, 'utf8'));
+        const attribution = Array.isArray(marker.data.attribution)
+            ? marker.data.attribution
+            : [];
+        const differingPaths = marker.body
+            .split('\n\n')[0]
+            .split('\n')
+            .filter((line) => line.startsWith('- '))
+            .map((line) => line.slice(2).trim());
+        const gate = await runVerificationCommand(projectRoot, taskData.verify, config.timeouts.verifyTimeoutSeconds);
+        const current = await computeTaskScopeHash(projectRoot, taskData.scope);
+        recertification = gate.exitCode === 0 && !gate.error ? 'passed' : 'requeued';
+        recertificationEvent = {
+            task: rawTarget,
+            outcome: recertification,
+            differingPaths,
+            attribution,
+            command: taskData.verify,
+            exitCode: gate.exitCode,
+            output: gate.output,
+            timedOut: gate.timedOut,
+            recordedHash: done.scopeHash,
+            currentHash: current.hash,
+            ...(recertification === 'passed' ? {} : { attempt: ordinal + 1, reason: SCOPE_REGRESSION }),
+        };
+        if (recertification === 'passed') {
+            const { data, body } = parseFrontmatter(await fs.readFile(path.join(runDir, 'done', rawTarget), 'utf8'));
+            const merged = { ...data };
+            if (typeof merged.original_scope_hash !== 'string' || !merged.original_scope_hash) {
+                merged.original_scope_hash = done.scopeHash;
+            }
+            merged.scope_hash = current.hash;
+            merged.scope_files = current.fileHashes;
+            merged.scope_resolver = SCOPE_RESOLVER_VERSION;
+            merged.recertified_at = new Date().toISOString();
+            const count = data.recertification_count;
+            merged.recertification_count =
+                (typeof count === 'number' && Number.isInteger(count) && count > 0 ? count : 0) + 1;
+            await fs.writeFile(path.join(runDir, 'done', rawTarget), `---\n${YAML.stringify(merged)}---\n${body}`, 'utf8');
+        }
+    }
+    const retainedMarkers = await retainFailureMarkers({
+        runDir,
+        folderPath,
+        target: rawTarget,
+        ordinal,
+        hasDead,
+        hasRegressed,
+        // A regressed completion is retained unless a pass recertified it in place.
+        retainDone: hasRegressed && rawTarget !== CHANGE_TARGET && recertification !== 'passed',
+    });
+    const attempt = recertification === 'passed' ? ordinal : ordinal + 1;
+    const retryData = {
+        target: rawTarget,
+        reason,
+        attempt,
+    };
+    // Only the watcher's automatic retry carries the marker; a human retry
+    // leaves the event without the key, and recertification never carries it.
+    if (options.automatic)
+        retryData.automatic = true;
+    await appendTargetEvent(folderPath, rawTarget, recertificationEvent
+        ? { type: 'recertification', data: recertificationEvent }
+        : { type: 'retry', data: retryData });
+    return {
+        specId,
+        folderName,
+        folderPath,
+        target: rawTarget,
+        reason,
+        attempt,
+        retainedMarkers,
+        ...(recertification ? { recertification } : {}),
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/core/lifecycle/retry.js.map

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

package/dist/core/report/approval-flags.d.ts

@@ -0,0 +1,29 @@
+/** The key used for changes whose recorded flag ids are empty. */
+export declare const NO_APPROVAL_FLAGS = "none";
+/** Every reported key, never recomputed: the flag ids then `none`. */
+export declare const APPROVAL_FLAG_KEYS: readonly string[];
+/** Fired and later-troubled counts for one handling mode. */
+export interface ApprovalFlagModeOutcome {
+    readonly fired: number;
+    readonly troubled: number;
+}
+/** Shown and confirmed outcomes for one reported key. */
+export interface ApprovalFlagOutcome {
+    readonly shown: ApprovalFlagModeOutcome;
+    readonly confirmed: ApprovalFlagModeOutcome;
+}
+/** Per-key outcomes plus the number of changes that recorded flags. */
+export interface ApprovalFlagOutcomes {
+    readonly changes: number;
+    readonly byFlag: Record<string, ApprovalFlagOutcome>;
+}
+/**
+ * Reads recorded `approvalFlags` from every given change folder's manifest and
+ * counts, per key and mode, how many changes fired it and how many later had
+ * trouble. Folders without a valid recorded field contribute nothing; flags
+ * are never recomputed from the authored change.
+ */
+export declare function collectApprovalFlagOutcomes(folders: readonly string[]): Promise<ApprovalFlagOutcomes>;
+/** Render the `Approval flags:` body, one line per key in fixed order. */
+export declare function formatApprovalFlagOutcomes(outcomes: ApprovalFlagOutcomes): string[];
+//# sourceMappingURL=approval-flags.d.ts.map

package/dist/core/report/approval-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-flags.d.ts","sourceRoot":"","sources":["../../../src/core/report/approval-flags.ts"],"names":[],"mappings":"AAeA,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAqC,CAAC;AAEtF,6DAA6D;AAC7D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;CAC7C;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACtD;AAyFD;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAyB/B;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAWnF"}