@aiviatic/kindling 0.1.0

package/dist/engine/index.js

@@ -0,0 +1,234 @@
+import {
+  AGENT_CLI_TABLE,
+  Engine,
+  EngineEmitter,
+  NODE_FLOOR_MAJOR,
+  SCHEMA_VERSION,
+  bmadVersionLabel,
+  buildValidationSummary,
+  cliLoginGuidance,
+  cliMissing,
+  composeInstallArgs,
+  defaultBmadInstalled,
+  defaultLogDir,
+  detectDependencies,
+  eligibleAgentClis,
+  errorMessages,
+  installAgentCli,
+  parseMajor,
+  pins,
+  provisionGitUnix,
+  provisionMessages,
+  readInstalledBmadVersion,
+  recoveryGuidance,
+  runBmadInstall,
+  runSelfCheck,
+  scaffold,
+  stepMessages,
+  writeFailureLog
+} from "../chunk-MW7UAGER.js";
+import {
+  ErrorCode,
+  NON_FATAL_STEPS,
+  Phase,
+  Status,
+  StepId,
+  exec
+} from "../chunk-OU3WSB6B.js";
+
+// engine/orchestrate/launch.ts
+import { dirname, join } from "path";
+function npxCliPath(nodeExe) {
+  return join(dirname(nodeExe), "node_modules", "npm", "bin", "npx-cli.js");
+}
+function composeLaunchCommand({ nodeExe, kindlingVersion }) {
+  const spec = `@aiviatic/kindling@${kindlingVersion}`;
+  if (nodeExe === null) {
+    return { cmd: "npx", args: ["-y", spec] };
+  }
+  return { cmd: nodeExe, args: [npxCliPath(nodeExe), "-y", spec] };
+}
+
+// engine/provision/node-windows.ts
+import { join as join2 } from "path";
+import { mkdir, writeFile } from "fs/promises";
+import { randomUUID } from "crypto";
+function nodeDistUrl(version, arch = "x64") {
+  const v = version.startsWith("v") ? version : `v${version}`;
+  return `https://nodejs.org/dist/${v}/node-${v}-win-${arch}.zip`;
+}
+function nodeExePath(baseDir, version, arch = "x64") {
+  const v = version.startsWith("v") ? version : `v${version}`;
+  return join2(baseDir, `node-${v}-win-${arch}`, "node.exe");
+}
+async function defaultDownload(url, dest) {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`download failed: ${res.status} ${url}`);
+  const buf = Buffer.from(await res.arrayBuffer());
+  await writeFile(dest, buf);
+}
+async function provisionNodeWindows(opts) {
+  const arch = opts.arch ?? "x64";
+  const exec2 = opts.exec ?? exec;
+  const download = opts.download ?? defaultDownload;
+  const extract = opts.extract ?? (async (zip, destDir) => {
+    const r = await exec2("tar", ["-xf", zip, "-C", destDir]);
+    if (r.code !== 0) throw new Error(`extract failed (code ${r.code}): ${r.stderr.trim()}`);
+  });
+  const now = opts.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
+  const emit = (status, humanMessage, level = "info", errorCode) => {
+    opts.emitter.emit({
+      id: randomUUID(),
+      phase: Phase.Provision,
+      step: StepId.ProvisionNode,
+      status,
+      humanMessage,
+      level,
+      timestamp: now(),
+      errorCode
+    });
+  };
+  if (opts.alreadyOk) {
+    emit(Status.Skipped, provisionMessages.nodePresent);
+    return { ok: true, nodeExe: null };
+  }
+  emit(Status.Working, stepMessages[StepId.ProvisionNode]);
+  try {
+    await mkdir(opts.baseDir, { recursive: true });
+    const url = nodeDistUrl(opts.version, arch);
+    const zip = join2(opts.baseDir, `node-${opts.version}-win-${arch}.zip`);
+    await download(url, zip);
+    await extract(zip, opts.baseDir);
+  } catch (err) {
+    emit(Status.Failed, "Setting up Node ran into a problem downloading or unpacking it. Check your connection, then press Retry.", "error", ErrorCode.NetworkLost);
+    throw err;
+  }
+  const nodeExe = nodeExePath(opts.baseDir, opts.version, arch);
+  emit(Status.Done, provisionMessages.nodePresent);
+  return { ok: true, nodeExe };
+}
+
+// engine/provision/node-unix.ts
+import { randomUUID as randomUUID2 } from "crypto";
+var NVM_VERSION = "v0.40.3";
+function nvmNodePath(nvmDir, version) {
+  const v = version.startsWith("v") ? version : `v${version}`;
+  return `${nvmDir}/versions/node/${v}/bin/node`;
+}
+function makeDefaults(exec2) {
+  const run = async (script, args, what) => {
+    const r = await exec2("bash", ["-c", script, "kindling", ...args]);
+    if (r.code !== 0) throw new Error(`${what} failed (code ${r.code}): ${r.stderr.trim()}`);
+  };
+  return {
+    // Install nvm only if it's not already present at $1 (idempotent).
+    installNvm: (nvmDir) => run(
+      `export NVM_DIR="$1"; [ -s "$NVM_DIR/nvm.sh" ] || curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh | bash`,
+      [nvmDir],
+      "nvm install"
+    ),
+    // Source nvm in the same shell, then install the pinned version. We do NOT touch `nvm alias
+    // default` — clobbering the user's global default would break their other projects (FR4); the
+    // launch step uses the absolute nodeExe path instead.
+    nvmInstallNode: (nvmDir, version) => run(
+      `export NVM_DIR="$1"; . "$NVM_DIR/nvm.sh"; nvm install "$2"`,
+      [nvmDir, version],
+      "nvm install node"
+    )
+  };
+}
+async function provisionNodeUnix(opts) {
+  const exec2 = opts.exec ?? exec;
+  const defaults = makeDefaults(exec2);
+  const installNvm = opts.installNvm ?? defaults.installNvm;
+  const nvmInstallNode = opts.nvmInstallNode ?? defaults.nvmInstallNode;
+  const nodeInstalled = opts.nodeInstalled ?? (async (nvmDir, version) => {
+    const want = version.startsWith("v") ? version : `v${version}`;
+    try {
+      const r = await exec2(nvmNodePath(nvmDir, version), ["--version"]);
+      return r.code === 0 && r.stdout.trim() === want;
+    } catch {
+      return false;
+    }
+  });
+  const now = opts.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
+  const emit = (status, humanMessage, level = "info", errorCode) => {
+    opts.emitter.emit({
+      id: randomUUID2(),
+      phase: Phase.Provision,
+      step: StepId.ProvisionNode,
+      status,
+      humanMessage,
+      level,
+      timestamp: now(),
+      errorCode
+    });
+  };
+  if (opts.alreadyOk && opts.platform !== "darwin") {
+    emit(Status.Skipped, provisionMessages.nodePresent);
+    return { ok: true, nodeExe: null };
+  }
+  if (await nodeInstalled(opts.nvmDir, opts.version)) {
+    emit(Status.Skipped, provisionMessages.nodePresent);
+    return { ok: true, nodeExe: nvmNodePath(opts.nvmDir, opts.version) };
+  }
+  emit(Status.Working, stepMessages[StepId.ProvisionNode]);
+  try {
+    await installNvm(opts.nvmDir);
+    await nvmInstallNode(opts.nvmDir, opts.version);
+  } catch (err) {
+    emit(
+      Status.Failed,
+      "Setting up Node ran into a problem downloading or installing it. Check your connection, then press Retry.",
+      "error",
+      ErrorCode.NetworkLost
+    );
+    throw err;
+  }
+  const nodeExe = nvmNodePath(opts.nvmDir, opts.version);
+  emit(Status.Done, provisionMessages.nodePresent);
+  return { ok: true, nodeExe };
+}
+export {
+  AGENT_CLI_TABLE,
+  Engine,
+  EngineEmitter,
+  ErrorCode,
+  NODE_FLOOR_MAJOR,
+  NON_FATAL_STEPS,
+  NVM_VERSION,
+  Phase,
+  SCHEMA_VERSION,
+  Status,
+  StepId,
+  bmadVersionLabel,
+  buildValidationSummary,
+  cliLoginGuidance,
+  cliMissing,
+  composeInstallArgs,
+  composeLaunchCommand,
+  defaultBmadInstalled,
+  defaultLogDir,
+  detectDependencies,
+  eligibleAgentClis,
+  errorMessages,
+  exec,
+  installAgentCli,
+  nodeDistUrl,
+  nodeExePath,
+  npxCliPath,
+  nvmNodePath,
+  parseMajor,
+  pins,
+  provisionGitUnix,
+  provisionNodeUnix,
+  provisionNodeWindows,
+  readInstalledBmadVersion,
+  recoveryGuidance,
+  runBmadInstall,
+  runSelfCheck,
+  scaffold,
+  stepMessages,
+  writeFailureLog
+};
+//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../engine/orchestrate/launch.ts","../../engine/provision/node-windows.ts","../../engine/provision/node-unix.ts"],"sourcesContent":["import { dirname, join } from 'node:path';\n\nexport interface LaunchRuntime {\n  /** Absolute path to the provisioned node binary, or null to use `node`/`npx` on PATH\n   *  (a reused system Node, or nvm sourced same-shell). See ProvisionResult.nodeExe. */\n  nodeExe: string | null;\n  /** Pinned Kindling version (pins.kindling). */\n  kindlingVersion: string;\n}\n\nexport interface LaunchCommand {\n  cmd: string;\n  args: string[];\n}\n\n/** Path to npx's CLI script beside a provisioned node binary (the npm bundled with the dist). */\nexport function npxCliPath(nodeExe: string): string {\n  return join(dirname(nodeExe), 'node_modules', 'npm', 'bin', 'npx-cli.js');\n}\n\n/**\n * Compose the command to launch Kindling once Node is provisioned (Story 2.6). The clean-runtime\n * rule (AR6): never depend on a freshly-mutated PATH —\n *  - `nodeExe === null` → Node is already on PATH (nvm sourced same-shell, or a reused system\n *    Node) → plain `npx -y @aiviatic/kindling@<pin>`.\n *  - `nodeExe` set (Windows portable, absolute) → invoke npx's CLI through that exact node binary,\n *    so the launch works without the portable Node ever being on PATH.\n * Pure — the bootstrap (or a future Windows launcher) spawns the returned command.\n */\nexport function composeLaunchCommand({ nodeExe, kindlingVersion }: LaunchRuntime): LaunchCommand {\n  const spec = `@aiviatic/kindling@${kindlingVersion}`;\n  if (nodeExe === null) {\n    return { cmd: 'npx', args: ['-y', spec] };\n  }\n  return { cmd: nodeExe, args: [npxCliPath(nodeExe), '-y', spec] };\n}\n","import { join } from 'node:path';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport { randomUUID } from 'node:crypto';\nimport { exec as defaultExec, type ExecResult } from '../exec';\nimport type { EngineEmitter } from '../emitter';\nimport { Phase, StepId, Status, ErrorCode, type Level } from '../contract';\nimport { stepMessages, provisionMessages } from '../messages';\n\nexport type NodeArch = 'x64' | 'arm64';\n\n/** Official Node Windows .zip URL for a pinned version. Pure. */\nexport function nodeDistUrl(version: string, arch: NodeArch = 'x64'): string {\n  const v = version.startsWith('v') ? version : `v${version}`;\n  return `https://nodejs.org/dist/${v}/node-${v}-win-${arch}.zip`;\n}\n\n/** Absolute path to node.exe inside the extracted distribution. Pure. */\nexport function nodeExePath(baseDir: string, version: string, arch: NodeArch = 'x64'): string {\n  const v = version.startsWith('v') ? version : `v${version}`;\n  return join(baseDir, `node-${v}-win-${arch}`, 'node.exe');\n}\n\nexport interface ProvisionNodeWindowsOptions {\n  /** Pinned Node version (pins.node). */\n  version: string;\n  /** Install root, e.g. %LOCALAPPDATA%\\kindling\\node. */\n  baseDir: string;\n  arch?: NodeArch;\n  emitter: EngineEmitter;\n  /** From 2.1 detection: a Node ≥ floor is already present → skip the download. */\n  alreadyOk?: boolean;\n  /** Injectable so tests run without network/Windows. Defaults below are spike-validation-pending. */\n  download?: (url: string, dest: string) => Promise<void>;\n  extract?: (zip: string, destDir: string) => Promise<void>;\n  exec?: (cmd: string, args: string[]) => Promise<ExecResult>;\n  now?: () => string;\n}\n\n// Default download: global fetch → file. UNVALIDATED on real Windows (spike / rehearsal).\nasync function defaultDownload(url: string, dest: string): Promise<void> {\n  const res = await fetch(url);\n  if (!res.ok) throw new Error(`download failed: ${res.status} ${url}`);\n  const buf = Buffer.from(await res.arrayBuffer());\n  await writeFile(dest, buf);\n}\n\nexport interface ProvisionResult {\n  ok: boolean;\n  /**\n   * Absolute path to the provisioned node binary for the launch step (2.6) to invoke directly\n   * (the clean-runtime rule — never rely on a mutated PATH). `null` means an existing system\n   * Node was reused → the launch resolves `node` from PATH instead.\n   */\n  nodeExe: string | null;\n}\n\nexport async function provisionNodeWindows(opts: ProvisionNodeWindowsOptions): Promise<ProvisionResult> {\n  const arch = opts.arch ?? 'x64';\n  const exec = opts.exec ?? defaultExec;\n  const download = opts.download ?? defaultDownload;\n  // Default extract via Windows 10+ bsdtar (handles .zip); UNVALIDATED here.\n  const extract =\n    opts.extract ??\n    (async (zip: string, destDir: string): Promise<void> => {\n      const r = await exec('tar', ['-xf', zip, '-C', destDir]);\n      if (r.code !== 0) throw new Error(`extract failed (code ${r.code}): ${r.stderr.trim()}`);\n    });\n  const now = opts.now ?? (() => new Date().toISOString());\n\n  const emit = (\n    status: Status,\n    humanMessage: string,\n    level: Level = 'info',\n    errorCode?: ErrorCode,\n  ): void => {\n    opts.emitter.emit({\n      id: randomUUID(),\n      phase: Phase.Provision,\n      step: StepId.ProvisionNode,\n      status,\n      humanMessage,\n      level,\n      timestamp: now(),\n      errorCode,\n    });\n  };\n\n  if (opts.alreadyOk) {\n    emit(Status.Skipped, provisionMessages.nodePresent);\n    return { ok: true, nodeExe: null };\n  }\n\n  emit(Status.Working, stepMessages[StepId.ProvisionNode]);\n  try {\n    await mkdir(opts.baseDir, { recursive: true }); // download dest + extract dir must exist\n    const url = nodeDistUrl(opts.version, arch);\n    const zip = join(opts.baseDir, `node-${opts.version}-win-${arch}.zip`);\n    await download(url, zip);\n    await extract(zip, opts.baseDir);\n  } catch (err) {\n    emit(Status.Failed, 'Setting up Node ran into a problem downloading or unpacking it. Check your connection, then press Retry.', 'error', ErrorCode.NetworkLost);\n    throw err;\n  }\n\n  const nodeExe = nodeExePath(opts.baseDir, opts.version, arch);\n  emit(Status.Done, provisionMessages.nodePresent);\n  return { ok: true, nodeExe };\n}\n","import { randomUUID } from 'node:crypto';\nimport { exec as defaultExec, type ExecResult } from '../exec';\nimport type { EngineEmitter } from '../emitter';\nimport { Phase, StepId, Status, ErrorCode, type Level } from '../contract';\nimport { stepMessages, provisionMessages } from '../messages';\nimport type { ProvisionResult } from './node-windows';\n\n// nvm release the bootstrap pins to (AC: nvm-sh v0.40.x). Embedded so the install is reproducible.\nexport const NVM_VERSION = 'v0.40.3';\n\n/** Absolute path to the nvm-installed node binary for a version. Pure. */\nexport function nvmNodePath(nvmDir: string, version: string): string {\n  const v = version.startsWith('v') ? version : `v${version}`;\n  return `${nvmDir}/versions/node/${v}/bin/node`;\n}\n\nexport interface ProvisionNodeUnixOptions {\n  /** Pinned Node version (pins.node). */\n  version: string;\n  /** nvm install dir (default ~/.nvm). */\n  nvmDir: string;\n  emitter: EngineEmitter;\n  /** From 2.1 detection: a system Node ≥ floor is already present. Honored only OFF macOS — on\n   *  macOS we always install the exact pin via nvm so the workshop is reproducible (AC2 reuse is\n   *  Linux-only; AC3 resolved-version-equals-pins.node). */\n  alreadyOk?: boolean;\n  /** Host platform — gates the reuse rule above. */\n  platform?: NodeJS.Platform;\n  /** Injectable side effects so tests run without network/a real shell. Defaults below are\n   *  shell-based and UNVALIDATED until the dress rehearsal (macOS + Linux). */\n  installNvm?: (nvmDir: string) => Promise<void>;\n  nvmInstallNode?: (nvmDir: string, version: string) => Promise<void>;\n  /** Idempotent re-run check (2.7): is the PINNED node already installed AND runnable? Default\n   *  runs the resolved binary with --version. Verifying it RUNS (not just that a dir exists)\n   *  means a partial/dirty prior install is repaired (re-installed), not skipped-into-broken. */\n  nodeInstalled?: (nvmDir: string, version: string) => Promise<boolean>;\n  exec?: (cmd: string, args: string[]) => Promise<ExecResult>;\n  now?: () => string;\n}\n\n// nvm is a shell function, not an executable — so every default runs `bash -c` (a single binary\n// + args, safe under exec's shell:false). Caller values are passed as POSITIONAL args ($1/$2),\n// never interpolated into the script, so a path/version can't break out of the shell context.\n// (NVM_VERSION is our own frozen constant, so it stays inline in the URL.)\nfunction makeDefaults(exec: (cmd: string, args: string[]) => Promise<ExecResult>) {\n  const run = async (script: string, args: string[], what: string): Promise<void> => {\n    // `kindling` becomes $0; the rest are $1, $2, …\n    const r = await exec('bash', ['-c', script, 'kindling', ...args]);\n    if (r.code !== 0) throw new Error(`${what} failed (code ${r.code}): ${r.stderr.trim()}`);\n  };\n  return {\n    // Install nvm only if it's not already present at $1 (idempotent).\n    installNvm: (nvmDir: string): Promise<void> =>\n      run(\n        `export NVM_DIR=\"$1\"; [ -s \"$NVM_DIR/nvm.sh\" ] || ` +\n          `curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh | bash`,\n        [nvmDir],\n        'nvm install',\n      ),\n    // Source nvm in the same shell, then install the pinned version. We do NOT touch `nvm alias\n    // default` — clobbering the user's global default would break their other projects (FR4); the\n    // launch step uses the absolute nodeExe path instead.\n    nvmInstallNode: (nvmDir: string, version: string): Promise<void> =>\n      run(\n        `export NVM_DIR=\"$1\"; . \"$NVM_DIR/nvm.sh\"; nvm install \"$2\"`,\n        [nvmDir, version],\n        'nvm install node',\n      ),\n  };\n}\n\n/**\n * Provision the pinned Node on macOS/Linux via nvm, returning the ABSOLUTE node path so the\n * launch step (2.6) never depends on a mutated PATH (the clean-runtime rule). A system Node ≥\n * floor is reused (Skipped, AC2). Emits provision.node events; Failed + rethrow on error.\n *\n * The real nvm install + same-shell source is validated at the dress rehearsal; here the shell\n * effects are injectable and the orchestration/events/skip/fail paths are unit-tested.\n */\nexport async function provisionNodeUnix(opts: ProvisionNodeUnixOptions): Promise<ProvisionResult> {\n  const exec = opts.exec ?? defaultExec;\n  const defaults = makeDefaults(exec);\n  const installNvm = opts.installNvm ?? defaults.installNvm;\n  const nvmInstallNode = opts.nvmInstallNode ?? defaults.nvmInstallNode;\n  const nodeInstalled =\n    opts.nodeInstalled ??\n    (async (nvmDir: string, version: string): Promise<boolean> => {\n      const want = version.startsWith('v') ? version : `v${version}`;\n      try {\n        const r = await exec(nvmNodePath(nvmDir, version), ['--version']);\n        // Require it to RUN and report the EXACT pinned version — a missing/broken/wrong-version\n        // binary at that path → not installed → (re)install repairs it.\n        return r.code === 0 && r.stdout.trim() === want;\n      } catch {\n        return false;\n      }\n    });\n  const now = opts.now ?? (() => new Date().toISOString());\n\n  const emit = (\n    status: Status,\n    humanMessage: string,\n    level: Level = 'info',\n    errorCode?: ErrorCode,\n  ): void => {\n    opts.emitter.emit({\n      id: randomUUID(),\n      phase: Phase.Provision,\n      step: StepId.ProvisionNode,\n      status,\n      humanMessage,\n      level,\n      timestamp: now(),\n      errorCode,\n    });\n  };\n\n  // Reuse a system Node only OFF macOS (AC2 Linux-only); on macOS always install the exact pin.\n  if (opts.alreadyOk && opts.platform !== 'darwin') {\n    emit(Status.Skipped, provisionMessages.nodePresent);\n    return { ok: true, nodeExe: null }; // null → the launch uses the system `node` on PATH\n  }\n\n  // Idempotent re-run (2.7): the pinned nvm node is already installed AND runs → skip, don't\n  // reinstall. (A partial/broken install fails this check → falls through to a repairing install.)\n  if (await nodeInstalled(opts.nvmDir, opts.version)) {\n    emit(Status.Skipped, provisionMessages.nodePresent);\n    return { ok: true, nodeExe: nvmNodePath(opts.nvmDir, opts.version) };\n  }\n\n  emit(Status.Working, stepMessages[StepId.ProvisionNode]);\n  try {\n    await installNvm(opts.nvmDir);\n    await nvmInstallNode(opts.nvmDir, opts.version);\n  } catch (err) {\n    emit(\n      Status.Failed,\n      'Setting up Node ran into a problem downloading or installing it. Check your connection, then press Retry.',\n      'error',\n      ErrorCode.NetworkLost,\n    );\n    throw err;\n  }\n\n  const nodeExe = nvmNodePath(opts.nvmDir, opts.version);\n  emit(Status.Done, provisionMessages.nodePresent);\n  return { ok: true, nodeExe };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,SAAS,YAAY;AAgBvB,SAAS,WAAW,SAAyB;AAClD,SAAO,KAAK,QAAQ,OAAO,GAAG,gBAAgB,OAAO,OAAO,YAAY;AAC1E;AAWO,SAAS,qBAAqB,EAAE,SAAS,gBAAgB,GAAiC;AAC/F,QAAM,OAAO,sBAAsB,eAAe;AAClD,MAAI,YAAY,MAAM;AACpB,WAAO,EAAE,KAAK,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE;AAAA,EAC1C;AACA,SAAO,EAAE,KAAK,SAAS,MAAM,CAAC,WAAW,OAAO,GAAG,MAAM,IAAI,EAAE;AACjE;;;ACnCA,SAAS,QAAAA,aAAY;AACrB,SAAS,OAAO,iBAAiB;AACjC,SAAS,kBAAkB;AASpB,SAAS,YAAY,SAAiB,OAAiB,OAAe;AAC3E,QAAM,IAAI,QAAQ,WAAW,GAAG,IAAI,UAAU,IAAI,OAAO;AACzD,SAAO,2BAA2B,CAAC,SAAS,CAAC,QAAQ,IAAI;AAC3D;AAGO,SAAS,YAAY,SAAiB,SAAiB,OAAiB,OAAe;AAC5F,QAAM,IAAI,QAAQ,WAAW,GAAG,IAAI,UAAU,IAAI,OAAO;AACzD,SAAOC,MAAK,SAAS,QAAQ,CAAC,QAAQ,IAAI,IAAI,UAAU;AAC1D;AAmBA,eAAe,gBAAgB,KAAa,MAA6B;AACvE,QAAM,MAAM,MAAM,MAAM,GAAG;AAC3B,MAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,oBAAoB,IAAI,MAAM,IAAI,GAAG,EAAE;AACpE,QAAM,MAAM,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC;AAC/C,QAAM,UAAU,MAAM,GAAG;AAC3B;AAYA,eAAsB,qBAAqB,MAA6D;AACtG,QAAM,OAAO,KAAK,QAAQ;AAC1B,QAAMC,QAAO,KAAK,QAAQ;AAC1B,QAAM,WAAW,KAAK,YAAY;AAElC,QAAM,UACJ,KAAK,YACJ,OAAO,KAAa,YAAmC;AACtD,UAAM,IAAI,MAAMA,MAAK,OAAO,CAAC,OAAO,KAAK,MAAM,OAAO,CAAC;AACvD,QAAI,EAAE,SAAS,EAAG,OAAM,IAAI,MAAM,wBAAwB,EAAE,IAAI,MAAM,EAAE,OAAO,KAAK,CAAC,EAAE;AAAA,EACzF;AACF,QAAM,MAAM,KAAK,QAAQ,OAAM,oBAAI,KAAK,GAAE,YAAY;AAEtD,QAAM,OAAO,CACX,QACA,cACA,QAAe,QACf,cACS;AACT,SAAK,QAAQ,KAAK;AAAA,MAChB,IAAI,WAAW;AAAA,MACf,OAAO,MAAM;AAAA,MACb,MAAM,OAAO;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW,IAAI;AAAA,MACf;AAAA,IACF,CAAC;AAAA,EACH;AAEA,MAAI,KAAK,WAAW;AAClB,SAAK,OAAO,SAAS,kBAAkB,WAAW;AAClD,WAAO,EAAE,IAAI,MAAM,SAAS,KAAK;AAAA,EACnC;AAEA,OAAK,OAAO,SAAS,aAAa,OAAO,aAAa,CAAC;AACvD,MAAI;AACF,UAAM,MAAM,KAAK,SAAS,EAAE,WAAW,KAAK,CAAC;AAC7C,UAAM,MAAM,YAAY,KAAK,SAAS,IAAI;AAC1C,UAAM,MAAMD,MAAK,KAAK,SAAS,QAAQ,KAAK,OAAO,QAAQ,IAAI,MAAM;AACrE,UAAM,SAAS,KAAK,GAAG;AACvB,UAAM,QAAQ,KAAK,KAAK,OAAO;AAAA,EACjC,SAAS,KAAK;AACZ,SAAK,OAAO,QAAQ,4GAA4G,SAAS,UAAU,WAAW;AAC9J,UAAM;AAAA,EACR;AAEA,QAAM,UAAU,YAAY,KAAK,SAAS,KAAK,SAAS,IAAI;AAC5D,OAAK,OAAO,MAAM,kBAAkB,WAAW;AAC/C,SAAO,EAAE,IAAI,MAAM,QAAQ;AAC7B;;;AC3GA,SAAS,cAAAE,mBAAkB;AAQpB,IAAM,cAAc;AAGpB,SAAS,YAAY,QAAgB,SAAyB;AACnE,QAAM,IAAI,QAAQ,WAAW,GAAG,IAAI,UAAU,IAAI,OAAO;AACzD,SAAO,GAAG,MAAM,kBAAkB,CAAC;AACrC;AA8BA,SAAS,aAAaC,OAA4D;AAChF,QAAM,MAAM,OAAO,QAAgB,MAAgB,SAAgC;AAEjF,UAAM,IAAI,MAAMA,MAAK,QAAQ,CAAC,MAAM,QAAQ,YAAY,GAAG,IAAI,CAAC;AAChE,QAAI,EAAE,SAAS,EAAG,OAAM,IAAI,MAAM,GAAG,IAAI,iBAAiB,EAAE,IAAI,MAAM,EAAE,OAAO,KAAK,CAAC,EAAE;AAAA,EACzF;AACA,SAAO;AAAA;AAAA,IAEL,YAAY,CAAC,WACX;AAAA,MACE,4GAC6D,WAAW;AAAA,MACxE,CAAC,MAAM;AAAA,MACP;AAAA,IACF;AAAA;AAAA;AAAA;AAAA,IAIF,gBAAgB,CAAC,QAAgB,YAC/B;AAAA,MACE;AAAA,MACA,CAAC,QAAQ,OAAO;AAAA,MAChB;AAAA,IACF;AAAA,EACJ;AACF;AAUA,eAAsB,kBAAkB,MAA0D;AAChG,QAAMA,QAAO,KAAK,QAAQ;AAC1B,QAAM,WAAW,aAAaA,KAAI;AAClC,QAAM,aAAa,KAAK,cAAc,SAAS;AAC/C,QAAM,iBAAiB,KAAK,kBAAkB,SAAS;AACvD,QAAM,gBACJ,KAAK,kBACJ,OAAO,QAAgB,YAAsC;AAC5D,UAAM,OAAO,QAAQ,WAAW,GAAG,IAAI,UAAU,IAAI,OAAO;AAC5D,QAAI;AACF,YAAM,IAAI,MAAMA,MAAK,YAAY,QAAQ,OAAO,GAAG,CAAC,WAAW,CAAC;AAGhE,aAAO,EAAE,SAAS,KAAK,EAAE,OAAO,KAAK,MAAM;AAAA,IAC7C,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF,QAAM,MAAM,KAAK,QAAQ,OAAM,oBAAI,KAAK,GAAE,YAAY;AAEtD,QAAM,OAAO,CACX,QACA,cACA,QAAe,QACf,cACS;AACT,SAAK,QAAQ,KAAK;AAAA,MAChB,IAAIC,YAAW;AAAA,MACf,OAAO,MAAM;AAAA,MACb,MAAM,OAAO;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW,IAAI;AAAA,MACf;AAAA,IACF,CAAC;AAAA,EACH;AAGA,MAAI,KAAK,aAAa,KAAK,aAAa,UAAU;AAChD,SAAK,OAAO,SAAS,kBAAkB,WAAW;AAClD,WAAO,EAAE,IAAI,MAAM,SAAS,KAAK;AAAA,EACnC;AAIA,MAAI,MAAM,cAAc,KAAK,QAAQ,KAAK,OAAO,GAAG;AAClD,SAAK,OAAO,SAAS,kBAAkB,WAAW;AAClD,WAAO,EAAE,IAAI,MAAM,SAAS,YAAY,KAAK,QAAQ,KAAK,OAAO,EAAE;AAAA,EACrE;AAEA,OAAK,OAAO,SAAS,aAAa,OAAO,aAAa,CAAC;AACvD,MAAI;AACF,UAAM,WAAW,KAAK,MAAM;AAC5B,UAAM,eAAe,KAAK,QAAQ,KAAK,OAAO;AAAA,EAChD,SAAS,KAAK;AACZ;AAAA,MACE,OAAO;AAAA,MACP;AAAA,MACA;AAAA,MACA,UAAU;AAAA,IACZ;AACA,UAAM;AAAA,EACR;AAEA,QAAM,UAAU,YAAY,KAAK,QAAQ,KAAK,OAAO;AACrD,OAAK,OAAO,MAAM,kBAAkB,WAAW;AAC/C,SAAO,EAAE,IAAI,MAAM,QAAQ;AAC7B;","names":["join","join","exec","randomUUID","exec","randomUUID"]}

package/dist/exec-JnCZZPZU.d.ts

@@ -0,0 +1,8 @@
+interface ExecResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+declare function exec(cmd: string, args?: string[]): Promise<ExecResult>;
+
+export { type ExecResult as E, exec as e };

package/dist/server/index.d.ts

@@ -0,0 +1,39 @@
+import { Server } from 'node:http';
+import { C as Config, e as StepId, I as InspectResult, a as EngineEmitter } from '../emitter-oidLJDmn.js';
+import { E as ExecResult } from '../exec-JnCZZPZU.js';
+
+interface ServerCommands {
+    start(config: Config): unknown | Promise<unknown>;
+    cancel(): void;
+    retry(step: StepId): unknown | Promise<unknown>;
+    /**
+     * Read-only filesystem probe for the Configure-time "existing project?" detection (Story 7.2 /
+     * `POST /inspect`). OPTIONAL so existing `ServerCommands` fakes (e.g. server.test.ts) don't break;
+     * when absent the handler returns the neutral `{ isKindlingProject: false, installedBmadVersion: null }`.
+     */
+    inspect?(projectDir: string): Promise<InspectResult>;
+}
+interface StartServerOptions {
+    emitter: EngineEmitter;
+    commands: ServerCommands;
+    /** Built UI directory (dist/ui) to serve statically; omit to skip static serving. */
+    uiDir?: string;
+    /** Called when the Welcome screen render-acks (POST /ack). The host uses this to write the
+     *  static welcome.html and exit the ephemeral server — only fired on success (3.7 lifecycle). */
+    onWelcomeAck?: () => void;
+}
+interface RunningServer {
+    server: Server;
+    url: string;
+    port: number;
+    close(): Promise<void>;
+}
+declare function startServer(opts: StartServerOptions): Promise<RunningServer>;
+
+interface OpenBrowserOptions {
+    exec?: (cmd: string, args: string[]) => Promise<ExecResult>;
+    platform?: NodeJS.Platform;
+}
+declare function openBrowser(url: string, opts?: OpenBrowserOptions): Promise<boolean>;
+
+export { type OpenBrowserOptions, type RunningServer, type ServerCommands, type StartServerOptions, openBrowser, startServer };

package/dist/server/index.js

@@ -0,0 +1,10 @@
+import {
+  openBrowser,
+  startServer
+} from "../chunk-IS6LC3HK.js";
+import "../chunk-OU3WSB6B.js";
+export {
+  openBrowser,
+  startServer
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/ui/assets/index-Bw_xLj6a.css

@@ -0,0 +1 @@
+:root{--color-stage-deep:#16100c;--color-stage:#1b1410;--color-surface:#221913;--color-surface-tint:#2c1c12;--color-surface-raised:#2c211a;--color-surface-raised-hi:#34271e;--color-surface-overlay:#463429;--color-text-primary:#fff6ee;--color-text-secondary:#d6b9a3;--color-text-muted:#9a8170;--color-accent:#ff6a1f;--color-accent-gold:#ffc24a;--color-accent-pink:#ff3d6e;--color-on-flame:#1b1410;--color-success:#4fd784;--color-border:#463429;--color-border-warm:#5a3c20;--color-focus-ring:#ffc24a;--gradient-flame:linear-gradient(92deg, #ffc24a 0%, #ff6a1f 45%, #ff3d6e 100%);--gradient-flame-2:linear-gradient(90deg, #ffc24a, #ff6a1f);--gradient-stage:linear-gradient(135deg, #2c1c12 0%, #221913 60%);--radius-sm:6px;--radius-md:8px;--radius-lg:10px;--radius-xl:12px;--radius-2xl:14px;--radius-full:999px;--space-1:4px;--space-2:8px;--space-3:12px;--space-4:16px;--space-5:24px;--space-6:32px;--space-7:44px;--space-8:56px;--font-family:-apple-system, "Segoe UI Variable", "Segoe UI", Roboto, Helvetica, Arial, sans-serif}*{box-sizing:border-box}@media (prefers-reduced-motion:reduce){html{scroll-behavior:auto!important}*,:before,:after{transition-duration:.001ms!important;animation-duration:.001ms!important;animation-iteration-count:1!important;animation-play-state:paused!important}}html,body{height:100%;margin:0}body{font-family:var(--font-family);color:var(--color-text-primary);background:var(--color-stage);font-size:16px;font-weight:500}.app-shell{background:var(--color-stage);justify-content:center;align-items:flex-start;min-height:100vh;display:flex}.app-window{width:100%;max-width:1000px;margin:var(--space-6) var(--space-4);border-radius:var(--radius-2xl);border:1px solid var(--color-border);background:var(--color-surface);overflow:hidden;box-shadow:0 24px 60px #00000080}.app-titlebar{align-items:center;gap:var(--space-3);padding:var(--space-3) var(--space-4);background:var(--color-stage-deep);border-bottom:1px solid var(--color-border);display:flex}.app-traffic{gap:var(--space-2);display:flex}.app-traffic span{border-radius:var(--radius-full);background:var(--color-surface-overlay);width:12px;height:12px}.app-urlbar{padding:var(--space-2) var(--space-3);border-radius:var(--radius-md);background:var(--color-surface-raised-hi);color:var(--color-text-secondary);flex:1;font-size:13px}.app-stage{padding:var(--space-8) var(--space-7);background:var(--gradient-stage);min-height:420px}.btn{font-family:var(--font-family);cursor:pointer;padding:var(--space-3) var(--space-5);border-radius:var(--radius-xl);border:0;font-size:16px;font-weight:800;transition:filter .12s}.btn:hover{filter:brightness(1.08)}.btn:focus-visible{outline:3px solid var(--color-focus-ring);outline-offset:3px}.btn--primary{background:var(--gradient-flame-2);color:var(--color-on-flame);box-shadow:0 10px 30px #ff6a1f73}.btn--secondary{color:var(--color-text-primary);border:2px solid var(--color-accent);background:0 0}.btn--ghost{background:var(--color-surface-raised-hi);color:var(--color-text-primary);border:1px solid var(--color-border-warm);border-radius:var(--radius-lg)}.field{gap:var(--space-2);flex-direction:column;display:flex}.field-label{color:var(--color-text-secondary);font-size:13px;font-weight:800}.field-input{font-family:var(--font-family);padding:var(--space-3) var(--space-4);border-radius:var(--radius-lg);background:var(--color-stage);color:var(--color-text-primary);border:1px solid var(--color-border);font-size:16px}.field-input::placeholder{color:var(--color-text-muted)}.field-input:focus-visible{outline:3px solid var(--color-focus-ring);outline-offset:2px}.screen{gap:var(--space-4);flex-direction:column;display:flex}.eyebrow{letter-spacing:.16em;text-transform:uppercase;color:var(--color-accent-gold);margin:0;font-size:12px;font-weight:800}.screen h1{letter-spacing:-.02em;color:var(--color-text-primary);margin:0;font-size:34px;font-weight:900}.lede{color:var(--color-text-secondary);margin:0;font-size:20px}.lede b{color:var(--color-text-primary)}.field legend.field-label,.field-label{padding:0}.field-note{color:var(--color-text-secondary);margin:0;font-size:13px}fieldset.field{border:0;margin:0;padding:0}.picker,.modules{margin:var(--space-2) 0 0;gap:var(--space-2);flex-direction:column;padding:0;list-style:none;display:flex}.picker-row,.mod-row{align-items:center;gap:var(--space-3);padding:var(--space-3) var(--space-4);border-radius:var(--radius-lg);background:var(--color-surface-raised);border:1px solid var(--color-border);cursor:pointer;display:flex}.picker-name,.mod-name{color:var(--color-text-primary);font-weight:700}.mod-desc{color:var(--color-text-secondary);font-size:13px}.picker-tag{letter-spacing:.08em;text-transform:uppercase;color:var(--color-accent-gold);font-size:11px;font-weight:800}.picker-check{color:var(--color-success);margin-left:auto;font-weight:800}.disclosure{gap:var(--space-3);flex-direction:column;display:flex}.disclosure-panel{gap:var(--space-4);padding:var(--space-4);border-radius:var(--radius-2xl);background:var(--color-surface-raised);border:1px solid var(--color-border);flex-direction:column;display:flex}.screen-actions{align-items:center;gap:var(--space-4);margin-top:var(--space-4);flex-wrap:wrap;display:flex}.start-note{color:var(--color-text-secondary);font-size:15px}.versions{border-collapse:collapse;width:100%;margin:var(--space-4) 0;text-align:left}.versions caption{text-align:left;color:var(--color-text-secondary);margin-bottom:var(--space-2);font-weight:700}.versions th,.versions td{padding:var(--space-2) var(--space-3);border-bottom:1px solid var(--color-border)}.versions th{color:var(--color-text-secondary);font-weight:700}.versions td{color:var(--color-text-primary);font-variant-numeric:tabular-nums}.field-row{align-items:center;gap:var(--space-3);margin-top:var(--space-2);display:flex}.field-value{color:var(--color-text-primary);font-weight:700}.default-pill{letter-spacing:.06em;text-transform:uppercase;color:var(--color-success);padding:var(--space-1) var(--space-3);border-radius:var(--radius-full);background:var(--color-surface-raised-hi);border:1px solid var(--color-border-warm);font-size:11px;font-weight:800}.optin-form{gap:var(--space-3);margin-top:var(--space-3);flex-direction:column;align-items:flex-start;display:flex}.start-error{padding:var(--space-3) var(--space-4);border-radius:var(--radius-lg);background:var(--color-surface-raised);border:1px solid var(--color-border-warm);color:var(--color-text-primary);margin:0}.progressbar{border-radius:var(--radius-lg);background:var(--color-surface-raised);border:1px solid var(--color-border);height:12px;overflow:hidden}.progressbar-fill{background:var(--gradient-flame);height:100%;transition:width .32s}.progressbar--activity .progressbar-fill{animation:1.4s ease-in-out infinite kindling-pulse}@keyframes kindling-pulse{0%,to{opacity:.55}50%{opacity:1}}.sr-live{clip:rect(0 0 0 0);white-space:nowrap;border:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.steps{margin:var(--space-4) 0 0;gap:var(--space-2);flex-direction:column;padding:0;list-style:none;display:flex}.step-row{align-items:center;gap:var(--space-3);padding:var(--space-3) var(--space-4);border-radius:var(--radius-2xl);background:var(--color-surface-raised);border:1px solid var(--color-border);display:flex}.step-icon{text-align:center;width:1.4em;font-size:18px}.step-word{letter-spacing:.04em;text-transform:uppercase;min-width:7.5em;font-size:12px;font-weight:900}.step-message{color:var(--color-text-secondary);flex:1}.step-row[data-tone=wait] .step-word{color:var(--color-text-secondary)}.step-row[data-tone=busy] .step-word{color:var(--color-accent-gold)}.step-row[data-tone=success] .step-word{color:var(--color-success)}.step-row[data-tone=error] .step-word{color:var(--color-text-primary)}.step-row[data-tone=busy] .step-icon{color:var(--color-accent)}.step-row[data-tone=error] .step-icon{color:var(--color-accent-pink)}.step-activity{color:var(--color-accent-gold);animation:1.2s ease-in-out infinite kindling-pulse}.steps--compact .step-row{padding:var(--space-2) var(--space-3);background:var(--color-surface-raised-hi)}.fix-command{align-items:center;gap:var(--space-3);padding:var(--space-3) var(--space-4);border-radius:var(--radius-lg);background:var(--color-stage);border:1px solid var(--color-border-warm);flex-wrap:wrap;display:flex}.fix-command-code{color:var(--color-accent-gold);word-break:break-all;flex:1;font-family:ui-monospace,SF Mono,Menlo,Consolas,monospace;font-size:14px}