everything-dev 1.53.1 → 2.0.0-rc.0

package/dist/cli/sync.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sync.cjs","names":["mergeBosConfigWithTemplate","isPlainObjectFromMerge","resolveExtendsRef","resolveSourceDir","readSnapshot","extractSkillsBlock","buildChildAgentsMd","personalizeConfig","syncResolvedSharedDeps","loadResolvedConfig","writeSnapshot","runBunInstall","runTypesGen"],"sources":["../../src/cli/sync.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { glob } from \"glob\";\nimport { loadResolvedConfig } from \"../config\";\nimport type { SyncOptions, SyncResult } from \"../contract\";\nimport {\n  isPlainObject as isPlainObjectFromMerge,\n  mergeBosConfigWithTemplate,\n  resolveExtendsRef,\n} from \"../merge\";\nimport { syncResolvedSharedDeps } from \"../shared-deps\";\nimport { writeGeneratedInfra } from \"./infra\";\nimport {\n  buildChildAgentsMd,\n  extractSkillsBlock,\n  personalizeConfig,\n  resolveSourceDir,\n  runBunInstall,\n  runTypesGen,\n} from \"./init\";\nimport { readSnapshot, writeSnapshot } from \"./snapshot\";\n\nconst FRAMEWORK_OWNED_SYNC_FILES = new Set([\n  \".env.example\",\n  \".gitignore\",\n  \"biome.json\",\n  \"bos.config.json\",\n  \"bunfig.toml\",\n  \"package.json\",\n  \".changeset/config.json\",\n  \".changeset/README.md\",\n  \".github/workflows/ci.yml\",\n  \".github/workflows/deploy.yml\",\n  \".github/workflows/staging.yml\",\n  \".github/workflows/release.yml\",\n  \"railway.toml\",\n  \"ui/package.json\",\n  \"ui/postcss.config.mjs\",\n  \"ui/rsbuild.config.ts\",\n  \"ui/tsconfig.json\",\n  \"ui/src/app.ts\",\n  \"ui/src/globals.d.ts\",\n  \"ui/src/hydrate.tsx\",\n  \"ui/src/lib/api.ts\",\n  \"ui/src/lib/auth.ts\",\n  \"ui/src/router.server.tsx\",\n  \"ui/src/router.tsx\",\n  \"ui/src/routes/__root.tsx\",\n  \"api/package.json\",\n  \"api/plugin.dev.ts\",\n  \"api/rspack.config.js\",\n  \"api/tsconfig.contract.json\",\n  \"api/tsconfig.json\",\n  \"api/src/lib/auth.ts\",\n  \"api/src/lib/context.ts\",\n  \"api/drizzle.config.ts\",\n  \"api/src/db/index.ts\",\n  \"api/src/db/layer.ts\",\n  \"api/src/db/migrate.ts\",\n  \"api/src/global.d.ts\",\n  \"api/tests/types.d.ts\",\n]);\n\ntype PackageJson = Record<string, unknown>;\n\nfunction computeHash(content: string | Uint8Array): string {\n  return createHash(\"sha256\").update(content).digest(\"hex\").substring(0, 16);\n}\n\nexport function isFrameworkOwnedSyncFile(filePath: string): boolean {\n  if (FRAMEWORK_OWNED_SYNC_FILES.has(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/src\\/lib\\/(auth|context)\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/src\\/db\\/(index|layer|migrate)\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/rspack\\.config\\.js$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/drizzle\\.config\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/src\\/global\\.d\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/tests\\/types\\.d\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/tsconfig\\.json$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/tsconfig\\.contract\\.json$/.test(filePath)) return true;\n  return false;\n}\n\nfunction computeLocalHash(projectDir: string, filePath: string): string | null {\n  const fullPath = join(projectDir, filePath);\n  if (!existsSync(fullPath)) return null;\n  try {\n    const content = readFileSync(fullPath);\n    return computeHash(content);\n  } catch {\n    return null;\n  }\n}\n\nfunction backupFiles(projectDir: string, filePaths: string[]): string | null {\n  const filesToBackup = filePaths.filter((f) => existsSync(join(projectDir, f)));\n  if (filesToBackup.length === 0) return null;\n\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const backupDir = join(projectDir, \".bos\", \"sync-backup\", timestamp);\n\n  for (const filePath of filesToBackup) {\n    const src = join(projectDir, filePath);\n    const dest = join(backupDir, filePath);\n    mkdirSync(dirname(dest), { recursive: true });\n    copyFileSync(src, dest);\n  }\n\n  return backupDir;\n}\n\nfunction mergeStringMaps(\n  local: Record<string, string> | undefined,\n  template: Record<string, string> | undefined,\n): Record<string, string> | undefined {\n  if (!local && !template) return undefined;\n\n  const merged: Record<string, string> = { ...(local ?? {}) };\n  for (const [name, value] of Object.entries(template ?? {})) {\n    merged[name] = value;\n  }\n\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\nfunction mergeWorkspacePackages(local: unknown, template: unknown): string[] | undefined {\n  const localPackages = Array.isArray(local) ? local : [];\n  const templatePackages = Array.isArray(template) ? template : [];\n  if (localPackages.length === 0 && templatePackages.length === 0) return undefined;\n\n  const ordered = new Set<string>();\n  for (const entry of templatePackages) {\n    if (typeof entry === \"string\" && entry.length > 0) ordered.add(entry);\n  }\n  for (const entry of localPackages) {\n    if (typeof entry === \"string\" && entry.length > 0) ordered.add(entry);\n  }\n\n  const hasPluginEntry = [...ordered].some((e) => e.startsWith(\"plugins/\") && e !== \"plugins/*\");\n  if (hasPluginEntry) {\n    for (const entry of [...ordered]) {\n      if (entry.startsWith(\"plugins/\") && entry !== \"plugins/*\") {\n        ordered.delete(entry);\n      }\n    }\n    ordered.add(\"plugins/*\");\n  }\n\n  return ordered.size > 0 ? [...ordered] : undefined;\n}\n\nexport function mergePackageJson(\n  filePath: string,\n  local: PackageJson,\n  template: PackageJson,\n): PackageJson {\n  const merged: PackageJson = { ...local, ...template };\n\n  if (filePath === \"package.json\") {\n    for (const key of [\"name\", \"private\", \"version\"] as const) {\n      if (key in local) {\n        merged[key] = local[key];\n      }\n    }\n  } else if (\"version\" in local) {\n    merged.version = local.version;\n  }\n\n  for (const depField of [\n    \"dependencies\",\n    \"devDependencies\",\n    \"peerDependencies\",\n    \"overrides\",\n  ] as const) {\n    const localDeps = local[depField] as Record<string, string> | undefined;\n    const templateDeps = template[depField] as Record<string, string> | undefined;\n\n    const mergedDeps = mergeStringMaps(localDeps, templateDeps);\n    if (mergedDeps) {\n      merged[depField] = mergedDeps;\n    } else {\n      delete merged[depField];\n    }\n  }\n\n  if (\n    (local.scripts && typeof local.scripts === \"object\") ||\n    (template.scripts && typeof template.scripts === \"object\")\n  ) {\n    const mergedScripts = mergeStringMaps(\n      local.scripts as Record<string, string> | undefined,\n      template.scripts as Record<string, string> | undefined,\n    );\n    if (mergedScripts) {\n      merged.scripts = mergedScripts;\n    } else {\n      delete merged.scripts;\n    }\n  }\n\n  if (\n    (local.workspaces && typeof local.workspaces === \"object\") ||\n    (template.workspaces && typeof template.workspaces === \"object\")\n  ) {\n    const localWorkspaces = (local.workspaces ?? {}) as {\n      packages?: string[];\n      catalog?: Record<string, string>;\n    };\n    const templateWorkspaces = (template.workspaces ?? {}) as {\n      packages?: string[];\n      catalog?: Record<string, string>;\n    };\n\n    const mergedWorkspaces: { packages?: string[]; catalog?: Record<string, string> } = {\n      ...localWorkspaces,\n      ...templateWorkspaces,\n    };\n\n    const mergedPackages = mergeWorkspacePackages(\n      localWorkspaces.packages,\n      templateWorkspaces.packages,\n    );\n    if (mergedPackages) {\n      mergedWorkspaces.packages = mergedPackages;\n    } else {\n      delete mergedWorkspaces.packages;\n    }\n\n    const mergedCatalog = mergeStringMaps(localWorkspaces.catalog, templateWorkspaces.catalog);\n    if (mergedCatalog) {\n      mergedWorkspaces.catalog = mergedCatalog;\n    } else {\n      delete mergedWorkspaces.catalog;\n    }\n\n    if (Object.keys(mergedWorkspaces).length > 0) {\n      merged.workspaces = mergedWorkspaces;\n    } else {\n      delete merged.workspaces;\n    }\n  }\n\n  return merged;\n}\n\nfunction toSourcePath(sourceDir: string, destPath: string): string | null {\n  if (destPath.startsWith(\".github/\")) {\n    const templatePath = destPath.replace(/^\\.github\\//, \".github/templates/\");\n    if (existsSync(join(sourceDir, templatePath))) {\n      return templatePath;\n    }\n  }\n\n  const directPath = join(sourceDir, destPath);\n  if (existsSync(directPath)) {\n    return destPath;\n  }\n\n  return null;\n}\n\nfunction buildSyncedFileContent(\n  sourceDir: string,\n  projectDir: string,\n  filePath: string,\n  explicitDestPath?: string,\n): string | Uint8Array {\n  const src = join(sourceDir, filePath);\n  const destPath =\n    explicitDestPath ??\n    (filePath.startsWith(\".github/templates/\")\n      ? filePath.replace(/^\\.github\\/templates\\//, \".github/\")\n      : filePath);\n  const dest = join(projectDir, destPath);\n\n  if (filePath.endsWith(\"bos.config.json\")) {\n    const localContent = existsSync(dest) ? readFileSync(dest, \"utf-8\") : null;\n    const templateContent = readFileSync(src, \"utf-8\");\n\n    if (localContent) {\n      const local = JSON.parse(localContent) as Record<string, unknown>;\n      const template = JSON.parse(templateContent) as Record<string, unknown>;\n      const merged = mergeBosConfigWithTemplate(local, template);\n      return `${JSON.stringify(merged, null, 2)}\\n`;\n    }\n  }\n\n  if (filePath.endsWith(\"package.json\")) {\n    const localContent = existsSync(dest) ? readFileSync(dest, \"utf-8\") : null;\n    const templateContent = readFileSync(src, \"utf-8\");\n\n    if (localContent) {\n      const local = JSON.parse(localContent) as Record<string, unknown>;\n      const template = JSON.parse(templateContent) as Record<string, unknown>;\n      const merged = mergePackageJson(destPath, local, template);\n      return `${JSON.stringify(merged, null, 2)}\\n`;\n    }\n  }\n\n  return readFileSync(src);\n}\n\nfunction writeSyncedFile(\n  sourceDir: string,\n  projectDir: string,\n  filePath: string,\n  explicitDestPath?: string,\n): void {\n  const destPath =\n    explicitDestPath ??\n    (filePath.startsWith(\".github/templates/\")\n      ? filePath.replace(/^\\.github\\/templates\\//, \".github/\")\n      : filePath);\n  const dest = join(projectDir, destPath);\n  mkdirSync(dirname(dest), { recursive: true });\n  writeFileSync(dest, buildSyncedFileContent(sourceDir, projectDir, filePath, destPath));\n}\n\nasync function getSelectedChildPlugins(\n  projectDir: string,\n  localConfig: Record<string, unknown>,\n): Promise<string[]> {\n  if (!localConfig.plugins || typeof localConfig.plugins !== \"object\") {\n    return [];\n  }\n\n  const pluginDirs = new Set(\n    (\n      await glob(\"plugins/*/package.json\", {\n        cwd: projectDir,\n        nodir: true,\n        dot: false,\n        absolute: false,\n      })\n    )\n      .map((file) => file.match(/^plugins\\/([^/]+)\\/package\\.json$/)?.[1])\n      .filter((key): key is string => Boolean(key)),\n  );\n\n  const selected: string[] = [];\n  for (const [pluginKey, rawEntry] of Object.entries(\n    localConfig.plugins as Record<string, unknown>,\n  )) {\n    if (typeof rawEntry === \"string\") {\n      if (!rawEntry.startsWith(\"local:\")) {\n        selected.push(pluginKey);\n        continue;\n      }\n\n      const localPath = join(projectDir, rawEntry.slice(\"local:\".length).trim());\n      if (existsSync(localPath) || pluginDirs.has(pluginKey)) {\n        selected.push(pluginKey);\n      }\n      continue;\n    }\n\n    if (!rawEntry || typeof rawEntry !== \"object\") {\n      selected.push(pluginKey);\n      continue;\n    }\n\n    const entry = rawEntry as Record<string, unknown>;\n    const development = typeof entry.development === \"string\" ? entry.development : undefined;\n    if (!development?.startsWith(\"local:\")) {\n      selected.push(pluginKey);\n      continue;\n    }\n\n    const localPath = join(projectDir, development.slice(\"local:\".length).trim());\n    if (existsSync(localPath) || pluginDirs.has(pluginKey)) {\n      selected.push(pluginKey);\n    }\n  }\n\n  return selected;\n}\n\nfunction hasPluginsWorkspace(projectDir: string): boolean {\n  const packageJsonPath = join(projectDir, \"package.json\");\n  if (!existsSync(packageJsonPath)) return false;\n\n  try {\n    const pkg = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as {\n      workspaces?: { packages?: string[] } | string[];\n    };\n    const workspaces = pkg.workspaces;\n    const packages = Array.isArray(workspaces)\n      ? workspaces\n      : Array.isArray(workspaces?.packages)\n        ? workspaces.packages\n        : [];\n    return packages.includes(\"plugins/*\");\n  } catch {\n    return false;\n  }\n}\n\nexport async function syncTemplate(projectDir: string, options: SyncOptions): Promise<SyncResult> {\n  // Sync reads the raw bos.config.json (not the resolved config) because it needs\n  // the user's explicit local settings: their extends ref, selected plugins, etc.\n  // The resolved config is the merged result and would include inherited parent\n  // values that the user didn't explicitly choose, which would break sync filtering.\n  const localConfig = JSON.parse(\n    readFileSync(join(projectDir, \"bos.config.json\"), \"utf-8\"),\n  ) as Record<string, unknown>;\n\n  let extendsRef: string | undefined;\n  if (typeof localConfig.extends === \"string\") {\n    extendsRef = localConfig.extends;\n  } else if (isPlainObjectFromMerge(localConfig.extends)) {\n    extendsRef = resolveExtendsRef(localConfig.extends as Record<string, string>, \"production\");\n  }\n  if (!extendsRef?.startsWith(\"bos://\")) {\n    return {\n      status: \"error\",\n      updated: [],\n      skipped: [],\n      added: [],\n      conflicted: [],\n      error: \"No extends field found in bos.config.json — cannot determine parent\",\n    };\n  }\n\n  const extendsMatch = extendsRef.match(/^bos:\\/\\/([^/]+)\\/(.+)$/);\n  if (!extendsMatch) {\n    return {\n      status: \"error\",\n      updated: [],\n      skipped: [],\n      added: [],\n      conflicted: [],\n      error: `Invalid extends reference: ${extendsRef}`,\n    };\n  }\n\n  const extendsAccount = extendsMatch[1];\n  const extendsGateway = extendsMatch[2];\n\n  const { sourceDir, cleanup } = await resolveSourceDir({\n    extendsAccount,\n    extendsGateway,\n  });\n\n  try {\n    const childPlugins = await getSelectedChildPlugins(projectDir, localConfig);\n    const withUi = existsSync(join(projectDir, \"ui\", \"package.json\"));\n    const withApi = existsSync(join(projectDir, \"api\", \"package.json\"));\n    const withHost = existsSync(join(projectDir, \"host\", \"package.json\"));\n    const withPlugins = childPlugins.length > 0 || hasPluginsWorkspace(projectDir);\n\n    const destToSource = new Map<string, string>();\n    for (const destPath of FRAMEWORK_OWNED_SYNC_FILES) {\n      if (destPath.startsWith(\"ui/\") && !withUi) continue;\n      if (destPath.startsWith(\"api/\") && !withApi) continue;\n      if (destPath.startsWith(\"host/\") && !withHost) continue;\n      const sourcePath = toSourcePath(sourceDir, destPath);\n      if (!sourcePath) continue;\n      destToSource.set(destPath, sourcePath);\n    }\n\n    // Sync api/src/lib/{auth,context}.ts into each plugin's src/lib/\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey, \"src\"))) continue;\n      for (const libFile of [\"auth.ts\", \"context.ts\"]) {\n        const sourceFile = `api/src/lib/${libFile}`;\n        if (!existsSync(join(sourceDir, sourceFile))) continue;\n        destToSource.set(`plugins/${pluginKey}/src/lib/${libFile}`, sourceFile);\n      }\n    }\n\n    // Sync api/src/global.d.ts into each plugin's src/\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey, \"src\"))) continue;\n      const sourceFile = \"api/src/global.d.ts\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/src/global.d.ts`, sourceFile);\n    }\n\n    // Sync tests/types.d.ts into each plugin's tests/\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey))) continue;\n      const sourceFile = \"plugins/_template/tests/types.d.ts\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/tests/types.d.ts`, sourceFile);\n    }\n\n    // Sync api/src/db/{index,layer,migrate}.ts into each plugin's src/db/\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey, \"src\", \"db\"))) continue;\n      for (const dbFile of [\"index.ts\", \"layer.ts\", \"migrate.ts\"]) {\n        const sourceFile = `api/src/db/${dbFile}`;\n        if (!existsSync(join(sourceDir, sourceFile))) continue;\n        destToSource.set(`plugins/${pluginKey}/src/db/${dbFile}`, sourceFile);\n      }\n    }\n\n    // Sync rspack.config.js from the template into each plugin\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey))) continue;\n      const sourceFile = \"plugins/_template/rspack.config.js\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/rspack.config.js`, sourceFile);\n    }\n\n    // Sync drizzle.config.ts from api into each DB-enabled plugin\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey, \"src\", \"db\"))) continue;\n      const sourceFile = \"api/drizzle.config.ts\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/drizzle.config.ts`, sourceFile);\n    }\n\n    // Sync tsconfig files from the template into each plugin\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey))) continue;\n      for (const tsconfigFile of [\"tsconfig.json\", \"tsconfig.contract.json\"]) {\n        const sourceFile = `plugins/_template/${tsconfigFile}`;\n        if (!existsSync(join(sourceDir, sourceFile))) continue;\n        destToSource.set(`plugins/${pluginKey}/${tsconfigFile}`, sourceFile);\n      }\n    }\n\n    const updated: string[] = [];\n    const skipped: string[] = [];\n    const added: string[] = [];\n    const conflicted: string[] = [];\n\n    const snapshot = await readSnapshot(projectDir);\n    const snapshotFiles = snapshot?.files ?? {};\n\n    for (const [destPath, filePath] of destToSource.entries()) {\n      const localHash = computeLocalHash(projectDir, destPath);\n      const sourceHash = computeHash(buildSyncedFileContent(sourceDir, projectDir, filePath));\n\n      if (localHash === null) {\n        added.push(destPath);\n        continue;\n      }\n\n      if (localHash === sourceHash) {\n        skipped.push(destPath);\n        continue;\n      }\n\n      const snapshotHash = snapshotFiles[destPath];\n      if (!snapshotHash) {\n        updated.push(destPath);\n        continue;\n      }\n\n      if (localHash === snapshotHash) {\n        updated.push(destPath);\n        continue;\n      }\n\n      if (sourceHash === snapshotHash) {\n        skipped.push(destPath);\n        continue;\n      }\n\n      conflicted.push(destPath);\n    }\n\n    const account = (localConfig.account as string) || extendsAccount;\n    const domain = (localConfig.domain as string) || extendsGateway;\n    const overrides: Array<\"ui\" | \"api\" | \"host\" | \"plugins\"> = [];\n    if (withUi) overrides.push(\"ui\");\n    if (withApi) overrides.push(\"api\");\n    if (withHost) overrides.push(\"host\");\n    if (withPlugins) overrides.push(\"plugins\");\n\n    if (options.dryRun) {\n      const agentsMdSourcePath = toSourcePath(sourceDir, \"AGENTS.md\");\n      if (agentsMdSourcePath) {\n        const agentsMdSourceContent = readFileSync(join(sourceDir, agentsMdSourcePath), \"utf-8\");\n        const skillsBlock = extractSkillsBlock(agentsMdSourceContent);\n        if (skillsBlock) {\n          const expectedContent = buildChildAgentsMd(skillsBlock, {\n            overrides,\n            plugins: childPlugins,\n          });\n          const expectedHash = computeHash(expectedContent);\n          const agentsMdLocalHash = computeLocalHash(projectDir, \"AGENTS.md\");\n          if (agentsMdLocalHash !== expectedHash) {\n            updated.push(\"AGENTS.md\");\n          }\n        }\n      }\n\n      return {\n        status: \"dry-run\",\n        updated,\n        skipped,\n        added,\n        conflicted,\n      };\n    }\n\n    const filesToWrite = [...updated, ...added, ...conflicted];\n\n    let backupDir: string | undefined;\n    if (filesToWrite.length > 0) {\n      backupDir = backupFiles(projectDir, filesToWrite) ?? undefined;\n\n      for (const destPath of filesToWrite) {\n        const sourcePath = destToSource.get(destPath) ?? destPath;\n        writeSyncedFile(sourceDir, projectDir, sourcePath, destPath);\n      }\n    }\n\n    await personalizeConfig(projectDir, {\n      extendsAccount,\n      extendsGateway,\n      account,\n      domain,\n      overrides,\n      plugins: childPlugins,\n      workspaceOpts: { sourceDir },\n      mode: \"sync\",\n      existingConfig: localConfig,\n    });\n\n    await syncResolvedSharedDeps({\n      configDir: projectDir,\n      hostMode: \"local\",\n    });\n\n    const syncedConfig = await loadResolvedConfig({ cwd: projectDir });\n    if (syncedConfig?.runtime) {\n      writeGeneratedInfra(projectDir, syncedConfig.runtime);\n    }\n\n    const newSnapshotFiles: Record<string, string> = {};\n    for (const destPath of destToSource.keys()) {\n      const hash = computeLocalHash(projectDir, destPath);\n      if (hash) {\n        newSnapshotFiles[destPath] = hash;\n      }\n    }\n\n    const agentsMdSourcePath = toSourcePath(sourceDir, \"AGENTS.md\");\n    if (agentsMdSourcePath) {\n      const agentsMdSourceContent = readFileSync(join(sourceDir, agentsMdSourcePath), \"utf-8\");\n      const skillsBlock = extractSkillsBlock(agentsMdSourceContent);\n      if (skillsBlock) {\n        const expectedContent = buildChildAgentsMd(skillsBlock, {\n          overrides,\n          plugins: childPlugins,\n        });\n        const expectedHash = computeHash(expectedContent);\n\n        const agentsMdLocalHash = computeLocalHash(projectDir, \"AGENTS.md\");\n        if (agentsMdLocalHash !== expectedHash) {\n          writeFileSync(join(projectDir, \"AGENTS.md\"), expectedContent);\n          updated.push(\"AGENTS.md\");\n        }\n\n        newSnapshotFiles[\"AGENTS.md\"] = expectedHash;\n      }\n    }\n\n    await writeSnapshot(projectDir, {\n      parentRef: `bos://${extendsAccount}/${extendsGateway}`,\n      files: newSnapshotFiles,\n    });\n\n    if (!options.noInstall) {\n      await runBunInstall(projectDir);\n      await runTypesGen(projectDir);\n    }\n\n    return {\n      status: \"synced\",\n      updated,\n      skipped,\n      added,\n      conflicted,\n      backupDir,\n    };\n  } finally {\n    await cleanup();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"sync.cjs","names":["join","existsSync","readFileSync","computeHash","dirname","mergeBosConfigWithTemplate","findWorkspaceRoot","relative","parseYaml","loadAppDescriptorConfig","isPlainObjectFromMerge","resolveExtendsRef","resolveSourceDir","buildChildRootScripts","readSnapshot","extractSkillsBlock","buildChildAgentsMd","personalizeConfig","syncResolvedSharedDeps","openResolution","materializeViaLayer","writeSnapshot","runPnpmInstall","runTypesGen"],"sources":["../../src/cli/sync.ts"],"sourcesContent":["import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { dirname, join, relative } from \"node:path\";\nimport { glob } from \"glob\";\nimport { parse as parseYaml } from \"yaml\";\nimport { loadAppDescriptorConfig } from \"../config\";\nimport type { SyncOptions, SyncResult } from \"../contract\";\nimport { materializeViaLayer } from \"../infra/materializer\";\nimport {\n  isPlainObject as isPlainObjectFromMerge,\n  mergeBosConfigWithTemplate,\n  resolveExtendsRef,\n} from \"../merge\";\nimport { openResolution } from \"../resolution/session\";\nimport { syncResolvedSharedDeps } from \"../shared-deps\";\nimport { computeSnapshotHash as computeHash } from \"../utils/snapshot-hash\";\nimport { findWorkspaceRoot } from \"../workspace\";\nimport {\n  buildChildAgentsMd,\n  buildChildRootScripts,\n  extractSkillsBlock,\n  personalizeConfig,\n  resolveSourceDir,\n  runPnpmInstall,\n  runTypesGen,\n} from \"./init\";\nimport { readSnapshot, writeSnapshot } from \"./snapshot\";\n\nconst FRAMEWORK_OWNED_SYNC_FILES = new Set([\n  \".env.example\",\n  \".gitignore\",\n  \"biome.json\",\n  \"bos.config.json\",\n  \"package.json\",\n  \".changeset/config.json\",\n  \".changeset/README.md\",\n  \".github/workflows/ci.yml\",\n  \".github/workflows/deploy.yml\",\n  \".github/workflows/staging.yml\",\n  \".github/workflows/release.yml\",\n  \"railway.toml\",\n  \"ui/package.json\",\n  \"ui/postcss.config.mjs\",\n  \"ui/tsconfig.json\",\n  \"api/package.json\",\n  \"api/plugin.dev.ts\",\n  \"api/rspack.config.js\",\n  \"api/tsconfig.json\",\n  \"api/src/lib/context.ts\",\n  \"api/drizzle.config.ts\",\n  \"api/src/db/index.ts\",\n  \"api/src/db/layer.ts\",\n  \"api/src/db/migrate.ts\",\n  \"api/src/global.d.ts\",\n  \"api/tests/types.d.ts\",\n]);\n\n/**\n * Files the scaffold previously sync-owned but has retired (ADR 0023) — the\n * generated `.gen` bootstrap stubs replaced them. During sync: a local copy\n * whose hash still matches the sync snapshot is deleted silently; a\n * hand-modified (or never-snapshotted) copy is backed up, then deleted. The\n * app's authored ui files (router.tsx, app.ts, lib, routes, components) are\n * NOT retired — they leave the sync list as app-owned files, untouched.\n */\nexport const RETIRED_SYNC_FILES = new Set([\n  \"ui/src/entry.ts\",\n  \"ui/src/globals.d.ts\",\n  \"ui/src/hydrate.tsx\",\n  \"ui/src/router.server.tsx\",\n  \"ui/src/compose.ts\",\n]);\n\ntype PackageJson = Record<string, unknown>;\n\nconst AGENT_SYNC_GLOBS = [\".agents/skills/**\", \"docs/agents/**\", \"skills-lock.json\"];\n\nexport function isFrameworkOwnedSyncFile(filePath: string): boolean {\n  if (FRAMEWORK_OWNED_SYNC_FILES.has(filePath)) return true;\n  if (\n    filePath.startsWith(\".agents/skills/\") ||\n    filePath.startsWith(\"docs/agents/\") ||\n    filePath === \"skills-lock.json\"\n  )\n    return true;\n  // lib/auth.ts is NOT sync-owned since #207: the middleware factory lives in\n  // everything-dev/api (framework home); projects import it, they don't own a copy.\n  if (/^plugins\\/[^/]+\\/src\\/lib\\/context\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/src\\/db\\/(index|layer|migrate)\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/rspack\\.config\\.js$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/drizzle\\.config\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/src\\/global\\.d\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/tests\\/types\\.d\\.ts$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/tsconfig\\.json$/.test(filePath)) return true;\n  if (/^plugins\\/[^/]+\\/tsconfig\\.contract\\.json$/.test(filePath)) return true;\n  return false;\n}\n\nfunction computeLocalHash(projectDir: string, filePath: string): string | null {\n  const fullPath = join(projectDir, filePath);\n  if (!existsSync(fullPath)) return null;\n  try {\n    const content = readFileSync(fullPath);\n    return computeHash(content);\n  } catch {\n    return null;\n  }\n}\n\nfunction backupFiles(projectDir: string, filePaths: string[]): string | null {\n  const filesToBackup = filePaths.filter((f) => existsSync(join(projectDir, f)));\n  if (filesToBackup.length === 0) return null;\n\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const backupDir = join(projectDir, \".bos\", \"sync-backup\", timestamp);\n\n  for (const filePath of filesToBackup) {\n    const src = join(projectDir, filePath);\n    const dest = join(backupDir, filePath);\n    mkdirSync(dirname(dest), { recursive: true });\n    copyFileSync(src, dest);\n  }\n\n  return backupDir;\n}\n\nexport interface RetiredSyncFilesResult {\n  /** unmodified stub copies — deleted (in a real run) */\n  retired: string[];\n  /** hand-modified or never-snapshotted stub copies — backed up, then deleted */\n  retiredConflicted: string[];\n  backupDir: string | null;\n}\n\n/**\n * Migrate a child off the retired bootstrap stub files (ADR 0023): unmodified\n * copies are deleted silently, hand-modified copies are backed up first. In\n * dry-run the actions are reported without touching the tree.\n */\nexport function retireSyncedFiles(\n  projectDir: string,\n  snapshotFiles: Record<string, string>,\n  opts: { dryRun: boolean },\n): RetiredSyncFilesResult {\n  const retired: string[] = [];\n  const retiredConflicted: string[] = [];\n\n  for (const destPath of RETIRED_SYNC_FILES) {\n    const localHash = computeLocalHash(projectDir, destPath);\n    if (localHash === null) continue;\n    if (localHash === snapshotFiles[destPath]) {\n      retired.push(destPath);\n    } else {\n      retiredConflicted.push(destPath);\n    }\n  }\n\n  if (opts.dryRun || (retired.length === 0 && retiredConflicted.length === 0)) {\n    return { retired, retiredConflicted, backupDir: null };\n  }\n\n  const backupDir = backupFiles(projectDir, retiredConflicted);\n  for (const destPath of [...retired, ...retiredConflicted]) {\n    rmSync(join(projectDir, destPath));\n  }\n  return { retired, retiredConflicted, backupDir };\n}\n\nfunction mergeStringMaps(\n  local: Record<string, string> | undefined,\n  template: Record<string, string> | undefined,\n): Record<string, string> | undefined {\n  if (!local && !template) return undefined;\n\n  const merged: Record<string, string> = { ...local };\n  for (const [name, value] of Object.entries(template ?? {})) {\n    merged[name] = value;\n  }\n\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\nfunction mergeWorkspacePackages(local: unknown, template: unknown): string[] | undefined {\n  const localPackages = Array.isArray(local) ? local : [];\n  const templatePackages = Array.isArray(template) ? template : [];\n  if (localPackages.length === 0 && templatePackages.length === 0) return undefined;\n\n  const ordered = new Set<string>();\n  for (const entry of templatePackages) {\n    if (typeof entry === \"string\" && entry.length > 0) ordered.add(entry);\n  }\n  for (const entry of localPackages) {\n    if (typeof entry === \"string\" && entry.length > 0) ordered.add(entry);\n  }\n\n  const hasPluginEntry = [...ordered].some((e) => e.startsWith(\"plugins/\") && e !== \"plugins/*\");\n  if (hasPluginEntry) {\n    for (const entry of ordered) {\n      if (entry.startsWith(\"plugins/\") && entry !== \"plugins/*\") {\n        ordered.delete(entry);\n      }\n    }\n    ordered.add(\"plugins/*\");\n  }\n\n  return ordered.size > 0 ? [...ordered] : undefined;\n}\n\nexport function mergePackageJson(\n  filePath: string,\n  local: PackageJson,\n  template: PackageJson,\n  childScripts?: Record<string, string>,\n): PackageJson {\n  const merged: PackageJson = { ...local, ...template };\n\n  if (filePath === \"package.json\") {\n    for (const key of [\"name\", \"private\", \"version\"] as const) {\n      if (key in local) {\n        merged[key] = local[key];\n      }\n    }\n  } else if (\"version\" in local) {\n    merged.version = local.version;\n  }\n\n  for (const depField of [\n    \"dependencies\",\n    \"devDependencies\",\n    \"peerDependencies\",\n    \"overrides\",\n  ] as const) {\n    const localDeps = local[depField] as Record<string, string> | undefined;\n    const templateDeps = template[depField] as Record<string, string> | undefined;\n\n    const mergedDeps = mergeStringMaps(localDeps, templateDeps);\n    if (mergedDeps) {\n      merged[depField] = mergedDeps;\n    } else {\n      delete merged[depField];\n    }\n  }\n\n  if (\n    (local.scripts && typeof local.scripts === \"object\") ||\n    (template.scripts && typeof template.scripts === \"object\") ||\n    childScripts\n  ) {\n    const mergedScripts = mergeStringMaps(\n      local.scripts as Record<string, string> | undefined,\n      filePath === \"package.json\" && childScripts\n        ? childScripts\n        : (template.scripts as Record<string, string> | undefined),\n    );\n    if (mergedScripts) {\n      merged.scripts = mergedScripts;\n    } else {\n      delete merged.scripts;\n    }\n  }\n\n  if (\n    (local.workspaces && typeof local.workspaces === \"object\") ||\n    (template.workspaces && typeof template.workspaces === \"object\")\n  ) {\n    const localWorkspaces = (local.workspaces ?? {}) as {\n      packages?: string[];\n      catalog?: Record<string, string>;\n    };\n    const templateWorkspaces = (template.workspaces ?? {}) as {\n      packages?: string[];\n      catalog?: Record<string, string>;\n    };\n\n    const mergedWorkspaces: { packages?: string[]; catalog?: Record<string, string> } = {\n      ...localWorkspaces,\n      ...templateWorkspaces,\n    };\n\n    const mergedPackages = mergeWorkspacePackages(\n      localWorkspaces.packages,\n      templateWorkspaces.packages,\n    );\n    if (mergedPackages) {\n      mergedWorkspaces.packages = mergedPackages;\n    } else {\n      delete mergedWorkspaces.packages;\n    }\n\n    const mergedCatalog = mergeStringMaps(localWorkspaces.catalog, templateWorkspaces.catalog);\n    if (mergedCatalog) {\n      mergedWorkspaces.catalog = mergedCatalog;\n    } else {\n      delete mergedWorkspaces.catalog;\n    }\n\n    if (Object.keys(mergedWorkspaces).length > 0) {\n      merged.workspaces = mergedWorkspaces;\n    } else {\n      delete merged.workspaces;\n    }\n  }\n\n  return merged;\n}\n\nfunction toSourcePath(sourceDir: string, destPath: string): string | null {\n  if (destPath.startsWith(\".github/\")) {\n    const templatePath = destPath.replace(/^\\.github\\//, \".github/templates/\");\n    if (existsSync(join(sourceDir, templatePath))) {\n      return templatePath;\n    }\n  }\n\n  const directPath = join(sourceDir, destPath);\n  if (existsSync(directPath)) {\n    return destPath;\n  }\n\n  return null;\n}\n\nfunction buildSyncedFileContent(\n  sourceDir: string,\n  projectDir: string,\n  filePath: string,\n  explicitDestPath?: string,\n  childScripts?: Record<string, string>,\n): string | Uint8Array {\n  const src = join(sourceDir, filePath);\n  const destPath =\n    explicitDestPath ??\n    (filePath.startsWith(\".github/templates/\")\n      ? filePath.replace(/^\\.github\\/templates\\//, \".github/\")\n      : filePath);\n  const dest = join(projectDir, destPath);\n\n  if (filePath.endsWith(\"bos.config.json\")) {\n    const localContent = existsSync(dest) ? readFileSync(dest, \"utf-8\") : null;\n    const templateContent = readFileSync(src, \"utf-8\");\n\n    if (localContent) {\n      const local = JSON.parse(localContent) as Record<string, unknown>;\n      const template = JSON.parse(templateContent) as Record<string, unknown>;\n      const merged = mergeBosConfigWithTemplate(local, template);\n      return `${JSON.stringify(merged, null, 2)}\\n`;\n    }\n  }\n\n  if (filePath.endsWith(\"package.json\")) {\n    const localContent = existsSync(dest) ? readFileSync(dest, \"utf-8\") : null;\n    const templateContent = readFileSync(src, \"utf-8\");\n\n    if (localContent) {\n      const local = JSON.parse(localContent) as Record<string, unknown>;\n      const template = JSON.parse(templateContent) as Record<string, unknown>;\n      const merged = mergePackageJson(destPath, local, template, childScripts);\n      return `${JSON.stringify(merged, null, 2)}\\n`;\n    }\n  }\n\n  return readFileSync(src);\n}\n\nfunction writeSyncedFile(\n  sourceDir: string,\n  projectDir: string,\n  filePath: string,\n  explicitDestPath?: string,\n  childScripts?: Record<string, string>,\n): void {\n  const destPath =\n    explicitDestPath ??\n    (filePath.startsWith(\".github/templates/\")\n      ? filePath.replace(/^\\.github\\/templates\\//, \".github/\")\n      : filePath);\n  const dest = join(projectDir, destPath);\n  mkdirSync(dirname(dest), { recursive: true });\n  writeFileSync(\n    dest,\n    buildSyncedFileContent(sourceDir, projectDir, filePath, destPath, childScripts),\n  );\n}\n\nasync function getSelectedChildPlugins(\n  projectDir: string,\n  localConfig: Record<string, unknown>,\n): Promise<string[]> {\n  if (!localConfig.plugins || typeof localConfig.plugins !== \"object\") {\n    return [];\n  }\n\n  const pluginDirs = new Set(\n    (\n      await glob(\"plugins/*/package.json\", {\n        cwd: projectDir,\n        nodir: true,\n        dot: false,\n        absolute: false,\n      })\n    )\n      .map((file) => file.match(/^plugins\\/([^/]+)\\/package\\.json$/)?.[1])\n      .filter((key): key is string => Boolean(key)),\n  );\n\n  const selected: string[] = [];\n  for (const [pluginKey, rawEntry] of Object.entries(\n    localConfig.plugins as Record<string, unknown>,\n  )) {\n    if (typeof rawEntry === \"string\") {\n      if (!rawEntry.startsWith(\"local:\")) {\n        selected.push(pluginKey);\n        continue;\n      }\n\n      const localPath = join(projectDir, rawEntry.slice(\"local:\".length).trim());\n      if (existsSync(localPath) || pluginDirs.has(pluginKey)) {\n        selected.push(pluginKey);\n      }\n      continue;\n    }\n\n    if (!rawEntry || typeof rawEntry !== \"object\") {\n      selected.push(pluginKey);\n      continue;\n    }\n\n    const entry = rawEntry as Record<string, unknown>;\n    const development = typeof entry.development === \"string\" ? entry.development : undefined;\n    if (!development?.startsWith(\"local:\")) {\n      selected.push(pluginKey);\n      continue;\n    }\n\n    const localPath = join(projectDir, development.slice(\"local:\".length).trim());\n    if (existsSync(localPath) || pluginDirs.has(pluginKey)) {\n      selected.push(pluginKey);\n    }\n  }\n\n  return selected;\n}\n\nfunction hasPluginsWorkspace(projectDir: string): boolean {\n  const root = findWorkspaceRoot(projectDir);\n  if (!root) return false;\n  const rel = relative(root.dir, projectDir);\n  const baseDir = rel.startsWith(\"..\") || rel === \"\" ? root.dir : projectDir;\n  for (const manifest of [\"pnpm-workspace.yaml\", \"package.json\"]) {\n    const manifestPath = join(baseDir, manifest);\n    if (!existsSync(manifestPath)) continue;\n    try {\n      const content = readFileSync(manifestPath, \"utf-8\");\n      const packages =\n        manifest === \"pnpm-workspace.yaml\"\n          ? (parseYaml(content) as { packages?: unknown } | null)?.packages\n          : (\n              JSON.parse(content) as {\n                workspaces?: { packages?: string[] } | string[];\n              }\n            ).workspaces;\n      const globs = Array.isArray(packages)\n        ? packages\n        : Array.isArray((packages as { packages?: string[] })?.packages)\n          ? (packages as { packages?: string[] }).packages\n          : [];\n      if (globs.includes(\"plugins/*\")) return true;\n    } catch {\n      return false;\n    }\n  }\n  return false;\n}\n\nexport async function syncTemplate(projectDir: string, options: SyncOptions): Promise<SyncResult> {\n  // Sync reads the user's authored config — the raw bos.config.json, or the\n  // materialized bos.app.ts descriptor for TS-form children — not the\n  // resolved config: it needs the user's explicit local settings (their\n  // extends ref, selected plugins, etc.). The resolved config is the merged\n  // result and would include inherited parent values that the user didn't\n  // explicitly choose, which would break sync filtering.\n  const tsFormChild = existsSync(join(projectDir, \"bos.app.ts\"));\n  const localConfig = (\n    tsFormChild\n      ? await loadAppDescriptorConfig(join(projectDir, \"bos.app.ts\"))\n      : JSON.parse(readFileSync(join(projectDir, \"bos.config.json\"), \"utf-8\"))\n  ) as Record<string, unknown>;\n\n  let extendsRef: string | undefined;\n  if (typeof localConfig.extends === \"string\") {\n    extendsRef = localConfig.extends;\n  } else if (isPlainObjectFromMerge(localConfig.extends)) {\n    extendsRef = resolveExtendsRef(localConfig.extends as Record<string, string>, \"production\");\n  }\n  if (!extendsRef?.startsWith(\"bos://\")) {\n    return {\n      status: \"error\",\n      updated: [],\n      skipped: [],\n      added: [],\n      conflicted: [],\n      error: \"No extends field found in bos.config.json — cannot determine parent\",\n    };\n  }\n\n  const extendsMatch = extendsRef.match(/^bos:\\/\\/([^/]+)\\/(.+)$/);\n  if (!extendsMatch) {\n    return {\n      status: \"error\",\n      updated: [],\n      skipped: [],\n      added: [],\n      conflicted: [],\n      error: `Invalid extends reference: ${extendsRef}`,\n    };\n  }\n\n  const extendsAccount = extendsMatch[1];\n  const extendsGateway = extendsMatch[2];\n\n  const { sourceDir, cleanup } = await resolveSourceDir({\n    extendsAccount,\n    extendsGateway,\n  });\n\n  try {\n    const childPlugins = await getSelectedChildPlugins(projectDir, localConfig);\n    const withUi = existsSync(join(projectDir, \"ui\", \"package.json\"));\n    const withApi = existsSync(join(projectDir, \"api\", \"package.json\"));\n    const withHost = existsSync(join(projectDir, \"host\", \"package.json\"));\n    const withPlugins = childPlugins.length > 0 || hasPluginsWorkspace(projectDir);\n\n    const childScripts = buildChildRootScripts({\n      ui: withUi,\n      api: withApi,\n      host: withHost,\n      plugins: withPlugins,\n    });\n\n    const destToSource = new Map<string, string>();\n    // TS-form children author bos.app.ts — the parent's JSON config must\n    // never sync into them.\n    const tsFormChild = !existsSync(join(projectDir, \"bos.config.json\"));\n    for (const destPath of FRAMEWORK_OWNED_SYNC_FILES) {\n      if (destPath === \"bos.config.json\" && tsFormChild) continue;\n      if (destPath.startsWith(\"ui/\") && !withUi) continue;\n      if (destPath.startsWith(\"api/\") && !withApi) continue;\n      if (destPath.startsWith(\"host/\") && !withHost) continue;\n      const sourcePath = toSourcePath(sourceDir, destPath);\n      if (!sourcePath) continue;\n      destToSource.set(destPath, sourcePath);\n    }\n\n    for (const destPath of await glob(AGENT_SYNC_GLOBS, {\n      cwd: sourceDir,\n      nodir: true,\n      dot: true,\n      absolute: false,\n      ignore: [\"**/node_modules/**\", \"**/.git/**\", \"**/dist/**\", \"**/.bos/**\"],\n    })) {\n      destToSource.set(destPath, destPath);\n    }\n\n    // Sync api/src/lib/{auth,context}.ts into each plugin's src/lib/\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey, \"src\"))) continue;\n      for (const libFile of [\"auth.ts\", \"context.ts\"]) {\n        const sourceFile = `api/src/lib/${libFile}`;\n        if (!existsSync(join(sourceDir, sourceFile))) continue;\n        destToSource.set(`plugins/${pluginKey}/src/lib/${libFile}`, sourceFile);\n      }\n    }\n\n    // Sync api/src/global.d.ts into each plugin's src/\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey, \"src\"))) continue;\n      const sourceFile = \"api/src/global.d.ts\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/src/global.d.ts`, sourceFile);\n    }\n\n    // Sync tests/types.d.ts into each plugin's tests/\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey))) continue;\n      const sourceFile = \"plugins/_template/tests/types.d.ts\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/tests/types.d.ts`, sourceFile);\n    }\n\n    // Sync api/src/db/{index,layer,migrate}.ts into each plugin's src/db/\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey, \"src\", \"db\"))) continue;\n      for (const dbFile of [\"index.ts\", \"layer.ts\", \"migrate.ts\"]) {\n        const sourceFile = `api/src/db/${dbFile}`;\n        if (!existsSync(join(sourceDir, sourceFile))) continue;\n        destToSource.set(`plugins/${pluginKey}/src/db/${dbFile}`, sourceFile);\n      }\n    }\n\n    // Sync rspack.config.js from the template into each plugin\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey))) continue;\n      const sourceFile = \"plugins/_template/rspack.config.js\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/rspack.config.js`, sourceFile);\n    }\n\n    // Sync drizzle.config.ts from api into each DB-enabled plugin\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey, \"src\", \"db\"))) continue;\n      const sourceFile = \"api/drizzle.config.ts\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/drizzle.config.ts`, sourceFile);\n    }\n\n    // Sync tsconfig from the template into each plugin\n    for (const pluginKey of childPlugins) {\n      if (!existsSync(join(projectDir, \"plugins\", pluginKey))) continue;\n      const sourceFile = \"plugins/_template/tsconfig.json\";\n      if (!existsSync(join(sourceDir, sourceFile))) continue;\n      destToSource.set(`plugins/${pluginKey}/tsconfig.json`, sourceFile);\n    }\n\n    const updated: string[] = [];\n    const skipped: string[] = [];\n    const added: string[] = [];\n    const conflicted: string[] = [];\n\n    const snapshot = await readSnapshot(projectDir);\n    const snapshotFiles = snapshot?.files ?? {};\n\n    for (const [destPath, filePath] of destToSource.entries()) {\n      if (!existsSync(join(sourceDir, filePath))) {\n        // The template no longer ships this file — it was retired from the\n        // scaffold. Leave the local copy untouched rather than crashing the\n        // sync (the old-CLI + new-template transitional combo).\n        skipped.push(destPath);\n        continue;\n      }\n      const localHash = computeLocalHash(projectDir, destPath);\n      const sourceHash = computeHash(\n        buildSyncedFileContent(sourceDir, projectDir, filePath, undefined, childScripts),\n      );\n\n      if (localHash === null) {\n        added.push(destPath);\n        continue;\n      }\n\n      if (localHash === sourceHash) {\n        skipped.push(destPath);\n        continue;\n      }\n\n      const snapshotHash = snapshotFiles[destPath];\n      if (!snapshotHash) {\n        updated.push(destPath);\n        continue;\n      }\n\n      if (localHash === snapshotHash) {\n        updated.push(destPath);\n        continue;\n      }\n\n      if (sourceHash === snapshotHash) {\n        skipped.push(destPath);\n        continue;\n      }\n\n      conflicted.push(destPath);\n    }\n\n    const account = (localConfig.account as string) || extendsAccount;\n    const domain = (localConfig.domain as string) || extendsGateway;\n    const overrides: Array<\"ui\" | \"api\" | \"host\" | \"plugins\"> = [];\n    if (withUi) overrides.push(\"ui\");\n    if (withApi) overrides.push(\"api\");\n    if (withHost) overrides.push(\"host\");\n    if (withPlugins) overrides.push(\"plugins\");\n\n    if (options.dryRun) {\n      const agentsMdSourcePath = toSourcePath(sourceDir, \"AGENTS.md\");\n      if (agentsMdSourcePath) {\n        const agentsMdSourceContent = readFileSync(join(sourceDir, agentsMdSourcePath), \"utf-8\");\n        const skillsBlock = extractSkillsBlock(agentsMdSourceContent);\n        if (skillsBlock) {\n          const expectedContent = buildChildAgentsMd(skillsBlock, {\n            overrides,\n            plugins: childPlugins,\n          });\n          const expectedHash = computeHash(expectedContent);\n          const agentsMdLocalHash = computeLocalHash(projectDir, \"AGENTS.md\");\n          if (agentsMdLocalHash !== expectedHash) {\n            updated.push(\"AGENTS.md\");\n          }\n        }\n      }\n\n      const retirement = retireSyncedFiles(projectDir, snapshotFiles, { dryRun: true });\n\n      return {\n        status: \"dry-run\",\n        updated,\n        skipped,\n        added,\n        conflicted,\n        retired: retirement.retired,\n        retiredConflicted: retirement.retiredConflicted,\n      };\n    }\n\n    // Migrate the child off the retired bootstrap stubs (ADR 0023) before any\n    // writes — a retired file is never in destToSource, so its snapshot entry\n    // drops out at the next writeSnapshot.\n    const retirement = retireSyncedFiles(projectDir, snapshotFiles, { dryRun: false });\n\n    const filesToWrite = [...updated, ...added, ...conflicted];\n\n    let backupDir: string | undefined = retirement.backupDir ?? undefined;\n    if (filesToWrite.length > 0) {\n      backupDir = backupFiles(projectDir, filesToWrite) ?? backupDir;\n\n      for (const destPath of filesToWrite) {\n        const sourcePath = destToSource.get(destPath) ?? destPath;\n        writeSyncedFile(sourceDir, projectDir, sourcePath, destPath, childScripts);\n      }\n    }\n\n    await personalizeConfig(projectDir, {\n      extendsAccount,\n      extendsGateway,\n      account,\n      domain,\n      overrides,\n      plugins: childPlugins,\n      workspaceOpts: { sourceDir },\n      mode: \"sync\",\n      existingConfig: localConfig,\n    });\n\n    await syncResolvedSharedDeps({\n      configDir: projectDir,\n      hostMode: \"local\",\n    });\n\n    const syncedConfig = await openResolution({ cwd: projectDir });\n    if (syncedConfig?.runtime) {\n      await materializeViaLayer(projectDir, syncedConfig.runtime!);\n    }\n\n    const newSnapshotFiles: Record<string, string> = {};\n    for (const destPath of destToSource.keys()) {\n      const hash = computeLocalHash(projectDir, destPath);\n      if (hash) {\n        newSnapshotFiles[destPath] = hash;\n      }\n    }\n\n    const agentsMdSourcePath = toSourcePath(sourceDir, \"AGENTS.md\");\n    if (agentsMdSourcePath) {\n      const agentsMdSourceContent = readFileSync(join(sourceDir, agentsMdSourcePath), \"utf-8\");\n      const skillsBlock = extractSkillsBlock(agentsMdSourceContent);\n      if (skillsBlock) {\n        const expectedContent = buildChildAgentsMd(skillsBlock, {\n          overrides,\n          plugins: childPlugins,\n        });\n        const expectedHash = computeHash(expectedContent);\n\n        const agentsMdLocalHash = computeLocalHash(projectDir, \"AGENTS.md\");\n        if (agentsMdLocalHash !== expectedHash) {\n          writeFileSync(join(projectDir, \"AGENTS.md\"), expectedContent);\n          updated.push(\"AGENTS.md\");\n        }\n\n        newSnapshotFiles[\"AGENTS.md\"] = expectedHash;\n      }\n    }\n\n    await writeSnapshot(projectDir, {\n      parentRef: `bos://${extendsAccount}/${extendsGateway}`,\n      files: newSnapshotFiles,\n    });\n\n    if (!options.noInstall) {\n      await runPnpmInstall(findWorkspaceRoot(projectDir)?.dir ?? projectDir);\n      await runTypesGen(projectDir);\n    }\n\n    return {\n      status: \"synced\",\n      updated,\n      skipped,\n      added,\n      conflicted,\n      retired: retirement.retired,\n      retiredConflicted: retirement.retiredConflicted,\n      retiredBackupDir: retirement.backupDir ?? undefined,\n      backupDir,\n    };\n  } finally {\n    await cleanup();\n  }\n}\n"],"mappings":"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"}

package/dist/cli/sync.mjs

@@ -1,13 +1,16 @@
 import { isPlainObject, mergeBosConfigWithTemplate, resolveExtendsRef } from "../merge.mjs";
-import { loadResolvedConfig } from "../config.mjs";
-import { syncResolvedSharedDeps } from "../shared-deps.mjs";
-import { writeGeneratedInfra } from "./infra.mjs";
+import { loadAppDescriptorConfig } from "../config.mjs";
+import { computeSnapshotHash } from "../utils/snapshot-hash.mjs";
 import { readSnapshot, writeSnapshot } from "./snapshot.mjs";
-import { buildChildAgentsMd, extractSkillsBlock, personalizeConfig, resolveSourceDir, runBunInstall, runTypesGen } from "./init.mjs";
-import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { createHash } from "node:crypto";
+import { buildChildAgentsMd, buildChildRootScripts, extractSkillsBlock, personalizeConfig, resolveSourceDir, runPnpmInstall, runTypesGen } from "./init.mjs";
+import { openResolution } from "../resolution/session.mjs";
+import { findWorkspaceRoot } from "../workspace.mjs";
+import { syncResolvedSharedDeps } from "../shared-deps.mjs";
+import { materializeViaLayer } from "../infra/materializer.mjs";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
 import { glob } from "glob";
+import { parse } from "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 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 = join(projectDir, filePath);
 	if (!existsSync(fullPath)) return null;
 	try {
-		return computeHash(readFileSync(fullPath));
+		const content = readFileSync(fullPath);
+		return computeSnapshotHash(content);
 	} catch {
 		return null;
 	}
@@ -65,7 +87,8 @@ function computeLocalHash(projectDir, filePath) {
 function backupFiles(projectDir, filePaths) {
 	const filesToBackup = filePaths.filter((f) => existsSync(join(projectDir, f)));
 	if (filesToBackup.length === 0) return null;
-	const backupDir = join(projectDir, ".bos", "sync-backup", (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-"));
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+	const backupDir = join(projectDir, ".bos", "sync-backup", timestamp);
 	for (const filePath of filesToBackup) {
 		const src = join(projectDir, filePath);
 		const dest = 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]) rmSync(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 (existsSync(join(sourceDir, templatePath))) return templatePath;
 	}
-	if (existsSync(join(sourceDir, destPath))) return destPath;
+	const directPath = join(sourceDir, destPath);
+	if (existsSync(directPath)) return destPath;
 	return null;
 }
-function buildSyncedFileContent(sourceDir, projectDir, filePath, explicitDestPath) {
+function buildSyncedFileContent(sourceDir, projectDir, filePath, explicitDestPath, childScripts) {
 	const src = join(sourceDir, filePath);
 	const destPath = explicitDestPath ?? (filePath.startsWith(".github/templates/") ? filePath.replace(/^\.github\/templates\//, ".github/") : filePath);
 	const dest = join(projectDir, destPath);
@@ -156,7 +207,9 @@ function buildSyncedFileContent(sourceDir, projectDir, filePath, explicitDestPat
 		const localContent = existsSync(dest) ? readFileSync(dest, "utf-8") : null;
 		const templateContent = readFileSync(src, "utf-8");
 		if (localContent) {
-			const merged = mergeBosConfigWithTemplate(JSON.parse(localContent), JSON.parse(templateContent));
+			const local = JSON.parse(localContent);
+			const template = JSON.parse(templateContent);
+			const merged = mergeBosConfigWithTemplate(local, template);
 			return `${JSON.stringify(merged, null, 2)}\n`;
 		}
 	}
@@ -164,17 +217,17 @@ function buildSyncedFileContent(sourceDir, projectDir, filePath, explicitDestPat
 		const localContent = existsSync(dest) ? readFileSync(dest, "utf-8") : null;
 		const templateContent = 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 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 = join(projectDir, destPath);
 	mkdirSync(dirname(dest), { recursive: true });
-	writeFileSync(dest, buildSyncedFileContent(sourceDir, projectDir, filePath, destPath));
+	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 (existsSync(join(projectDir, rawEntry.slice(6).trim())) || pluginDirs.has(pluginKey)) selected.push(pluginKey);
+			const localPath = join(projectDir, rawEntry.slice(6).trim());
+			if (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 (existsSync(join(projectDir, development.slice(6).trim())) || pluginDirs.has(pluginKey)) selected.push(pluginKey);
+		const localPath = join(projectDir, development.slice(6).trim());
+		if (existsSync(localPath) || pluginDirs.has(pluginKey)) selected.push(pluginKey);
 	}
 	return selected;
 }
 function hasPluginsWorkspace(projectDir) {
-	const packageJsonPath = join(projectDir, "package.json");
-	if (!existsSync(packageJsonPath)) return false;
-	try {
-		const workspaces = JSON.parse(readFileSync(packageJsonPath, "utf-8")).workspaces;
-		return (Array.isArray(workspaces) ? workspaces : Array.isArray(workspaces?.packages) ? workspaces.packages : []).includes("plugins/*");
-	} catch {
-		return false;
+	const root = findWorkspaceRoot(projectDir);
+	if (!root) return false;
+	const rel = relative(root.dir, projectDir);
+	const baseDir = rel.startsWith("..") || rel === "" ? root.dir : projectDir;
+	for (const manifest of ["pnpm-workspace.yaml", "package.json"]) {
+		const manifestPath = join(baseDir, manifest);
+		if (!existsSync(manifestPath)) continue;
+		try {
+			const content = readFileSync(manifestPath, "utf-8");
+			const packages = manifest === "pnpm-workspace.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(readFileSync(join(projectDir, "bos.config.json"), "utf-8"));
+	const localConfig = existsSync(join(projectDir, "bos.app.ts")) ? await loadAppDescriptorConfig(join(projectDir, "bos.app.ts")) : JSON.parse(readFileSync(join(projectDir, "bos.config.json"), "utf-8"));
 	let extendsRef;
 	if (typeof localConfig.extends === "string") extendsRef = localConfig.extends;
 	else if (isPlainObject(localConfig.extends)) extendsRef = resolveExtendsRef(localConfig.extends, "production");
@@ -252,8 +315,16 @@ async function syncTemplate(projectDir, options) {
 		const withApi = existsSync(join(projectDir, "api", "package.json"));
 		const withHost = existsSync(join(projectDir, "host", "package.json"));
 		const withPlugins = childPlugins.length > 0 || hasPluginsWorkspace(projectDir);
+		const childScripts = buildChildRootScripts({
+			ui: withUi,
+			api: withApi,
+			host: withHost,
+			plugins: withPlugins
+		});
 		const destToSource = /* @__PURE__ */ new Map();
+		const tsFormChild = !existsSync(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 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 (!existsSync(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 (!existsSync(join(projectDir, "plugins", pluginKey))) continue;
-			for (const tsconfigFile of ["tsconfig.json", "tsconfig.contract.json"]) {
-				const sourceFile = `plugins/_template/${tsconfigFile}`;
-				if (!existsSync(join(sourceDir, sourceFile))) continue;
-				destToSource.set(`plugins/${pluginKey}/${tsconfigFile}`, sourceFile);
-			}
+			const sourceFile = "plugins/_template/tsconfig.json";
+			if (!existsSync(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 readSnapshot(projectDir))?.files ?? {};
 		for (const [destPath, filePath] of destToSource.entries()) {
+			if (!existsSync(join(sourceDir, filePath))) {
+				skipped.push(destPath);
+				continue;
+			}
 			const localHash = computeLocalHash(projectDir, destPath);
-			const sourceHash = computeHash(buildSyncedFileContent(sourceDir, projectDir, filePath));
+			const sourceHash = 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 = extractSkillsBlock(readFileSync(join(sourceDir, agentsMdSourcePath), "utf-8"));
+				const agentsMdSourceContent = readFileSync(join(sourceDir, agentsMdSourcePath), "utf-8");
+				const skillsBlock = extractSkillsBlock(agentsMdSourceContent);
 				if (skillsBlock) {
-					const expectedHash = computeHash(buildChildAgentsMd(skillsBlock, {
+					const expectedContent = buildChildAgentsMd(skillsBlock, {
 						overrides,
 						plugins: childPlugins
-					}));
+					});
+					const expectedHash = 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 personalizeConfig(projectDir, {
 			extendsAccount,
@@ -396,8 +487,8 @@ async function syncTemplate(projectDir, options) {
 			configDir: projectDir,
 			hostMode: "local"
 		});
-		const syncedConfig = await loadResolvedConfig({ cwd: projectDir });
-		if (syncedConfig?.runtime) writeGeneratedInfra(projectDir, syncedConfig.runtime);
+		const syncedConfig = await openResolution({ cwd: projectDir });
+		if (syncedConfig?.runtime) await 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 = extractSkillsBlock(readFileSync(join(sourceDir, agentsMdSourcePath), "utf-8"));
+			const agentsMdSourceContent = readFileSync(join(sourceDir, agentsMdSourcePath), "utf-8");
+			const skillsBlock = extractSkillsBlock(agentsMdSourceContent);
 			if (skillsBlock) {
 				const expectedContent = buildChildAgentsMd(skillsBlock, {
 					overrides,
 					plugins: childPlugins
 				});
-				const expectedHash = computeHash(expectedContent);
+				const expectedHash = computeSnapshotHash(expectedContent);
 				if (computeLocalHash(projectDir, "AGENTS.md") !== expectedHash) {
 					writeFileSync(join(projectDir, "AGENTS.md"), expectedContent);
 					updated.push("AGENTS.md");
@@ -424,7 +516,7 @@ async function syncTemplate(projectDir, options) {
 			files: newSnapshotFiles
 		});
 		if (!options.noInstall) {
-			await runBunInstall(projectDir);
+			await runPnpmInstall(findWorkspaceRoot(projectDir)?.dir ?? projectDir);
 			await 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,5 +536,5 @@ async function syncTemplate(projectDir, options) {
 }
 
 //#endregion
-export { mergePackageJson, syncTemplate };
+export { RETIRED_SYNC_FILES, isFrameworkOwnedSyncFile, mergePackageJson, retireSyncedFiles, syncTemplate };
 //# sourceMappingURL=sync.mjs.map