@matteeh/osq 0.1.0 → 0.2.0

package/dist/cli/lint.js

@@ -0,0 +1,60 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { loadConfig } from '../core/foundation/config.js';
+import { createLogger } from '../core/foundation/logger.js';
+import { findSpecFolder } from '../core/spec/approve.js';
+import { lintChangeFolder } from '../core/spec/linter.js';
+import { getChangesDir } from '../core/status/layout.js';
+async function listChangeFolders(specsDir) {
+    let entries = [];
+    try {
+        entries = await fs.readdir(specsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((entry) => entry.isDirectory() && entry.name !== 'archive' && !entry.name.startsWith('_'))
+        .map((entry) => path.join(specsDir, entry.name))
+        .sort();
+}
+/**
+ * Lints one or more change folders (or every folder under the configured specs
+ * root when no IDs are given) and exits non-zero on failure. The exit sink is
+ * injectable so callers can test the failure path without terminating the
+ * process.
+ */
+export async function lintCommand(specIds = [], options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const config = options.config ?? (await loadConfig(cwd));
+    const logger = options.logger ?? createLogger('normal', 'osq');
+    const specsDir = getChangesDir(config.paths.openspecRoot, cwd);
+    const folders = specIds.length > 0
+        ? await Promise.all(specIds.map((id) => findSpecFolder(specsDir, id)))
+        : await listChangeFolders(specsDir);
+    const entries = [];
+    for (const folder of folders) {
+        const name = path.basename(folder);
+        const result = await lintChangeFolder(cwd, folder, config, { logger });
+        for (const error of result.errors) {
+            logger.error(`${name}: ${error}`);
+        }
+        for (const warning of result.warnings) {
+            logger.warn(`${name}: ${warning}`);
+        }
+        if (result.valid) {
+            logger.info(`${name}: valid`);
+        }
+        entries.push({ folder, result });
+    }
+    const valid = entries.every((entry) => entry.result.valid);
+    if (!valid) {
+        const exit = options.exit ??
+            ((code) => {
+                process.exitCode = code;
+            });
+        exit(1);
+    }
+    return { valid, entries };
+}
+//# sourceMappingURL=lint.js.map

package/dist/cli/lint.js.map

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

package/dist/cli/migrate.d.ts

@@ -0,0 +1,18 @@
+import { type OsqConfig } from '../core/foundation/config.js';
+import { type Logger } from '../core/foundation/logger.js';
+import { type MigrateResult } from '../core/spec/migrate.js';
+export interface MigrateCommandOptions {
+    readonly cwd?: string;
+    readonly config?: OsqConfig;
+    readonly logger?: Pick<Logger, 'info' | 'error'>;
+    readonly exit?: (code: number) => void;
+}
+export type MigrateCommandLogger = Pick<Logger, 'info' | 'error'>;
+/**
+ * Runs `osq migrate <target>`. Only the `openspec` target exists: it moves the
+ * legacy layout to `openspec/`, converts `spec.md` to `proposal.md`, ticks
+ * archived tasks, and creates the next-spec stub. Returns `null` when the
+ * target is unsupported or migration throws, after signalling a non-zero exit.
+ */
+export declare function migrateCommand(target: string, options?: MigrateCommandOptions): Promise<MigrateResult | null>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/cli/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/cli/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,yBAAyB,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAElE;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAqC/B"}

package/dist/cli/migrate.js

@@ -0,0 +1,42 @@
+import { loadConfig } from '../core/foundation/config.js';
+import { createLogger } from '../core/foundation/logger.js';
+import { migrateToOpenSpec } from '../core/spec/migrate.js';
+/**
+ * Runs `osq migrate <target>`. Only the `openspec` target exists: it moves the
+ * legacy layout to `openspec/`, converts `spec.md` to `proposal.md`, ticks
+ * archived tasks, and creates the next-spec stub. Returns `null` when the
+ * target is unsupported or migration throws, after signalling a non-zero exit.
+ */
+export async function migrateCommand(target, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const logger = options.logger ?? createLogger('normal', 'osq');
+    const exit = options.exit ??
+        ((code) => {
+            process.exitCode = code;
+        });
+    if (target !== 'openspec') {
+        logger.error(`unsupported migrate target "${target}"; expected "openspec"`);
+        exit(1);
+        return null;
+    }
+    try {
+        const config = options.config ?? (await loadConfig(cwd));
+        const result = await migrateToOpenSpec({ cwd, config });
+        logger.info(`migrated ${result.migratedFeatures.length} feature doc(s) to openspec/specs/`);
+        logger.info(`migrated ${result.migratedChanges.length} active change(s) to openspec/changes/`);
+        logger.info(`migrated ${result.migratedArchives.length} archived change(s) to openspec/changes/archive/`);
+        logger.info(`converted ${result.convertedProposals.length} spec.md file(s) to proposal.md`);
+        logger.info(`ticked ${result.tickedTasks.length} archived tasks.md file(s)`);
+        if (result.createdStub) {
+            logger.info(`created next-spec stub ${result.createdStub}`);
+        }
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(`migration failed: ${message}`);
+        exit(1);
+        return null;
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/cli/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/cli/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAe,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAsB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAWhF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,UAAiC,EAAE;IAEnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/D,MAAM,IAAI,GACR,OAAO,CAAC,IAAI;QACZ,CAAC,CAAC,IAAY,EAAE,EAAE;YAChB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC1B,CAAC,CAAC,CAAC;IAEL,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,+BAA+B,MAAM,wBAAwB,CAAC,CAAC;QAC5E,IAAI,CAAC,CAAC,CAAC,CAAC;QACR,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAExD,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,gBAAgB,CAAC,MAAM,oCAAoC,CAAC,CAAC;QAC5F,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,eAAe,CAAC,MAAM,wCAAwC,CAAC,CAAC;QAC/F,MAAM,CAAC,IAAI,CACT,YAAY,MAAM,CAAC,gBAAgB,CAAC,MAAM,kDAAkD,CAC7F,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,kBAAkB,CAAC,MAAM,iCAAiC,CAAC,CAAC;QAC5F,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,WAAW,CAAC,MAAM,4BAA4B,CAAC,CAAC;QAC7E,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,CAAC,CAAC;QACR,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cli/new.js

@@ -1,4 +1,4 @@
-import { createNewSpec } from '../core/new.js';
+import { createNewSpec } from '../core/foundation/new.js';
 export async function newCommand(name, options = {}) {
     const cwd = options.cwd || process.cwd();
     try {

package/dist/cli/new.js.map

@@ -1 +1 @@
-{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/cli/new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,UAA4B,EAAE;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/cli/new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,UAA4B,EAAE;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/plan-queue.d.ts

@@ -0,0 +1,50 @@
+import type { OsqConfig } from '../core/foundation/config.js';
+import { type QueuePlanSelection } from '../core/status/queue.js';
+export declare function formatBriefContent(body: string, plannerModel: string | null, today: string, metadata?: Record<string, string>): string;
+/** The first four ordered prompt sections; the repository record is appended by `plan.ts`. */
+export declare function buildBaseOpeningPrompt(options: {
+    projectRoot: string;
+    folderPath: string;
+    specId: string;
+    specTitle: string;
+    briefContent: string;
+    openspecRoot: string;
+    dependencyPaths?: readonly string[];
+}): Promise<string>;
+export declare function readBriefInput(briefOption?: string): Promise<string>;
+/**
+ * Default handoff: persist the transient prompt beside the change and name the
+ * exact change an available planning tool should pick up.
+ */
+export declare function writePromptHandoff(folderPath: string, openingPrompt: string): Promise<void>;
+/** Reject ordinary and queue mode combinations before any file is touched. */
+export declare function validatePlanModeOptions(name: string, options: {
+    next?: boolean;
+    replan?: boolean;
+    brief?: string;
+    print?: boolean;
+    session?: boolean;
+}): void;
+/**
+ * Run the read-only next-item preparation with the explicit config the caller
+ * already loaded. Refusals and the incomplete-cost notice are reported here and
+ * nothing is written; `null` tells the caller to stop before mutation.
+ */
+export declare function prepareQueueSelection(projectRoot: string, config: OsqConfig, options: {
+    replan?: boolean;
+    print?: boolean;
+}): Promise<QueuePlanSelection | null>;
+export declare function createChange(projectRoot: string, quiet: boolean | undefined, title: string, options: {
+    slug?: string;
+    dependsOn?: readonly string[];
+}): Promise<{
+    folderPath: string;
+    specId: string;
+}>;
+export declare function writeBriefAndManifest(projectRoot: string, config: OsqConfig, folderPath: string, plannerModel: string | null, briefBody: string, metadata?: Record<string, string>): Promise<void>;
+/** Create the selected queue item's change with queue metadata on its brief. */
+export declare function createQueueChange(projectRoot: string, config: OsqConfig, quiet: boolean | undefined, selection: QueuePlanSelection, plannerModel: string | null): Promise<{
+    folderPath: string;
+    specId: string;
+}>;
+//# sourceMappingURL=plan-queue.d.ts.map

package/dist/cli/plan-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-queue.d.ts","sourceRoot":"","sources":["../../src/cli/plan-queue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAK9D,OAAO,EAAE,KAAK,kBAAkB,EAAoB,MAAM,yBAAyB,CAAC;AAEpF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACpC,MAAM,CAeR;AAED,8FAA8F;AAC9F,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClB;AAED,wBAAsB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC1E;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjG;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,IAAI,CAYN;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAYpC;AAED,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACxD,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAUjD;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,gFAAgF;AAChF,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,SAAS,EAAE,kBAAkB,EAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAcjD"}

package/dist/cli/plan-queue.js

@@ -0,0 +1,167 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { createNewSpec } from '../core/foundation/new.js';
+import { buildManifest, writeManifest } from '../core/run/manifest.js';
+import { parseFrontmatter } from '../core/spec/parser.js';
+import { getSpecsDir } from '../core/status/layout.js';
+import { prepareQueuePlan } from '../core/status/queue.js';
+export function formatBriefContent(body, plannerModel, today, metadata = {}) {
+    const trimmed = body.trim();
+    const parsed = parseFrontmatter(trimmed);
+    const frontmatterData = {
+        ...metadata,
+        ...parsed.data,
+        planner: plannerModel,
+        date: today,
+    };
+    const yamlLines = Object.entries(frontmatterData).map(([k, v]) => `${k}: ${v}`);
+    const fm = `---\n${yamlLines.join('\n')}\n---\n\n`;
+    const cleanBody = parsed.body.trim();
+    return `${fm}${cleanBody}\n`;
+}
+/** The first four ordered prompt sections; the repository record is appended by `plan.ts`. */
+export async function buildBaseOpeningPrompt(options) {
+    const { projectRoot, folderPath, specId, specTitle, briefContent, openspecRoot } = options;
+    let plannerMd = '';
+    try {
+        plannerMd = await fs.readFile(path.join(projectRoot, 'PLANNER.md'), 'utf8');
+    }
+    catch {
+        plannerMd = '# Planning a change for osq\n';
+    }
+    const changeLines = [
+        `# Change: ${specId} - ${specTitle}`,
+        `Change ID: ${specId}`,
+        `Change Folder: ${path.basename(folderPath)}`,
+    ];
+    if (options.dependencyPaths && options.dependencyPaths.length > 0) {
+        const paths = options.dependencyPaths.map((dep) => `- ${dep}`).join('\n');
+        changeLines.push(`Landed dependencies:\n${paths}`);
+    }
+    const changeHeader = changeLines.join('\n');
+    const specsDir = getSpecsDir(openspecRoot, projectRoot);
+    const specPaths = [];
+    try {
+        const entries = await fs.readdir(specsDir, { withFileTypes: true });
+        for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+            if (entry.isDirectory()) {
+                const rel = path.relative(projectRoot, path.join(specsDir, entry.name, 'spec.md'));
+                specPaths.push(rel);
+            }
+        }
+    }
+    catch { }
+    const specsHeader = `## Capability Specs\n\n${specPaths.map((p) => `- ${p}`).join('\n')}`;
+    const briefHeader = `## Brief\n\n${briefContent.trim()}`;
+    return [plannerMd.trim(), changeHeader.trim(), specsHeader.trim(), briefHeader.trim()].join('\n\n');
+}
+export async function readBriefInput(briefOption) {
+    if (briefOption === '-') {
+        return new Promise((resolve, reject) => {
+            let data = '';
+            process.stdin.setEncoding('utf8');
+            process.stdin.on('data', (chunk) => {
+                data += chunk;
+            });
+            process.stdin.on('end', () => resolve(data));
+            process.stdin.on('error', reject);
+        });
+    }
+    if (briefOption) {
+        return await fs.readFile(briefOption, 'utf8');
+    }
+    const editor = process.env.VISUAL || process.env.EDITOR;
+    if (editor) {
+        const tempFile = path.join(os.tmpdir(), `osq-brief-${Date.now()}.md`);
+        await fs.writeFile(tempFile, '# Feature Brief\n\nDescribe the goal, background, and requirements here.\n', 'utf8');
+        try {
+            const parts = editor.trim().split(/\s+/);
+            const res = spawnSync(parts[0], [...parts.slice(1), tempFile], {
+                stdio: 'inherit',
+            });
+            if (res.error || res.status !== 0) {
+                throw new Error(`Editor ${editor} exited with code ${res.status}`);
+            }
+            return await fs.readFile(tempFile, 'utf8');
+        }
+        finally {
+            await fs.rm(tempFile, { force: true }).catch(() => { });
+        }
+    }
+    throw new Error('No brief provided. Specify --brief <file> or set $EDITOR.');
+}
+/**
+ * Default handoff: persist the transient prompt beside the change and name the
+ * exact change an available planning tool should pick up.
+ */
+export async function writePromptHandoff(folderPath, openingPrompt) {
+    await fs.writeFile(path.join(folderPath, 'plan-prompt.md'), openingPrompt, 'utf8');
+    console.log(`${folderPath}: ask your planning tool to plan change ${path.basename(folderPath)}`);
+}
+/** Reject ordinary and queue mode combinations before any file is touched. */
+export function validatePlanModeOptions(name, options) {
+    if (options.session && options.print) {
+        throw new Error('`--session` cannot be combined with `--print`');
+    }
+    if (options.next) {
+        if (name)
+            throw new Error('`plan --next` cannot be combined with a change name');
+        if (options.brief)
+            throw new Error('`plan --next` cannot be combined with --brief');
+    }
+    else if (options.replan) {
+        throw new Error('`--replan` is valid only with `plan --next`');
+    }
+    else if (!name) {
+        throw new Error('Provide a change name or use `plan --next`');
+    }
+}
+/**
+ * Run the read-only next-item preparation with the explicit config the caller
+ * already loaded. Refusals and the incomplete-cost notice are reported here and
+ * nothing is written; `null` tells the caller to stop before mutation.
+ */
+export async function prepareQueueSelection(projectRoot, config, options) {
+    const preparation = await prepareQueuePlan(projectRoot, config, {
+        replan: options.replan,
+        enforceBudget: !options.print,
+    });
+    if (preparation.kind === 'refused') {
+        console.error(preparation.message);
+        process.exitCode = 1;
+        return null;
+    }
+    if (preparation.notice)
+        console.error(preparation.notice);
+    return preparation.selection;
+}
+export async function createChange(projectRoot, quiet, title, options) {
+    const newResult = await createNewSpec(projectRoot, title, {
+        slug: options.slug,
+        dependsOn: options.dependsOn,
+    });
+    if (!quiet) {
+        console.log(`Created spec ${newResult.specId}: ${newResult.folderName}`);
+        console.log(`  Path: ${newResult.folderPath}`);
+    }
+    return { folderPath: newResult.folderPath, specId: newResult.specId };
+}
+export async function writeBriefAndManifest(projectRoot, config, folderPath, plannerModel, briefBody, metadata) {
+    const today = new Date().toISOString().split('T')[0];
+    await fs.writeFile(path.join(folderPath, 'brief.md'), formatBriefContent(briefBody, plannerModel, today, metadata), 'utf8');
+    const runDir = path.join(folderPath, '.run');
+    await fs.mkdir(runDir, { recursive: true });
+    await writeManifest(runDir, await buildManifest(projectRoot, folderPath, config));
+}
+/** Create the selected queue item's change with queue metadata on its brief. */
+export async function createQueueChange(projectRoot, config, quiet, selection, plannerModel) {
+    const created = await createChange(projectRoot, quiet, selection.item.title, {
+        slug: selection.item.slug,
+        dependsOn: selection.landedDependencies.map((dep) => dep.changeId),
+    });
+    await writeBriefAndManifest(projectRoot, config, created.folderPath, plannerModel, selection.item.body, { queue_item: selection.item.slug, queue_hash: selection.item.hash });
+    return created;
+}
+//# sourceMappingURL=plan-queue.js.map

package/dist/cli/plan-queue.js.map

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

package/dist/cli/plan.d.ts

@@ -0,0 +1,35 @@
+import { type OsqConfig } from '../core/foundation/config.js';
+import type { HarnessAdapter } from '../harness/types.js';
+import { readBriefInput } from './plan-queue.js';
+export { formatBriefContent } from './plan-queue.js';
+export { readBriefInput };
+/** Exact heading of the fifth ordered planning-prompt section. */
+export declare const REPOSITORY_RECORD_HEADING = "## This repository's record";
+export interface OpeningPromptOptions {
+    projectRoot: string;
+    folderPath: string;
+    specId: string;
+    specTitle: string;
+    briefContent: string;
+    openspecRoot: string;
+    dependencyPaths?: readonly string[];
+    config?: OsqConfig;
+    recordBody?: string;
+}
+/**
+ * Compose the opening prompt with the repository record as the fifth ordered
+ * section. The record body comes from the shared report derivation over the 20
+ * most recent canonical archives, or from a caller-supplied preformatted body.
+ */
+export declare function buildOpeningPrompt(options: OpeningPromptOptions): Promise<string>;
+export interface PlanCommandOptions {
+    brief?: string;
+    print?: boolean;
+    session?: boolean;
+    next?: boolean;
+    replan?: boolean;
+    cwd?: string;
+    adapter?: HarnessAdapter;
+}
+export declare function planCommand(nameOrId: string | undefined, options?: PlanCommandOptions): Promise<void>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/cli/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/cli/plan.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,8BAA8B,CAAC;AAQ1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAKL,cAAc,EAIf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAWvF;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAsIf"}

package/dist/cli/plan.js

@@ -0,0 +1,153 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolvePlannerSelection } from '../core/foundation/config-codex.js';
+import { loadConfig } from '../core/foundation/config.js';
+import { readPlanningUsage, recordPlanExited, recordPlanStarted } from '../core/report/planning.js';
+import { formatRepositoryRecordBody, getRepositoryRecord } from '../core/report/report.js';
+import { findSpecFolder } from '../core/spec/approve.js';
+import { parseFrontmatter } from '../core/spec/parser.js';
+import { getChangesDir } from '../core/status/layout.js';
+import { getHarnessAdapter } from '../harness/index.js';
+import { buildBaseOpeningPrompt, createChange, createQueueChange, prepareQueueSelection, readBriefInput, validatePlanModeOptions, writeBriefAndManifest, writePromptHandoff, } from './plan-queue.js';
+export { formatBriefContent } from './plan-queue.js';
+export { readBriefInput };
+/** Exact heading of the fifth ordered planning-prompt section. */
+export const REPOSITORY_RECORD_HEADING = "## This repository's record";
+/**
+ * Compose the opening prompt with the repository record as the fifth ordered
+ * section. The record body comes from the shared report derivation over the 20
+ * most recent canonical archives, or from a caller-supplied preformatted body.
+ */
+export async function buildOpeningPrompt(options) {
+    const base = await buildBaseOpeningPrompt(options);
+    const recordBody = options.recordBody ??
+        formatRepositoryRecordBody(await getRepositoryRecord(options.projectRoot, options.config ?? (await loadConfig(options.projectRoot))));
+    return `${base}\n\n${REPOSITORY_RECORD_HEADING}\n\n${recordBody}`;
+}
+export async function planCommand(nameOrId, options = {}) {
+    const name = (nameOrId ?? '').trim();
+    validatePlanModeOptions(name, options);
+    const cwd = options.cwd || process.cwd();
+    const config = await loadConfig(cwd);
+    const changesDir = getChangesDir(config.paths.openspecRoot, cwd);
+    // The planner is resolved only for an explicit owned session; the default
+    // prompt handoff and print modes never need planner configuration.
+    const isSession = options.session === true;
+    const plannerSelection = isSession ? resolvePlannerSelection(config) : null;
+    const briefModel = plannerSelection?.briefModel ?? null;
+    const quiet = !isSession;
+    let queueSelection = null;
+    let folderPath = null;
+    let specId = null;
+    let isResumed = false;
+    if (options.next) {
+        const selection = await prepareQueueSelection(cwd, config, {
+            replan: options.replan,
+            print: options.print,
+        });
+        if (!selection)
+            return;
+        queueSelection = selection;
+    }
+    else {
+        try {
+            folderPath = await findSpecFolder(changesDir, name);
+            const briefExists = await fs
+                .stat(path.join(folderPath, 'brief.md'))
+                .then(() => true)
+                .catch(() => false);
+            if (briefExists) {
+                isResumed = true;
+                const folderName = path.basename(folderPath);
+                specId = folderName.match(/^(\d+)/)?.[1] || folderName;
+            }
+        }
+        catch { }
+    }
+    if (queueSelection) {
+        const created = await createQueueChange(cwd, config, quiet, queueSelection, briefModel);
+        folderPath = created.folderPath;
+        specId = created.specId;
+    }
+    else if (!isResumed) {
+        const created = await createChange(cwd, quiet, name, {});
+        folderPath = created.folderPath;
+        specId = created.specId;
+        const rawBrief = await readBriefInput(options.brief);
+        await writeBriefAndManifest(cwd, config, folderPath, briefModel, rawBrief);
+    }
+    if (!folderPath || !specId) {
+        throw new Error('Failed to resolve change folder');
+    }
+    const briefPath = path.join(folderPath, 'brief.md');
+    const briefContent = await fs.readFile(briefPath, 'utf8');
+    let specTitle = name;
+    try {
+        const proposalContent = await fs.readFile(path.join(folderPath, 'proposal.md'), 'utf8');
+        const parsed = parseFrontmatter(proposalContent);
+        if (parsed.data.title) {
+            specTitle = String(parsed.data.title);
+        }
+    }
+    catch { }
+    const openingPrompt = await buildOpeningPrompt({
+        projectRoot: cwd,
+        folderPath,
+        specId,
+        specTitle,
+        briefContent,
+        openspecRoot: config.paths.openspecRoot,
+        dependencyPaths: queueSelection?.landedDependencies.map((dep) => dep.archivePath),
+        config,
+    });
+    if (options.print) {
+        process.stdout.write(`${openingPrompt}\n`);
+        return;
+    }
+    if (!plannerSelection) {
+        await writePromptHandoff(folderPath, openingPrompt);
+        return;
+    }
+    const adapter = options.adapter || getHarnessAdapter(plannerSelection.harness);
+    const started = await recordPlanStarted(folderPath, {
+        harness: plannerSelection.harness,
+        model: plannerSelection.model || plannerSelection.briefModel || 'default',
+        ...(plannerSelection.agent ? { agent: plannerSelection.agent } : {}),
+        briefPath,
+    });
+    // Timing brackets the child: the reader runs only after it has closed.
+    let exitCode = 1;
+    let spawnError;
+    try {
+        if (!adapter.spawnInteractive) {
+            throw new Error(`Harness adapter for '${plannerSelection.harness}' does not support interactive sessions.`);
+        }
+        exitCode = await adapter.spawnInteractive({
+            prompt: openingPrompt,
+            cwd,
+            model: plannerSelection.model,
+            agent: plannerSelection.agent,
+        });
+    }
+    catch (error) {
+        spawnError = error;
+    }
+    const endedAtMs = Date.now();
+    const usage = await readPlanningUsage(adapter.readInteractiveUsage, {
+        cwd,
+        startedAt: started.timestamp,
+        endedAt: new Date(endedAtMs).toISOString(),
+    });
+    await recordPlanExited(folderPath, {
+        sessionId: started.sessionId,
+        startedAtMs: started.startedAtMs,
+        endedAtMs,
+        exitCode,
+        usage,
+    });
+    if (spawnError)
+        throw spawnError;
+    if (exitCode !== 0)
+        process.exitCode = exitCode;
+}
+//# sourceMappingURL=plan.js.map

package/dist/cli/plan.js.map

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

package/dist/cli/queue.d.ts

@@ -0,0 +1,9 @@
+import { type OsqConfig } from '../core/foundation/config.js';
+export interface QueueCommandOptions {
+    cwd?: string;
+    stdout?: (msg: string) => void;
+    config?: OsqConfig;
+}
+/** Thin CLI wrapper: load config, project the read-only queue, and print it. */
+export declare function queueCommand(options?: QueueCommandOptions): Promise<string>;
+//# sourceMappingURL=queue.d.ts.map

package/dist/cli/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/cli/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,8BAA8B,CAAC;AAG1E,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,gFAAgF;AAChF,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBrF"}

package/dist/cli/queue.js

@@ -0,0 +1,24 @@
+import { loadConfig } from '../core/foundation/config.js';
+import { formatQueue, projectQueue } from '../core/status/queue.js';
+/** Thin CLI wrapper: load config, project the read-only queue, and print it. */
+export async function queueCommand(options = {}) {
+    const cwd = options.cwd || process.cwd();
+    const config = options.config || (await loadConfig(cwd));
+    try {
+        const projection = await projectQueue(cwd, config);
+        const formatted = formatQueue(projection);
+        if (options.stdout) {
+            options.stdout(formatted);
+        }
+        else {
+            console.log(formatted);
+        }
+        return formatted;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Queue error: ${message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/cli/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/cli/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAQpE,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA+B,EAAE;IAClE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}