@matteeh/osq 0.1.0 → 0.2.0

package/dist/core/spec/digest-flags.js

@@ -0,0 +1,194 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { CLAUDE_PLAN_COMMAND_PATH } from '../foundation/init-blocks.js';
+import { verifyStartsConflictFlags } from './digest-verify-starts.js';
+const SENSITIVE_KINDS = [
+    'package manifest',
+    'lockfile',
+    'CI workflow',
+    'osq config',
+    'OpenSpec config',
+    'managed instructions',
+    'env file',
+];
+const PACKAGE_MANIFEST_BASENAMES = new Set('package.json pnpm-workspace.yaml pyproject.toml Cargo.toml go.mod'.split(' '));
+const LOCKFILE_BASENAMES = new Set('pnpm-lock.yaml package-lock.json npm-shrinkwrap.json yarn.lock bun.lock bun.lockb poetry.lock uv.lock Cargo.lock go.sum'.split(' '));
+const OSQ_CONFIG_BASENAMES = new Set('osq.config.ts osq.config.js osq.config.mjs'.split(' '));
+const MANAGED_INSTRUCTION_BASENAMES = new Set('AGENTS.md PLANNER.md CLAUDE.md'.split(' '));
+const ENV_TEMPLATE_BASENAMES = new Set('.env.example .env.sample .env.template'.split(' '));
+const ENV_FILE_REGEX = /^\.env(?:\..+)?$/;
+const RUNNER_MARKERS = ['--test', 'vitest', 'jest', 'mocha', 'pytest', 'go test', 'cargo test'];
+const PACKAGE_RUNNER_REGEX = /\b(?:pnpm|npm|yarn|bun)\s+(?:run\s+)?(?:test|verify)\b/;
+function basename(relativePath) {
+    const index = relativePath.lastIndexOf('/');
+    return index === -1 ? relativePath : relativePath.slice(index + 1);
+}
+function compareText(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function compareTaskNumbers(a, b) {
+    const numA = Number.parseInt(a, 10);
+    const numB = Number.parseInt(b, 10);
+    if (!Number.isNaN(numA) && !Number.isNaN(numB) && numA !== numB)
+        return numA - numB;
+    return compareText(a, b);
+}
+function taskPhrase(numbers) {
+    const sorted = [...numbers].sort(compareTaskNumbers);
+    return sorted.length === 1 ? `task ${sorted[0]}` : `tasks ${sorted.join(', ')}`;
+}
+/** One flag per task pair sharing any resolved scope path. */
+function sharedFileFlags(tasks) {
+    const ordered = [...tasks].sort((a, b) => compareTaskNumbers(a.number, b.number));
+    const flags = [];
+    for (let left = 0; left < ordered.length; left += 1) {
+        for (let right = left + 1; right < ordered.length; right += 1) {
+            const first = ordered[left];
+            const second = ordered[right];
+            const other = new Set(second.paths);
+            const shared = first.paths.filter((entry) => other.has(entry)).sort(compareText);
+            if (shared.length === 0)
+                continue;
+            flags.push({
+                id: 'shared_file',
+                label: `shared files in tasks ${first.number} and ${second.number}`,
+                excerpt: `${shared.join(', ')}; the watcher will halt for recertification when task ${second.number} changes them`,
+            });
+        }
+    }
+    return flags;
+}
+/** The first sensitive kind a resolved path matches, or null. */
+function sensitiveKindOf(relativePath, openspecRoot) {
+    const name = basename(relativePath);
+    if (PACKAGE_MANIFEST_BASENAMES.has(name))
+        return 'package manifest';
+    if (LOCKFILE_BASENAMES.has(name))
+        return 'lockfile';
+    if (relativePath.startsWith('.github/workflows/') || relativePath === '.gitlab-ci.yml') {
+        return 'CI workflow';
+    }
+    if (OSQ_CONFIG_BASENAMES.has(name))
+        return 'osq config';
+    if (relativePath === `${openspecRoot}/config.yaml`)
+        return 'OpenSpec config';
+    const claudePath = CLAUDE_PLAN_COMMAND_PATH.split(path.sep).join('/');
+    if (MANAGED_INSTRUCTION_BASENAMES.has(name) ||
+        relativePath === claudePath ||
+        relativePath.startsWith('.opencode/agent/')) {
+        return 'managed instructions';
+    }
+    if (ENV_FILE_REGEX.test(name) && !ENV_TEMPLATE_BASENAMES.has(name))
+        return 'env file';
+    return null;
+}
+/** One flag per sensitive kind present, naming each path and its tasks. */
+function sensitivePathFlags(tasks, openspecRoot) {
+    const byKind = new Map();
+    for (const task of tasks) {
+        for (const relativePath of task.paths) {
+            const kind = sensitiveKindOf(relativePath, openspecRoot);
+            if (kind === null)
+                continue;
+            const paths = byKind.get(kind) ?? new Map();
+            const numbers = paths.get(relativePath) ?? new Set();
+            numbers.add(task.number);
+            paths.set(relativePath, numbers);
+            byKind.set(kind, paths);
+        }
+    }
+    const flags = [];
+    for (const kind of SENSITIVE_KINDS) {
+        const paths = byKind.get(kind);
+        if (!paths || paths.size === 0)
+            continue;
+        const excerpt = [...paths.entries()]
+            .sort((a, b) => compareText(a[0], b[0]))
+            .map(([relativePath, numbers]) => `${relativePath} in ${taskPhrase([...numbers])}`)
+            .join('; ');
+        flags.push({ id: 'sensitive_path', label: `${kind} in scope`, excerpt });
+    }
+    return flags;
+}
+/** True when a command names neither a test file nor a recognized runner. */
+function verifyLacksTest(command) {
+    const trimmed = command.trim();
+    if (trimmed === '')
+        return false;
+    if (trimmed.includes('.test.') || trimmed.includes('.spec.'))
+        return false;
+    if (/(?:^|[\s/])(?:tests?|__tests__)\//.test(trimmed))
+        return false;
+    if (RUNNER_MARKERS.some((marker) => trimmed.includes(marker)))
+        return false;
+    return !PACKAGE_RUNNER_REGEX.test(trimmed);
+}
+/** One flag per task and proposal verify that names no test file or runner. */
+function verifyWithoutTestFlags(tasks, proposalVerify) {
+    const ordered = [...tasks].sort((a, b) => compareTaskNumbers(a.number, b.number));
+    const flags = [];
+    for (const task of ordered) {
+        if (verifyLacksTest(task.verify)) {
+            flags.push({
+                id: 'verify_without_test',
+                label: `verify without a test in task ${task.number}`,
+                excerpt: task.verify,
+            });
+        }
+    }
+    if (verifyLacksTest(proposalVerify)) {
+        flags.push({
+            id: 'verify_without_test',
+            label: 'verify without a test in the proposal',
+            excerpt: proposalVerify,
+        });
+    }
+    return flags;
+}
+/** One flag per capability whose delta removes requirements. */
+function removedRequirementFlags(capabilities) {
+    return [...capabilities]
+        .filter((capability) => capability.removed.length > 0)
+        .sort((a, b) => compareText(a.name, b.name))
+        .map((capability) => ({
+        id: 'removed_requirement',
+        label: `removes ${capability.removed.length} requirements from ${capability.name}`,
+        excerpt: capability.removed.join(', '),
+    }));
+}
+/** One flag per delta capability whose living spec file does not exist. */
+async function unknownCapabilityFlags(input) {
+    const flags = [];
+    const ordered = [...input.capabilities].sort((a, b) => compareText(a.name, b.name));
+    for (const capability of ordered) {
+        const specPath = path.join(input.projectRoot, input.openspecRoot, 'specs', capability.name, 'spec.md');
+        const exists = await fs
+            .stat(specPath)
+            .then(() => true)
+            .catch(() => false);
+        if (!exists) {
+            flags.push({
+                id: 'unknown_capability',
+                label: `unknown capability ${capability.name}`,
+                excerpt: `no living spec at ${input.openspecRoot}/specs/${capability.name}/spec.md`,
+            });
+        }
+    }
+    return flags;
+}
+/** Build every approval flag in the fixed id order, then task-number or name order. */
+export async function buildApprovalFlags(input) {
+    const openspecRoot = input.openspecRoot
+        .replace(/\\/g, '/')
+        .replace(/^\.\/+/, '')
+        .replace(/\/+$/, '');
+    return [
+        ...sharedFileFlags(input.tasks),
+        ...sensitivePathFlags(input.tasks, openspecRoot),
+        ...verifyWithoutTestFlags(input.tasks, input.proposalVerify),
+        ...removedRequirementFlags(input.capabilities),
+        ...(await unknownCapabilityFlags(input)),
+        ...(await verifyStartsConflictFlags(input.projectRoot, input.tasks)),
+    ];
+}
+//# sourceMappingURL=digest-flags.js.map

package/dist/core/spec/digest-flags.js.map

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

package/dist/core/spec/digest-verify-starts.d.ts

@@ -0,0 +1,5 @@
+import type { ApprovalFlagTask } from './digest-flags.js';
+import type { ApprovalFlag } from './digest.js';
+/** One flag per task that declares `green` or `any` while creating its own named path. */
+export declare function verifyStartsConflictFlags(projectRoot: string, tasks: readonly ApprovalFlagTask[]): Promise<ApprovalFlag[]>;
+//# sourceMappingURL=digest-verify-starts.d.ts.map

package/dist/core/spec/digest-verify-starts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-verify-starts.d.ts","sourceRoot":"","sources":["../../../src/core/spec/digest-verify-starts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgBhD,0FAA0F;AAC1F,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,gBAAgB,EAAE,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB"}

package/dist/core/spec/digest-verify-starts.js

@@ -0,0 +1,31 @@
+import { analyzeVerifyStarts } from './verify-starts.js';
+/**
+ * Turns each verify start contradiction found by the shared rule in
+ * `verify-starts.ts` into one approval flag. Lint and the digest consume the
+ * same rule so their diagnostics agree.
+ */
+function compareTaskNumbers(a, b) {
+    const numA = Number.parseInt(a, 10);
+    const numB = Number.parseInt(b, 10);
+    if (!Number.isNaN(numA) && !Number.isNaN(numB) && numA !== numB)
+        return numA - numB;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/** One flag per task that declares `green` or `any` while creating its own named path. */
+export async function verifyStartsConflictFlags(projectRoot, tasks) {
+    const ruleTasks = tasks.map((task) => ({
+        taskNumber: task.number,
+        verify: task.verify,
+        verifyStarts: task.verifyStarts,
+        scope: task.scope,
+    }));
+    const report = await analyzeVerifyStarts(projectRoot, ruleTasks);
+    return [...report.contradictions]
+        .sort((a, b) => compareTaskNumbers(a.taskNumber, b.taskNumber) || (a.path < b.path ? -1 : 1))
+        .map((contradiction) => ({
+        id: 'verify_starts_conflict',
+        label: `verify starts conflict in task ${contradiction.taskNumber}`,
+        excerpt: `${contradiction.path} is named by the verify but created by this task, which declares verify_starts: ${contradiction.start}`,
+    }));
+}
+//# sourceMappingURL=digest-verify-starts.js.map

package/dist/core/spec/digest-verify-starts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-verify-starts.js","sourceRoot":"","sources":["../../../src/core/spec/digest-verify-starts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE/E;;;;GAIG;AAEH,SAAS,kBAAkB,CAAC,CAAS,EAAE,CAAS;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IACpF,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,KAAkC;IAElC,MAAM,SAAS,GAAsB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxD,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC;SAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC5F,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACvB,EAAE,EAAE,wBAAiC;QACrC,KAAK,EAAE,kCAAkC,aAAa,CAAC,UAAU,EAAE;QACnE,OAAO,EAAE,GAAG,aAAa,CAAC,IAAI,mFAAmF,aAAa,CAAC,KAAK,EAAE;KACvI,CAAC,CAAC,CAAC;AACR,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { OsqConfig } from '../foundation/config.js';
+/** Approval flag ids, in the fixed order their flags are emitted. */
+export type ApprovalFlagId = 'shared_file' | 'sensitive_path' | 'verify_without_test' | 'removed_requirement' | 'unknown_capability' | 'verify_starts_conflict';
+export interface ApprovalFlag {
+    readonly id: ApprovalFlagId;
+    readonly label: string;
+    readonly excerpt: string;
+}
+export interface ApprovalDigestTask {
+    readonly number: string;
+    readonly title: string;
+    readonly scopeFiles: number;
+    readonly testsModify: boolean;
+    readonly existingTests: readonly string[];
+}
+export interface ApprovalDigestCapability {
+    readonly name: string;
+    readonly added: readonly string[];
+    readonly modified: readonly string[];
+    readonly removed: readonly string[];
+}
+export interface ApprovalDigest {
+    readonly change: string;
+    readonly goal: string;
+    readonly tasks: readonly ApprovalDigestTask[];
+    readonly capabilities: readonly ApprovalDigestCapability[];
+    readonly humanSteps: string;
+    readonly flags: readonly ApprovalFlag[];
+}
+/** Collapse every whitespace run, including newlines, to one space. */
+export declare function collapseWhitespace(text: string): string;
+/** The first two sentences of a goal, whitespace-collapsed. */
+export declare function firstTwoSentences(goal: string): string;
+/** Summarize a change from its authored files into the approval digest. */
+export declare function buildApprovalDigest(projectRoot: string, changeFolder: string, config: OsqConfig): Promise<ApprovalDigest>;
+/** Render the digest body, without flags. */
+export declare function formatApprovalDigest(digest: ApprovalDigest): string;
+/** One `Flag: <label> — <excerpt>` line per flag. */
+export declare function formatApprovalFlags(flags: readonly ApprovalFlag[]): string[];
+/** `<n> flag(s): <label>, <label>`, or an empty string with no flags. */
+export declare function summarizeApprovalFlags(flags: readonly ApprovalFlag[]): string;
+//# sourceMappingURL=digest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../../src/core/spec/digest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAazD,qEAAqE;AACrE,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,gBAAgB,GAChB,qBAAqB,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CACzC;AA4BD,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOtD;AAmDD,2EAA2E;AAC3E,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,cAAc,CAAC,CA+CzB;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA0BnE;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAE5E;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAI7E"}

package/dist/core/spec/digest.js

@@ -0,0 +1,170 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveScope } from '../run/scope.js';
+import { parseDelta } from './delta.js';
+import { buildApprovalFlags } from './digest-flags.js';
+import { extractSection, parseFrontmatter, parseSpecMd, parseTaskMd, resolveChangeDoc, } from './parser.js';
+function compareText(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function compareTaskNumbers(a, b) {
+    const numA = Number.parseInt(a, 10);
+    const numB = Number.parseInt(b, 10);
+    if (!Number.isNaN(numA) && !Number.isNaN(numB) && numA !== numB)
+        return numA - numB;
+    return compareText(a, b);
+}
+/** Collapse every whitespace run, including newlines, to one space. */
+export function collapseWhitespace(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+/** The first two sentences of a goal, whitespace-collapsed. */
+export function firstTwoSentences(goal) {
+    const collapsed = collapseWhitespace(goal);
+    if (collapsed === '')
+        return '';
+    return collapsed
+        .split(/(?<=[.!?])\s+/)
+        .slice(0, 2)
+        .join(' ');
+}
+function isTestPath(relativePath) {
+    return relativePath === 'tests' || relativePath.startsWith('tests/');
+}
+async function resolveTasks(projectRoot, changeFolder) {
+    const tasksDir = path.join(changeFolder, 'tasks');
+    const files = (await fs.readdir(tasksDir).catch(() => []))
+        .filter((entry) => entry.endsWith('.md'))
+        .sort((a, b) => compareTaskNumbers(a.replace(/\.md$/, ''), b.replace(/\.md$/, '')));
+    const tasks = [];
+    for (const file of files) {
+        const content = await fs.readFile(path.join(tasksDir, file), 'utf8');
+        const task = parseTaskMd(content);
+        const entries = task.scope.length > 0 ? await resolveScope(projectRoot, task.scope) : [];
+        tasks.push({
+            number: file.replace(/\.md$/, ''),
+            title: task.title,
+            verify: task.verify,
+            verifyStarts: task.verifyStarts,
+            scope: task.scope,
+            testsModify: task.testsModify,
+            entries,
+        });
+    }
+    return tasks;
+}
+async function readCapabilities(changeFolder) {
+    const specsDir = path.join(changeFolder, 'specs');
+    let entries = [];
+    try {
+        entries = await fs.readdir(specsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const names = entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort(compareText);
+    const capabilities = [];
+    for (const name of names) {
+        const content = await fs
+            .readFile(path.join(specsDir, name, 'spec.md'), 'utf8')
+            .catch(() => null);
+        if (content !== null)
+            capabilities.push({ name, delta: parseDelta(content) });
+    }
+    return capabilities;
+}
+/** Summarize a change from its authored files into the approval digest. */
+export async function buildApprovalDigest(projectRoot, changeFolder, config) {
+    const resolvedDoc = await resolveChangeDoc(changeFolder);
+    const content = resolvedDoc ? await fs.readFile(resolvedDoc.path, 'utf8') : '';
+    const spec = parseSpecMd(content);
+    const body = resolvedDoc ? parseFrontmatter(content).body : '';
+    const tasks = await resolveTasks(projectRoot, changeFolder);
+    const changeCapabilities = await readCapabilities(changeFolder);
+    const capabilities = changeCapabilities.map(({ name, delta }) => ({
+        name,
+        added: delta.added.map((requirement) => requirement.name),
+        modified: delta.modified.map((requirement) => requirement.name),
+        removed: delta.removed.map((requirement) => requirement.name),
+    }));
+    const flagTasks = tasks.map((task) => ({
+        number: task.number,
+        verify: task.verify,
+        verifyStarts: task.verifyStarts,
+        scope: task.scope,
+        paths: task.entries.map((entry) => entry.relativePath),
+    }));
+    const flags = await buildApprovalFlags({
+        projectRoot,
+        openspecRoot: config.paths.openspecRoot,
+        proposalVerify: spec.verify,
+        tasks: flagTasks,
+        capabilities,
+    });
+    return {
+        change: path.basename(changeFolder),
+        goal: firstTwoSentences(spec.goal),
+        tasks: tasks.map((task) => {
+            const existing = task.entries.filter((entry) => entry.absolutePath !== null);
+            return {
+                number: task.number,
+                title: task.title,
+                scopeFiles: existing.length,
+                testsModify: task.testsModify,
+                existingTests: existing
+                    .map((entry) => entry.relativePath)
+                    .filter(isTestPath)
+                    .sort(compareText),
+            };
+        }),
+        capabilities,
+        humanSteps: extractSection(body, 'Human steps'),
+        flags,
+    };
+}
+/** Render the digest body, without flags. */
+export function formatApprovalDigest(digest) {
+    const lines = [`Change: ${digest.change}`];
+    if (digest.goal)
+        lines.push(`Goal: ${digest.goal}`);
+    lines.push('Tasks:');
+    for (const task of digest.tasks) {
+        const suffix = task.scopeFiles === 1 ? 'scope file' : 'scope files';
+        lines.push(`  ${task.number}. ${task.title} (${task.scopeFiles} ${suffix})`);
+        if (task.testsModify) {
+            const tests = task.existingTests.length > 0 ? task.existingTests.join(', ') : '(none)';
+            lines.push(`     tests.modify: existing tests in scope: ${tests}`);
+        }
+    }
+    lines.push('Capabilities:');
+    if (digest.capabilities.length === 0)
+        lines.push('  (none)');
+    for (const capability of digest.capabilities) {
+        lines.push(`  ${capability.name}:`);
+        for (const kind of ['added', 'modified', 'removed']) {
+            const names = capability[kind];
+            lines.push(`    ${kind}: ${names.length > 0 ? names.join(', ') : '(none)'}`);
+        }
+    }
+    if (digest.humanSteps) {
+        lines.push('Human steps:');
+        for (const line of digest.humanSteps.split('\n'))
+            lines.push(`  ${line.trim()}`);
+    }
+    return lines.join('\n');
+}
+/** One `Flag: <label> — <excerpt>` line per flag. */
+export function formatApprovalFlags(flags) {
+    return flags.map((flag) => `Flag: ${flag.label} \u2014 ${flag.excerpt}`);
+}
+/** `<n> flag(s): <label>, <label>`, or an empty string with no flags. */
+export function summarizeApprovalFlags(flags) {
+    if (flags.length === 0)
+        return '';
+    const labels = flags.map((flag) => flag.label).join(', ');
+    return `${flags.length} flag${flags.length === 1 ? '' : 's'}: ${labels}`;
+}
+//# sourceMappingURL=digest.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * The single root-relative exclusion predicate shared by hashing and linting.
+ * `relPath` is a project-folder-relative POSIX path such as `.run/done/1` or
+ * `plan-prompt.md`. Nested runtime directories stay excluded, but a transient
+ * file is only transient at the change folder root.
+ */
+export declare function isExcludedChangePath(relPath: string): boolean;
+export declare function normalizeTasksMd(content: string): string;
+export declare function hashChangeFolder(folderPath: string): Promise<string>;
+export declare function verifyFolderHash(folderPath: string, expectedHash: string): Promise<boolean>;
+//# sourceMappingURL=hasher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../../src/core/spec/hasher.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM7D;AAwBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB1E;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjG"}

package/dist/core/{hasher.js → spec/hasher.js}

@@ -1,20 +1,44 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs/promises';
 import path from 'node:path';
+/**
+ * Directory or metadata names excluded from every authored-content view of a
+ * change folder, at any depth. These mirror the runtime state the engine owns
+ * rather than the author's specification.
+ */
+const CHANGE_FOLDER_EXCLUDED_SEGMENTS = new Set(['.run', '.git', '.DS_Store']);
+/**
+ * Transient files owned by the engine at a change folder's root only. A nested
+ * file with the same name is authored content and stays covered.
+ */
+const CHANGE_FOLDER_TRANSIENT_FILES = new Set(['plan-prompt.md']);
+/**
+ * The single root-relative exclusion predicate shared by hashing and linting.
+ * `relPath` is a project-folder-relative POSIX path such as `.run/done/1` or
+ * `plan-prompt.md`. Nested runtime directories stay excluded, but a transient
+ * file is only transient at the change folder root.
+ */
+export function isExcludedChangePath(relPath) {
+    const normalized = relPath.replace(/\\/g, '/');
+    if (CHANGE_FOLDER_TRANSIENT_FILES.has(normalized)) {
+        return true;
+    }
+    return normalized.split('/').some((segment) => CHANGE_FOLDER_EXCLUDED_SEGMENTS.has(segment));
+}
 async function collectFiles(dir, baseDir) {
     const entries = await fs.readdir(dir, { withFileTypes: true });
     const files = [];
     for (const entry of entries) {
-        if (entry.name === '.run' || entry.name === '.git' || entry.name === '.DS_Store') {
+        const fullPath = path.join(dir, entry.name);
+        const relPath = path.relative(baseDir, fullPath).replace(/\\/g, '/');
+        if (isExcludedChangePath(relPath)) {
             continue;
         }
-        const fullPath = path.join(dir, entry.name);
         if (entry.isDirectory()) {
             const nested = await collectFiles(fullPath, baseDir);
             files.push(...nested);
         }
         else if (entry.isFile()) {
-            const relPath = path.relative(baseDir, fullPath).replace(/\\/g, '/');
             files.push(relPath);
         }
     }

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

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

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

@@ -0,0 +1,79 @@
+import type { OsqConfig } from '../foundation/config.js';
+import { OPENSPEC_EXPECTED_VERSION } from './openspec-version.js';
+export { OPENSPEC_EXPECTED_VERSION };
+/** Prefix applied to every finding surfaced by the OpenSpec validator. */
+export declare const OPENSPEC_ERROR_PREFIX = "openspec:";
+export interface LintLogger {
+    info(msg: string): void;
+    verbose(msg: string): void;
+    warn(msg: string): void;
+}
+/**
+ * The outcome of analyzing one verify command. Every field is derived without
+ * executing or shell-expanding the command.
+ */
+export interface VerifyCommandAnalysis {
+    /** The command is the template sentinel or a normalized equivalent. */
+    readonly placeholder: boolean;
+    /** The recognized package script name, when the command invokes one. */
+    readonly packageScript: string | null;
+    /** The recognized package script name that the root manifest lacks. */
+    readonly missingScript: string | null;
+    /** No existing repository path and no recognized package script was named. */
+    readonly unresolved: boolean;
+}
+/**
+ * Analyze one verify command read-only: detect the template sentinel, resolve a
+ * recognized package script against the root manifest, or fall back to an
+ * unresolved-target warning when no existing path or script is named.
+ */
+export declare function analyzeVerifyCommand(projectRoot: string, command: string, packageScripts: ReadonlySet<string>): Promise<VerifyCommandAnalysis>;
+export interface LintResult {
+    readonly valid: boolean;
+    readonly errors: string[];
+    readonly warnings: string[];
+}
+export interface LintOptions {
+    readonly logger?: LintLogger;
+}
+export interface OpenSpecFindings {
+    readonly errors: string[];
+    readonly warnings: string[];
+}
+export interface OpenSpecValidationOutcome extends OpenSpecFindings {
+    readonly ran: boolean;
+    readonly bin: string | null;
+    readonly version: string | null;
+}
+/**
+ * Resolves the project-local OpenSpec binary. Only a binary inside the
+ * project's own `node_modules/.bin` (or an explicitly configured absolute
+ * path) is used; missing installs resolve to `null` so linting degrades
+ * gracefully rather than failing on projects without OpenSpec.
+ */
+export declare function resolveOpenSpecBin(projectRoot: string, config: OsqConfig): Promise<string | null>;
+/** Reads the resolved `@fission-ai/openspec` version from the local install. */
+export declare function resolveOpenSpecVersion(projectRoot: string): Promise<string | null>;
+/**
+ * Tolerantly extracts validation findings from `openspec validate --json`.
+ * Accepts a top-level array or an object exposing `issues`/`errors`/`warnings`
+ * (or similar) and classifies each finding by its error/warning severity.
+ */
+export declare function parseOpenSpecFindings(output: string): OpenSpecFindings;
+/**
+ * Runs the local OpenSpec validator for changes and specs. Validation failures
+ * are returned prefixed with `openspec:`. A missing binary or a version outside
+ * the declared peer range is an error that cites ADR 004 and the install
+ * command; a version inside the range that differs from the pin warns and cites
+ * ADR 005. Linting fails closed rather than silently degrading.
+ */
+export declare function validateWithOpenSpec(projectRoot: string, config: OsqConfig, options?: LintOptions): Promise<OpenSpecValidationOutcome>;
+/**
+ * Verifies that every delta operation targeting a requirement resolves against
+ * the living base spec at `openspec/specs/<capability>/spec.md`. Applying the
+ * delta through the deterministic merge engine reports unmatched MODIFIED,
+ * REMOVED, or RENAMED targets; ADDED-only deltas may create a new capability.
+ */
+export declare function verifyDeltaTargets(projectRoot: string, folderPath: string, config: OsqConfig): Promise<string[]>;
+export declare function lintChangeFolder(projectRoot: string, folderPath: string, config: OsqConfig, options?: LintOptions): Promise<LintResult>;
+//# sourceMappingURL=linter.d.ts.map