@ebay-dt/bonfire-cli 0.2.0 → 0.3.0-alpha.0
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 +7 -3
- package/dist/branch-prepare.d.ts +4 -0
- package/dist/branch-prepare.d.ts.map +1 -1
- package/dist/branch-prepare.js +100 -4
- package/dist/branch-prepare.js.map +1 -1
- package/dist/command.d.ts +1 -0
- package/dist/command.d.ts.map +1 -1
- package/dist/command.js +21 -16
- package/dist/command.js.map +1 -1
- package/dist/convert.d.ts +0 -2
- package/dist/convert.d.ts.map +1 -1
- package/dist/convert.js +12 -7
- package/dist/convert.js.map +1 -1
- package/dist/release-versions.d.ts +1 -1
- package/dist/release-versions.d.ts.map +1 -1
- package/dist/release-versions.js +1 -1
- package/dist/release-versions.js.map +1 -1
- package/package.json +4 -4
- package/templates/instance/context/PROTOTYPE.md +9 -0
- package/templates/instance/context/skills/color-scheme/SKILL.md +10 -3
- package/templates/instance/context/skills/item-data/SKILL.md +23 -11
- package/templates/instance/context/skills/prototype-controls/SKILL.md +105 -0
- package/templates/instance/src/app/(prototypes)/layout.tsx +11 -9
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
|
|
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.
|
package/dist/branch-prepare.d.ts
CHANGED
|
@@ -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;AAOlE,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;AAMD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,2BAA2B,EACpC,YAAY,EAAE,yBAAyB,GACtC,OAAO,CAAC,MAAM,CAAC,CAiTjB","sourcesContent":["import { missingInstalledSkills } from \"@ebay-dt/bonfire-context\";\nimport 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 { 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\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 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/branch-prepare.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
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);
|
|
@@ -20,17 +21,98 @@ export async function runBranchPrepare(options, dependencies) {
|
|
|
20
21
|
// collaborators. A direct production invocation must remain read-only even
|
|
21
22
|
// when a previous development install left recovery state behind.
|
|
22
23
|
if (environment.NODE_ENV === "production") {
|
|
23
|
-
console.log("Branch preparation is disabled in production.");
|
|
24
24
|
return 0;
|
|
25
25
|
}
|
|
26
|
+
const checkSkills = async () => {
|
|
27
|
+
try {
|
|
28
|
+
const missing = await (dependencies.checkMissingInstalledSkills ?? missingInstalledSkills)({ repositoryRoot: root });
|
|
29
|
+
if (missing.length)
|
|
30
|
+
console.warn("Canonical skills are not installed for this app; run pnpm context:install.");
|
|
31
|
+
}
|
|
32
|
+
catch {
|
|
33
|
+
console.warn("Unable to check installed skills; continuing branch preparation.");
|
|
34
|
+
}
|
|
35
|
+
};
|
|
36
|
+
const generatedLifecycle = () => new LocalPrototypeLifecycle({
|
|
37
|
+
repositoryRoot: root,
|
|
38
|
+
prototypeRoot: options.prototypeRoot ?? environment.BF_PROTOTYPE_ROOT,
|
|
39
|
+
remote: options.remote ?? environment.BF_GIT_REMOTE,
|
|
40
|
+
primaryBranch: options.primaryBranch ?? environment.BF_PROTOTYPE_BASE_BRANCH,
|
|
41
|
+
automaticBranchSwitch: parseAutomaticBranchSwitchSetting(environment.BF_DISABLE_AUTO_BRANCH_SWITCH),
|
|
42
|
+
gitMode: parseGitModeSetting(environment.BF_GIT_MODE),
|
|
43
|
+
});
|
|
44
|
+
const ignoredPaths = new Set();
|
|
45
|
+
const configuredRoot = options.prototypeRoot ??
|
|
46
|
+
environment.BF_PROTOTYPE_ROOT ??
|
|
47
|
+
"src/app/(prototypes)";
|
|
48
|
+
const relativeRoot = relative(root, resolve(root, configuredRoot));
|
|
49
|
+
const safeRoot = relativeRoot &&
|
|
50
|
+
relativeRoot !== ".." &&
|
|
51
|
+
!relativeRoot.startsWith(`..${sep}`) &&
|
|
52
|
+
!isAbsolute(relativeRoot) &&
|
|
53
|
+
!configuredRoot.split(/[\\/]/u).includes("..")
|
|
54
|
+
? relativeRoot
|
|
55
|
+
.split(sep)
|
|
56
|
+
.join("/")
|
|
57
|
+
.replace(/[\\*?[\] ]/gu, "\\$&")
|
|
58
|
+
: undefined;
|
|
59
|
+
const regenerate = async () => {
|
|
60
|
+
try {
|
|
61
|
+
const result = await (dependencies.regenerateGeneratedContext ??
|
|
62
|
+
(() => generatedLifecycle().regenerateGeneratedContext()))();
|
|
63
|
+
if (!result.ok)
|
|
64
|
+
console.warn(`Generated context regeneration skipped: ${result.error.code}.`);
|
|
65
|
+
else {
|
|
66
|
+
for (const [reason, paths] of Object.entries(result.value.skipped)) {
|
|
67
|
+
if (reason === "not ignored")
|
|
68
|
+
paths.forEach((path) => ignoredPaths.add(path));
|
|
69
|
+
else if (paths.length)
|
|
70
|
+
console.warn(`Generated context regeneration skipped (${reason}): ${paths.join(", ")}.`);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
catch {
|
|
75
|
+
console.warn("Generated context regeneration failed; continuing branch preparation.");
|
|
76
|
+
}
|
|
77
|
+
if (ignoredPaths.size)
|
|
78
|
+
console.warn(`Generated context skipped: ${[...ignoredPaths].join(", ")}. ${safeRoot
|
|
79
|
+
? `Add these .gitignore patterns:\n${["AGENTS.md", "CLAUDE.md", ".claude/settings.json"].map((file) => `/${safeRoot}/*/*/${file}`).join("\n")}`
|
|
80
|
+
: "Check the configured prototype root before adding .gitignore patterns."}`);
|
|
81
|
+
};
|
|
82
|
+
const untrack = async (identity) => {
|
|
83
|
+
try {
|
|
84
|
+
const result = await (dependencies.untrackGeneratedContext ??
|
|
85
|
+
((user) => generatedLifecycle().untrackGeneratedContext(user)))(identity);
|
|
86
|
+
if (!result.ok)
|
|
87
|
+
console.warn(`Generated context untrack skipped: ${result.error.code}.`);
|
|
88
|
+
else if (result.value.status === "skipped") {
|
|
89
|
+
const { reason, paths } = result.value;
|
|
90
|
+
if (reason === "wrong-branch" ||
|
|
91
|
+
reason === "HEAD is not the identity branch.")
|
|
92
|
+
return;
|
|
93
|
+
if (reason ===
|
|
94
|
+
"Generated context is not ignored; add the recommended ignore rules before untracking.")
|
|
95
|
+
paths.forEach((path) => ignoredPaths.add(path));
|
|
96
|
+
else
|
|
97
|
+
console.warn(`Generated context untrack skipped: ${reason}${paths.length ? ` (${paths.join(", ")})` : ""}`);
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
catch {
|
|
101
|
+
console.warn("Generated context untrack failed; continuing branch preparation.");
|
|
102
|
+
}
|
|
103
|
+
};
|
|
26
104
|
const mode = parseAutomaticBranchSwitchSetting(environment.BF_DISABLE_AUTO_BRANCH_SWITCH);
|
|
27
105
|
const gitMode = parseGitModeSetting(environment.BF_GIT_MODE);
|
|
28
106
|
if (gitMode === "manual") {
|
|
29
107
|
console.log("Git management is in manual mode.");
|
|
108
|
+
await regenerate();
|
|
109
|
+
await checkSkills();
|
|
30
110
|
return 0;
|
|
31
111
|
}
|
|
32
112
|
if (mode === "disabled") {
|
|
33
113
|
console.log("Automatic branch switching is disabled.");
|
|
114
|
+
await regenerate();
|
|
115
|
+
await checkSkills();
|
|
34
116
|
return 0;
|
|
35
117
|
}
|
|
36
118
|
// Explicit --hostname wins. Generated scripts use --default-hostname so
|
|
@@ -73,6 +155,8 @@ export async function runBranchPrepare(options, dependencies) {
|
|
|
73
155
|
if (error instanceof GitHubCliError &&
|
|
74
156
|
(error.reason === "missing" || error.reason === "unauthenticated")) {
|
|
75
157
|
console.log("Branch preparation deferred; GitHub CLI authentication is not available.");
|
|
158
|
+
await regenerate();
|
|
159
|
+
await checkSkills();
|
|
76
160
|
return 0;
|
|
77
161
|
}
|
|
78
162
|
throw new BranchPrepareError("Unable to resolve GitHub CLI identity.");
|
|
@@ -83,7 +167,9 @@ export async function runBranchPrepare(options, dependencies) {
|
|
|
83
167
|
throw new BranchPrepareError(`Branch preparation failed with ${result.error.code}.`);
|
|
84
168
|
}
|
|
85
169
|
if (result.value.status === "deferred") {
|
|
86
|
-
console.log(
|
|
170
|
+
console.log(result.value.reason === "dirty-worktree"
|
|
171
|
+
? "Branch preparation deferred: uncommitted changes outside the prototype folder; platform updates were not applied."
|
|
172
|
+
: `Branch preparation deferred; repository attention: ${result.value.reason}.`);
|
|
87
173
|
// A dirty/offline check that made no changes is safe to leave for the
|
|
88
174
|
// existing environment. Never launch after a partially applied update.
|
|
89
175
|
if (result.value.effects.changed ||
|
|
@@ -95,6 +181,8 @@ export async function runBranchPrepare(options, dependencies) {
|
|
|
95
181
|
result.value.effects.restartRequired) {
|
|
96
182
|
throw new BranchPrepareError("Branch preparation was only partially completed; the development server was not started.");
|
|
97
183
|
}
|
|
184
|
+
await regenerate();
|
|
185
|
+
await checkSkills();
|
|
98
186
|
return 0;
|
|
99
187
|
}
|
|
100
188
|
if (result.value.status === "unsafe") {
|
|
@@ -109,14 +197,21 @@ export async function runBranchPrepare(options, dependencies) {
|
|
|
109
197
|
// justify taking down startup. A partial checkout/platform/dependency
|
|
110
198
|
// transition still does: the existing environment must not run against
|
|
111
199
|
// an unsafe working tree.
|
|
112
|
-
if (!actualContentTransition)
|
|
200
|
+
if (!actualContentTransition) {
|
|
201
|
+
await regenerate();
|
|
202
|
+
await checkSkills();
|
|
113
203
|
return 0;
|
|
204
|
+
}
|
|
114
205
|
throw new BranchPrepareError("Branch preparation was only partially completed; the development server was not started.");
|
|
115
206
|
}
|
|
116
207
|
if (result.value.status === "disabled") {
|
|
117
208
|
console.log("Branch preparation skipped; synchronization is disabled by configuration.");
|
|
209
|
+
await regenerate();
|
|
210
|
+
await checkSkills();
|
|
118
211
|
return 0;
|
|
119
212
|
}
|
|
213
|
+
await untrack(identity);
|
|
214
|
+
await regenerate();
|
|
120
215
|
const dependencyPaths = result.value.effects.dependencyPaths ?? [];
|
|
121
216
|
const managedPathChanged = dependencyPaths.length > 0 ||
|
|
122
217
|
result.value.effects.preparationRequired === true;
|
|
@@ -132,6 +227,7 @@ export async function runBranchPrepare(options, dependencies) {
|
|
|
132
227
|
throw new BranchPrepareError("This lifecycle does not support dependency preparation; the development server was not started.");
|
|
133
228
|
}
|
|
134
229
|
}
|
|
230
|
+
await checkSkills();
|
|
135
231
|
console.log("Branch preparation complete.");
|
|
136
232
|
return 0;
|
|
137
233
|
}
|
|
@@ -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} 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\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 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
package/dist/command.d.ts.map
CHANGED
|
@@ -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"]}
|
package/dist/command.js
CHANGED
|
@@ -35,11 +35,12 @@ function parsePrepareArgs(argv) {
|
|
|
35
35
|
function parseContextArgs(argv) {
|
|
36
36
|
const context = argv[1];
|
|
37
37
|
if (context !== "sync" && context !== "install") {
|
|
38
|
-
throw new CliSyntaxError("Usage: bonfire context sync [--check] [--root <root>] | bonfire context install [--check] --app-id <app-id> [--root <root>]");
|
|
38
|
+
throw new CliSyntaxError("Usage: bonfire context sync [--check] [--skip-prototypes] [--root <root>] | bonfire context install [--check] --app-id <app-id> [--root <root>]");
|
|
39
39
|
}
|
|
40
40
|
let root = process.cwd();
|
|
41
41
|
let appId;
|
|
42
42
|
let check = false;
|
|
43
|
+
let skipPrototypes = false;
|
|
43
44
|
let rootProvided = false;
|
|
44
45
|
let appIdProvided = false;
|
|
45
46
|
let checkProvided = false;
|
|
@@ -54,6 +55,14 @@ function parseContextArgs(argv) {
|
|
|
54
55
|
index += 1;
|
|
55
56
|
continue;
|
|
56
57
|
}
|
|
58
|
+
if (option === "--skip-prototypes" && context === "sync") {
|
|
59
|
+
if (skipPrototypes) {
|
|
60
|
+
throw new CliSyntaxError("The --skip-prototypes option may only be provided once");
|
|
61
|
+
}
|
|
62
|
+
skipPrototypes = true;
|
|
63
|
+
index += 1;
|
|
64
|
+
continue;
|
|
65
|
+
}
|
|
57
66
|
if (option === "--root") {
|
|
58
67
|
if (rootProvided) {
|
|
59
68
|
throw new CliSyntaxError("The --root option may only be provided once");
|
|
@@ -88,7 +97,7 @@ function parseContextArgs(argv) {
|
|
|
88
97
|
if (appId !== undefined) {
|
|
89
98
|
throw new CliSyntaxError("The --app-id option is only valid for install");
|
|
90
99
|
}
|
|
91
|
-
return { command: "context", context, root, check };
|
|
100
|
+
return { command: "context", context, root, check, skipPrototypes };
|
|
92
101
|
}
|
|
93
102
|
function parseConvertArgs(argv) {
|
|
94
103
|
const defaults = defaultConvertOptions();
|
|
@@ -97,7 +106,6 @@ function parseConvertArgs(argv) {
|
|
|
97
106
|
let name;
|
|
98
107
|
let packageName = defaults.packageName;
|
|
99
108
|
let hostname = convertDefaults.hostname;
|
|
100
|
-
let port = convertDefaults.port;
|
|
101
109
|
let deploymentEndpoint = convertDefaults.deploymentEndpoint;
|
|
102
110
|
let withoutData = false;
|
|
103
111
|
let dryRun = false;
|
|
@@ -141,14 +149,6 @@ function parseConvertArgs(argv) {
|
|
|
141
149
|
"--deployment-endpoint": (value) => {
|
|
142
150
|
deploymentEndpoint = value;
|
|
143
151
|
},
|
|
144
|
-
"--port": (value) => {
|
|
145
|
-
if (!/^\d+$/u.test(value) ||
|
|
146
|
-
Number(value) < 1 ||
|
|
147
|
-
Number(value) > 65535) {
|
|
148
|
-
throw new CliSyntaxError("--port must be a number between 1 and 65535");
|
|
149
|
-
}
|
|
150
|
-
port = Number(value);
|
|
151
|
-
},
|
|
152
152
|
};
|
|
153
153
|
const setter = setters[option];
|
|
154
154
|
if (!setter)
|
|
@@ -163,7 +163,7 @@ function parseConvertArgs(argv) {
|
|
|
163
163
|
index += 2;
|
|
164
164
|
}
|
|
165
165
|
if (!root || !appId) {
|
|
166
|
-
throw new CliSyntaxError("Usage: bonfire convert --root <next-app> --app-id <app-id> [--name <display-name>] [--hostname <hostname>] [--
|
|
166
|
+
throw new CliSyntaxError("Usage: bonfire convert --root <next-app> --app-id <app-id> [--name <display-name>] [--hostname <hostname>] [--without-data] [--dry-run] [--skip-install]");
|
|
167
167
|
}
|
|
168
168
|
return {
|
|
169
169
|
command: "convert",
|
|
@@ -172,7 +172,6 @@ function parseConvertArgs(argv) {
|
|
|
172
172
|
name: name ?? humanizeAppId(appId),
|
|
173
173
|
packageName,
|
|
174
174
|
hostname,
|
|
175
|
-
port,
|
|
176
175
|
deploymentEndpoint,
|
|
177
176
|
withItemData: !withoutData,
|
|
178
177
|
dryRun,
|
|
@@ -277,7 +276,7 @@ export function parseArgs(argv) {
|
|
|
277
276
|
if (argv[0] === "branch" && argv[1] === "prepare") {
|
|
278
277
|
return parseBranchPrepareArgs(argv);
|
|
279
278
|
}
|
|
280
|
-
throw new CliSyntaxError("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>]");
|
|
279
|
+
throw new CliSyntaxError("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>]");
|
|
281
280
|
}
|
|
282
281
|
function printContextIssues(result) {
|
|
283
282
|
for (const issue of result.issues) {
|
|
@@ -322,7 +321,10 @@ async function runContextCommand(options, dependencies) {
|
|
|
322
321
|
return 0;
|
|
323
322
|
}
|
|
324
323
|
if (options.check) {
|
|
325
|
-
const result = await checkContext({
|
|
324
|
+
const result = await checkContext({
|
|
325
|
+
repositoryRoot: options.root,
|
|
326
|
+
skipPrototypes: options.skipPrototypes,
|
|
327
|
+
});
|
|
326
328
|
if (!result.ok) {
|
|
327
329
|
console.error("Context sync check failed:");
|
|
328
330
|
printContextIssues(result);
|
|
@@ -331,7 +333,10 @@ async function runContextCommand(options, dependencies) {
|
|
|
331
333
|
console.log("Context sync check passed.");
|
|
332
334
|
return 0;
|
|
333
335
|
}
|
|
334
|
-
const result = await syncContext({
|
|
336
|
+
const result = await syncContext({
|
|
337
|
+
repositoryRoot: options.root,
|
|
338
|
+
skipPrototypes: options.skipPrototypes,
|
|
339
|
+
});
|
|
335
340
|
if (!result.ok) {
|
|
336
341
|
console.error("Context sync failed:");
|
|
337
342
|
printContextIssues(result);
|