everything-dev 1.53.1 → 2.0.0-rc.0

package/dist/cli/snapshot.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.cjs","names":[],"sources":["../../src/cli/snapshot.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface SyncSnapshot {\n  parentRef: string;\n  timestamp: string;\n  files: Record<string, string>;\n}\n\nconst SNAPSHOT_DIR = \".bos\";\nconst SNAPSHOT_FILE = \"sync-snapshot.json\";\n\nfunction snapshotPath(projectDir: string): string {\n  return join(projectDir, SNAPSHOT_DIR, SNAPSHOT_FILE);\n}\n\nexport async function readSnapshot(projectDir: string): Promise<SyncSnapshot | null> {\n  const path = snapshotPath(projectDir);\n  if (!existsSync(path)) {\n    return null;\n  }\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    return JSON.parse(content) as SyncSnapshot;\n  } catch {\n    return null;\n  }\n}\n\nexport async function writeSnapshot(\n  projectDir: string,\n  data: { parentRef: string; files: Record<string, string> },\n): Promise<void> {\n  const dir = join(projectDir, SNAPSHOT_DIR);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const snapshot: SyncSnapshot = {\n    parentRef: data.parentRef,\n    timestamp: new Date().toISOString(),\n    files: data.files,\n  };\n\n  writeFileSync(snapshotPath(projectDir), `${JSON.stringify(snapshot, null, 2)}\\n`);\n}\n"],"mappings":";;;;AASA,MAAM,eAAe;AACrB,MAAM,gBAAgB;AAEtB,SAAS,aAAa,YAA4B;CAChD,2BAAY,YAAY,cAAc,aAAa;AACrD;AAEA,eAAsB,aAAa,YAAkD;CACnF,MAAM,OAAO,aAAa,UAAU;CACpC,IAAI,yBAAY,IAAI,GAClB,OAAO;CAET,IAAI;EACF,MAAM,oCAAuB,MAAM,OAAO;EAC1C,OAAO,KAAK,MAAM,OAAO;CAC3B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,cACpB,YACA,MACe;CACf,MAAM,0BAAW,YAAY,YAAY;CACzC,IAAI,yBAAY,GAAG,GACjB,uBAAU,KAAK,EAAE,WAAW,KAAK,CAAC;CAGpC,MAAM,WAAyB;EAC7B,WAAW,KAAK;EAChB,4BAAW,IAAI,KAAK,EAAC,CAAC,YAAY;EAClC,OAAO,KAAK;CACd;CAEA,2BAAc,aAAa,UAAU,GAAG,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,GAAG;AAClF"}
+{"version":3,"file":"snapshot.cjs","names":["join","existsSync","readFileSync"],"sources":["../../src/cli/snapshot.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface SyncSnapshot {\n  parentRef: string;\n  timestamp: string;\n  files: Record<string, string>;\n  starter?: string;\n}\n\nconst SNAPSHOT_DIR = \".bos\";\nconst SNAPSHOT_FILE = \"sync-snapshot.json\";\n\nfunction snapshotPath(projectDir: string): string {\n  return join(projectDir, SNAPSHOT_DIR, SNAPSHOT_FILE);\n}\n\nexport async function readSnapshot(projectDir: string): Promise<SyncSnapshot | null> {\n  const path = snapshotPath(projectDir);\n  if (!existsSync(path)) {\n    return null;\n  }\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    return JSON.parse(content) as SyncSnapshot;\n  } catch {\n    return null;\n  }\n}\n\nexport async function writeSnapshot(\n  projectDir: string,\n  data: { parentRef: string; files: Record<string, string>; starter?: string },\n): Promise<void> {\n  const dir = join(projectDir, SNAPSHOT_DIR);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const snapshot: SyncSnapshot = {\n    parentRef: data.parentRef,\n    timestamp: new Date().toISOString(),\n    files: data.files,\n    ...(data.starter ? { starter: data.starter } : {}),\n  };\n\n  writeFileSync(snapshotPath(projectDir), `${JSON.stringify(snapshot, null, 2)}\\n`);\n}\n"],"mappings":";;;;AAUA,MAAM,eAAe;AACrB,MAAM,gBAAgB;AAEtB,SAAS,aAAa,YAA4B;CAChD,WAAOA,gBAAK,YAAY,cAAc,aAAa;AACrD;AAEA,eAAsB,aAAa,YAAkD;CACnF,MAAM,OAAO,aAAa,UAAU;CACpC,IAAI,KAACC,oBAAW,IAAI,GAClB,OAAO;CAET,IAAI;EACF,MAAM,cAAUC,sBAAa,MAAM,OAAO;EAC1C,OAAO,KAAK,MAAM,OAAO;CAC3B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,cACpB,YACA,MACe;CACf,MAAM,UAAMF,gBAAK,YAAY,YAAY;CACzC,IAAI,KAACC,oBAAW,GAAG,GACjB,uBAAU,KAAK,EAAE,WAAW,KAAK,CAAC;CAGpC,MAAM,WAAyB;EAC7B,WAAW,KAAK;EAChB,4BAAW,IAAI,KAAK,EAAC,CAAC,YAAY;EAClC,OAAO,KAAK;EACZ,GAAI,KAAK,UAAU,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;CAClD;CAEA,2BAAc,aAAa,UAAU,GAAG,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,GAAG;AAClF"}

package/dist/cli/snapshot.mjs

@@ -23,7 +23,8 @@ async function writeSnapshot(projectDir, data) {
 	const snapshot = {
 		parentRef: data.parentRef,
 		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-		files: data.files
+		files: data.files,
+		...data.starter ? { starter: data.starter } : {}
 	};
 	writeFileSync(snapshotPath(projectDir), `${JSON.stringify(snapshot, null, 2)}\n`);
 }

package/dist/cli/snapshot.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../src/cli/snapshot.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface SyncSnapshot {\n  parentRef: string;\n  timestamp: string;\n  files: Record<string, string>;\n}\n\nconst SNAPSHOT_DIR = \".bos\";\nconst SNAPSHOT_FILE = \"sync-snapshot.json\";\n\nfunction snapshotPath(projectDir: string): string {\n  return join(projectDir, SNAPSHOT_DIR, SNAPSHOT_FILE);\n}\n\nexport async function readSnapshot(projectDir: string): Promise<SyncSnapshot | null> {\n  const path = snapshotPath(projectDir);\n  if (!existsSync(path)) {\n    return null;\n  }\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    return JSON.parse(content) as SyncSnapshot;\n  } catch {\n    return null;\n  }\n}\n\nexport async function writeSnapshot(\n  projectDir: string,\n  data: { parentRef: string; files: Record<string, string> },\n): Promise<void> {\n  const dir = join(projectDir, SNAPSHOT_DIR);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const snapshot: SyncSnapshot = {\n    parentRef: data.parentRef,\n    timestamp: new Date().toISOString(),\n    files: data.files,\n  };\n\n  writeFileSync(snapshotPath(projectDir), `${JSON.stringify(snapshot, null, 2)}\\n`);\n}\n"],"mappings":";;;;AASA,MAAM,eAAe;AACrB,MAAM,gBAAgB;AAEtB,SAAS,aAAa,YAA4B;CAChD,OAAO,KAAK,YAAY,cAAc,aAAa;AACrD;AAEA,eAAsB,aAAa,YAAkD;CACnF,MAAM,OAAO,aAAa,UAAU;CACpC,IAAI,CAAC,WAAW,IAAI,GAClB,OAAO;CAET,IAAI;EACF,MAAM,UAAU,aAAa,MAAM,OAAO;EAC1C,OAAO,KAAK,MAAM,OAAO;CAC3B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,cACpB,YACA,MACe;CACf,MAAM,MAAM,KAAK,YAAY,YAAY;CACzC,IAAI,CAAC,WAAW,GAAG,GACjB,UAAU,KAAK,EAAE,WAAW,KAAK,CAAC;CAGpC,MAAM,WAAyB;EAC7B,WAAW,KAAK;EAChB,4BAAW,IAAI,KAAK,EAAC,CAAC,YAAY;EAClC,OAAO,KAAK;CACd;CAEA,cAAc,aAAa,UAAU,GAAG,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,GAAG;AAClF"}
+{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../src/cli/snapshot.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface SyncSnapshot {\n  parentRef: string;\n  timestamp: string;\n  files: Record<string, string>;\n  starter?: string;\n}\n\nconst SNAPSHOT_DIR = \".bos\";\nconst SNAPSHOT_FILE = \"sync-snapshot.json\";\n\nfunction snapshotPath(projectDir: string): string {\n  return join(projectDir, SNAPSHOT_DIR, SNAPSHOT_FILE);\n}\n\nexport async function readSnapshot(projectDir: string): Promise<SyncSnapshot | null> {\n  const path = snapshotPath(projectDir);\n  if (!existsSync(path)) {\n    return null;\n  }\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    return JSON.parse(content) as SyncSnapshot;\n  } catch {\n    return null;\n  }\n}\n\nexport async function writeSnapshot(\n  projectDir: string,\n  data: { parentRef: string; files: Record<string, string>; starter?: string },\n): Promise<void> {\n  const dir = join(projectDir, SNAPSHOT_DIR);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const snapshot: SyncSnapshot = {\n    parentRef: data.parentRef,\n    timestamp: new Date().toISOString(),\n    files: data.files,\n    ...(data.starter ? { starter: data.starter } : {}),\n  };\n\n  writeFileSync(snapshotPath(projectDir), `${JSON.stringify(snapshot, null, 2)}\\n`);\n}\n"],"mappings":";;;;AAUA,MAAM,eAAe;AACrB,MAAM,gBAAgB;AAEtB,SAAS,aAAa,YAA4B;CAChD,OAAO,KAAK,YAAY,cAAc,aAAa;AACrD;AAEA,eAAsB,aAAa,YAAkD;CACnF,MAAM,OAAO,aAAa,UAAU;CACpC,IAAI,CAAC,WAAW,IAAI,GAClB,OAAO;CAET,IAAI;EACF,MAAM,UAAU,aAAa,MAAM,OAAO;EAC1C,OAAO,KAAK,MAAM,OAAO;CAC3B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,cACpB,YACA,MACe;CACf,MAAM,MAAM,KAAK,YAAY,YAAY;CACzC,IAAI,CAAC,WAAW,GAAG,GACjB,UAAU,KAAK,EAAE,WAAW,KAAK,CAAC;CAGpC,MAAM,WAAyB;EAC7B,WAAW,KAAK;EAChB,4BAAW,IAAI,KAAK,EAAC,CAAC,YAAY;EAClC,OAAO,KAAK;EACZ,GAAI,KAAK,UAAU,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;CAClD;CAEA,cAAc,aAAa,UAAU,GAAG,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,GAAG;AAClF"}

package/dist/cli/status.cjs

@@ -1,5 +1,6 @@
 const require_http_client = require('../http-client.cjs');
 const require_fastkv = require('../fastkv.cjs');
+const require_config = require('../config.cjs');
 const require_snapshot = require('./snapshot.cjs');
 const require_framework_version = require('./framework-version.cjs');
 let node_fs = require("node:fs");
@@ -42,14 +43,14 @@ async function checkParentReachable(extendsRef) {
 	}
 }
 async function getStatus(projectDir) {
-	const configPath = (0, node_path.join)(projectDir, "bos.config.json");
-	if (!(0, node_fs.existsSync)(configPath)) return {
+	const authored = await require_config.readAuthoredConfigInput(projectDir);
+	if (!authored) return {
 		status: "error",
-		error: "No bos.config.json found in current directory",
+		error: `${require_config.MISSING_CONFIG_MESSAGE} in current directory`,
 		packages: [],
 		envFile: "missing"
 	};
-	const config = JSON.parse((0, node_fs.readFileSync)(configPath, "utf-8"));
+	const config = authored;
 	const packageNames = [...FRAMEWORK_PACKAGES];
 	for (const name of CATALOG_TOOL_PACKAGES) if (readInstalledVersion(projectDir, name)) packageNames.push(name);
 	const packages = await Promise.all(packageNames.map(async (name) => {

package/dist/cli/status.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"status.cjs","names":["fetchJsonOrNull","readInstalledFrameworkVersion","fetchBosConfigFromFastKv","resolveFrameworkPackage","readSnapshot"],"sources":["../../src/cli/status.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { StatusResult } from \"../contract\";\nimport { fetchBosConfigFromFastKv } from \"../fastkv\";\nimport { fetchJsonOrNull } from \"../http-client\";\nimport { readInstalledFrameworkVersion, resolveFrameworkPackage } from \"./framework-version\";\nimport { readSnapshot } from \"./snapshot\";\n\nconst FRAMEWORK_PACKAGES = [\"everything-dev\", \"every-plugin\"];\n\nconst CATALOG_TOOL_PACKAGES = [\n  \"@rspack/core\",\n  \"@rspack/cli\",\n  \"@rsbuild/core\",\n  \"@rsbuild/plugin-react\",\n  \"@module-federation/enhanced\",\n  \"@module-federation/node\",\n  \"@module-federation/rsbuild-plugin\",\n  \"@module-federation/runtime-core\",\n  \"@module-federation/sdk\",\n  \"@module-federation/dts-plugin\",\n] as const;\n\nasync function fetchLatestNpmVersion(packageName: string): Promise<string | null> {\n  return fetchJsonOrNull<{ version: string }>(`https://registry.npmjs.org/${packageName}/latest`, {\n    headers: { Accept: \"application/json\" },\n    retries: 0,\n  }).then((data) => data?.version ?? null);\n}\n\nfunction readInstalledVersion(projectDir: string, packageName: string): string | undefined {\n  return readInstalledFrameworkVersion(projectDir, packageName);\n}\n\nfunction checkEnvFile(projectDir: string): \"found\" | \"missing\" | \"example-only\" {\n  if (existsSync(join(projectDir, \".env\"))) return \"found\";\n  if (existsSync(join(projectDir, \".env.example\"))) return \"example-only\";\n  return \"missing\";\n}\n\nasync function checkParentReachable(extendsRef: string | undefined): Promise<boolean | undefined> {\n  if (!extendsRef?.startsWith(\"bos://\")) return undefined;\n  try {\n    const config = await fetchBosConfigFromFastKv(extendsRef);\n    return config !== null;\n  } catch {\n    return false;\n  }\n}\n\nexport async function getStatus(projectDir: string): Promise<StatusResult> {\n  const configPath = join(projectDir, \"bos.config.json\");\n  if (!existsSync(configPath)) {\n    return {\n      status: \"error\",\n      error: \"No bos.config.json found in current directory\",\n      packages: [],\n      envFile: \"missing\",\n    };\n  }\n\n  const config = JSON.parse(readFileSync(configPath, \"utf-8\")) as Record<string, unknown>;\n\n  const packageNames = [...FRAMEWORK_PACKAGES];\n  for (const name of CATALOG_TOOL_PACKAGES) {\n    if (readInstalledVersion(projectDir, name)) {\n      packageNames.push(name);\n    }\n  }\n\n  const packages = await Promise.all(\n    packageNames.map(async (name) => {\n      const resolved = resolveFrameworkPackage(projectDir, name);\n      const latest = await fetchLatestNpmVersion(name);\n      return {\n        name,\n        installed: resolved.installedVersion,\n        latest: latest ?? undefined,\n        isLinked: resolved.isLinked,\n        specifier: resolved.specifier,\n      };\n    }),\n  );\n\n  const snapshot = await readSnapshot(projectDir);\n\n  const extendsRef = config.extends as string | undefined;\n  const parentReachable = await checkParentReachable(extendsRef);\n\n  return {\n    status: \"ok\",\n    extends: extendsRef,\n    account: config.account as string | undefined,\n    domain: config.domain as string | undefined,\n    packages,\n    lastSync: snapshot?.timestamp,\n    envFile: checkEnvFile(projectDir),\n    parentReachable,\n  };\n}\n"],"mappings":";;;;;;;;AAQA,MAAM,qBAAqB,CAAC,kBAAkB,cAAc;AAE5D,MAAM,wBAAwB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,eAAe,sBAAsB,aAA6C;CAChF,OAAOA,oCAAqC,8BAA8B,YAAY,UAAU;EAC9F,SAAS,EAAE,QAAQ,mBAAmB;EACtC,SAAS;CACX,CAAC,CAAC,CAAC,MAAM,SAAS,MAAM,WAAW,IAAI;AACzC;AAEA,SAAS,qBAAqB,YAAoB,aAAyC;CACzF,OAAOC,wDAA8B,YAAY,WAAW;AAC9D;AAEA,SAAS,aAAa,YAA0D;CAC9E,gDAAoB,YAAY,MAAM,CAAC,GAAG,OAAO;CACjD,gDAAoB,YAAY,cAAc,CAAC,GAAG,OAAO;CACzD,OAAO;AACT;AAEA,eAAe,qBAAqB,YAA8D;CAChG,IAAI,CAAC,YAAY,WAAW,QAAQ,GAAG,OAAO;CAC9C,IAAI;EAEF,OAAO,MADcC,wCAAyB,UAAU,MACtC;CACpB,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,UAAU,YAA2C;CACzE,MAAM,iCAAkB,YAAY,iBAAiB;CACrD,IAAI,yBAAY,UAAU,GACxB,OAAO;EACL,QAAQ;EACR,OAAO;EACP,UAAU,CAAC;EACX,SAAS;CACX;CAGF,MAAM,SAAS,KAAK,gCAAmB,YAAY,OAAO,CAAC;CAE3D,MAAM,eAAe,CAAC,GAAG,kBAAkB;CAC3C,KAAK,MAAM,QAAQ,uBACjB,IAAI,qBAAqB,YAAY,IAAI,GACvC,aAAa,KAAK,IAAI;CAI1B,MAAM,WAAW,MAAM,QAAQ,IAC7B,aAAa,IAAI,OAAO,SAAS;EAC/B,MAAM,WAAWC,kDAAwB,YAAY,IAAI;EACzD,MAAM,SAAS,MAAM,sBAAsB,IAAI;EAC/C,OAAO;GACL;GACA,WAAW,SAAS;GACpB,QAAQ,UAAU;GAClB,UAAU,SAAS;GACnB,WAAW,SAAS;EACtB;CACF,CAAC,CACH;CAEA,MAAM,WAAW,MAAMC,8BAAa,UAAU;CAE9C,MAAM,aAAa,OAAO;CAC1B,MAAM,kBAAkB,MAAM,qBAAqB,UAAU;CAE7D,OAAO;EACL,QAAQ;EACR,SAAS;EACT,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf;EACA,UAAU,UAAU;EACpB,SAAS,aAAa,UAAU;EAChC;CACF;AACF"}
+{"version":3,"file":"status.cjs","names":["fetchJsonOrNull","readInstalledFrameworkVersion","existsSync","join","fetchBosConfigFromFastKv","readAuthoredConfigInput","MISSING_CONFIG_MESSAGE","resolveFrameworkPackage","readSnapshot"],"sources":["../../src/cli/status.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { MISSING_CONFIG_MESSAGE, readAuthoredConfigInput } from \"../config\";\nimport type { StatusResult } from \"../contract\";\nimport { fetchBosConfigFromFastKv } from \"../fastkv\";\nimport { fetchJsonOrNull } from \"../http-client\";\nimport { readInstalledFrameworkVersion, resolveFrameworkPackage } from \"./framework-version\";\nimport { readSnapshot } from \"./snapshot\";\n\nconst FRAMEWORK_PACKAGES = [\"everything-dev\", \"every-plugin\"];\n\nconst CATALOG_TOOL_PACKAGES = [\n  \"@rspack/core\",\n  \"@rspack/cli\",\n  \"@rsbuild/core\",\n  \"@rsbuild/plugin-react\",\n  \"@module-federation/enhanced\",\n  \"@module-federation/node\",\n  \"@module-federation/rsbuild-plugin\",\n  \"@module-federation/runtime-core\",\n  \"@module-federation/sdk\",\n  \"@module-federation/dts-plugin\",\n] as const;\n\nasync function fetchLatestNpmVersion(packageName: string): Promise<string | null> {\n  return fetchJsonOrNull<{ version: string }>(`https://registry.npmjs.org/${packageName}/latest`, {\n    headers: { Accept: \"application/json\" },\n    retries: 0,\n  }).then((data) => data?.version ?? null);\n}\n\nfunction readInstalledVersion(projectDir: string, packageName: string): string | undefined {\n  return readInstalledFrameworkVersion(projectDir, packageName);\n}\n\nfunction checkEnvFile(projectDir: string): \"found\" | \"missing\" | \"example-only\" {\n  if (existsSync(join(projectDir, \".env\"))) return \"found\";\n  if (existsSync(join(projectDir, \".env.example\"))) return \"example-only\";\n  return \"missing\";\n}\n\nasync function checkParentReachable(extendsRef: string | undefined): Promise<boolean | undefined> {\n  if (!extendsRef?.startsWith(\"bos://\")) return undefined;\n  try {\n    const config = await fetchBosConfigFromFastKv(extendsRef);\n    return config !== null;\n  } catch {\n    return false;\n  }\n}\n\nexport async function getStatus(projectDir: string): Promise<StatusResult> {\n  const authored = await readAuthoredConfigInput(projectDir);\n  if (!authored) {\n    return {\n      status: \"error\",\n      error: `${MISSING_CONFIG_MESSAGE} in current directory`,\n      packages: [],\n      envFile: \"missing\",\n    };\n  }\n\n  const config = authored as Record<string, unknown>;\n\n  const packageNames = [...FRAMEWORK_PACKAGES];\n  for (const name of CATALOG_TOOL_PACKAGES) {\n    if (readInstalledVersion(projectDir, name)) {\n      packageNames.push(name);\n    }\n  }\n\n  const packages = await Promise.all(\n    packageNames.map(async (name) => {\n      const resolved = resolveFrameworkPackage(projectDir, name);\n      const latest = await fetchLatestNpmVersion(name);\n      return {\n        name,\n        installed: resolved.installedVersion,\n        latest: latest ?? undefined,\n        isLinked: resolved.isLinked,\n        specifier: resolved.specifier,\n      };\n    }),\n  );\n\n  const snapshot = await readSnapshot(projectDir);\n\n  const extendsRef = config.extends as string | undefined;\n  const parentReachable = await checkParentReachable(extendsRef);\n\n  return {\n    status: \"ok\",\n    extends: extendsRef,\n    account: config.account as string | undefined,\n    domain: config.domain as string | undefined,\n    packages,\n    lastSync: snapshot?.timestamp,\n    envFile: checkEnvFile(projectDir),\n    parentReachable,\n  };\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,qBAAqB,CAAC,kBAAkB,cAAc;AAE5D,MAAM,wBAAwB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,eAAe,sBAAsB,aAA6C;CAChF,OAAOA,oCAAqC,8BAA8B,YAAY,UAAU;EAC9F,SAAS,EAAE,QAAQ,mBAAmB;EACtC,SAAS;CACX,CAAC,CAAC,CAAC,MAAM,SAAS,MAAM,WAAW,IAAI;AACzC;AAEA,SAAS,qBAAqB,YAAoB,aAAyC;CACzF,OAAOC,wDAA8B,YAAY,WAAW;AAC9D;AAEA,SAAS,aAAa,YAA0D;CAC9E,QAAIC,wBAAWC,gBAAK,YAAY,MAAM,CAAC,GAAG,OAAO;CACjD,QAAID,wBAAWC,gBAAK,YAAY,cAAc,CAAC,GAAG,OAAO;CACzD,OAAO;AACT;AAEA,eAAe,qBAAqB,YAA8D;CAChG,IAAI,CAAC,YAAY,WAAW,QAAQ,GAAG,OAAO;CAC9C,IAAI;EAEF,OAAO,MADcC,wCAAyB,UAAU,MACtC;CACpB,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,UAAU,YAA2C;CACzE,MAAM,WAAW,MAAMC,uCAAwB,UAAU;CACzD,IAAI,CAAC,UACH,OAAO;EACL,QAAQ;EACR,OAAO,GAAGC,sCAAuB;EACjC,UAAU,CAAC;EACX,SAAS;CACX;CAGF,MAAM,SAAS;CAEf,MAAM,eAAe,CAAC,GAAG,kBAAkB;CAC3C,KAAK,MAAM,QAAQ,uBACjB,IAAI,qBAAqB,YAAY,IAAI,GACvC,aAAa,KAAK,IAAI;CAI1B,MAAM,WAAW,MAAM,QAAQ,IAC7B,aAAa,IAAI,OAAO,SAAS;EAC/B,MAAM,WAAWC,kDAAwB,YAAY,IAAI;EACzD,MAAM,SAAS,MAAM,sBAAsB,IAAI;EAC/C,OAAO;GACL;GACA,WAAW,SAAS;GACpB,QAAQ,UAAU;GAClB,UAAU,SAAS;GACnB,WAAW,SAAS;EACtB;CACF,CAAC,CACH;CAEA,MAAM,WAAW,MAAMC,8BAAa,UAAU;CAE9C,MAAM,aAAa,OAAO;CAC1B,MAAM,kBAAkB,MAAM,qBAAqB,UAAU;CAE7D,OAAO;EACL,QAAQ;EACR,SAAS;EACT,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf;EACA,UAAU,UAAU;EACpB,SAAS,aAAa,UAAU;EAChC;CACF;AACF"}

package/dist/cli/status.mjs

@@ -1,8 +1,9 @@
 import { fetchJsonOrNull } from "../http-client.mjs";
 import { fetchBosConfigFromFastKv } from "../fastkv.mjs";
+import { MISSING_CONFIG_MESSAGE, readAuthoredConfigInput } from "../config.mjs";
 import { readSnapshot } from "./snapshot.mjs";
 import { readInstalledFrameworkVersion, resolveFrameworkPackage } from "./framework-version.mjs";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { join } from "node:path";
 
 //#region src/cli/status.ts
@@ -42,14 +43,14 @@ async function checkParentReachable(extendsRef) {
 	}
 }
 async function getStatus(projectDir) {
-	const configPath = join(projectDir, "bos.config.json");
-	if (!existsSync(configPath)) return {
+	const authored = await readAuthoredConfigInput(projectDir);
+	if (!authored) return {
 		status: "error",
-		error: "No bos.config.json found in current directory",
+		error: `${MISSING_CONFIG_MESSAGE} in current directory`,
 		packages: [],
 		envFile: "missing"
 	};
-	const config = JSON.parse(readFileSync(configPath, "utf-8"));
+	const config = authored;
 	const packageNames = [...FRAMEWORK_PACKAGES];
 	for (const name of CATALOG_TOOL_PACKAGES) if (readInstalledVersion(projectDir, name)) packageNames.push(name);
 	const packages = await Promise.all(packageNames.map(async (name) => {

package/dist/cli/status.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"status.mjs","names":[],"sources":["../../src/cli/status.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { StatusResult } from \"../contract\";\nimport { fetchBosConfigFromFastKv } from \"../fastkv\";\nimport { fetchJsonOrNull } from \"../http-client\";\nimport { readInstalledFrameworkVersion, resolveFrameworkPackage } from \"./framework-version\";\nimport { readSnapshot } from \"./snapshot\";\n\nconst FRAMEWORK_PACKAGES = [\"everything-dev\", \"every-plugin\"];\n\nconst CATALOG_TOOL_PACKAGES = [\n  \"@rspack/core\",\n  \"@rspack/cli\",\n  \"@rsbuild/core\",\n  \"@rsbuild/plugin-react\",\n  \"@module-federation/enhanced\",\n  \"@module-federation/node\",\n  \"@module-federation/rsbuild-plugin\",\n  \"@module-federation/runtime-core\",\n  \"@module-federation/sdk\",\n  \"@module-federation/dts-plugin\",\n] as const;\n\nasync function fetchLatestNpmVersion(packageName: string): Promise<string | null> {\n  return fetchJsonOrNull<{ version: string }>(`https://registry.npmjs.org/${packageName}/latest`, {\n    headers: { Accept: \"application/json\" },\n    retries: 0,\n  }).then((data) => data?.version ?? null);\n}\n\nfunction readInstalledVersion(projectDir: string, packageName: string): string | undefined {\n  return readInstalledFrameworkVersion(projectDir, packageName);\n}\n\nfunction checkEnvFile(projectDir: string): \"found\" | \"missing\" | \"example-only\" {\n  if (existsSync(join(projectDir, \".env\"))) return \"found\";\n  if (existsSync(join(projectDir, \".env.example\"))) return \"example-only\";\n  return \"missing\";\n}\n\nasync function checkParentReachable(extendsRef: string | undefined): Promise<boolean | undefined> {\n  if (!extendsRef?.startsWith(\"bos://\")) return undefined;\n  try {\n    const config = await fetchBosConfigFromFastKv(extendsRef);\n    return config !== null;\n  } catch {\n    return false;\n  }\n}\n\nexport async function getStatus(projectDir: string): Promise<StatusResult> {\n  const configPath = join(projectDir, \"bos.config.json\");\n  if (!existsSync(configPath)) {\n    return {\n      status: \"error\",\n      error: \"No bos.config.json found in current directory\",\n      packages: [],\n      envFile: \"missing\",\n    };\n  }\n\n  const config = JSON.parse(readFileSync(configPath, \"utf-8\")) as Record<string, unknown>;\n\n  const packageNames = [...FRAMEWORK_PACKAGES];\n  for (const name of CATALOG_TOOL_PACKAGES) {\n    if (readInstalledVersion(projectDir, name)) {\n      packageNames.push(name);\n    }\n  }\n\n  const packages = await Promise.all(\n    packageNames.map(async (name) => {\n      const resolved = resolveFrameworkPackage(projectDir, name);\n      const latest = await fetchLatestNpmVersion(name);\n      return {\n        name,\n        installed: resolved.installedVersion,\n        latest: latest ?? undefined,\n        isLinked: resolved.isLinked,\n        specifier: resolved.specifier,\n      };\n    }),\n  );\n\n  const snapshot = await readSnapshot(projectDir);\n\n  const extendsRef = config.extends as string | undefined;\n  const parentReachable = await checkParentReachable(extendsRef);\n\n  return {\n    status: \"ok\",\n    extends: extendsRef,\n    account: config.account as string | undefined,\n    domain: config.domain as string | undefined,\n    packages,\n    lastSync: snapshot?.timestamp,\n    envFile: checkEnvFile(projectDir),\n    parentReachable,\n  };\n}\n"],"mappings":";;;;;;;;AAQA,MAAM,qBAAqB,CAAC,kBAAkB,cAAc;AAE5D,MAAM,wBAAwB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,eAAe,sBAAsB,aAA6C;CAChF,OAAO,gBAAqC,8BAA8B,YAAY,UAAU;EAC9F,SAAS,EAAE,QAAQ,mBAAmB;EACtC,SAAS;CACX,CAAC,CAAC,CAAC,MAAM,SAAS,MAAM,WAAW,IAAI;AACzC;AAEA,SAAS,qBAAqB,YAAoB,aAAyC;CACzF,OAAO,8BAA8B,YAAY,WAAW;AAC9D;AAEA,SAAS,aAAa,YAA0D;CAC9E,IAAI,WAAW,KAAK,YAAY,MAAM,CAAC,GAAG,OAAO;CACjD,IAAI,WAAW,KAAK,YAAY,cAAc,CAAC,GAAG,OAAO;CACzD,OAAO;AACT;AAEA,eAAe,qBAAqB,YAA8D;CAChG,IAAI,CAAC,YAAY,WAAW,QAAQ,GAAG,OAAO;CAC9C,IAAI;EAEF,OAAO,MADc,yBAAyB,UAAU,MACtC;CACpB,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,UAAU,YAA2C;CACzE,MAAM,aAAa,KAAK,YAAY,iBAAiB;CACrD,IAAI,CAAC,WAAW,UAAU,GACxB,OAAO;EACL,QAAQ;EACR,OAAO;EACP,UAAU,CAAC;EACX,SAAS;CACX;CAGF,MAAM,SAAS,KAAK,MAAM,aAAa,YAAY,OAAO,CAAC;CAE3D,MAAM,eAAe,CAAC,GAAG,kBAAkB;CAC3C,KAAK,MAAM,QAAQ,uBACjB,IAAI,qBAAqB,YAAY,IAAI,GACvC,aAAa,KAAK,IAAI;CAI1B,MAAM,WAAW,MAAM,QAAQ,IAC7B,aAAa,IAAI,OAAO,SAAS;EAC/B,MAAM,WAAW,wBAAwB,YAAY,IAAI;EACzD,MAAM,SAAS,MAAM,sBAAsB,IAAI;EAC/C,OAAO;GACL;GACA,WAAW,SAAS;GACpB,QAAQ,UAAU;GAClB,UAAU,SAAS;GACnB,WAAW,SAAS;EACtB;CACF,CAAC,CACH;CAEA,MAAM,WAAW,MAAM,aAAa,UAAU;CAE9C,MAAM,aAAa,OAAO;CAC1B,MAAM,kBAAkB,MAAM,qBAAqB,UAAU;CAE7D,OAAO;EACL,QAAQ;EACR,SAAS;EACT,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf;EACA,UAAU,UAAU;EACpB,SAAS,aAAa,UAAU;EAChC;CACF;AACF"}
+{"version":3,"file":"status.mjs","names":[],"sources":["../../src/cli/status.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { MISSING_CONFIG_MESSAGE, readAuthoredConfigInput } from \"../config\";\nimport type { StatusResult } from \"../contract\";\nimport { fetchBosConfigFromFastKv } from \"../fastkv\";\nimport { fetchJsonOrNull } from \"../http-client\";\nimport { readInstalledFrameworkVersion, resolveFrameworkPackage } from \"./framework-version\";\nimport { readSnapshot } from \"./snapshot\";\n\nconst FRAMEWORK_PACKAGES = [\"everything-dev\", \"every-plugin\"];\n\nconst CATALOG_TOOL_PACKAGES = [\n  \"@rspack/core\",\n  \"@rspack/cli\",\n  \"@rsbuild/core\",\n  \"@rsbuild/plugin-react\",\n  \"@module-federation/enhanced\",\n  \"@module-federation/node\",\n  \"@module-federation/rsbuild-plugin\",\n  \"@module-federation/runtime-core\",\n  \"@module-federation/sdk\",\n  \"@module-federation/dts-plugin\",\n] as const;\n\nasync function fetchLatestNpmVersion(packageName: string): Promise<string | null> {\n  return fetchJsonOrNull<{ version: string }>(`https://registry.npmjs.org/${packageName}/latest`, {\n    headers: { Accept: \"application/json\" },\n    retries: 0,\n  }).then((data) => data?.version ?? null);\n}\n\nfunction readInstalledVersion(projectDir: string, packageName: string): string | undefined {\n  return readInstalledFrameworkVersion(projectDir, packageName);\n}\n\nfunction checkEnvFile(projectDir: string): \"found\" | \"missing\" | \"example-only\" {\n  if (existsSync(join(projectDir, \".env\"))) return \"found\";\n  if (existsSync(join(projectDir, \".env.example\"))) return \"example-only\";\n  return \"missing\";\n}\n\nasync function checkParentReachable(extendsRef: string | undefined): Promise<boolean | undefined> {\n  if (!extendsRef?.startsWith(\"bos://\")) return undefined;\n  try {\n    const config = await fetchBosConfigFromFastKv(extendsRef);\n    return config !== null;\n  } catch {\n    return false;\n  }\n}\n\nexport async function getStatus(projectDir: string): Promise<StatusResult> {\n  const authored = await readAuthoredConfigInput(projectDir);\n  if (!authored) {\n    return {\n      status: \"error\",\n      error: `${MISSING_CONFIG_MESSAGE} in current directory`,\n      packages: [],\n      envFile: \"missing\",\n    };\n  }\n\n  const config = authored as Record<string, unknown>;\n\n  const packageNames = [...FRAMEWORK_PACKAGES];\n  for (const name of CATALOG_TOOL_PACKAGES) {\n    if (readInstalledVersion(projectDir, name)) {\n      packageNames.push(name);\n    }\n  }\n\n  const packages = await Promise.all(\n    packageNames.map(async (name) => {\n      const resolved = resolveFrameworkPackage(projectDir, name);\n      const latest = await fetchLatestNpmVersion(name);\n      return {\n        name,\n        installed: resolved.installedVersion,\n        latest: latest ?? undefined,\n        isLinked: resolved.isLinked,\n        specifier: resolved.specifier,\n      };\n    }),\n  );\n\n  const snapshot = await readSnapshot(projectDir);\n\n  const extendsRef = config.extends as string | undefined;\n  const parentReachable = await checkParentReachable(extendsRef);\n\n  return {\n    status: \"ok\",\n    extends: extendsRef,\n    account: config.account as string | undefined,\n    domain: config.domain as string | undefined,\n    packages,\n    lastSync: snapshot?.timestamp,\n    envFile: checkEnvFile(projectDir),\n    parentReachable,\n  };\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,qBAAqB,CAAC,kBAAkB,cAAc;AAE5D,MAAM,wBAAwB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,eAAe,sBAAsB,aAA6C;CAChF,OAAO,gBAAqC,8BAA8B,YAAY,UAAU;EAC9F,SAAS,EAAE,QAAQ,mBAAmB;EACtC,SAAS;CACX,CAAC,CAAC,CAAC,MAAM,SAAS,MAAM,WAAW,IAAI;AACzC;AAEA,SAAS,qBAAqB,YAAoB,aAAyC;CACzF,OAAO,8BAA8B,YAAY,WAAW;AAC9D;AAEA,SAAS,aAAa,YAA0D;CAC9E,IAAI,WAAW,KAAK,YAAY,MAAM,CAAC,GAAG,OAAO;CACjD,IAAI,WAAW,KAAK,YAAY,cAAc,CAAC,GAAG,OAAO;CACzD,OAAO;AACT;AAEA,eAAe,qBAAqB,YAA8D;CAChG,IAAI,CAAC,YAAY,WAAW,QAAQ,GAAG,OAAO;CAC9C,IAAI;EAEF,OAAO,MADc,yBAAyB,UAAU,MACtC;CACpB,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,UAAU,YAA2C;CACzE,MAAM,WAAW,MAAM,wBAAwB,UAAU;CACzD,IAAI,CAAC,UACH,OAAO;EACL,QAAQ;EACR,OAAO,GAAG,uBAAuB;EACjC,UAAU,CAAC;EACX,SAAS;CACX;CAGF,MAAM,SAAS;CAEf,MAAM,eAAe,CAAC,GAAG,kBAAkB;CAC3C,KAAK,MAAM,QAAQ,uBACjB,IAAI,qBAAqB,YAAY,IAAI,GACvC,aAAa,KAAK,IAAI;CAI1B,MAAM,WAAW,MAAM,QAAQ,IAC7B,aAAa,IAAI,OAAO,SAAS;EAC/B,MAAM,WAAW,wBAAwB,YAAY,IAAI;EACzD,MAAM,SAAS,MAAM,sBAAsB,IAAI;EAC/C,OAAO;GACL;GACA,WAAW,SAAS;GACpB,QAAQ,UAAU;GAClB,UAAU,SAAS;GACnB,WAAW,SAAS;EACtB;CACF,CAAC,CACH;CAEA,MAAM,WAAW,MAAM,aAAa,UAAU;CAE9C,MAAM,aAAa,OAAO;CAC1B,MAAM,kBAAkB,MAAM,qBAAqB,UAAU;CAE7D,OAAO;EACL,QAAQ;EACR,SAAS;EACT,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf;EACA,UAAU,UAAU;EACpB,SAAS,aAAa,UAAU;EAChC;CACF;AACF"}

package/dist/cli/sync.cjs

@@ -1,13 +1,16 @@
 const require_merge = require('../merge.cjs');
 const require_config = require('../config.cjs');
-const require_shared_deps = require('../shared-deps.cjs');
-const require_infra = require('./infra.cjs');
+const require_snapshot_hash = require('../utils/snapshot-hash.cjs');
 const require_snapshot = require('./snapshot.cjs');
 const require_cli_init = require('./init.cjs');
+const require_resolution_session = require('../resolution/session.cjs');
+const require_workspace = require('../workspace.cjs');
+const require_shared_deps = require('../shared-deps.cjs');
+const require_materializer = require('../infra/materializer.cjs');
 let node_fs = require("node:fs");
 let node_path = require("node:path");
-let node_crypto = require("node:crypto");
 let glob = require("glob");
+let yaml = require("yaml");
 
 //#region src/cli/sync.ts
 const FRAMEWORK_OWNED_SYNC_FILES = /* @__PURE__ */ new Set([
@@ -15,7 +18,6 @@ const FRAMEWORK_OWNED_SYNC_FILES = /* @__PURE__ */ new Set([
 	".gitignore",
 	"biome.json",
 	"bos.config.json",
-	"bunfig.toml",
 	"package.json",
 	".changeset/config.json",
 	".changeset/README.md",
@@ -26,22 +28,11 @@ const FRAMEWORK_OWNED_SYNC_FILES = /* @__PURE__ */ new Set([
 	"railway.toml",
 	"ui/package.json",
 	"ui/postcss.config.mjs",
-	"ui/rsbuild.config.ts",
 	"ui/tsconfig.json",
-	"ui/src/app.ts",
-	"ui/src/globals.d.ts",
-	"ui/src/hydrate.tsx",
-	"ui/src/lib/api.ts",
-	"ui/src/lib/auth.ts",
-	"ui/src/router.server.tsx",
-	"ui/src/router.tsx",
-	"ui/src/routes/__root.tsx",
 	"api/package.json",
 	"api/plugin.dev.ts",
 	"api/rspack.config.js",
-	"api/tsconfig.contract.json",
 	"api/tsconfig.json",
-	"api/src/lib/auth.ts",
 	"api/src/lib/context.ts",
 	"api/drizzle.config.ts",
 	"api/src/db/index.ts",
@@ -50,14 +41,45 @@ const FRAMEWORK_OWNED_SYNC_FILES = /* @__PURE__ */ new Set([
 	"api/src/global.d.ts",
 	"api/tests/types.d.ts"
 ]);
-function computeHash(content) {
-	return (0, node_crypto.createHash)("sha256").update(content).digest("hex").substring(0, 16);
+/**
+* Files the scaffold previously sync-owned but has retired (ADR 0023) — the
+* generated `.gen` bootstrap stubs replaced them. During sync: a local copy
+* whose hash still matches the sync snapshot is deleted silently; a
+* hand-modified (or never-snapshotted) copy is backed up, then deleted. The
+* app's authored ui files (router.tsx, app.ts, lib, routes, components) are
+* NOT retired — they leave the sync list as app-owned files, untouched.
+*/
+const RETIRED_SYNC_FILES = /* @__PURE__ */ new Set([
+	"ui/src/entry.ts",
+	"ui/src/globals.d.ts",
+	"ui/src/hydrate.tsx",
+	"ui/src/router.server.tsx",
+	"ui/src/compose.ts"
+]);
+const AGENT_SYNC_GLOBS = [
+	".agents/skills/**",
+	"docs/agents/**",
+	"skills-lock.json"
+];
+function isFrameworkOwnedSyncFile(filePath) {
+	if (FRAMEWORK_OWNED_SYNC_FILES.has(filePath)) return true;
+	if (filePath.startsWith(".agents/skills/") || filePath.startsWith("docs/agents/") || filePath === "skills-lock.json") return true;
+	if (/^plugins\/[^/]+\/src\/lib\/context\.ts$/.test(filePath)) return true;
+	if (/^plugins\/[^/]+\/src\/db\/(index|layer|migrate)\.ts$/.test(filePath)) return true;
+	if (/^plugins\/[^/]+\/rspack\.config\.js$/.test(filePath)) return true;
+	if (/^plugins\/[^/]+\/drizzle\.config\.ts$/.test(filePath)) return true;
+	if (/^plugins\/[^/]+\/src\/global\.d\.ts$/.test(filePath)) return true;
+	if (/^plugins\/[^/]+\/tests\/types\.d\.ts$/.test(filePath)) return true;
+	if (/^plugins\/[^/]+\/tsconfig\.json$/.test(filePath)) return true;
+	if (/^plugins\/[^/]+\/tsconfig\.contract\.json$/.test(filePath)) return true;
+	return false;
 }
 function computeLocalHash(projectDir, filePath) {
 	const fullPath = (0, node_path.join)(projectDir, filePath);
 	if (!(0, node_fs.existsSync)(fullPath)) return null;
 	try {
-		return computeHash((0, node_fs.readFileSync)(fullPath));
+		const content = (0, node_fs.readFileSync)(fullPath);
+		return require_snapshot_hash.computeSnapshotHash(content);
 	} catch {
 		return null;
 	}
@@ -65,7 +87,8 @@ function computeLocalHash(projectDir, filePath) {
 function backupFiles(projectDir, filePaths) {
 	const filesToBackup = filePaths.filter((f) => (0, node_fs.existsSync)((0, node_path.join)(projectDir, f)));
 	if (filesToBackup.length === 0) return null;
-	const backupDir = (0, node_path.join)(projectDir, ".bos", "sync-backup", (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-"));
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+	const backupDir = (0, node_path.join)(projectDir, ".bos", "sync-backup", timestamp);
 	for (const filePath of filesToBackup) {
 		const src = (0, node_path.join)(projectDir, filePath);
 		const dest = (0, node_path.join)(backupDir, filePath);
@@ -74,9 +97,36 @@ function backupFiles(projectDir, filePaths) {
 	}
 	return backupDir;
 }
+/**
+* Migrate a child off the retired bootstrap stub files (ADR 0023): unmodified
+* copies are deleted silently, hand-modified copies are backed up first. In
+* dry-run the actions are reported without touching the tree.
+*/
+function retireSyncedFiles(projectDir, snapshotFiles, opts) {
+	const retired = [];
+	const retiredConflicted = [];
+	for (const destPath of RETIRED_SYNC_FILES) {
+		const localHash = computeLocalHash(projectDir, destPath);
+		if (localHash === null) continue;
+		if (localHash === snapshotFiles[destPath]) retired.push(destPath);
+		else retiredConflicted.push(destPath);
+	}
+	if (opts.dryRun || retired.length === 0 && retiredConflicted.length === 0) return {
+		retired,
+		retiredConflicted,
+		backupDir: null
+	};
+	const backupDir = backupFiles(projectDir, retiredConflicted);
+	for (const destPath of [...retired, ...retiredConflicted]) (0, node_fs.rmSync)((0, node_path.join)(projectDir, destPath));
+	return {
+		retired,
+		retiredConflicted,
+		backupDir
+	};
+}
 function mergeStringMaps(local, template) {
 	if (!local && !template) return void 0;
-	const merged = { ...local ?? {} };
+	const merged = { ...local };
 	for (const [name, value] of Object.entries(template ?? {})) merged[name] = value;
 	return Object.keys(merged).length > 0 ? merged : void 0;
 }
@@ -88,12 +138,12 @@ function mergeWorkspacePackages(local, template) {
 	for (const entry of templatePackages) if (typeof entry === "string" && entry.length > 0) ordered.add(entry);
 	for (const entry of localPackages) if (typeof entry === "string" && entry.length > 0) ordered.add(entry);
 	if ([...ordered].some((e) => e.startsWith("plugins/") && e !== "plugins/*")) {
-		for (const entry of [...ordered]) if (entry.startsWith("plugins/") && entry !== "plugins/*") ordered.delete(entry);
+		for (const entry of ordered) if (entry.startsWith("plugins/") && entry !== "plugins/*") ordered.delete(entry);
 		ordered.add("plugins/*");
 	}
 	return ordered.size > 0 ? [...ordered] : void 0;
 }
-function mergePackageJson(filePath, local, template) {
+function mergePackageJson(filePath, local, template, childScripts) {
 	const merged = {
 		...local,
 		...template
@@ -117,8 +167,8 @@ function mergePackageJson(filePath, local, template) {
 		if (mergedDeps) merged[depField] = mergedDeps;
 		else delete merged[depField];
 	}
-	if (local.scripts && typeof local.scripts === "object" || template.scripts && typeof template.scripts === "object") {
-		const mergedScripts = mergeStringMaps(local.scripts, template.scripts);
+	if (local.scripts && typeof local.scripts === "object" || template.scripts && typeof template.scripts === "object" || childScripts) {
+		const mergedScripts = mergeStringMaps(local.scripts, filePath === "package.json" && childScripts ? childScripts : template.scripts);
 		if (mergedScripts) merged.scripts = mergedScripts;
 		else delete merged.scripts;
 	}
@@ -145,10 +195,11 @@ function toSourcePath(sourceDir, destPath) {
 		const templatePath = destPath.replace(/^\.github\//, ".github/templates/");
 		if ((0, node_fs.existsSync)((0, node_path.join)(sourceDir, templatePath))) return templatePath;
 	}
-	if ((0, node_fs.existsSync)((0, node_path.join)(sourceDir, destPath))) return destPath;
+	const directPath = (0, node_path.join)(sourceDir, destPath);
+	if ((0, node_fs.existsSync)(directPath)) return destPath;
 	return null;
 }
-function buildSyncedFileContent(sourceDir, projectDir, filePath, explicitDestPath) {
+function buildSyncedFileContent(sourceDir, projectDir, filePath, explicitDestPath, childScripts) {
 	const src = (0, node_path.join)(sourceDir, filePath);
 	const destPath = explicitDestPath ?? (filePath.startsWith(".github/templates/") ? filePath.replace(/^\.github\/templates\//, ".github/") : filePath);
 	const dest = (0, node_path.join)(projectDir, destPath);
@@ -156,7 +207,9 @@ function buildSyncedFileContent(sourceDir, projectDir, filePath, explicitDestPat
 		const localContent = (0, node_fs.existsSync)(dest) ? (0, node_fs.readFileSync)(dest, "utf-8") : null;
 		const templateContent = (0, node_fs.readFileSync)(src, "utf-8");
 		if (localContent) {
-			const merged = require_merge.mergeBosConfigWithTemplate(JSON.parse(localContent), JSON.parse(templateContent));
+			const local = JSON.parse(localContent);
+			const template = JSON.parse(templateContent);
+			const merged = require_merge.mergeBosConfigWithTemplate(local, template);
 			return `${JSON.stringify(merged, null, 2)}\n`;
 		}
 	}
@@ -164,17 +217,17 @@ function buildSyncedFileContent(sourceDir, projectDir, filePath, explicitDestPat
 		const localContent = (0, node_fs.existsSync)(dest) ? (0, node_fs.readFileSync)(dest, "utf-8") : null;
 		const templateContent = (0, node_fs.readFileSync)(src, "utf-8");
 		if (localContent) {
-			const merged = mergePackageJson(destPath, JSON.parse(localContent), JSON.parse(templateContent));
+			const merged = mergePackageJson(destPath, JSON.parse(localContent), JSON.parse(templateContent), childScripts);
 			return `${JSON.stringify(merged, null, 2)}\n`;
 		}
 	}
 	return (0, node_fs.readFileSync)(src);
 }
-function writeSyncedFile(sourceDir, projectDir, filePath, explicitDestPath) {
+function writeSyncedFile(sourceDir, projectDir, filePath, explicitDestPath, childScripts) {
 	const destPath = explicitDestPath ?? (filePath.startsWith(".github/templates/") ? filePath.replace(/^\.github\/templates\//, ".github/") : filePath);
 	const dest = (0, node_path.join)(projectDir, destPath);
 	(0, node_fs.mkdirSync)((0, node_path.dirname)(dest), { recursive: true });
-	(0, node_fs.writeFileSync)(dest, buildSyncedFileContent(sourceDir, projectDir, filePath, destPath));
+	(0, node_fs.writeFileSync)(dest, buildSyncedFileContent(sourceDir, projectDir, filePath, destPath, childScripts));
 }
 async function getSelectedChildPlugins(projectDir, localConfig) {
 	if (!localConfig.plugins || typeof localConfig.plugins !== "object") return [];
@@ -191,7 +244,8 @@ async function getSelectedChildPlugins(projectDir, localConfig) {
 				selected.push(pluginKey);
 				continue;
 			}
-			if ((0, node_fs.existsSync)((0, node_path.join)(projectDir, rawEntry.slice(6).trim())) || pluginDirs.has(pluginKey)) selected.push(pluginKey);
+			const localPath = (0, node_path.join)(projectDir, rawEntry.slice(6).trim());
+			if ((0, node_fs.existsSync)(localPath) || pluginDirs.has(pluginKey)) selected.push(pluginKey);
 			continue;
 		}
 		if (!rawEntry || typeof rawEntry !== "object") {
@@ -204,22 +258,31 @@ async function getSelectedChildPlugins(projectDir, localConfig) {
 			selected.push(pluginKey);
 			continue;
 		}
-		if ((0, node_fs.existsSync)((0, node_path.join)(projectDir, development.slice(6).trim())) || pluginDirs.has(pluginKey)) selected.push(pluginKey);
+		const localPath = (0, node_path.join)(projectDir, development.slice(6).trim());
+		if ((0, node_fs.existsSync)(localPath) || pluginDirs.has(pluginKey)) selected.push(pluginKey);
 	}
 	return selected;
 }
 function hasPluginsWorkspace(projectDir) {
-	const packageJsonPath = (0, node_path.join)(projectDir, "package.json");
-	if (!(0, node_fs.existsSync)(packageJsonPath)) return false;
-	try {
-		const workspaces = JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8")).workspaces;
-		return (Array.isArray(workspaces) ? workspaces : Array.isArray(workspaces?.packages) ? workspaces.packages : []).includes("plugins/*");
-	} catch {
-		return false;
+	const root = require_workspace.findWorkspaceRoot(projectDir);
+	if (!root) return false;
+	const rel = (0, node_path.relative)(root.dir, projectDir);
+	const baseDir = rel.startsWith("..") || rel === "" ? root.dir : projectDir;
+	for (const manifest of ["pnpm-workspace.yaml", "package.json"]) {
+		const manifestPath = (0, node_path.join)(baseDir, manifest);
+		if (!(0, node_fs.existsSync)(manifestPath)) continue;
+		try {
+			const content = (0, node_fs.readFileSync)(manifestPath, "utf-8");
+			const packages = manifest === "pnpm-workspace.yaml" ? (0, yaml.parse)(content)?.packages : JSON.parse(content).workspaces;
+			if ((Array.isArray(packages) ? packages : Array.isArray(packages?.packages) ? packages.packages : []).includes("plugins/*")) return true;
+		} catch {
+			return false;
+		}
 	}
+	return false;
 }
 async function syncTemplate(projectDir, options) {
-	const localConfig = JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(projectDir, "bos.config.json"), "utf-8"));
+	const localConfig = (0, node_fs.existsSync)((0, node_path.join)(projectDir, "bos.app.ts")) ? await require_config.loadAppDescriptorConfig((0, node_path.join)(projectDir, "bos.app.ts")) : JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(projectDir, "bos.config.json"), "utf-8"));
 	let extendsRef;
 	if (typeof localConfig.extends === "string") extendsRef = localConfig.extends;
 	else if (require_merge.isPlainObject(localConfig.extends)) extendsRef = require_merge.resolveExtendsRef(localConfig.extends, "production");
@@ -252,8 +315,16 @@ async function syncTemplate(projectDir, options) {
 		const withApi = (0, node_fs.existsSync)((0, node_path.join)(projectDir, "api", "package.json"));
 		const withHost = (0, node_fs.existsSync)((0, node_path.join)(projectDir, "host", "package.json"));
 		const withPlugins = childPlugins.length > 0 || hasPluginsWorkspace(projectDir);
+		const childScripts = require_cli_init.buildChildRootScripts({
+			ui: withUi,
+			api: withApi,
+			host: withHost,
+			plugins: withPlugins
+		});
 		const destToSource = /* @__PURE__ */ new Map();
+		const tsFormChild = !(0, node_fs.existsSync)((0, node_path.join)(projectDir, "bos.config.json"));
 		for (const destPath of FRAMEWORK_OWNED_SYNC_FILES) {
+			if (destPath === "bos.config.json" && tsFormChild) continue;
 			if (destPath.startsWith("ui/") && !withUi) continue;
 			if (destPath.startsWith("api/") && !withApi) continue;
 			if (destPath.startsWith("host/") && !withHost) continue;
@@ -261,6 +332,18 @@ async function syncTemplate(projectDir, options) {
 			if (!sourcePath) continue;
 			destToSource.set(destPath, sourcePath);
 		}
+		for (const destPath of await (0, glob.glob)(AGENT_SYNC_GLOBS, {
+			cwd: sourceDir,
+			nodir: true,
+			dot: true,
+			absolute: false,
+			ignore: [
+				"**/node_modules/**",
+				"**/.git/**",
+				"**/dist/**",
+				"**/.bos/**"
+			]
+		})) destToSource.set(destPath, destPath);
 		for (const pluginKey of childPlugins) {
 			if (!(0, node_fs.existsSync)((0, node_path.join)(projectDir, "plugins", pluginKey, "src"))) continue;
 			for (const libFile of ["auth.ts", "context.ts"]) {
@@ -307,11 +390,9 @@ async function syncTemplate(projectDir, options) {
 		}
 		for (const pluginKey of childPlugins) {
 			if (!(0, node_fs.existsSync)((0, node_path.join)(projectDir, "plugins", pluginKey))) continue;
-			for (const tsconfigFile of ["tsconfig.json", "tsconfig.contract.json"]) {
-				const sourceFile = `plugins/_template/${tsconfigFile}`;
-				if (!(0, node_fs.existsSync)((0, node_path.join)(sourceDir, sourceFile))) continue;
-				destToSource.set(`plugins/${pluginKey}/${tsconfigFile}`, sourceFile);
-			}
+			const sourceFile = "plugins/_template/tsconfig.json";
+			if (!(0, node_fs.existsSync)((0, node_path.join)(sourceDir, sourceFile))) continue;
+			destToSource.set(`plugins/${pluginKey}/tsconfig.json`, sourceFile);
 		}
 		const updated = [];
 		const skipped = [];
@@ -319,8 +400,12 @@ async function syncTemplate(projectDir, options) {
 		const conflicted = [];
 		const snapshotFiles = (await require_snapshot.readSnapshot(projectDir))?.files ?? {};
 		for (const [destPath, filePath] of destToSource.entries()) {
+			if (!(0, node_fs.existsSync)((0, node_path.join)(sourceDir, filePath))) {
+				skipped.push(destPath);
+				continue;
+			}
 			const localHash = computeLocalHash(projectDir, destPath);
-			const sourceHash = computeHash(buildSyncedFileContent(sourceDir, projectDir, filePath));
+			const sourceHash = require_snapshot_hash.computeSnapshotHash(buildSyncedFileContent(sourceDir, projectDir, filePath, void 0, childScripts));
 			if (localHash === null) {
 				added.push(destPath);
 				continue;
@@ -354,32 +439,38 @@ async function syncTemplate(projectDir, options) {
 		if (options.dryRun) {
 			const agentsMdSourcePath = toSourcePath(sourceDir, "AGENTS.md");
 			if (agentsMdSourcePath) {
-				const skillsBlock = require_cli_init.extractSkillsBlock((0, node_fs.readFileSync)((0, node_path.join)(sourceDir, agentsMdSourcePath), "utf-8"));
+				const agentsMdSourceContent = (0, node_fs.readFileSync)((0, node_path.join)(sourceDir, agentsMdSourcePath), "utf-8");
+				const skillsBlock = require_cli_init.extractSkillsBlock(agentsMdSourceContent);
 				if (skillsBlock) {
-					const expectedHash = computeHash(require_cli_init.buildChildAgentsMd(skillsBlock, {
+					const expectedContent = require_cli_init.buildChildAgentsMd(skillsBlock, {
 						overrides,
 						plugins: childPlugins
-					}));
+					});
+					const expectedHash = require_snapshot_hash.computeSnapshotHash(expectedContent);
 					if (computeLocalHash(projectDir, "AGENTS.md") !== expectedHash) updated.push("AGENTS.md");
 				}
 			}
+			const retirement = retireSyncedFiles(projectDir, snapshotFiles, { dryRun: true });
 			return {
 				status: "dry-run",
 				updated,
 				skipped,
 				added,
-				conflicted
+				conflicted,
+				retired: retirement.retired,
+				retiredConflicted: retirement.retiredConflicted
 			};
 		}
+		const retirement = retireSyncedFiles(projectDir, snapshotFiles, { dryRun: false });
 		const filesToWrite = [
 			...updated,
 			...added,
 			...conflicted
 		];
-		let backupDir;
+		let backupDir = retirement.backupDir ?? void 0;
 		if (filesToWrite.length > 0) {
-			backupDir = backupFiles(projectDir, filesToWrite) ?? void 0;
-			for (const destPath of filesToWrite) writeSyncedFile(sourceDir, projectDir, destToSource.get(destPath) ?? destPath, destPath);
+			backupDir = backupFiles(projectDir, filesToWrite) ?? backupDir;
+			for (const destPath of filesToWrite) writeSyncedFile(sourceDir, projectDir, destToSource.get(destPath) ?? destPath, destPath, childScripts);
 		}
 		await require_cli_init.personalizeConfig(projectDir, {
 			extendsAccount,
@@ -396,8 +487,8 @@ async function syncTemplate(projectDir, options) {
 			configDir: projectDir,
 			hostMode: "local"
 		});
-		const syncedConfig = await require_config.loadResolvedConfig({ cwd: projectDir });
-		if (syncedConfig?.runtime) require_infra.writeGeneratedInfra(projectDir, syncedConfig.runtime);
+		const syncedConfig = await require_resolution_session.openResolution({ cwd: projectDir });
+		if (syncedConfig?.runtime) await require_materializer.materializeViaLayer(projectDir, syncedConfig.runtime);
 		const newSnapshotFiles = {};
 		for (const destPath of destToSource.keys()) {
 			const hash = computeLocalHash(projectDir, destPath);
@@ -405,13 +496,14 @@ async function syncTemplate(projectDir, options) {
 		}
 		const agentsMdSourcePath = toSourcePath(sourceDir, "AGENTS.md");
 		if (agentsMdSourcePath) {
-			const skillsBlock = require_cli_init.extractSkillsBlock((0, node_fs.readFileSync)((0, node_path.join)(sourceDir, agentsMdSourcePath), "utf-8"));
+			const agentsMdSourceContent = (0, node_fs.readFileSync)((0, node_path.join)(sourceDir, agentsMdSourcePath), "utf-8");
+			const skillsBlock = require_cli_init.extractSkillsBlock(agentsMdSourceContent);
 			if (skillsBlock) {
 				const expectedContent = require_cli_init.buildChildAgentsMd(skillsBlock, {
 					overrides,
 					plugins: childPlugins
 				});
-				const expectedHash = computeHash(expectedContent);
+				const expectedHash = require_snapshot_hash.computeSnapshotHash(expectedContent);
 				if (computeLocalHash(projectDir, "AGENTS.md") !== expectedHash) {
 					(0, node_fs.writeFileSync)((0, node_path.join)(projectDir, "AGENTS.md"), expectedContent);
 					updated.push("AGENTS.md");
@@ -424,7 +516,7 @@ async function syncTemplate(projectDir, options) {
 			files: newSnapshotFiles
 		});
 		if (!options.noInstall) {
-			await require_cli_init.runBunInstall(projectDir);
+			await require_cli_init.runPnpmInstall(require_workspace.findWorkspaceRoot(projectDir)?.dir ?? projectDir);
 			await require_cli_init.runTypesGen(projectDir);
 		}
 		return {
@@ -433,6 +525,9 @@ async function syncTemplate(projectDir, options) {
 			skipped,
 			added,
 			conflicted,
+			retired: retirement.retired,
+			retiredConflicted: retirement.retiredConflicted,
+			retiredBackupDir: retirement.backupDir ?? void 0,
 			backupDir
 		};
 	} finally {
@@ -441,6 +536,9 @@ async function syncTemplate(projectDir, options) {
 }
 
 //#endregion
+exports.RETIRED_SYNC_FILES = RETIRED_SYNC_FILES;
+exports.isFrameworkOwnedSyncFile = isFrameworkOwnedSyncFile;
 exports.mergePackageJson = mergePackageJson;
+exports.retireSyncedFiles = retireSyncedFiles;
 exports.syncTemplate = syncTemplate;
 //# sourceMappingURL=sync.cjs.map