@warlock.js/core 5.29.0 → 5.31.0

package/esm/updater/package-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"package-manager.mjs","names":[],"sources":["../../../../../../../core/src/updater/package-manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { rootPath } from \"../utils\";\n\n/** Package managers the framework knows how to drive. */\nexport type PackageManager = \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n/**\n * The lockfile that identifies each package manager, in detection order.\n * Bun is checked first because a Bun project may also carry a `yarn.lock`\n * (Bun writes one for tooling compatibility) — matching yarn there would run\n * the wrong installer against the wrong lockfile.\n */\nconst LOCKFILES: ReadonlyArray<{ file: string; packageManager: PackageManager }> = [\n  { file: \"bun.lock\", packageManager: \"bun\" },\n  { file: \"bun.lockb\", packageManager: \"bun\" },\n  { file: \"pnpm-lock.yaml\", packageManager: \"pnpm\" },\n  { file: \"yarn.lock\", packageManager: \"yarn\" },\n  { file: \"package-lock.json\", packageManager: \"npm\" },\n];\n\n/**\n * Detect the project's package manager from its lockfile, falling back to\n * npm when none is present. Shared by `warlock update` and `warlock add` so\n * both agree on a project that happens to carry more than one lockfile.\n */\nexport async function detectPackageManager(startDir: string = rootPath()): Promise<PackageManager> {\n  const dirs: string[] = [];\n\n  for (let dir = path.resolve(startDir); ; dir = path.dirname(dir)) {\n    dirs.push(dir);\n\n    if (path.dirname(dir) === dir) break;\n  }\n\n  // 1. nearest declared `packageManager` field\n  for (const dir of dirs) {\n    const declared = await readDeclaredPackageManager(dir);\n\n    if (declared) return declared;\n  }\n\n  // 2. a pnpm workspace marker beats any (possibly stray) lockfile\n  for (const dir of dirs) {\n    if (await fileExistsAsync(path.join(dir, \"pnpm-workspace.yaml\"))) return \"pnpm\";\n  }\n\n  // 3. lockfiles, nearest level first\n  for (const dir of dirs) {\n    for (const { file, packageManager } of LOCKFILES) {\n      if (await fileExistsAsync(path.join(dir, file))) return packageManager;\n    }\n  }\n\n  const agent = process.env.npm_config_user_agent?.split(\"/\")[0];\n\n  if (agent === \"pnpm\" || agent === \"yarn\" || agent === \"bun\") return agent;\n\n  return \"npm\";\n}\n\n/** The manager named by the app's `packageManager` field, if any. */\nasync function readDeclaredPackageManager(dir: string): Promise<PackageManager | undefined> {\n  try {\n    const json = JSON.parse(await readFile(path.join(dir, \"package.json\"), \"utf8\"));\n    const name = String(json.packageManager ?? \"\").split(\"@\")[0];\n\n    if (name === \"pnpm\" || name === \"yarn\" || name === \"bun\" || name === \"npm\") return name;\n  } catch {\n    // no readable package.json — fall through to lockfiles\n  }\n\n  return undefined;\n}\n\n/**\n * The lockfile-syncing install command for the given manager. No package\n * arguments — `warlock update` rewrites the versions in package.json first,\n * then a plain install reconciles `node_modules` to match.\n */\nexport function getInstallCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"yarn\":\n      return \"yarn install\";\n\n    case \"pnpm\":\n      return \"pnpm install\";\n\n    case \"bun\":\n      return \"bun install\";\n\n    default:\n      return \"npm install\";\n  }\n}\n\n/**\n * The command that installs *specific* packages — what `warlock add` needs.\n * Distinct from {@link getInstallCommand}, which only reconciles what is\n * already written into package.json.\n */\nexport function getAddCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"yarn\":\n      return \"yarn add\";\n\n    case \"pnpm\":\n      return \"pnpm add\";\n\n    case \"bun\":\n      return \"bun add\";\n\n    default:\n      return \"npm install\";\n  }\n}\n\n/**\n * The package-manager command that saves an exact version. Warlock family\n * dependencies use this path so the version selected by the executing Core is\n * preserved verbatim in package.json instead of being widened by a manager's\n * default save prefix.\n */\nexport function getExactAddCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"yarn\":\n      return \"yarn add --exact\";\n\n    case \"pnpm\":\n      return \"pnpm add --save-exact\";\n\n    case \"bun\":\n      return \"bun add --exact\";\n\n    default:\n      return \"npm install --save-exact\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAM,YAA6E;CACjF;EAAE,MAAM;EAAY,gBAAgB;CAAM;CAC1C;EAAE,MAAM;EAAa,gBAAgB;CAAM;CAC3C;EAAE,MAAM;EAAkB,gBAAgB;CAAO;CACjD;EAAE,MAAM;EAAa,gBAAgB;CAAO;CAC5C;EAAE,MAAM;EAAqB,gBAAgB;CAAM;AACrD;;;;;;AAOA,eAAsB,qBAAqB,WAAmB,SAAS,GAA4B;CACjG,MAAM,OAAiB,CAAC;CAExB,KAAK,IAAI,MAAM,KAAK,QAAQ,QAAQ,IAAK,MAAM,KAAK,QAAQ,GAAG,GAAG;EAChE,KAAK,KAAK,GAAG;EAEb,IAAI,KAAK,QAAQ,GAAG,MAAM,KAAK;CACjC;CAGA,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,WAAW,MAAM,2BAA2B,GAAG;EAErD,IAAI,UAAU,OAAO;CACvB;CAGA,KAAK,MAAM,OAAO,MAChB,IAAI,MAAM,gBAAgB,KAAK,KAAK,KAAK,qBAAqB,CAAC,GAAG,OAAO;CAI3E,KAAK,MAAM,OAAO,MAChB,KAAK,MAAM,EAAE,MAAM,oBAAoB,WACrC,IAAI,MAAM,gBAAgB,KAAK,KAAK,KAAK,IAAI,CAAC,GAAG,OAAO;CAI5D,MAAM,QAAQ,QAAQ,IAAI,uBAAuB,MAAM,GAAG,CAAC,CAAC;CAE5D,IAAI,UAAU,UAAU,UAAU,UAAU,UAAU,OAAO,OAAO;CAEpE,OAAO;AACT;;AAGA,eAAe,2BAA2B,KAAkD;CAC1F,IAAI;EACF,MAAM,OAAO,KAAK,MAAM,MAAM,SAAS,KAAK,KAAK,KAAK,cAAc,GAAG,MAAM,CAAC;EAC9E,MAAM,OAAO,OAAO,KAAK,kBAAkB,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;EAE1D,IAAI,SAAS,UAAU,SAAS,UAAU,SAAS,SAAS,SAAS,OAAO,OAAO;CACrF,QAAQ,CAER;AAGF;;;;;;AAOA,SAAgB,kBAAkB,gBAAwC;CACxE,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EAET,KAAK,QACH,OAAO;EAET,KAAK,OACH,OAAO;EAET,SACE,OAAO;CACX;AACF;;;;;;AAOA,SAAgB,cAAc,gBAAwC;CACpE,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EAET,KAAK,QACH,OAAO;EAET,KAAK,OACH,OAAO;EAET,SACE,OAAO;CACX;AACF;;;;;;;AAQA,SAAgB,mBAAmB,gBAAwC;CACzE,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EAET,KAAK,QACH,OAAO;EAET,KAAK,OACH,OAAO;EAET,SACE,OAAO;CACX;AACF"}
+{"version":3,"file":"package-manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/updater/package-manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { rootPath } from \"../utils\";\n\n/** Package managers the framework knows how to drive. */\nexport type PackageManager = \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n/**\n * The lockfile that identifies each package manager, in detection order.\n * Bun is checked first because a Bun project may also carry a `yarn.lock`\n * (Bun writes one for tooling compatibility) — matching yarn there would run\n * the wrong installer against the wrong lockfile.\n */\nconst LOCKFILES: ReadonlyArray<{ file: string; packageManager: PackageManager }> = [\n  { file: \"bun.lock\", packageManager: \"bun\" },\n  { file: \"bun.lockb\", packageManager: \"bun\" },\n  { file: \"pnpm-lock.yaml\", packageManager: \"pnpm\" },\n  { file: \"yarn.lock\", packageManager: \"yarn\" },\n  { file: \"package-lock.json\", packageManager: \"npm\" },\n];\n\n/**\n * Detect the project's package manager from its lockfile, falling back to\n * npm when none is present. Shared by `warlock update` and `warlock add` so\n * both agree on a project that happens to carry more than one lockfile.\n */\nexport async function detectPackageManager(startDir: string = rootPath()): Promise<PackageManager> {\n  const dirs: string[] = [];\n\n  for (let dir = path.resolve(startDir); ; dir = path.dirname(dir)) {\n    dirs.push(dir);\n\n    if (path.dirname(dir) === dir) break;\n  }\n\n  // 1. nearest declared `packageManager` field\n  for (const dir of dirs) {\n    const declared = await readDeclaredPackageManager(dir);\n\n    if (declared) return declared;\n  }\n\n  // 2. a pnpm workspace marker beats any (possibly stray) lockfile\n  for (const dir of dirs) {\n    if (await fileExistsAsync(path.join(dir, \"pnpm-workspace.yaml\"))) return \"pnpm\";\n  }\n\n  // 3. lockfiles, nearest level first\n  for (const dir of dirs) {\n    for (const { file, packageManager } of LOCKFILES) {\n      if (await fileExistsAsync(path.join(dir, file))) return packageManager;\n    }\n  }\n\n  const agent = process.env.npm_config_user_agent?.split(\"/\")[0];\n\n  if (agent === \"pnpm\" || agent === \"yarn\" || agent === \"bun\") return agent;\n\n  return \"npm\";\n}\n\n/** The manager named by the app's `packageManager` field, if any. */\nasync function readDeclaredPackageManager(dir: string): Promise<PackageManager | undefined> {\n  try {\n    const json = JSON.parse(await readFile(path.join(dir, \"package.json\"), \"utf8\"));\n    const name = String(json.packageManager ?? \"\").split(\"@\")[0];\n\n    if (name === \"pnpm\" || name === \"yarn\" || name === \"bun\" || name === \"npm\") return name;\n  } catch {\n    // no readable package.json — fall through to lockfiles\n  }\n\n  return undefined;\n}\n\n/**\n * The lockfile-syncing install command for the given manager. No package\n * arguments — `warlock update` rewrites the versions in package.json first,\n * then a plain install reconciles `node_modules` to match.\n */\nexport function getInstallCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"yarn\":\n      return \"yarn install\";\n\n    case \"pnpm\":\n      return \"pnpm install\";\n\n    case \"bun\":\n      return \"bun install\";\n\n    default:\n      return \"npm install\";\n  }\n}\n\n/**\n * The command that installs *specific* packages — what `warlock add` needs.\n * Distinct from {@link getInstallCommand}, which only reconciles what is\n * already written into package.json.\n */\nexport function getAddCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"yarn\":\n      return \"yarn add\";\n\n    case \"pnpm\":\n      return \"pnpm add\";\n\n    case \"bun\":\n      return \"bun add\";\n\n    default:\n      return \"npm install\";\n  }\n}\n\n/**\n * The package-manager command that saves an exact version. Warlock family\n * dependencies use this path so the version selected by the executing Core is\n * preserved verbatim in package.json instead of being widened by a manager's\n * default save prefix.\n */\nexport function getExactAddCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"yarn\":\n      return \"yarn add --exact\";\n\n    case \"pnpm\":\n      return \"pnpm add --save-exact\";\n\n    case \"bun\":\n      return \"bun add --exact\";\n\n    default:\n      return \"npm install --save-exact\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAM,YAA6E;CACjF;EAAE,MAAM;EAAY,gBAAgB;CAAM;CAC1C;EAAE,MAAM;EAAa,gBAAgB;CAAM;CAC3C;EAAE,MAAM;EAAkB,gBAAgB;CAAO;CACjD;EAAE,MAAM;EAAa,gBAAgB;CAAO;CAC5C;EAAE,MAAM;EAAqB,gBAAgB;CAAM;AACrD;;;;;;AAOA,eAAsB,qBAAqB,WAAmB,SAAS,GAA4B;CACjG,MAAM,OAAiB,CAAC;CAExB,KAAK,IAAI,MAAM,KAAK,QAAQ,QAAQ,IAAK,MAAM,KAAK,QAAQ,GAAG,GAAG;EAChE,KAAK,KAAK,GAAG;EAEb,IAAI,KAAK,QAAQ,GAAG,MAAM,KAAK;CACjC;CAGA,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,WAAW,MAAM,2BAA2B,GAAG;EAErD,IAAI,UAAU,OAAO;CACvB;CAGA,KAAK,MAAM,OAAO,MAChB,IAAI,MAAM,gBAAgB,KAAK,KAAK,KAAK,qBAAqB,CAAC,GAAG,OAAO;CAI3E,KAAK,MAAM,OAAO,MAChB,KAAK,MAAM,EAAE,MAAM,oBAAoB,WACrC,IAAI,MAAM,gBAAgB,KAAK,KAAK,KAAK,IAAI,CAAC,GAAG,OAAO;CAI5D,MAAM,QAAQ,QAAQ,IAAI,uBAAuB,MAAM,GAAG,CAAC,CAAC;CAE5D,IAAI,UAAU,UAAU,UAAU,UAAU,UAAU,OAAO,OAAO;CAEpE,OAAO;AACT;;AAGA,eAAe,2BAA2B,KAAkD;CAC1F,IAAI;EACF,MAAM,OAAO,KAAK,MAAM,MAAM,SAAS,KAAK,KAAK,KAAK,cAAc,GAAG,MAAM,CAAC;EAC9E,MAAM,OAAO,OAAO,KAAK,kBAAkB,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;EAE1D,IAAI,SAAS,UAAU,SAAS,UAAU,SAAS,SAAS,SAAS,OAAO,OAAO;CACrF,QAAQ,CAER;AAGF;;;;;;AAOA,SAAgB,kBAAkB,gBAAwC;CACxE,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EAET,KAAK,QACH,OAAO;EAET,KAAK,OACH,OAAO;EAET,SACE,OAAO;CACX;AACF;;;;;;AAOA,SAAgB,cAAc,gBAAwC;CACpE,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EAET,KAAK,QACH,OAAO;EAET,KAAK,OACH,OAAO;EAET,SACE,OAAO;CACX;AACF;;;;;;;AAQA,SAAgB,mBAAmB,gBAAwC;CACzE,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EAET,KAAK,QACH,OAAO;EAET,KAAK,OACH,OAAO;EAET,SACE,OAAO;CACX;AACF"}

package/esm/updater/update-warlock-packages.mjs

@@ -7,7 +7,7 @@ import { colors } from "@mongez/copper";
 import { fileExistsAsync, getJsonFileAsync, putJsonFileAsync } from "@warlock.js/fs";
 import { execSync } from "node:child_process";
 
-//#region ../core/src/updater/update-warlock-packages.ts
+//#region ../../packages/core/src/updater/update-warlock-packages.ts
 /** Scope prefix that identifies a Warlock framework package. */
 const WARLOCK_SCOPE = "@warlock.js/";
 /** The dependency maps in package.json we update, in display order. */

package/esm/updater/update-warlock-packages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"update-warlock-packages.mjs","names":[],"sources":["../../../../../../../core/src/updater/update-warlock-packages.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getJsonFileAsync, putJsonFileAsync } from \"@warlock.js/fs\";\nimport { execSync } from \"node:child_process\";\nimport { rootPath } from \"../utils\";\nimport { fetchLatestVersion } from \"../utils/npm-registry\";\nimport { isNewerVersion } from \"../utils/version-compare\";\nimport { detectPackageManager, getInstallCommand } from \"./package-manager\";\n\n/** Scope prefix that identifies a Warlock framework package. */\nconst WARLOCK_SCOPE = \"@warlock.js/\";\n\n/** The dependency maps in package.json we update, in display order. */\nconst DEPENDENCY_SECTIONS = [\"dependencies\", \"devDependencies\"] as const;\n\ntype DependencySection = (typeof DEPENDENCY_SECTIONS)[number];\n\ntype DependencyMap = Record<string, string>;\n\ntype PackageJson = Record<string, unknown> & {\n  dependencies?: DependencyMap;\n  devDependencies?: DependencyMap;\n};\n\n/** A `@warlock.js/*` dependency found in package.json. */\ntype WarlockDependency = {\n  name: string;\n  section: DependencySection;\n  /** The current spec exactly as written, e.g. `^4.2.0`. */\n  current: string;\n};\n\n/** A dependency whose latest version has been resolved from the registry. */\nexport type ResolvedDependency = WarlockDependency & {\n  /** Latest version from npm, or `undefined` when the lookup failed. */\n  latest: string | undefined;\n};\n\n/** A concrete version bump to write back into package.json. */\nexport type PackageUpdate = {\n  name: string;\n  section: DependencySection;\n  /** Existing spec, e.g. `^4.2.0`. */\n  from: string;\n  /** New spec with the original range operator preserved, e.g. `^4.3.0`. */\n  to: string;\n};\n\n/** Options accepted by {@link updateWarlockPackages}. */\nexport type UpdateWarlockPackagesOptions = {\n  /** Run the package manager install after rewriting versions (default true). */\n  install?: boolean;\n  /**\n   * Report what would change without touching package.json or node_modules.\n   * Resolves with the `outdated` outcome instead of `updated`.\n   */\n  dryRun?: boolean;\n};\n\n/**\n * How an update run ended. Callers branch on this instead of re-deriving the\n * situation from the printed output — the dev-server `u` shortcut needs to\n * know whether restarting is warranted, and whether it may offer a retry.\n */\nexport type UpdateOutcome =\n  /** No package.json at the project root — nothing to do. */\n  | \"no-package-json\"\n  /** package.json carries no `@warlock.js/*` dependency. */\n  | \"no-packages\"\n  /** Every registry lookup failed — offline, DNS down, or npm unreachable. */\n  | \"registry-unreachable\"\n  /** Every package is already at (or ahead of) its latest published version. */\n  | \"up-to-date\"\n  /** Newer versions exist, and a dry run left everything untouched. */\n  | \"outdated\"\n  /** Versions were rewritten (and installed, unless `install: false`). */\n  | \"updated\"\n  /** Versions were rewritten but the package manager install failed. */\n  | \"install-failed\";\n\n/** The result of an update run. */\nexport type UpdateWarlockPackagesResult = {\n  outcome: UpdateOutcome;\n  /** The bumps written to package.json — empty unless `outcome` wrote any. */\n  updates: PackageUpdate[];\n  /** The install failure, present only for `install-failed`. */\n  error?: Error;\n};\n\n/**\n * Update every `@warlock.js/*` package listed in the project's root\n * package.json to its latest published version, then reconcile `node_modules`\n * via the detected package manager.\n *\n * The original range operator on each dependency (`^`, `~`, or an exact pin)\n * is preserved; specs that aren't a plain semver — `workspace:*`, `*`,\n * `latest`, git/file URLs — are left untouched. Only genuine upgrades are\n * written, so re-running on an already-current project is a no-op.\n *\n * Resolves rather than throws on the two failures a caller is expected to\n * survive — an unreachable registry and a failed install — so the dev-server\n * shortcut can report them and keep serving.\n */\nexport async function updateWarlockPackages(\n  options: UpdateWarlockPackagesOptions = {},\n): Promise<UpdateWarlockPackagesResult> {\n  const runInstall = options.install ?? true;\n  const packageJsonPath = rootPath(\"package.json\");\n\n  if (!(await fileExistsAsync(packageJsonPath))) {\n    console.log(`${colors.red(\"✖\")} No package.json found at the project root.`);\n    return { outcome: \"no-package-json\", updates: [] };\n  }\n\n  const packageJson = (await getJsonFileAsync(packageJsonPath)) as PackageJson;\n  const dependencies = collectWarlockDependencies(packageJson);\n\n  if (dependencies.length === 0) {\n    console.log(`${colors.yellow(\"⚠\")} No @warlock.js packages found in package.json.`);\n    return { outcome: \"no-packages\", updates: [] };\n  }\n\n  console.log(\n    `${colors.cyan(\"›\")} Checking ${colors.bold(String(dependencies.length))} ` +\n      `@warlock.js package(s) for updates…`,\n  );\n\n  const resolved = await resolveLatestVersions(dependencies);\n\n  // Distinguish \"nothing newer\" from \"we never got an answer\". Without this,\n  // an offline run reports every package as up to date, which is a lie.\n  if (isRegistryUnreachable(resolved)) {\n    console.log(\n      `${colors.yellow(\"⚠\")} Could not reach the npm registry — ` +\n        `no versions were changed. Check your connection and try again.`,\n    );\n    return { outcome: \"registry-unreachable\", updates: [] };\n  }\n\n  // A partial failure would bump some family members and leave others behind,\n  // a lockstep drift reported as success. Refuse the whole run instead.\n  const failedLookups = resolved.filter((dependency) => !dependency.latest);\n\n  if (failedLookups.length > 0) {\n    console.log(\n      `${colors.yellow(\"⚠\")} Could not look up ${failedLookups.map((dependency) => dependency.name).join(\", \")} — ` +\n        `no versions were changed, to keep @warlock.js packages in lockstep. Try again.`,\n    );\n    return { outcome: \"registry-unreachable\", updates: [] };\n  }\n\n  const updates = resolvePackageUpdates(resolved);\n\n  if (updates.length === 0) {\n    console.log(`${colors.green(\"✓\")} All @warlock.js packages are already up to date.`);\n    return { outcome: \"up-to-date\", updates: [] };\n  }\n\n  if (options.dryRun) {\n    printUpdates(updates, { pending: true });\n    return { outcome: \"outdated\", updates };\n  }\n\n  applyUpdates(packageJson, updates);\n  await putJsonFileAsync(packageJsonPath, packageJson);\n\n  printUpdates(updates);\n\n  if (!runInstall) {\n    console.log(\n      colors.dim(\"Skipped install (--no-install). Run your package manager to apply the changes.\"),\n    );\n    return { outcome: \"updated\", updates };\n  }\n\n  try {\n    await installDependencies();\n  } catch (error) {\n    console.log(\n      `${colors.red(\"✖\")} The install failed. package.json is already updated — ` +\n        `re-run your package manager install to finish.`,\n    );\n    return { outcome: \"install-failed\", updates, error: error as Error };\n  }\n\n  return { outcome: \"updated\", updates };\n}\n\n/**\n * Whether *every* lookup came back empty, which in practice means the\n * registry was never reached. A single failed package (unpublished, renamed,\n * private) leaves the rest resolvable and is not treated as an outage.\n */\nexport function isRegistryUnreachable(resolved: ResolvedDependency[]): boolean {\n  return resolved.length > 0 && resolved.every((dependency) => !dependency.latest);\n}\n\n/** Collect every `@warlock.js/*` dependency across the relevant sections. */\nfunction collectWarlockDependencies(packageJson: PackageJson): WarlockDependency[] {\n  const dependencies: WarlockDependency[] = [];\n\n  for (const section of DEPENDENCY_SECTIONS) {\n    const map = packageJson[section];\n\n    if (!map) {\n      continue;\n    }\n\n    for (const [name, current] of Object.entries(map)) {\n      if (name.startsWith(WARLOCK_SCOPE)) {\n        dependencies.push({ name, section, current });\n      }\n    }\n  }\n\n  return dependencies;\n}\n\n/** Resolve each dependency's latest version from the registry in parallel. */\nasync function resolveLatestVersions(\n  dependencies: WarlockDependency[],\n): Promise<ResolvedDependency[]> {\n  return Promise.all(\n    dependencies.map(async (dependency) => ({\n      ...dependency,\n      latest: await fetchLatestVersion(dependency.name),\n    })),\n  );\n}\n\n/**\n * Turn resolved dependencies into the concrete set of version bumps to write.\n * Pure (no I/O) so it can be unit-tested directly: skips lookups that failed,\n * non-semver specs, and anything already at (or ahead of) the latest version,\n * and preserves the original range operator on everything it does rewrite.\n */\nexport function resolvePackageUpdates(resolved: ResolvedDependency[]): PackageUpdate[] {\n  const updates: PackageUpdate[] = [];\n\n  for (const dependency of resolved) {\n    if (!dependency.latest) {\n      continue;\n    }\n\n    const parsed = parseSpec(dependency.current);\n\n    if (!parsed) {\n      continue;\n    }\n\n    if (!isNewerVersion(dependency.latest, parsed.version)) {\n      continue;\n    }\n\n    updates.push({\n      name: dependency.name,\n      section: dependency.section,\n      from: dependency.current,\n      to: `${parsed.operator}${dependency.latest}`,\n    });\n  }\n\n  return updates;\n}\n\n/**\n * Split a dependency spec into its range operator and concrete version.\n * Returns `undefined` for specs we won't touch — `workspace:*`, `*`,\n * `latest`, multi-part ranges, or git/file URLs — leaving them exactly as\n * the author wrote them.\n */\nfunction parseSpec(spec: string): { operator: string; version: string } | undefined {\n  const match = spec.trim().match(/^(\\^|~)?(\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?)$/);\n\n  if (!match) {\n    return undefined;\n  }\n\n  const version = match[2];\n\n  if (version === undefined) {\n    return undefined;\n  }\n\n  return { operator: match[1] ?? \"\", version };\n}\n\n/** Write the resolved bumps back into the package.json object in place. */\nfunction applyUpdates(packageJson: PackageJson, updates: PackageUpdate[]): void {\n  for (const update of updates) {\n    const map = packageJson[update.section];\n\n    if (map) {\n      map[update.name] = update.to;\n    }\n  }\n}\n\n/** Print the version bumps — applied, or pending on a dry run. */\nfunction printUpdates(updates: PackageUpdate[], { pending = false } = {}): void {\n  const headline = pending\n    ? `${colors.yellow(\"↑\")} ${colors.bold(String(updates.length))} package(s) can be updated:`\n    : `${colors.green(\"✓\")} Updated ${colors.bold(String(updates.length))} package(s):`;\n\n  console.log(headline);\n\n  for (const update of updates) {\n    console.log(\n      `   ${colors.cyan(update.name)}  ` +\n        `${colors.dim(update.from)} ${colors.dim(\"→\")} ${colors.greenBright(update.to)}`,\n    );\n  }\n}\n\n/** Reconcile node_modules to the rewritten package.json via the project PM. */\nasync function installDependencies(): Promise<void> {\n  const packageManager = await detectPackageManager();\n  const installCommand = getInstallCommand(packageManager);\n\n  console.log(`${colors.cyan(\"›\")} Running ${colors.bold(installCommand)}…`);\n\n  execSync(installCommand, { cwd: process.cwd(), stdio: \"inherit\" });\n}\n"],"mappings":"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"}
+{"version":3,"file":"update-warlock-packages.mjs","names":[],"sources":["../../../../../../../../packages/core/src/updater/update-warlock-packages.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getJsonFileAsync, putJsonFileAsync } from \"@warlock.js/fs\";\nimport { execSync } from \"node:child_process\";\nimport { rootPath } from \"../utils\";\nimport { fetchLatestVersion } from \"../utils/npm-registry\";\nimport { isNewerVersion } from \"../utils/version-compare\";\nimport { detectPackageManager, getInstallCommand } from \"./package-manager\";\n\n/** Scope prefix that identifies a Warlock framework package. */\nconst WARLOCK_SCOPE = \"@warlock.js/\";\n\n/** The dependency maps in package.json we update, in display order. */\nconst DEPENDENCY_SECTIONS = [\"dependencies\", \"devDependencies\"] as const;\n\ntype DependencySection = (typeof DEPENDENCY_SECTIONS)[number];\n\ntype DependencyMap = Record<string, string>;\n\ntype PackageJson = Record<string, unknown> & {\n  dependencies?: DependencyMap;\n  devDependencies?: DependencyMap;\n};\n\n/** A `@warlock.js/*` dependency found in package.json. */\ntype WarlockDependency = {\n  name: string;\n  section: DependencySection;\n  /** The current spec exactly as written, e.g. `^4.2.0`. */\n  current: string;\n};\n\n/** A dependency whose latest version has been resolved from the registry. */\nexport type ResolvedDependency = WarlockDependency & {\n  /** Latest version from npm, or `undefined` when the lookup failed. */\n  latest: string | undefined;\n};\n\n/** A concrete version bump to write back into package.json. */\nexport type PackageUpdate = {\n  name: string;\n  section: DependencySection;\n  /** Existing spec, e.g. `^4.2.0`. */\n  from: string;\n  /** New spec with the original range operator preserved, e.g. `^4.3.0`. */\n  to: string;\n};\n\n/** Options accepted by {@link updateWarlockPackages}. */\nexport type UpdateWarlockPackagesOptions = {\n  /** Run the package manager install after rewriting versions (default true). */\n  install?: boolean;\n  /**\n   * Report what would change without touching package.json or node_modules.\n   * Resolves with the `outdated` outcome instead of `updated`.\n   */\n  dryRun?: boolean;\n};\n\n/**\n * How an update run ended. Callers branch on this instead of re-deriving the\n * situation from the printed output — the dev-server `u` shortcut needs to\n * know whether restarting is warranted, and whether it may offer a retry.\n */\nexport type UpdateOutcome =\n  /** No package.json at the project root — nothing to do. */\n  | \"no-package-json\"\n  /** package.json carries no `@warlock.js/*` dependency. */\n  | \"no-packages\"\n  /** Every registry lookup failed — offline, DNS down, or npm unreachable. */\n  | \"registry-unreachable\"\n  /** Every package is already at (or ahead of) its latest published version. */\n  | \"up-to-date\"\n  /** Newer versions exist, and a dry run left everything untouched. */\n  | \"outdated\"\n  /** Versions were rewritten (and installed, unless `install: false`). */\n  | \"updated\"\n  /** Versions were rewritten but the package manager install failed. */\n  | \"install-failed\";\n\n/** The result of an update run. */\nexport type UpdateWarlockPackagesResult = {\n  outcome: UpdateOutcome;\n  /** The bumps written to package.json — empty unless `outcome` wrote any. */\n  updates: PackageUpdate[];\n  /** The install failure, present only for `install-failed`. */\n  error?: Error;\n};\n\n/**\n * Update every `@warlock.js/*` package listed in the project's root\n * package.json to its latest published version, then reconcile `node_modules`\n * via the detected package manager.\n *\n * The original range operator on each dependency (`^`, `~`, or an exact pin)\n * is preserved; specs that aren't a plain semver — `workspace:*`, `*`,\n * `latest`, git/file URLs — are left untouched. Only genuine upgrades are\n * written, so re-running on an already-current project is a no-op.\n *\n * Resolves rather than throws on the two failures a caller is expected to\n * survive — an unreachable registry and a failed install — so the dev-server\n * shortcut can report them and keep serving.\n */\nexport async function updateWarlockPackages(\n  options: UpdateWarlockPackagesOptions = {},\n): Promise<UpdateWarlockPackagesResult> {\n  const runInstall = options.install ?? true;\n  const packageJsonPath = rootPath(\"package.json\");\n\n  if (!(await fileExistsAsync(packageJsonPath))) {\n    console.log(`${colors.red(\"✖\")} No package.json found at the project root.`);\n    return { outcome: \"no-package-json\", updates: [] };\n  }\n\n  const packageJson = (await getJsonFileAsync(packageJsonPath)) as PackageJson;\n  const dependencies = collectWarlockDependencies(packageJson);\n\n  if (dependencies.length === 0) {\n    console.log(`${colors.yellow(\"⚠\")} No @warlock.js packages found in package.json.`);\n    return { outcome: \"no-packages\", updates: [] };\n  }\n\n  console.log(\n    `${colors.cyan(\"›\")} Checking ${colors.bold(String(dependencies.length))} ` +\n      `@warlock.js package(s) for updates…`,\n  );\n\n  const resolved = await resolveLatestVersions(dependencies);\n\n  // Distinguish \"nothing newer\" from \"we never got an answer\". Without this,\n  // an offline run reports every package as up to date, which is a lie.\n  if (isRegistryUnreachable(resolved)) {\n    console.log(\n      `${colors.yellow(\"⚠\")} Could not reach the npm registry — ` +\n        `no versions were changed. Check your connection and try again.`,\n    );\n    return { outcome: \"registry-unreachable\", updates: [] };\n  }\n\n  // A partial failure would bump some family members and leave others behind,\n  // a lockstep drift reported as success. Refuse the whole run instead.\n  const failedLookups = resolved.filter((dependency) => !dependency.latest);\n\n  if (failedLookups.length > 0) {\n    console.log(\n      `${colors.yellow(\"⚠\")} Could not look up ${failedLookups.map((dependency) => dependency.name).join(\", \")} — ` +\n        `no versions were changed, to keep @warlock.js packages in lockstep. Try again.`,\n    );\n    return { outcome: \"registry-unreachable\", updates: [] };\n  }\n\n  const updates = resolvePackageUpdates(resolved);\n\n  if (updates.length === 0) {\n    console.log(`${colors.green(\"✓\")} All @warlock.js packages are already up to date.`);\n    return { outcome: \"up-to-date\", updates: [] };\n  }\n\n  if (options.dryRun) {\n    printUpdates(updates, { pending: true });\n    return { outcome: \"outdated\", updates };\n  }\n\n  applyUpdates(packageJson, updates);\n  await putJsonFileAsync(packageJsonPath, packageJson);\n\n  printUpdates(updates);\n\n  if (!runInstall) {\n    console.log(\n      colors.dim(\"Skipped install (--no-install). Run your package manager to apply the changes.\"),\n    );\n    return { outcome: \"updated\", updates };\n  }\n\n  try {\n    await installDependencies();\n  } catch (error) {\n    console.log(\n      `${colors.red(\"✖\")} The install failed. package.json is already updated — ` +\n        `re-run your package manager install to finish.`,\n    );\n    return { outcome: \"install-failed\", updates, error: error as Error };\n  }\n\n  return { outcome: \"updated\", updates };\n}\n\n/**\n * Whether *every* lookup came back empty, which in practice means the\n * registry was never reached. A single failed package (unpublished, renamed,\n * private) leaves the rest resolvable and is not treated as an outage.\n */\nexport function isRegistryUnreachable(resolved: ResolvedDependency[]): boolean {\n  return resolved.length > 0 && resolved.every((dependency) => !dependency.latest);\n}\n\n/** Collect every `@warlock.js/*` dependency across the relevant sections. */\nfunction collectWarlockDependencies(packageJson: PackageJson): WarlockDependency[] {\n  const dependencies: WarlockDependency[] = [];\n\n  for (const section of DEPENDENCY_SECTIONS) {\n    const map = packageJson[section];\n\n    if (!map) {\n      continue;\n    }\n\n    for (const [name, current] of Object.entries(map)) {\n      if (name.startsWith(WARLOCK_SCOPE)) {\n        dependencies.push({ name, section, current });\n      }\n    }\n  }\n\n  return dependencies;\n}\n\n/** Resolve each dependency's latest version from the registry in parallel. */\nasync function resolveLatestVersions(\n  dependencies: WarlockDependency[],\n): Promise<ResolvedDependency[]> {\n  return Promise.all(\n    dependencies.map(async (dependency) => ({\n      ...dependency,\n      latest: await fetchLatestVersion(dependency.name),\n    })),\n  );\n}\n\n/**\n * Turn resolved dependencies into the concrete set of version bumps to write.\n * Pure (no I/O) so it can be unit-tested directly: skips lookups that failed,\n * non-semver specs, and anything already at (or ahead of) the latest version,\n * and preserves the original range operator on everything it does rewrite.\n */\nexport function resolvePackageUpdates(resolved: ResolvedDependency[]): PackageUpdate[] {\n  const updates: PackageUpdate[] = [];\n\n  for (const dependency of resolved) {\n    if (!dependency.latest) {\n      continue;\n    }\n\n    const parsed = parseSpec(dependency.current);\n\n    if (!parsed) {\n      continue;\n    }\n\n    if (!isNewerVersion(dependency.latest, parsed.version)) {\n      continue;\n    }\n\n    updates.push({\n      name: dependency.name,\n      section: dependency.section,\n      from: dependency.current,\n      to: `${parsed.operator}${dependency.latest}`,\n    });\n  }\n\n  return updates;\n}\n\n/**\n * Split a dependency spec into its range operator and concrete version.\n * Returns `undefined` for specs we won't touch — `workspace:*`, `*`,\n * `latest`, multi-part ranges, or git/file URLs — leaving them exactly as\n * the author wrote them.\n */\nfunction parseSpec(spec: string): { operator: string; version: string } | undefined {\n  const match = spec.trim().match(/^(\\^|~)?(\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?)$/);\n\n  if (!match) {\n    return undefined;\n  }\n\n  const version = match[2];\n\n  if (version === undefined) {\n    return undefined;\n  }\n\n  return { operator: match[1] ?? \"\", version };\n}\n\n/** Write the resolved bumps back into the package.json object in place. */\nfunction applyUpdates(packageJson: PackageJson, updates: PackageUpdate[]): void {\n  for (const update of updates) {\n    const map = packageJson[update.section];\n\n    if (map) {\n      map[update.name] = update.to;\n    }\n  }\n}\n\n/** Print the version bumps — applied, or pending on a dry run. */\nfunction printUpdates(updates: PackageUpdate[], { pending = false } = {}): void {\n  const headline = pending\n    ? `${colors.yellow(\"↑\")} ${colors.bold(String(updates.length))} package(s) can be updated:`\n    : `${colors.green(\"✓\")} Updated ${colors.bold(String(updates.length))} package(s):`;\n\n  console.log(headline);\n\n  for (const update of updates) {\n    console.log(\n      `   ${colors.cyan(update.name)}  ` +\n        `${colors.dim(update.from)} ${colors.dim(\"→\")} ${colors.greenBright(update.to)}`,\n    );\n  }\n}\n\n/** Reconcile node_modules to the rewritten package.json via the project PM. */\nasync function installDependencies(): Promise<void> {\n  const packageManager = await detectPackageManager();\n  const installCommand = getInstallCommand(packageManager);\n\n  console.log(`${colors.cyan(\"›\")} Running ${colors.bold(installCommand)}…`);\n\n  execSync(installCommand, { cwd: process.cwd(), stdio: \"inherit\" });\n}\n"],"mappings":"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"}

package/esm/upgrade/codemods/head-viewport.mjs

@@ -0,0 +1,46 @@
+import { manualAt, removeNode } from "./helpers.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/head-viewport.ts
+const DEFAULT_VIEWPORT = "width=device-width,initial-scale=1";
+/**
+* 5.30: `<Head />` emits `width=device-width, initial-scale=1` itself. Removes
+* a hand-written duplicate of exactly that tag next to `<Head`; a different
+* viewport is listed so it can move to `metadata.viewport`.
+*/
+const headViewport = {
+	id: "head-viewport",
+	version: "5.30.0",
+	package: "@warlock.js/web",
+	title: "Remove the duplicate viewport meta tag",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node, SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			if (!sourceFile.getFilePath().endsWith(".tsx")) continue;
+			if (!/<Head[\s/>]/.test(sourceFile.getFullText())) continue;
+			for (const element of sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)) {
+				if (element.getTagNameNode().getText() !== "meta") continue;
+				const attributes = /* @__PURE__ */ new Map();
+				for (const attribute of element.getAttributes()) {
+					if (!Node.isJsxAttribute(attribute)) continue;
+					const initializer = attribute.getInitializer();
+					const value = initializer && Node.isStringLiteral(initializer) ? initializer.getLiteralValue() : void 0;
+					attributes.set(attribute.getNameNode().getText(), value);
+				}
+				if (attributes.get("name") !== "viewport") continue;
+				const content = attributes.get("content");
+				if (attributes.size === 2 && content?.replace(/\s/g, "") === DEFAULT_VIEWPORT) output.edits.push(removeNode(context, element, "removed a viewport tag <Head /> already emits"));
+				else output.manual.push(manualAt(context, element, "`<Head />` now emits its own viewport tag. Move this one to `metadata.viewport` (or set it to `false`) so the page does not get two."));
+			}
+		}
+		return output;
+	}
+};
+
+//#endregion
+export { headViewport };
+//# sourceMappingURL=head-viewport.mjs.map

package/esm/upgrade/codemods/head-viewport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-viewport.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/head-viewport.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { manualAt, removeNode } from \"./helpers\";\n\nconst DEFAULT_VIEWPORT = \"width=device-width,initial-scale=1\";\n\n/**\n * 5.30: `<Head />` emits `width=device-width, initial-scale=1` itself. Removes\n * a hand-written duplicate of exactly that tag next to `<Head`; a different\n * viewport is listed so it can move to `metadata.viewport`.\n */\nexport const headViewport: Codemod = {\n  id: \"head-viewport\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/web\",\n  title: \"Remove the duplicate viewport meta tag\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      if (!sourceFile.getFilePath().endsWith(\".tsx\")) continue;\n      if (!/<Head[\\s/>]/.test(sourceFile.getFullText())) continue;\n\n      for (const element of sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)) {\n        if (element.getTagNameNode().getText() !== \"meta\") continue;\n\n        const attributes = new Map<string, string | undefined>();\n        for (const attribute of element.getAttributes()) {\n          if (!Node.isJsxAttribute(attribute)) continue;\n          const initializer = attribute.getInitializer();\n          const value =\n            initializer && Node.isStringLiteral(initializer)\n              ? initializer.getLiteralValue()\n              : undefined;\n          attributes.set(attribute.getNameNode().getText(), value);\n        }\n        if (attributes.get(\"name\") !== \"viewport\") continue;\n\n        const content = attributes.get(\"content\");\n        if (attributes.size === 2 && content?.replace(/\\s/g, \"\") === DEFAULT_VIEWPORT) {\n          output.edits.push(\n            removeNode(context, element, \"removed a viewport tag <Head /> already emits\"),\n          );\n        } else {\n          output.manual.push(\n            manualAt(\n              context,\n              element,\n              \"`<Head />` now emits its own viewport tag. Move this one to `metadata.viewport` (or set it to `false`) so the page does not get two.\",\n            ),\n          );\n        }\n      }\n    }\n\n    return output;\n  },\n};\n"],"mappings":";;;AAGA,MAAM,mBAAmB;;;;;;AAOzB,MAAa,eAAwB;CACnC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,IAAI,CAAC,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG;GAChD,IAAI,CAAC,cAAc,KAAK,WAAW,YAAY,CAAC,GAAG;GAEnD,KAAK,MAAM,WAAW,WAAW,qBAAqB,WAAW,qBAAqB,GAAG;IACvF,IAAI,QAAQ,eAAe,CAAC,CAAC,QAAQ,MAAM,QAAQ;IAEnD,MAAM,6BAAa,IAAI,IAAgC;IACvD,KAAK,MAAM,aAAa,QAAQ,cAAc,GAAG;KAC/C,IAAI,CAAC,KAAK,eAAe,SAAS,GAAG;KACrC,MAAM,cAAc,UAAU,eAAe;KAC7C,MAAM,QACJ,eAAe,KAAK,gBAAgB,WAAW,IAC3C,YAAY,gBAAgB,IAC5B;KACN,WAAW,IAAI,UAAU,YAAY,CAAC,CAAC,QAAQ,GAAG,KAAK;IACzD;IACA,IAAI,WAAW,IAAI,MAAM,MAAM,YAAY;IAE3C,MAAM,UAAU,WAAW,IAAI,SAAS;IACxC,IAAI,WAAW,SAAS,KAAK,SAAS,QAAQ,OAAO,EAAE,MAAM,kBAC3D,OAAO,MAAM,KACX,WAAW,SAAS,SAAS,+CAA+C,CAC9E;SAEA,OAAO,OAAO,KACZ,SACE,SACA,SACA,sIACF,CACF;GAEJ;EACF;EAEA,OAAO;CACT;AACF"}

package/esm/upgrade/codemods/helpers.mjs

@@ -0,0 +1,81 @@
+//#region ../../packages/core/src/upgrade/codemods/helpers.ts
+/** Local names bound to `exported` imported from `moduleName` (`import { log as l }` → `l`). */
+function importedLocalNames(sourceFile, moduleName, exported) {
+	const names = /* @__PURE__ */ new Set();
+	for (const declaration of sourceFile.getImportDeclarations()) {
+		if (declaration.getModuleSpecifierValue() !== moduleName) continue;
+		for (const specifier of declaration.getNamedImports()) {
+			if (specifier.getName() !== exported) continue;
+			names.add(specifier.getAliasNode()?.getText() ?? exported);
+		}
+	}
+	return names;
+}
+/** Whether the file imports anything from `moduleName`. */
+function importsFrom(sourceFile, moduleName) {
+	return sourceFile.getImportDeclarations().some((declaration) => declaration.getModuleSpecifierValue() === moduleName);
+}
+/** A replacement of a node's text (leading trivia kept). */
+function replaceNode(context, node, text, description) {
+	return {
+		file: context.relativePath(node.getSourceFile()),
+		start: node.getStart(),
+		end: node.getEnd(),
+		text,
+		line: node.getStartLineNumber(),
+		description
+	};
+}
+/**
+* Remove a node; when it sits alone on its line(s), remove those lines too so
+* no blank line is left behind.
+*/
+function removeNode(context, node, description) {
+	const full = node.getSourceFile().getFullText();
+	let start = node.getStart();
+	let end = node.getEnd();
+	let lineStart = start;
+	while (lineStart > 0 && (full[lineStart - 1] === " " || full[lineStart - 1] === "	")) lineStart--;
+	let lineEnd = end;
+	while (lineEnd < full.length && (full[lineEnd] === " " || full[lineEnd] === "	")) lineEnd++;
+	const startsLine = lineStart === 0 || full[lineStart - 1] === "\n";
+	const endsLine = lineEnd === full.length || full[lineEnd] === "\n" || full[lineEnd] === "\r";
+	if (startsLine && endsLine) {
+		start = lineStart;
+		end = full[lineEnd] === "\r" ? lineEnd + 2 : lineEnd + 1;
+		end = Math.min(end, full.length);
+	}
+	return {
+		file: context.relativePath(node.getSourceFile()),
+		start,
+		end,
+		text: "",
+		line: node.getStartLineNumber(),
+		description
+	};
+}
+function manualAt(context, node, hint) {
+	return {
+		file: context.relativePath(node.getSourceFile()),
+		line: node.getStartLineNumber(),
+		hint
+	};
+}
+/** The property names of an object literal (static names only). */
+function objectPropertyNames(tsMorph, literal) {
+	const names = /* @__PURE__ */ new Set();
+	for (const property of literal.getProperties()) if (tsMorph.Node.isPropertyAssignment(property) || tsMorph.Node.isShorthandPropertyAssignment(property) || tsMorph.Node.isMethodDeclaration(property)) names.add(property.getName().replace(/^["']|["']$/g, ""));
+	return names;
+}
+/** The object literal assigned to `name` in `literal`, if any. */
+function objectProperty(tsMorph, literal, name) {
+	for (const property of literal.getProperties()) {
+		if (!tsMorph.Node.isPropertyAssignment(property)) continue;
+		if (property.getName().replace(/^["']|["']$/g, "") !== name) continue;
+		return property.getInitializer();
+	}
+}
+
+//#endregion
+export { importedLocalNames, importsFrom, manualAt, objectProperty, objectPropertyNames, removeNode, replaceNode };
+//# sourceMappingURL=helpers.mjs.map

package/esm/upgrade/codemods/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/helpers.ts"],"sourcesContent":["import type * as TsMorph from \"ts-morph\";\nimport type { CodemodContext, ManualFinding, SourceEdit, SourceFile } from \"../types\";\n\n/** Local names bound to `exported` imported from `moduleName` (`import { log as l }` → `l`). */\nexport function importedLocalNames(\n  sourceFile: SourceFile,\n  moduleName: string,\n  exported: string,\n): Set<string> {\n  const names = new Set<string>();\n\n  for (const declaration of sourceFile.getImportDeclarations()) {\n    if (declaration.getModuleSpecifierValue() !== moduleName) continue;\n    for (const specifier of declaration.getNamedImports()) {\n      if (specifier.getName() !== exported) continue;\n      names.add(specifier.getAliasNode()?.getText() ?? exported);\n    }\n  }\n\n  return names;\n}\n\n/** Whether the file imports anything from `moduleName`. */\nexport function importsFrom(sourceFile: SourceFile, moduleName: string): boolean {\n  return sourceFile\n    .getImportDeclarations()\n    .some((declaration) => declaration.getModuleSpecifierValue() === moduleName);\n}\n\n/** A replacement of a node's text (leading trivia kept). */\nexport function replaceNode(\n  context: CodemodContext,\n  node: TsMorph.Node,\n  text: string,\n  description: string,\n): SourceEdit {\n  return {\n    file: context.relativePath(node.getSourceFile()),\n    start: node.getStart(),\n    end: node.getEnd(),\n    text,\n    line: node.getStartLineNumber(),\n    description,\n  };\n}\n\n/**\n * Remove a node; when it sits alone on its line(s), remove those lines too so\n * no blank line is left behind.\n */\nexport function removeNode(\n  context: CodemodContext,\n  node: TsMorph.Node,\n  description: string,\n): SourceEdit {\n  const full = node.getSourceFile().getFullText();\n  let start = node.getStart();\n  let end = node.getEnd();\n\n  let lineStart = start;\n  while (lineStart > 0 && (full[lineStart - 1] === \" \" || full[lineStart - 1] === \"\\t\")) {\n    lineStart--;\n  }\n  let lineEnd = end;\n  while (lineEnd < full.length && (full[lineEnd] === \" \" || full[lineEnd] === \"\\t\")) lineEnd++;\n\n  const startsLine = lineStart === 0 || full[lineStart - 1] === \"\\n\";\n  const endsLine = lineEnd === full.length || full[lineEnd] === \"\\n\" || full[lineEnd] === \"\\r\";\n  if (startsLine && endsLine) {\n    start = lineStart;\n    end = full[lineEnd] === \"\\r\" ? lineEnd + 2 : lineEnd + 1;\n    end = Math.min(end, full.length);\n  }\n\n  return {\n    file: context.relativePath(node.getSourceFile()),\n    start,\n    end,\n    text: \"\",\n    line: node.getStartLineNumber(),\n    description,\n  };\n}\n\nexport function manualAt(context: CodemodContext, node: TsMorph.Node, hint: string): ManualFinding {\n  return {\n    file: context.relativePath(node.getSourceFile()),\n    line: node.getStartLineNumber(),\n    hint,\n  };\n}\n\n/** The property names of an object literal (static names only). */\nexport function objectPropertyNames(\n  tsMorph: CodemodContext[\"tsMorph\"],\n  literal: TsMorph.ObjectLiteralExpression,\n): Set<string> {\n  const names = new Set<string>();\n  for (const property of literal.getProperties()) {\n    if (\n      tsMorph.Node.isPropertyAssignment(property) ||\n      tsMorph.Node.isShorthandPropertyAssignment(property) ||\n      tsMorph.Node.isMethodDeclaration(property)\n    ) {\n      names.add(property.getName().replace(/^[\"']|[\"']$/g, \"\"));\n    }\n  }\n  return names;\n}\n\n/** The object literal assigned to `name` in `literal`, if any. */\nexport function objectProperty(\n  tsMorph: CodemodContext[\"tsMorph\"],\n  literal: TsMorph.ObjectLiteralExpression,\n  name: string,\n): TsMorph.Node | undefined {\n  for (const property of literal.getProperties()) {\n    if (!tsMorph.Node.isPropertyAssignment(property)) continue;\n    if (property.getName().replace(/^[\"']|[\"']$/g, \"\") !== name) continue;\n    return property.getInitializer();\n  }\n  return undefined;\n}\n"],"mappings":";;AAIA,SAAgB,mBACd,YACA,YACA,UACa;CACb,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,eAAe,WAAW,sBAAsB,GAAG;EAC5D,IAAI,YAAY,wBAAwB,MAAM,YAAY;EAC1D,KAAK,MAAM,aAAa,YAAY,gBAAgB,GAAG;GACrD,IAAI,UAAU,QAAQ,MAAM,UAAU;GACtC,MAAM,IAAI,UAAU,aAAa,CAAC,EAAE,QAAQ,KAAK,QAAQ;EAC3D;CACF;CAEA,OAAO;AACT;;AAGA,SAAgB,YAAY,YAAwB,YAA6B;CAC/E,OAAO,WACJ,sBAAsB,CAAC,CACvB,MAAM,gBAAgB,YAAY,wBAAwB,MAAM,UAAU;AAC/E;;AAGA,SAAgB,YACd,SACA,MACA,MACA,aACY;CACZ,OAAO;EACL,MAAM,QAAQ,aAAa,KAAK,cAAc,CAAC;EAC/C,OAAO,KAAK,SAAS;EACrB,KAAK,KAAK,OAAO;EACjB;EACA,MAAM,KAAK,mBAAmB;EAC9B;CACF;AACF;;;;;AAMA,SAAgB,WACd,SACA,MACA,aACY;CACZ,MAAM,OAAO,KAAK,cAAc,CAAC,CAAC,YAAY;CAC9C,IAAI,QAAQ,KAAK,SAAS;CAC1B,IAAI,MAAM,KAAK,OAAO;CAEtB,IAAI,YAAY;CAChB,OAAO,YAAY,MAAM,KAAK,YAAY,OAAO,OAAO,KAAK,YAAY,OAAO,MAC9E;CAEF,IAAI,UAAU;CACd,OAAO,UAAU,KAAK,WAAW,KAAK,aAAa,OAAO,KAAK,aAAa,MAAO;CAEnF,MAAM,aAAa,cAAc,KAAK,KAAK,YAAY,OAAO;CAC9D,MAAM,WAAW,YAAY,KAAK,UAAU,KAAK,aAAa,QAAQ,KAAK,aAAa;CACxF,IAAI,cAAc,UAAU;EAC1B,QAAQ;EACR,MAAM,KAAK,aAAa,OAAO,UAAU,IAAI,UAAU;EACvD,MAAM,KAAK,IAAI,KAAK,KAAK,MAAM;CACjC;CAEA,OAAO;EACL,MAAM,QAAQ,aAAa,KAAK,cAAc,CAAC;EAC/C;EACA;EACA,MAAM;EACN,MAAM,KAAK,mBAAmB;EAC9B;CACF;AACF;AAEA,SAAgB,SAAS,SAAyB,MAAoB,MAA6B;CACjG,OAAO;EACL,MAAM,QAAQ,aAAa,KAAK,cAAc,CAAC;EAC/C,MAAM,KAAK,mBAAmB;EAC9B;CACF;AACF;;AAGA,SAAgB,oBACd,SACA,SACa;CACb,MAAM,wBAAQ,IAAI,IAAY;CAC9B,KAAK,MAAM,YAAY,QAAQ,cAAc,GAC3C,IACE,QAAQ,KAAK,qBAAqB,QAAQ,KAC1C,QAAQ,KAAK,8BAA8B,QAAQ,KACnD,QAAQ,KAAK,oBAAoB,QAAQ,GAEzC,MAAM,IAAI,SAAS,QAAQ,CAAC,CAAC,QAAQ,gBAAgB,EAAE,CAAC;CAG5D,OAAO;AACT;;AAGA,SAAgB,eACd,SACA,SACA,MAC0B;CAC1B,KAAK,MAAM,YAAY,QAAQ,cAAc,GAAG;EAC9C,IAAI,CAAC,QAAQ,KAAK,qBAAqB,QAAQ,GAAG;EAClD,IAAI,SAAS,QAAQ,CAAC,CAAC,QAAQ,gBAAgB,EAAE,MAAM,MAAM;EAC7D,OAAO,SAAS,eAAe;CACjC;AAEF"}

package/esm/upgrade/codemods/index.mjs

@@ -0,0 +1,34 @@
+import { importedLocalNames, importsFrom, manualAt, objectProperty, objectPropertyNames, removeNode, replaceNode } from "./helpers.mjs";
+import { headViewport } from "./head-viewport.mjs";
+import { loggerSyncCalls } from "./logger-sync-calls.mjs";
+import { node2215, warlockVersions } from "./package-json.mjs";
+import { requestLogSnapshot } from "./request-log-snapshot.mjs";
+import { aiAnthropicBody, aiCompactionOptIn, aiFinishReason, aiToolDispatch, rateLimitDefaults, sealContainerCatch, sealRefineOutput, sealUnionOutput, sealValidateResult } from "./review-sites.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/index.ts
+/**
+* Every codemod, oldest release first. A codemod runs when the app upgrades
+* across its `version` (`from < version <= to`); `"target"` ones run on every
+* upgrade. Add one here for each breaking change, and name its id next to the
+* `**BREAKING**` entry in the package changelog.
+*/
+const CODEMODS = [
+	loggerSyncCalls,
+	requestLogSnapshot,
+	headViewport,
+	sealValidateResult,
+	aiToolDispatch,
+	aiAnthropicBody,
+	aiFinishReason,
+	node2215,
+	rateLimitDefaults,
+	sealRefineOutput,
+	sealContainerCatch,
+	sealUnionOutput,
+	aiCompactionOptIn,
+	warlockVersions
+];
+
+//#endregion
+export { CODEMODS };
+//# sourceMappingURL=index.mjs.map

package/esm/upgrade/codemods/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/index.ts"],"sourcesContent":["import type { Codemod } from \"../types\";\nimport { headViewport } from \"./head-viewport\";\nimport { loggerSyncCalls } from \"./logger-sync-calls\";\nimport { node2215, warlockVersions } from \"./package-json\";\nimport { requestLogSnapshot } from \"./request-log-snapshot\";\nimport {\n  aiAnthropicBody,\n  aiCompactionOptIn,\n  aiFinishReason,\n  aiToolDispatch,\n  rateLimitDefaults,\n  sealContainerCatch,\n  sealRefineOutput,\n  sealUnionOutput,\n  sealValidateResult,\n} from \"./review-sites\";\n\n/**\n * Every codemod, oldest release first. A codemod runs when the app upgrades\n * across its `version` (`from < version <= to`); `\"target\"` ones run on every\n * upgrade. Add one here for each breaking change, and name its id next to the\n * `**BREAKING**` entry in the package changelog.\n */\nexport const CODEMODS: readonly Codemod[] = [\n  loggerSyncCalls,\n  requestLogSnapshot,\n  headViewport,\n  sealValidateResult,\n  aiToolDispatch,\n  aiAnthropicBody,\n  aiFinishReason,\n  node2215,\n  rateLimitDefaults,\n  sealRefineOutput,\n  sealContainerCatch,\n  sealUnionOutput,\n  aiCompactionOptIn,\n  warlockVersions,\n];\n\nexport * from \"./helpers\";\n"],"mappings":";;;;;;;;;;;;;;AAuBA,MAAa,WAA+B;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/esm/upgrade/codemods/logger-sync-calls.mjs

@@ -0,0 +1,57 @@
+import { importedLocalNames, manualAt, replaceNode } from "./helpers.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/logger-sync-calls.ts
+const SYNC_METHODS = new Set([
+	"info",
+	"warn",
+	"error",
+	"debug",
+	"success",
+	"fatal",
+	"log",
+	"assert"
+]);
+/**
+* 5.30: `log.info()` and its siblings return the logger instead of a promise.
+* Removes `await` in front of them; a `.then()` chained on one is listed for
+* review (code that must wait for delivery calls `await log.flush()`).
+*/
+const loggerSyncCalls = {
+	id: "logger-sync-calls",
+	version: "5.30.0",
+	package: "@warlock.js/logger",
+	title: "Remove `await` from synchronous log calls",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node, SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			const loggers = importedLocalNames(sourceFile, "@warlock.js/logger", "log");
+			if (loggers.size === 0) continue;
+			const isLogCall = (node) => {
+				if (!Node.isCallExpression(node)) return false;
+				const callee = node.getExpression();
+				if (!Node.isPropertyAccessExpression(callee)) return false;
+				const owner = callee.getExpression();
+				return Node.isIdentifier(owner) && loggers.has(owner.getText()) && SYNC_METHODS.has(callee.getName());
+			};
+			for (const awaitExpression of sourceFile.getDescendantsOfKind(SyntaxKind.AwaitExpression)) {
+				const argument = awaitExpression.getExpression();
+				if (!isLogCall(argument)) continue;
+				output.edits.push(replaceNode(context, awaitExpression, argument.getText(), `removed await before ${argument.getText().split("(")[0]}()`));
+			}
+			for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {
+				if (access.getName() !== "then" || !isLogCall(access.getExpression())) continue;
+				output.manual.push(manualAt(context, access, "`.then()` on a log call: log calls return the logger now. Run the callback directly, or `await log.flush()` first if it must wait for delivery."));
+			}
+		}
+		return output;
+	}
+};
+
+//#endregion
+export { loggerSyncCalls };
+//# sourceMappingURL=logger-sync-calls.mjs.map

package/esm/upgrade/codemods/logger-sync-calls.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-sync-calls.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/logger-sync-calls.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\nconst SYNC_METHODS = new Set([\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"debug\",\n  \"success\",\n  \"fatal\",\n  \"log\",\n  \"assert\",\n]);\n\n/**\n * 5.30: `log.info()` and its siblings return the logger instead of a promise.\n * Removes `await` in front of them; a `.then()` chained on one is listed for\n * review (code that must wait for delivery calls `await log.flush()`).\n */\nexport const loggerSyncCalls: Codemod = {\n  id: \"logger-sync-calls\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/logger\",\n  title: \"Remove `await` from synchronous log calls\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      const loggers = importedLocalNames(sourceFile, \"@warlock.js/logger\", \"log\");\n      if (loggers.size === 0) continue;\n\n      const isLogCall = (node: import(\"ts-morph\").Node): boolean => {\n        if (!Node.isCallExpression(node)) return false;\n        const callee = node.getExpression();\n        if (!Node.isPropertyAccessExpression(callee)) return false;\n        const owner = callee.getExpression();\n        return (\n          Node.isIdentifier(owner) &&\n          loggers.has(owner.getText()) &&\n          SYNC_METHODS.has(callee.getName())\n        );\n      };\n\n      for (const awaitExpression of sourceFile.getDescendantsOfKind(SyntaxKind.AwaitExpression)) {\n        const argument = awaitExpression.getExpression();\n        if (!isLogCall(argument)) continue;\n        output.edits.push(\n          replaceNode(\n            context,\n            awaitExpression,\n            argument.getText(),\n            `removed await before ${argument.getText().split(\"(\")[0]}()`,\n          ),\n        );\n      }\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        if (access.getName() !== \"then\" || !isLogCall(access.getExpression())) continue;\n        output.manual.push(\n          manualAt(\n            context,\n            access,\n            \"`.then()` on a log call: log calls return the logger now. Run the callback directly, or `await log.flush()` first if it must wait for delivery.\",\n          ),\n        );\n      }\n    }\n\n    return output;\n  },\n};\n"],"mappings":";;;AAGA,MAAM,eAAe,IAAI,IAAI;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;AAOD,MAAa,kBAA2B;CACtC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,MAAM,UAAU,mBAAmB,YAAY,sBAAsB,KAAK;GAC1E,IAAI,QAAQ,SAAS,GAAG;GAExB,MAAM,aAAa,SAA2C;IAC5D,IAAI,CAAC,KAAK,iBAAiB,IAAI,GAAG,OAAO;IACzC,MAAM,SAAS,KAAK,cAAc;IAClC,IAAI,CAAC,KAAK,2BAA2B,MAAM,GAAG,OAAO;IACrD,MAAM,QAAQ,OAAO,cAAc;IACnC,OACE,KAAK,aAAa,KAAK,KACvB,QAAQ,IAAI,MAAM,QAAQ,CAAC,KAC3B,aAAa,IAAI,OAAO,QAAQ,CAAC;GAErC;GAEA,KAAK,MAAM,mBAAmB,WAAW,qBAAqB,WAAW,eAAe,GAAG;IACzF,MAAM,WAAW,gBAAgB,cAAc;IAC/C,IAAI,CAAC,UAAU,QAAQ,GAAG;IAC1B,OAAO,MAAM,KACX,YACE,SACA,iBACA,SAAS,QAAQ,GACjB,wBAAwB,SAAS,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAC3D,CACF;GACF;GAEA,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,IAAI,OAAO,QAAQ,MAAM,UAAU,CAAC,UAAU,OAAO,cAAc,CAAC,GAAG;IACvE,OAAO,OAAO,KACZ,SACE,SACA,QACA,iJACF,CACF;GACF;EACF;EAEA,OAAO;CACT;AACF"}

package/esm/upgrade/codemods/package-json.mjs

@@ -0,0 +1,122 @@
+import { compareVersions, parseVersion } from "../version.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/package-json.ts
+const NODE_MINIMUM = "22.15.0";
+/** Keep the file's indentation and trailing newline when rewriting JSON. */
+function serialize(original, value) {
+	const indent = /^[ \t]+(?=")/m.exec(original)?.[0];
+	return (indent ? JSON.stringify(value, null, indent) : JSON.stringify(value)) + (original.endsWith("\n") ? "\n" : "");
+}
+function lineOf(source, needle) {
+	const index = source.indexOf(needle);
+	return index < 0 ? 1 : source.slice(0, index).split("\n").length;
+}
+/**
+* 5.31: the CLI needs Node.js 22.15 or newer. Raises `engines.node` in
+* package.json and the version in `.nvmrc` / `.node-version` when they allow
+* an older Node.
+*/
+const node2215 = {
+	id: "node-22-15",
+	version: "5.31.0",
+	package: "@warlock.js/core",
+	title: "Require Node.js 22.15 or newer",
+	skill: "run-app",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		const source = context.text.read("package.json");
+		if (source !== void 0) {
+			const pkg = JSON.parse(source);
+			const current = pkg.engines?.node;
+			if (typeof current === "string") {
+				const minimum = parseVersion(current);
+				if (minimum && compareVersions(minimum.join("."), NODE_MINIMUM) < 0) {
+					const line = lineOf(source, "\"node\"");
+					pkg.engines = {
+						...pkg.engines,
+						node: ">=22.15"
+					};
+					context.text.write("package.json", serialize(source, pkg), {
+						line,
+						description: `engines.node "${current}" → ">=22.15"`
+					});
+				}
+			}
+		}
+		for (const file of [".nvmrc", ".node-version"]) {
+			const content = context.text.read(file);
+			if (content === void 0) continue;
+			const value = content.trim();
+			const parsed = /^v?\d/.test(value) ? parseVersion(value) : void 0;
+			if (!parsed) {
+				if (value !== "" && !/^lts\/|^node$|^latest$/i.test(value)) output.manual.push({
+					file,
+					line: 1,
+					hint: `Make sure "${value}" resolves to Node.js 22.15 or newer.`
+				});
+				continue;
+			}
+			if (compareVersions(parsed.join("."), NODE_MINIMUM) >= 0) continue;
+			const next = `${value.startsWith("v") ? "v" : ""}22.15.0`;
+			context.text.write(file, `${next}\n`, {
+				line: 1,
+				description: `Node ${value} → ${next}`
+			});
+		}
+		return output;
+	}
+};
+/** Version specs that are not a plain range and must not be rewritten. */
+const NON_REGISTRY_SPEC = /^(workspace:|file:|link:|portal:|git|github:|https?:|npm:)|^\*$|^latest$/;
+/**
+* Every upgrade: set each `@warlock.js/*` (and `create-warlock`) dependency to
+* the target version, keeping its `^`/`~`/exact style. The family is
+* released in lockstep, so mixed versions are not supported.
+*/
+const warlockVersions = {
+	id: "warlock-versions",
+	version: "target",
+	package: "@warlock.js/core",
+	title: "Move the @warlock.js packages to the target version",
+	skill: "update-packages",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		const source = context.text.read("package.json");
+		if (source === void 0) return output;
+		const pkg = JSON.parse(source);
+		const changes = [];
+		for (const field of ["dependencies", "devDependencies"]) {
+			const dependencies = pkg[field];
+			if (!dependencies) continue;
+			for (const [name, spec] of Object.entries(dependencies)) {
+				if (!name.startsWith("@warlock.js/") && name !== "create-warlock") continue;
+				if (typeof spec !== "string" || NON_REGISTRY_SPEC.test(spec)) continue;
+				const next = `${/^[\^~]/.exec(spec)?.[0] ?? (/^\d/.test(spec) ? "" : "^")}${context.targetVersion}`;
+				if (next === spec) continue;
+				dependencies[name] = next;
+				changes.push({
+					name,
+					from: spec,
+					to: next
+				});
+			}
+		}
+		if (changes.length === 0) return output;
+		const first = changes[0];
+		context.text.write("package.json", serialize(source, pkg), {
+			line: first ? lineOf(source, `"${first.name}"`) : 1,
+			description: changes.map((change) => `${change.name} ${change.from} → ${change.to}`).join(", ")
+		});
+		return output;
+	}
+};
+
+//#endregion
+export { node2215, warlockVersions };
+//# sourceMappingURL=package-json.mjs.map

package/esm/upgrade/codemods/package-json.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/package-json.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { compareVersions, parseVersion } from \"../version\";\n\nconst NODE_MINIMUM = \"22.15.0\";\n\ntype PackageJson = {\n  engines?: Record<string, unknown>;\n  dependencies?: Record<string, unknown>;\n  devDependencies?: Record<string, unknown>;\n};\n\n/** Keep the file's indentation and trailing newline when rewriting JSON. */\nfunction serialize(original: string, value: unknown): string {\n  const indent = /^[ \\t]+(?=\")/m.exec(original)?.[0];\n  // A one-line (minified) manifest stays on one line.\n  const json = indent ? JSON.stringify(value, null, indent) : JSON.stringify(value);\n  return json + (original.endsWith(\"\\n\") ? \"\\n\" : \"\");\n}\n\nfunction lineOf(source: string, needle: string): number {\n  const index = source.indexOf(needle);\n  return index < 0 ? 1 : source.slice(0, index).split(\"\\n\").length;\n}\n\n/**\n * 5.31: the CLI needs Node.js 22.15 or newer. Raises `engines.node` in\n * package.json and the version in `.nvmrc` / `.node-version` when they allow\n * an older Node.\n */\nexport const node2215: Codemod = {\n  id: \"node-22-15\",\n  version: \"5.31.0\",\n  package: \"@warlock.js/core\",\n  title: \"Require Node.js 22.15 or newer\",\n  skill: \"run-app\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    const source = context.text.read(\"package.json\");\n    if (source !== undefined) {\n      const pkg = JSON.parse(source) as PackageJson;\n      const current = pkg.engines?.node;\n      if (typeof current === \"string\") {\n        const minimum = parseVersion(current);\n        if (minimum && compareVersions(minimum.join(\".\"), NODE_MINIMUM) < 0) {\n          const line = lineOf(source, '\"node\"');\n          pkg.engines = { ...pkg.engines, node: \">=22.15\" };\n          context.text.write(\"package.json\", serialize(source, pkg), {\n            line,\n            description: `engines.node \"${current}\" → \">=22.15\"`,\n          });\n        }\n      }\n    }\n\n    for (const file of [\".nvmrc\", \".node-version\"]) {\n      const content = context.text.read(file);\n      if (content === undefined) continue;\n      const value = content.trim();\n      const parsed = /^v?\\d/.test(value) ? parseVersion(value) : undefined;\n      if (!parsed) {\n        if (value !== \"\" && !/^lts\\/|^node$|^latest$/i.test(value)) {\n          output.manual.push({\n            file,\n            line: 1,\n            hint: `Make sure \"${value}\" resolves to Node.js 22.15 or newer.`,\n          });\n        }\n        continue;\n      }\n      if (compareVersions(parsed.join(\".\"), NODE_MINIMUM) >= 0) continue;\n      const next = `${value.startsWith(\"v\") ? \"v\" : \"\"}22.15.0`;\n      context.text.write(file, `${next}\\n`, { line: 1, description: `Node ${value} → ${next}` });\n    }\n\n    return output;\n  },\n};\n\n/** Version specs that are not a plain range and must not be rewritten. */\nconst NON_REGISTRY_SPEC =\n  /^(workspace:|file:|link:|portal:|git|github:|https?:|npm:)|^\\*$|^latest$/;\n\n/**\n * Every upgrade: set each `@warlock.js/*` (and `create-warlock`) dependency to\n * the target version, keeping its `^`/`~`/exact style. The family is\n * released in lockstep, so mixed versions are not supported.\n */\nexport const warlockVersions: Codemod = {\n  id: \"warlock-versions\",\n  version: \"target\",\n  package: \"@warlock.js/core\",\n  title: \"Move the @warlock.js packages to the target version\",\n  skill: \"update-packages\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n    const source = context.text.read(\"package.json\");\n    if (source === undefined) return output;\n\n    const pkg = JSON.parse(source) as PackageJson;\n    const changes: { name: string; from: string; to: string }[] = [];\n\n    for (const field of [\"dependencies\", \"devDependencies\"] as const) {\n      const dependencies = pkg[field];\n      if (!dependencies) continue;\n      for (const [name, spec] of Object.entries(dependencies)) {\n        if (!name.startsWith(\"@warlock.js/\") && name !== \"create-warlock\") continue;\n        if (typeof spec !== \"string\" || NON_REGISTRY_SPEC.test(spec)) continue;\n        const prefix = /^[\\^~]/.exec(spec)?.[0] ?? (/^\\d/.test(spec) ? \"\" : \"^\");\n        const next = `${prefix}${context.targetVersion}`;\n        if (next === spec) continue;\n        dependencies[name] = next;\n        changes.push({ name, from: spec, to: next });\n      }\n    }\n\n    if (changes.length === 0) return output;\n\n    const first = changes[0];\n    context.text.write(\"package.json\", serialize(source, pkg), {\n      line: first ? lineOf(source, `\"${first.name}\"`) : 1,\n      description: changes\n        .map((change) => `${change.name} ${change.from} → ${change.to}`)\n        .join(\", \"),\n    });\n\n    return output;\n  },\n};\n"],"mappings":"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"}

package/esm/upgrade/codemods/request-log-snapshot.mjs

@@ -0,0 +1,82 @@
+import { importedLocalNames, manualAt, replaceNode } from "./helpers.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/request-log-snapshot.ts
+/** Fields of the `RequestLogSnapshot` a log channel now receives. */
+const SNAPSHOT_FIELDS = new Set([
+	"id",
+	"method",
+	"url",
+	"route",
+	"name",
+	"ip",
+	"userAgent",
+	"query",
+	"body",
+	"statusCode"
+]);
+/** `request.<a>.<b>` reads with a snapshot equivalent. */
+const REWRITES = {
+	"baseRequest.url": "url",
+	"baseRequest.method": "method",
+	"baseRequest.ip": "ip",
+	"route.path": "route",
+	"route.name": "name"
+};
+/**
+* 5.30: request log entries carry a plain `RequestLogSnapshot` in
+* `context.request`, not the `Request` instance. Inside custom log channels,
+* rewrites the reads that have a direct snapshot field and lists the rest.
+*/
+const requestLogSnapshot = {
+	id: "request-log-snapshot",
+	version: "5.30.0",
+	package: "@warlock.js/core",
+	title: "Read request log snapshots in custom log channels",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node, SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			if (importedLocalNames(sourceFile, "@warlock.js/logger", "LogChannel").size === 0) continue;
+			for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {
+				const owner = access.getExpression();
+				if (!Node.isPropertyAccessExpression(owner) || owner.getName() !== "context") continue;
+				const target = access.getName();
+				if (target !== "request" && target !== "response") continue;
+				const chain = memberChain(Node, access);
+				if (chain.length === 0) continue;
+				const first = chain[0];
+				const second = chain[1];
+				const pair = second ? `${first.getName()}.${second.getName()}` : void 0;
+				const replacement = pair ? REWRITES[pair] : void 0;
+				if (target === "request" && replacement && second) {
+					output.edits.push(replaceNode(context, second, `${access.getText()}.${replacement}`, `context.request.${pair} → context.request.${replacement}`));
+					continue;
+				}
+				const field = first.getName();
+				const isCall = Node.isCallExpression(first.getParent());
+				const readsRouteObject = target === "request" && field === "route" && second !== void 0;
+				if (!SNAPSHOT_FIELDS.has(field) || isCall || readsRouteObject) output.manual.push(manualAt(context, first, `\`context.${target}.${field}\` is not on the log snapshot ({ id, method, url, route, name, ip, userAgent, query?, body? }). Read a snapshot field, or call \`request.toLogSnapshot()\` where the entry is logged.`));
+			}
+		}
+		return output;
+	}
+};
+/** `x.context.request.a.b` → [`…request.a`, `…request.a.b`]. */
+function memberChain(Node, start) {
+	const chain = [];
+	let current = start;
+	for (;;) {
+		const parent = current.getParent();
+		if (!parent || !Node.isPropertyAccessExpression(parent) || parent.getExpression() !== current) return chain;
+		chain.push(parent);
+		current = parent;
+	}
+}
+
+//#endregion
+export { requestLogSnapshot };
+//# sourceMappingURL=request-log-snapshot.mjs.map

package/esm/upgrade/codemods/request-log-snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-log-snapshot.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/request-log-snapshot.ts"],"sourcesContent":["import type * as TsMorph from \"ts-morph\";\nimport type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\n/** Fields of the `RequestLogSnapshot` a log channel now receives. */\nconst SNAPSHOT_FIELDS = new Set([\n  \"id\",\n  \"method\",\n  \"url\",\n  \"route\",\n  \"name\",\n  \"ip\",\n  \"userAgent\",\n  \"query\",\n  \"body\",\n  \"statusCode\",\n]);\n\n/** `request.<a>.<b>` reads with a snapshot equivalent. */\nconst REWRITES: Record<string, string> = {\n  \"baseRequest.url\": \"url\",\n  \"baseRequest.method\": \"method\",\n  \"baseRequest.ip\": \"ip\",\n  \"route.path\": \"route\",\n  \"route.name\": \"name\",\n};\n\n/**\n * 5.30: request log entries carry a plain `RequestLogSnapshot` in\n * `context.request`, not the `Request` instance. Inside custom log channels,\n * rewrites the reads that have a direct snapshot field and lists the rest.\n */\nexport const requestLogSnapshot: Codemod = {\n  id: \"request-log-snapshot\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/core\",\n  title: \"Read request log snapshots in custom log channels\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      if (importedLocalNames(sourceFile, \"@warlock.js/logger\", \"LogChannel\").size === 0) continue;\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        const owner = access.getExpression();\n        // `<anything>.context.request` / `.context.response`\n        if (!Node.isPropertyAccessExpression(owner) || owner.getName() !== \"context\") continue;\n        const target = access.getName();\n        if (target !== \"request\" && target !== \"response\") continue;\n\n        const chain = memberChain(Node, access);\n        if (chain.length === 0) continue;\n\n        const first = chain[0] as TsMorph.PropertyAccessExpression;\n        const second = chain[1];\n        const pair = second ? `${first.getName()}.${second.getName()}` : undefined;\n        const replacement = pair ? REWRITES[pair] : undefined;\n\n        if (target === \"request\" && replacement && second) {\n          output.edits.push(\n            replaceNode(\n              context,\n              second,\n              `${access.getText()}.${replacement}`,\n              `context.request.${pair} → context.request.${replacement}`,\n            ),\n          );\n          continue;\n        }\n\n        const field = first.getName();\n        const isCall = Node.isCallExpression(first.getParent());\n        // `route` is the matched pattern string now, not the route object.\n        const readsRouteObject = target === \"request\" && field === \"route\" && second !== undefined;\n        if (!SNAPSHOT_FIELDS.has(field) || isCall || readsRouteObject) {\n          output.manual.push(\n            manualAt(\n              context,\n              first,\n              `\\`context.${target}.${field}\\` is not on the log snapshot ({ id, method, url, route, name, ip, userAgent, query?, body? }). Read a snapshot field, or call \\`request.toLogSnapshot()\\` where the entry is logged.`,\n            ),\n          );\n        }\n      }\n    }\n\n    return output;\n  },\n};\n\n/** `x.context.request.a.b` → [`…request.a`, `…request.a.b`]. */\nfunction memberChain(\n  Node: typeof TsMorph.Node,\n  start: TsMorph.PropertyAccessExpression,\n): TsMorph.PropertyAccessExpression[] {\n  const chain: TsMorph.PropertyAccessExpression[] = [];\n  let current: TsMorph.Node = start;\n\n  for (;;) {\n    const parent = current.getParent();\n    if (!parent || !Node.isPropertyAccessExpression(parent) || parent.getExpression() !== current) {\n      return chain;\n    }\n    chain.push(parent);\n    current = parent;\n  }\n}\n"],"mappings":";;;;AAKA,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAM,WAAmC;CACvC,mBAAmB;CACnB,sBAAsB;CACtB,kBAAkB;CAClB,cAAc;CACd,cAAc;AAChB;;;;;;AAOA,MAAa,qBAA8B;CACzC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,IAAI,mBAAmB,YAAY,sBAAsB,YAAY,CAAC,CAAC,SAAS,GAAG;GAEnF,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,MAAM,QAAQ,OAAO,cAAc;IAEnC,IAAI,CAAC,KAAK,2BAA2B,KAAK,KAAK,MAAM,QAAQ,MAAM,WAAW;IAC9E,MAAM,SAAS,OAAO,QAAQ;IAC9B,IAAI,WAAW,aAAa,WAAW,YAAY;IAEnD,MAAM,QAAQ,YAAY,MAAM,MAAM;IACtC,IAAI,MAAM,WAAW,GAAG;IAExB,MAAM,QAAQ,MAAM;IACpB,MAAM,SAAS,MAAM;IACrB,MAAM,OAAO,SAAS,GAAG,MAAM,QAAQ,EAAE,GAAG,OAAO,QAAQ,MAAM;IACjE,MAAM,cAAc,OAAO,SAAS,QAAQ;IAE5C,IAAI,WAAW,aAAa,eAAe,QAAQ;KACjD,OAAO,MAAM,KACX,YACE,SACA,QACA,GAAG,OAAO,QAAQ,EAAE,GAAG,eACvB,mBAAmB,KAAK,qBAAqB,aAC/C,CACF;KACA;IACF;IAEA,MAAM,QAAQ,MAAM,QAAQ;IAC5B,MAAM,SAAS,KAAK,iBAAiB,MAAM,UAAU,CAAC;IAEtD,MAAM,mBAAmB,WAAW,aAAa,UAAU,WAAW,WAAW;IACjF,IAAI,CAAC,gBAAgB,IAAI,KAAK,KAAK,UAAU,kBAC3C,OAAO,OAAO,KACZ,SACE,SACA,OACA,aAAa,OAAO,GAAG,MAAM,sLAC/B,CACF;GAEJ;EACF;EAEA,OAAO;CACT;AACF;;AAGA,SAAS,YACP,MACA,OACoC;CACpC,MAAM,QAA4C,CAAC;CACnD,IAAI,UAAwB;CAE5B,SAAS;EACP,MAAM,SAAS,QAAQ,UAAU;EACjC,IAAI,CAAC,UAAU,CAAC,KAAK,2BAA2B,MAAM,KAAK,OAAO,cAAc,MAAM,SACpF,OAAO;EAET,MAAM,KAAK,MAAM;EACjB,UAAU;CACZ;AACF"}