@delegance/claude-autopilot 6.2.2 → 7.2.1

package/dist/src/cli/dashboard/upload.js

@@ -0,0 +1,48 @@
+// `claude-autopilot dashboard upload <runId>` — manual upload wrapper.
+//
+// Locates run dir at <homeDir>/runs/<runId>, calls uploadRun() directly,
+// and prints the result. Intended for resuming interrupted auto-uploads.
+import * as path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { readConfig, getConfigDir } from "../../dashboard/config.js";
+import { uploadRun } from "../../dashboard/upload/uploader.js";
+export async function runDashboardUpload(opts) {
+    const cfg = await readConfig();
+    if (!cfg) {
+        if (!opts.silent) {
+            process.stderr.write(`[autopilot] not logged in. Run: claude-autopilot dashboard login\n`);
+        }
+        return { ok: false, notLoggedIn: true };
+    }
+    const runsDir = opts.runsDir ?? path.join(getConfigDir(), 'runs');
+    const runDir = path.join(runsDir, opts.runId);
+    try {
+        await fs.access(runDir);
+    }
+    catch {
+        if (!opts.silent) {
+            process.stderr.write(`[autopilot] run dir not found: ${runDir}\n`);
+        }
+        return { ok: false, runDirMissing: true, runDir };
+    }
+    const uploadOpts = {
+        apiKey: cfg.apiKey,
+        ...(opts.baseUrl !== undefined ? { baseUrl: opts.baseUrl } : {}),
+        ...(opts.fetchImpl !== undefined ? { fetchImpl: opts.fetchImpl } : {}),
+        ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+    };
+    const res = await uploadRun(opts.runId, runDir, uploadOpts);
+    if (!opts.silent) {
+        if (res.ok && res.url) {
+            process.stdout.write(`[autopilot] uploaded to ${res.url}\n`);
+        }
+        else if (res.ok && res.skipped) {
+            process.stdout.write(`[autopilot] skipping upload — events.ndjson is empty\n`);
+        }
+        else {
+            process.stderr.write(`[autopilot] upload failed: ${res.error}\n`);
+        }
+    }
+    return { ...res, runDir };
+}
+//# sourceMappingURL=upload.js.map

package/dist/src/cli/engine-flag-deprecation.d.ts

@@ -0,0 +1,14 @@
+/** Banner emitted to stderr (once per process) when `--engine` is
+ *  passed in v7.0+. The flag is preserved as a no-op shim; the engine
+ *  is unconditionally on. Codex pass-3 NOTE #2. */
+export declare const ENGINE_FLAG_DEPRECATION_MESSAGE = "[deprecation] --engine is a no-op in v7.0+ (engine is always on). Drop the flag from your scripts.";
+/** Banner emitted to stderr when `--no-engine` is passed in v7.0+. The
+ *  dispatcher rejects with `invalid_config` exit 1 immediately after. */
+export declare const ENGINE_OFF_REMOVED_MESSAGE = "[deprecation] --no-engine was removed in v7.0. The engine is always on. See docs/v7/breaking-changes.md.";
+/** Banner emitted to stderr (once per process) when
+ *  `CLAUDE_AUTOPILOT_ENGINE` is set to an off-style value. The env value
+ *  is otherwise ignored — softer than the `--no-engine` rejection
+ *  because env vars in CI are sticky and silently breaking every
+ *  v6.x → v7 upgrade in CI on day one would burn user trust. */
+export declare const ENGINE_OFF_ENV_REMOVED_MESSAGE = "[deprecation] CLAUDE_AUTOPILOT_ENGINE=off has no effect in v7.0+ (engine is always on). Unset the env var.";
+//# sourceMappingURL=engine-flag-deprecation.d.ts.map

package/dist/src/cli/engine-flag-deprecation.js

@@ -0,0 +1,20 @@
+// src/cli/engine-flag-deprecation.ts
+//
+// v7.0 — exported deprecation constants for the engine-flag removal.
+// Pulled out of src/cli/index.ts so tests can import them without
+// triggering the dispatcher's top-level switch (which exits the
+// process on module load).
+/** Banner emitted to stderr (once per process) when `--engine` is
+ *  passed in v7.0+. The flag is preserved as a no-op shim; the engine
+ *  is unconditionally on. Codex pass-3 NOTE #2. */
+export const ENGINE_FLAG_DEPRECATION_MESSAGE = '[deprecation] --engine is a no-op in v7.0+ (engine is always on). Drop the flag from your scripts.';
+/** Banner emitted to stderr when `--no-engine` is passed in v7.0+. The
+ *  dispatcher rejects with `invalid_config` exit 1 immediately after. */
+export const ENGINE_OFF_REMOVED_MESSAGE = '[deprecation] --no-engine was removed in v7.0. The engine is always on. See docs/v7/breaking-changes.md.';
+/** Banner emitted to stderr (once per process) when
+ *  `CLAUDE_AUTOPILOT_ENGINE` is set to an off-style value. The env value
+ *  is otherwise ignored — softer than the `--no-engine` rejection
+ *  because env vars in CI are sticky and silently breaking every
+ *  v6.x → v7 upgrade in CI on day one would burn user trust. */
+export const ENGINE_OFF_ENV_REMOVED_MESSAGE = '[deprecation] CLAUDE_AUTOPILOT_ENGINE=off has no effect in v7.0+ (engine is always on). Unset the env var.';
+//# sourceMappingURL=engine-flag-deprecation.js.map

package/dist/src/cli/help-text.d.ts

@@ -42,7 +42,7 @@ export declare const HELP_OPTIONS: Record<string, string>;
  * support varies; v6.0.1 wires them into `scan` first, additional verbs land
  * in subsequent v6.0.x point releases per docs/v6/wrapping-pipeline-phases.md).
  */
-export declare const GLOBAL_FLAGS_BLOCK = "Global flags:\n  --json                 Emit a structured JSON envelope on stdout (most verbs)\n  --engine               Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)\n  --no-engine            Force the legacy stateless code path (overrides config / env)\n                         Precedence: CLI > env (CLAUDE_AUTOPILOT_ENGINE) > config (engine.enabled) > built-in default\n                         v6.0.1: wired for `scan`. v6.0.2: wired for `fix` and `costs`. v6.0.3: wired for `brainstorm` and `spec`. v6.0.4: wired for `plan` and `review`. v6.0.5: wired for `validate`. v6.0.7: wired for `implement`. v6.0.8: wired for `migrate`. v6.0.9: wired for `pr`. ALL 10 phases now wrapped \u2014 v6.0.x feature-complete.";
+export declare const GLOBAL_FLAGS_BLOCK = "Global flags:\n  --json                 Emit a structured JSON envelope on stdout (most verbs)\n  --engine               [v7.0 deprecated no-op] engine is always on; flag emits a warning\n                         v7.0 removed the engine-off opt-out flag and code path entirely.\n                         CLAUDE_AUTOPILOT_ENGINE=off is now ignored (warns once per process)\n                         instead of disabling the engine. See docs/v7/breaking-changes.md.";
 /** Build the full two-level help text. Returned as a string so tests can assert against it without spawning. */
 export declare function buildHelpText(): string;
 /** Build help text for a single verb. Returns null if the verb is unknown. */

package/dist/src/cli/help-text.js

@@ -28,6 +28,7 @@ export const HELP_GROUPS = [
         verbs: [
             { verb: 'init', summary: 'Scaffold guardrail.config.yaml + auto-detect migrate stack (writes .autopilot/stack.md)' },
             { verb: 'setup', summary: 'Auto-detect stack, write config, install pre-push hook' },
+            { verb: 'scaffold', summary: 'Scaffold project skeleton from a spec markdown (--from-spec <path>)' },
             { verb: 'autopilot', summary: 'Multi-phase orchestrator — run scan → spec → plan → implement under one runId (v6.2.0)' },
             { verb: 'brainstorm', summary: 'Pipeline entry point (Claude Code skill — see /brainstorm)' },
             { verb: 'spec', summary: 'Spec-writing pointer (Claude Code skill — see /brainstorm)' },
@@ -87,6 +88,13 @@ export const HELP_GROUPS = [
             { verb: 'runs', summary: 'Inspect run state: runs list | show <id> | watch <id> | resume <id> | gc | delete <id> | doctor' },
         ],
     },
+    {
+        name: 'Dashboard',
+        tagline: 'hosted product — login, status, manual upload (v7.0 Phase 2.3)',
+        verbs: [
+            { verb: 'dashboard', summary: 'Manage hosted dashboard auth + uploads: dashboard {login,logout,status,upload <runId>}' },
+        ],
+    },
     {
         name: 'Advanced',
         tagline: 'server / experimental — hidden from welcome screen',
@@ -125,15 +133,13 @@ export const HELP_OPTIONS = {
   --focus <type>       security | logic | performance (default: all)
   --dry-run            List files that would be scanned without running
   --config <path>      Path to config file
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)`,
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning`,
     pr: `Options (pr):
   <number>                   PR number to review (optional if on a PR branch)
   --no-post-comments         Skip posting/updating PR summary comment
   --no-inline-comments       Skip posting per-line inline annotations
   --config <path>            Path to config file
-  --engine                   Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine                Force the legacy stateless code path (overrides config / env)
+  --engine                   [v7.0 deprecated no-op] engine is always on; flag emits a warning
 
   Note: pr is side-effecting — it posts/updates a PR comment and inline
         review comments via the gh CLI. Engine-on records a github-pr
@@ -144,16 +150,13 @@ export const HELP_OPTIONS = {
   --severity <critical|warning|all>  Which findings to fix (default: critical)
   --dry-run                          Preview fixes without writing files
   --config <path>                    Path to config file
-  --engine                           Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine                        Force the legacy stateless code path (overrides config / env)`,
+  --engine                           [v7.0 deprecated no-op] engine is always on; flag emits a warning`,
     costs: `Options (costs):
   --config <path>      Path to config file
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)`,
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning`,
     brainstorm: `Options (brainstorm):
   --config <path>      Path to config file
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning
   --json               Emit a structured JSON envelope on stdout
 
   Note: brainstorm is primarily a Claude Code skill (/brainstorm). The CLI
@@ -161,8 +164,7 @@ export const HELP_OPTIONS = {
         snapshot (state.json + events.ndjson) for pipeline introspection.`,
     spec: `Options (spec):
   --config <path>      Path to config file
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning
   --json               Emit a structured JSON envelope on stdout
 
   Note: spec is primarily a Claude Code skill (entered via /brainstorm). The
@@ -172,20 +174,17 @@ export const HELP_OPTIONS = {
   --spec <path>        Spec file the planner should read (optional)
   --output <path>      Where to write the plan markdown (default: .guardrail-cache/plans/<ts>-plan.md)
   --config <path>      Path to config file
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)`,
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning`,
     review: `Options (review):
   --context <text>     Optional context note injected into the review log
   --output <path>      Where to write the review log (default: .guardrail-cache/reviews/<ts>-review.md)
   --config <path>      Path to config file
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)`,
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning`,
     validate: `Options (validate):
   --context <text>     Optional context note injected into the validate log
   --output <path>      Where to write the validate log (default: .guardrail-cache/validate/<ts>-validate.md)
   --config <path>      Path to config file
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning
 
   Note: validate is primarily a Claude Code skill (/validate). The CLI verb
         is an engine-wrap shell; engine-on still produces a run-state
@@ -195,8 +194,7 @@ export const HELP_OPTIONS = {
   --mode <full>        Pipeline mode (v6.2.0 ships 'full' only — scan → spec → plan → implement)
   --phases <a,b,c>     Explicit phase list (comma-separated; overrides --mode)
   --budget <usd>       Run-scope budget cap (USD). Cross-phase — actualSoFar accumulates across phases.
-  --engine             Run under the v6 Run State Engine (REQUIRED — engine-off is rejected)
-  --no-engine          REJECTED — orchestrator requires engine-on (rejected at pre-flight, exit 1)
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning
 
   Behavior: drives N pipeline phases under ONE runId so a \`runs watch <id>\`
             window covers the whole pipeline. Sequential — no parallel
@@ -215,13 +213,32 @@ export const HELP_OPTIONS = {
     claude-autopilot autopilot
     claude-autopilot autopilot --budget 25
     claude-autopilot autopilot --phases=scan,spec,plan`,
+    dashboard: `Options (dashboard):
+  login                Open browser, mint API key via loopback callback
+  logout               Revoke server-side, delete local config
+  status               Show login state + memberships + last upload
+  upload <runId>       Manually upload a run (resume an interrupted auto-upload)
+
+  Auto-upload: after \`dashboard login\`, every engine-on autopilot run
+  uploads to autopilot.dev when run.complete fires. Failure prints a
+  resume command and never fails the run. Opt out per-run with
+  \`--no-upload\` or globally with \`CLAUDE_AUTOPILOT_UPLOAD=off\`.
+
+  Env:
+    AUTOPILOT_DASHBOARD_BASE_URL   Override base URL (default https://autopilot.dev)
+    CLAUDE_AUTOPILOT_HOME          Override config dir (default ~/.claude-autopilot)
+    CLAUDE_AUTOPILOT_UPLOAD=off    Skip auto-upload at run.complete
+
+  Examples:
+    claude-autopilot dashboard login
+    claude-autopilot dashboard status
+    claude-autopilot dashboard upload 01HFGB...`,
     implement: `Options (implement):
   --context <text>     Optional context note injected into the implement log
   --plan <path>        Plan file the implement phase consumed (e.g. docs/plans/<slug>.md)
   --output <path>      Where to write the implement log (default: .guardrail-cache/implement/<ts>-implement.md)
   --config <path>      Path to config file
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning
 
   Note: implement is primarily a Claude Code skill (claude-autopilot — reads
         plan, dispatches subagents per plan phase via subagent-driven-development,
@@ -248,8 +265,7 @@ export const HELP_OPTIONS = {
   --dry-run            Run skill in dry-run mode (no side effects)
   --yes                Required to apply prod migrations in CI
   --config <path>      Path to config file (default: ./guardrail.config.yaml)
-  --engine             Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine          Force the legacy stateless code path (overrides config / env)
+  --engine             [v7.0 deprecated no-op] engine is always on; flag emits a warning
 
   Note: migrate is a side-effecting phase — re-running with --engine after a
         prior phase.success requires --force-replay (Phase 6+) because the
@@ -342,10 +358,10 @@ function padVerb(verb) {
  */
 export const GLOBAL_FLAGS_BLOCK = `Global flags:
   --json                 Emit a structured JSON envelope on stdout (most verbs)
-  --engine               Run under the v6 Run State Engine (writes .guardrail-cache/runs/<ulid>/)
-  --no-engine            Force the legacy stateless code path (overrides config / env)
-                         Precedence: CLI > env (CLAUDE_AUTOPILOT_ENGINE) > config (engine.enabled) > built-in default
-                         v6.0.1: wired for \`scan\`. v6.0.2: wired for \`fix\` and \`costs\`. v6.0.3: wired for \`brainstorm\` and \`spec\`. v6.0.4: wired for \`plan\` and \`review\`. v6.0.5: wired for \`validate\`. v6.0.7: wired for \`implement\`. v6.0.8: wired for \`migrate\`. v6.0.9: wired for \`pr\`. ALL 10 phases now wrapped — v6.0.x feature-complete.`;
+  --engine               [v7.0 deprecated no-op] engine is always on; flag emits a warning
+                         v7.0 removed the engine-off opt-out flag and code path entirely.
+                         CLAUDE_AUTOPILOT_ENGINE=off is now ignored (warns once per process)
+                         instead of disabling the engine. See docs/v7/breaking-changes.md.`;
 /** Build the full two-level help text. Returned as a string so tests can assert against it without spawning. */
 export function buildHelpText() {
     const lines = [];

package/dist/src/cli/index.d.ts

@@ -1,3 +1,4 @@
 #!/usr/bin/env node
-export {};
+export declare function _resetEngineDeprecationLatchForTests(): void;
+export declare function _resetEngineEnvOffLatchForTests(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/cli/index.js

@@ -13,6 +13,7 @@
 import { runCommand } from "./run.js";
 import { runWatch } from "./watch.js";
 import { runSetup } from "./setup.js";
+import { runScaffold } from "./scaffold.js";
 import { runDoctor } from "./preflight.js";
 import { runCi } from "./ci.js";
 import { runFix } from "./fix.js";
@@ -258,30 +259,60 @@ function boolFlag(name) {
     return args.includes(`--${name}`);
 }
 /**
- * Parse the `--engine` / `--no-engine` flag pair into a tri-state.
+ * v7.0 — `--no-engine` removed; `--engine` becomes a no-op shim with a
+ * one-shot per-process deprecation warning to stderr (codex pass-3
+ * NOTE #2). The engine is unconditionally on.
  *
- * Returns:
- *   - true  if `--engine` was passed
- *   - false if `--no-engine` was passed
- *   - undefined if neither was passed
- *
- * If BOTH are passed, exits 1 with `invalid_config` — the spec is explicit
- * that this is single-version-supported, you can't ask for both at once.
+ * Behavior:
+ *   - `--no-engine` → exit 1 with `invalid_config` and a removal hint.
+ *   - `--engine`    → emit one stderr deprecation line per process; return.
+ *   - neither       → no-op; return.
  */
+let __engineDeprecationWarned = false;
+import { ENGINE_FLAG_DEPRECATION_MESSAGE, ENGINE_OFF_REMOVED_MESSAGE, ENGINE_OFF_ENV_REMOVED_MESSAGE, } from "./engine-flag-deprecation.js";
 function parseEngineCliFlag() {
-    const on = args.includes('--engine');
-    const off = args.includes('--no-engine');
-    if (on && off) {
-        console.error(`\x1b[31m[claude-autopilot] invalid_config: --engine and --no-engine cannot both be passed\x1b[0m`);
-        console.error(`\x1b[2m  hint: pass exactly one. Precedence: CLI > env > config > default.\x1b[0m`);
+    if (args.includes('--no-engine')) {
+        console.error(`\x1b[31m[claude-autopilot] invalid_config: ${ENGINE_OFF_REMOVED_MESSAGE}\x1b[0m`);
         process.exit(1);
     }
-    if (on)
-        return true;
-    if (off)
-        return false;
+    if (args.includes('--engine') && !__engineDeprecationWarned) {
+        __engineDeprecationWarned = true;
+        process.stderr.write(`${ENGINE_FLAG_DEPRECATION_MESSAGE}\n`);
+    }
+    checkEngineOffEnvDeprecation();
+    // v7.0 — engine is always on; the resolver ignores cliEngine. We
+    // return undefined so `cliEngine` never gets spread into the
+    // resolver opts (keeps call sites identical and source-compatible).
     return undefined;
 }
+// Test seam: reset the per-process deprecation latch so tests that drive
+// the flag multiple times in one process can exercise the "warn once"
+// behavior repeatably.
+export function _resetEngineDeprecationLatchForTests() {
+    __engineDeprecationWarned = false;
+}
+/**
+ * v7.0 — `CLAUDE_AUTOPILOT_ENGINE=off` is softer than `--no-engine`:
+ * emit a one-shot warning + return undefined so the engine remains on.
+ * Per spec: env vars in CI are sticky and silently breaking every
+ * v6.x → v7 upgrade in CI on day one would burn user trust.
+ */
+let __engineEnvOffWarned = false;
+function checkEngineOffEnvDeprecation() {
+    const raw = process.env.CLAUDE_AUTOPILOT_ENGINE;
+    if (!raw)
+        return;
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === 'off' || normalized === 'false' || normalized === '0' || normalized === 'no') {
+        if (!__engineEnvOffWarned) {
+            __engineEnvOffWarned = true;
+            process.stderr.write(`${ENGINE_OFF_ENV_REMOVED_MESSAGE}\n`);
+        }
+    }
+}
+export function _resetEngineEnvOffLatchForTests() {
+    __engineEnvOffWarned = false;
+}
 /**
  * Run the migrate-doctor with shared CLI formatting and exit handling.
  *
@@ -828,6 +859,7 @@ switch (subcommand) {
             budgetUSD = parsed;
         }
         const cliEngine = parseEngineCliFlag();
+        const noUpload = boolFlag('no-upload');
         if (json) {
             const exitCode = await runAutopilotWithJsonEnvelope({
                 cwd: process.cwd(),
@@ -835,6 +867,7 @@ switch (subcommand) {
                 ...(phases !== undefined ? { phases } : {}),
                 ...(budgetUSD !== undefined ? { budgetUSD } : {}),
                 ...(cliEngine !== undefined ? { cliEngine } : {}),
+                ...(noUpload ? { noUpload: true } : {}),
                 envEngine: process.env.CLAUDE_AUTOPILOT_ENGINE,
             });
             process.exit(exitCode);
@@ -845,6 +878,7 @@ switch (subcommand) {
             ...(phases !== undefined ? { phases } : {}),
             ...(budgetUSD !== undefined ? { budgetUSD } : {}),
             ...(cliEngine !== undefined ? { cliEngine } : {}),
+            ...(noUpload ? { noUpload: true } : {}),
             envEngine: process.env.CLAUDE_AUTOPILOT_ENGINE,
         });
         process.exit(result.exitCode);
@@ -897,6 +931,19 @@ switch (subcommand) {
         process.exit(code);
         break;
     }
+    case 'scaffold': {
+        // v7.2.0 — `claude-autopilot scaffold --from-spec <path>`
+        const fromSpec = flag('from-spec');
+        const dryRun = boolFlag('dry-run');
+        if (!fromSpec) {
+            console.error(`\x1b[31m[claude-autopilot] scaffold requires --from-spec <path>\x1b[0m`);
+            console.error(`  Example: claude-autopilot scaffold --from-spec docs/specs/foo.md`);
+            process.exit(1);
+        }
+        await runScaffold({ specPath: fromSpec, dryRun });
+        process.exit(0);
+        break;
+    }
     case 'council': {
         const config = flag('config');
         const prompt = flag('prompt');
@@ -1294,6 +1341,14 @@ switch (subcommand) {
         process.exit(result.exit);
         break;
     }
+    case 'dashboard': {
+        // v7.0 Phase 2.3 — hosted dashboard verbs.
+        //   claude-autopilot dashboard {login,logout,status,upload <runId>}
+        const { runDashboardVerb } = await import("./dashboard/index.js");
+        const exit = await runDashboardVerb({ argv: args.slice(1) });
+        process.exit(exit);
+        break;
+    }
     default:
         console.error(`\x1b[31m[claude-autopilot] Unknown subcommand: "${subcommand}"\x1b[0m`);
         printUsage();

package/dist/src/cli/scaffold.d.ts

@@ -0,0 +1,39 @@
+export interface ScaffoldOptions {
+    cwd?: string;
+    specPath: string;
+    /** When true, log what would happen but don't write anything. */
+    dryRun?: boolean;
+}
+export interface ScaffoldResult {
+    filesCreated: string[];
+    dirsCreated: string[];
+    filesSkippedExisting: string[];
+    packageJsonAction: 'created' | 'merged' | 'skipped-exists';
+    tsconfigAction: 'created' | 'skipped-exists' | 'skipped-no-ts';
+}
+interface ParsedFiles {
+    /** Raw paths extracted from the `## Files` section bullets. */
+    paths: string[];
+    /** Loosely-parsed package.json hints found anywhere in the section. */
+    packageHints: {
+        bin?: Record<string, string>;
+        type?: 'module' | 'commonjs';
+        dependencies?: Record<string, string>;
+        devDependencies?: Record<string, string>;
+        scripts?: Record<string, string>;
+    };
+}
+/**
+ * Parse the `## Files` (or `## files`) section of a spec markdown file.
+ * Tolerant: missing section returns `null`; malformed bullets are skipped
+ * silently. Returns extracted file paths + best-effort package-hint blob.
+ */
+export declare function parseSpecFiles(markdown: string): ParsedFiles | null;
+/**
+ * Build a minimal starter package.json. Caller passes in any explicit
+ * hints (parsed from spec); we layer Node 22 ESM defaults on top.
+ */
+export declare function buildStarterPackageJson(projectName: string, hints: ParsedFiles['packageHints']): Record<string, unknown>;
+export declare function runScaffold(opts: ScaffoldOptions): Promise<ScaffoldResult>;
+export {};
+//# sourceMappingURL=scaffold.d.ts.map