opencastle 0.26.1 → 0.27.0

package/README.md

@@ -70,6 +70,8 @@ MCP servers are auto-configured for your stack in each IDE's native format.
 | `opencastle init` | Set up agents in your project |
 | `opencastle update` | Update framework files (keeps your customizations) |
 | `opencastle eject` | Remove the dependency, keep all files |
+| `opencastle destroy` | Remove ALL OpenCastle files (reverse of init) |
+| `opencastle plan` | Generate a convoy spec from a task description |
 | `opencastle run` | Run the Convoy Engine (deterministic, crash-recoverable orchestrator) |
 | `opencastle dashboard` | Open the observability dashboard |
 | `opencastle doctor` | Validate your setup and surface issues |
@@ -165,7 +167,11 @@ gates:
 - **Observable** — real-time dashboard auto-starts during execution.
 - **Multi-runtime** — mix Copilot, Claude Code, Cursor, and OpenCode in the same convoy.
 
-TIP: Use the **"Generate Convoy"** prompt to create a `convoy.yml` from a plain description. No YAML by hand.
+Generate a convoy spec from a plain text description — no YAML by hand:
+
+```bash
+npx opencastle plan --file task.txt
+```
 
 📖 [Full Convoy Engine documentation →](https://www.opencastle.dev/docs/cli#run)
 

package/bin/cli.mjs

@@ -21,7 +21,9 @@ const HELP = `
     init        Set up OpenCastle in your project
     update      Update framework files (preserves customizations)
     eject       Remove dependency, keep all files standalone
+    destroy     Remove ALL OpenCastle files (reverse of init)
     run         Process a task queue from a spec file autonomously
+    plan        Generate a convoy spec from a task description file
     dashboard   View agent observability dashboard in your browser
     doctor      Validate your OpenCastle setup
     log         Append a structured event to the observability log
@@ -50,7 +52,9 @@ const commands = {
   init: () => import('../dist/cli/init.js'),
   update: () => import('../dist/cli/update.js'),
   eject: () => import('../dist/cli/eject.js'),
+  destroy: () => import('../dist/cli/destroy.js'),
   run: () => import('../dist/cli/run.js'),
+  plan: () => import('../dist/cli/plan.js'),
   dashboard: () => import('../dist/cli/dashboard.js'),
   doctor: () => import('../dist/cli/doctor.js'),
   log: () => import('../dist/cli/log.js'),

package/dist/cli/destroy.d.ts

@@ -0,0 +1,3 @@
+import type { CliContext } from './types.js';
+export default function destroy({ pkgRoot: _pkgRoot, args, }: CliContext): Promise<void>;
+//# sourceMappingURL=destroy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"destroy.d.ts","sourceRoot":"","sources":["../../src/cli/destroy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,wBAA8B,OAAO,CAAC,EACpC,OAAO,EAAE,QAAQ,EACjB,IAAI,GACL,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2E5B"}

package/dist/cli/destroy.js

@@ -0,0 +1,69 @@
+import { resolve } from 'node:path';
+import { unlink } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { readManifest } from './manifest.js';
+import { removeDirIfExists } from './copy.js';
+import { removeGitignoreBlock } from './gitignore.js';
+import { confirm, closePrompts, c } from './prompt.js';
+export default async function destroy({ pkgRoot: _pkgRoot, args, }) {
+    const projectRoot = process.cwd();
+    const dryRun = args.includes('--dry-run') || args.includes('--dryRun');
+    const manifest = await readManifest(projectRoot);
+    if (!manifest) {
+        console.error('  ✗ No OpenCastle installation found.');
+        process.exit(1);
+    }
+    const frameworkPaths = manifest.managedPaths?.framework ?? [];
+    const customizablePaths = manifest.managedPaths?.customizable ?? [];
+    const legacyManifestPath = resolve(projectRoot, '.opencastle.json');
+    const hasLegacy = existsSync(legacyManifestPath);
+    console.log(`\n  🏰 OpenCastle destroy\n`);
+    console.log('  This will permanently remove:\n');
+    for (const p of frameworkPaths) {
+        console.log(`    ${c.dim(p)}`);
+    }
+    for (const p of customizablePaths) {
+        console.log(`    ${c.dim(p)}`);
+    }
+    console.log(`    ${c.dim('.opencastle/')}`);
+    if (hasLegacy) {
+        console.log(`    ${c.dim('.opencastle.json')}`);
+    }
+    console.log(`    ${c.dim('.gitignore block')}\n`);
+    if (dryRun) {
+        console.log('  [dry-run] No files were changed.\n');
+        return;
+    }
+    const proceed = await confirm('This will permanently delete all OpenCastle files. Continue?', false);
+    if (!proceed) {
+        console.log('  Aborted.');
+        closePrompts();
+        return;
+    }
+    let removed = 0;
+    for (const p of [...frameworkPaths, ...customizablePaths]) {
+        if (p.endsWith('/')) {
+            const dir = resolve(projectRoot, p);
+            await removeDirIfExists(dir);
+            removed++;
+        }
+        else {
+            const file = resolve(projectRoot, p);
+            if (existsSync(file)) {
+                await unlink(file);
+                removed++;
+            }
+        }
+    }
+    await removeDirIfExists(resolve(projectRoot, '.opencastle'));
+    removed++;
+    if (hasLegacy) {
+        await unlink(legacyManifestPath);
+        removed++;
+    }
+    const gitignoreResult = await removeGitignoreBlock(projectRoot);
+    console.log(`\n  ${c.green('✓')} Removed ${removed} path(s)${gitignoreResult === 'removed' ? ' + .gitignore block' : ''}.`);
+    console.log(`  You can uninstall: ${c.bold('npm uninstall opencastle')}\n`);
+    closePrompts();
+}
+//# sourceMappingURL=destroy.js.map

package/dist/cli/destroy.js.map

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

package/dist/cli/destroy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=destroy.test.d.ts.map

package/dist/cli/destroy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy.test.d.ts","sourceRoot":"","sources":["../../src/cli/destroy.test.ts"],"names":[],"mappings":""}

package/dist/cli/destroy.test.js

@@ -0,0 +1,116 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdtemp, mkdir, writeFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { existsSync } from 'node:fs';
+vi.mock('./prompt.js', () => ({
+    confirm: vi.fn().mockResolvedValue(true),
+    closePrompts: vi.fn(),
+    c: {
+        green: (s) => s,
+        dim: (s) => s,
+        bold: (s) => s,
+        red: (s) => s,
+        cyan: (s) => s,
+        yellow: (s) => s,
+        magenta: (s) => s,
+    },
+}));
+import destroy from './destroy.js';
+import { confirm } from './prompt.js';
+const START_MARKER = '# >>> OpenCastle managed (do not edit) >>>';
+const END_MARKER = '# <<< OpenCastle managed <<<';
+async function writeManifestFile(dir, manifest = {}) {
+    await mkdir(join(dir, '.opencastle'), { recursive: true });
+    const full = {
+        version: '1.0.0',
+        ide: 'vscode',
+        ides: ['vscode'],
+        installedAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        managedPaths: { framework: [], customizable: [] },
+        ...manifest,
+    };
+    await writeFile(join(dir, '.opencastle', 'manifest.json'), JSON.stringify(full, null, 2));
+}
+async function writeGitignoreWithBlock(dir, userEntries = 'node_modules\n') {
+    const block = [userEntries, '', START_MARKER, '.github/', '!.github/customizations/', END_MARKER, ''].join('\n');
+    await writeFile(join(dir, '.gitignore'), block);
+}
+// ── Tests ──────────────────────────────────────────────────────
+describe('destroy', () => {
+    let tmpDir;
+    let cwdSpy;
+    let exitSpy;
+    beforeEach(async () => {
+        tmpDir = await mkdtemp(join(tmpdir(), 'oc-destroy-'));
+        cwdSpy = vi.spyOn(process, 'cwd').mockReturnValue(tmpDir);
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => {
+            throw new Error('process.exit called');
+        });
+        vi.mocked(confirm).mockResolvedValue(true);
+    });
+    afterEach(async () => {
+        cwdSpy.mockRestore();
+        exitSpy.mockRestore();
+        await rm(tmpDir, { recursive: true, force: true });
+    });
+    it('removes all managed framework files', async () => {
+        await writeManifestFile(tmpDir, {
+            managedPaths: {
+                framework: ['.github/instructions/general.instructions.md', '.github/copilot-instructions.md'],
+                customizable: [],
+            },
+        });
+        await mkdir(join(tmpDir, '.github', 'instructions'), { recursive: true });
+        await writeFile(join(tmpDir, '.github', 'instructions', 'general.instructions.md'), 'content');
+        await writeFile(join(tmpDir, '.github', 'copilot-instructions.md'), 'content');
+        await destroy({ pkgRoot: tmpDir, args: [] });
+        expect(existsSync(join(tmpDir, '.github', 'instructions', 'general.instructions.md'))).toBe(false);
+        expect(existsSync(join(tmpDir, '.github', 'copilot-instructions.md'))).toBe(false);
+    });
+    it('removes .opencastle/ directory', async () => {
+        await writeManifestFile(tmpDir);
+        expect(existsSync(join(tmpDir, '.opencastle'))).toBe(true);
+        await destroy({ pkgRoot: tmpDir, args: [] });
+        expect(existsSync(join(tmpDir, '.opencastle'))).toBe(false);
+    });
+    it('removes legacy .opencastle.json manifest', async () => {
+        await writeManifestFile(tmpDir);
+        const legacyPath = join(tmpDir, '.opencastle.json');
+        await writeFile(legacyPath, JSON.stringify({ version: '0.1.0', ide: 'vscode', installedAt: '', updatedAt: '' }));
+        await destroy({ pkgRoot: tmpDir, args: [] });
+        expect(existsSync(legacyPath)).toBe(false);
+    });
+    it('cleans the gitignore block but keeps user entries', async () => {
+        await writeManifestFile(tmpDir);
+        await writeGitignoreWithBlock(tmpDir, 'node_modules\ndist\n');
+        await destroy({ pkgRoot: tmpDir, args: [] });
+        const gitignorePath = join(tmpDir, '.gitignore');
+        expect(existsSync(gitignorePath)).toBe(true);
+        const { readFile } = await import('node:fs/promises');
+        const content = await readFile(gitignorePath, 'utf8');
+        expect(content).not.toContain(START_MARKER);
+        expect(content).not.toContain(END_MARKER);
+        expect(content).toContain('node_modules');
+        expect(content).toContain('dist');
+    });
+    it('dry-run makes no changes', async () => {
+        await writeManifestFile(tmpDir, {
+            managedPaths: { framework: ['some-file.md'], customizable: [] },
+        });
+        await writeFile(join(tmpDir, 'some-file.md'), 'content');
+        await writeGitignoreWithBlock(tmpDir);
+        await destroy({ pkgRoot: tmpDir, args: ['--dry-run'] });
+        expect(existsSync(join(tmpDir, 'some-file.md'))).toBe(true);
+        expect(existsSync(join(tmpDir, '.opencastle'))).toBe(true);
+        const { readFile } = await import('node:fs/promises');
+        const gitignore = await readFile(join(tmpDir, '.gitignore'), 'utf8');
+        expect(gitignore).toContain(START_MARKER);
+    });
+    it('exits with error when no manifest found', async () => {
+        await expect(destroy({ pkgRoot: tmpDir, args: [] })).rejects.toThrow('process.exit called');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+});
+//# sourceMappingURL=destroy.test.js.map

package/dist/cli/destroy.test.js.map

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

package/dist/cli/gitignore.d.ts

@@ -8,4 +8,13 @@ import type { ManagedPaths } from './types.js';
  *   (handles re-init or IDE switch cleanly).
  */
 export declare function updateGitignore(projectRoot: string, managed: ManagedPaths): Promise<'created' | 'updated' | 'unchanged'>;
+/**
+ * Remove the OpenCastle managed block from `.gitignore`.
+ *
+ * - No-op if no `.gitignore` exists or no block is present.
+ * - Cleans up resulting double blank lines.
+ * - Deletes `.gitignore` if the file becomes empty after removal.
+ * - Returns 'removed' or 'unchanged'.
+ */
+export declare function removeGitignoreBlock(projectRoot: string): Promise<'removed' | 'unchanged'>;
 //# sourceMappingURL=gitignore.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/cli/gitignore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AA6B9C;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,CA8B9C"}
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/cli/gitignore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AA6B9C;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,CA8B9C;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,GAAG,WAAW,CAAC,CAwBlC"}

package/dist/cli/gitignore.js

@@ -56,4 +56,33 @@ export async function updateGitignore(projectRoot, managed) {
     await writeFile(gitignorePath, existing + separator + block + '\n', 'utf8');
     return 'updated';
 }
+/**
+ * Remove the OpenCastle managed block from `.gitignore`.
+ *
+ * - No-op if no `.gitignore` exists or no block is present.
+ * - Cleans up resulting double blank lines.
+ * - Deletes `.gitignore` if the file becomes empty after removal.
+ * - Returns 'removed' or 'unchanged'.
+ */
+export async function removeGitignoreBlock(projectRoot) {
+    const gitignorePath = resolve(projectRoot, '.gitignore');
+    if (!existsSync(gitignorePath))
+        return 'unchanged';
+    const existing = await readFile(gitignorePath, 'utf8');
+    const startIdx = existing.indexOf(START_MARKER);
+    const endIdx = existing.indexOf(END_MARKER);
+    if (startIdx === -1 || endIdx === -1)
+        return 'unchanged';
+    const before = existing.slice(0, startIdx);
+    const after = existing.slice(endIdx + END_MARKER.length);
+    // Collapse consecutive blank lines left by removal
+    const updated = (before + after).replace(/\n{3,}/g, '\n\n').trimEnd();
+    if (!updated) {
+        const { unlink } = await import('node:fs/promises');
+        await unlink(gitignorePath);
+        return 'removed';
+    }
+    await writeFile(gitignorePath, updated + '\n', 'utf8');
+    return 'removed';
+}
 //# sourceMappingURL=gitignore.js.map

package/dist/cli/gitignore.js.map

@@ -1 +1 @@
-{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/cli/gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAGpC,MAAM,YAAY,GAAG,4CAA4C,CAAA;AACjE,MAAM,UAAU,GAAG,8BAA8B,CAAA;AAEjD;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,OAAqB;IACvC,MAAM,KAAK,GAAa,CAAC,YAAY,CAAC,CAAA;IAEtC,+DAA+D;IAC/D,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACf,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACrB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,OAAqB;IAErB,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;IACxD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IAEjC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,MAAM,SAAS,CAAC,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,CAAA;QACpD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAEtD,yBAAyB;IACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAE3C,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;QACxD,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;QAEtC,IAAI,OAAO,KAAK,QAAQ;YAAE,OAAO,WAAW,CAAA;QAE5C,MAAM,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QAC/C,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,gCAAgC;IAChC,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;IACzD,MAAM,SAAS,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,CAAA;IAC3E,OAAO,SAAS,CAAA;AAClB,CAAC"}
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/cli/gitignore.ts"],"names":[],"mappings":"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"}

package/dist/cli/plan.d.ts

@@ -0,0 +1,3 @@
+import type { CliContext } from './types.js';
+export default function plan({ args, pkgRoot }: CliContext): 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":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAQ,MAAM,YAAY,CAAA;AAmKlD,wBAA8B,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiJ/E"}

package/dist/cli/plan.js

@@ -0,0 +1,288 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { resolve, join, basename } from 'node:path';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { getAdapter, detectAdapter } from './run/adapters/index.js';
+import { parseTaskSpecText } from './run/schema.js';
+import { c } from './prompt.js';
+const HELP = `
+  opencastle plan [options]
+
+  Generate a convoy spec from a task description file by running it through the
+  generate-convoy prompt via an AI adapter.
+
+  Options:
+    --file, -f <path>        Path to a text file with the task description (required)
+    --context <path>         Optional path to an additional context file
+    --output, -o <path>      Output path for the generated convoy spec
+    --adapter, -a <name>     Override agent runtime adapter
+    --verbose                Show full agent output
+    --dry-run                Print the prompt that would be sent without executing
+    --help, -h               Show this help
+`;
+function parseArgs(args) {
+    const opts = {
+        file: null,
+        context: null,
+        output: null,
+        adapter: null,
+        verbose: false,
+        dryRun: false,
+        help: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                opts.help = true;
+                break;
+            case '--file':
+            case '-f':
+                if (i + 1 >= args.length) {
+                    console.error('  ✗ --file requires a path');
+                    process.exit(1);
+                }
+                opts.file = args[++i];
+                break;
+            case '--context':
+                if (i + 1 >= args.length) {
+                    console.error('  ✗ --context requires a path');
+                    process.exit(1);
+                }
+                opts.context = args[++i];
+                break;
+            case '--output':
+            case '-o':
+                if (i + 1 >= args.length) {
+                    console.error('  ✗ --output requires a path');
+                    process.exit(1);
+                }
+                opts.output = args[++i];
+                break;
+            case '--adapter':
+            case '-a':
+                if (i + 1 >= args.length) {
+                    console.error('  ✗ --adapter requires a name');
+                    process.exit(1);
+                }
+                opts.adapter = args[++i];
+                break;
+            case '--verbose':
+                opts.verbose = true;
+                break;
+            case '--dry-run':
+            case '--dryRun':
+                opts.dryRun = true;
+                break;
+            default:
+                console.error(`  ✗ Unknown option: ${arg}`);
+                console.log(HELP);
+                process.exit(1);
+        }
+    }
+    return opts;
+}
+function printAdapterError(detectionFailed, adapterName) {
+    if (detectionFailed) {
+        console.error(`  ✗ No agent CLI found on your PATH.\n` +
+            `    Install one of the following adapters:\n` +
+            `    • copilot    — https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli\n` +
+            `    • claude     — npm install -g @anthropic-ai/claude-code\n` +
+            `    • cursor     — https://cursor.com (Cursor > Install CLI)\n` +
+            `    • opencode   — https://opencode.ai\n` +
+            `\n` +
+            `    Or specify an adapter explicitly: opencastle plan --adapter <name>`);
+    }
+    else {
+        const hints = {
+            'claude': '    Install: npm install -g @anthropic-ai/claude-code\n' +
+                '    Docs:    https://docs.anthropic.com/en/docs/claude-code',
+            copilot: '    Requires the Copilot CLI installed and authenticated:\n' +
+                '    https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli\n' +
+                '    Docs:    https://docs.github.com/en/copilot',
+            cursor: '    The Cursor agent CLI ships with the Cursor editor.\n' +
+                '    Install Cursor from https://cursor.com and ensure the\n' +
+                '    "agent" command is on your PATH (Cursor > Install CLI).',
+            opencode: '    Install OpenCode from https://opencode.ai\n' +
+                '    Ensure the "opencode" command is on your PATH.',
+        };
+        const cliName = adapterName === 'cursor' ? 'agent' : adapterName;
+        const hint = hints[adapterName] ?? '';
+        console.error(`  ✗ Adapter "${adapterName}" is not available.\n` +
+            `    Make sure the "${cliName}" CLI is installed and on your PATH.\n` +
+            hint);
+    }
+}
+/**
+ * Strip YAML frontmatter (everything between first and second --- lines).
+ */
+function stripFrontmatter(text) {
+    const lines = text.split('\n');
+    if (lines[0]?.trim() !== '---')
+        return text;
+    const closingIdx = lines.findIndex((line, i) => i > 0 && line.trim() === '---');
+    if (closingIdx === -1)
+        return text;
+    return lines.slice(closingIdx + 1).join('\n').trimStart();
+}
+/**
+ * Extract YAML content from a fenced code block (```yaml or ```yml).
+ */
+function extractYamlBlock(text) {
+    const match = text.match(/```ya?ml\s*\n([\s\S]*?)```/);
+    if (!match)
+        return null;
+    return match[1].trim();
+}
+/**
+ * Derive an output filename from YAML content.
+ * Checks for a comment on the first line, then falls back to the `name` field.
+ */
+function deriveOutputFilename(yaml) {
+    // First line comment: # .opencastle/convoys/some-name.convoy.yml
+    const firstLine = yaml.split('\n')[0] ?? '';
+    const commentMatch = firstLine.match(/^#\s*(.+\.convoy\.ya?ml)\s*$/);
+    if (commentMatch) {
+        return basename(commentMatch[1]);
+    }
+    // Fall back to `name:` field
+    const nameMatch = yaml.match(/^name:\s*['"]?([^'"\n]+)['"]?\s*$/m);
+    if (nameMatch) {
+        const kebab = nameMatch[1].trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+        if (kebab)
+            return `${kebab}.convoy.yml`;
+    }
+    return 'convoy-plan.convoy.yml';
+}
+export default async function plan({ args, pkgRoot }) {
+    const opts = parseArgs(args);
+    if (opts.help) {
+        console.log(HELP);
+        return;
+    }
+    // ── Validate required --file arg ──────────────────────────────
+    if (!opts.file) {
+        console.error(`  ✗ --file is required. Specify a text file with the task description.`);
+        console.log(HELP);
+        process.exit(1);
+    }
+    const filePath = resolve(process.cwd(), opts.file);
+    if (!existsSync(filePath)) {
+        console.error(`  ✗ File not found: ${opts.file}`);
+        process.exit(1);
+    }
+    // ── Read task description ──────────────────────────────────────
+    const taskDescription = await readFile(filePath, 'utf8');
+    // ── Read optional context file ─────────────────────────────────
+    let contextContent = '';
+    if (opts.context) {
+        const contextPath = resolve(process.cwd(), opts.context);
+        if (!existsSync(contextPath)) {
+            console.error(`  ✗ Context file not found: ${opts.context}`);
+            process.exit(1);
+        }
+        contextContent = await readFile(contextPath, 'utf8');
+    }
+    // ── Load and assemble the prompt template ─────────────────────
+    const promptTemplatePath = join(pkgRoot, 'src', 'orchestrator', 'prompts', 'generate-convoy.prompt.md');
+    if (!existsSync(promptTemplatePath)) {
+        console.error(`  ✗ Prompt template not found: ${promptTemplatePath}`);
+        process.exit(1);
+    }
+    const rawTemplate = await readFile(promptTemplatePath, 'utf8');
+    const template = stripFrontmatter(rawTemplate);
+    const assembledPrompt = template
+        .replace('{{goal}}', taskDescription.trim())
+        .replace('{{context}}', contextContent.trim());
+    // ── Dry-run: print prompt and exit ────────────────────────────
+    if (opts.dryRun) {
+        console.log(c.bold(c.cyan('  Assembled prompt (dry-run):\n')));
+        console.log(assembledPrompt);
+        return;
+    }
+    // ── Resolve adapter ───────────────────────────────────────────
+    let adapterName;
+    if (opts.adapter) {
+        adapterName = opts.adapter;
+    }
+    else {
+        const detected = await detectAdapter();
+        if (!detected) {
+            printAdapterError(true, '');
+            process.exit(1);
+        }
+        adapterName = detected;
+    }
+    let adapter;
+    try {
+        adapter = await getAdapter(adapterName);
+    }
+    catch {
+        printAdapterError(false, adapterName);
+        process.exit(1);
+    }
+    const available = await adapter.isAvailable();
+    if (!available) {
+        printAdapterError(false, adapterName);
+        process.exit(1);
+    }
+    console.log(c.dim(`  Using adapter: ${adapterName}`));
+    console.log(c.dim(`  Generating convoy spec from: ${opts.file}\n`));
+    // ── Execute the prompt through the adapter ────────────────────
+    const task = {
+        id: 'generate-convoy',
+        prompt: assembledPrompt,
+        agent: 'team-lead',
+        timeout: '10m',
+        depends_on: [],
+        files: [],
+        description: 'Generate convoy spec from task description',
+        max_retries: 1,
+    };
+    const result = await adapter.execute(task, { verbose: opts.verbose });
+    // ── Extract YAML from the response ────────────────────────────
+    const yamlContent = extractYamlBlock(result.output);
+    if (!yamlContent) {
+        const preview = result.output.slice(0, 500);
+        console.error(`  ✗ No YAML code block found in the agent response.\n`);
+        console.error(c.dim(`  Raw output (truncated):\n${preview}`));
+        process.exit(1);
+    }
+    // ── Validate YAML ─────────────────────────────────────────────
+    let validationWarning = false;
+    try {
+        parseTaskSpecText(yamlContent);
+    }
+    catch (err) {
+        validationWarning = true;
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(c.yellow(`  ⚠ YAML validation warning: ${msg}`));
+        console.warn(c.dim(`    The file will still be written — you may need to edit it before running.\n`));
+    }
+    // ── Determine output path ─────────────────────────────────────
+    let outputPath;
+    if (opts.output) {
+        outputPath = resolve(process.cwd(), opts.output);
+    }
+    else {
+        const convoyDir = resolve(process.cwd(), '.opencastle', 'convoys');
+        await mkdir(convoyDir, { recursive: true });
+        const filename = deriveOutputFilename(yamlContent);
+        outputPath = join(convoyDir, filename);
+    }
+    await mkdir(resolve(outputPath, '..'), { recursive: true });
+    await writeFile(outputPath, yamlContent + '\n', 'utf8');
+    const relPath = outputPath.startsWith(process.cwd())
+        ? outputPath.slice(process.cwd().length + 1)
+        : outputPath;
+    console.log(c.green(`  ✓ Convoy spec written to ${relPath}`));
+    if (validationWarning) {
+        console.log(c.yellow(`    (contains validation warnings — review before running)`));
+    }
+    console.log(`
+  ${c.dim('Preview:')} npx opencastle run -f ${relPath} --dry-run
+  ${c.dim('Execute:')} npx opencastle run -f ${relPath}
+`);
+}
+//# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencastle",
-  "version": "0.26.1",
+  "version": "0.27.0",
   "type": "module",
   "description": "Multi-agent orchestration framework for AI coding assistants",
   "bin": {

package/src/cli/destroy.test.ts

@@ -0,0 +1,141 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
+import { mkdtemp, mkdir, writeFile, rm } from 'node:fs/promises'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+import { existsSync } from 'node:fs'
+
+vi.mock('./prompt.js', () => ({
+  confirm: vi.fn().mockResolvedValue(true),
+  closePrompts: vi.fn(),
+  c: {
+    green: (s: string) => s,
+    dim: (s: string) => s,
+    bold: (s: string) => s,
+    red: (s: string) => s,
+    cyan: (s: string) => s,
+    yellow: (s: string) => s,
+    magenta: (s: string) => s,
+  },
+}))
+
+import destroy from './destroy.js'
+import { confirm } from './prompt.js'
+import type { Manifest } from './types.js'
+
+const START_MARKER = '# >>> OpenCastle managed (do not edit) >>>'
+const END_MARKER = '# <<< OpenCastle managed <<<'
+
+async function writeManifestFile(dir: string, manifest: Partial<Manifest> = {}): Promise<void> {
+  await mkdir(join(dir, '.opencastle'), { recursive: true })
+  const full: Manifest = {
+    version: '1.0.0',
+    ide: 'vscode',
+    ides: ['vscode'],
+    installedAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+    managedPaths: { framework: [], customizable: [] },
+    ...manifest,
+  }
+  await writeFile(join(dir, '.opencastle', 'manifest.json'), JSON.stringify(full, null, 2))
+}
+
+async function writeGitignoreWithBlock(dir: string, userEntries = 'node_modules\n'): Promise<void> {
+  const block = [userEntries, '', START_MARKER, '.github/', '!.github/customizations/', END_MARKER, ''].join('\n')
+  await writeFile(join(dir, '.gitignore'), block)
+}
+
+// ── Tests ──────────────────────────────────────────────────────
+
+describe('destroy', () => {
+  let tmpDir: string
+  let cwdSpy: ReturnType<typeof vi.spyOn>
+  let exitSpy: ReturnType<typeof vi.spyOn>
+
+  beforeEach(async () => {
+    tmpDir = await mkdtemp(join(tmpdir(), 'oc-destroy-'))
+    cwdSpy = vi.spyOn(process, 'cwd').mockReturnValue(tmpDir)
+    exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => {
+      throw new Error('process.exit called')
+    })
+    vi.mocked(confirm).mockResolvedValue(true)
+  })
+
+  afterEach(async () => {
+    cwdSpy.mockRestore()
+    exitSpy.mockRestore()
+    await rm(tmpDir, { recursive: true, force: true })
+  })
+
+  it('removes all managed framework files', async () => {
+    await writeManifestFile(tmpDir, {
+      managedPaths: {
+        framework: ['.github/instructions/general.instructions.md', '.github/copilot-instructions.md'],
+        customizable: [],
+      },
+    })
+    await mkdir(join(tmpDir, '.github', 'instructions'), { recursive: true })
+    await writeFile(join(tmpDir, '.github', 'instructions', 'general.instructions.md'), 'content')
+    await writeFile(join(tmpDir, '.github', 'copilot-instructions.md'), 'content')
+
+    await destroy({ pkgRoot: tmpDir, args: [] })
+
+    expect(existsSync(join(tmpDir, '.github', 'instructions', 'general.instructions.md'))).toBe(false)
+    expect(existsSync(join(tmpDir, '.github', 'copilot-instructions.md'))).toBe(false)
+  })
+
+  it('removes .opencastle/ directory', async () => {
+    await writeManifestFile(tmpDir)
+    expect(existsSync(join(tmpDir, '.opencastle'))).toBe(true)
+
+    await destroy({ pkgRoot: tmpDir, args: [] })
+
+    expect(existsSync(join(tmpDir, '.opencastle'))).toBe(false)
+  })
+
+  it('removes legacy .opencastle.json manifest', async () => {
+    await writeManifestFile(tmpDir)
+    const legacyPath = join(tmpDir, '.opencastle.json')
+    await writeFile(legacyPath, JSON.stringify({ version: '0.1.0', ide: 'vscode', installedAt: '', updatedAt: '' }))
+
+    await destroy({ pkgRoot: tmpDir, args: [] })
+
+    expect(existsSync(legacyPath)).toBe(false)
+  })
+
+  it('cleans the gitignore block but keeps user entries', async () => {
+    await writeManifestFile(tmpDir)
+    await writeGitignoreWithBlock(tmpDir, 'node_modules\ndist\n')
+
+    await destroy({ pkgRoot: tmpDir, args: [] })
+
+    const gitignorePath = join(tmpDir, '.gitignore')
+    expect(existsSync(gitignorePath)).toBe(true)
+    const { readFile } = await import('node:fs/promises')
+    const content = await readFile(gitignorePath, 'utf8')
+    expect(content).not.toContain(START_MARKER)
+    expect(content).not.toContain(END_MARKER)
+    expect(content).toContain('node_modules')
+    expect(content).toContain('dist')
+  })
+
+  it('dry-run makes no changes', async () => {
+    await writeManifestFile(tmpDir, {
+      managedPaths: { framework: ['some-file.md'], customizable: [] },
+    })
+    await writeFile(join(tmpDir, 'some-file.md'), 'content')
+    await writeGitignoreWithBlock(tmpDir)
+
+    await destroy({ pkgRoot: tmpDir, args: ['--dry-run'] })
+
+    expect(existsSync(join(tmpDir, 'some-file.md'))).toBe(true)
+    expect(existsSync(join(tmpDir, '.opencastle'))).toBe(true)
+    const { readFile } = await import('node:fs/promises')
+    const gitignore = await readFile(join(tmpDir, '.gitignore'), 'utf8')
+    expect(gitignore).toContain(START_MARKER)
+  })
+
+  it('exits with error when no manifest found', async () => {
+    await expect(destroy({ pkgRoot: tmpDir, args: [] })).rejects.toThrow('process.exit called')
+    expect(exitSpy).toHaveBeenCalledWith(1)
+  })
+})

package/src/cli/destroy.ts

@@ -0,0 +1,88 @@
+import { resolve } from 'node:path'
+import { unlink } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { readManifest } from './manifest.js'
+import { removeDirIfExists } from './copy.js'
+import { removeGitignoreBlock } from './gitignore.js'
+import { confirm, closePrompts, c } from './prompt.js'
+import type { CliContext } from './types.js'
+
+export default async function destroy({
+  pkgRoot: _pkgRoot,
+  args,
+}: CliContext): Promise<void> {
+  const projectRoot = process.cwd()
+  const dryRun = args.includes('--dry-run') || args.includes('--dryRun')
+
+  const manifest = await readManifest(projectRoot)
+  if (!manifest) {
+    console.error('  ✗ No OpenCastle installation found.')
+    process.exit(1)
+  }
+
+  const frameworkPaths = manifest.managedPaths?.framework ?? []
+  const customizablePaths = manifest.managedPaths?.customizable ?? []
+  const legacyManifestPath = resolve(projectRoot, '.opencastle.json')
+  const hasLegacy = existsSync(legacyManifestPath)
+
+  console.log(`\n  🏰 OpenCastle destroy\n`)
+  console.log('  This will permanently remove:\n')
+
+  for (const p of frameworkPaths) {
+    console.log(`    ${c.dim(p)}`)
+  }
+  for (const p of customizablePaths) {
+    console.log(`    ${c.dim(p)}`)
+  }
+  console.log(`    ${c.dim('.opencastle/')}`)
+  if (hasLegacy) {
+    console.log(`    ${c.dim('.opencastle.json')}`)
+  }
+  console.log(`    ${c.dim('.gitignore block')}\n`)
+
+  if (dryRun) {
+    console.log('  [dry-run] No files were changed.\n')
+    return
+  }
+
+  const proceed = await confirm(
+    'This will permanently delete all OpenCastle files. Continue?',
+    false
+  )
+  if (!proceed) {
+    console.log('  Aborted.')
+    closePrompts()
+    return
+  }
+
+  let removed = 0
+
+  for (const p of [...frameworkPaths, ...customizablePaths]) {
+    if (p.endsWith('/')) {
+      const dir = resolve(projectRoot, p)
+      await removeDirIfExists(dir)
+      removed++
+    } else {
+      const file = resolve(projectRoot, p)
+      if (existsSync(file)) {
+        await unlink(file)
+        removed++
+      }
+    }
+  }
+
+  await removeDirIfExists(resolve(projectRoot, '.opencastle'))
+  removed++
+
+  if (hasLegacy) {
+    await unlink(legacyManifestPath)
+    removed++
+  }
+
+  const gitignoreResult = await removeGitignoreBlock(projectRoot)
+
+  console.log(`\n  ${c.green('✓')} Removed ${removed} path(s)${gitignoreResult === 'removed' ? ' + .gitignore block' : ''}.`)
+  console.log(`  You can uninstall: ${c.bold('npm uninstall opencastle')}\n`)
+
+  closePrompts()
+}

package/src/cli/gitignore.ts

@@ -72,3 +72,39 @@ export async function updateGitignore(
   await writeFile(gitignorePath, existing + separator + block + '\n', 'utf8')
   return 'updated'
 }
+
+/**
+ * Remove the OpenCastle managed block from `.gitignore`.
+ *
+ * - No-op if no `.gitignore` exists or no block is present.
+ * - Cleans up resulting double blank lines.
+ * - Deletes `.gitignore` if the file becomes empty after removal.
+ * - Returns 'removed' or 'unchanged'.
+ */
+export async function removeGitignoreBlock(
+  projectRoot: string
+): Promise<'removed' | 'unchanged'> {
+  const gitignorePath = resolve(projectRoot, '.gitignore')
+  if (!existsSync(gitignorePath)) return 'unchanged'
+
+  const existing = await readFile(gitignorePath, 'utf8')
+  const startIdx = existing.indexOf(START_MARKER)
+  const endIdx = existing.indexOf(END_MARKER)
+
+  if (startIdx === -1 || endIdx === -1) return 'unchanged'
+
+  const before = existing.slice(0, startIdx)
+  const after = existing.slice(endIdx + END_MARKER.length)
+
+  // Collapse consecutive blank lines left by removal
+  const updated = (before + after).replace(/\n{3,}/g, '\n\n').trimEnd()
+
+  if (!updated) {
+    const { unlink } = await import('node:fs/promises')
+    await unlink(gitignorePath)
+    return 'removed'
+  }
+
+  await writeFile(gitignorePath, updated + '\n', 'utf8')
+  return 'removed'
+}

package/src/cli/plan.ts

@@ -0,0 +1,316 @@
+import { readFile } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { resolve, join, basename } from 'node:path'
+import { mkdir, writeFile } from 'node:fs/promises'
+import { getAdapter, detectAdapter } from './run/adapters/index.js'
+import { parseTaskSpecText } from './run/schema.js'
+import { c } from './prompt.js'
+import type { CliContext, Task } from './types.js'
+
+const HELP = `
+  opencastle plan [options]
+
+  Generate a convoy spec from a task description file by running it through the
+  generate-convoy prompt via an AI adapter.
+
+  Options:
+    --file, -f <path>        Path to a text file with the task description (required)
+    --context <path>         Optional path to an additional context file
+    --output, -o <path>      Output path for the generated convoy spec
+    --adapter, -a <name>     Override agent runtime adapter
+    --verbose                Show full agent output
+    --dry-run                Print the prompt that would be sent without executing
+    --help, -h               Show this help
+`
+
+interface PlanOptions {
+  file: string | null
+  context: string | null
+  output: string | null
+  adapter: string | null
+  verbose: boolean
+  dryRun: boolean
+  help: boolean
+}
+
+function parseArgs(args: string[]): PlanOptions {
+  const opts: PlanOptions = {
+    file: null,
+    context: null,
+    output: null,
+    adapter: null,
+    verbose: false,
+    dryRun: false,
+    help: false,
+  }
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+    switch (arg) {
+      case '--help':
+      case '-h':
+        opts.help = true
+        break
+      case '--file':
+      case '-f':
+        if (i + 1 >= args.length) { console.error('  ✗ --file requires a path'); process.exit(1) }
+        opts.file = args[++i]
+        break
+      case '--context':
+        if (i + 1 >= args.length) { console.error('  ✗ --context requires a path'); process.exit(1) }
+        opts.context = args[++i]
+        break
+      case '--output':
+      case '-o':
+        if (i + 1 >= args.length) { console.error('  ✗ --output requires a path'); process.exit(1) }
+        opts.output = args[++i]
+        break
+      case '--adapter':
+      case '-a':
+        if (i + 1 >= args.length) { console.error('  ✗ --adapter requires a name'); process.exit(1) }
+        opts.adapter = args[++i]
+        break
+      case '--verbose':
+        opts.verbose = true
+        break
+      case '--dry-run':
+      case '--dryRun':
+        opts.dryRun = true
+        break
+      default:
+        console.error(`  ✗ Unknown option: ${arg}`)
+        console.log(HELP)
+        process.exit(1)
+    }
+  }
+
+  return opts
+}
+
+function printAdapterError(detectionFailed: boolean, adapterName: string): void {
+  if (detectionFailed) {
+    console.error(
+      `  ✗ No agent CLI found on your PATH.\n` +
+        `    Install one of the following adapters:\n` +
+        `    • copilot    — https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli\n` +
+        `    • claude     — npm install -g @anthropic-ai/claude-code\n` +
+        `    • cursor     — https://cursor.com (Cursor > Install CLI)\n` +
+        `    • opencode   — https://opencode.ai\n` +
+        `\n` +
+        `    Or specify an adapter explicitly: opencastle plan --adapter <name>`
+    )
+  } else {
+    const hints: Record<string, string> = {
+      'claude':
+        '    Install: npm install -g @anthropic-ai/claude-code\n' +
+        '    Docs:    https://docs.anthropic.com/en/docs/claude-code',
+      copilot:
+        '    Requires the Copilot CLI installed and authenticated:\n' +
+        '    https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli\n' +
+        '    Docs:    https://docs.github.com/en/copilot',
+      cursor:
+        '    The Cursor agent CLI ships with the Cursor editor.\n' +
+        '    Install Cursor from https://cursor.com and ensure the\n' +
+        '    "agent" command is on your PATH (Cursor > Install CLI).',
+      opencode:
+        '    Install OpenCode from https://opencode.ai\n' +
+        '    Ensure the "opencode" command is on your PATH.',
+    }
+    const cliName = adapterName === 'cursor' ? 'agent' : adapterName
+    const hint = hints[adapterName] ?? ''
+    console.error(
+      `  ✗ Adapter "${adapterName}" is not available.\n` +
+        `    Make sure the "${cliName}" CLI is installed and on your PATH.\n` +
+        hint
+    )
+  }
+}
+
+/**
+ * Strip YAML frontmatter (everything between first and second --- lines).
+ */
+function stripFrontmatter(text: string): string {
+  const lines = text.split('\n')
+  if (lines[0]?.trim() !== '---') return text
+  const closingIdx = lines.findIndex((line, i) => i > 0 && line.trim() === '---')
+  if (closingIdx === -1) return text
+  return lines.slice(closingIdx + 1).join('\n').trimStart()
+}
+
+/**
+ * Extract YAML content from a fenced code block (```yaml or ```yml).
+ */
+function extractYamlBlock(text: string): string | null {
+  const match = text.match(/```ya?ml\s*\n([\s\S]*?)```/)
+  if (!match) return null
+  return match[1].trim()
+}
+
+/**
+ * Derive an output filename from YAML content.
+ * Checks for a comment on the first line, then falls back to the `name` field.
+ */
+function deriveOutputFilename(yaml: string): string {
+  // First line comment: # .opencastle/convoys/some-name.convoy.yml
+  const firstLine = yaml.split('\n')[0] ?? ''
+  const commentMatch = firstLine.match(/^#\s*(.+\.convoy\.ya?ml)\s*$/)
+  if (commentMatch) {
+    return basename(commentMatch[1])
+  }
+
+  // Fall back to `name:` field
+  const nameMatch = yaml.match(/^name:\s*['"]?([^'"\n]+)['"]?\s*$/m)
+  if (nameMatch) {
+    const kebab = nameMatch[1].trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '')
+    if (kebab) return `${kebab}.convoy.yml`
+  }
+
+  return 'convoy-plan.convoy.yml'
+}
+
+export default async function plan({ args, pkgRoot }: CliContext): Promise<void> {
+  const opts = parseArgs(args)
+
+  if (opts.help) {
+    console.log(HELP)
+    return
+  }
+
+  // ── Validate required --file arg ──────────────────────────────
+  if (!opts.file) {
+    console.error(`  ✗ --file is required. Specify a text file with the task description.`)
+    console.log(HELP)
+    process.exit(1)
+  }
+
+  const filePath = resolve(process.cwd(), opts.file)
+  if (!existsSync(filePath)) {
+    console.error(`  ✗ File not found: ${opts.file}`)
+    process.exit(1)
+  }
+
+  // ── Read task description ──────────────────────────────────────
+  const taskDescription = await readFile(filePath, 'utf8')
+
+  // ── Read optional context file ─────────────────────────────────
+  let contextContent = ''
+  if (opts.context) {
+    const contextPath = resolve(process.cwd(), opts.context)
+    if (!existsSync(contextPath)) {
+      console.error(`  ✗ Context file not found: ${opts.context}`)
+      process.exit(1)
+    }
+    contextContent = await readFile(contextPath, 'utf8')
+  }
+
+  // ── Load and assemble the prompt template ─────────────────────
+  const promptTemplatePath = join(pkgRoot, 'src', 'orchestrator', 'prompts', 'generate-convoy.prompt.md')
+  if (!existsSync(promptTemplatePath)) {
+    console.error(`  ✗ Prompt template not found: ${promptTemplatePath}`)
+    process.exit(1)
+  }
+
+  const rawTemplate = await readFile(promptTemplatePath, 'utf8')
+  const template = stripFrontmatter(rawTemplate)
+  const assembledPrompt = template
+    .replace('{{goal}}', taskDescription.trim())
+    .replace('{{context}}', contextContent.trim())
+
+  // ── Dry-run: print prompt and exit ────────────────────────────
+  if (opts.dryRun) {
+    console.log(c.bold(c.cyan('  Assembled prompt (dry-run):\n')))
+    console.log(assembledPrompt)
+    return
+  }
+
+  // ── Resolve adapter ───────────────────────────────────────────
+  let adapterName: string
+  if (opts.adapter) {
+    adapterName = opts.adapter
+  } else {
+    const detected = await detectAdapter()
+    if (!detected) {
+      printAdapterError(true, '')
+      process.exit(1)
+    }
+    adapterName = detected
+  }
+
+  let adapter
+  try {
+    adapter = await getAdapter(adapterName)
+  } catch {
+    printAdapterError(false, adapterName)
+    process.exit(1)
+  }
+
+  const available = await adapter.isAvailable()
+  if (!available) {
+    printAdapterError(false, adapterName)
+    process.exit(1)
+  }
+
+  console.log(c.dim(`  Using adapter: ${adapterName}`))
+  console.log(c.dim(`  Generating convoy spec from: ${opts.file}\n`))
+
+  // ── Execute the prompt through the adapter ────────────────────
+  const task: Task = {
+    id: 'generate-convoy',
+    prompt: assembledPrompt,
+    agent: 'team-lead',
+    timeout: '10m',
+    depends_on: [],
+    files: [],
+    description: 'Generate convoy spec from task description',
+    max_retries: 1,
+  }
+
+  const result = await adapter.execute(task, { verbose: opts.verbose })
+
+  // ── Extract YAML from the response ────────────────────────────
+  const yamlContent = extractYamlBlock(result.output)
+  if (!yamlContent) {
+    const preview = result.output.slice(0, 500)
+    console.error(`  ✗ No YAML code block found in the agent response.\n`)
+    console.error(c.dim(`  Raw output (truncated):\n${preview}`))
+    process.exit(1)
+  }
+
+  // ── Validate YAML ─────────────────────────────────────────────
+  let validationWarning = false
+  try {
+    parseTaskSpecText(yamlContent)
+  } catch (err) {
+    validationWarning = true
+    const msg = err instanceof Error ? err.message : String(err)
+    console.warn(c.yellow(`  ⚠ YAML validation warning: ${msg}`))
+    console.warn(c.dim(`    The file will still be written — you may need to edit it before running.\n`))
+  }
+
+  // ── Determine output path ─────────────────────────────────────
+  let outputPath: string
+  if (opts.output) {
+    outputPath = resolve(process.cwd(), opts.output)
+  } else {
+    const convoyDir = resolve(process.cwd(), '.opencastle', 'convoys')
+    await mkdir(convoyDir, { recursive: true })
+    const filename = deriveOutputFilename(yamlContent)
+    outputPath = join(convoyDir, filename)
+  }
+
+  await mkdir(resolve(outputPath, '..'), { recursive: true })
+  await writeFile(outputPath, yamlContent + '\n', 'utf8')
+
+  const relPath = outputPath.startsWith(process.cwd())
+    ? outputPath.slice(process.cwd().length + 1)
+    : outputPath
+
+  console.log(c.green(`  ✓ Convoy spec written to ${relPath}`))
+  if (validationWarning) {
+    console.log(c.yellow(`    (contains validation warnings — review before running)`))
+  }
+  console.log(`
+  ${c.dim('Preview:')} npx opencastle run -f ${relPath} --dry-run
+  ${c.dim('Execute:')} npx opencastle run -f ${relPath}
+`)
+}

package/src/dashboard/node_modules/.vite/deps/_metadata.json

@@ -1,25 +1,25 @@
 {
-  "hash": "0f52f4b3",
+  "hash": "46302718",
   "configHash": "30f8ea04",
-  "lockfileHash": "cf370ff3",
-  "browserHash": "cd4e9a91",
+  "lockfileHash": "0bec59b6",
+  "browserHash": "455152ca",
   "optimized": {
     "astro > cssesc": {
       "src": "../../../../../node_modules/cssesc/cssesc.js",
       "file": "astro___cssesc.js",
-      "fileHash": "cfa5042b",
+      "fileHash": "5409385e",
       "needsInterop": true
     },
     "astro > aria-query": {
       "src": "../../../../../node_modules/aria-query/lib/index.js",
       "file": "astro___aria-query.js",
-      "fileHash": "80fa9785",
+      "fileHash": "5fd7c72e",
       "needsInterop": true
     },
     "astro > axobject-query": {
       "src": "../../../../../node_modules/axobject-query/lib/index.js",
       "file": "astro___axobject-query.js",
-      "fileHash": "73e4f752",
+      "fileHash": "530306fc",
       "needsInterop": true
     }
   },