@matteeh/osq 0.1.0 → 0.2.0

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

@@ -0,0 +1,167 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { DEFAULT_CONFIG } from '../foundation/config.js';
+import { parseFrontmatter } from '../spec/parser.js';
+import { getArchiveDir, getChangesDir, getRejectedDir } from './layout.js';
+import { readQueue } from './queue-parser.js';
+import { compareNumericPrefix, deriveSpecState, readChangeFolder, } from './state.js';
+const RESERVED_DIRS = new Set(['archive', 'rejected']);
+/** Scan active, archived, and rejected folders for queue metadata; null keeps retired slugs. */
+export async function scanQueueAssociations(projectRoot, config, slugs) {
+    const result = new Map();
+    const changesDir = getChangesDir(config.paths.openspecRoot, projectRoot);
+    const archiveDir = getArchiveDir(config.paths.openspecRoot, projectRoot);
+    const rejectedDir = getRejectedDir(config.paths.openspecRoot, projectRoot);
+    const scan = async (dir, location) => {
+        for (const entry of await fs.readdir(dir, { withFileTypes: true }).catch(() => [])) {
+            const { name } = entry;
+            if (!entry.isDirectory() || name.startsWith('.') || name.startsWith('_'))
+                continue;
+            if (location === 'active' && RESERVED_DIRS.has(name))
+                continue;
+            const folderPath = path.join(dir, name);
+            const content = await fs
+                .readFile(path.join(folderPath, 'brief.md'), 'utf8')
+                .catch(() => null);
+            if (content === null)
+                continue;
+            const { data } = parseFrontmatter(content);
+            const item = typeof data.queue_item === 'string' ? data.queue_item.trim() : '';
+            if (!item || (slugs && !slugs.has(item)))
+                continue;
+            const groups = result.get(item) ?? { active: [], archived: [], rejected: [] };
+            groups[location].push({
+                folderName: name,
+                folderPath,
+                id: name.match(/^(\d+)/)?.[1] ?? name,
+                queueHash: typeof data.queue_hash === 'string' ? data.queue_hash : null,
+            });
+            result.set(item, groups);
+        }
+    };
+    await scan(changesDir, 'active');
+    await scan(archiveDir, 'archived');
+    await scan(rejectedDir, 'rejected');
+    return result;
+}
+function mapActiveState(status) {
+    if (status === 'dead' || status === 'regressed')
+        return 'dead';
+    if (status === 'running')
+        return 'running';
+    if (status === 'unapproved')
+        return 'planned';
+    return 'approved';
+}
+function ambiguous(item, matches, location) {
+    const folders = matches
+        .map((m) => m.folderName)
+        .sort(compareNumericPrefix)
+        .join(', ');
+    return new Error(`Ambiguous queue association for "${item.slug}": multiple ${location} changes (${folders})`);
+}
+async function selectAssociation(projectRoot, item, groups) {
+    if (!groups)
+        return { state: 'unplanned', selected: null };
+    const { active, archived, rejected } = groups;
+    if (archived.length > 1)
+        throw ambiguous(item, archived, 'archived');
+    if (active.length > 1)
+        throw ambiguous(item, active, 'active');
+    if (archived.length === 1)
+        return { state: 'landed', selected: archived[0] };
+    if (active.length === 1) {
+        try {
+            const spec = await deriveSpecState(projectRoot, active[0].folderPath);
+            return { state: mapActiveState(spec.status), selected: active[0] };
+        }
+        catch {
+            // Active folder unreadable: fall through to rejected history.
+        }
+    }
+    if (rejected.length > 0) {
+        const ordered = [...rejected].sort((a, b) => compareNumericPrefix(a.folderName, b.folderName));
+        return { state: 'rejected', selected: ordered[ordered.length - 1] };
+    }
+    return { state: 'unplanned', selected: null };
+}
+/** Project the current queue's filesystem-derived state for planning and report views. */
+export async function readQueueState(projectRoot, config) {
+    const items = await readQueue(projectRoot, config);
+    const groups = await scanQueueAssociations(projectRoot, config, new Set(items.map((i) => i.slug)));
+    const chosen = await Promise.all(items.map((item) => selectAssociation(projectRoot, item, groups.get(item.slug))));
+    const landed = new Set(items.filter((_, i) => chosen[i].state === 'landed').map((i) => i.slug));
+    const rows = items.map((item, index) => {
+        const choice = chosen[index];
+        return {
+            slug: item.slug,
+            title: item.title,
+            state: choice.state,
+            changeId: choice.selected?.id ?? null,
+            rejectionCount: groups.get(item.slug)?.rejected.length ?? 0,
+            changedSincePlanned: choice.selected ? choice.selected.queueHash !== item.hash : false,
+            unmetDependencies: item.dependsOn.filter((dep) => !landed.has(dep)),
+        };
+    });
+    return { items, groups, rows, landed };
+}
+/** Derive the queue projection afresh from disk on every invocation. */
+export async function projectQueue(projectRoot, config = DEFAULT_CONFIG) {
+    const { rows, landed } = await readQueueState(projectRoot, config);
+    return { items: rows, landedCount: landed.size, totalCount: rows.length };
+}
+function activeFailure(assoc, target, reason) {
+    return {
+        changeId: assoc.id,
+        folderName: assoc.folderName,
+        target,
+        reason,
+        retryCommand: `osq retry ${assoc.id} ${target}`,
+    };
+}
+/** Active dead, regressed, and change-level queue failures in numeric order. */
+export async function findActiveQueueFailures(projectRoot, config = DEFAULT_CONFIG) {
+    const groups = await scanQueueAssociations(projectRoot, config, null);
+    const failures = [];
+    for (const group of groups.values()) {
+        for (const assoc of group.active) {
+            let state;
+            try {
+                state = deriveSpecState(await readChangeFolder(projectRoot, assoc.folderPath));
+            }
+            catch {
+                continue;
+            }
+            if (state.changeRegressed)
+                failures.push(activeFailure(assoc, 'change', 'regressed'));
+            for (const task of state.tasks) {
+                if (task.status === 'dead') {
+                    failures.push(activeFailure(assoc, task.taskNumber, task.deadReason ?? 'dead'));
+                }
+                else if (task.status === 'regressed') {
+                    failures.push(activeFailure(assoc, task.taskNumber, 'regressed'));
+                }
+            }
+        }
+    }
+    return failures.sort((a, b) => a.changeId.localeCompare(b.changeId, undefined, { numeric: true }) ||
+        a.target.localeCompare(b.target, undefined, { numeric: true }));
+}
+export function formatQueue(projection) {
+    const lines = ['Queue:'];
+    if (projection.items.length === 0)
+        lines.push('  (no items)');
+    for (const row of projection.items) {
+        let line = `  ${row.slug}: ${row.title} [${row.state}]`;
+        if (row.changeId)
+            line += ` change: ${row.changeId}`;
+        line += ` rejections: ${row.rejectionCount}`;
+        if (row.unmetDependencies.length > 0)
+            line += ` unmet: ${row.unmetDependencies.join(', ')}`;
+        if (row.changedSincePlanned)
+            line += ' changed since planned';
+        lines.push(line);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=queue-state.js.map

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

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

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

@@ -0,0 +1,7 @@
+export type { QueueItem } from './queue-parser.js';
+export { getQueuePath, parseQueue, readQueue } from './queue-parser.js';
+export type { QueueActiveFailure, QueueAssociation, QueueAssociationGroups, QueueItemState, QueueProjection, QueueRow, QueueStateSnapshot, } from './queue-state.js';
+export { findActiveQueueFailures, formatQueue, projectQueue, readQueueState, scanQueueAssociations, } from './queue-state.js';
+export type { LandedDependency, QueueBudgetEvaluation, QueuePlanPreparation, QueuePlanSelection, QueuePlanningUsage, } from './queue-planning.js';
+export { evaluateQueueBudget, prepareQueuePlan, readQueuePlanningUsage, } from './queue-planning.js';
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/core/status/queue.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/core/status/queue.js

@@ -0,0 +1,4 @@
+export { getQueuePath, parseQueue, readQueue } from './queue-parser.js';
+export { findActiveQueueFailures, formatQueue, projectQueue, readQueueState, scanQueueAssociations, } from './queue-state.js';
+export { evaluateQueueBudget, prepareQueuePlan, readQueuePlanningUsage, } from './queue-planning.js';
+//# sourceMappingURL=queue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/core/status/queue.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAUxE,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/core/status/show.d.ts

@@ -0,0 +1,102 @@
+import { type OsqConfig } from '../foundation/config.js';
+import { type SpecStatus, type TaskStatus } from './state.js';
+export interface TimelineEvent {
+    taskNumber: string;
+    type: string;
+    timestamp: string;
+    data?: Record<string, unknown>;
+}
+/** One differing path paired with its recorded later-task attribution. */
+export interface RecertificationAttribution {
+    path: string;
+    attribution: string;
+}
+/**
+ * One human recertification decision projected from a typed `recertification`
+ * event. Every optional field is independently nullable so malformed event data
+ * renders as unavailable without dropping the decision.
+ */
+export interface RecertificationDetail {
+    taskNumber: string;
+    timestamp: string | null;
+    outcome: 'passed' | 'requeued' | null;
+    differingPaths: string[];
+    attribution: RecertificationAttribution[];
+    verify: string | null;
+    exitCode: number | null;
+    timedOut: boolean | null;
+}
+export interface TaskDetail {
+    taskNumber: string;
+    fileName: string;
+    title: string;
+    status: TaskStatus;
+    verify: string;
+    scope: string[];
+    entry: string[];
+    skills: string[];
+    acceptance: string[];
+    deadReason?: string;
+    deadDiagnostic?: string;
+    regressedReason?: string;
+    regressedDiagnostic?: string;
+    resultContent?: string;
+    events: TimelineEvent[];
+}
+/**
+ * One correlated planning lifecycle pair for display. Only lifecycle
+ * identity, timing, and outcome are exposed; token usage and artifact paths
+ * stay in the append-only log.
+ */
+export interface PlanningSessionDetail {
+    sessionId: string;
+    startTime: string;
+    harness: string;
+    /** Null when neither the owned nor the observed record reported a model. */
+    model: string | null;
+    agent?: string;
+    exitCode: number | null;
+    wallSeconds: number | null;
+}
+export interface SpecDetails {
+    id: string;
+    folderName: string;
+    folderPath: string;
+    isArchived: boolean;
+    location: 'active' | 'archived' | 'rejected';
+    title: string;
+    status: SpecStatus;
+    approvedHash: string | null;
+    dependsOn: string[];
+    features: {
+        reads: string[];
+        writes: string[];
+    };
+    goal: string;
+    contract: string;
+    nonGoals: string;
+    delta: string;
+    tasks: TaskDetail[];
+    planningSessions: PlanningSessionDetail[];
+    recertifications: RecertificationDetail[];
+    timeline: TimelineEvent[];
+}
+export declare function resolveSpecFolder(projectRoot: string, idOrPrefix: string, config?: OsqConfig): Promise<{
+    folderPath: string;
+    isArchived: boolean;
+    location: 'active' | 'archived' | 'rejected';
+}>;
+export declare function getSpecDetails(projectRoot: string, specIdOrPrefix: string, config?: OsqConfig): Promise<SpecDetails>;
+/**
+ * Builds the complete change detail for an already resolved folder in any of
+ * the three canonical locations. Selector discovery stays with the caller.
+ */
+export declare function getSpecDetailsFromFolder(projectRoot: string, folderPath: string, location: 'active' | 'archived' | 'rejected', config?: OsqConfig): Promise<SpecDetails>;
+export declare function formatSpecDetails(details: SpecDetails): string;
+/**
+ * Alias for {@link formatSpecDetails} matching the show-output name used by
+ * the status-inspection spec. Displays the dead reason (including
+ * `undeclared_test_change`) and its failure diagnostic.
+ */
+export declare const formatShowOutput: typeof formatSpecDetails;
+//# sourceMappingURL=show.d.ts.map

package/dist/core/status/show.d.ts.map

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