@ebay-dt/bonfire-cli 0.1.0-alpha.3 → 0.1.0-alpha.4

package/README.md

@@ -33,6 +33,22 @@ The command never invokes GitHub CLI, loads application configuration, or
 prints the secret. It exits with `0` on success, `1` on validation or
 filesystem failure, and `2` for invalid command syntax.
 
+## Context repository operations
+
+Use the context commands explicitly from an instance repository:
+
+```sh
+bonfire context sync [--check] [--root <root>]
+bonfire context install [--check] --app-id <app-id> [--root <root>]
+```
+
+`sync` writes deterministic repository projections and `sync --check` performs
+the same validation without writing. Both default `--root` to the current
+working directory and print only generated paths and status. `install` installs
+canonical skills and merges MCP definitions into the user's Cursor MCP
+configuration while preserving unrelated entries. `install --check` validates
+machine state without changing it.
+
 ## Branch preparation
 
 Before starting Next.js in development, run:

package/dist/command.d.ts

@@ -1,3 +1,4 @@
+import { type ContextInstallCheckResult, type ContextInstallResult, type ContextInstallOptions } from "@ebay-dt/bonfire-context";
 import { type BranchPrepareDependencies } from "./branch-prepare.js";
 export declare class CliSyntaxError extends Error {
     constructor(message: string);
@@ -9,8 +10,22 @@ export type BranchPrepareCommandOptions = {
     root: string;
     hostname: string;
 };
-type CliCommandOptions = PrepareCommandOptions | BranchPrepareCommandOptions;
+export type ContextCommandOptions = {
+    context: "sync";
+    root: string;
+    check: boolean;
+} | {
+    context: "install";
+    root: string;
+    appId: string;
+    check: boolean;
+};
+type CliCommandOptions = PrepareCommandOptions | BranchPrepareCommandOptions | ContextCommandOptions;
+export type CliDependencies = BranchPrepareDependencies & {
+    contextInstall?: (options: ContextInstallOptions) => Promise<ContextInstallResult>;
+    contextInstallCheck?: (options: ContextInstallOptions) => Promise<ContextInstallCheckResult>;
+};
 export declare function parseArgs(argv: readonly string[]): CliCommandOptions;
-export declare function run(argv?: readonly string[], dependencies?: BranchPrepareDependencies): Promise<number>;
+export declare function run(argv?: readonly string[], dependencies?: CliDependencies): Promise<number>;
 export {};
 //# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,iBAAiB,GAAG,qBAAqB,GAAG,2BAA2B,CAAC;AA6E7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAQpE;AAED,wBAAsB,GAAG,CACvB,IAAI,GAAE,SAAS,MAAM,EAA0B,EAC/C,YAAY,GAAE,yBAA8B,GAC3C,OAAO,CAAC,MAAM,CAAC,CAuCjB","sourcesContent":["import { prepare, PrepareError } from \"./prepare.js\";\nimport {\n  BranchPrepareError,\n  runBranchPrepare,\n  type BranchPrepareDependencies,\n} from \"./branch-prepare.js\";\n\nexport class CliSyntaxError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CliSyntaxError\";\n  }\n}\n\nexport type PrepareCommandOptions = {\n  root: string;\n};\n\nexport type BranchPrepareCommandOptions = {\n  root: string;\n  hostname: string;\n};\n\ntype CliCommandOptions = PrepareCommandOptions | BranchPrepareCommandOptions;\n\nfunction parseRootOption(\n  argv: readonly string[],\n  start: number,\n): { root: string; nextIndex: number } {\n  const value = argv[start + 1];\n  if (!value || value.startsWith(\"--\")) {\n    throw new CliSyntaxError(\"The --root option requires a value\");\n  }\n  return { root: value, nextIndex: start + 2 };\n}\n\nfunction parsePrepareArgs(argv: readonly string[]): PrepareCommandOptions {\n  let root = process.cwd();\n  let rootProvided = false;\n  for (let index = 1; index < argv.length;) {\n    if (argv[index] !== \"--root\") {\n      throw new CliSyntaxError(`Unknown option: ${argv[index]}`);\n    }\n    if (rootProvided) {\n      throw new CliSyntaxError(\"The --root option may only be provided once\");\n    }\n    const parsed = parseRootOption(argv, index);\n    root = parsed.root;\n    rootProvided = true;\n    index = parsed.nextIndex;\n  }\n  return { root };\n}\n\nfunction parseBranchPrepareArgs(\n  argv: readonly string[],\n): BranchPrepareCommandOptions {\n  let root = process.cwd();\n  let hostname: string | undefined;\n  let rootProvided = false;\n  let hostnameProvided = false;\n\n  for (let index = 2; index < argv.length;) {\n    const option = argv[index];\n    if (option === \"--root\") {\n      if (rootProvided) {\n        throw new CliSyntaxError(\"The --root option may only be provided once\");\n      }\n      const parsed = parseRootOption(argv, index);\n      root = parsed.root;\n      rootProvided = true;\n      index = parsed.nextIndex;\n      continue;\n    }\n    if (option === \"--hostname\") {\n      if (hostnameProvided) {\n        throw new CliSyntaxError(\n          \"The --hostname option may only be provided once\",\n        );\n      }\n      const value = argv[index + 1];\n      if (!value || value.startsWith(\"--\")) {\n        throw new CliSyntaxError(\"The --hostname option requires a value\");\n      }\n      hostname = value;\n      hostnameProvided = true;\n      index += 2;\n      continue;\n    }\n    throw new CliSyntaxError(`Unknown option: ${option}`);\n  }\n\n  if (hostname === undefined) {\n    throw new CliSyntaxError(\n      \"Usage: bonfire branch prepare --root <application-root> --hostname <hostname>\",\n    );\n  }\n  return { root, hostname };\n}\n\nexport function parseArgs(argv: readonly string[]): CliCommandOptions {\n  if (argv[0] === \"prepare\") return parsePrepareArgs(argv);\n  if (argv[0] === \"branch\" && argv[1] === \"prepare\") {\n    return parseBranchPrepareArgs(argv);\n  }\n  throw new CliSyntaxError(\n    \"Usage: bonfire prepare [--root <application-root>] | bonfire branch prepare --root <application-root> --hostname <hostname>\",\n  );\n}\n\nexport async function run(\n  argv: readonly string[] = process.argv.slice(2),\n  dependencies: BranchPrepareDependencies = {},\n): Promise<number> {\n  const isBranchPrepare = argv[0] === \"branch\";\n  try {\n    const options = parseArgs(argv);\n    if (\"hostname\" in options) {\n      return await runBranchPrepare(options, dependencies);\n    }\n\n    const result = await prepare(options);\n    const descriptions = {\n      environment: \"the process environment\",\n      existing: \".env.local\",\n      generated: \"a newly generated value in .env.local\",\n    } as const;\n    console.log(\n      `Bonfire preparation complete; BF_SESSION_SECRET came from ${descriptions[result.source]}.`,\n    );\n    return 0;\n  } catch (error) {\n    if (error instanceof CliSyntaxError) {\n      console.error(`bonfire: ${error.message}`);\n      return 2;\n    }\n    if (isBranchPrepare) {\n      const message =\n        error instanceof BranchPrepareError\n          ? error.message\n          : \"Unable to load branch preparation configuration.\";\n      console.error(`bonfire branch prepare failed: ${message}`);\n      return 1;\n    }\n\n    const message =\n      error instanceof PrepareError || error instanceof Error\n        ? error.message\n        : \"an unknown error occurred\";\n    console.error(`bonfire prepare failed: ${message}`);\n    return 1;\n  }\n}\n"]}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAE3B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEN,KAAK,iBAAiB,GACpB,qBAAqB,GAAG,2BAA2B,GAAG,qBAAqB,CAAC;AAE9E,MAAM,MAAM,eAAe,GAAG,yBAAyB,GAAG;IACxD,cAAc,CAAC,EAAE,CACf,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,mBAAmB,CAAC,EAAE,CACpB,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACzC,CAAC;AAmJF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CASpE;AA+ED,wBAAsB,GAAG,CACvB,IAAI,GAAE,SAAS,MAAM,EAA0B,EAC/C,YAAY,GAAE,eAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CAiDjB","sourcesContent":["import {\n  checkContext,\n  checkContextInstallation,\n  installContext,\n  syncContext,\n  type ContextInstallCheckResult,\n  type ContextInstallResult,\n  type ContextInstallOptions,\n  type ContextSyncResult,\n} from \"@ebay-dt/bonfire-context\";\nimport { prepare, PrepareError } from \"./prepare.js\";\nimport {\n  BranchPrepareError,\n  runBranchPrepare,\n  type BranchPrepareDependencies,\n} from \"./branch-prepare.js\";\n\nexport class CliSyntaxError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CliSyntaxError\";\n  }\n}\n\nexport type PrepareCommandOptions = {\n  root: string;\n};\n\nexport type BranchPrepareCommandOptions = {\n  root: string;\n  hostname: string;\n};\n\nexport type ContextCommandOptions =\n  | {\n      context: \"sync\";\n      root: string;\n      check: boolean;\n    }\n  | {\n      context: \"install\";\n      root: string;\n      appId: string;\n      check: boolean;\n    };\n\ntype CliCommandOptions =\n  PrepareCommandOptions | BranchPrepareCommandOptions | ContextCommandOptions;\n\nexport type CliDependencies = BranchPrepareDependencies & {\n  contextInstall?: (\n    options: ContextInstallOptions,\n  ) => Promise<ContextInstallResult>;\n  contextInstallCheck?: (\n    options: ContextInstallOptions,\n  ) => Promise<ContextInstallCheckResult>;\n};\n\nfunction parseRootOption(\n  argv: readonly string[],\n  start: number,\n): { root: string; nextIndex: number } {\n  const value = argv[start + 1];\n  if (!value || value.startsWith(\"--\")) {\n    throw new CliSyntaxError(\"The --root option requires a value\");\n  }\n  return { root: value, nextIndex: start + 2 };\n}\n\nfunction parsePrepareArgs(argv: readonly string[]): PrepareCommandOptions {\n  let root = process.cwd();\n  let rootProvided = false;\n  for (let index = 1; index < argv.length;) {\n    if (argv[index] !== \"--root\") {\n      throw new CliSyntaxError(`Unknown option: ${argv[index]}`);\n    }\n    if (rootProvided) {\n      throw new CliSyntaxError(\"The --root option may only be provided once\");\n    }\n    const parsed = parseRootOption(argv, index);\n    root = parsed.root;\n    rootProvided = true;\n    index = parsed.nextIndex;\n  }\n  return { root };\n}\n\nfunction parseContextArgs(argv: readonly string[]): ContextCommandOptions {\n  const context = argv[1];\n  if (context !== \"sync\" && context !== \"install\") {\n    throw new CliSyntaxError(\n      \"Usage: bonfire context sync [--check] [--root <root>] | bonfire context install [--check] --app-id <app-id> [--root <root>]\",\n    );\n  }\n\n  let root = process.cwd();\n  let appId: string | undefined;\n  let check = false;\n  let rootProvided = false;\n  let appIdProvided = false;\n  let checkProvided = false;\n\n  for (let index = 2; index < argv.length;) {\n    const option = argv[index];\n    if (option === \"--check\") {\n      if (checkProvided) {\n        throw new CliSyntaxError(\n          \"The --check option may only be provided once\",\n        );\n      }\n      check = true;\n      checkProvided = true;\n      index += 1;\n      continue;\n    }\n    if (option === \"--root\") {\n      if (rootProvided) {\n        throw new CliSyntaxError(\"The --root option may only be provided once\");\n      }\n      const parsed = parseRootOption(argv, index);\n      root = parsed.root;\n      rootProvided = true;\n      index = parsed.nextIndex;\n      continue;\n    }\n    if (option === \"--app-id\") {\n      if (appIdProvided) {\n        throw new CliSyntaxError(\n          \"The --app-id option may only be provided once\",\n        );\n      }\n      const value = argv[index + 1];\n      if (!value || value.startsWith(\"--\")) {\n        throw new CliSyntaxError(\"The --app-id option requires a value\");\n      }\n      appId = value;\n      appIdProvided = true;\n      index += 2;\n      continue;\n    }\n    throw new CliSyntaxError(`Unknown option: ${option}`);\n  }\n\n  if (context === \"install\") {\n    if (appId === undefined) {\n      throw new CliSyntaxError(\n        \"Usage: bonfire context install [--check] --app-id <app-id> [--root <root>]\",\n      );\n    }\n    return { context, root, appId, check };\n  }\n  if (appId !== undefined) {\n    throw new CliSyntaxError(\"The --app-id option is only valid for install\");\n  }\n  return { context, root, check };\n}\n\nfunction parseBranchPrepareArgs(\n  argv: readonly string[],\n): BranchPrepareCommandOptions {\n  let root = process.cwd();\n  let hostname: string | undefined;\n  let rootProvided = false;\n  let hostnameProvided = false;\n\n  for (let index = 2; index < argv.length;) {\n    const option = argv[index];\n    if (option === \"--root\") {\n      if (rootProvided) {\n        throw new CliSyntaxError(\"The --root option may only be provided once\");\n      }\n      const parsed = parseRootOption(argv, index);\n      root = parsed.root;\n      rootProvided = true;\n      index = parsed.nextIndex;\n      continue;\n    }\n    if (option === \"--hostname\") {\n      if (hostnameProvided) {\n        throw new CliSyntaxError(\n          \"The --hostname option may only be provided once\",\n        );\n      }\n      const value = argv[index + 1];\n      if (!value || value.startsWith(\"--\")) {\n        throw new CliSyntaxError(\"The --hostname option requires a value\");\n      }\n      hostname = value;\n      hostnameProvided = true;\n      index += 2;\n      continue;\n    }\n    throw new CliSyntaxError(`Unknown option: ${option}`);\n  }\n\n  if (hostname === undefined) {\n    throw new CliSyntaxError(\n      \"Usage: bonfire branch prepare --root <application-root> --hostname <hostname>\",\n    );\n  }\n  return { root, hostname };\n}\n\nexport function parseArgs(argv: readonly string[]): CliCommandOptions {\n  if (argv[0] === \"context\") return parseContextArgs(argv);\n  if (argv[0] === \"prepare\") return parsePrepareArgs(argv);\n  if (argv[0] === \"branch\" && argv[1] === \"prepare\") {\n    return parseBranchPrepareArgs(argv);\n  }\n  throw new CliSyntaxError(\n    \"Usage: bonfire context sync [--check] [--root <root>] | bonfire context install [--check] --app-id <app-id> [--root <root>] | bonfire prepare [--root <application-root>] | bonfire branch prepare --root <application-root> --hostname <hostname>\",\n  );\n}\n\nfunction printContextIssues(result: {\n  issues: readonly { kind: string; path: string }[];\n}) {\n  for (const issue of result.issues) {\n    console.error(`- ${issue.kind}: ${issue.path}`);\n  }\n}\n\nfunction printContextSyncSummary(result: ContextSyncResult) {\n  if (result.written.length > 0) {\n    console.log(`Written: ${result.written.join(\", \")}`);\n  }\n  if (result.removed.length > 0) {\n    console.log(`Removed: ${result.removed.join(\", \")}`);\n  }\n}\n\nasync function runContextCommand(\n  options: ContextCommandOptions,\n  dependencies: CliDependencies,\n): Promise<number> {\n  if (options.context === \"install\") {\n    if (options.check) {\n      const result = await (\n        dependencies.contextInstallCheck ?? checkContextInstallation\n      )({\n        repositoryRoot: options.root,\n        appId: options.appId,\n      });\n      if (!result.ok) {\n        console.error(\"Context install check failed:\");\n        printContextIssues(result);\n        return 1;\n      }\n      console.log(\"Context install check passed.\");\n      return 0;\n    }\n    const result = await (dependencies.contextInstall ?? installContext)({\n      repositoryRoot: options.root,\n      appId: options.appId,\n    });\n    const skills = result.skills.map(\n      (skill) => `${skill.name} (${skill.status})`,\n    );\n    const mcp = result.mcp.map((server) => `${server.name} (${server.status})`);\n    console.log(\n      skills.length > 0\n        ? `Context skills: ${skills.join(\", \")}`\n        : \"No context skills configured.\",\n    );\n    if (mcp.length > 0) console.log(`Context MCP: ${mcp.join(\", \")}`);\n    console.log(\"Context install complete.\");\n    return 0;\n  }\n\n  if (options.check) {\n    const result = await checkContext({ repositoryRoot: options.root });\n    if (!result.ok) {\n      console.error(\"Context sync check failed:\");\n      printContextIssues(result);\n      return 1;\n    }\n    console.log(\"Context sync check passed.\");\n    return 0;\n  }\n\n  const result = await syncContext({ repositoryRoot: options.root });\n  if (!result.ok) {\n    console.error(\"Context sync failed:\");\n    printContextIssues(result);\n    return 1;\n  }\n  printContextSyncSummary(result);\n  console.log(\"Context sync complete.\");\n  return 0;\n}\n\nexport async function run(\n  argv: readonly string[] = process.argv.slice(2),\n  dependencies: CliDependencies = {},\n): Promise<number> {\n  const isBranchPrepare = argv[0] === \"branch\";\n  const isContext = argv[0] === \"context\";\n  try {\n    const options = parseArgs(argv);\n    if (\"context\" in options) {\n      return await runContextCommand(options, dependencies);\n    }\n    if (\"hostname\" in options) {\n      return await runBranchPrepare(options, dependencies);\n    }\n\n    const result = await prepare(options);\n    const descriptions = {\n      environment: \"the process environment\",\n      existing: \".env.local\",\n      generated: \"a newly generated value in .env.local\",\n    } as const;\n    console.log(\n      `Bonfire preparation complete; BF_SESSION_SECRET came from ${descriptions[result.source]}.`,\n    );\n    return 0;\n  } catch (error) {\n    if (error instanceof CliSyntaxError) {\n      console.error(`bonfire: ${error.message}`);\n      return 2;\n    }\n    if (isContext) {\n      const message =\n        error instanceof Error ? error.message : \"an unknown error occurred\";\n      console.error(`bonfire context failed: ${message}`);\n      return 1;\n    }\n    if (isBranchPrepare) {\n      const message =\n        error instanceof BranchPrepareError\n          ? error.message\n          : \"Unable to load branch preparation configuration.\";\n      console.error(`bonfire branch prepare failed: ${message}`);\n      return 1;\n    }\n\n    const message =\n      error instanceof PrepareError || error instanceof Error\n        ? error.message\n        : \"an unknown error occurred\";\n    console.error(`bonfire prepare failed: ${message}`);\n    return 1;\n  }\n}\n"]}

package/dist/command.js

@@ -1,3 +1,4 @@
+import { checkContext, checkContextInstallation, installContext, syncContext, } from "@ebay-dt/bonfire-context";
 import { prepare, PrepareError } from "./prepare.js";
 import { BranchPrepareError, runBranchPrepare, } from "./branch-prepare.js";
 export class CliSyntaxError extends Error {
@@ -30,6 +31,64 @@ function parsePrepareArgs(argv) {
     }
     return { root };
 }
+function parseContextArgs(argv) {
+    const context = argv[1];
+    if (context !== "sync" && context !== "install") {
+        throw new CliSyntaxError("Usage: bonfire context sync [--check] [--root <root>] | bonfire context install [--check] --app-id <app-id> [--root <root>]");
+    }
+    let root = process.cwd();
+    let appId;
+    let check = false;
+    let rootProvided = false;
+    let appIdProvided = false;
+    let checkProvided = false;
+    for (let index = 2; index < argv.length;) {
+        const option = argv[index];
+        if (option === "--check") {
+            if (checkProvided) {
+                throw new CliSyntaxError("The --check option may only be provided once");
+            }
+            check = true;
+            checkProvided = true;
+            index += 1;
+            continue;
+        }
+        if (option === "--root") {
+            if (rootProvided) {
+                throw new CliSyntaxError("The --root option may only be provided once");
+            }
+            const parsed = parseRootOption(argv, index);
+            root = parsed.root;
+            rootProvided = true;
+            index = parsed.nextIndex;
+            continue;
+        }
+        if (option === "--app-id") {
+            if (appIdProvided) {
+                throw new CliSyntaxError("The --app-id option may only be provided once");
+            }
+            const value = argv[index + 1];
+            if (!value || value.startsWith("--")) {
+                throw new CliSyntaxError("The --app-id option requires a value");
+            }
+            appId = value;
+            appIdProvided = true;
+            index += 2;
+            continue;
+        }
+        throw new CliSyntaxError(`Unknown option: ${option}`);
+    }
+    if (context === "install") {
+        if (appId === undefined) {
+            throw new CliSyntaxError("Usage: bonfire context install [--check] --app-id <app-id> [--root <root>]");
+        }
+        return { context, root, appId, check };
+    }
+    if (appId !== undefined) {
+        throw new CliSyntaxError("The --app-id option is only valid for install");
+    }
+    return { context, root, check };
+}
 function parseBranchPrepareArgs(argv) {
     let root = process.cwd();
     let hostname;
@@ -68,17 +127,85 @@ function parseBranchPrepareArgs(argv) {
     return { root, hostname };
 }
 export function parseArgs(argv) {
+    if (argv[0] === "context")
+        return parseContextArgs(argv);
     if (argv[0] === "prepare")
         return parsePrepareArgs(argv);
     if (argv[0] === "branch" && argv[1] === "prepare") {
         return parseBranchPrepareArgs(argv);
     }
-    throw new CliSyntaxError("Usage: bonfire prepare [--root <application-root>] | bonfire branch prepare --root <application-root> --hostname <hostname>");
+    throw new CliSyntaxError("Usage: bonfire context sync [--check] [--root <root>] | bonfire context install [--check] --app-id <app-id> [--root <root>] | bonfire prepare [--root <application-root>] | bonfire branch prepare --root <application-root> --hostname <hostname>");
+}
+function printContextIssues(result) {
+    for (const issue of result.issues) {
+        console.error(`- ${issue.kind}: ${issue.path}`);
+    }
+}
+function printContextSyncSummary(result) {
+    if (result.written.length > 0) {
+        console.log(`Written: ${result.written.join(", ")}`);
+    }
+    if (result.removed.length > 0) {
+        console.log(`Removed: ${result.removed.join(", ")}`);
+    }
+}
+async function runContextCommand(options, dependencies) {
+    if (options.context === "install") {
+        if (options.check) {
+            const result = await (dependencies.contextInstallCheck ?? checkContextInstallation)({
+                repositoryRoot: options.root,
+                appId: options.appId,
+            });
+            if (!result.ok) {
+                console.error("Context install check failed:");
+                printContextIssues(result);
+                return 1;
+            }
+            console.log("Context install check passed.");
+            return 0;
+        }
+        const result = await (dependencies.contextInstall ?? installContext)({
+            repositoryRoot: options.root,
+            appId: options.appId,
+        });
+        const skills = result.skills.map((skill) => `${skill.name} (${skill.status})`);
+        const mcp = result.mcp.map((server) => `${server.name} (${server.status})`);
+        console.log(skills.length > 0
+            ? `Context skills: ${skills.join(", ")}`
+            : "No context skills configured.");
+        if (mcp.length > 0)
+            console.log(`Context MCP: ${mcp.join(", ")}`);
+        console.log("Context install complete.");
+        return 0;
+    }
+    if (options.check) {
+        const result = await checkContext({ repositoryRoot: options.root });
+        if (!result.ok) {
+            console.error("Context sync check failed:");
+            printContextIssues(result);
+            return 1;
+        }
+        console.log("Context sync check passed.");
+        return 0;
+    }
+    const result = await syncContext({ repositoryRoot: options.root });
+    if (!result.ok) {
+        console.error("Context sync failed:");
+        printContextIssues(result);
+        return 1;
+    }
+    printContextSyncSummary(result);
+    console.log("Context sync complete.");
+    return 0;
 }
 export async function run(argv = process.argv.slice(2), dependencies = {}) {
     const isBranchPrepare = argv[0] === "branch";
+    const isContext = argv[0] === "context";
     try {
         const options = parseArgs(argv);
+        if ("context" in options) {
+            return await runContextCommand(options, dependencies);
+        }
         if ("hostname" in options) {
             return await runBranchPrepare(options, dependencies);
         }
@@ -96,6 +223,11 @@ export async function run(argv = process.argv.slice(2), dependencies = {}) {
             console.error(`bonfire: ${error.message}`);
             return 2;
         }
+        if (isContext) {
+            const message = error instanceof Error ? error.message : "an unknown error occurred";
+            console.error(`bonfire context failed: ${message}`);
+            return 1;
+        }
         if (isBranchPrepare) {
             const message = error instanceof BranchPrepareError
                 ? error.message

package/dist/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"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","sourcesContent":["import { prepare, PrepareError } from \"./prepare.js\";\nimport {\n  BranchPrepareError,\n  runBranchPrepare,\n  type BranchPrepareDependencies,\n} from \"./branch-prepare.js\";\n\nexport class CliSyntaxError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CliSyntaxError\";\n  }\n}\n\nexport type PrepareCommandOptions = {\n  root: string;\n};\n\nexport type BranchPrepareCommandOptions = {\n  root: string;\n  hostname: string;\n};\n\ntype CliCommandOptions = PrepareCommandOptions | BranchPrepareCommandOptions;\n\nfunction parseRootOption(\n  argv: readonly string[],\n  start: number,\n): { root: string; nextIndex: number } {\n  const value = argv[start + 1];\n  if (!value || value.startsWith(\"--\")) {\n    throw new CliSyntaxError(\"The --root option requires a value\");\n  }\n  return { root: value, nextIndex: start + 2 };\n}\n\nfunction parsePrepareArgs(argv: readonly string[]): PrepareCommandOptions {\n  let root = process.cwd();\n  let rootProvided = false;\n  for (let index = 1; index < argv.length;) {\n    if (argv[index] !== \"--root\") {\n      throw new CliSyntaxError(`Unknown option: ${argv[index]}`);\n    }\n    if (rootProvided) {\n      throw new CliSyntaxError(\"The --root option may only be provided once\");\n    }\n    const parsed = parseRootOption(argv, index);\n    root = parsed.root;\n    rootProvided = true;\n    index = parsed.nextIndex;\n  }\n  return { root };\n}\n\nfunction parseBranchPrepareArgs(\n  argv: readonly string[],\n): BranchPrepareCommandOptions {\n  let root = process.cwd();\n  let hostname: string | undefined;\n  let rootProvided = false;\n  let hostnameProvided = false;\n\n  for (let index = 2; index < argv.length;) {\n    const option = argv[index];\n    if (option === \"--root\") {\n      if (rootProvided) {\n        throw new CliSyntaxError(\"The --root option may only be provided once\");\n      }\n      const parsed = parseRootOption(argv, index);\n      root = parsed.root;\n      rootProvided = true;\n      index = parsed.nextIndex;\n      continue;\n    }\n    if (option === \"--hostname\") {\n      if (hostnameProvided) {\n        throw new CliSyntaxError(\n          \"The --hostname option may only be provided once\",\n        );\n      }\n      const value = argv[index + 1];\n      if (!value || value.startsWith(\"--\")) {\n        throw new CliSyntaxError(\"The --hostname option requires a value\");\n      }\n      hostname = value;\n      hostnameProvided = true;\n      index += 2;\n      continue;\n    }\n    throw new CliSyntaxError(`Unknown option: ${option}`);\n  }\n\n  if (hostname === undefined) {\n    throw new CliSyntaxError(\n      \"Usage: bonfire branch prepare --root <application-root> --hostname <hostname>\",\n    );\n  }\n  return { root, hostname };\n}\n\nexport function parseArgs(argv: readonly string[]): CliCommandOptions {\n  if (argv[0] === \"prepare\") return parsePrepareArgs(argv);\n  if (argv[0] === \"branch\" && argv[1] === \"prepare\") {\n    return parseBranchPrepareArgs(argv);\n  }\n  throw new CliSyntaxError(\n    \"Usage: bonfire prepare [--root <application-root>] | bonfire branch prepare --root <application-root> --hostname <hostname>\",\n  );\n}\n\nexport async function run(\n  argv: readonly string[] = process.argv.slice(2),\n  dependencies: BranchPrepareDependencies = {},\n): Promise<number> {\n  const isBranchPrepare = argv[0] === \"branch\";\n  try {\n    const options = parseArgs(argv);\n    if (\"hostname\" in options) {\n      return await runBranchPrepare(options, dependencies);\n    }\n\n    const result = await prepare(options);\n    const descriptions = {\n      environment: \"the process environment\",\n      existing: \".env.local\",\n      generated: \"a newly generated value in .env.local\",\n    } as const;\n    console.log(\n      `Bonfire preparation complete; BF_SESSION_SECRET came from ${descriptions[result.source]}.`,\n    );\n    return 0;\n  } catch (error) {\n    if (error instanceof CliSyntaxError) {\n      console.error(`bonfire: ${error.message}`);\n      return 2;\n    }\n    if (isBranchPrepare) {\n      const message =\n        error instanceof BranchPrepareError\n          ? error.message\n          : \"Unable to load branch preparation configuration.\";\n      console.error(`bonfire branch prepare failed: ${message}`);\n      return 1;\n    }\n\n    const message =\n      error instanceof PrepareError || error instanceof Error\n        ? error.message\n        : \"an unknown error occurred\";\n    console.error(`bonfire prepare failed: ${message}`);\n    return 1;\n  }\n}\n"]}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,cAAc,EACd,WAAW,GAKZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAoCD,SAAS,eAAe,CACtB,IAAuB,EACvB,KAAa;IAEb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,cAAc,CAAC,oCAAoC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAuB;IAC/C,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QACzC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,cAAc,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,cAAc,CAAC,6CAA6C,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACnB,YAAY,GAAG,IAAI,CAAC;QACpB,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAuB;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,cAAc,CACtB,6HAA6H,CAC9H,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,KAAyB,CAAC;IAC9B,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,IAAI,cAAc,CACtB,8CAA8C,CAC/C,CAAC;YACJ,CAAC;YACD,KAAK,GAAG,IAAI,CAAC;YACb,aAAa,GAAG,IAAI,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,cAAc,CAAC,6CAA6C,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,YAAY,GAAG,IAAI,CAAC;YACpB,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,IAAI,cAAc,CACtB,+CAA+C,CAChD,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,cAAc,CAAC,sCAAsC,CAAC,CAAC;YACnE,CAAC;YACD,KAAK,GAAG,KAAK,CAAC;YACd,aAAa,GAAG,IAAI,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,IAAI,cAAc,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,cAAc,CACtB,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,cAAc,CAAC,+CAA+C,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAAuB;IAEvB,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,QAA4B,CAAC;IACjC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,cAAc,CAAC,6CAA6C,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,YAAY,GAAG,IAAI,CAAC;YACpB,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,IAAI,cAAc,CACtB,iDAAiD,CAClD,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,cAAc,CAAC,wCAAwC,CAAC,CAAC;YACrE,CAAC;YACD,QAAQ,GAAG,KAAK,CAAC;YACjB,gBAAgB,GAAG,IAAI,CAAC;YACxB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,IAAI,cAAc,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,cAAc,CACtB,+EAA+E,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAuB;IAC/C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAClD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,IAAI,cAAc,CACtB,oPAAoP,CACrP,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,MAE3B;IACC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAyB;IACxD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,OAA8B,EAC9B,YAA6B;IAE7B,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,CACnB,YAAY,CAAC,mBAAmB,IAAI,wBAAwB,CAC7D,CAAC;gBACA,cAAc,EAAE,OAAO,CAAC,IAAI;gBAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;gBAC/C,kBAAkB,CAAC,MAAM,CAAC,CAAC;gBAC3B,OAAO,CAAC,CAAC;YACX,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YAC7C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,cAAc,IAAI,cAAc,CAAC,CAAC;YACnE,cAAc,EAAE,OAAO,CAAC,IAAI;YAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAC9B,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,GAAG,CAC7C,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,MAAM,GAAG,CAAC;YACf,CAAC,CAAC,mBAAmB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACxC,CAAC,CAAC,+BAA+B,CACpC,CAAC;QACF,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC5C,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,IAAI,GAAsB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAC/C,YAAY,GAAoB,EAAE;IAElC,MAAM,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACzB,OAAO,MAAM,iBAAiB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,UAAU,IAAI,OAAO,EAAE,CAAC;YAC1B,OAAO,MAAM,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,uCAAuC;SAC1C,CAAC;QACX,OAAO,CAAC,GAAG,CACT,6DAA6D,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAC5F,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,OAAO,GACX,KAAK,YAAY,kBAAkB;gBACjC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,kDAAkD,CAAC;YACzD,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,OAAO,GACX,KAAK,YAAY,YAAY,IAAI,KAAK,YAAY,KAAK;YACrD,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,2BAA2B,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC","sourcesContent":["import {\n  checkContext,\n  checkContextInstallation,\n  installContext,\n  syncContext,\n  type ContextInstallCheckResult,\n  type ContextInstallResult,\n  type ContextInstallOptions,\n  type ContextSyncResult,\n} from \"@ebay-dt/bonfire-context\";\nimport { prepare, PrepareError } from \"./prepare.js\";\nimport {\n  BranchPrepareError,\n  runBranchPrepare,\n  type BranchPrepareDependencies,\n} from \"./branch-prepare.js\";\n\nexport class CliSyntaxError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CliSyntaxError\";\n  }\n}\n\nexport type PrepareCommandOptions = {\n  root: string;\n};\n\nexport type BranchPrepareCommandOptions = {\n  root: string;\n  hostname: string;\n};\n\nexport type ContextCommandOptions =\n  | {\n      context: \"sync\";\n      root: string;\n      check: boolean;\n    }\n  | {\n      context: \"install\";\n      root: string;\n      appId: string;\n      check: boolean;\n    };\n\ntype CliCommandOptions =\n  PrepareCommandOptions | BranchPrepareCommandOptions | ContextCommandOptions;\n\nexport type CliDependencies = BranchPrepareDependencies & {\n  contextInstall?: (\n    options: ContextInstallOptions,\n  ) => Promise<ContextInstallResult>;\n  contextInstallCheck?: (\n    options: ContextInstallOptions,\n  ) => Promise<ContextInstallCheckResult>;\n};\n\nfunction parseRootOption(\n  argv: readonly string[],\n  start: number,\n): { root: string; nextIndex: number } {\n  const value = argv[start + 1];\n  if (!value || value.startsWith(\"--\")) {\n    throw new CliSyntaxError(\"The --root option requires a value\");\n  }\n  return { root: value, nextIndex: start + 2 };\n}\n\nfunction parsePrepareArgs(argv: readonly string[]): PrepareCommandOptions {\n  let root = process.cwd();\n  let rootProvided = false;\n  for (let index = 1; index < argv.length;) {\n    if (argv[index] !== \"--root\") {\n      throw new CliSyntaxError(`Unknown option: ${argv[index]}`);\n    }\n    if (rootProvided) {\n      throw new CliSyntaxError(\"The --root option may only be provided once\");\n    }\n    const parsed = parseRootOption(argv, index);\n    root = parsed.root;\n    rootProvided = true;\n    index = parsed.nextIndex;\n  }\n  return { root };\n}\n\nfunction parseContextArgs(argv: readonly string[]): ContextCommandOptions {\n  const context = argv[1];\n  if (context !== \"sync\" && context !== \"install\") {\n    throw new CliSyntaxError(\n      \"Usage: bonfire context sync [--check] [--root <root>] | bonfire context install [--check] --app-id <app-id> [--root <root>]\",\n    );\n  }\n\n  let root = process.cwd();\n  let appId: string | undefined;\n  let check = false;\n  let rootProvided = false;\n  let appIdProvided = false;\n  let checkProvided = false;\n\n  for (let index = 2; index < argv.length;) {\n    const option = argv[index];\n    if (option === \"--check\") {\n      if (checkProvided) {\n        throw new CliSyntaxError(\n          \"The --check option may only be provided once\",\n        );\n      }\n      check = true;\n      checkProvided = true;\n      index += 1;\n      continue;\n    }\n    if (option === \"--root\") {\n      if (rootProvided) {\n        throw new CliSyntaxError(\"The --root option may only be provided once\");\n      }\n      const parsed = parseRootOption(argv, index);\n      root = parsed.root;\n      rootProvided = true;\n      index = parsed.nextIndex;\n      continue;\n    }\n    if (option === \"--app-id\") {\n      if (appIdProvided) {\n        throw new CliSyntaxError(\n          \"The --app-id option may only be provided once\",\n        );\n      }\n      const value = argv[index + 1];\n      if (!value || value.startsWith(\"--\")) {\n        throw new CliSyntaxError(\"The --app-id option requires a value\");\n      }\n      appId = value;\n      appIdProvided = true;\n      index += 2;\n      continue;\n    }\n    throw new CliSyntaxError(`Unknown option: ${option}`);\n  }\n\n  if (context === \"install\") {\n    if (appId === undefined) {\n      throw new CliSyntaxError(\n        \"Usage: bonfire context install [--check] --app-id <app-id> [--root <root>]\",\n      );\n    }\n    return { context, root, appId, check };\n  }\n  if (appId !== undefined) {\n    throw new CliSyntaxError(\"The --app-id option is only valid for install\");\n  }\n  return { context, root, check };\n}\n\nfunction parseBranchPrepareArgs(\n  argv: readonly string[],\n): BranchPrepareCommandOptions {\n  let root = process.cwd();\n  let hostname: string | undefined;\n  let rootProvided = false;\n  let hostnameProvided = false;\n\n  for (let index = 2; index < argv.length;) {\n    const option = argv[index];\n    if (option === \"--root\") {\n      if (rootProvided) {\n        throw new CliSyntaxError(\"The --root option may only be provided once\");\n      }\n      const parsed = parseRootOption(argv, index);\n      root = parsed.root;\n      rootProvided = true;\n      index = parsed.nextIndex;\n      continue;\n    }\n    if (option === \"--hostname\") {\n      if (hostnameProvided) {\n        throw new CliSyntaxError(\n          \"The --hostname option may only be provided once\",\n        );\n      }\n      const value = argv[index + 1];\n      if (!value || value.startsWith(\"--\")) {\n        throw new CliSyntaxError(\"The --hostname option requires a value\");\n      }\n      hostname = value;\n      hostnameProvided = true;\n      index += 2;\n      continue;\n    }\n    throw new CliSyntaxError(`Unknown option: ${option}`);\n  }\n\n  if (hostname === undefined) {\n    throw new CliSyntaxError(\n      \"Usage: bonfire branch prepare --root <application-root> --hostname <hostname>\",\n    );\n  }\n  return { root, hostname };\n}\n\nexport function parseArgs(argv: readonly string[]): CliCommandOptions {\n  if (argv[0] === \"context\") return parseContextArgs(argv);\n  if (argv[0] === \"prepare\") return parsePrepareArgs(argv);\n  if (argv[0] === \"branch\" && argv[1] === \"prepare\") {\n    return parseBranchPrepareArgs(argv);\n  }\n  throw new CliSyntaxError(\n    \"Usage: bonfire context sync [--check] [--root <root>] | bonfire context install [--check] --app-id <app-id> [--root <root>] | bonfire prepare [--root <application-root>] | bonfire branch prepare --root <application-root> --hostname <hostname>\",\n  );\n}\n\nfunction printContextIssues(result: {\n  issues: readonly { kind: string; path: string }[];\n}) {\n  for (const issue of result.issues) {\n    console.error(`- ${issue.kind}: ${issue.path}`);\n  }\n}\n\nfunction printContextSyncSummary(result: ContextSyncResult) {\n  if (result.written.length > 0) {\n    console.log(`Written: ${result.written.join(\", \")}`);\n  }\n  if (result.removed.length > 0) {\n    console.log(`Removed: ${result.removed.join(\", \")}`);\n  }\n}\n\nasync function runContextCommand(\n  options: ContextCommandOptions,\n  dependencies: CliDependencies,\n): Promise<number> {\n  if (options.context === \"install\") {\n    if (options.check) {\n      const result = await (\n        dependencies.contextInstallCheck ?? checkContextInstallation\n      )({\n        repositoryRoot: options.root,\n        appId: options.appId,\n      });\n      if (!result.ok) {\n        console.error(\"Context install check failed:\");\n        printContextIssues(result);\n        return 1;\n      }\n      console.log(\"Context install check passed.\");\n      return 0;\n    }\n    const result = await (dependencies.contextInstall ?? installContext)({\n      repositoryRoot: options.root,\n      appId: options.appId,\n    });\n    const skills = result.skills.map(\n      (skill) => `${skill.name} (${skill.status})`,\n    );\n    const mcp = result.mcp.map((server) => `${server.name} (${server.status})`);\n    console.log(\n      skills.length > 0\n        ? `Context skills: ${skills.join(\", \")}`\n        : \"No context skills configured.\",\n    );\n    if (mcp.length > 0) console.log(`Context MCP: ${mcp.join(\", \")}`);\n    console.log(\"Context install complete.\");\n    return 0;\n  }\n\n  if (options.check) {\n    const result = await checkContext({ repositoryRoot: options.root });\n    if (!result.ok) {\n      console.error(\"Context sync check failed:\");\n      printContextIssues(result);\n      return 1;\n    }\n    console.log(\"Context sync check passed.\");\n    return 0;\n  }\n\n  const result = await syncContext({ repositoryRoot: options.root });\n  if (!result.ok) {\n    console.error(\"Context sync failed:\");\n    printContextIssues(result);\n    return 1;\n  }\n  printContextSyncSummary(result);\n  console.log(\"Context sync complete.\");\n  return 0;\n}\n\nexport async function run(\n  argv: readonly string[] = process.argv.slice(2),\n  dependencies: CliDependencies = {},\n): Promise<number> {\n  const isBranchPrepare = argv[0] === \"branch\";\n  const isContext = argv[0] === \"context\";\n  try {\n    const options = parseArgs(argv);\n    if (\"context\" in options) {\n      return await runContextCommand(options, dependencies);\n    }\n    if (\"hostname\" in options) {\n      return await runBranchPrepare(options, dependencies);\n    }\n\n    const result = await prepare(options);\n    const descriptions = {\n      environment: \"the process environment\",\n      existing: \".env.local\",\n      generated: \"a newly generated value in .env.local\",\n    } as const;\n    console.log(\n      `Bonfire preparation complete; BF_SESSION_SECRET came from ${descriptions[result.source]}.`,\n    );\n    return 0;\n  } catch (error) {\n    if (error instanceof CliSyntaxError) {\n      console.error(`bonfire: ${error.message}`);\n      return 2;\n    }\n    if (isContext) {\n      const message =\n        error instanceof Error ? error.message : \"an unknown error occurred\";\n      console.error(`bonfire context failed: ${message}`);\n      return 1;\n    }\n    if (isBranchPrepare) {\n      const message =\n        error instanceof BranchPrepareError\n          ? error.message\n          : \"Unable to load branch preparation configuration.\";\n      console.error(`bonfire branch prepare failed: ${message}`);\n      return 1;\n    }\n\n    const message =\n      error instanceof PrepareError || error instanceof Error\n        ? error.message\n        : \"an unknown error occurred\";\n    console.error(`bonfire prepare failed: ${message}`);\n    return 1;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ebay-dt/bonfire-cli",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "The Bonfire command-line tool.",
   "license": "MIT",
   "type": "module",
@@ -30,9 +30,10 @@
     "access": "public"
   },
   "dependencies": {
+    "@ebay-dt/bonfire-context": "0.1.0-alpha.4",
     "@next/env": "16.3.4",
-    "@ebay-dt/bonfire-core": "0.1.0-alpha.3",
-    "@ebay-dt/bonfire-node": "0.1.0-alpha.3"
+    "@ebay-dt/bonfire-core": "0.1.0-alpha.4",
+    "@ebay-dt/bonfire-node": "0.1.0-alpha.4"
   },
   "devDependencies": {
     "@repo/eslint-config": "0.0.0",