@matteeh/osq 0.1.0 → 0.2.0

package/dist/core/run/scope-hash.js.map

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

package/dist/core/run/scope.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Version of the deterministic scope resolver. Consumers that persist scope
+ * evidence record this value so legacy and resolver-2 artifacts stay distinct.
+ */
+export declare const SCOPE_RESOLVER_VERSION = 2;
+/**
+ * One resolved scope entry. `relativePath` is always a normalized
+ * project-relative POSIX path, while `absolutePath` is the readable path of an
+ * existing regular file or `null` for a missing exact declaration.
+ */
+export interface ResolvedScopeEntry {
+    readonly relativePath: string;
+    readonly absolutePath: string | null;
+}
+/**
+ * True when a list of declared scope entries covers one project-relative path:
+ * the path equals an exact entry, or a glob or trailing-directory entry matches
+ * it through the same `globToRegExp` translation the resolver uses. This is a
+ * pure predicate; it never touches the filesystem.
+ */
+export declare function scopeCoversPath(scope: readonly string[], relativePath: string): boolean;
+/**
+ * Resolve scope declarations against the project tree deterministically. Exact
+ * declarations contribute their existing regular file or a null-valued entry
+ * when missing; glob and trailing-directory declarations contribute every
+ * matching regular file. Results are deduplicated, lexically sorted
+ * project-relative POSIX entries and never escape the project root.
+ */
+export declare function resolveScope(projectRoot: string, scope: readonly string[]): Promise<ResolvedScopeEntry[]>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/core/run/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/core/run/scope.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAgED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAevF;AA4DD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA6C/B"}

package/dist/core/run/scope.js

@@ -0,0 +1,193 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Version of the deterministic scope resolver. Consumers that persist scope
+ * evidence record this value so legacy and resolver-2 artifacts stay distinct.
+ */
+export const SCOPE_RESOLVER_VERSION = 2;
+/** Glob metacharacters that distinguish a pattern from an exact declaration. */
+const GLOB_METACHARACTER_REGEX = /[*?]/;
+/** Normalize a raw scope entry to a trimmed, POSIX, project-relative form. */
+function normalizeScopeEntry(entry) {
+    return entry
+        .trim()
+        .replace(/\\/g, '/')
+        .replace(/^(?:\.\/)+/, '');
+}
+/** A pattern is a glob or a trailing-directory form; everything else is exact. */
+function isPatternEntry(normalized) {
+    return GLOB_METACHARACTER_REGEX.test(normalized) || normalized.endsWith('/');
+}
+/** Normalize a path to a project-relative POSIX string. */
+function relativePosix(projectRoot, filePath) {
+    return path.relative(projectRoot, filePath).split(path.sep).join('/');
+}
+/**
+ * Translate a scope glob into an anchored regular expression. Supports `*`
+ * (within one path segment), `**` (across segments), and `?`; a trailing `/`
+ * expands to that directory's recursive contents.
+ */
+function globToRegExp(glob) {
+    let normalized = normalizeScopeEntry(glob);
+    if (normalized.endsWith('/')) {
+        normalized = `${normalized}**`;
+    }
+    normalized = normalized.replace(/\/+$/, '');
+    let source = '^';
+    let index = 0;
+    while (index < normalized.length) {
+        const char = normalized[index];
+        if (char === '*') {
+            if (normalized[index + 1] === '*') {
+                index += 2;
+                if (normalized[index] === '/') {
+                    index += 1;
+                    source += '(?:.*/)?';
+                }
+                else {
+                    source += '.*';
+                }
+            }
+            else {
+                index += 1;
+                source += '[^/]*';
+            }
+        }
+        else if (char === '?') {
+            index += 1;
+            source += '[^/]';
+        }
+        else {
+            source += char.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            index += 1;
+        }
+    }
+    return new RegExp(`${source}$`);
+}
+/**
+ * True when a list of declared scope entries covers one project-relative path:
+ * the path equals an exact entry, or a glob or trailing-directory entry matches
+ * it through the same `globToRegExp` translation the resolver uses. This is a
+ * pure predicate; it never touches the filesystem.
+ */
+export function scopeCoversPath(scope, relativePath) {
+    const normalizedPath = normalizeScopeEntry(relativePath);
+    for (const rawEntry of scope) {
+        if (typeof rawEntry !== 'string')
+            continue;
+        const normalizedEntry = normalizeScopeEntry(rawEntry);
+        if (normalizedEntry === normalizedPath) {
+            return true;
+        }
+        if (isPatternEntry(normalizedEntry) && globToRegExp(normalizedEntry).test(normalizedPath)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * The project-relative directory a pattern can possibly match beneath. Walking
+ * only this prefix keeps resolution proportional to the declared scope rather
+ * than the whole project tree.
+ */
+function patternSearchRoot(normalized) {
+    if (!GLOB_METACHARACTER_REGEX.test(normalized)) {
+        return normalized.replace(/\/+$/, '');
+    }
+    const firstMeta = normalized.search(GLOB_METACHARACTER_REGEX);
+    const prefix = normalized.slice(0, firstMeta);
+    const lastSlash = prefix.lastIndexOf('/');
+    return lastSlash === -1 ? '' : prefix.slice(0, lastSlash);
+}
+/** True when `relative` stays strictly inside the project root. */
+function staysInsideProject(relative) {
+    return (relative !== '..' &&
+        !relative.startsWith(`..${path.sep}`) &&
+        !relative.startsWith('../') &&
+        !path.isAbsolute(relative));
+}
+/** Recursively list every regular file under `root` as a project-relative path. */
+async function listFilesUnder(projectRoot, root) {
+    const base = root === '' ? projectRoot : path.join(projectRoot, root);
+    const files = [];
+    const walk = async (dir) => {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        const ordered = [...entries].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        for (const entry of ordered) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+            }
+            else if (entry.isFile()) {
+                files.push(relativePosix(projectRoot, full));
+            }
+        }
+    };
+    await walk(base);
+    return files.sort();
+}
+function compareResolved(a, b) {
+    if (a.relativePath < b.relativePath)
+        return -1;
+    if (a.relativePath > b.relativePath)
+        return 1;
+    return 0;
+}
+/**
+ * Resolve scope declarations against the project tree deterministically. Exact
+ * declarations contribute their existing regular file or a null-valued entry
+ * when missing; glob and trailing-directory declarations contribute every
+ * matching regular file. Results are deduplicated, lexically sorted
+ * project-relative POSIX entries and never escape the project root.
+ */
+export async function resolveScope(projectRoot, scope) {
+    const results = new Map();
+    const walkCache = new Map();
+    const add = (relativePath, absolutePath) => {
+        if (!results.has(relativePath)) {
+            results.set(relativePath, { relativePath, absolutePath });
+        }
+    };
+    for (const rawEntry of scope) {
+        if (typeof rawEntry !== 'string')
+            continue;
+        const normalized = normalizeScopeEntry(rawEntry);
+        if (isPatternEntry(normalized)) {
+            const root = patternSearchRoot(normalized);
+            if (!staysInsideProject(root))
+                continue;
+            const regex = globToRegExp(normalized);
+            let files = walkCache.get(root);
+            if (files === undefined) {
+                files = await listFilesUnder(projectRoot, root);
+                walkCache.set(root, files);
+            }
+            for (const relative of files) {
+                if (regex.test(relative)) {
+                    add(relative, path.join(projectRoot, relative));
+                }
+            }
+            continue;
+        }
+        const resolved = path.resolve(projectRoot, normalized);
+        if (!staysInsideProject(path.relative(projectRoot, resolved))) {
+            add(normalized, null);
+            continue;
+        }
+        const stat = await fs.lstat(resolved).catch(() => null);
+        if (stat?.isFile()) {
+            add(relativePosix(projectRoot, resolved), resolved);
+        }
+        else {
+            add(normalized, null);
+        }
+    }
+    return [...results.values()].sort(compareResolved);
+}
+//# sourceMappingURL=scope.js.map

package/dist/core/run/scope.js.map

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

package/dist/core/run/summary.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Strip the project root from absolute paths embedded in a tool summary so the
+ * status row reads a clean repository relative path. Relativization happens once
+ * at write time (harness adapters) and once more for display (heartbeat), but the
+ * function lives in core so both layers share a single implementation.
+ */
+export declare function relativizeToolSummary(summary: string, root?: string): string;
+//# sourceMappingURL=summary.d.ts.map

package/dist/core/run/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/core/run/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAsB,GAAG,MAAM,CAoB3F"}

package/dist/core/run/summary.js

@@ -0,0 +1,25 @@
+/**
+ * Strip the project root from absolute paths embedded in a tool summary so the
+ * status row reads a clean repository relative path. Relativization happens once
+ * at write time (harness adapters) and once more for display (heartbeat), but the
+ * function lives in core so both layers share a single implementation.
+ */
+export function relativizeToolSummary(summary, root = process.cwd()) {
+    if (!summary || !root) {
+        return summary;
+    }
+    // Compare without a trailing separator so `${normalizedRoot}/` strips
+    // cleanly, but keep a bare filesystem root intact so it is not reduced to an
+    // empty string that would match every separator in the summary.
+    const normalizedRoot = root.length > 1 ? root.replace(/[\\/]+$/, '') : root;
+    if (!normalizedRoot || normalizedRoot === '/' || normalizedRoot === '\\') {
+        return summary;
+    }
+    const escapedRoot = normalizedRoot.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const withSeparator = new RegExp(`${escapedRoot}[\\\\/]`, 'g');
+    const relativized = summary.replace(withSeparator, '');
+    // A summary that is exactly the root has no trailing separator to strip.
+    const exactRoot = new RegExp(`${escapedRoot}(?=$|[\\s"'()\\[\\]{},;:])`, 'g');
+    return relativized.replace(exactRoot, '.');
+}
+//# sourceMappingURL=summary.js.map

package/dist/core/run/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../src/core/run/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,OAAe,OAAO,CAAC,GAAG,EAAE;IACjF,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,sEAAsE;IACtE,6EAA6E;IAC7E,gEAAgE;IAChE,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,IAAI,CAAC,cAAc,IAAI,cAAc,KAAK,GAAG,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QACzE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC1E,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,GAAG,WAAW,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAEvD,yEAAyE;IACzE,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,GAAG,WAAW,4BAA4B,EAAE,GAAG,CAAC,CAAC;IAC9E,OAAO,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core/run/verification.d.ts

@@ -0,0 +1,23 @@
+/** Raw outcome of one timeout-bounded verification command. */
+export interface VerificationResult {
+    command: string;
+    exitCode: number;
+    /** Wall-clock duration in seconds, rounded to two decimals. */
+    duration: number;
+    /** Combined stdout and stderr captured while the command ran. */
+    output: string;
+    timedOut: boolean;
+    /** Spawn-level failure message, when the process could not be started. */
+    error?: string;
+}
+/**
+ * Execute a verification command under a configured timeout, capturing its
+ * command, exit code, wall-clock duration, combined output, and timeout state.
+ *
+ * This is the single core process implementation shared by the task,
+ * scope-audit, archive, and recertification gates. It never imports from the
+ * watcher or harness layers, so core retains its import boundary; callers own
+ * event emission.
+ */
+export declare function runVerificationCommand(projectRoot: string, command: string, timeoutSeconds: number): Promise<VerificationResult>;
+//# sourceMappingURL=verification.d.ts.map

package/dist/core/run/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../src/core/run/verification.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAWD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,CAAC,CA0D7B"}

package/dist/core/run/verification.js

@@ -0,0 +1,78 @@
+import { spawn } from 'node:child_process';
+function killTree(child, signal) {
+    const pid = child.pid ?? Number.NaN;
+    try {
+        process.kill(-pid, signal);
+    }
+    catch {
+        child.kill(signal);
+    }
+}
+/**
+ * Execute a verification command under a configured timeout, capturing its
+ * command, exit code, wall-clock duration, combined output, and timeout state.
+ *
+ * This is the single core process implementation shared by the task,
+ * scope-audit, archive, and recertification gates. It never imports from the
+ * watcher or harness layers, so core retains its import boundary; callers own
+ * event emission.
+ */
+export async function runVerificationCommand(projectRoot, command, timeoutSeconds) {
+    const startMs = Date.now();
+    const timeoutMs = timeoutSeconds * 1000;
+    let timedOut = false;
+    let exitCode = 1;
+    let output = '';
+    let spawnError;
+    await new Promise((resolve) => {
+        const child = spawn(command, {
+            cwd: projectRoot,
+            shell: true,
+            detached: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let timer = null;
+        let killTimer = null;
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            resolve();
+        };
+        if (timeoutMs > 0) {
+            timer = setTimeout(() => {
+                timedOut = true;
+                killTree(child, 'SIGTERM');
+                killTimer = setTimeout(() => killTree(child, 'SIGKILL'), 5000);
+            }, timeoutMs);
+        }
+        child.stderr?.on('data', (d) => {
+            output += d.toString();
+        });
+        child.stdout?.on('data', (d) => {
+            output += d.toString();
+        });
+        child.on('error', (err) => {
+            spawnError = err.message;
+            finish();
+        });
+        child.on('close', (code) => {
+            exitCode = timedOut ? 1 : (code ?? 1);
+            finish();
+        });
+    });
+    return {
+        command,
+        exitCode,
+        duration: Number(((Date.now() - startMs) / 1000).toFixed(2)),
+        output,
+        timedOut,
+        ...(spawnError ? { error: spawnError } : {}),
+    };
+}
+//# sourceMappingURL=verification.js.map

package/dist/core/run/verification.js.map

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

package/dist/core/spec/approve.d.ts

@@ -0,0 +1,31 @@
+import { type OsqConfig } from '../foundation/config.js';
+import { type PlanningSessionReader } from '../report/planning-observed.js';
+import { type ApprovalDigest, type ApprovalFlag } from './digest.js';
+export declare function findSpecFolder(specsDir: string, idOrPrefix: string): Promise<string>;
+export interface ApproveResult {
+    specId: string;
+    folderName: string;
+    folderPath: string;
+    hash: string;
+    warnings: string[];
+    /** Number of local planning sessions matched at approval time. */
+    planningMatches: number;
+    /** The digest built for this approval, flags included. */
+    digest: ApprovalDigest;
+}
+/** How an optional approver review resolved before the seal was written. */
+export type ApprovalReview = 'proceed' | 'confirmed' | 'declined';
+/** Thrown when an approver declined a flagged approval; nothing is written. */
+export declare class ApprovalDeclinedError extends Error {
+    constructor(flags: readonly ApprovalFlag[]);
+}
+export interface ApproveOptions {
+    /** Independent local session readers supplied by the CLI. */
+    planningReaders?: readonly PlanningSessionReader[];
+    /** Single observation end; defaults to the current time. */
+    now?: Date | string;
+    /** Optional port between the CLI and core for digest review and confirmation. */
+    review?: (digest: ApprovalDigest) => Promise<ApprovalReview>;
+}
+export declare function approveSpec(projectRoot: string, specIdOrPrefix: string, config: OsqConfig, options?: ApproveOptions): Promise<ApproveResult>;
+//# sourceMappingURL=approve.d.ts.map

package/dist/core/spec/approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../../src/core/spec/approve.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EACL,KAAK,qBAAqB,EAI3B,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EAGlB,MAAM,aAAa,CAAC;AAIrB,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B1F;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAElE,+EAA+E;AAC/E,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,KAAK,EAAE,SAAS,YAAY,EAAE;CAI3C;AAED,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,eAAe,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,4DAA4D;IAC5D,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAiBD,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAgExB"}

package/dist/core/spec/approve.js

@@ -0,0 +1,111 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { DEFAULT_CONFIG } from '../foundation/config.js';
+import { appendObservedSessions, findPlanningSessions, resolveChangeCreationTime, } from '../report/planning-observed.js';
+import { hashBriefBytes, resolveOsqPackageVersion } from '../report/planning.js';
+import { buildManifest, writeManifest } from '../run/manifest.js';
+import { getChangesDir } from '../status/layout.js';
+import { buildApprovalDigest, summarizeApprovalFlags, } from './digest.js';
+import { hashChangeFolder } from './hasher.js';
+import { lintChangeFolder } from './linter.js';
+export async function findSpecFolder(specsDir, idOrPrefix) {
+    let entries = [];
+    try {
+        entries = await fs.readdir(specsDir);
+    }
+    catch {
+        throw new Error(`Specs directory not found at ${specsDir}`);
+    }
+    const trimmed = idOrPrefix.trim();
+    const num = Number.parseInt(trimmed, 10);
+    const padded = !Number.isNaN(num) ? String(num).padStart(3, '0') : trimmed;
+    for (const entry of entries) {
+        if (entry === trimmed ||
+            entry === padded ||
+            entry.startsWith(`${trimmed}-`) ||
+            entry.startsWith(`${padded}-`)) {
+            const fullPath = path.join(specsDir, entry);
+            const stat = await fs.stat(fullPath);
+            if (stat.isDirectory()) {
+                return fullPath;
+            }
+        }
+    }
+    throw new Error(`Spec "${idOrPrefix}" not found in ${specsDir}`);
+}
+/** Thrown when an approver declined a flagged approval; nothing is written. */
+export class ApprovalDeclinedError extends Error {
+    constructor(flags) {
+        super(`Approval declined: ${summarizeApprovalFlags(flags)}`);
+        this.name = 'ApprovalDeclinedError';
+    }
+}
+function toIso(value) {
+    if (value instanceof Date) {
+        return Number.isFinite(value.getTime()) ? value.toISOString() : null;
+    }
+    if (typeof value === 'string') {
+        return Number.isFinite(Date.parse(value)) ? value : null;
+    }
+    return null;
+}
+async function readBriefHash(folderPath) {
+    const bytes = await fs.readFile(path.join(folderPath, 'brief.md')).catch(() => null);
+    return hashBriefBytes(bytes ?? '');
+}
+export async function approveSpec(projectRoot, specIdOrPrefix, config, options = {}) {
+    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 lintResult = await lintChangeFolder(projectRoot, folderPath, config);
+    if (!lintResult.valid) {
+        throw new Error(`Lint failed for spec "${folderName}":\n  - ${lintResult.errors.join('\n  - ')}`);
+    }
+    // Build the digest after lint and before any observation write, then let the
+    // optional review port decide whether a flagged approval may proceed.
+    const digest = await buildApprovalDigest(projectRoot, folderPath, config);
+    let mode = 'shown';
+    if (options.review) {
+        const review = await options.review(digest);
+        if (review === 'declined') {
+            throw new ApprovalDeclinedError(digest.flags);
+        }
+        mode = review === 'confirmed' ? 'confirmed' : 'shown';
+    }
+    // Discover local planning sessions after lint so a failed change is never
+    // recorded, then append observed pairs before the manifest is built.
+    const observations = await findPlanningSessions(folderPath, {
+        createdAt: await resolveChangeCreationTime(folderPath),
+        observedAt: toIso(options.now) ?? new Date().toISOString(),
+        changesDir: specsDir,
+        planning: config.planning ?? DEFAULT_CONFIG.planning,
+        readers: options.planningReaders ?? [],
+    });
+    await appendObservedSessions(folderPath, observations, {
+        briefHash: await readBriefHash(folderPath),
+        osqVersion: await resolveOsqPackageVersion(),
+    });
+    const hash = await hashChangeFolder(folderPath);
+    // Approval only refreshes the seal. It never retires failure markers: that is
+    // the exclusive job of an explicit `osq retry`.
+    const runDir = path.join(folderPath, '.run');
+    await fs.mkdir(runDir, { recursive: true });
+    const approvedPath = path.join(runDir, 'approved');
+    await fs.writeFile(approvedPath, `${hash}\n`, 'utf8');
+    const manifest = await buildManifest(projectRoot, folderPath, config, {
+        ids: digest.flags.map((flag) => flag.id),
+        mode,
+    });
+    await writeManifest(runDir, manifest);
+    return {
+        specId,
+        folderName,
+        folderPath,
+        hash,
+        warnings: lintResult.warnings,
+        planningMatches: observations.length,
+        digest,
+    };
+}
+//# sourceMappingURL=approve.js.map

package/dist/core/spec/approve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.js","sourceRoot":"","sources":["../../../src/core/spec/approve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAEL,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAGL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,UAAkB;IACvE,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAE3E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IACE,KAAK,KAAK,OAAO;YACjB,KAAK,KAAK,MAAM;YAChB,KAAK,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC;YAC/B,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,EAC9B,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,SAAS,UAAU,kBAAkB,QAAQ,EAAE,CAAC,CAAC;AACnE,CAAC;AAiBD,+EAA+E;AAC/E,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,KAA8B;QACxC,KAAK,CAAC,sBAAsB,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAWD,SAAS,KAAK,CAAC,KAAgC;IAC7C,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,UAAkB;IAC7C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO,cAAc,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,cAAsB,EACtB,MAAiB,EACjB,UAA0B,EAAE;IAE5B,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC;IAE7D,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3E,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,yBAAyB,UAAU,WAAW,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,sEAAsE;IACtE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC1E,IAAI,IAAI,GAA0B,OAAO,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IACxD,CAAC;IAED,0EAA0E;IAC1E,qEAAqE;IACrE,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE;QAC1D,SAAS,EAAE,MAAM,yBAAyB,CAAC,UAAU,CAAC;QACtD,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC1D,UAAU,EAAE,QAAQ;QACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ;QACpD,OAAO,EAAE,OAAO,CAAC,eAAe,IAAI,EAAE;KACvC,CAAC,CAAC;IACH,MAAM,sBAAsB,CAAC,UAAU,EAAE,YAAY,EAAE;QACrD,SAAS,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC;QAC1C,UAAU,EAAE,MAAM,wBAAwB,EAAE;KAC7C,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEhD,8EAA8E;IAC9E,gDAAgD;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC;IAEtD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE;QACpE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI;KACL,CAAC,CAAC;IACH,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEtC,OAAO;QACL,MAAM;QACN,UAAU;QACV,UAAU;QACV,IAAI;QACJ,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,eAAe,EAAE,YAAY,CAAC,MAAM;QACpC,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/core/spec/delta.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Deterministic OpenSpec delta merging.
+ *
+ * A delta spec is a capability-scoped markdown file using the OpenSpec
+ * operation headings `## ADDED Requirements`, `## MODIFIED Requirements`,
+ * `## REMOVED Requirements`, and `## RENAMED Requirements`. This module parses
+ * those documents and merges them into a living capability spec.
+ *
+ * The merge reproduces `openspec archive` byte for byte: requirement blocks are
+ * carried verbatim rather than re-serialized, section text the delta does not
+ * touch is preserved, and a new capability follows `## Purpose` with its body on
+ * the next line. Where OpenSpec can only warn, this module refuses with
+ * `DeltaMergeError`: a MODIFIED block that drops an existing scenario, an ADDED
+ * name that already exists with different content, a bare RENAMED entry, and an
+ * unmatched RENAMED, MODIFIED, or REMOVED target.
+ */
+export interface DeltaScenario {
+    readonly name: string;
+    readonly when: string[];
+    readonly then: string[];
+    readonly raw: string;
+}
+export interface DeltaRequirement {
+    readonly name: string;
+    readonly body: string;
+    readonly scenarios: DeltaScenario[];
+    readonly raw: string;
+}
+export interface DeltaRename {
+    readonly from: string;
+    readonly to: string;
+}
+export interface InvalidRename {
+    readonly line: string;
+}
+export interface UnpairedRename {
+    readonly side: 'FROM' | 'TO';
+    readonly name: string;
+}
+export interface ParsedDelta {
+    readonly title: string;
+    readonly purpose: string;
+    readonly added: DeltaRequirement[];
+    readonly modified: DeltaRequirement[];
+    readonly removed: DeltaRequirement[];
+    readonly renamed: DeltaRename[];
+    readonly invalidRenames: InvalidRename[];
+    readonly unpairedRenames: UnpairedRename[];
+}
+export interface CapabilitySpec {
+    readonly title: string;
+    readonly purpose: string;
+    readonly requirements: DeltaRequirement[];
+}
+export declare class DeltaMergeError extends Error {
+    constructor(message: string);
+}
+/** Strip an ATX closing run and surrounding whitespace from a requirement name. */
+export declare function normalizeRequirementName(name: string): string;
+/** Parse one `### Requirement:` block from its verbatim text. */
+export declare function parseRequirement(raw: string): DeltaRequirement;
+/** Parse one `#### Scenario:` block from its verbatim text. */
+export declare function parseScenario(raw: string): DeltaScenario;
+/** The body of a `## Purpose` section, or undefined when it is absent or empty. */
+export declare function extractPurposeSection(content: string): string | undefined;
+/** Parse a delta document into its operations and purpose. */
+export declare function parseDelta(content: string): ParsedDelta;
+/** Parse a living capability spec into its title, purpose, and requirements. */
+export declare function parseCapabilitySpec(content: string): CapabilitySpec;
+/** Serialize a capability spec back to the shape OpenSpec writes. */
+export declare function serializeCapabilitySpec(spec: CapabilitySpec): string;
+/**
+ * Merge a parsed delta into a base capability spec. When `baseContent` is null
+ * or empty, a new capability spec is created from the delta's Purpose.
+ */
+export declare function mergeDelta(baseContent: string | null, capability: string, delta: ParsedDelta): string;
+//# sourceMappingURL=delta.d.ts.map