@ebay-dt/bonfire-cli 0.2.1 → 0.3.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -55,7 +55,7 @@ pnpm --filter @ebay-dt/bonfire-cli exec node dist/bin.js convert \
55
55
  --name "My Bonfire App"
56
56
  ```
57
57
 
58
- `--root` and `--app-id` are required. The display name defaults to a humanized app ID (`my-bonfire-app` becomes `My Bonfire App`). Hostname defaults to `github.corp.ebay.com` and the development port defaults to `1995`. Data routes are included by default; use `--without-data` to omit the eBay item gateway adapter. Use `--dry-run` to inspect the plan and `--skip-install` to leave dependency installation and type generation to the caller. Existing customized files and conflicting settings stop the conversion rather than being overwritten.
58
+ `--root` and `--app-id` are required. The display name defaults to a humanized app ID (`my-bonfire-app` becomes `My Bonfire App`). Hostname defaults to `github.corp.ebay.com`. Data routes are included by default; use `--without-data` to omit the eBay item gateway adapter. Use `--dry-run` to inspect the plan and `--skip-install` to leave dependency installation and type generation to the caller. Existing customized files and conflicting settings stop the conversion rather than being overwritten.
59
59
 
60
60
  The normal conversion performs `pnpm install`, formats changed files, runs `next typegen`, and synchronizes generated repository context. It does not create GitHub/Vercel projects, authenticate a machine, or start the development server.
61
61
 
@@ -64,13 +64,13 @@ The normal conversion performs `pnpm install`, formats changed files, runs `next
64
64
  Use the context commands explicitly from an instance repository:
65
65
 
66
66
  ```sh
67
- bonfire context sync [--check] [--root <root>]
67
+ bonfire context sync [--check] [--skip-prototypes] [--root <root>]
68
68
  bonfire context install [--check] --app-id <app-id> [--root <root>]
69
69
  ```
70
70
 
71
71
  `sync` writes deterministic repository projections and `sync --check` performs
72
72
  the same validation without writing. Both default `--root` to the current
73
- working directory and print only generated paths and status. `install` installs
73
+ working directory and print only generated paths and status. `--skip-prototypes` excludes prototype discovery for both sync and check; generated app `check` uses it to validate root context only. Prototype `AGENTS.md`, `CLAUDE.md`, and `.claude/settings.json` are local ignored outputs, regenerated on non-production dev startup when eligible, rather than committed. `install` installs
74
74
  canonical skills and merges MCP definitions into the user's Cursor MCP
75
75
  configuration while preserving unrelated entries. `install --check` validates
76
76
  machine state without changing it.
@@ -98,3 +98,7 @@ nonfatal and allow Next.js to start. Invalid configuration or unexpected
98
98
  preparation failures still exit nonzero; no other branch is silently used.
99
99
  The command never starts interactive authentication or prints identity,
100
100
  credentials, paths, or raw Git output.
101
+
102
+ Non-production branch preparation regenerates eligible ignored, untracked prototype context even in manual or deferred modes. On a ready identity branch it first makes at most one untrack commit for that login. Tracked or unignored outputs are skipped with a warning; failures here are nonfatal. Production and fatal partial transitions do not regenerate. Missing canonical skill registrations trigger a recommendation to run `pnpm context:install`, not an automatic install. This check parses a literal `--app-id` from the `context:install` script and silently skips unsupported scripts or unreadable registry state.
103
+
104
+ Converted apps use `next dev` without a fixed port, and ignore `**/.next/` and the three generated outputs under the default prototype root. Custom runtime roots need corresponding ignore rules. Canonical skills include `prototype-controls`; users request its adoption explicitly.
@@ -1,7 +1,9 @@
1
+ import { missingInstalledSkills } from "@ebay-dt/bonfire-context";
1
2
  import { type DependencyInstaller, type GitHubCliClientLike, type PrototypeLifecycle } from "@ebay-dt/bonfire-node";
2
3
  import type { BranchPrepareCommandOptions } from "./command.js";
3
4
  export type CliEnvironmentLoader = (root: string) => Readonly<Record<string, string | undefined>>;
4
5
  export type BranchPrepareDependencies = {
6
+ checkMissingInstalledSkills?: typeof missingInstalledSkills;
5
7
  environment?: Readonly<Record<string, string | undefined>>;
6
8
  loadEnvironment?: CliEnvironmentLoader;
7
9
  githubCli?: GitHubCliClientLike;
@@ -10,6 +12,8 @@ export type BranchPrepareDependencies = {
10
12
  }) => GitHubCliClientLike;
11
13
  lifecycle?: Pick<PrototypeLifecycle, "prepareBranch" | "prepareDependencies">;
12
14
  installDependencies?: DependencyInstaller;
15
+ regenerateGeneratedContext?: NonNullable<PrototypeLifecycle["regenerateGeneratedContext"]>;
16
+ untrackGeneratedContext?: PrototypeLifecycle["untrackGeneratedContext"];
13
17
  };
14
18
  export declare class BranchPrepareError extends Error {
15
19
  constructor(message: string);
@@ -1 +1 @@
1
- {"version":3,"file":"branch-prepare.d.ts","sourceRoot":"","sources":["../src/branch-prepare.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,MAAM,KACT,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAElD,MAAM,MAAM,yBAAyB,GAAG;IACtC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,mBAAmB,CAAC;IACzE,SAAS,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,qBAAqB,CAAC,CAAC;IAC9E,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAMD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,2BAA2B,EACpC,YAAY,EAAE,yBAAyB,GACtC,OAAO,CAAC,MAAM,CAAC,CA2KjB","sourcesContent":["import nextEnv from \"@next/env\";\nimport {\n parseAutomaticBranchSwitchSetting,\n parseGitModeSetting,\n parseHostname,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n GitHubCliClient,\n GitHubCliError,\n LocalPrototypeLifecycle,\n type DependencyInstaller,\n type GitHubCliClientLike,\n type PrototypeLifecycle,\n} from \"@ebay-dt/bonfire-node\";\nimport { resolve } from \"node:path\";\nimport type { BranchPrepareCommandOptions } from \"./command.js\";\n\nexport type CliEnvironmentLoader = (\n root: string,\n) => Readonly<Record<string, string | undefined>>;\n\nexport type BranchPrepareDependencies = {\n environment?: Readonly<Record<string, string | undefined>>;\n loadEnvironment?: CliEnvironmentLoader;\n githubCli?: GitHubCliClientLike;\n createGitHubCli?: (options: { hostname: string }) => GitHubCliClientLike;\n lifecycle?: Pick<PrototypeLifecycle, \"prepareBranch\" | \"prepareDependencies\">;\n installDependencies?: DependencyInstaller;\n};\n\nexport class BranchPrepareError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"BranchPrepareError\";\n }\n}\n\nfunction loadEnvironment(root: string) {\n return nextEnv.loadEnvConfig(root, true, undefined, false).combinedEnv;\n}\n\nexport async function runBranchPrepare(\n options: BranchPrepareCommandOptions,\n dependencies: BranchPrepareDependencies,\n): Promise<number> {\n const root = resolve(options.root);\n const environment =\n dependencies.environment ??\n dependencies.loadEnvironment?.(root) ??\n loadEnvironment(root);\n // This guard must precede marker reads, identity resolution, and all Git\n // collaborators. A direct production invocation must remain read-only even\n // when a previous development install left recovery state behind.\n if (environment.NODE_ENV === \"production\") {\n console.log(\"Branch preparation is disabled in production.\");\n return 0;\n }\n\n const mode = parseAutomaticBranchSwitchSetting(\n environment.BF_DISABLE_AUTO_BRANCH_SWITCH,\n );\n const gitMode = parseGitModeSetting(environment.BF_GIT_MODE);\n\n if (gitMode === \"manual\") {\n console.log(\"Git management is in manual mode.\");\n return 0;\n }\n\n if (mode === \"disabled\") {\n console.log(\"Automatic branch switching is disabled.\");\n return 0;\n }\n\n // Explicit --hostname wins. Generated scripts use --default-hostname so\n // Next-compatible .env.local loading can supply BF_GITHUB_HOSTNAME first.\n const hostname = parseHostname(\n options.hostname ??\n environment.BF_GITHUB_HOSTNAME ??\n options.defaultHostname,\n );\n const lifecycle =\n dependencies.lifecycle ??\n new LocalPrototypeLifecycle({\n repositoryRoot: root,\n prototypeRoot: options.prototypeRoot ?? environment.BF_PROTOTYPE_ROOT,\n remote: options.remote ?? environment.BF_GIT_REMOTE,\n primaryBranch:\n options.primaryBranch ?? environment.BF_PROTOTYPE_BASE_BRANCH,\n automaticBranchSwitch: mode,\n gitMode,\n installDependencies: dependencies.installDependencies,\n });\n const prepareDependencies = lifecycle.prepareDependencies;\n if (prepareDependencies !== undefined) {\n console.log(\"Checking pending dependency preparation...\");\n const pending = await prepareDependencies.call(\n lifecycle,\n [],\n dependencies.installDependencies,\n );\n if (!pending.ok) {\n throw new BranchPrepareError(\"Unable to prepare project dependencies.\");\n }\n if (pending.value.status === \"failed\") {\n throw new BranchPrepareError(\n \"Dependency preparation failed; the development server was not started.\",\n );\n }\n if (pending.value.status === \"prepared\") {\n console.log(\"Pending project dependencies prepared.\");\n }\n }\n\n const githubCli =\n dependencies.githubCli ??\n dependencies.createGitHubCli?.({ hostname }) ??\n new GitHubCliClient({ hostname });\n let identity;\n try {\n identity = await githubCli.getUser();\n } catch (error) {\n if (\n error instanceof GitHubCliError &&\n (error.reason === \"missing\" || error.reason === \"unauthenticated\")\n ) {\n console.log(\n \"Branch preparation deferred; GitHub CLI authentication is not available.\",\n );\n return 0;\n }\n throw new BranchPrepareError(\"Unable to resolve GitHub CLI identity.\");\n }\n\n console.log(\"Synchronizing project platform...\");\n const result = await lifecycle.prepareBranch(identity);\n if (!result.ok) {\n throw new BranchPrepareError(\n `Branch preparation failed with ${result.error.code}.`,\n );\n }\n\n if (result.value.status === \"deferred\") {\n console.log(\n `Branch preparation deferred; repository attention: ${result.value.reason}.`,\n );\n // A dirty/offline check that made no changes is safe to leave for the\n // existing environment. Never launch after a partially applied update.\n if (\n result.value.effects.changed ||\n result.value.effects.pushed ||\n result.value.effects.reconciledPaths.length > 0 ||\n (result.value.effects.platformPaths?.length ?? 0) > 0 ||\n (result.value.effects.dependencyPaths?.length ?? 0) > 0 ||\n result.value.effects.preparationRequired === true ||\n result.value.effects.restartRequired\n ) {\n throw new BranchPrepareError(\n \"Branch preparation was only partially completed; the development server was not started.\",\n );\n }\n return 0;\n }\n if (result.value.status === \"unsafe\") {\n console.log(\n `Branch preparation requires repository attention (${result.value.reason}).`,\n );\n const effects = result.value.effects;\n const actualContentTransition =\n effects.reconciledPaths.length > 0 ||\n (effects.platformPaths?.length ?? 0) > 0 ||\n (effects.dependencyPaths?.length ?? 0) > 0 ||\n effects.preparationRequired === true ||\n effects.restartRequired;\n // History-only checkpoints and other no-effect safety refusals do not\n // justify taking down startup. A partial checkout/platform/dependency\n // transition still does: the existing environment must not run against\n // an unsafe working tree.\n if (!actualContentTransition) return 0;\n throw new BranchPrepareError(\n \"Branch preparation was only partially completed; the development server was not started.\",\n );\n }\n if (result.value.status === \"disabled\") {\n console.log(\n \"Branch preparation skipped; synchronization is disabled by configuration.\",\n );\n return 0;\n }\n\n const dependencyPaths = result.value.effects.dependencyPaths ?? [];\n const managedPathChanged =\n dependencyPaths.length > 0 ||\n result.value.effects.preparationRequired === true;\n if (managedPathChanged) {\n console.log(\"Installing updated project dependencies...\");\n if (prepareDependencies !== undefined) {\n const preparation = await prepareDependencies.call(\n lifecycle,\n dependencyPaths,\n dependencies.installDependencies,\n );\n if (!preparation.ok || preparation.value.status === \"failed\") {\n throw new BranchPrepareError(\n \"Dependency preparation failed; the development server was not started.\",\n );\n }\n } else {\n throw new BranchPrepareError(\n \"This lifecycle does not support dependency preparation; the development server was not started.\",\n );\n }\n }\n\n console.log(\"Branch preparation complete.\");\n return 0;\n}\n"]}
1
+ {"version":3,"file":"branch-prepare.d.ts","sourceRoot":"","sources":["../src/branch-prepare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAQlE,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,MAAM,KACT,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAElD,MAAM,MAAM,yBAAyB,GAAG;IACtC,2BAA2B,CAAC,EAAE,OAAO,sBAAsB,CAAC;IAC5D,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,mBAAmB,CAAC;IACzE,SAAS,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,qBAAqB,CAAC,CAAC;IAC9E,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,0BAA0B,CAAC,EAAE,WAAW,CACtC,kBAAkB,CAAC,4BAA4B,CAAC,CACjD,CAAC;IACF,uBAAuB,CAAC,EAAE,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;CACzE,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA+DD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,2BAA2B,EACpC,YAAY,EAAE,yBAAyB,GACtC,OAAO,CAAC,MAAM,CAAC,CAwTjB","sourcesContent":["import { missingInstalledSkills } from \"@ebay-dt/bonfire-context\";\nimport nextEnv from \"@next/env\";\nimport {\n parseAutomaticBranchSwitchSetting,\n parseGitModeSetting,\n parseHostname,\n type BranchPreparationDiagnostic,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n GitHubCliClient,\n GitHubCliError,\n LocalPrototypeLifecycle,\n type DependencyInstaller,\n type GitHubCliClientLike,\n type PrototypeLifecycle,\n} from \"@ebay-dt/bonfire-node\";\nimport { isAbsolute, relative, resolve, sep } from \"node:path\";\nimport type { BranchPrepareCommandOptions } from \"./command.js\";\n\nexport type CliEnvironmentLoader = (\n root: string,\n) => Readonly<Record<string, string | undefined>>;\n\nexport type BranchPrepareDependencies = {\n checkMissingInstalledSkills?: typeof missingInstalledSkills;\n environment?: Readonly<Record<string, string | undefined>>;\n loadEnvironment?: CliEnvironmentLoader;\n githubCli?: GitHubCliClientLike;\n createGitHubCli?: (options: { hostname: string }) => GitHubCliClientLike;\n lifecycle?: Pick<PrototypeLifecycle, \"prepareBranch\" | \"prepareDependencies\">;\n installDependencies?: DependencyInstaller;\n regenerateGeneratedContext?: NonNullable<\n PrototypeLifecycle[\"regenerateGeneratedContext\"]\n >;\n untrackGeneratedContext?: PrototypeLifecycle[\"untrackGeneratedContext\"];\n};\n\nexport class BranchPrepareError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"BranchPrepareError\";\n }\n}\n\nconst diagnosticStages: Record<BranchPreparationDiagnostic[\"stage\"], string> = {\n \"checkout-identity-branch\": \"checking out the identity branch\",\n \"configure-identity-upstream\": \"configuring the identity upstream\",\n \"prepare-reconciliation\": \"preparing reconciliation\",\n \"compose-baseline-tree\": \"composing the baseline tree\",\n \"create-baseline-commit\": \"creating the baseline commit\",\n \"apply-platform-patch\": \"applying the platform patch\",\n \"update-identity-ref\": \"updating the identity reference\",\n \"verify-reconciliation\": \"verifying reconciliation\",\n \"rollback-platform-patch\": \"rolling back the platform patch\",\n};\n\nconst diagnosticReasons: Record<BranchPreparationDiagnostic[\"reason\"], string> =\n {\n \"index-locked\": \"the Git index is locked\",\n \"patch-does-not-apply\": \"the patch does not apply\",\n \"identity-missing\": \"Git identity is missing\",\n \"ref-changed\": \"the reference changed\",\n \"permission-denied\": \"permission was denied\",\n \"missing-path-or-object\": \"a path or object is missing\",\n \"worktree-obstruction\": \"the working tree obstructs the operation\",\n \"worktree-changed\": \"the working tree changed\",\n unknown: \"the cause is unknown\",\n };\n\nfunction printDiagnostic(\n label: string,\n diagnostic: BranchPreparationDiagnostic,\n) {\n const ownData = (key: string): unknown => {\n try {\n const descriptor = Object.getOwnPropertyDescriptor(diagnostic, key);\n return descriptor && \"value\" in descriptor ? descriptor.value : undefined;\n } catch {\n return undefined;\n }\n };\n const stageValue = ownData(\"stage\");\n const reasonValue = ownData(\"reason\");\n const exitValue = ownData(\"exitCode\");\n const stage =\n typeof stageValue === \"string\" &&\n Object.hasOwn(diagnosticStages, stageValue)\n ? diagnosticStages[stageValue as BranchPreparationDiagnostic[\"stage\"]]\n : \"an unknown stage\";\n const reason =\n typeof reasonValue === \"string\" &&\n Object.hasOwn(diagnosticReasons, reasonValue)\n ? diagnosticReasons[reasonValue as BranchPreparationDiagnostic[\"reason\"]]\n : diagnosticReasons.unknown;\n const exitCode =\n typeof exitValue === \"number\" && Number.isSafeInteger(exitValue)\n ? ` (exit code ${exitValue})`\n : \"\";\n console.log(`${label}: ${stage}: ${reason}${exitCode}.`);\n}\n\nfunction loadEnvironment(root: string) {\n return nextEnv.loadEnvConfig(root, true, undefined, false).combinedEnv;\n}\n\nexport async function runBranchPrepare(\n options: BranchPrepareCommandOptions,\n dependencies: BranchPrepareDependencies,\n): Promise<number> {\n const root = resolve(options.root);\n const environment =\n dependencies.environment ??\n dependencies.loadEnvironment?.(root) ??\n loadEnvironment(root);\n // This guard must precede marker reads, identity resolution, and all Git\n // collaborators. A direct production invocation must remain read-only even\n // when a previous development install left recovery state behind.\n if (environment.NODE_ENV === \"production\") {\n return 0;\n }\n\n const checkSkills = async () => {\n try {\n const missing = await (\n dependencies.checkMissingInstalledSkills ?? missingInstalledSkills\n )({ repositoryRoot: root });\n if (missing.length)\n console.warn(\n \"Canonical skills are not installed for this app; run pnpm context:install.\",\n );\n } catch {\n console.warn(\n \"Unable to check installed skills; continuing branch preparation.\",\n );\n }\n };\n\n const generatedLifecycle = () =>\n new LocalPrototypeLifecycle({\n repositoryRoot: root,\n prototypeRoot: options.prototypeRoot ?? environment.BF_PROTOTYPE_ROOT,\n remote: options.remote ?? environment.BF_GIT_REMOTE,\n primaryBranch:\n options.primaryBranch ?? environment.BF_PROTOTYPE_BASE_BRANCH,\n automaticBranchSwitch: parseAutomaticBranchSwitchSetting(\n environment.BF_DISABLE_AUTO_BRANCH_SWITCH,\n ),\n gitMode: parseGitModeSetting(environment.BF_GIT_MODE),\n });\n const ignoredPaths = new Set<string>();\n const configuredRoot =\n options.prototypeRoot ??\n environment.BF_PROTOTYPE_ROOT ??\n \"src/app/(prototypes)\";\n const relativeRoot = relative(root, resolve(root, configuredRoot));\n const safeRoot =\n relativeRoot &&\n relativeRoot !== \"..\" &&\n !relativeRoot.startsWith(`..${sep}`) &&\n !isAbsolute(relativeRoot) &&\n !configuredRoot.split(/[\\\\/]/u).includes(\"..\")\n ? relativeRoot\n .split(sep)\n .join(\"/\")\n .replace(/[\\\\*?[\\] ]/gu, \"\\\\$&\")\n : undefined;\n const regenerate = async () => {\n try {\n const result = await (\n dependencies.regenerateGeneratedContext ??\n (() => generatedLifecycle().regenerateGeneratedContext())\n )();\n if (!result.ok)\n console.warn(\n `Generated context regeneration skipped: ${result.error.code}.`,\n );\n else {\n for (const [reason, paths] of Object.entries(result.value.skipped)) {\n if (reason === \"not ignored\")\n paths.forEach((path) => ignoredPaths.add(path));\n else if (paths.length)\n console.warn(\n `Generated context regeneration skipped (${reason}): ${paths.join(\", \")}.`,\n );\n }\n }\n } catch {\n console.warn(\n \"Generated context regeneration failed; continuing branch preparation.\",\n );\n }\n if (ignoredPaths.size)\n console.warn(\n `Generated context skipped: ${[...ignoredPaths].join(\", \")}. ${\n safeRoot\n ? `Add these .gitignore patterns:\\n${[\"AGENTS.md\", \"CLAUDE.md\", \".claude/settings.json\"].map((file) => `/${safeRoot}/*/*/${file}`).join(\"\\n\")}`\n : \"Check the configured prototype root before adding .gitignore patterns.\"\n }`,\n );\n };\n const untrack = async (\n identity: Parameters<PrototypeLifecycle[\"untrackGeneratedContext\"]>[0],\n ) => {\n try {\n const result = await (\n dependencies.untrackGeneratedContext ??\n ((user) => generatedLifecycle().untrackGeneratedContext(user))\n )(identity);\n if (!result.ok)\n console.warn(\n `Generated context untrack skipped: ${result.error.code}.`,\n );\n else if (result.value.status === \"skipped\") {\n const { reason, paths } = result.value;\n if (\n reason === \"wrong-branch\" ||\n reason === \"HEAD is not the identity branch.\"\n )\n return;\n if (\n reason ===\n \"Generated context is not ignored; add the recommended ignore rules before untracking.\"\n )\n paths.forEach((path) => ignoredPaths.add(path));\n else\n console.warn(\n `Generated context untrack skipped: ${reason}${paths.length ? ` (${paths.join(\", \")})` : \"\"}`,\n );\n }\n } catch {\n console.warn(\n \"Generated context untrack failed; continuing branch preparation.\",\n );\n }\n };\n\n const mode = parseAutomaticBranchSwitchSetting(\n environment.BF_DISABLE_AUTO_BRANCH_SWITCH,\n );\n const gitMode = parseGitModeSetting(environment.BF_GIT_MODE);\n\n if (gitMode === \"manual\") {\n console.log(\"Git management is in manual mode.\");\n await regenerate();\n await checkSkills();\n return 0;\n }\n\n if (mode === \"disabled\") {\n console.log(\"Automatic branch switching is disabled.\");\n await regenerate();\n await checkSkills();\n return 0;\n }\n\n // Explicit --hostname wins. Generated scripts use --default-hostname so\n // Next-compatible .env.local loading can supply BF_GITHUB_HOSTNAME first.\n const hostname = parseHostname(\n options.hostname ??\n environment.BF_GITHUB_HOSTNAME ??\n options.defaultHostname,\n );\n const lifecycle =\n dependencies.lifecycle ??\n new LocalPrototypeLifecycle({\n repositoryRoot: root,\n prototypeRoot: options.prototypeRoot ?? environment.BF_PROTOTYPE_ROOT,\n remote: options.remote ?? environment.BF_GIT_REMOTE,\n primaryBranch:\n options.primaryBranch ?? environment.BF_PROTOTYPE_BASE_BRANCH,\n automaticBranchSwitch: mode,\n gitMode,\n installDependencies: dependencies.installDependencies,\n });\n const prepareDependencies = lifecycle.prepareDependencies;\n if (prepareDependencies !== undefined) {\n console.log(\"Checking pending dependency preparation...\");\n const pending = await prepareDependencies.call(\n lifecycle,\n [],\n dependencies.installDependencies,\n );\n if (!pending.ok) {\n throw new BranchPrepareError(\"Unable to prepare project dependencies.\");\n }\n if (pending.value.status === \"failed\") {\n throw new BranchPrepareError(\n \"Dependency preparation failed; the development server was not started.\",\n );\n }\n if (pending.value.status === \"prepared\") {\n console.log(\"Pending project dependencies prepared.\");\n }\n }\n\n const githubCli =\n dependencies.githubCli ??\n dependencies.createGitHubCli?.({ hostname }) ??\n new GitHubCliClient({ hostname });\n let identity;\n try {\n identity = await githubCli.getUser();\n } catch (error) {\n if (\n error instanceof GitHubCliError &&\n (error.reason === \"missing\" || error.reason === \"unauthenticated\")\n ) {\n console.log(\n \"Branch preparation deferred; GitHub CLI authentication is not available.\",\n );\n await regenerate();\n await checkSkills();\n return 0;\n }\n throw new BranchPrepareError(\"Unable to resolve GitHub CLI identity.\");\n }\n\n console.log(\"Synchronizing project platform...\");\n const result = await lifecycle.prepareBranch(identity);\n if (!result.ok) {\n throw new BranchPrepareError(\n `Branch preparation failed with ${result.error.code}.`,\n );\n }\n\n if (result.value.status === \"deferred\") {\n console.log(\n result.value.reason === \"dirty-worktree\"\n ? \"Branch preparation deferred: uncommitted changes outside the prototype folder; platform updates were not applied.\"\n : `Branch preparation deferred; repository attention: ${result.value.reason}.`,\n );\n // A dirty/offline check that made no changes is safe to leave for the\n // existing environment. Never launch after a partially applied update.\n if (\n result.value.effects.changed ||\n result.value.effects.pushed ||\n result.value.effects.reconciledPaths.length > 0 ||\n (result.value.effects.platformPaths?.length ?? 0) > 0 ||\n (result.value.effects.dependencyPaths?.length ?? 0) > 0 ||\n result.value.effects.preparationRequired === true ||\n result.value.effects.restartRequired\n ) {\n throw new BranchPrepareError(\n \"Branch preparation was only partially completed; the development server was not started.\",\n );\n }\n await regenerate();\n await checkSkills();\n return 0;\n }\n if (result.value.status === \"unsafe\") {\n console.log(\n `Branch preparation requires repository attention (${result.value.reason}).`,\n );\n if (result.value.diagnostic)\n printDiagnostic(\"Branch preparation diagnostic\", result.value.diagnostic);\n if (result.value.rollbackDiagnostic)\n printDiagnostic(\n \"Branch preparation rollback diagnostic\",\n result.value.rollbackDiagnostic,\n );\n const effects = result.value.effects;\n const actualContentTransition =\n effects.reconciledPaths.length > 0 ||\n (effects.platformPaths?.length ?? 0) > 0 ||\n (effects.dependencyPaths?.length ?? 0) > 0 ||\n effects.preparationRequired === true ||\n effects.restartRequired;\n // History-only checkpoints and other no-effect safety refusals do not\n // justify taking down startup. A partial checkout/platform/dependency\n // transition still does: the existing environment must not run against\n // an unsafe working tree.\n if (!actualContentTransition) {\n await regenerate();\n await checkSkills();\n return 0;\n }\n throw new BranchPrepareError(\n \"Branch preparation was only partially completed; the development server was not started.\",\n );\n }\n if (result.value.status === \"disabled\") {\n console.log(\n \"Branch preparation skipped; synchronization is disabled by configuration.\",\n );\n await regenerate();\n await checkSkills();\n return 0;\n }\n\n await untrack(identity);\n await regenerate();\n\n const dependencyPaths = result.value.effects.dependencyPaths ?? [];\n const managedPathChanged =\n dependencyPaths.length > 0 ||\n result.value.effects.preparationRequired === true;\n if (managedPathChanged) {\n console.log(\"Installing updated project dependencies...\");\n if (prepareDependencies !== undefined) {\n const preparation = await prepareDependencies.call(\n lifecycle,\n dependencyPaths,\n dependencies.installDependencies,\n );\n if (!preparation.ok || preparation.value.status === \"failed\") {\n throw new BranchPrepareError(\n \"Dependency preparation failed; the development server was not started.\",\n );\n }\n } else {\n throw new BranchPrepareError(\n \"This lifecycle does not support dependency preparation; the development server was not started.\",\n );\n }\n }\n\n await checkSkills();\n console.log(\"Branch preparation complete.\");\n return 0;\n}\n"]}
@@ -1,13 +1,62 @@
1
+ import { missingInstalledSkills } from "@ebay-dt/bonfire-context";
1
2
  import nextEnv from "@next/env";
2
3
  import { parseAutomaticBranchSwitchSetting, parseGitModeSetting, parseHostname, } from "@ebay-dt/bonfire-core";
3
4
  import { GitHubCliClient, GitHubCliError, LocalPrototypeLifecycle, } from "@ebay-dt/bonfire-node";
4
- import { resolve } from "node:path";
5
+ import { isAbsolute, relative, resolve, sep } from "node:path";
5
6
  export class BranchPrepareError extends Error {
6
7
  constructor(message) {
7
8
  super(message);
8
9
  this.name = "BranchPrepareError";
9
10
  }
10
11
  }
12
+ const diagnosticStages = {
13
+ "checkout-identity-branch": "checking out the identity branch",
14
+ "configure-identity-upstream": "configuring the identity upstream",
15
+ "prepare-reconciliation": "preparing reconciliation",
16
+ "compose-baseline-tree": "composing the baseline tree",
17
+ "create-baseline-commit": "creating the baseline commit",
18
+ "apply-platform-patch": "applying the platform patch",
19
+ "update-identity-ref": "updating the identity reference",
20
+ "verify-reconciliation": "verifying reconciliation",
21
+ "rollback-platform-patch": "rolling back the platform patch",
22
+ };
23
+ const diagnosticReasons = {
24
+ "index-locked": "the Git index is locked",
25
+ "patch-does-not-apply": "the patch does not apply",
26
+ "identity-missing": "Git identity is missing",
27
+ "ref-changed": "the reference changed",
28
+ "permission-denied": "permission was denied",
29
+ "missing-path-or-object": "a path or object is missing",
30
+ "worktree-obstruction": "the working tree obstructs the operation",
31
+ "worktree-changed": "the working tree changed",
32
+ unknown: "the cause is unknown",
33
+ };
34
+ function printDiagnostic(label, diagnostic) {
35
+ const ownData = (key) => {
36
+ try {
37
+ const descriptor = Object.getOwnPropertyDescriptor(diagnostic, key);
38
+ return descriptor && "value" in descriptor ? descriptor.value : undefined;
39
+ }
40
+ catch {
41
+ return undefined;
42
+ }
43
+ };
44
+ const stageValue = ownData("stage");
45
+ const reasonValue = ownData("reason");
46
+ const exitValue = ownData("exitCode");
47
+ const stage = typeof stageValue === "string" &&
48
+ Object.hasOwn(diagnosticStages, stageValue)
49
+ ? diagnosticStages[stageValue]
50
+ : "an unknown stage";
51
+ const reason = typeof reasonValue === "string" &&
52
+ Object.hasOwn(diagnosticReasons, reasonValue)
53
+ ? diagnosticReasons[reasonValue]
54
+ : diagnosticReasons.unknown;
55
+ const exitCode = typeof exitValue === "number" && Number.isSafeInteger(exitValue)
56
+ ? ` (exit code ${exitValue})`
57
+ : "";
58
+ console.log(`${label}: ${stage}: ${reason}${exitCode}.`);
59
+ }
11
60
  function loadEnvironment(root) {
12
61
  return nextEnv.loadEnvConfig(root, true, undefined, false).combinedEnv;
13
62
  }
@@ -20,17 +69,98 @@ export async function runBranchPrepare(options, dependencies) {
20
69
  // collaborators. A direct production invocation must remain read-only even
21
70
  // when a previous development install left recovery state behind.
22
71
  if (environment.NODE_ENV === "production") {
23
- console.log("Branch preparation is disabled in production.");
24
72
  return 0;
25
73
  }
74
+ const checkSkills = async () => {
75
+ try {
76
+ const missing = await (dependencies.checkMissingInstalledSkills ?? missingInstalledSkills)({ repositoryRoot: root });
77
+ if (missing.length)
78
+ console.warn("Canonical skills are not installed for this app; run pnpm context:install.");
79
+ }
80
+ catch {
81
+ console.warn("Unable to check installed skills; continuing branch preparation.");
82
+ }
83
+ };
84
+ const generatedLifecycle = () => new LocalPrototypeLifecycle({
85
+ repositoryRoot: root,
86
+ prototypeRoot: options.prototypeRoot ?? environment.BF_PROTOTYPE_ROOT,
87
+ remote: options.remote ?? environment.BF_GIT_REMOTE,
88
+ primaryBranch: options.primaryBranch ?? environment.BF_PROTOTYPE_BASE_BRANCH,
89
+ automaticBranchSwitch: parseAutomaticBranchSwitchSetting(environment.BF_DISABLE_AUTO_BRANCH_SWITCH),
90
+ gitMode: parseGitModeSetting(environment.BF_GIT_MODE),
91
+ });
92
+ const ignoredPaths = new Set();
93
+ const configuredRoot = options.prototypeRoot ??
94
+ environment.BF_PROTOTYPE_ROOT ??
95
+ "src/app/(prototypes)";
96
+ const relativeRoot = relative(root, resolve(root, configuredRoot));
97
+ const safeRoot = relativeRoot &&
98
+ relativeRoot !== ".." &&
99
+ !relativeRoot.startsWith(`..${sep}`) &&
100
+ !isAbsolute(relativeRoot) &&
101
+ !configuredRoot.split(/[\\/]/u).includes("..")
102
+ ? relativeRoot
103
+ .split(sep)
104
+ .join("/")
105
+ .replace(/[\\*?[\] ]/gu, "\\$&")
106
+ : undefined;
107
+ const regenerate = async () => {
108
+ try {
109
+ const result = await (dependencies.regenerateGeneratedContext ??
110
+ (() => generatedLifecycle().regenerateGeneratedContext()))();
111
+ if (!result.ok)
112
+ console.warn(`Generated context regeneration skipped: ${result.error.code}.`);
113
+ else {
114
+ for (const [reason, paths] of Object.entries(result.value.skipped)) {
115
+ if (reason === "not ignored")
116
+ paths.forEach((path) => ignoredPaths.add(path));
117
+ else if (paths.length)
118
+ console.warn(`Generated context regeneration skipped (${reason}): ${paths.join(", ")}.`);
119
+ }
120
+ }
121
+ }
122
+ catch {
123
+ console.warn("Generated context regeneration failed; continuing branch preparation.");
124
+ }
125
+ if (ignoredPaths.size)
126
+ console.warn(`Generated context skipped: ${[...ignoredPaths].join(", ")}. ${safeRoot
127
+ ? `Add these .gitignore patterns:\n${["AGENTS.md", "CLAUDE.md", ".claude/settings.json"].map((file) => `/${safeRoot}/*/*/${file}`).join("\n")}`
128
+ : "Check the configured prototype root before adding .gitignore patterns."}`);
129
+ };
130
+ const untrack = async (identity) => {
131
+ try {
132
+ const result = await (dependencies.untrackGeneratedContext ??
133
+ ((user) => generatedLifecycle().untrackGeneratedContext(user)))(identity);
134
+ if (!result.ok)
135
+ console.warn(`Generated context untrack skipped: ${result.error.code}.`);
136
+ else if (result.value.status === "skipped") {
137
+ const { reason, paths } = result.value;
138
+ if (reason === "wrong-branch" ||
139
+ reason === "HEAD is not the identity branch.")
140
+ return;
141
+ if (reason ===
142
+ "Generated context is not ignored; add the recommended ignore rules before untracking.")
143
+ paths.forEach((path) => ignoredPaths.add(path));
144
+ else
145
+ console.warn(`Generated context untrack skipped: ${reason}${paths.length ? ` (${paths.join(", ")})` : ""}`);
146
+ }
147
+ }
148
+ catch {
149
+ console.warn("Generated context untrack failed; continuing branch preparation.");
150
+ }
151
+ };
26
152
  const mode = parseAutomaticBranchSwitchSetting(environment.BF_DISABLE_AUTO_BRANCH_SWITCH);
27
153
  const gitMode = parseGitModeSetting(environment.BF_GIT_MODE);
28
154
  if (gitMode === "manual") {
29
155
  console.log("Git management is in manual mode.");
156
+ await regenerate();
157
+ await checkSkills();
30
158
  return 0;
31
159
  }
32
160
  if (mode === "disabled") {
33
161
  console.log("Automatic branch switching is disabled.");
162
+ await regenerate();
163
+ await checkSkills();
34
164
  return 0;
35
165
  }
36
166
  // Explicit --hostname wins. Generated scripts use --default-hostname so
@@ -73,6 +203,8 @@ export async function runBranchPrepare(options, dependencies) {
73
203
  if (error instanceof GitHubCliError &&
74
204
  (error.reason === "missing" || error.reason === "unauthenticated")) {
75
205
  console.log("Branch preparation deferred; GitHub CLI authentication is not available.");
206
+ await regenerate();
207
+ await checkSkills();
76
208
  return 0;
77
209
  }
78
210
  throw new BranchPrepareError("Unable to resolve GitHub CLI identity.");
@@ -83,7 +215,9 @@ export async function runBranchPrepare(options, dependencies) {
83
215
  throw new BranchPrepareError(`Branch preparation failed with ${result.error.code}.`);
84
216
  }
85
217
  if (result.value.status === "deferred") {
86
- console.log(`Branch preparation deferred; repository attention: ${result.value.reason}.`);
218
+ console.log(result.value.reason === "dirty-worktree"
219
+ ? "Branch preparation deferred: uncommitted changes outside the prototype folder; platform updates were not applied."
220
+ : `Branch preparation deferred; repository attention: ${result.value.reason}.`);
87
221
  // A dirty/offline check that made no changes is safe to leave for the
88
222
  // existing environment. Never launch after a partially applied update.
89
223
  if (result.value.effects.changed ||
@@ -95,10 +229,16 @@ export async function runBranchPrepare(options, dependencies) {
95
229
  result.value.effects.restartRequired) {
96
230
  throw new BranchPrepareError("Branch preparation was only partially completed; the development server was not started.");
97
231
  }
232
+ await regenerate();
233
+ await checkSkills();
98
234
  return 0;
99
235
  }
100
236
  if (result.value.status === "unsafe") {
101
237
  console.log(`Branch preparation requires repository attention (${result.value.reason}).`);
238
+ if (result.value.diagnostic)
239
+ printDiagnostic("Branch preparation diagnostic", result.value.diagnostic);
240
+ if (result.value.rollbackDiagnostic)
241
+ printDiagnostic("Branch preparation rollback diagnostic", result.value.rollbackDiagnostic);
102
242
  const effects = result.value.effects;
103
243
  const actualContentTransition = effects.reconciledPaths.length > 0 ||
104
244
  (effects.platformPaths?.length ?? 0) > 0 ||
@@ -109,14 +249,21 @@ export async function runBranchPrepare(options, dependencies) {
109
249
  // justify taking down startup. A partial checkout/platform/dependency
110
250
  // transition still does: the existing environment must not run against
111
251
  // an unsafe working tree.
112
- if (!actualContentTransition)
252
+ if (!actualContentTransition) {
253
+ await regenerate();
254
+ await checkSkills();
113
255
  return 0;
256
+ }
114
257
  throw new BranchPrepareError("Branch preparation was only partially completed; the development server was not started.");
115
258
  }
116
259
  if (result.value.status === "disabled") {
117
260
  console.log("Branch preparation skipped; synchronization is disabled by configuration.");
261
+ await regenerate();
262
+ await checkSkills();
118
263
  return 0;
119
264
  }
265
+ await untrack(identity);
266
+ await regenerate();
120
267
  const dependencyPaths = result.value.effects.dependencyPaths ?? [];
121
268
  const managedPathChanged = dependencyPaths.length > 0 ||
122
269
  result.value.effects.preparationRequired === true;
@@ -132,6 +279,7 @@ export async function runBranchPrepare(options, dependencies) {
132
279
  throw new BranchPrepareError("This lifecycle does not support dependency preparation; the development server was not started.");
133
280
  }
134
281
  }
282
+ await checkSkills();
135
283
  console.log("Branch preparation complete.");
136
284
  return 0;
137
285
  }
@@ -1 +1 @@
1
- {"version":3,"file":"branch-prepare.js","sourceRoot":"","sources":["../src/branch-prepare.ts"],"names":[],"mappings":"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","sourcesContent":["import nextEnv from \"@next/env\";\nimport {\n parseAutomaticBranchSwitchSetting,\n parseGitModeSetting,\n parseHostname,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n GitHubCliClient,\n GitHubCliError,\n LocalPrototypeLifecycle,\n type DependencyInstaller,\n type GitHubCliClientLike,\n type PrototypeLifecycle,\n} from \"@ebay-dt/bonfire-node\";\nimport { resolve } from \"node:path\";\nimport type { BranchPrepareCommandOptions } from \"./command.js\";\n\nexport type CliEnvironmentLoader = (\n root: string,\n) => Readonly<Record<string, string | undefined>>;\n\nexport type BranchPrepareDependencies = {\n environment?: Readonly<Record<string, string | undefined>>;\n loadEnvironment?: CliEnvironmentLoader;\n githubCli?: GitHubCliClientLike;\n createGitHubCli?: (options: { hostname: string }) => GitHubCliClientLike;\n lifecycle?: Pick<PrototypeLifecycle, \"prepareBranch\" | \"prepareDependencies\">;\n installDependencies?: DependencyInstaller;\n};\n\nexport class BranchPrepareError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"BranchPrepareError\";\n }\n}\n\nfunction loadEnvironment(root: string) {\n return nextEnv.loadEnvConfig(root, true, undefined, false).combinedEnv;\n}\n\nexport async function runBranchPrepare(\n options: BranchPrepareCommandOptions,\n dependencies: BranchPrepareDependencies,\n): Promise<number> {\n const root = resolve(options.root);\n const environment =\n dependencies.environment ??\n dependencies.loadEnvironment?.(root) ??\n loadEnvironment(root);\n // This guard must precede marker reads, identity resolution, and all Git\n // collaborators. A direct production invocation must remain read-only even\n // when a previous development install left recovery state behind.\n if (environment.NODE_ENV === \"production\") {\n console.log(\"Branch preparation is disabled in production.\");\n return 0;\n }\n\n const mode = parseAutomaticBranchSwitchSetting(\n environment.BF_DISABLE_AUTO_BRANCH_SWITCH,\n );\n const gitMode = parseGitModeSetting(environment.BF_GIT_MODE);\n\n if (gitMode === \"manual\") {\n console.log(\"Git management is in manual mode.\");\n return 0;\n }\n\n if (mode === \"disabled\") {\n console.log(\"Automatic branch switching is disabled.\");\n return 0;\n }\n\n // Explicit --hostname wins. Generated scripts use --default-hostname so\n // Next-compatible .env.local loading can supply BF_GITHUB_HOSTNAME first.\n const hostname = parseHostname(\n options.hostname ??\n environment.BF_GITHUB_HOSTNAME ??\n options.defaultHostname,\n );\n const lifecycle =\n dependencies.lifecycle ??\n new LocalPrototypeLifecycle({\n repositoryRoot: root,\n prototypeRoot: options.prototypeRoot ?? environment.BF_PROTOTYPE_ROOT,\n remote: options.remote ?? environment.BF_GIT_REMOTE,\n primaryBranch:\n options.primaryBranch ?? environment.BF_PROTOTYPE_BASE_BRANCH,\n automaticBranchSwitch: mode,\n gitMode,\n installDependencies: dependencies.installDependencies,\n });\n const prepareDependencies = lifecycle.prepareDependencies;\n if (prepareDependencies !== undefined) {\n console.log(\"Checking pending dependency preparation...\");\n const pending = await prepareDependencies.call(\n lifecycle,\n [],\n dependencies.installDependencies,\n );\n if (!pending.ok) {\n throw new BranchPrepareError(\"Unable to prepare project dependencies.\");\n }\n if (pending.value.status === \"failed\") {\n throw new BranchPrepareError(\n \"Dependency preparation failed; the development server was not started.\",\n );\n }\n if (pending.value.status === \"prepared\") {\n console.log(\"Pending project dependencies prepared.\");\n }\n }\n\n const githubCli =\n dependencies.githubCli ??\n dependencies.createGitHubCli?.({ hostname }) ??\n new GitHubCliClient({ hostname });\n let identity;\n try {\n identity = await githubCli.getUser();\n } catch (error) {\n if (\n error instanceof GitHubCliError &&\n (error.reason === \"missing\" || error.reason === \"unauthenticated\")\n ) {\n console.log(\n \"Branch preparation deferred; GitHub CLI authentication is not available.\",\n );\n return 0;\n }\n throw new BranchPrepareError(\"Unable to resolve GitHub CLI identity.\");\n }\n\n console.log(\"Synchronizing project platform...\");\n const result = await lifecycle.prepareBranch(identity);\n if (!result.ok) {\n throw new BranchPrepareError(\n `Branch preparation failed with ${result.error.code}.`,\n );\n }\n\n if (result.value.status === \"deferred\") {\n console.log(\n `Branch preparation deferred; repository attention: ${result.value.reason}.`,\n );\n // A dirty/offline check that made no changes is safe to leave for the\n // existing environment. Never launch after a partially applied update.\n if (\n result.value.effects.changed ||\n result.value.effects.pushed ||\n result.value.effects.reconciledPaths.length > 0 ||\n (result.value.effects.platformPaths?.length ?? 0) > 0 ||\n (result.value.effects.dependencyPaths?.length ?? 0) > 0 ||\n result.value.effects.preparationRequired === true ||\n result.value.effects.restartRequired\n ) {\n throw new BranchPrepareError(\n \"Branch preparation was only partially completed; the development server was not started.\",\n );\n }\n return 0;\n }\n if (result.value.status === \"unsafe\") {\n console.log(\n `Branch preparation requires repository attention (${result.value.reason}).`,\n );\n const effects = result.value.effects;\n const actualContentTransition =\n effects.reconciledPaths.length > 0 ||\n (effects.platformPaths?.length ?? 0) > 0 ||\n (effects.dependencyPaths?.length ?? 0) > 0 ||\n effects.preparationRequired === true ||\n effects.restartRequired;\n // History-only checkpoints and other no-effect safety refusals do not\n // justify taking down startup. A partial checkout/platform/dependency\n // transition still does: the existing environment must not run against\n // an unsafe working tree.\n if (!actualContentTransition) return 0;\n throw new BranchPrepareError(\n \"Branch preparation was only partially completed; the development server was not started.\",\n );\n }\n if (result.value.status === \"disabled\") {\n console.log(\n \"Branch preparation skipped; synchronization is disabled by configuration.\",\n );\n return 0;\n }\n\n const dependencyPaths = result.value.effects.dependencyPaths ?? [];\n const managedPathChanged =\n dependencyPaths.length > 0 ||\n result.value.effects.preparationRequired === true;\n if (managedPathChanged) {\n console.log(\"Installing updated project dependencies...\");\n if (prepareDependencies !== undefined) {\n const preparation = await prepareDependencies.call(\n lifecycle,\n dependencyPaths,\n dependencies.installDependencies,\n );\n if (!preparation.ok || preparation.value.status === \"failed\") {\n throw new BranchPrepareError(\n \"Dependency preparation failed; the development server was not started.\",\n );\n }\n } else {\n throw new BranchPrepareError(\n \"This lifecycle does not support dependency preparation; the development server was not started.\",\n );\n }\n }\n\n console.log(\"Branch preparation complete.\");\n return 0;\n}\n"]}
1
+ {"version":3,"file":"branch-prepare.js","sourceRoot":"","sources":["../src/branch-prepare.ts"],"names":[],"mappings":"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","sourcesContent":["import { missingInstalledSkills } from \"@ebay-dt/bonfire-context\";\nimport nextEnv from \"@next/env\";\nimport {\n parseAutomaticBranchSwitchSetting,\n parseGitModeSetting,\n parseHostname,\n type BranchPreparationDiagnostic,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n GitHubCliClient,\n GitHubCliError,\n LocalPrototypeLifecycle,\n type DependencyInstaller,\n type GitHubCliClientLike,\n type PrototypeLifecycle,\n} from \"@ebay-dt/bonfire-node\";\nimport { isAbsolute, relative, resolve, sep } from \"node:path\";\nimport type { BranchPrepareCommandOptions } from \"./command.js\";\n\nexport type CliEnvironmentLoader = (\n root: string,\n) => Readonly<Record<string, string | undefined>>;\n\nexport type BranchPrepareDependencies = {\n checkMissingInstalledSkills?: typeof missingInstalledSkills;\n environment?: Readonly<Record<string, string | undefined>>;\n loadEnvironment?: CliEnvironmentLoader;\n githubCli?: GitHubCliClientLike;\n createGitHubCli?: (options: { hostname: string }) => GitHubCliClientLike;\n lifecycle?: Pick<PrototypeLifecycle, \"prepareBranch\" | \"prepareDependencies\">;\n installDependencies?: DependencyInstaller;\n regenerateGeneratedContext?: NonNullable<\n PrototypeLifecycle[\"regenerateGeneratedContext\"]\n >;\n untrackGeneratedContext?: PrototypeLifecycle[\"untrackGeneratedContext\"];\n};\n\nexport class BranchPrepareError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"BranchPrepareError\";\n }\n}\n\nconst diagnosticStages: Record<BranchPreparationDiagnostic[\"stage\"], string> = {\n \"checkout-identity-branch\": \"checking out the identity branch\",\n \"configure-identity-upstream\": \"configuring the identity upstream\",\n \"prepare-reconciliation\": \"preparing reconciliation\",\n \"compose-baseline-tree\": \"composing the baseline tree\",\n \"create-baseline-commit\": \"creating the baseline commit\",\n \"apply-platform-patch\": \"applying the platform patch\",\n \"update-identity-ref\": \"updating the identity reference\",\n \"verify-reconciliation\": \"verifying reconciliation\",\n \"rollback-platform-patch\": \"rolling back the platform patch\",\n};\n\nconst diagnosticReasons: Record<BranchPreparationDiagnostic[\"reason\"], string> =\n {\n \"index-locked\": \"the Git index is locked\",\n \"patch-does-not-apply\": \"the patch does not apply\",\n \"identity-missing\": \"Git identity is missing\",\n \"ref-changed\": \"the reference changed\",\n \"permission-denied\": \"permission was denied\",\n \"missing-path-or-object\": \"a path or object is missing\",\n \"worktree-obstruction\": \"the working tree obstructs the operation\",\n \"worktree-changed\": \"the working tree changed\",\n unknown: \"the cause is unknown\",\n };\n\nfunction printDiagnostic(\n label: string,\n diagnostic: BranchPreparationDiagnostic,\n) {\n const ownData = (key: string): unknown => {\n try {\n const descriptor = Object.getOwnPropertyDescriptor(diagnostic, key);\n return descriptor && \"value\" in descriptor ? descriptor.value : undefined;\n } catch {\n return undefined;\n }\n };\n const stageValue = ownData(\"stage\");\n const reasonValue = ownData(\"reason\");\n const exitValue = ownData(\"exitCode\");\n const stage =\n typeof stageValue === \"string\" &&\n Object.hasOwn(diagnosticStages, stageValue)\n ? diagnosticStages[stageValue as BranchPreparationDiagnostic[\"stage\"]]\n : \"an unknown stage\";\n const reason =\n typeof reasonValue === \"string\" &&\n Object.hasOwn(diagnosticReasons, reasonValue)\n ? diagnosticReasons[reasonValue as BranchPreparationDiagnostic[\"reason\"]]\n : diagnosticReasons.unknown;\n const exitCode =\n typeof exitValue === \"number\" && Number.isSafeInteger(exitValue)\n ? ` (exit code ${exitValue})`\n : \"\";\n console.log(`${label}: ${stage}: ${reason}${exitCode}.`);\n}\n\nfunction loadEnvironment(root: string) {\n return nextEnv.loadEnvConfig(root, true, undefined, false).combinedEnv;\n}\n\nexport async function runBranchPrepare(\n options: BranchPrepareCommandOptions,\n dependencies: BranchPrepareDependencies,\n): Promise<number> {\n const root = resolve(options.root);\n const environment =\n dependencies.environment ??\n dependencies.loadEnvironment?.(root) ??\n loadEnvironment(root);\n // This guard must precede marker reads, identity resolution, and all Git\n // collaborators. A direct production invocation must remain read-only even\n // when a previous development install left recovery state behind.\n if (environment.NODE_ENV === \"production\") {\n return 0;\n }\n\n const checkSkills = async () => {\n try {\n const missing = await (\n dependencies.checkMissingInstalledSkills ?? missingInstalledSkills\n )({ repositoryRoot: root });\n if (missing.length)\n console.warn(\n \"Canonical skills are not installed for this app; run pnpm context:install.\",\n );\n } catch {\n console.warn(\n \"Unable to check installed skills; continuing branch preparation.\",\n );\n }\n };\n\n const generatedLifecycle = () =>\n new LocalPrototypeLifecycle({\n repositoryRoot: root,\n prototypeRoot: options.prototypeRoot ?? environment.BF_PROTOTYPE_ROOT,\n remote: options.remote ?? environment.BF_GIT_REMOTE,\n primaryBranch:\n options.primaryBranch ?? environment.BF_PROTOTYPE_BASE_BRANCH,\n automaticBranchSwitch: parseAutomaticBranchSwitchSetting(\n environment.BF_DISABLE_AUTO_BRANCH_SWITCH,\n ),\n gitMode: parseGitModeSetting(environment.BF_GIT_MODE),\n });\n const ignoredPaths = new Set<string>();\n const configuredRoot =\n options.prototypeRoot ??\n environment.BF_PROTOTYPE_ROOT ??\n \"src/app/(prototypes)\";\n const relativeRoot = relative(root, resolve(root, configuredRoot));\n const safeRoot =\n relativeRoot &&\n relativeRoot !== \"..\" &&\n !relativeRoot.startsWith(`..${sep}`) &&\n !isAbsolute(relativeRoot) &&\n !configuredRoot.split(/[\\\\/]/u).includes(\"..\")\n ? relativeRoot\n .split(sep)\n .join(\"/\")\n .replace(/[\\\\*?[\\] ]/gu, \"\\\\$&\")\n : undefined;\n const regenerate = async () => {\n try {\n const result = await (\n dependencies.regenerateGeneratedContext ??\n (() => generatedLifecycle().regenerateGeneratedContext())\n )();\n if (!result.ok)\n console.warn(\n `Generated context regeneration skipped: ${result.error.code}.`,\n );\n else {\n for (const [reason, paths] of Object.entries(result.value.skipped)) {\n if (reason === \"not ignored\")\n paths.forEach((path) => ignoredPaths.add(path));\n else if (paths.length)\n console.warn(\n `Generated context regeneration skipped (${reason}): ${paths.join(\", \")}.`,\n );\n }\n }\n } catch {\n console.warn(\n \"Generated context regeneration failed; continuing branch preparation.\",\n );\n }\n if (ignoredPaths.size)\n console.warn(\n `Generated context skipped: ${[...ignoredPaths].join(\", \")}. ${\n safeRoot\n ? `Add these .gitignore patterns:\\n${[\"AGENTS.md\", \"CLAUDE.md\", \".claude/settings.json\"].map((file) => `/${safeRoot}/*/*/${file}`).join(\"\\n\")}`\n : \"Check the configured prototype root before adding .gitignore patterns.\"\n }`,\n );\n };\n const untrack = async (\n identity: Parameters<PrototypeLifecycle[\"untrackGeneratedContext\"]>[0],\n ) => {\n try {\n const result = await (\n dependencies.untrackGeneratedContext ??\n ((user) => generatedLifecycle().untrackGeneratedContext(user))\n )(identity);\n if (!result.ok)\n console.warn(\n `Generated context untrack skipped: ${result.error.code}.`,\n );\n else if (result.value.status === \"skipped\") {\n const { reason, paths } = result.value;\n if (\n reason === \"wrong-branch\" ||\n reason === \"HEAD is not the identity branch.\"\n )\n return;\n if (\n reason ===\n \"Generated context is not ignored; add the recommended ignore rules before untracking.\"\n )\n paths.forEach((path) => ignoredPaths.add(path));\n else\n console.warn(\n `Generated context untrack skipped: ${reason}${paths.length ? ` (${paths.join(\", \")})` : \"\"}`,\n );\n }\n } catch {\n console.warn(\n \"Generated context untrack failed; continuing branch preparation.\",\n );\n }\n };\n\n const mode = parseAutomaticBranchSwitchSetting(\n environment.BF_DISABLE_AUTO_BRANCH_SWITCH,\n );\n const gitMode = parseGitModeSetting(environment.BF_GIT_MODE);\n\n if (gitMode === \"manual\") {\n console.log(\"Git management is in manual mode.\");\n await regenerate();\n await checkSkills();\n return 0;\n }\n\n if (mode === \"disabled\") {\n console.log(\"Automatic branch switching is disabled.\");\n await regenerate();\n await checkSkills();\n return 0;\n }\n\n // Explicit --hostname wins. Generated scripts use --default-hostname so\n // Next-compatible .env.local loading can supply BF_GITHUB_HOSTNAME first.\n const hostname = parseHostname(\n options.hostname ??\n environment.BF_GITHUB_HOSTNAME ??\n options.defaultHostname,\n );\n const lifecycle =\n dependencies.lifecycle ??\n new LocalPrototypeLifecycle({\n repositoryRoot: root,\n prototypeRoot: options.prototypeRoot ?? environment.BF_PROTOTYPE_ROOT,\n remote: options.remote ?? environment.BF_GIT_REMOTE,\n primaryBranch:\n options.primaryBranch ?? environment.BF_PROTOTYPE_BASE_BRANCH,\n automaticBranchSwitch: mode,\n gitMode,\n installDependencies: dependencies.installDependencies,\n });\n const prepareDependencies = lifecycle.prepareDependencies;\n if (prepareDependencies !== undefined) {\n console.log(\"Checking pending dependency preparation...\");\n const pending = await prepareDependencies.call(\n lifecycle,\n [],\n dependencies.installDependencies,\n );\n if (!pending.ok) {\n throw new BranchPrepareError(\"Unable to prepare project dependencies.\");\n }\n if (pending.value.status === \"failed\") {\n throw new BranchPrepareError(\n \"Dependency preparation failed; the development server was not started.\",\n );\n }\n if (pending.value.status === \"prepared\") {\n console.log(\"Pending project dependencies prepared.\");\n }\n }\n\n const githubCli =\n dependencies.githubCli ??\n dependencies.createGitHubCli?.({ hostname }) ??\n new GitHubCliClient({ hostname });\n let identity;\n try {\n identity = await githubCli.getUser();\n } catch (error) {\n if (\n error instanceof GitHubCliError &&\n (error.reason === \"missing\" || error.reason === \"unauthenticated\")\n ) {\n console.log(\n \"Branch preparation deferred; GitHub CLI authentication is not available.\",\n );\n await regenerate();\n await checkSkills();\n return 0;\n }\n throw new BranchPrepareError(\"Unable to resolve GitHub CLI identity.\");\n }\n\n console.log(\"Synchronizing project platform...\");\n const result = await lifecycle.prepareBranch(identity);\n if (!result.ok) {\n throw new BranchPrepareError(\n `Branch preparation failed with ${result.error.code}.`,\n );\n }\n\n if (result.value.status === \"deferred\") {\n console.log(\n result.value.reason === \"dirty-worktree\"\n ? \"Branch preparation deferred: uncommitted changes outside the prototype folder; platform updates were not applied.\"\n : `Branch preparation deferred; repository attention: ${result.value.reason}.`,\n );\n // A dirty/offline check that made no changes is safe to leave for the\n // existing environment. Never launch after a partially applied update.\n if (\n result.value.effects.changed ||\n result.value.effects.pushed ||\n result.value.effects.reconciledPaths.length > 0 ||\n (result.value.effects.platformPaths?.length ?? 0) > 0 ||\n (result.value.effects.dependencyPaths?.length ?? 0) > 0 ||\n result.value.effects.preparationRequired === true ||\n result.value.effects.restartRequired\n ) {\n throw new BranchPrepareError(\n \"Branch preparation was only partially completed; the development server was not started.\",\n );\n }\n await regenerate();\n await checkSkills();\n return 0;\n }\n if (result.value.status === \"unsafe\") {\n console.log(\n `Branch preparation requires repository attention (${result.value.reason}).`,\n );\n if (result.value.diagnostic)\n printDiagnostic(\"Branch preparation diagnostic\", result.value.diagnostic);\n if (result.value.rollbackDiagnostic)\n printDiagnostic(\n \"Branch preparation rollback diagnostic\",\n result.value.rollbackDiagnostic,\n );\n const effects = result.value.effects;\n const actualContentTransition =\n effects.reconciledPaths.length > 0 ||\n (effects.platformPaths?.length ?? 0) > 0 ||\n (effects.dependencyPaths?.length ?? 0) > 0 ||\n effects.preparationRequired === true ||\n effects.restartRequired;\n // History-only checkpoints and other no-effect safety refusals do not\n // justify taking down startup. A partial checkout/platform/dependency\n // transition still does: the existing environment must not run against\n // an unsafe working tree.\n if (!actualContentTransition) {\n await regenerate();\n await checkSkills();\n return 0;\n }\n throw new BranchPrepareError(\n \"Branch preparation was only partially completed; the development server was not started.\",\n );\n }\n if (result.value.status === \"disabled\") {\n console.log(\n \"Branch preparation skipped; synchronization is disabled by configuration.\",\n );\n await regenerate();\n await checkSkills();\n return 0;\n }\n\n await untrack(identity);\n await regenerate();\n\n const dependencyPaths = result.value.effects.dependencyPaths ?? [];\n const managedPathChanged =\n dependencyPaths.length > 0 ||\n result.value.effects.preparationRequired === true;\n if (managedPathChanged) {\n console.log(\"Installing updated project dependencies...\");\n if (prepareDependencies !== undefined) {\n const preparation = await prepareDependencies.call(\n lifecycle,\n dependencyPaths,\n dependencies.installDependencies,\n );\n if (!preparation.ok || preparation.value.status === \"failed\") {\n throw new BranchPrepareError(\n \"Dependency preparation failed; the development server was not started.\",\n );\n }\n } else {\n throw new BranchPrepareError(\n \"This lifecycle does not support dependency preparation; the development server was not started.\",\n );\n }\n }\n\n await checkSkills();\n console.log(\"Branch preparation complete.\");\n return 0;\n}\n"]}
package/dist/command.d.ts CHANGED
@@ -22,6 +22,7 @@ export type ContextCommandOptions = {
22
22
  context: "sync";
23
23
  root: string;
24
24
  check: boolean;
25
+ skipPrototypes: boolean;
25
26
  } | {
26
27
  command: "context";
27
28
  context: "install";
@@ -1 +1 @@
1
- {"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;AAC7B,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IACE,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAE5E,KAAK,iBAAiB,GAClB,qBAAqB,GACrB,2BAA2B,GAC3B,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,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;AA8RF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAUpE;AA+ED,wBAAsB,GAAG,CACvB,IAAI,GAAE,SAAS,MAAM,EAA0B,EAC/C,YAAY,GAAE,eAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CA4DjB","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\";\nimport {\n convert,\n convertDefaults,\n defaultConvertOptions,\n humanizeAppId,\n type ConvertOptions,\n} from \"./convert.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 command: \"prepare\";\n root: string;\n};\n\nexport type BranchPrepareCommandOptions = {\n command: \"branch\";\n root: string;\n hostname?: string;\n defaultHostname?: string;\n prototypeRoot?: string;\n remote?: string;\n primaryBranch?: string;\n};\n\nexport type ContextCommandOptions =\n | {\n command: \"context\";\n context: \"sync\";\n root: string;\n check: boolean;\n }\n | {\n command: \"context\";\n context: \"install\";\n root: string;\n appId: string;\n check: boolean;\n };\n\nexport type ConvertCommandOptions = ConvertOptions & { command: \"convert\" };\n\ntype CliCommandOptions =\n | PrepareCommandOptions\n | BranchPrepareCommandOptions\n | ContextCommandOptions\n | ConvertCommandOptions;\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 { command: \"prepare\", 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 { command: \"context\", 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 { command: \"context\", context, root, check };\n}\n\nfunction parseConvertArgs(argv: readonly string[]): ConvertCommandOptions {\n const defaults = defaultConvertOptions();\n let root: string | undefined;\n let appId: string | undefined;\n let name: string | undefined;\n let packageName = defaults.packageName;\n let hostname = convertDefaults.hostname;\n let port = convertDefaults.port;\n let deploymentEndpoint = convertDefaults.deploymentEndpoint;\n let withoutData = false;\n let dryRun = false;\n let skipInstall = false;\n const seen = new Set<string>();\n\n for (let index = 1; index < argv.length;) {\n const option = argv[index];\n if (!option) throw new CliSyntaxError(\"Missing convert option\");\n if (\n option === \"--without-data\" ||\n option === \"--dry-run\" ||\n option === \"--skip-install\"\n ) {\n if (seen.has(option))\n throw new CliSyntaxError(`${option} may only be provided once`);\n seen.add(option);\n if (option === \"--without-data\") withoutData = true;\n if (option === \"--dry-run\") dryRun = true;\n if (option === \"--skip-install\") skipInstall = true;\n index += 1;\n continue;\n }\n const setters: Record<string, (value: string) => void> = {\n \"--root\": (value) => {\n root = value;\n },\n \"--app-id\": (value) => {\n appId = value;\n },\n \"--name\": (value) => {\n name = value;\n },\n \"--package-name\": (value) => {\n packageName = value;\n },\n \"--hostname\": (value) => {\n hostname = value;\n },\n \"--deployment-endpoint\": (value) => {\n deploymentEndpoint = value;\n },\n \"--port\": (value) => {\n if (\n !/^\\d+$/u.test(value) ||\n Number(value) < 1 ||\n Number(value) > 65535\n ) {\n throw new CliSyntaxError(\n \"--port must be a number between 1 and 65535\",\n );\n }\n port = Number(value);\n },\n };\n const setter = setters[option];\n if (!setter) throw new CliSyntaxError(`Unknown option: ${option}`);\n if (seen.has(option))\n throw new CliSyntaxError(`${option} may only be provided once`);\n const value = argv[index + 1];\n if (!value || value.startsWith(\"--\"))\n throw new CliSyntaxError(`${option} requires a value`);\n seen.add(option);\n setter(value);\n index += 2;\n }\n if (!root || !appId) {\n throw new CliSyntaxError(\n \"Usage: bonfire convert --root <next-app> --app-id <app-id> [--name <display-name>] [--hostname <hostname>] [--port <port>] [--without-data] [--dry-run] [--skip-install]\",\n );\n }\n return {\n command: \"convert\",\n root,\n appId,\n name: name ?? humanizeAppId(appId),\n packageName,\n hostname,\n port,\n deploymentEndpoint,\n withItemData: !withoutData,\n dryRun,\n skipInstall,\n };\n}\n\nfunction parseBranchPrepareArgs(\n argv: readonly string[],\n): BranchPrepareCommandOptions {\n let root = process.cwd();\n let hostname: string | undefined;\n let defaultHostname: string | undefined;\n let prototypeRoot: string | undefined;\n let remote: string | undefined;\n let primaryBranch: string | undefined;\n let rootProvided = false;\n let hostnameProvided = false;\n let defaultHostnameProvided = false;\n let prototypeRootProvided = false;\n let remoteProvided = false;\n let primaryBranchProvided = 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 (\n option === \"--prototype-root\" ||\n option === \"--remote\" ||\n option === \"--primary\"\n ) {\n const provided =\n option === \"--prototype-root\"\n ? prototypeRootProvided\n : option === \"--remote\"\n ? remoteProvided\n : primaryBranchProvided;\n if (provided) {\n throw new CliSyntaxError(`${option} may only be provided once`);\n }\n if (option === \"--prototype-root\") prototypeRootProvided = true;\n if (option === \"--remote\") remoteProvided = true;\n if (option === \"--primary\") primaryBranchProvided = true;\n const value = argv[index + 1];\n if (!value || value.startsWith(\"--\")) {\n throw new CliSyntaxError(`${option} requires a value`);\n }\n if (option === \"--prototype-root\") prototypeRoot = value;\n if (option === \"--remote\") remote = value;\n if (option === \"--primary\") primaryBranch = value;\n index += 2;\n continue;\n }\n if (option === \"--hostname\" || option === \"--default-hostname\") {\n const isDefault = option === \"--default-hostname\";\n const provided = isDefault ? defaultHostnameProvided : hostnameProvided;\n if (provided) {\n throw new CliSyntaxError(\n `The ${option} option may only be provided once`,\n );\n }\n const value = argv[index + 1];\n if (!value || value.startsWith(\"--\")) {\n throw new CliSyntaxError(`The ${option} option requires a value`);\n }\n if (isDefault) {\n defaultHostname = value;\n defaultHostnameProvided = true;\n } else {\n hostname = value;\n hostnameProvided = true;\n }\n index += 2;\n continue;\n }\n throw new CliSyntaxError(`Unknown option: ${option}`);\n }\n\n return {\n command: \"branch\",\n root,\n ...(hostname === undefined ? {} : { hostname }),\n ...(defaultHostname === undefined ? {} : { defaultHostname }),\n ...(prototypeRoot === undefined ? {} : { prototypeRoot }),\n ...(remote === undefined ? {} : { remote }),\n ...(primaryBranch === undefined ? {} : { primaryBranch }),\n };\n}\n\nexport function parseArgs(argv: readonly string[]): CliCommandOptions {\n if (argv[0] === \"convert\") return parseConvertArgs(argv);\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 convert --root <next-app> --app-id <app-id> [options] | 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>] [--default-hostname <hostname>] [--prototype-root <root>] [--remote <name>] [--primary <branch>]\",\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 const isConvert = argv[0] === \"convert\";\n try {\n const options = parseArgs(argv);\n switch (options.command) {\n case \"context\":\n return await runContextCommand(options, dependencies);\n case \"convert\":\n await convert(options);\n return 0;\n case \"branch\":\n return await runBranchPrepare(options, dependencies);\n case \"prepare\": {\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 }\n }\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 if (isConvert) {\n const message =\n error instanceof Error ? error.message : \"an unknown error occurred\";\n console.error(`bonfire convert 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"]}
1
+ {"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;AAC7B,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IACE,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;CACzB,GACD;IACE,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAE5E,KAAK,iBAAiB,GAClB,qBAAqB,GACrB,2BAA2B,GAC3B,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,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;AA2RF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAUpE;AAqFD,wBAAsB,GAAG,CACvB,IAAI,GAAE,SAAS,MAAM,EAA0B,EAC/C,YAAY,GAAE,eAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CA4DjB","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\";\nimport {\n convert,\n convertDefaults,\n defaultConvertOptions,\n humanizeAppId,\n type ConvertOptions,\n} from \"./convert.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 command: \"prepare\";\n root: string;\n};\n\nexport type BranchPrepareCommandOptions = {\n command: \"branch\";\n root: string;\n hostname?: string;\n defaultHostname?: string;\n prototypeRoot?: string;\n remote?: string;\n primaryBranch?: string;\n};\n\nexport type ContextCommandOptions =\n | {\n command: \"context\";\n context: \"sync\";\n root: string;\n check: boolean;\n skipPrototypes: boolean;\n }\n | {\n command: \"context\";\n context: \"install\";\n root: string;\n appId: string;\n check: boolean;\n };\n\nexport type ConvertCommandOptions = ConvertOptions & { command: \"convert\" };\n\ntype CliCommandOptions =\n | PrepareCommandOptions\n | BranchPrepareCommandOptions\n | ContextCommandOptions\n | ConvertCommandOptions;\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 { command: \"prepare\", 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] [--skip-prototypes] [--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 skipPrototypes = 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 === \"--skip-prototypes\" && context === \"sync\") {\n if (skipPrototypes) {\n throw new CliSyntaxError(\n \"The --skip-prototypes option may only be provided once\",\n );\n }\n skipPrototypes = 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 { command: \"context\", 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 { command: \"context\", context, root, check, skipPrototypes };\n}\n\nfunction parseConvertArgs(argv: readonly string[]): ConvertCommandOptions {\n const defaults = defaultConvertOptions();\n let root: string | undefined;\n let appId: string | undefined;\n let name: string | undefined;\n let packageName = defaults.packageName;\n let hostname = convertDefaults.hostname;\n let deploymentEndpoint = convertDefaults.deploymentEndpoint;\n let withoutData = false;\n let dryRun = false;\n let skipInstall = false;\n const seen = new Set<string>();\n\n for (let index = 1; index < argv.length;) {\n const option = argv[index];\n if (!option) throw new CliSyntaxError(\"Missing convert option\");\n if (\n option === \"--without-data\" ||\n option === \"--dry-run\" ||\n option === \"--skip-install\"\n ) {\n if (seen.has(option))\n throw new CliSyntaxError(`${option} may only be provided once`);\n seen.add(option);\n if (option === \"--without-data\") withoutData = true;\n if (option === \"--dry-run\") dryRun = true;\n if (option === \"--skip-install\") skipInstall = true;\n index += 1;\n continue;\n }\n const setters: Record<string, (value: string) => void> = {\n \"--root\": (value) => {\n root = value;\n },\n \"--app-id\": (value) => {\n appId = value;\n },\n \"--name\": (value) => {\n name = value;\n },\n \"--package-name\": (value) => {\n packageName = value;\n },\n \"--hostname\": (value) => {\n hostname = value;\n },\n \"--deployment-endpoint\": (value) => {\n deploymentEndpoint = value;\n },\n };\n const setter = setters[option];\n if (!setter) throw new CliSyntaxError(`Unknown option: ${option}`);\n if (seen.has(option))\n throw new CliSyntaxError(`${option} may only be provided once`);\n const value = argv[index + 1];\n if (!value || value.startsWith(\"--\"))\n throw new CliSyntaxError(`${option} requires a value`);\n seen.add(option);\n setter(value);\n index += 2;\n }\n if (!root || !appId) {\n throw new CliSyntaxError(\n \"Usage: bonfire convert --root <next-app> --app-id <app-id> [--name <display-name>] [--hostname <hostname>] [--without-data] [--dry-run] [--skip-install]\",\n );\n }\n return {\n command: \"convert\",\n root,\n appId,\n name: name ?? humanizeAppId(appId),\n packageName,\n hostname,\n deploymentEndpoint,\n withItemData: !withoutData,\n dryRun,\n skipInstall,\n };\n}\n\nfunction parseBranchPrepareArgs(\n argv: readonly string[],\n): BranchPrepareCommandOptions {\n let root = process.cwd();\n let hostname: string | undefined;\n let defaultHostname: string | undefined;\n let prototypeRoot: string | undefined;\n let remote: string | undefined;\n let primaryBranch: string | undefined;\n let rootProvided = false;\n let hostnameProvided = false;\n let defaultHostnameProvided = false;\n let prototypeRootProvided = false;\n let remoteProvided = false;\n let primaryBranchProvided = 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 (\n option === \"--prototype-root\" ||\n option === \"--remote\" ||\n option === \"--primary\"\n ) {\n const provided =\n option === \"--prototype-root\"\n ? prototypeRootProvided\n : option === \"--remote\"\n ? remoteProvided\n : primaryBranchProvided;\n if (provided) {\n throw new CliSyntaxError(`${option} may only be provided once`);\n }\n if (option === \"--prototype-root\") prototypeRootProvided = true;\n if (option === \"--remote\") remoteProvided = true;\n if (option === \"--primary\") primaryBranchProvided = true;\n const value = argv[index + 1];\n if (!value || value.startsWith(\"--\")) {\n throw new CliSyntaxError(`${option} requires a value`);\n }\n if (option === \"--prototype-root\") prototypeRoot = value;\n if (option === \"--remote\") remote = value;\n if (option === \"--primary\") primaryBranch = value;\n index += 2;\n continue;\n }\n if (option === \"--hostname\" || option === \"--default-hostname\") {\n const isDefault = option === \"--default-hostname\";\n const provided = isDefault ? defaultHostnameProvided : hostnameProvided;\n if (provided) {\n throw new CliSyntaxError(\n `The ${option} option may only be provided once`,\n );\n }\n const value = argv[index + 1];\n if (!value || value.startsWith(\"--\")) {\n throw new CliSyntaxError(`The ${option} option requires a value`);\n }\n if (isDefault) {\n defaultHostname = value;\n defaultHostnameProvided = true;\n } else {\n hostname = value;\n hostnameProvided = true;\n }\n index += 2;\n continue;\n }\n throw new CliSyntaxError(`Unknown option: ${option}`);\n }\n\n return {\n command: \"branch\",\n root,\n ...(hostname === undefined ? {} : { hostname }),\n ...(defaultHostname === undefined ? {} : { defaultHostname }),\n ...(prototypeRoot === undefined ? {} : { prototypeRoot }),\n ...(remote === undefined ? {} : { remote }),\n ...(primaryBranch === undefined ? {} : { primaryBranch }),\n };\n}\n\nexport function parseArgs(argv: readonly string[]): CliCommandOptions {\n if (argv[0] === \"convert\") return parseConvertArgs(argv);\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 convert --root <next-app> --app-id <app-id> [options] | bonfire context sync [--check] [--skip-prototypes] [--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>] [--default-hostname <hostname>] [--prototype-root <root>] [--remote <name>] [--primary <branch>]\",\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({\n repositoryRoot: options.root,\n skipPrototypes: options.skipPrototypes,\n });\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({\n repositoryRoot: options.root,\n skipPrototypes: options.skipPrototypes,\n });\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 const isConvert = argv[0] === \"convert\";\n try {\n const options = parseArgs(argv);\n switch (options.command) {\n case \"context\":\n return await runContextCommand(options, dependencies);\n case \"convert\":\n await convert(options);\n return 0;\n case \"branch\":\n return await runBranchPrepare(options, dependencies);\n case \"prepare\": {\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 }\n }\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 if (isConvert) {\n const message =\n error instanceof Error ? error.message : \"an unknown error occurred\";\n console.error(`bonfire convert 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"]}