@matteeh/osq 0.1.0 → 0.2.0

package/dist/core/status/queue-planning.d.ts

@@ -0,0 +1,62 @@
+import { type OsqConfig } from '../foundation/config.js';
+import type { QueueItem } from './queue-parser.js';
+import { type QueueRow } from './queue-state.js';
+export interface LandedDependency {
+    readonly slug: string;
+    readonly changeId: string;
+    readonly archivePath: string;
+}
+export interface QueuePlanSelection {
+    readonly item: QueueItem;
+    readonly row: QueueRow;
+    readonly replan: boolean;
+    readonly landedDependencies: readonly LandedDependency[];
+}
+export type QueuePlanPreparation = {
+    readonly kind: 'ready';
+    readonly selection: QueuePlanSelection;
+    readonly notice?: string;
+} | {
+    readonly kind: 'refused';
+    readonly message: string;
+};
+/** Recorded queue planning spend across every associated change. */
+export interface QueuePlanningUsage {
+    /** Number of valid `plan_started` records (each counted once). */
+    readonly sessions: number;
+    /** Sum of finite recorded cost from singly correlated exits. */
+    readonly cost: number;
+    /** True only when every counted start has one exit with a finite cost. */
+    readonly costCoverageComplete: boolean;
+}
+export type QueueBudgetEvaluation = {
+    readonly kind: 'ok';
+    readonly notice?: string;
+} | {
+    readonly kind: 'refused';
+    readonly message: string;
+};
+/**
+ * Read the planning spend of every queue-associated change across active,
+ * archived, and rejected locations, including retained attempts whose slug is
+ * no longer in the current queue. Malformed records and non-queue changes
+ * contribute nothing.
+ */
+export declare function readQueuePlanningUsage(projectRoot: string, config?: OsqConfig): Promise<QueuePlanningUsage>;
+/**
+ * Apply the queue spend gates to a read-only usage aggregate. The session gate
+ * is always enforced; the cost gate is enforced only when coverage is complete.
+ * Incomplete coverage yields one factual note and leaves the cost gate off.
+ */
+export declare function evaluateQueueBudget(config: OsqConfig, usage: QueuePlanningUsage): QueueBudgetEvaluation;
+/**
+ * Read-only next-item preparation: halt on any active failure, then select the
+ * first unplanned or rejected item whose queue dependencies are landed. A
+ * rejected first eligible item refuses unless `replan` is set. Nothing is
+ * written here.
+ */
+export declare function prepareQueuePlan(projectRoot: string, config?: OsqConfig, options?: {
+    replan?: boolean;
+    enforceBudget?: boolean;
+}): Promise<QueuePlanPreparation>;
+//# sourceMappingURL=queue-planning.d.ts.map

package/dist/core/status/queue-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-planning.d.ts","sourceRoot":"","sources":["../../../src/core/status/queue-planning.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,KAAK,QAAQ,EAKd,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC1D;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5F;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAkC3D;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,SAA0B,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAiB7B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,kBAAkB,GACxB,qBAAqB,CA+BvB;AAYD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,SAA0B,EAClC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1D,OAAO,CAAC,oBAAoB,CAAC,CAwD/B"}

package/dist/core/status/queue-planning.js

@@ -0,0 +1,158 @@
+import path from 'node:path';
+import { DEFAULT_CONFIG } from '../foundation/config.js';
+import { readPlanRecords } from '../report/planning.js';
+import { findActiveQueueFailures, readQueueState, scanQueueAssociations, } from './queue-state.js';
+const QUEUE_BUDGET_REQUIRED = 'Non-print `plan --next` requires queue.maxPlanningSessions and queue.maxPlanningCost in osq.config.ts.';
+/** Correlate one change's planning records into start counts and finite cost. */
+function aggregatePlanUsage(records) {
+    const starts = new Map();
+    const exits = new Map();
+    for (const record of records) {
+        if (record.type === 'plan_started') {
+            starts.set(record.sessionId, (starts.get(record.sessionId) ?? 0) + 1);
+        }
+        else {
+            const costs = exits.get(record.sessionId) ?? [];
+            costs.push(record.data.usage.cost);
+            exits.set(record.sessionId, costs);
+        }
+    }
+    let sessions = 0;
+    let cost = 0;
+    let complete = true;
+    for (const [sessionId, startCount] of starts) {
+        // Count every valid start once; malformed duplicates do not shift the count.
+        sessions += startCount;
+        const matched = exits.get(sessionId) ?? [];
+        if (startCount !== 1 || matched.length !== 1 || matched[0] === null) {
+            complete = false;
+            continue;
+        }
+        cost += matched[0];
+    }
+    return { sessions, cost, costCoverageComplete: complete };
+}
+/**
+ * Read the planning spend of every queue-associated change across active,
+ * archived, and rejected locations, including retained attempts whose slug is
+ * no longer in the current queue. Malformed records and non-queue changes
+ * contribute nothing.
+ */
+export async function readQueuePlanningUsage(projectRoot, config = DEFAULT_CONFIG) {
+    const groups = await scanQueueAssociations(projectRoot, config, null);
+    const visited = new Set();
+    let sessions = 0;
+    let cost = 0;
+    let complete = true;
+    for (const group of groups.values()) {
+        for (const assoc of [...group.active, ...group.archived, ...group.rejected]) {
+            if (visited.has(assoc.folderPath))
+                continue;
+            visited.add(assoc.folderPath);
+            const aggregate = aggregatePlanUsage(await readPlanRecords(assoc.folderPath));
+            sessions += aggregate.sessions;
+            cost += aggregate.cost;
+            complete = complete && aggregate.costCoverageComplete;
+        }
+    }
+    return { sessions, cost, costCoverageComplete: complete };
+}
+/**
+ * Apply the queue spend gates to a read-only usage aggregate. The session gate
+ * is always enforced; the cost gate is enforced only when coverage is complete.
+ * Incomplete coverage yields one factual note and leaves the cost gate off.
+ */
+export function evaluateQueueBudget(config, usage) {
+    const queue = config.queue;
+    if (!queue ||
+        !Number.isFinite(queue.maxPlanningSessions) ||
+        !Number.isFinite(queue.maxPlanningCost) ||
+        queue.maxPlanningSessions < 0 ||
+        queue.maxPlanningCost < 0) {
+        return { kind: 'refused', message: QUEUE_BUDGET_REQUIRED };
+    }
+    if (usage.sessions + 1 > queue.maxPlanningSessions) {
+        return {
+            kind: 'refused',
+            message: `Queue planning session limit reached: ${usage.sessions} recorded session(s) against a maximum of ${queue.maxPlanningSessions}; launching another planner would exceed it.`,
+        };
+    }
+    if (usage.costCoverageComplete && usage.cost >= queue.maxPlanningCost) {
+        return {
+            kind: 'refused',
+            message: `Queue planning cost limit reached: recorded cost ${usage.cost} has reached the maximum of ${queue.maxPlanningCost}.`,
+        };
+    }
+    if (!usage.costCoverageComplete) {
+        return {
+            kind: 'ok',
+            notice: 'Recorded planning cost coverage is incomplete, so the queue cost ceiling is not enforced.',
+        };
+    }
+    return { kind: 'ok' };
+}
+function summarizeRows(rows) {
+    return rows
+        .map((row) => {
+        const waiting = row.unmetDependencies.length > 0 ? ` (waiting on ${row.unmetDependencies.join(', ')})` : '';
+        return `  - ${row.slug}: ${row.state}${waiting}`;
+    })
+        .join('\n');
+}
+/**
+ * Read-only next-item preparation: halt on any active failure, then select the
+ * first unplanned or rejected item whose queue dependencies are landed. A
+ * rejected first eligible item refuses unless `replan` is set. Nothing is
+ * written here.
+ */
+export async function prepareQueuePlan(projectRoot, config = DEFAULT_CONFIG, options = {}) {
+    const failures = await findActiveQueueFailures(projectRoot, config);
+    if (failures.length > 0) {
+        const lines = failures.map((f) => `  - ${f.changeId} ${f.target} (${f.reason}): ${f.retryCommand}`);
+        return {
+            kind: 'refused',
+            message: `Queue planning is blocked by active failures:\n${lines.join('\n')}`,
+        };
+    }
+    const state = await readQueueState(projectRoot, config);
+    const { items, groups, rows } = state;
+    const index = rows.findIndex((row) => (row.state === 'unplanned' || row.state === 'rejected') && row.unmetDependencies.length === 0);
+    if (index === -1) {
+        return {
+            kind: 'refused',
+            message: `No queue item is eligible to plan.\n${summarizeRows(rows)}`,
+        };
+    }
+    const row = rows[index];
+    if (row.state === 'rejected' && !options.replan) {
+        return {
+            kind: 'refused',
+            message: `Queue item "${row.slug}" has ${row.rejectionCount} rejected attempt(s) and no active plan. Re-run with --replan to create a new attempt.`,
+        };
+    }
+    let notice;
+    if (options.enforceBudget) {
+        const evaluation = evaluateQueueBudget(config, await readQueuePlanningUsage(projectRoot, config));
+        if (evaluation.kind === 'refused')
+            return { kind: 'refused', message: evaluation.message };
+        notice = evaluation.notice;
+    }
+    const item = items[index];
+    const landedDependencies = [];
+    for (const dep of item.dependsOn) {
+        const archived = groups.get(dep)?.archived ?? [];
+        if (archived.length === 1) {
+            landedDependencies.push({
+                slug: dep,
+                changeId: archived[0].id,
+                archivePath: path.relative(projectRoot, archived[0].folderPath),
+            });
+        }
+    }
+    return {
+        kind: 'ready',
+        selection: { item, row, replan: row.state === 'rejected', landedDependencies },
+        ...(notice ? { notice } : {}),
+    };
+}
+//# sourceMappingURL=queue-planning.js.map

package/dist/core/status/queue-planning.js.map

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

package/dist/core/status/queue-report-detail.d.ts

@@ -0,0 +1,50 @@
+import type { OsqConfig } from '../foundation/config.js';
+import type { QueueActiveFailure, QueueAssociationGroups, QueueItemState, QueueRow } from './queue.js';
+/** The queue-specific spend aggregate carried in the delivery report. */
+export interface QueueReportPlanning {
+    readonly sessions: number;
+    readonly cost: number;
+    readonly costCoverageComplete: boolean;
+}
+/** One current queue item with its derived state and nullable planned-to-landed time. */
+export interface QueueReportItem {
+    readonly slug: string;
+    readonly title: string;
+    readonly state: QueueItemState;
+    readonly change: string | null;
+    readonly rejectionCount: number;
+    readonly changedSincePlanned: boolean;
+    readonly plannedToLandedSeconds: number | null;
+}
+/** One active dead or regressed target associated with the queue. */
+export interface QueueReportFailure {
+    readonly change: string;
+    readonly target: string;
+    readonly reason: string;
+}
+/** One retained rejected queue attempt, preserved per folder. */
+export interface QueueReportRejection {
+    readonly slug: string;
+    readonly change: string;
+    readonly reason: string;
+    readonly timestamp: string | null;
+}
+/** The stable top-level queue view of the delivery report. */
+export interface QueueReport {
+    readonly configured: boolean;
+    readonly landed: number;
+    readonly total: number;
+    readonly planning: QueueReportPlanning;
+    readonly items: readonly QueueReportItem[];
+    readonly failures: readonly QueueReportFailure[];
+    readonly rejections: readonly QueueReportRejection[];
+}
+/** Deterministic empty projection used when no queue file is configured. */
+export declare function emptyQueueReport(): QueueReport;
+/** Project one derived queue row, deriving elapsed time only for a landed association. */
+export declare function readQueueReportItem(row: QueueRow, groups: QueueAssociationGroups | undefined): Promise<QueueReportItem>;
+/** Enrich one active failure with its canonical marker reason. */
+export declare function readQueueReportFailure(projectRoot: string, config: OsqConfig, failure: QueueActiveFailure): Promise<QueueReportFailure>;
+/** One retained rejection row per rejected queue attempt, sorted by numeric change. */
+export declare function readQueueReportRejections(associations: ReadonlyMap<string, QueueAssociationGroups>): Promise<QueueReportRejection[]>;
+//# sourceMappingURL=queue-report-detail.d.ts.map

package/dist/core/status/queue-report-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-report-detail.d.ts","sourceRoot":"","sources":["../../../src/core/status/queue-report-detail.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AASzD,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,QAAQ,EACT,MAAM,YAAY,CAAC;AAGpB,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACtD;AAID,4EAA4E;AAC5E,wBAAgB,gBAAgB,IAAI,WAAW,CAU9C;AAsDD,0FAA0F;AAC1F,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,sBAAsB,GAAG,SAAS,GACzC,OAAO,CAAC,eAAe,CAAC,CAiB1B;AAUD,kEAAkE;AAClE,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAiB7B;AAED,uFAAuF;AACvF,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,GACxD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoBjC"}

package/dist/core/status/queue-report-detail.js

@@ -0,0 +1,140 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readPlanRecords } from '../report/planning.js';
+import { parseFrontmatter } from '../spec/parser.js';
+import { getChangesDir, getDeadMarkerPath, getRegressedMarkerPath, getRejectedMarkerPath, } from './layout.js';
+import { compareNumericPrefix } from './state.js';
+const UNAVAILABLE = 'unavailable';
+/** Deterministic empty projection used when no queue file is configured. */
+export function emptyQueueReport() {
+    return {
+        configured: false,
+        landed: 0,
+        total: 0,
+        planning: { sessions: 0, cost: 0, costCoverageComplete: false },
+        items: [],
+        failures: [],
+        rejections: [],
+    };
+}
+function finiteTimestamp(value) {
+    if (typeof value !== 'string')
+        return null;
+    const ms = Date.parse(value);
+    return Number.isFinite(ms) ? ms : null;
+}
+/** Rounded non-negative seconds between two endpoints, or null when missing or reversed. */
+function elapsedSeconds(startMs, endMs) {
+    if (startMs === null || endMs === null || endMs < startMs)
+        return null;
+    return Math.round((endMs - startMs) / 1000);
+}
+/** Earliest valid `plan_started` timestamp across every attempt for one item. */
+async function earliestPlanStartMs(groups) {
+    if (!groups)
+        return null;
+    let earliest = null;
+    for (const assoc of [...groups.active, ...groups.archived, ...groups.rejected]) {
+        for (const record of await readPlanRecords(assoc.folderPath)) {
+            if (record.type !== 'plan_started')
+                continue;
+            const ms = finiteTimestamp(record.timestamp);
+            if (ms !== null && (earliest === null || ms < earliest))
+                earliest = ms;
+        }
+    }
+    return earliest;
+}
+/** Timestamp of the first valid typed `archived` event in a change-level stream. */
+async function archivedEventMs(folderPath) {
+    const content = await fs
+        .readFile(path.join(folderPath, '.run', 'events', 'change.jsonl'), 'utf8')
+        .catch(() => null);
+    if (content === null)
+        return null;
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            continue;
+        const event = parsed;
+        if (event.type !== 'archived')
+            continue;
+        const ms = finiteTimestamp(event.timestamp);
+        if (ms !== null)
+            return ms;
+    }
+    return null;
+}
+/** Project one derived queue row, deriving elapsed time only for a landed association. */
+export async function readQueueReportItem(row, groups) {
+    let plannedToLandedSeconds = null;
+    if (row.state === 'landed' && groups?.archived.length === 1) {
+        plannedToLandedSeconds = elapsedSeconds(await earliestPlanStartMs(groups), await archivedEventMs(groups.archived[0].folderPath));
+    }
+    return {
+        slug: row.slug,
+        title: row.title,
+        state: row.state,
+        change: row.changeId,
+        rejectionCount: row.rejectionCount,
+        changedSincePlanned: row.changedSincePlanned,
+        plannedToLandedSeconds,
+    };
+}
+/** Non-empty `reason` frontmatter from a marker, or null when absent or malformed. */
+async function markerReason(markerPath) {
+    const content = await fs.readFile(markerPath, 'utf8').catch(() => null);
+    if (content === null)
+        return null;
+    const value = parseFrontmatter(content).data.reason;
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+/** Enrich one active failure with its canonical marker reason. */
+export async function readQueueReportFailure(projectRoot, config, failure) {
+    const folderPath = path.join(getChangesDir(config.paths.openspecRoot, projectRoot), failure.folderName);
+    const candidates = failure.target === 'change'
+        ? [getRegressedMarkerPath(folderPath, 'change')]
+        : [
+            getRegressedMarkerPath(folderPath, failure.target),
+            getDeadMarkerPath(folderPath, failure.target),
+        ];
+    for (const candidate of candidates) {
+        const reason = await markerReason(candidate);
+        if (reason !== null)
+            return { change: failure.changeId, target: failure.target, reason };
+    }
+    return { change: failure.changeId, target: failure.target, reason: UNAVAILABLE };
+}
+/** One retained rejection row per rejected queue attempt, sorted by numeric change. */
+export async function readQueueReportRejections(associations) {
+    const rows = [];
+    for (const [slug, groups] of associations) {
+        for (const assoc of groups.rejected) {
+            const content = await fs
+                .readFile(getRejectedMarkerPath(assoc.folderPath), 'utf8')
+                .catch(() => null);
+            let reason = UNAVAILABLE;
+            let timestamp = null;
+            if (content !== null) {
+                const data = parseFrontmatter(content).data;
+                if (typeof data.reason === 'string' && data.reason.trim())
+                    reason = data.reason.trim();
+                if (typeof data.timestamp === 'string' && data.timestamp.trim()) {
+                    timestamp = data.timestamp.trim();
+                }
+            }
+            rows.push({ slug, change: assoc.folderName, reason, timestamp });
+        }
+    }
+    return rows.sort((a, b) => compareNumericPrefix(a.change, b.change));
+}
+//# sourceMappingURL=queue-report-detail.js.map

package/dist/core/status/queue-report-detail.js.map

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

package/dist/core/status/queue-report.d.ts

@@ -0,0 +1,14 @@
+import { type OsqConfig } from '../foundation/config.js';
+import { type QueueReport } from './queue-report-detail.js';
+export type { QueueReport, QueueReportFailure, QueueReportItem, QueueReportPlanning, QueueReportRejection, } from './queue-report-detail.js';
+/**
+ * Read the stable queue view for the delivery report.
+ *
+ * A missing queue file yields the deterministic unconfigured empty view so
+ * ordinary repositories never depend on a queue. Once the file exists, queue
+ * parse errors and ambiguous associations propagate unchanged. The projection
+ * reuses the established queue facade for state, failures, and spend, and adds
+ * report-only rejection and elapsed-time derivation.
+ */
+export declare function readQueueReport(projectRoot: string, config?: OsqConfig): Promise<QueueReport>;
+//# sourceMappingURL=queue-report.d.ts.map

package/dist/core/status/queue-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-report.d.ts","sourceRoot":"","sources":["../../../src/core/status/queue-report.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EACL,KAAK,WAAW,EAKjB,MAAM,0BAA0B,CAAC;AASlC,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AASlC;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,SAA0B,GACjC,OAAO,CAAC,WAAW,CAAC,CA6BtB"}

package/dist/core/status/queue-report.js

@@ -0,0 +1,41 @@
+import fs from 'node:fs/promises';
+import { DEFAULT_CONFIG } from '../foundation/config.js';
+import { emptyQueueReport, readQueueReportFailure, readQueueReportItem, readQueueReportRejections, } from './queue-report-detail.js';
+import { findActiveQueueFailures, getQueuePath, projectQueue, readQueuePlanningUsage, scanQueueAssociations, } from './queue.js';
+async function fileExists(filePath) {
+    return fs.stat(filePath).then(() => true, () => false);
+}
+/**
+ * Read the stable queue view for the delivery report.
+ *
+ * A missing queue file yields the deterministic unconfigured empty view so
+ * ordinary repositories never depend on a queue. Once the file exists, queue
+ * parse errors and ambiguous associations propagate unchanged. The projection
+ * reuses the established queue facade for state, failures, and spend, and adds
+ * report-only rejection and elapsed-time derivation.
+ */
+export async function readQueueReport(projectRoot, config = DEFAULT_CONFIG) {
+    if (!(await fileExists(getQueuePath(projectRoot, config))))
+        return emptyQueueReport();
+    const projection = await projectQueue(projectRoot, config);
+    const associations = await scanQueueAssociations(projectRoot, config, null);
+    const usage = await readQueuePlanningUsage(projectRoot, config);
+    const failures = await findActiveQueueFailures(projectRoot, config);
+    const items = await Promise.all(projection.items.map((row) => readQueueReportItem(row, associations.get(row.slug))));
+    const failureRows = await Promise.all(failures.map((failure) => readQueueReportFailure(projectRoot, config, failure)));
+    const rejections = await readQueueReportRejections(associations);
+    return {
+        configured: true,
+        landed: projection.landedCount,
+        total: projection.totalCount,
+        planning: {
+            sessions: usage.sessions,
+            cost: usage.cost,
+            costCoverageComplete: usage.costCoverageComplete,
+        },
+        items,
+        failures: failureRows,
+        rejections,
+    };
+}
+//# sourceMappingURL=queue-report.js.map

package/dist/core/status/queue-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-report.js","sourceRoot":"","sources":["../../../src/core/status/queue-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAEL,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAUpB,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC3B,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,SAAoB,cAAc;IAElC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAAE,OAAO,gBAAgB,EAAE,CAAC;IAEtF,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CACpF,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAChF,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,yBAAyB,CAAC,YAAY,CAAC,CAAC;IAEjE,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,UAAU,CAAC,WAAW;QAC9B,KAAK,EAAE,UAAU,CAAC,UAAU;QAC5B,QAAQ,EAAE;YACR,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;SACjD;QACD,KAAK;QACL,QAAQ,EAAE,WAAW;QACrB,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/core/status/queue-state.d.ts

@@ -0,0 +1,53 @@
+import { type OsqConfig } from '../foundation/config.js';
+import { type QueueItem } from './queue-parser.js';
+export type QueueItemState = 'landed' | 'dead' | 'running' | 'approved' | 'planned' | 'rejected' | 'unplanned';
+export interface QueueRow {
+    readonly slug: string;
+    readonly title: string;
+    readonly state: QueueItemState;
+    readonly changeId: string | null;
+    readonly rejectionCount: number;
+    readonly changedSincePlanned: boolean;
+    readonly unmetDependencies: readonly string[];
+}
+export type QueueProjection = {
+    items: QueueRow[];
+    landedCount: number;
+    totalCount: number;
+};
+export interface QueueActiveFailure {
+    readonly changeId: string;
+    readonly folderName: string;
+    readonly target: string;
+    readonly reason: string;
+    readonly retryCommand: string;
+}
+/** One change folder associated with a queue item through `brief.md` metadata. */
+export interface QueueAssociation {
+    readonly folderName: string;
+    readonly folderPath: string;
+    readonly id: string;
+    readonly queueHash: string | null;
+}
+export interface QueueAssociationGroups {
+    readonly active: QueueAssociation[];
+    readonly archived: QueueAssociation[];
+    readonly rejected: QueueAssociation[];
+}
+/** Internal state projection shared by queue planning and later report views. */
+export interface QueueStateSnapshot {
+    readonly items: QueueItem[];
+    readonly groups: Map<string, QueueAssociationGroups>;
+    readonly rows: QueueRow[];
+    readonly landed: Set<string>;
+}
+/** Scan active, archived, and rejected folders for queue metadata; null keeps retired slugs. */
+export declare function scanQueueAssociations(projectRoot: string, config: OsqConfig, slugs: ReadonlySet<string> | null): Promise<Map<string, QueueAssociationGroups>>;
+/** Project the current queue's filesystem-derived state for planning and report views. */
+export declare function readQueueState(projectRoot: string, config: OsqConfig): Promise<QueueStateSnapshot>;
+/** Derive the queue projection afresh from disk on every invocation. */
+export declare function projectQueue(projectRoot: string, config?: OsqConfig): Promise<QueueProjection>;
+/** Active dead, regressed, and change-level queue failures in numeric order. */
+export declare function findActiveQueueFailures(projectRoot: string, config?: OsqConfig): Promise<QueueActiveFailure[]>;
+export declare function formatQueue(projection: QueueProjection): string;
+//# sourceMappingURL=queue-state.d.ts.map

package/dist/core/status/queue-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-state.d.ts","sourceRoot":"","sources":["../../../src/core/status/queue-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGzE,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,mBAAmB,CAAC;AAS9D,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,MAAM,GACN,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,WAAW,CAAC;AAEhB,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAED,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC9B;AAID,gGAAgG;AAChG,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAChC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAgC9C;AA4CD,0FAA0F;AAC1F,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAwB7B;AAED,wEAAwE;AACxE,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,SAA0B,GACjC,OAAO,CAAC,eAAe,CAAC,CAG1B;AAgBD,gFAAgF;AAChF,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,SAA0B,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0B/B;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAY/D"}