everything-dev 1.53.1 → 2.0.0-rc.0

package/dist/cli/init.d.mts

@@ -1,7 +1,26 @@
-import { BosConfig, BosConfigInput } from "../types.mjs";
+import { BosConfig, BosConfigInput, ParentStarterConfig, StarterLevel } from "../types.mjs";
 import { OverrideSection } from "../contract.mjs";
+import { runDockerComposeUp } from "../infra/docker.mjs";
 //#region src/cli/init.d.ts
-declare const INIT_ROOT_PATTERNS: readonly ["bos.config.json", "package.json", ".env.example", ".gitignore", "biome.json", "bunfig.toml", "Dockerfile", "railway.json", "railway.toml", "AGENTS.md", ".changeset/config.json", ".changeset/README.md", "README.md", "CONTRIBUTING.md", ".github/templates/**"];
+declare const PNPM_PACKAGE_MANAGER = "pnpm@12.10.1";
+/**
+ * The child's workspace manifest: pnpm-workspace.yaml is canonical (v2, ADR
+ * 0026) — packages globs synthesized from the child's override sections, the
+ * catalog merged over any local entry, plus the fleet-wide linker posture and
+ * singleton overrides. Re-running (sync/upgrade) merges instead of clobbering.
+ */
+declare function writeChildWorkspaceYaml(projectDir: string, next: {
+  packages: string[];
+  catalog: Record<string, string>;
+}): boolean;
+/**
+ * Init must never reuse a lockfile left in the target (copied from a parent
+ * checkout or left by a previous run) — stale framework resolutions would
+ * survive the fresh install. Bun's bun.lock is deleted on sight (ADR 0026's
+ * silent-revert footgun); the child's own pnpm-lock.yaml is re-resolved.
+ */
+declare function removeStrayLockfiles(projectDir: string): void;
+declare const INIT_ROOT_PATTERNS: readonly ["bos.config.json", "package.json", ".env.example", ".gitignore", "biome.json", "railway.json", "railway.toml", "AGENTS.md", ".agents/skills/**", "skills-lock.json", "docs/agents/**", ".changeset/config.json", ".changeset/README.md", "README.md", "CONTRIBUTING.md", ".github/templates/**"];
 interface SourceResult {
   sourceDir: string;
   parentConfig: BosConfig;
@@ -12,6 +31,7 @@ interface CatalogChainSource {
   repository?: string;
   extendsChain: string[];
 }
+declare function readWorkspaceCatalog(sourceDir: string): Record<string, string>;
 declare function resolveCatalogChainSource(opts: {
   extendsAccount: string;
   extendsGateway: string;
@@ -23,9 +43,21 @@ declare function resolveSourceDir(opts: {
   source?: string;
 }): Promise<SourceResult>;
 declare function buildInitPatterns(overrides: OverrideSection[], plugins?: string[], pluginDirMap?: Record<string, string>): string[];
+declare function isApiTemplatePath(filePath: string): boolean;
+declare function isComposeTemplatePath(filePath: string): boolean;
 declare function buildPluginRouteExclusions(parentConfig: {
   plugins?: Record<string, unknown>;
 } | null | undefined, selectedPlugins: string[]): string[];
+/**
+ * Route-file globs (relative to the child's `ui/src/routes/`) that a starter
+ * of the given level must not receive. Parent `starter` config can add
+ * exclusions (`exclude`, `levels[level].exclude`) or reclaim routes for a
+ * level (`levels[level].include`). Entries are prefixed with
+ * `ui/src/routes/` so they compose with `copyFilteredFiles`'s ignore list.
+ */
+declare function buildStarterRouteExclusions(level: StarterLevel, parentConfig: {
+  starter?: ParentStarterConfig;
+} | null | undefined): string[];
 declare function sourcePathToDestinationPath(filePath: string): string;
 declare function fetchParentConfig(extendsAccount: string, extendsGateway: string): Promise<BosConfig>;
 declare function resolveRepositoryViaExtendsChain(extendsAccount: string, extendsGateway: string, visited?: Set<string>): Promise<{
@@ -42,6 +74,23 @@ declare function copyFilteredFiles(sourceDir: string, destination: string, patte
   plugins?: string[];
   ignore?: string[];
 }): Promise<number>;
+/**
+ * Scaffold the authored config as the TS form: the personalized
+ * bos.config.json materializes into an authored `bos.app.ts` descriptor and
+ * the JSON copy is removed — publish/sync still canonicalize to JSON for
+ * FastKV from the resolved config. Returns the config that was converted, so
+ * callers that need it (before the child has node_modules to import the
+ * descriptor) can pass it onward.
+ */
+declare function convertChildConfigToAppForm(destination: string): Promise<BosConfigInput | null>;
+/**
+ * Scaffold the root dev-overlay starter (`bos.dev.ts`). Idempotent — never
+ * overwrites an existing overlay. Dev overlays are merged child-wins over
+ * the resolved config in development and are never published.
+ */
+declare function writeDevOverlayTemplate(destination: string, opts?: {
+  extendsRef?: string;
+}): void;
 declare function getParentOnlyScriptKeys(projectDir: string): string[];
 declare function buildChildRootScripts(sections: {
   ui: boolean;
@@ -68,13 +117,14 @@ declare function personalizeConfig(destination: string, opts: {
   description?: string;
   testnet?: string;
   staging?: unknown;
+  starter?: StarterLevel;
 }): Promise<void>;
-declare function runBunInstall(destination: string, opts?: {
+declare function runPnpmInstall(destination: string, opts?: {
   spinner?: {
     message: (msg: string) => void;
   };
 }): Promise<void>;
-declare function runBunInstallForUpgrade(destination: string, opts?: {
+declare function runPnpmInstallForUpgrade(destination: string, opts?: {
   spinner?: {
     message: (msg: string) => void;
   };
@@ -85,9 +135,6 @@ declare function runTypesGen(destination: string, opts?: {
   };
   remotePlugins?: string[];
 }): Promise<void>;
-declare function runDockerComposeUp(destination: string): Promise<void>;
-declare function stripOrphanedWorkspacesFromLockfile(lockfilePath: string, allowedWorkspaces: string[]): void;
-declare function removeInitLockfile(lockfilePath: string): void;
 declare function scaffoldMinimalProject(destination: string, parentConfig: BosConfigInput, opts: {
   extendsAccount: string;
   extendsGateway: string;
@@ -98,11 +145,15 @@ declare function scaffoldMinimalProject(destination: string, parentConfig: BosCo
   repository?: string;
   title?: string;
   description?: string;
+  starter?: StarterLevel;
+  /** local parent source dir — resolves the catalog offline (tests, --source) */
+  catalogSourceDir?: string;
 }): Promise<number>;
 declare function writeInitSnapshot(destination: string, extendsAccount: string, extendsGateway: string, sourceDir: string, patterns: string[], options: {
   overrides: OverrideSection[];
   plugins?: string[];
   ignore?: string[];
+  starter?: StarterLevel;
 }): Promise<void>;
 declare function generateDatabaseMigrations(destination: string): Promise<void>;
 declare function execCommand(command: string, args: string[], cwd?: string, options?: {
@@ -117,6 +168,8 @@ declare function personalizeAgentsMd(destination: string, opts: {
   overrides: OverrideSection[];
   plugins?: string[];
 }): Promise<void>;
+declare function buildChildLlmsTxt(title: string): string;
+declare function buildChildSkillMd(title: string, repository: string): string;
 //#endregion
-export { CatalogChainSource, INIT_ROOT_PATTERNS, buildChildAgentsMd, buildChildRootScripts, buildInitPatterns, buildPluginRouteExclusions, copyFilteredFiles, detectGitRemoteUrl, downloadTarball, execCommand, extractSkillsBlock, fetchParentConfig, generateDatabaseMigrations, getParentOnlyScriptKeys, personalizeAgentsMd, personalizeConfig, removeInitLockfile, resolveCatalogChainSource, resolveRepositoryViaExtendsChain, resolveSourceDir, runBunInstall, runBunInstallForUpgrade, runDockerComposeUp, runTypesGen, scaffoldMinimalProject, sourcePathToDestinationPath, stripOrphanedWorkspacesFromLockfile, writeInitSnapshot };
+export { CatalogChainSource, INIT_ROOT_PATTERNS, PNPM_PACKAGE_MANAGER, buildChildAgentsMd, buildChildLlmsTxt, buildChildRootScripts, buildChildSkillMd, buildInitPatterns, buildPluginRouteExclusions, buildStarterRouteExclusions, convertChildConfigToAppForm, copyFilteredFiles, detectGitRemoteUrl, downloadTarball, execCommand, extractSkillsBlock, fetchParentConfig, generateDatabaseMigrations, getParentOnlyScriptKeys, isApiTemplatePath, isComposeTemplatePath, personalizeAgentsMd, personalizeConfig, readWorkspaceCatalog, removeStrayLockfiles, resolveCatalogChainSource, resolveRepositoryViaExtendsChain, resolveSourceDir, runDockerComposeUp, runPnpmInstall, runPnpmInstallForUpgrade, runTypesGen, scaffoldMinimalProject, sourcePathToDestinationPath, writeChildWorkspaceYaml, writeDevOverlayTemplate, writeInitSnapshot };
 //# sourceMappingURL=init.d.mts.map