@matteeh/osq 0.2.0 → 0.2.2

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

@@ -0,0 +1,143 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { DEFAULT_TRACEABILITY_CONFIG, } from '../foundation/config-traceability.js';
+import { readDecisions } from '../foundation/decisions.js';
+import { buildScenarioIndex } from '../trace/scenario-index.js';
+import { effectiveScenarios } from '../trace/scenario-lookup.js';
+import { readCapabilityOwnership } from './capability-impact.js';
+import { parseCapabilitySpec } from './delta.js';
+import { makeFinding } from './lint-findings.js';
+import { extractSection, parseFrontmatter } from './parser.js';
+import { blastScenarios, readCapabilityChanges, readDeltaCapabilities, scenarioImpactFindings, specDirectories, } from './scenario-impact.js';
+import { linkFindings, plannedCoversFunction, scenarioKey, traceabilitySeverity, } from './traceability-links.js';
+/** The opted-in capability set; `'all'` expands to living specs and deltas. */
+async function readOptedIn(input, deltas, traceability) {
+    const configured = traceability.capabilities;
+    if (configured === 'all') {
+        const specsDir = path.join(input.projectRoot, input.config.paths.openspecRoot, 'specs');
+        return new Set([...(await specDirectories(specsDir)), ...deltas]);
+    }
+    return new Set(configured);
+}
+/** Effective scenario names, tolerating a delta the merge engine refuses. */
+async function effectiveNamesFor(openspecRoot, folderPath, capability, change) {
+    try {
+        return effectiveScenarios(openspecRoot, folderPath, capability).map((scenario) => scenario.name);
+    }
+    catch {
+        const living = await fs
+            .readFile(path.join(openspecRoot, 'specs', capability, 'spec.md'), 'utf8')
+            .catch(() => null);
+        if (living !== null) {
+            return parseCapabilitySpec(living).requirements.flatMap((requirement) => requirement.scenarios.map((scenario) => scenario.name));
+        }
+        return change === undefined ? [] : [...change.addedNames, ...change.modifiedNames];
+    }
+}
+/** Build the opted-in capability link info, effective scenarios included. */
+async function readLinkCapabilities(input, openspecRoot, changes, optedIn) {
+    const capabilities = [];
+    for (const capability of [...optedIn].sort()) {
+        const change = changes.get(capability);
+        capabilities.push({
+            capability,
+            deltaPath: change?.deltaPath ?? null,
+            effectiveNames: await effectiveNamesFor(openspecRoot, input.folderPath, capability, change),
+            alteredNames: change === undefined ? [] : [...change.addedNames, ...change.modifiedNames],
+        });
+    }
+    return capabilities;
+}
+/** A test path is under `tests/`, or its file name holds `.test.` or `.spec.`. */
+function isTestPath(relativePath) {
+    if (relativePath === 'tests' || relativePath.startsWith('tests/'))
+        return true;
+    const base = relativePath.slice(relativePath.lastIndexOf('/') + 1);
+    return base.includes('.test.') || base.includes('.spec.');
+}
+/** The `## Scenarios` keys each task with a test path lists, by task number. */
+async function readPlannedScenarios(projectRoot, tasks) {
+    const planned = new Map();
+    for (const task of tasks) {
+        if (!task.resolvedPaths.some(isTestPath))
+            continue;
+        const content = await fs
+            .readFile(path.join(projectRoot, task.taskPath), 'utf8')
+            .catch(() => null);
+        if (content === null)
+            continue;
+        const section = extractSection(parseFrontmatter(content).body, 'Scenarios');
+        const keys = new Set();
+        for (const line of section.split('\n')) {
+            const bullet = /^\s*[-*]\s+(.*)$/.exec(line);
+            if (bullet === null)
+                continue;
+            const colon = bullet[1].indexOf(':');
+            if (colon === -1)
+                continue;
+            const capability = bullet[1].slice(0, colon).trim();
+            const name = bullet[1].slice(colon + 1).trim();
+            if (capability !== '' && name !== '')
+                keys.add(scenarioKey(capability, name));
+        }
+        if (keys.size > 0)
+            planned.set(task.taskNumber, keys);
+    }
+    return planned;
+}
+/** Every unreadable tag or scenario call the index holds in a resolved scope. */
+function unreadableFindings(input) {
+    const severity = traceabilitySeverity(input.mode);
+    const findings = [];
+    for (const form of input.index.unreadable) {
+        if (!input.scopedFiles.has(form.file))
+            continue;
+        if (form.capability !== undefined && !input.optedIn.has(form.capability))
+            continue;
+        findings.push(makeFinding(severity, { file: form.file }, `${form.file}:${form.line}: ${form.reason}`));
+    }
+    return findings;
+}
+/** Collect the traceability findings for one change folder. */
+export async function collectTraceabilityFindings(input) {
+    const traceability = input.config.traceability ?? DEFAULT_TRACEABILITY_CONFIG;
+    const mode = traceability.mode;
+    const openspecRoot = path.join(input.projectRoot, input.config.paths.openspecRoot);
+    const deltas = await readDeltaCapabilities(input.folderPath);
+    const optedIn = await readOptedIn(input, deltas, traceability);
+    const changes = await readCapabilityChanges(input.projectRoot, input.folderPath, openspecRoot, deltas);
+    const index = buildScenarioIndex(input.projectRoot, input.importGraph);
+    const findings = [];
+    if (optedIn.size > 0) {
+        const scopedFiles = new Set(input.tasks.flatMap((task) => [...task.resolvedPaths]));
+        const scopedTests = new Set(index.scenarioTestFiles.filter((file) => scopedFiles.has(file)));
+        const plannedByTask = await readPlannedScenarios(input.projectRoot, input.tasks);
+        const planned = new Set([...plannedByTask.values()].flatMap((keys) => [...keys]));
+        const namedByScopedTest = (capability, name) => index.testsNaming(capability, name).some((file) => scopedTests.has(file));
+        const capabilities = await readLinkCapabilities(input, openspecRoot, changes, optedIn);
+        const adrs = (await readDecisions(input.projectRoot, input.config)).adrs;
+        const ownerships = await readCapabilityOwnership(input.projectRoot, input.config.paths.openspecRoot);
+        findings.push(...linkFindings({
+            mode,
+            index,
+            scopedFiles,
+            optedIn,
+            capabilities,
+            planned,
+            namedByScopedTest,
+            plannedCoversFunction: (file, capability, name) => plannedCoversFunction(input.tasks, plannedByTask, file, capability, name, namedByScopedTest),
+            adrs,
+            ownerships,
+        }));
+        findings.push(...unreadableFindings({ index, scopedFiles, optedIn, mode }));
+    }
+    findings.push(...scenarioImpactFindings({
+        mode,
+        index,
+        optedIn,
+        tasks: input.tasks,
+        scenarios: blastScenarios(changes),
+    }));
+    return findings;
+}
+//# sourceMappingURL=traceability-lint.js.map

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

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

package/dist/core/status/blocked-item.d.ts

@@ -0,0 +1,8 @@
+import type { NeedsYouItem } from './inbox.js';
+import type { StatusOverview } from './status.js';
+/**
+ * Annotate `task-dead` items whose task died blocked with the stated need and
+ * the reject-and-replan command. Every other item is returned unchanged.
+ */
+export declare function applyBlockedItems(overview: StatusOverview, items: NeedsYouItem[]): Promise<NeedsYouItem[]>;
+//# sourceMappingURL=blocked-item.d.ts.map

package/dist/core/status/blocked-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocked-item.d.ts","sourceRoot":"","sources":["../../../src/core/status/blocked-item.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA2BlD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,YAAY,EAAE,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAczB"}

package/dist/core/status/blocked-item.js

@@ -0,0 +1,45 @@
+import fs from 'node:fs/promises';
+import { parseResultSections } from '../report/result-sections.js';
+import { getResultPath } from './layout.js';
+const NOT_STATED = '(not stated)';
+const REJECT_REASON = '--reason <text>';
+/** The task state behind a task-dead item, when the overview still holds it. */
+function findTask(overview, item) {
+    const spec = overview.specs.find((candidate) => candidate.id === item.change.id);
+    if (!spec)
+        return null;
+    const taskNumber = item.task?.number;
+    if (!taskNumber)
+        return null;
+    const task = spec.tasks.find((candidate) => candidate.taskNumber === taskNumber);
+    return task ? { spec, task } : null;
+}
+/** The task result file's stated need, or `(not stated)` when it has none. */
+async function readNeed(folderPath, taskNumber) {
+    const content = await fs
+        .readFile(getResultPath(folderPath, taskNumber), 'utf8')
+        .catch(() => null);
+    if (content === null)
+        return NOT_STATED;
+    return parseResultSections(content).blocked ?? NOT_STATED;
+}
+/**
+ * Annotate `task-dead` items whose task died blocked with the stated need and
+ * the reject-and-replan command. Every other item is returned unchanged.
+ */
+export async function applyBlockedItems(overview, items) {
+    return Promise.all(items.map(async (item) => {
+        if (item.kind !== 'task-dead')
+            return item;
+        const found = findTask(overview, item);
+        if (!found || found.task.deadReason !== 'blocked')
+            return item;
+        const need = await readNeed(found.spec.folderPath, found.task.taskNumber);
+        return {
+            ...item,
+            command: `osq reject ${item.change.id} ${REJECT_REASON}`,
+            blocked: { need },
+        };
+    }));
+}
+//# sourceMappingURL=blocked-item.js.map

package/dist/core/status/blocked-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocked-item.js","sourceRoot":"","sources":["../../../src/core/status/blocked-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,UAAU,GAAG,cAAc,CAAC;AAClC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,gFAAgF;AAChF,SAAS,QAAQ,CACf,QAAwB,EACxB,IAAkB;IAElB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;IACrC,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,KAAK,UAAU,QAAQ,CAAC,UAAkB,EAAE,UAAkB;IAC5D,MAAM,OAAO,GAAG,MAAM,EAAE;SACrB,QAAQ,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC;SACvD,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC;IACxC,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAwB,EACxB,KAAqB;IAErB,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1E,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,cAAc,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,aAAa,EAAE;YACxD,OAAO,EAAE,EAAE,IAAI,EAAE;SACK,CAAC;IAC3B,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/core/status/change-locations.d.ts

@@ -0,0 +1,44 @@
+import type { OsqConfig } from '../foundation/config.js';
+/** Where a change folder currently lives. */
+export type ChangeLocation = 'active' | 'archived' | 'rejected';
+/** One tree changes live in, with its canonical change directories. */
+export interface ChangeTree {
+    /** Absolute project root of the tree. */
+    readonly root: string;
+    /** For an osq worktree tree, the change folder it checks out. */
+    readonly worktreeFolder?: string;
+    readonly changesDir: string;
+    readonly archiveDir: string;
+    readonly rejectedDir: string;
+}
+/** One change folder with its location and the tree it lives in. */
+export interface LocatedChange {
+    readonly folderName: string;
+    /** Absolute path of the folder. */
+    readonly folderPath: string;
+    readonly location: ChangeLocation;
+    readonly tree: ChangeTree;
+}
+/**
+ * The trees changes live in. The first is always the project root; with
+ * `vcs.enabled` and git selected, one tree follows per osq worktree, carrying
+ * the change folder its branch names. A relative project root resolves against
+ * the current directory.
+ */
+export declare function changeTrees(projectRoot: string, config: OsqConfig): Promise<ChangeTree[]>;
+/**
+ * Every change folder across every tree, directories only, active first, then
+ * archived, then rejected, each in numeric prefix order.
+ */
+export declare function listChanges(projectRoot: string, config: OsqConfig, locations?: readonly ChangeLocation[]): Promise<LocatedChange[]>;
+/**
+ * The active change matching an exact name, a number with or without zero
+ * padding, or that number followed by `-`. Fails with `findSpecFolder`'s
+ * message when nothing matches.
+ */
+export declare function findChange(projectRoot: string, config: OsqConfig, idOrPrefix: string): Promise<LocatedChange>;
+/** The change an absolute folder path names, or null when no tree holds it. */
+export declare function locateFolder(projectRoot: string, config: OsqConfig, folderPath: string): Promise<LocatedChange | null>;
+/** The changes directory relative to the project root, for display. */
+export declare function changesDirLabel(config: OsqConfig): string;
+//# sourceMappingURL=change-locations.d.ts.map

package/dist/core/status/change-locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-locations.d.ts","sourceRoot":"","sources":["../../../src/core/status/change-locations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAUzD,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhE,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAmDD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAgB/F;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,SAAS,GAAE,SAAS,cAAc,EAAmB,GACpD,OAAO,CAAC,aAAa,EAAE,CAAC,CA+B1B;AAgBD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,+EAA+E;AAC/E,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAI/B;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEzD"}

package/dist/core/status/change-locations.js

@@ -0,0 +1,138 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { selectVcs } from '../vcs/select.js';
+import { getArchiveDir, getChangesDir, getRejectedDir, isActiveChangeFolderName, } from './layout.js';
+import { compareNumericPrefix } from './state.js';
+const LOCATION_ORDER = ['active', 'archived', 'rejected'];
+/** Order two located changes by location, then numeric prefix. */
+function compareLocated(a, b) {
+    const rank = LOCATION_ORDER.indexOf(a.location) - LOCATION_ORDER.indexOf(b.location);
+    if (rank !== 0)
+        return rank;
+    return compareNumericPrefix(a.folderName, b.folderName);
+}
+/** Whether a change-location directory entry is a change folder candidate. */
+function isLocationEntry(entry, location) {
+    if (location === 'active')
+        return isActiveChangeFolderName(entry);
+    return !entry.startsWith('_') && !entry.startsWith('.');
+}
+/** Every change folder directly under one canonical directory. */
+async function listLocation(tree, dir, location) {
+    const entries = await fs.readdir(dir).catch(() => []);
+    const changes = [];
+    for (const entry of entries) {
+        if (!isLocationEntry(entry, location))
+            continue;
+        const folderPath = path.join(dir, entry);
+        const stat = await fs.stat(folderPath).catch(() => null);
+        if (!stat?.isDirectory())
+            continue;
+        changes.push({ folderName: entry, folderPath, location, tree });
+    }
+    return changes;
+}
+/** One tree rooted at `root`, its canonical directories from the config. */
+function treeAt(root, config, worktreeFolder) {
+    return {
+        root,
+        ...(worktreeFolder !== undefined ? { worktreeFolder } : {}),
+        changesDir: getChangesDir(config.paths.openspecRoot, root),
+        archiveDir: getArchiveDir(config.paths.openspecRoot, root),
+        rejectedDir: getRejectedDir(config.paths.openspecRoot, root),
+    };
+}
+/** Resolve a path with symlinks, falling back to the raw path when absent. */
+async function realpath(target) {
+    return fs.realpath(target).catch(() => target);
+}
+/**
+ * The trees changes live in. The first is always the project root; with
+ * `vcs.enabled` and git selected, one tree follows per osq worktree, carrying
+ * the change folder its branch names. A relative project root resolves against
+ * the current directory.
+ */
+export async function changeTrees(projectRoot, config) {
+    const root = path.resolve(projectRoot);
+    const trees = [treeAt(root, config)];
+    if (config.vcs?.enabled !== true)
+        return trees;
+    const vcs = await selectVcs(root, config);
+    if (vcs.kind !== 'git')
+        return trees;
+    const rootReal = await realpath(root);
+    for (const worktree of await vcs.worktreeList()) {
+        const branch = worktree.branch;
+        if (!branch?.startsWith('osq/'))
+            continue;
+        if ((await realpath(worktree.path)) === rootReal)
+            continue;
+        trees.push(treeAt(worktree.path, config, branch.slice('osq/'.length)));
+    }
+    return trees;
+}
+/**
+ * Every change folder across every tree, directories only, active first, then
+ * archived, then rejected, each in numeric prefix order.
+ */
+export async function listChanges(projectRoot, config, locations = LOCATION_ORDER) {
+    const wanted = new Set(locations);
+    const trees = await changeTrees(projectRoot, config);
+    const worktreeFolders = new Set(trees.flatMap((tree) => (tree.worktreeFolder === undefined ? [] : [tree.worktreeFolder])));
+    const changes = [];
+    for (const tree of trees) {
+        const entries = [];
+        if (wanted.has('active')) {
+            entries.push(...(await listLocation(tree, tree.changesDir, 'active')));
+        }
+        if (wanted.has('archived')) {
+            entries.push(...(await listLocation(tree, tree.archiveDir, 'archived')));
+        }
+        if (wanted.has('rejected')) {
+            entries.push(...(await listLocation(tree, tree.rejectedDir, 'rejected')));
+        }
+        // A worktree tree contributes only the folder its branch names; the
+        // project root drops an active folder any worktree tree names.
+        if (tree.worktreeFolder !== undefined) {
+            changes.push(...entries.filter((entry) => entry.folderName === tree.worktreeFolder));
+        }
+        else {
+            changes.push(...entries.filter((entry) => entry.location !== 'active' || !worktreeFolders.has(entry.folderName)));
+        }
+    }
+    return changes.sort(compareLocated);
+}
+/** Whether a folder name matches a query as `findSpecFolder` matches it. */
+function matchesFolder(folderName, query) {
+    const trimmed = query.trim();
+    const num = Number.parseInt(trimmed, 10);
+    const padded = !Number.isNaN(num) ? String(num).padStart(3, '0') : trimmed;
+    return (folderName === trimmed ||
+        folderName === padded ||
+        folderName.startsWith(`${trimmed}-`) ||
+        folderName.startsWith(`${padded}-`));
+}
+/**
+ * The active change matching an exact name, a number with or without zero
+ * padding, or that number followed by `-`. Fails with `findSpecFolder`'s
+ * message when nothing matches.
+ */
+export async function findChange(projectRoot, config, idOrPrefix) {
+    const active = await listChanges(projectRoot, config, ['active']);
+    const match = active.find((change) => matchesFolder(change.folderName, idOrPrefix));
+    if (match)
+        return match;
+    const [tree] = await changeTrees(projectRoot, config);
+    throw new Error(`Spec "${idOrPrefix}" not found in ${tree.changesDir}`);
+}
+/** The change an absolute folder path names, or null when no tree holds it. */
+export async function locateFolder(projectRoot, config, folderPath) {
+    const target = path.resolve(projectRoot, folderPath);
+    const changes = await listChanges(projectRoot, config);
+    return changes.find((change) => change.folderPath === target) ?? null;
+}
+/** The changes directory relative to the project root, for display. */
+export function changesDirLabel(config) {
+    return getChangesDir(config.paths.openspecRoot);
+}
+//# sourceMappingURL=change-locations.js.map

package/dist/core/status/change-locations.js.map

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

package/dist/core/status/dependency-readiness.d.ts

@@ -0,0 +1,11 @@
+/** Directory entries, or an empty list when the directory cannot be read. */
+export declare function listDir(dir: string): Promise<string[]>;
+/** True while an archived change requires a verification outcome that has not passed. */
+export declare function isVerificationPending(folderPath: string): Promise<boolean>;
+/**
+ * Runtime dependency completion: an archived dependency counts as met only when
+ * its recorded verification is not pending. A rejected dependency and an
+ * unfinished active change are never met.
+ */
+export declare function isDependencyDone(changesDir: string, dependency: string): Promise<boolean>;
+//# sourceMappingURL=dependency-readiness.d.ts.map

package/dist/core/status/dependency-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-readiness.d.ts","sourceRoot":"","sources":["../../../src/core/status/dependency-readiness.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE5D;AAOD,yFAAyF;AACzF,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc/F"}

package/dist/core/status/dependency-readiness.js

@@ -0,0 +1,39 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readVerification } from './verification.js';
+/** Directory entries, or an empty list when the directory cannot be read. */
+export async function listDir(dir) {
+    return fs.readdir(dir).catch(() => []);
+}
+async function findFolder(parent, prefix) {
+    const entries = await listDir(parent);
+    return entries.find((entry) => entry === prefix || entry.startsWith(`${prefix}-`)) ?? null;
+}
+/** True while an archived change requires a verification outcome that has not passed. */
+export async function isVerificationPending(folderPath) {
+    const { required, outcome } = await readVerification(folderPath);
+    return required && outcome !== 'passed';
+}
+/**
+ * Runtime dependency completion: an archived dependency counts as met only when
+ * its recorded verification is not pending. A rejected dependency and an
+ * unfinished active change are never met.
+ */
+export async function isDependencyDone(changesDir, dependency) {
+    const padded = dependency.padStart(3, '0');
+    const archived = await findFolder(path.join(changesDir, 'archive'), padded);
+    if (archived)
+        return !(await isVerificationPending(path.join(changesDir, 'archive', archived)));
+    if (await findFolder(path.join(changesDir, 'rejected'), padded))
+        return false;
+    const active = await findFolder(changesDir, padded);
+    if (!active)
+        return false;
+    const dependencyFolder = path.join(changesDir, active);
+    const taskFiles = (await listDir(path.join(dependencyFolder, 'tasks'))).filter((entry) => entry.endsWith('.md'));
+    if (taskFiles.length === 0)
+        return false;
+    const done = new Set(await listDir(path.join(dependencyFolder, '.run', 'done')));
+    return taskFiles.every((entry) => done.has(entry.replace(/\.md$/, '')));
+}
+//# sourceMappingURL=dependency-readiness.js.map

package/dist/core/status/dependency-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-readiness.js","sourceRoot":"","sources":["../../../src/core/status/dependency-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW;IACvC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,MAAc;IACtD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AAC7F,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAAkB;IAC5D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACjE,OAAO,QAAQ,IAAI,OAAO,KAAK,QAAQ,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAkB,EAAE,UAAkB;IAC3E,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5E,IAAI,QAAQ;QAAE,OAAO,CAAC,CAAC,MAAM,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChG,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACvF,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CACtB,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACjF,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/core/status/inbox-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-projection.d.ts","sourceRoot":"","sources":["../../../src/core/status/inbox-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EAAE,KAAK,KAAK,EAAoC,MAAM,YAAY,CAAC;AAI1E,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,KAAK,CAAC,CAQhB"}
+{"version":3,"file":"inbox-projection.d.ts","sourceRoot":"","sources":["../../../src/core/status/inbox-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIzE,OAAO,EAAE,KAAK,KAAK,EAAuD,MAAM,YAAY,CAAC;AAG7F,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAmBD;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,KAAK,CAAC,CAWhB"}

package/dist/core/status/inbox-projection.js

@@ -1,8 +1,24 @@
 import { DEFAULT_CONFIG } from '../foundation/config.js';
+import { applyBlockedItems } from './blocked-item.js';
+import { changeTrees } from './change-locations.js';
 import { readLastLook } from './inbox-cursor.js';
 import { collectLandedItems, projectInbox } from './inbox.js';
-import { getArchiveDir } from './layout.js';
 import { getStatusOverview } from './status.js';
+function changeId(folderName) {
+    return folderName.match(/^(\d+)/)?.[1] ?? folderName;
+}
+/** One needs-you item per archived change still awaiting a verification outcome. */
+function projectPendingVerifications(overview) {
+    return (overview.pendingVerifications ?? []).map((pending) => {
+        const id = changeId(pending.folderName);
+        return {
+            kind: pending.next.detail === 'failed' ? 'verification-failed' : 'verification-pending',
+            change: { id, title: pending.title },
+            task: null,
+            command: pending.next.command ?? `osq verified ${id} --passed|--failed`,
+        };
+    });
+}
 /**
  * Derives the stable inbox object without mutating any file. Both the CLI and
  * the read-only HTTP transport consume it, so a contemporaneous invocation and
@@ -13,8 +29,11 @@ export async function readInbox(projectRoot, options = {}) {
     const now = options.now ?? new Date();
     const overview = await getStatusOverview(projectRoot, config);
     const lastLookMs = await readLastLook(projectRoot, options.home);
-    const archiveDir = getArchiveDir(config.paths.openspecRoot, projectRoot);
-    const landed = await collectLandedItems(archiveDir, lastLookMs);
-    return projectInbox(overview, landed, now.getTime());
+    const [tree] = await changeTrees(projectRoot, config);
+    const landed = await collectLandedItems(tree.archiveDir, lastLookMs);
+    const inbox = projectInbox(overview, landed, now.getTime());
+    const pending = projectPendingVerifications(overview);
+    const needsYou = await applyBlockedItems(overview, [...inbox.needsYou, ...pending]);
+    return { ...inbox, needsYou };
 }
 //# sourceMappingURL=inbox-projection.js.map

package/dist/core/status/inbox-projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-projection.js","sourceRoot":"","sources":["../../../src/core/status/inbox-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAc,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAShD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,UAA4B,EAAE;IAE9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAChE,OAAO,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"inbox-projection.js","sourceRoot":"","sources":["../../../src/core/status/inbox-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAiC,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAuB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrE,SAAS,QAAQ,CAAC,UAAkB;IAClC,OAAO,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC;AACvD,CAAC;AAED,oFAAoF;AACpF,SAAS,2BAA2B,CAAC,QAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3D,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,sBAAsB;YACvF,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;YACpC,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,gBAAgB,EAAE,oBAAoB;SACjD,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,UAA4B,EAAE;IAE9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IACpF,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC"}

package/dist/core/status/inbox-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-text.d.ts","sourceRoot":"","sources":["../../../src/core/status/inbox-text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAuD,MAAM,YAAY,CAAC;AAuB7F,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAmBpD"}
+{"version":3,"file":"inbox-text.d.ts","sourceRoot":"","sources":["../../../src/core/status/inbox-text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAuD,MAAM,YAAY,CAAC;AAkD7F,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAmBpD"}

package/dist/core/status/inbox-text.js

@@ -2,12 +2,25 @@ import { formatDuration } from '../report/report.js';
 const REJECT_HINT = '--reason <text>';
 function needsYouLine(item) {
     const head = `  ${item.change.id}: ${item.change.title}`;
-    if (item.kind === 'approval')
-        return `${head} — ${item.command}`;
+    if (item.kind === 'planning')
+        return `${head} — unplanned — ${item.command}`;
+    if (item.kind === 'verification-pending')
+        return `${head} — verification pending — ${item.command}`;
+    if (item.kind === 'verification-failed')
+        return `${head} — verification failed — ${item.command}`;
+    if (item.kind === 'approval') {
+        return item.beforeApproval
+            ? `${head} — do the steps before approval first — ${item.command}`
+            : `${head} — ${item.command}`;
+    }
     if (item.kind === 'change-regressed')
         return `${head} — change regressed — ${item.command}`;
     const task = item.task;
     const row = `${head} — task ${task.number}: ${task.title}`;
+    if (item.blocked) {
+        const need = item.blocked.need.replace(/\s+/g, ' ');
+        return `${row} — blocked: ${need} — reject, then osq plan --next --replan — ${item.command}`;
+    }
     if (!item.stuck)
         return `${row} — ${item.command}`;
     return `${row} — stuck: same failure twice; amend the spec or osq reject ${item.change.id} ${REJECT_HINT} — ${item.command}`;
@@ -16,8 +29,26 @@ function runningLine(item) {
     const duration = formatDuration(item.elapsedSeconds * 1000);
     return `  ${item.change.id}: ${item.change.title} — task ${item.task.number}: ${item.task.title} — ${duration} — ${item.command}`;
 }
+/**
+ * The `— disclosed: ...` suffix for a landed item whose tasks disclosed a gap.
+ * Counts appear in the order deviated, missing context, outside scope, and an
+ * item without disclosures contributes nothing.
+ */
+function disclosedSuffix(item) {
+    const disclosures = item.disclosures;
+    if (!disclosures)
+        return '';
+    const parts = [];
+    if (disclosures.deviated > 0)
+        parts.push(`deviated ${disclosures.deviated}`);
+    if (disclosures.missingContext > 0)
+        parts.push(`missing context ${disclosures.missingContext}`);
+    if (disclosures.outsideScope > 0)
+        parts.push(`outside scope ${disclosures.outsideScope}`);
+    return parts.length > 0 ? ` — disclosed: ${parts.join(', ')}` : '';
+}
 function landedLine(item) {
-    return `  ${item.change.id}: ${item.change.title} — archived ${item.archivedAt} — ${item.command}`;
+    return `  ${item.change.id}: ${item.change.title} — archived ${item.archivedAt}${disclosedSuffix(item)} — ${item.command}`;
 }
 /** Concise text rendering of the three inbox groups. */
 export function formatInboxText(inbox) {

package/dist/core/status/inbox-text.js.map

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