@matteeh/osq 0.1.0 → 0.2.1

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

@@ -0,0 +1,89 @@
+/**
+ * Capability name resemblance and living-capability discovery for the approval
+ * digest. A new capability resembles a living one when their names are equal
+ * once hyphens and underscores are removed, when one name's words all appear
+ * among the other's, or when both are long enough and their edit distance is
+ * small.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const MIN_EDIT_DISTANCE_LENGTH = 5;
+const MAX_EDIT_DISTANCE = 2;
+function compareText(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/** Words of a name, split on hyphens and underscores. */
+function words(name) {
+    return name.split(/[-_]+/).filter((word) => word !== '');
+}
+function stripSeparators(name) {
+    return name.replace(/[-_]/g, '');
+}
+function isSubset(a, b) {
+    const other = new Set(b);
+    return a.every((word) => other.has(word));
+}
+/** Levenshtein edit distance between two names. */
+function editDistance(a, b) {
+    const previous = [];
+    for (let j = 0; j <= b.length; j += 1)
+        previous.push(j);
+    for (let i = 1; i <= a.length; i += 1) {
+        let diagonal = previous[0];
+        previous[0] = i;
+        for (let j = 1; j <= b.length; j += 1) {
+            const saved = previous[j];
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            previous[j] = Math.min(previous[j] + 1, previous[j - 1] + 1, diagonal + cost);
+            diagonal = saved;
+        }
+    }
+    return previous[b.length];
+}
+/** True when two capability names resemble each other. */
+export function namesResemble(name, other) {
+    if (stripSeparators(name) === stripSeparators(other))
+        return true;
+    const nameWords = words(name);
+    const otherWords = words(other);
+    if (nameWords.length > 0 && otherWords.length > 0) {
+        if (isSubset(nameWords, otherWords) || isSubset(otherWords, nameWords))
+            return true;
+    }
+    if (name.length >= MIN_EDIT_DISTANCE_LENGTH && other.length >= MIN_EDIT_DISTANCE_LENGTH) {
+        return editDistance(name, other) <= MAX_EDIT_DISTANCE;
+    }
+    return false;
+}
+/** The first living name, in name order, that `name` resembles, or null. */
+export function resemblingCapability(name, living) {
+    const ordered = [...living].sort(compareText);
+    return ordered.find((candidate) => namesResemble(name, candidate)) ?? null;
+}
+/**
+ * Living capability names: the directories under `<openspecRoot>/specs` that
+ * hold a `spec.md`, in name order.
+ */
+export async function readLivingCapabilityNames(projectRoot, openspecRoot) {
+    const specsDir = path.join(projectRoot, openspecRoot, 'specs');
+    let entries = [];
+    try {
+        entries = await fs.readdir(specsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const names = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const exists = await fs
+            .stat(path.join(specsDir, entry.name, 'spec.md'))
+            .then(() => true)
+            .catch(() => false);
+        if (exists)
+            names.push(entry.name);
+    }
+    return names.sort(compareText);
+}
+//# sourceMappingURL=digest-capability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest-capability.js","sourceRoot":"","sources":["../../../src/core/spec/digest-capability.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,wBAAwB,GAAG,CAAC,CAAC;AACnC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,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,yDAAyD;AACzD,SAAS,KAAK,CAAC,IAAY;IACzB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,QAAQ,CAAC,CAAoB,EAAE,CAAoB;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,mDAAmD;AACnD,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3B,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;YAC9E,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa;IACvD,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;IACtF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,wBAAwB,IAAI,KAAK,CAAC,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACxF,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,iBAAiB,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAAyB;IAC1E,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,YAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAC/D,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,MAAM,GAAG,MAAM,EAAE;aACpB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;aAChD,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { ApprovalDigestCapability, ApprovalFlag } from './digest.js';
+import type { VerifyStarts } from './parser.js';
+/** One task projection: identity, verify, declared scope, and resolved scope paths. */
+export interface ApprovalFlagTask {
+    readonly number: string;
+    readonly verify: string;
+    readonly verifyStarts: VerifyStarts;
+    readonly scope: readonly string[];
+    readonly paths: readonly string[];
+}
+/** Everything the flag rules need from the digested change and its project. */
+export interface ApprovalFlagInput {
+    readonly projectRoot: string;
+    readonly openspecRoot: string;
+    readonly proposalVerify: string;
+    readonly tasks: readonly ApprovalFlagTask[];
+    readonly capabilities: readonly ApprovalDigestCapability[];
+    readonly livingCapabilities: readonly string[];
+}
+/** Build every approval flag in the fixed id order, then task-number or name order. */
+export declare function buildApprovalFlags(input: ApprovalFlagInput): Promise<ApprovalFlag[]>;
+//# sourceMappingURL=digest-flags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest-flags.d.ts","sourceRoot":"","sources":["../../../src/core/spec/digest-flags.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAgMD,uFAAuF;AACvF,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAa1F"}

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

@@ -0,0 +1,194 @@
+import path from 'node:path';
+import { CLAUDE_PLAN_COMMAND_PATH } from '../foundation/init-blocks.js';
+import { resemblingCapability } from './digest-capability.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 that has no living spec and is not deliberately created. */
+function unknownCapabilityFlags(input) {
+    const flags = [];
+    const living = input.livingCapabilities;
+    const ordered = [...input.capabilities].sort((a, b) => compareText(a.name, b.name));
+    for (const capability of ordered) {
+        if (living.includes(capability.name) || capability.creates)
+            continue;
+        const resembles = resemblingCapability(capability.name, living);
+        const label = resembles === null
+            ? `unknown capability ${capability.name} without a Purpose`
+            : `unknown capability ${capability.name} resembles ${resembles}`;
+        flags.push({
+            id: 'unknown_capability',
+            label,
+            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),
+        ...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,43 @@
+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[];
+    readonly creates: boolean;
+}
+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;AAczD,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;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;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,CAmDzB;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA2BnE;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,175 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveScope } from '../run/scope.js';
+import { parseDelta } from './delta.js';
+import { readLivingCapabilityNames, resemblingCapability } from './digest-capability.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 living = await readLivingCapabilityNames(projectRoot, config.paths.openspecRoot);
+    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),
+        creates: !living.includes(name) && delta.purpose !== '' && resemblingCapability(name, living) === null,
+    }));
+    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,
+        livingCapabilities: living,
+    });
+    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) {
+        const creation = capability.creates ? ' (new capability)' : '';
+        lines.push(`  ${capability.name}${creation}:`);
+        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"}