@matteeh/osq 0.1.0 → 0.2.0

package/dist/core/foundation/init-managed.js

@@ -0,0 +1,115 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { CLAUDE_PLAN_COMMAND_PATH, MANAGED_AGENTS_MD_BODY, MANAGED_CLAUDE_PLAN_COMMAND, MANAGED_PLANNER_BLOCK, OSQ_END_MARKER, OSQ_START_MARKER, } from './init-blocks.js';
+/** New-file preamble for the managed Claude command. */
+const CLAUDE_PLAN_COMMAND_TITLE = 'Plan a change with osq';
+function countOccurrences(haystack, needle) {
+    return haystack.split(needle).length - 1;
+}
+/**
+ * Compare one document's osq marker pair against the installed canonical block.
+ * Returns `null` only when exactly one well-formed, current pair is present.
+ */
+export function inspectManagedBlock(content, canonical) {
+    const starts = countOccurrences(content, OSQ_START_MARKER);
+    const ends = countOccurrences(content, OSQ_END_MARKER);
+    if (starts === 0 && ends === 0)
+        return 'missing-block';
+    if (starts > 1 || ends > 1)
+        return 'duplicated';
+    if (starts === 0 || ends === 0)
+        return 'partial';
+    const start = content.indexOf(OSQ_START_MARKER);
+    const end = content.indexOf(OSQ_END_MARKER);
+    if (end < start)
+        return 'reversed';
+    const block = content.slice(start, end + OSQ_END_MARKER.length);
+    return block === canonical ? null : 'stale';
+}
+/**
+ * Locate every removable osq marker range. Well-formed pairs are removed whole;
+ * a stray marker (unterminated start, orphan end, or reversed pair) is removed
+ * as its own token so repair always converges on exactly one canonical block.
+ */
+function markerRanges(content) {
+    const markers = [];
+    for (const [kind, marker] of [
+        ['start', OSQ_START_MARKER],
+        ['end', OSQ_END_MARKER],
+    ]) {
+        let from = 0;
+        while (true) {
+            const index = content.indexOf(marker, from);
+            if (index === -1)
+                break;
+            markers.push({ kind, index });
+            from = index + marker.length;
+        }
+    }
+    markers.sort((a, b) => a.index - b.index);
+    const ranges = [];
+    let openStart = null;
+    for (const marker of markers) {
+        if (marker.kind === 'start') {
+            if (openStart !== null) {
+                ranges.push({ start: openStart, end: openStart + OSQ_START_MARKER.length });
+            }
+            openStart = marker.index;
+        }
+        else if (openStart !== null) {
+            ranges.push({ start: openStart, end: marker.index + OSQ_END_MARKER.length });
+            openStart = null;
+        }
+        else {
+            ranges.push({ start: marker.index, end: marker.index + OSQ_END_MARKER.length });
+        }
+    }
+    if (openStart !== null) {
+        ranges.push({ start: openStart, end: openStart + OSQ_START_MARKER.length });
+    }
+    return ranges.sort((a, b) => a.start - b.start);
+}
+/** Replace every osq block with exactly one current canonical block. */
+function replaceManagedBlock(content, block) {
+    const ranges = markerRanges(content);
+    if (ranges.length === 0) {
+        const separator = content.endsWith('\n\n') ? '' : content.endsWith('\n') ? '\n' : '\n\n';
+        return `${content}${separator}${block}\n`;
+    }
+    let result = '';
+    let cursor = 0;
+    for (let index = 0; index < ranges.length; index += 1) {
+        const range = ranges[index];
+        result += content.slice(cursor, range.start);
+        if (index === 0)
+            result += block;
+        cursor = range.end;
+    }
+    return result + content.slice(cursor);
+}
+async function pathExists(targetPath) {
+    return fs
+        .stat(targetPath)
+        .then(() => true)
+        .catch(() => false);
+}
+async function writeManagedBlock(filePath, title, block) {
+    if (!(await pathExists(filePath))) {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, `# ${title}\n\n${block}\n`, 'utf8');
+        return true;
+    }
+    const currentContent = await fs.readFile(filePath, 'utf8');
+    await fs.writeFile(filePath, replaceManagedBlock(currentContent, block), 'utf8');
+    return true;
+}
+export async function updateAgentsMd(targetDir) {
+    return writeManagedBlock(path.join(targetDir, 'AGENTS.md'), 'AGENTS', MANAGED_AGENTS_MD_BODY);
+}
+export async function updatePlannerMd(targetDir) {
+    return writeManagedBlock(path.join(targetDir, 'PLANNER.md'), 'Planning a change for osq', MANAGED_PLANNER_BLOCK);
+}
+export async function updateClaudePlanCommand(targetDir) {
+    return writeManagedBlock(path.join(targetDir, CLAUDE_PLAN_COMMAND_PATH), CLAUDE_PLAN_COMMAND_TITLE, MANAGED_CLAUDE_PLAN_COMMAND);
+}
+//# sourceMappingURL=init-managed.js.map

package/dist/core/foundation/init-managed.js.map

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

package/dist/core/foundation/init.d.ts

@@ -0,0 +1,18 @@
+export { TEMPLATES_ROOT } from './package-root.js';
+export { CLAUDE_PLAN_COMMAND_PATH, MANAGED_AGENTS_BLOCK, MANAGED_AGENTS_MD_BODY, MANAGED_CLAUDE_PLAN_COMMAND, MANAGED_PLANNER_BLOCK, OSQ_END_MARKER, OSQ_START_MARKER, } from './init-blocks.js';
+export { inspectManagedBlock, updateAgentsMd, updateClaudePlanCommand, updatePlannerMd, } from './init-managed.js';
+export type { ManagedBlockProblem } from './init-managed.js';
+export interface InitResult {
+    createdDirs: string[];
+    createdFiles: string[];
+    existingFiles: string[];
+    refreshedFiles: string[];
+    currentFiles: string[];
+    updatedAgentsMd: boolean;
+    updatedPlannerMd: boolean;
+    updatedClaudePlanCommand: boolean;
+}
+export declare function scaffoldProject(targetDir: string, options?: {
+    refreshSchema?: boolean;
+}): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/core/foundation/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/init.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAsB7D,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAuCD,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,OAAO,CAAC,UAAU,CAAC,CAmErB"}

package/dist/core/foundation/init.js

@@ -0,0 +1,113 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { CLAUDE_PLAN_COMMAND_PATH } from './init-blocks.js';
+import { updateAgentsMd, updateClaudePlanCommand, updatePlannerMd } from './init-managed.js';
+import { TEMPLATES_ROOT } from './package-root.js';
+export { TEMPLATES_ROOT } from './package-root.js';
+export { CLAUDE_PLAN_COMMAND_PATH, MANAGED_AGENTS_BLOCK, MANAGED_AGENTS_MD_BODY, MANAGED_CLAUDE_PLAN_COMMAND, MANAGED_PLANNER_BLOCK, OSQ_END_MARKER, OSQ_START_MARKER, } from './init-blocks.js';
+export { inspectManagedBlock, updateAgentsMd, updateClaudePlanCommand, updatePlannerMd, } from './init-managed.js';
+const DEFAULT_CONFIG_CONTENT = `import { defineConfig } from '@matteeh/osq';
+
+export default defineConfig({
+  harness: process.env.OSQ_HARNESS || 'agy',
+  maxConcurrency: 1,
+});
+`;
+const DEFAULT_ENV_EXAMPLE = `OSQ_HARNESS=agy
+# GEMINI_API_KEY=
+# ANTHROPIC_API_KEY=
+
+# Codex CLI (optional): select it with OSQ_HARNESS=codex here, or with
+# harness: 'codex' in osq.config.ts. An explicit harness in osq.config.ts wins
+# over this environment fallback. Codex needs no generated config or credentials.
+# CODEX_PATH=/path/to/codex        # binary: codex.bin -> CODEX_PATH -> codex
+# OSQ_MODEL=<your-codex-model>     # model: codex.model -> OSQ_MODEL (Codex executor) -> native
+# codex.effort in osq.config.ts sets reasoning effort; the default is native.
+`;
+async function pathExists(targetPath) {
+    return fs
+        .stat(targetPath)
+        .then(() => true)
+        .catch(() => false);
+}
+/**
+ * Create a scaffolded file, or, when `refresh` is set, overwrite it from the
+ * template only if its bytes differ. Matching files stay untouched.
+ */
+async function writeOrRefreshFile(targetDir, file, refresh, result) {
+    const fullPath = path.join(targetDir, file.relPath);
+    if (!(await pathExists(fullPath))) {
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, file.content, 'utf8');
+        result.createdFiles.push(file.relPath);
+        return;
+    }
+    if (!refresh) {
+        result.existingFiles.push(file.relPath);
+        return;
+    }
+    const current = await fs.readFile(fullPath);
+    if (current.equals(Buffer.from(file.content, 'utf8'))) {
+        result.currentFiles.push(file.relPath);
+        return;
+    }
+    await fs.writeFile(fullPath, file.content, 'utf8');
+    result.refreshedFiles.push(file.relPath);
+}
+export async function scaffoldProject(targetDir, options = {}) {
+    const result = {
+        createdDirs: [],
+        createdFiles: [],
+        existingFiles: [],
+        refreshedFiles: [],
+        currentFiles: [],
+        updatedAgentsMd: false,
+        updatedPlannerMd: false,
+        updatedClaudePlanCommand: false,
+    };
+    const dirsToCreate = [
+        'openspec',
+        path.join('openspec', 'schemas'),
+        path.join('openspec', 'schemas', 'osq'),
+        path.join('openspec', 'schemas', 'osq', 'templates'),
+        path.join('openspec', 'specs'),
+        path.join('openspec', 'changes'),
+        path.join('openspec', 'changes', 'archive'),
+    ];
+    for (const relDir of dirsToCreate) {
+        const fullDir = path.join(targetDir, relDir);
+        if (!(await pathExists(fullDir))) {
+            await fs.mkdir(fullDir, { recursive: true });
+            result.createdDirs.push(relDir);
+        }
+    }
+    const baseFiles = [
+        { relPath: 'osq.config.ts', content: DEFAULT_CONFIG_CONTENT },
+        { relPath: '.env.example', content: DEFAULT_ENV_EXAMPLE },
+    ];
+    const bundledTemplates = [
+        path.join('openspec', 'config.yaml'),
+        path.join('openspec', 'schemas', 'osq', 'schema.yaml'),
+        path.join('openspec', 'schemas', 'osq', 'README.md'),
+        path.join('openspec', 'schemas', 'osq', 'templates', 'proposal.md'),
+        path.join('openspec', 'schemas', 'osq', 'templates', 'spec.md'),
+        path.join('openspec', 'schemas', 'osq', 'templates', 'tasks.md'),
+    ];
+    for (const file of baseFiles) {
+        await writeOrRefreshFile(targetDir, file, false, result);
+    }
+    for (const relPath of bundledTemplates) {
+        const content = await fs.readFile(path.join(TEMPLATES_ROOT, relPath), 'utf8');
+        await writeOrRefreshFile(targetDir, { relPath, content }, options.refreshSchema ?? false, result);
+    }
+    const claudeCommandExisted = await pathExists(path.join(targetDir, CLAUDE_PLAN_COMMAND_PATH));
+    result.updatedAgentsMd = await updateAgentsMd(targetDir);
+    result.updatedPlannerMd = await updatePlannerMd(targetDir);
+    result.updatedClaudePlanCommand = await updateClaudePlanCommand(targetDir);
+    if (claudeCommandExisted)
+        result.existingFiles.push(CLAUDE_PLAN_COMMAND_PATH);
+    else
+        result.createdFiles.push(CLAUDE_PLAN_COMMAND_PATH);
+    return result;
+}
+//# sourceMappingURL=init.js.map

package/dist/core/foundation/init.js.map

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

package/dist/core/{logger.d.ts → foundation/logger.d.ts}

@@ -25,6 +25,7 @@ export declare function resolveSymbol(symbol: string, word: string, enabled?: bo
 export interface LoggerOptions {
     stream?: NodeJS.WritableStream & {
         isTTY?: boolean;
+        columns?: number;
     };
     isTTY?: boolean;
 }

package/dist/core/foundation/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,IAAI,IAAI,CAAC;IACpB,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAmB,GAAG,MAAM,CAE9F;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAwBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAyF9F"}

package/dist/core/{logger.js → foundation/logger.js}

@@ -27,6 +27,9 @@ const MESSAGE_RANK = {
 const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 const SPINNER_INTERVAL_MS = 80;
 const CLEAR_LINE = '\r\x1b[2K';
+const ELLIPSIS = '…';
+const SPINNER_PREFIX_WIDTH = 2; // spinner frame plus a single space
+const DEFAULT_COLUMNS = 80;
 export function createLogger(level, prefix, options) {
     const maxRank = LEVEL_RANK[level];
     const stream = options?.stream ?? process.stderr;
@@ -43,10 +46,23 @@ export function createLogger(level, prefix, options) {
     const writeRaw = (chunk) => {
         stream.write(chunk);
     };
+    /**
+     * Constrain status text to the terminal width minus the spinner prefix. The
+     * logger owns the `[prefix]` formatting for log lines, but status text is
+     * written raw so a prefixed row can never overflow the terminal.
+     */
+    const fitStatusText = (text) => {
+        const available = (stream.columns ?? DEFAULT_COLUMNS) - SPINNER_PREFIX_WIDTH;
+        if (text.length <= available)
+            return text;
+        if (available <= 0)
+            return '';
+        return `${text.slice(0, available - 1)}${ELLIPSIS}`;
+    };
     const redraw = () => {
         if (statusText === null)
             return;
-        writeRaw(`${CLEAR_LINE}${SPINNER_FRAMES[frameIndex]} ${statusText}`);
+        writeRaw(`${CLEAR_LINE}${SPINNER_FRAMES[frameIndex]} ${fitStatusText(statusText)}`);
     };
     const startTimer = () => {
         if (timer !== null)
@@ -87,7 +103,7 @@ export function createLogger(level, prefix, options) {
         status: (text) => {
             if (!animate)
                 return;
-            statusText = render(text);
+            statusText = text;
             startTimer();
             redraw();
         },

package/dist/core/foundation/logger.js.map

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

package/dist/core/{new.d.ts → foundation/new.d.ts}

@@ -1,3 +1,4 @@
+export { TEMPLATES_ROOT } from './package-root.js';
 export declare function slugify(text: string): string;
 export declare function getNextSpecNumber(specsDir: string): Promise<string>;
 export interface NewSpecResult {
@@ -7,5 +8,7 @@ export interface NewSpecResult {
 }
 export declare function createNewSpec(projectDir: string, title: string, options?: {
     specsDirName?: string;
+    slug?: string;
+    dependsOn?: readonly string[];
 }): Promise<NewSpecResult>;
 //# sourceMappingURL=new.d.ts.map

package/dist/core/foundation/new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/new.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAwFnD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BzE;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAgBD,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GACpF,OAAO,CAAC,aAAa,CAAC,CAgFxB"}

package/dist/core/foundation/new.js

@@ -0,0 +1,206 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { getChangesDir } from '../status/layout.js';
+import { DEFAULT_CONFIG } from './config.js';
+import { TEMPLATES_ROOT } from './package-root.js';
+export { TEMPLATES_ROOT } from './package-root.js';
+const FALLBACK_PROPOSAL_MD = `---
+title: Change title
+depends_on: []
+verify: node -e "process.exit(0)"
+features:
+  reads: []
+---
+## Goal
+
+What problem this change solves and why.
+
+## Verify
+
+\`node -e "process.exit(0)"\`
+
+Replace this planning sentinel, here and in the frontmatter, with the command
+that verifies the completed change's final tree, and say what it proves.
+
+## Non-goals
+
+- What this change deliberately does not do.
+
+## Surface
+
+<!-- User-facing names this change adds, changes, or removes: commands, flags,
+config keys, frontmatter fields, document sections, dead reasons, and event
+types. Replace None with one line per name, such as
+"- Added: \`osq init --refresh-schema\` (flag)". -->
+None
+
+## Contract
+
+### Requirement: <requirement name>
+
+The system SHALL <observable behavior>.
+
+#### Scenario: <scenario name>
+- **WHEN** <condition>
+- **THEN** <outcome>
+
+## Human steps
+
+- Review the proposal, delta specs, and task bodies, then run \`osq approve <id>\`
+  yourself.
+
+## Delta
+
+Delta specs live beside the proposal as \`specs/<capability>/spec.md\`. Each holds
+the exact text the capability spec will contain after the change, under
+\`## ADDED Requirements\`, \`## MODIFIED Requirements\`, \`## REMOVED Requirements\`,
+or \`## RENAMED Requirements\`; a modified requirement repeats its full text. List
+each delta here in one line and name any file two tasks share.
+
+A delta that introduces a new capability also declares the files it owns in a
+\`### Requirement: Code ownership\` block. Its \`<!-- source: ... -->\` comment lists
+the owned path globs, comma-separated, and its scenario restates them:
+
+\`\`\`markdown
+### Requirement: Code ownership
+<!-- source: src/core/example.ts, src/cli/example.ts -->
+The <capability> capability SHALL own <subsystems>.
+
+#### Scenario: Codebase ownership boundaries
+- **WHEN** file ownership is resolved for <capability>
+- **THEN** system maps \`src/core/example.ts\` and \`src/cli/example.ts\` to <capability>
+\`\`\`
+`;
+const FALLBACK_TASKS_MD = `# Tasks
+
+## 1. Section title
+
+- [ ] 1. When initial condition, expected outcome
+`;
+const FALLBACK_TASK_1_MD = `---
+title: When initial condition, expected outcome
+verify: node -e "process.exit(0)"
+scope: []
+entry: []
+skills: []
+---
+## Acceptance
+- [ ] Acceptance criterion 1
+`;
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+export async function getNextSpecNumber(specsDir) {
+    // Rejected attempts are numbered too, so a rejection followed by a replan
+    // never reuses an identifier.
+    const dirsToScan = [specsDir, path.join(specsDir, 'archive'), path.join(specsDir, 'rejected')];
+    let maxNum = 0;
+    for (const dir of dirsToScan) {
+        let entries = [];
+        try {
+            entries = await fs.readdir(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const match = entry.match(/^(\d+)/);
+            if (match) {
+                const num = Number.parseInt(match[1], 10);
+                if (!Number.isNaN(num) && num > maxNum) {
+                    maxNum = num;
+                }
+            }
+        }
+    }
+    return String(maxNum + 1).padStart(3, '0');
+}
+/**
+ * Replace only the proposal title and, when queue dependencies are supplied,
+ * the `depends_on` line. The template body and every other frontmatter key
+ * stay intact.
+ */
+function seedProposal(content, title, dependsOn) {
+    let seeded = content.replace(/^title:\s*.*$/m, `title: ${title}`);
+    if (dependsOn !== undefined) {
+        const value = `[${dependsOn.map((id) => JSON.stringify(id)).join(', ')}]`;
+        seeded = seeded.replace(/^depends_on:\s*.*$/m, `depends_on: ${value}`);
+    }
+    return seeded;
+}
+export async function createNewSpec(projectDir, title, options = {}) {
+    const trimmedTitle = title.trim();
+    if (!trimmedTitle) {
+        throw new Error('Spec name cannot be empty');
+    }
+    const slug = options.slug?.trim() || slugify(trimmedTitle);
+    if (!slug) {
+        throw new Error('Spec name cannot be empty');
+    }
+    const specsDir = options.specsDirName
+        ? path.join(projectDir, options.specsDirName)
+        : getChangesDir(DEFAULT_CONFIG.paths.openspecRoot, projectDir);
+    const legacyTemplateDir = path.join(specsDir, '_template');
+    const legacyTemplateExists = await fs
+        .stat(legacyTemplateDir)
+        .then(() => true)
+        .catch(() => false);
+    const specId = await getNextSpecNumber(specsDir);
+    const folderName = `${specId}-${slug}`;
+    const targetDir = path.join(specsDir, folderName);
+    const targetExists = await fs
+        .stat(targetDir)
+        .then(() => true)
+        .catch(() => false);
+    if (targetExists) {
+        throw new Error(`Spec folder already exists at ${targetDir}`);
+    }
+    if (legacyTemplateExists) {
+        // Legacy spec folder layout
+        await fs.cp(legacyTemplateDir, targetDir, { recursive: true });
+        const specMdPath = path.join(targetDir, 'spec.md');
+        try {
+            const specContent = await fs.readFile(specMdPath, 'utf8');
+            const updatedContent = specContent.replace(/^title:\s*.*$/m, `title: ${trimmedTitle}`);
+            await fs.writeFile(specMdPath, updatedContent, 'utf8');
+        }
+        catch { }
+    }
+    else {
+        // OpenSpec change folder layout
+        await fs.mkdir(path.join(targetDir, 'tasks'), { recursive: true });
+        let proposalContent = FALLBACK_PROPOSAL_MD;
+        try {
+            proposalContent = await fs.readFile(path.join(TEMPLATES_ROOT, 'proposal.md'), 'utf8');
+        }
+        catch { }
+        const updatedProposal = seedProposal(proposalContent, trimmedTitle, options.dependsOn);
+        await fs.writeFile(path.join(targetDir, 'proposal.md'), updatedProposal, 'utf8');
+        let tasksContent = FALLBACK_TASKS_MD;
+        try {
+            tasksContent = await fs.readFile(path.join(TEMPLATES_ROOT, 'tasks.md'), 'utf8');
+        }
+        catch { }
+        await fs.writeFile(path.join(targetDir, 'tasks.md'), tasksContent, 'utf8');
+        let task1Content = FALLBACK_TASK_1_MD;
+        try {
+            task1Content = await fs.readFile(path.join(TEMPLATES_ROOT, 'openspec', 'schemas', 'osq', 'templates', 'spec.md'), 'utf8');
+        }
+        catch { }
+        // If not a task format, fallback to default task 1
+        if (!task1Content.includes('verify:')) {
+            task1Content = FALLBACK_TASK_1_MD;
+        }
+        await fs.writeFile(path.join(targetDir, 'tasks', '1.md'), task1Content, 'utf8');
+    }
+    return {
+        specId,
+        folderName,
+        folderPath: targetDir,
+    };
+}
+//# sourceMappingURL=new.js.map

package/dist/core/foundation/new.js.map

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

package/dist/core/foundation/package-root.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Package root of the running osq build: `src/core/foundation/` when executed
+ * through `tsx`, `dist/core/foundation/` once compiled. Both resolve three
+ * levels up.
+ */
+export declare const PACKAGE_ROOT: string;
+/** Path to the package's bundled `templates/` directory. */
+export declare const TEMPLATES_ROOT: string;
+//# sourceMappingURL=package-root.d.ts.map

package/dist/core/foundation/package-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-root.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/package-root.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAqE,CAAC;AAE/F,4DAA4D;AAC5D,eAAO,MAAM,cAAc,QAAuC,CAAC"}

package/dist/core/foundation/package-root.js

@@ -0,0 +1,11 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Package root of the running osq build: `src/core/foundation/` when executed
+ * through `tsx`, `dist/core/foundation/` once compiled. Both resolve three
+ * levels up.
+ */
+export const PACKAGE_ROOT = path.resolve(fileURLToPath(new URL('../../../', import.meta.url)));
+/** Path to the package's bundled `templates/` directory. */
+export const TEMPLATES_ROOT = path.join(PACKAGE_ROOT, 'templates');
+//# sourceMappingURL=package-root.js.map

package/dist/core/foundation/package-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-root.js","sourceRoot":"","sources":["../../../src/core/foundation/package-root.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE/F,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC"}

package/dist/core/lifecycle/done.d.ts

@@ -0,0 +1,17 @@
+import type { OsqConfig } from '../foundation/config.js';
+export interface DoneManualResult {
+    readonly specId: string;
+    readonly folderName: string;
+    readonly folderPath: string;
+    readonly taskNumber: string;
+    readonly markerPath: string;
+    readonly eventPath: string;
+}
+/**
+ * Mark a task done by human decision. Writes `.run/done/<n>` carrying
+ * `manual: true` and the justification, appends a `done_manual` event, and ticks
+ * the task checkbox in `tasks.md`. This is the sole path for manual completion;
+ * archive-time verification still runs the task's `verify` command.
+ */
+export declare function markTaskDoneManual(projectRoot: string, specIdOrPrefix: string, taskNumber: string, reason: string, config: OsqConfig): Promise<DoneManualResult>;
+//# sourceMappingURL=done.d.ts.map

package/dist/core/lifecycle/done.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"done.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/done.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAKzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAsED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,gBAAgB,CAAC,CA+B3B"}