@matteeh/osq 0.2.1 → 0.2.2

package/dist/core/spec/approve.js

@@ -2,12 +2,15 @@ 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 { findUnpricedPlanningModels } from '../report/planning-price-gaps.js';
+import { resolveOsqPackageVersion } from '../report/planning.js';
+import { findChange } from '../status/change-locations.js';
+import { selectVcs } from '../vcs/select.js';
+import { confirmApproval, readBriefHash, toIso, writeApprovalSeal, } from './approve-worktree-shared.js';
+import { approveIntoWorktree } from './approve-worktree.js';
 import { hashChangeFolder } from './hasher.js';
 import { lintChangeFolder } from './linter.js';
+export { ApprovalDeclinedError } from './approve-worktree-shared.js';
 export async function findSpecFolder(specsDir, idOrPrefix) {
     let entries = [];
     try {
@@ -33,46 +36,10 @@ export async function findSpecFolder(specsDir, idOrPrefix) {
     }
     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';
-    }
+/** The pre-worktree path: seal and observe inside the checkout's folder. */
+async function approveInPlace(projectRoot, input) {
+    const { specId, folderName, folderPath, specsDir, config, options, warnings } = input;
+    const { digest, mode } = await confirmApproval(projectRoot, folderPath, config, options);
     // 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, {
@@ -86,26 +53,62 @@ export async function approveSpec(projectRoot, specIdOrPrefix, config, options =
         briefHash: await readBriefHash(folderPath),
         osqVersion: await resolveOsqPackageVersion(),
     });
+    // Price gaps are read after observation so a session found at approval is
+    // named too. Approval itself is unaffected.
+    const missingPrices = await findUnpricedPlanningModels([folderPath], config.planning?.prices);
     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);
+    await writeApprovalSeal(projectRoot, folderPath, config, digest, mode, hash);
     return {
         specId,
         folderName,
         folderPath,
         hash,
-        warnings: lintResult.warnings,
+        warnings,
         planningMatches: observations.length,
+        missingPrices,
         digest,
     };
 }
+/**
+ * Approve one change. Lint always runs in the checkout. With `vcs.enabled` and
+ * git selected, the seal and commit go to a linked worktree and the checkout
+ * is left untouched; otherwise approval writes in place as before.
+ */
+export async function approveSpec(projectRoot, specIdOrPrefix, config, options = {}) {
+    const change = await findChange(projectRoot, config, specIdOrPrefix);
+    const folderPath = change.folderPath;
+    const specsDir = change.tree.changesDir;
+    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  - ')}`);
+    }
+    if (config.vcs?.enabled === true) {
+        const vcs = await selectVcs(projectRoot, config);
+        if (vcs.kind === 'git') {
+            return approveIntoWorktree(projectRoot, {
+                specId,
+                folderName,
+                folderPath,
+                specsDir,
+                config,
+                options,
+                vcs,
+                warnings: lintResult.warnings,
+            });
+        }
+    }
+    return approveInPlace(projectRoot, {
+        specId,
+        folderName,
+        folderPath,
+        specsDir,
+        config,
+        options,
+        warnings: lintResult.warnings,
+    });
+}
 //# sourceMappingURL=approve.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"approve.js","sourceRoot":"","sources":["../../../src/core/spec/approve.ts"],"names":[],"mappings":"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"}
+{"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,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAEL,eAAe,EACf,aAAa,EACb,KAAK,EACL,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,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;AAyCD,4EAA4E;AAC5E,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,KAAsB;IACvE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACtF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzF,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,0EAA0E;IAC1E,4CAA4C;IAC5C,MAAM,aAAa,GAAG,MAAM,0BAA0B,CAAC,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9F,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEhD,8EAA8E;IAC9E,gDAAgD;IAChD,MAAM,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAE7E,OAAO;QACL,MAAM;QACN,UAAU;QACV,UAAU;QACV,IAAI;QACJ,QAAQ;QACR,eAAe,EAAE,YAAY,CAAC,MAAM;QACpC,aAAa;QACb,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,cAAsB,EACtB,MAAiB,EACjB,UAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;IACxC,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,IAAI,MAAM,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACvB,OAAO,mBAAmB,CAAC,WAAW,EAAE;gBACtC,MAAM;gBACN,UAAU;gBACV,UAAU;gBACV,QAAQ;gBACR,MAAM;gBACN,OAAO;gBACP,GAAG;gBACH,QAAQ,EAAE,UAAU,CAAC,QAAQ;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,cAAc,CAAC,WAAW,EAAE;QACjC,MAAM;QACN,UAAU;QACV,UAAU;QACV,QAAQ;QACR,MAAM;QACN,OAAO;QACP,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAC,CAAC;AACL,CAAC"}

package/dist/core/spec/capability-impact.d.ts

@@ -0,0 +1,43 @@
+import { type LintFinding } from './lint-findings.js';
+/**
+ * The capability half of impact lint: a scoped file that imports code owned by
+ * a capability the proposal neither reads nor writes, and a resolved scope path
+ * owned by no capability with a delta. Both never affect validity.
+ */
+/** One living capability's declared Code ownership globs. */
+export interface CapabilityOwnership {
+    readonly capability: string;
+    readonly globs: readonly string[];
+}
+/** Read every living spec's Code ownership globs, in capability name order. */
+export declare function readCapabilityOwnership(projectRoot: string, openspecRoot: string): Promise<CapabilityOwnership[]>;
+/** Capabilities whose Code ownership globs cover one path, sorted by name. */
+export declare function ownerCapabilities(ownerships: readonly CapabilityOwnership[], relativePath: string): string[];
+/** One task's resolved write surface for the write-without-delta check. */
+export interface CapabilityWriteTask {
+    readonly taskNumber: string;
+    readonly taskPath: string;
+    readonly existingPaths: readonly string[];
+}
+/**
+ * Warn once per resolved scope path owned by capabilities none of which has a
+ * delta in the change. Paths no living spec owns are left alone.
+ */
+export declare function writeWithoutDeltaFindings(tasks: readonly CapabilityWriteTask[], ownerships: readonly CapabilityOwnership[], deltaCapabilities: ReadonlySet<string>): LintFinding[];
+/** The direct imports a capability read check reads, plus what counts as declared. */
+export interface CapabilityReadInput {
+    readonly proposalPath: string;
+    readonly scopedFiles: readonly string[];
+    readonly importsOf: (file: string) => readonly string[];
+    readonly filesInScope: ReadonlySet<string>;
+    readonly ownerships: readonly CapabilityOwnership[];
+    /** Capability names in `features.reads` or with a delta in the change. */
+    readonly declared: ReadonlySet<string>;
+}
+/**
+ * Warn once per capability owning code a scoped file imports directly, when no
+ * owner of the imported file is read or has a delta and the file is out of every
+ * task's scope.
+ */
+export declare function undeclaredReadFindings(input: CapabilityReadInput): LintFinding[];
+//# sourceMappingURL=capability-impact.d.ts.map

package/dist/core/spec/capability-impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-impact.d.ts","sourceRoot":"","sources":["../../../src/core/spec/capability-impact.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,oBAAoB,CAAC;AAGnE;;;;GAIG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,+EAA+E;AAC/E,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAwBhC;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAKV;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,WAAW,EAAE,CAmBf;AAED,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,WAAW,EAAE,CA2BhF"}

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

@@ -0,0 +1,85 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { scopeCoversPath } from '../run/scope.js';
+import { getSpecsDir } from '../status/layout.js';
+import { makeFinding } from './lint-findings.js';
+import { parseCodeOwnership } from './parser.js';
+/** Read every living spec's Code ownership globs, in capability name order. */
+export async function readCapabilityOwnership(projectRoot, openspecRoot) {
+    const specsDir = getSpecsDir(openspecRoot, projectRoot);
+    let entries;
+    try {
+        entries = await fs.readdir(specsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const ownerships = [];
+    const directories = entries
+        .filter((entry) => entry.isDirectory())
+        .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    for (const entry of directories) {
+        const content = await fs
+            .readFile(path.join(specsDir, entry.name, 'spec.md'), 'utf8')
+            .catch(() => null);
+        if (content === null)
+            continue;
+        const globs = parseCodeOwnership(content);
+        if (globs.length > 0)
+            ownerships.push({ capability: entry.name, globs });
+    }
+    return ownerships;
+}
+/** Capabilities whose Code ownership globs cover one path, sorted by name. */
+export function ownerCapabilities(ownerships, relativePath) {
+    return ownerships
+        .filter((entry) => scopeCoversPath(entry.globs, relativePath))
+        .map((entry) => entry.capability)
+        .sort();
+}
+/**
+ * Warn once per resolved scope path owned by capabilities none of which has a
+ * delta in the change. Paths no living spec owns are left alone.
+ */
+export function writeWithoutDeltaFindings(tasks, ownerships, deltaCapabilities) {
+    const findings = [];
+    for (const task of tasks) {
+        for (const scopePath of task.existingPaths) {
+            const owners = ownerCapabilities(ownerships, scopePath);
+            if (owners.length === 0)
+                continue;
+            if (owners.some((owner) => deltaCapabilities.has(owner)))
+                continue;
+            findings.push(makeFinding('warning', { file: task.taskPath }, `${scopePath} is owned by ${owners.join(', ')}, which has no delta in this change. Add a delta or move the file out of scope`));
+        }
+    }
+    return findings;
+}
+/**
+ * Warn once per capability owning code a scoped file imports directly, when no
+ * owner of the imported file is read or has a delta and the file is out of every
+ * task's scope.
+ */
+export function undeclaredReadFindings(input) {
+    const importersByCapability = new Map();
+    for (const scoped of input.scopedFiles) {
+        for (const imported of input.importsOf(scoped)) {
+            if (input.filesInScope.has(imported))
+                continue;
+            const owners = ownerCapabilities(input.ownerships, imported);
+            if (owners.length === 0)
+                continue;
+            if (owners.some((owner) => input.declared.has(owner)))
+                continue;
+            for (const owner of owners) {
+                const importers = importersByCapability.get(owner) ?? new Set();
+                importers.add(scoped);
+                importersByCapability.set(owner, importers);
+            }
+        }
+    }
+    return [...importersByCapability.entries()]
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+        .map(([capability, importers]) => makeFinding('warning', { file: input.proposalPath }, `Scoped files import code owned by the ${capability} capability: ${[...importers].sort().join(', ')}. Add ${capability} to features.reads`));
+}
+//# sourceMappingURL=capability-impact.js.map

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

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

package/dist/core/spec/decisions-lint.d.ts

@@ -0,0 +1,18 @@
+import type { OsqConfig } from '../foundation/config.js';
+import { type LintFinding } from './lint-findings.js';
+export interface DecisionsLintInput {
+    readonly projectRoot: string;
+    readonly folderPath: string;
+    /** Repository-relative `proposal.md`; the change document's own findings. */
+    readonly proposalPath: string;
+    /** The proposal body with frontmatter stripped. */
+    readonly proposalBody: string;
+    readonly config: OsqConfig;
+}
+/**
+ * Checks a proposal's Decisions section and, when the project has ADRs, the
+ * AGENTS.md project rules block. Returns the change's own findings; a project
+ * whose decisions folder holds no ADR with osq frontmatter returns none.
+ */
+export declare function collectDecisionsFindings(input: DecisionsLintInput): Promise<LintFinding[]>;
+//# sourceMappingURL=decisions-lint.d.ts.map

package/dist/core/spec/decisions-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions-lint.d.ts","sourceRoot":"","sources":["../../../src/core/spec/decisions-lint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,oBAAoB,CAAC;AAiBnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAqHD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA2BhG"}

package/dist/core/spec/decisions-lint.js

@@ -0,0 +1,127 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readDecisions, sameAdrNumber } from '../foundation/decisions.js';
+import { checkProjectRules } from '../foundation/rules-block.js';
+import { makeFinding } from './lint-findings.js';
+/**
+ * Decisions lint: the proposal's `## Decisions` section and the AGENTS.md
+ * project rules block, checked only when the project has at least one ADR with
+ * osq frontmatter. A project without ADRs returns no findings.
+ */
+/** HTML comments are structural scaffolding, not declared decision text. */
+const HTML_COMMENT_REGEX = /<!--[\s\S]*?-->/g;
+/** An `ADR <n>` mention anywhere in the section; a departure line names its ADR. */
+const ADR_MENTION_REGEX = /\bADR\s+(\d+)/g;
+const MISSING_SECTION_ERROR = 'proposal.md needs a ## Decisions section: name each accepted ADR that governs a capability this change writes, or write None';
+/**
+ * Reads a proposal body's `## <heading>` section content. The heading must
+ * occupy its own line; a mention inside prose does not count. Returns `null`
+ * when the section is absent.
+ */
+function readSection(body, heading) {
+    const match = new RegExp(`^##\\s+${heading}\\s*$`, 'm').exec(body);
+    if (!match) {
+        return null;
+    }
+    const rest = body.slice(match.index + match[0].length);
+    const boundary = rest.search(/\n##(?!#)\s/);
+    return boundary === -1 ? rest : rest.slice(0, boundary);
+}
+/** True when a section holds only HTML comments and whitespace. */
+function sectionIsBlank(section) {
+    return section.replace(HTML_COMMENT_REGEX, '').trim().length === 0;
+}
+/** True when `target` exists as a regular file. */
+async function fileExists(target) {
+    return fs
+        .stat(target)
+        .then((stat) => stat.isFile())
+        .catch(() => false);
+}
+/** Capability names whose directory under the change's `specs/` holds `spec.md`. */
+async function readWrittenCapabilities(folderPath) {
+    let entries;
+    try {
+        entries = await fs.readdir(path.join(folderPath, 'specs'), { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const capabilities = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        if (await fileExists(path.join(folderPath, 'specs', entry.name, 'spec.md'))) {
+            capabilities.push(entry.name);
+        }
+    }
+    return capabilities.sort();
+}
+/** The distinct ADR numbers named anywhere in a Decisions section, in order. */
+function mentionedAdrNumbers(section) {
+    const numbers = [];
+    for (const match of section.matchAll(ADR_MENTION_REGEX)) {
+        if (!numbers.some((number) => sameAdrNumber(number, match[1]))) {
+            numbers.push(match[1]);
+        }
+    }
+    return numbers;
+}
+/** One error per governing capability ADR the section leaves unnamed. */
+function unnamedAdrFindings(section, adrs, written, proposalPath) {
+    const mentioned = mentionedAdrNumbers(section);
+    const findings = [];
+    for (const adr of adrs) {
+        const applies = adr.appliesTo;
+        if (adr.status !== 'accepted' || applies === null || applies === 'all') {
+            continue;
+        }
+        const capability = written.find((name) => applies.includes(name));
+        if (capability === undefined) {
+            continue;
+        }
+        if (mentioned.some((number) => sameAdrNumber(number, adr.number))) {
+            continue;
+        }
+        findings.push(makeFinding('error', { file: proposalPath, section: 'Decisions' }, `proposal.md ## Decisions does not name ADR ${adr.number}, which applies to ${capability}`));
+    }
+    return findings;
+}
+/** One warning per named ADR number that doesn't exist or isn't accepted. */
+function unknownAdrFindings(section, adrs, proposalPath) {
+    const findings = [];
+    for (const number of mentionedAdrNumbers(section)) {
+        const adr = adrs.find((entry) => sameAdrNumber(entry.number, number));
+        if (adr !== undefined && adr.status === 'accepted') {
+            continue;
+        }
+        findings.push(makeFinding('warning', { file: proposalPath, section: 'Decisions' }, `proposal.md ## Decisions names ADR ${number}, which does not exist or is not accepted`));
+    }
+    return findings;
+}
+/**
+ * Checks a proposal's Decisions section and, when the project has ADRs, the
+ * AGENTS.md project rules block. Returns the change's own findings; a project
+ * whose decisions folder holds no ADR with osq frontmatter returns none.
+ */
+export async function collectDecisionsFindings(input) {
+    const records = await readDecisions(input.projectRoot, input.config);
+    if (records.adrs.length === 0) {
+        return [];
+    }
+    const findings = [];
+    for (const message of await checkProjectRules(input.projectRoot, input.config)) {
+        findings.push(makeFinding('error', { file: 'AGENTS.md' }, message));
+    }
+    const section = readSection(input.proposalBody, 'Decisions');
+    if (section === null || sectionIsBlank(section)) {
+        findings.push(makeFinding('error', { file: input.proposalPath, section: 'Decisions' }, MISSING_SECTION_ERROR));
+        return findings;
+    }
+    const written = await readWrittenCapabilities(input.folderPath);
+    findings.push(...unnamedAdrFindings(section, records.adrs, written, input.proposalPath));
+    findings.push(...unknownAdrFindings(section, records.adrs, input.proposalPath));
+    return findings;
+}
+//# sourceMappingURL=decisions-lint.js.map

package/dist/core/spec/decisions-lint.js.map

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

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

@@ -14,10 +14,16 @@
  * name that already exists with different content, a bare RENAMED entry, and an
  * unmatched RENAMED, MODIFIED, or REMOVED target.
  */
+/** One THEN or AND assertion, with the table directly under it when present. */
+export interface ScenarioOutcome {
+    readonly text: string;
+    readonly rows?: readonly Record<string, string>[];
+}
 export interface DeltaScenario {
     readonly name: string;
     readonly when: string[];
     readonly then: string[];
+    readonly outcomes: readonly ScenarioOutcome[];
     readonly raw: string;
 }
 export interface DeltaRequirement {

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

@@ -1 +1 @@
-{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../../src/core/spec/delta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAcH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAC3C;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAwBD,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AA4DD,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAE9D;AAWD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAuBxD;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBzE;AAuPD,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAqBvD;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAUnE;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAUpE;AAyND;;;GAGG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,GACjB,MAAM,CAgCR"}
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../../src/core/spec/delta.ts"],"names":[],"mappings":"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"}

package/dist/core/spec/delta.js

@@ -22,6 +22,11 @@ const RENAME_FROM_REGEX = /^\s*[-*+]?\s*FROM:\s*`?###\s*Requirement:\s*(.+?)`?\s
 const RENAME_TO_REGEX = /^\s*[-*+]?\s*TO:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/;
 const ANY_RENAME_REGEX = /^\s*[-*+]?\s*(FROM|TO):\s*(.*)$/i;
 const REMOVED_BULLET_REGEX = /^\s*[-*+]\s*`?###\s*Requirement:\s*(.+?)`?\s*$/;
+const WHEN_BULLET_REGEX = /^-[ \t]+\*\*WHEN\*\*[ \t]*(.*)$/;
+const THEN_BULLET_REGEX = /^-[ \t]+\*\*THEN\*\*[ \t]*(.*)$/;
+const AND_BULLET_REGEX = /^-[ \t]+\*\*AND\*\*[ \t]*(.*)$/;
+const TABLE_ROW_REGEX = /^\s*\|.*\|\s*$/;
+const TABLE_SEPARATOR_CELL_REGEX = /^:?-+:?$/;
 const PURPOSE_PLACEHOLDER_PREFIX = 'TBD - created by archiving change ';
 const PURPOSE_PLACEHOLDER_SUFFIX = '. Update Purpose after archive.';
 export class DeltaMergeError extends Error {
@@ -111,18 +116,81 @@ export function parseScenario(raw) {
     const name = scenarioNameAt(lines[0]);
     const when = [];
     const then = [];
-    for (const line of lines.slice(1)) {
-        const whenMatch = line.match(/^-[ \t]+\*\*WHEN\*\*[ \t]*(.*)$/);
+    const outcomes = [];
+    let thenSeen = false;
+    for (let index = 1; index < lines.length; index++) {
+        const line = lines[index];
+        const whenMatch = line.match(WHEN_BULLET_REGEX);
         if (whenMatch) {
             when.push(whenMatch[1].trim());
+            thenSeen = false;
             continue;
         }
-        const thenMatch = line.match(/^-[ \t]+\*\*THEN\*\*[ \t]*(.*)$/);
+        const thenMatch = line.match(THEN_BULLET_REGEX);
         if (thenMatch) {
-            then.push(thenMatch[1].trim());
+            const text = thenMatch[1].trim();
+            then.push(text);
+            outcomes.push(outcomeWithTable(text, lines, index + 1));
+            thenSeen = true;
+            continue;
+        }
+        const andMatch = line.match(AND_BULLET_REGEX);
+        if (andMatch && thenSeen) {
+            outcomes.push(outcomeWithTable(andMatch[1].trim(), lines, index + 1));
+        }
+    }
+    return { name, when, then, outcomes, raw: normalizeLineEndings(raw).trimEnd() };
+}
+/** An outcome line paired with the table directly below it, if any. */
+function outcomeWithTable(text, lines, start) {
+    const rows = readTableRows(lines, start);
+    return rows === undefined ? { text } : { text, rows };
+}
+/** Split one Markdown table row into its trimmed cells. */
+function splitTableRow(line) {
+    return line
+        .trim()
+        .replace(/^\|/, '')
+        .replace(/\|$/, '')
+        .split('|')
+        .map((cell) => cell.trim());
+}
+/** True when a table row is the dashes-and-colons alignment row. */
+function isTableSeparator(line) {
+    const cells = splitTableRow(line);
+    return cells.length > 0 && cells.every((cell) => TABLE_SEPARATOR_CELL_REGEX.test(cell));
+}
+/**
+ * Read the Markdown table directly under an outcome line. Blank lines may sit
+ * between the outcome and the table, and the table may be indented. The first
+ * row names the columns, the alignment row is left out, and each later row is
+ * keyed by the header cells, a missing cell reading as the empty string.
+ * Returns undefined when no table follows the outcome.
+ */
+function readTableRows(lines, start) {
+    let index = start;
+    while (index < lines.length && lines[index].trim() === '') {
+        index++;
+    }
+    if (index >= lines.length || !TABLE_ROW_REGEX.test(lines[index])) {
+        return undefined;
+    }
+    const header = splitTableRow(lines[index]);
+    index++;
+    if (index < lines.length && isTableSeparator(lines[index])) {
+        index++;
+    }
+    const rows = [];
+    while (index < lines.length && TABLE_ROW_REGEX.test(lines[index])) {
+        const cells = splitTableRow(lines[index]);
+        const row = {};
+        for (let column = 0; column < header.length; column++) {
+            row[header[column]] = cells[column] ?? '';
         }
+        rows.push(row);
+        index++;
     }
-    return { name, when, then, raw: normalizeLineEndings(raw).trimEnd() };
+    return rows;
 }
 /** The body of a `## Purpose` section, or undefined when it is absent or empty. */
 export function extractPurposeSection(content) {