playcademy 0.28.1-beta.13 → 0.28.1-beta.14

package/dist/bucket.d.ts

@@ -138,6 +138,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -170,6 +183,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**

package/dist/bucket.js

@@ -44,7 +44,7 @@ var GAME_API_ROUTES_DIRECTORY = join2(GAME_SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21-beta.13",
+  version: "0.0.21-beta.14",
   type: "module",
   exports: {
     "./server": {

package/dist/cli.js

@@ -514,7 +514,10 @@ function nestColor(content, color2) {
 function customTransform(text) {
   let result = text;
   result = result.replace(/<<([^>]+)>>/g, (_, url) => blueBright(underline(url)));
-  result = result.replace(/<([^>]+)>/g, (_, inner) => blueBright(`<${inner}>`));
+  result = result.replace(
+    /<([^>]+)>/g,
+    (match, inner) => blueBright(/[./]/.test(inner) ? inner : match)
+  );
   result = result.replace(/`([^`]+)`/g, (_, code) => nestColor(code, greenBright));
   return result;
 }
@@ -1207,7 +1210,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21-beta.13",
+  version: "0.0.21-beta.14",
   type: "module",
   exports: {
     "./server": {
@@ -3041,7 +3044,7 @@ import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as re
 import { join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.28.1-beta.13";
+var cliVersion = false ? "0.0.0-dev" : "0.28.1-beta.14";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");

package/dist/constants.js

@@ -21,7 +21,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21-beta.13",
+  version: "0.0.21-beta.14",
   type: "module",
   exports: {
     "./server": {

package/dist/db.js

@@ -2335,7 +2335,7 @@ var GAME_API_ROUTES_DIRECTORY = join2(GAME_SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21-beta.13",
+  version: "0.0.21-beta.14",
   type: "module",
   exports: {
     "./server": {
@@ -2817,7 +2817,10 @@ function nestColor(content, color2) {
 function customTransform(text) {
   let result = text;
   result = result.replace(/<<([^>]+)>>/g, (_, url) => blueBright(underline(url)));
-  result = result.replace(/<([^>]+)>/g, (_, inner) => blueBright(`<${inner}>`));
+  result = result.replace(
+    /<([^>]+)>/g,
+    (match, inner) => blueBright(/[./]/.test(inner) ? inner : match)
+  );
   result = result.replace(/`([^`]+)`/g, (_, code) => nestColor(code, greenBright));
   return result;
 }

package/dist/index.d.ts

@@ -479,6 +479,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -511,6 +524,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**

package/dist/index.js

@@ -2346,7 +2346,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21-beta.13",
+  version: "0.0.21-beta.14",
   type: "module",
   exports: {
     "./server": {
@@ -3168,7 +3168,10 @@ function nestColor(content, color2) {
 function customTransform(text4) {
   let result = text4;
   result = result.replace(/<<([^>]+)>>/g, (_, url) => blueBright(underline(url)));
-  result = result.replace(/<([^>]+)>/g, (_, inner) => blueBright(`<${inner}>`));
+  result = result.replace(
+    /<([^>]+)>/g,
+    (match, inner) => blueBright(/[./]/.test(inner) ? inner : match)
+  );
   result = result.replace(/`([^`]+)`/g, (_, code) => nestColor(code, greenBright));
   return result;
 }
@@ -6235,7 +6238,7 @@ async function checkbox(config) {
 // src/lib/core/subprocess.ts
 import { spawn } from "node:child_process";
 function runShell(command, options = {}) {
-  return new Promise((resolve18, reject) => {
+  return new Promise((resolve19, reject) => {
     const env = { ...options.env ?? process.env };
     delete env.ESBUILD_BINARY_PATH;
     const child = spawn(command, {
@@ -6255,7 +6258,7 @@ function runShell(command, options = {}) {
     child.on("error", reject);
     child.on("close", (code) => {
       if (code === 0) {
-        resolve18();
+        resolve19();
       } else {
         reject(
           Object.assign(new Error(`Command failed: ${command}`), {
@@ -6468,7 +6471,7 @@ import { existsSync as existsSync11, mkdirSync as mkdirSync2, readFileSync as re
 import { join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.28.1-beta.13";
+var cliVersion = false ? "0.0.0-dev" : "0.28.1-beta.14";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
@@ -10160,14 +10163,14 @@ function readServerInfo(type, projectRoot) {
   return servers[0] || null;
 }
 async function isPortInUse(port) {
-  return new Promise((resolve18) => {
+  return new Promise((resolve19) => {
     const server = createServer();
     server.once("error", () => {
-      resolve18(true);
+      resolve19(true);
     });
     server.once("listening", () => {
       server.close();
-      resolve18(false);
+      resolve19(false);
     });
     server.listen(port, "0.0.0.0");
   });
@@ -10178,7 +10181,7 @@ async function waitForPort(port, timeoutMs = 5e3) {
     if (Date.now() - start > timeoutMs) {
       throw new Error(`Port ${port} is already in use`);
     }
-    await new Promise((resolve18) => setTimeout(resolve18, 100));
+    await new Promise((resolve19) => setTimeout(resolve19, 100));
   }
 }
 
@@ -13451,7 +13454,7 @@ function sleep(ms) {
   if (ms <= 0) {
     return Promise.resolve();
   }
-  return new Promise((resolve18) => setTimeout(resolve18, ms));
+  return new Promise((resolve19) => setTimeout(resolve19, ms));
 }
 async function runWithConcurrency(items, concurrency, worker) {
   if (items.length === 0) {
@@ -15848,21 +15851,21 @@ var Matcher = class {
    * @returns {string}
    */
   toString(separator, includeNamespace = true) {
-    const sep6 = separator || this.separator;
-    const isDefault = sep6 === this.separator && includeNamespace === true;
+    const sep7 = separator || this.separator;
+    const isDefault = sep7 === this.separator && includeNamespace === true;
     if (isDefault) {
       if (this._pathStringCache !== null) {
         return this._pathStringCache;
       }
       const result = this.path.map(
         (n) => n.namespace ? `${n.namespace}:${n.tag}` : n.tag
-      ).join(sep6);
+      ).join(sep7);
       this._pathStringCache = result;
       return result;
     }
     return this.path.map(
       (n) => includeNamespace && n.namespace ? `${n.namespace}:${n.tag}` : n.tag
-    ).join(sep6);
+    ).join(sep7);
   }
   /**
    * Get path as array of tag names.
@@ -24798,6 +24801,162 @@ async function bundleStubWorker() {
   return cachedBundle;
 }
 
+// src/lib/catalog/document.ts
+import {
+  CATALOG_LEVELS,
+  CATALOG_READINESS,
+  CHILD_ATTEMPT_CONTRACT,
+  CHILD_CATALOG_CONTRACT
+} from "@playcademy/sdk/contracts";
+var CatalogError = class extends Error {
+  hint;
+  constructor(message2, hint) {
+    super(message2);
+    this.name = "CatalogError";
+    this.hint = hint;
+  }
+};
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function assertExtractorOutput(value) {
+  if (!isRecord3(value)) {
+    throw new CatalogError("Extractor output must be a JSON object");
+  }
+  if (typeof value.generatedFrom !== "string" || value.generatedFrom.length === 0) {
+    throw new CatalogError(
+      'Extractor output is missing "generatedFrom"',
+      'Name the in-repo source of truth, e.g. "data/e_level_route_catalog.json"'
+    );
+  }
+  if (!isRecord3(value.deliveries)) {
+    throw new CatalogError(
+      'Extractor output is missing "deliveries" (lesson id \u2192 level \u2192 readiness)'
+    );
+  }
+  for (const [lessonId, levels] of Object.entries(value.deliveries)) {
+    if (!isRecord3(levels)) {
+      throw new CatalogError(`Delivery "${lessonId}" must map levels to readiness`);
+    }
+    for (const [level, readiness] of Object.entries(levels)) {
+      if (!CATALOG_LEVELS.includes(level)) {
+        throw new CatalogError(
+          `Delivery "${lessonId}" has unknown level "${level}"`,
+          `Levels are: ${CATALOG_LEVELS.join(", ")}`
+        );
+      }
+      if (!CATALOG_READINESS.includes(readiness)) {
+        throw new CatalogError(
+          `Delivery "${lessonId}" level "${level}" has unknown readiness "${String(readiness)}"`,
+          `Readiness values are: ${CATALOG_READINESS.join(", ")}`
+        );
+      }
+    }
+  }
+}
+function buildCatalog(output, generatedBy) {
+  return {
+    contract: CHILD_CATALOG_CONTRACT,
+    evidence: CHILD_ATTEMPT_CONTRACT,
+    generatedBy,
+    generatedFrom: output.generatedFrom,
+    deliveries: output.deliveries
+  };
+}
+function sortDeep(value) {
+  if (Array.isArray(value)) {
+    return value.map(sortDeep);
+  }
+  if (isRecord3(value)) {
+    const out = {};
+    for (const key of Object.keys(value).toSorted()) {
+      out[key] = sortDeep(value[key]);
+    }
+    return out;
+  }
+  return value;
+}
+function renderCatalog(catalog) {
+  return `${JSON.stringify(sortDeep(catalog), null, 2)}
+`;
+}
+
+// src/lib/catalog/extract.ts
+import { spawnSync } from "node:child_process";
+import { existsSync as existsSync32, mkdirSync as mkdirSync11, readFileSync as readFileSync15, writeFileSync as writeFileSync17 } from "node:fs";
+import { dirname as dirname9, join as join44, relative as relative7, resolve as resolve14, sep as sep4 } from "node:path";
+function jsRuntime() {
+  if (!process.isBun) {
+    return process.execPath;
+  }
+  const found = Bun.which("bun") ?? Bun.which("node");
+  if (!found) {
+    throw new CatalogError(
+      "No JavaScript runtime found to run the extractor",
+      "Install bun (or node) and make sure it is on PATH"
+    );
+  }
+  return found;
+}
+var CATALOG_PATH = ".playcademy/catalog.json";
+function assertNotIgnored(path4, root) {
+  const result = spawnSync("git", ["check-ignore", "-q", path4], { cwd: root });
+  if (result.error || result.status !== 0) {
+    return;
+  }
+  throw new CatalogError(
+    `<${CATALOG_PATH}> is gitignored, so it would never be committed or synced`,
+    "Narrow the ignore: replace '.playcademy' with '.playcademy/*' plus '!.playcademy/catalog.json'"
+  );
+}
+async function extractCatalog() {
+  const { config, configPath } = await loadConfigWithPath();
+  const root = dirname9(configPath);
+  const extractor = config.catalog?.extractor;
+  if (!extractor) {
+    throw new CatalogError(
+      "No catalog extractor configured",
+      "Add `catalog: { extractor: './tools/extract-catalog.mjs' }` to <playcademy.config>"
+    );
+  }
+  const extractorPath = resolve14(root, extractor);
+  if (!existsSync32(extractorPath)) {
+    throw new CatalogError(`Catalog extractor not found: <${extractor}>`);
+  }
+  const result = spawnSync(jsRuntime(), [extractorPath], {
+    cwd: root,
+    encoding: "utf8",
+    maxBuffer: 16 * 1024 * 1024
+  });
+  if (result.status !== 0) {
+    throw new CatalogError(
+      `Catalog extractor exited with ${String(result.status)}`,
+      result.stderr?.trim() || void 0
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(result.stdout);
+  } catch {
+    throw new CatalogError(
+      "Catalog extractor did not print valid JSON on stdout",
+      "The extractor must print only the JSON document (log to stderr instead)"
+    );
+  }
+  assertExtractorOutput(parsed);
+  const generatedBy = relative7(root, extractorPath).split(sep4).join("/");
+  const catalog = buildCatalog(parsed, generatedBy);
+  const path4 = join44(root, CATALOG_PATH);
+  assertNotIgnored(path4, root);
+  const rendered = renderCatalog(catalog);
+  const existing = existsSync32(path4) ? readFileSync15(path4, "utf8") : "";
+  return { catalog, path: path4, rendered, current: existing === rendered };
+}
+function writeCatalog(run) {
+  mkdirSync11(dirname9(run.path), { recursive: true });
+  writeFileSync17(run.path, run.rendered);
+}
+
 // src/lib/dashboard/report.ts
 import { underline as underline2 } from "colorette";
 function reportCredentialLink(kind, email, token, dashboardUrl) {
@@ -24885,8 +25044,8 @@ async function bootstrapDashboardAdmin(slug, dashboardUrl) {
 }
 
 // src/lib/dashboard/init.ts
-import { existsSync as existsSync32, mkdirSync as mkdirSync11, readdirSync as readdirSync4, readFileSync as readFileSync15, writeFileSync as writeFileSync17 } from "node:fs";
-import { join as join44, normalize as normalize3, resolve as resolve14 } from "node:path";
+import { existsSync as existsSync33, mkdirSync as mkdirSync12, readdirSync as readdirSync4, readFileSync as readFileSync16, writeFileSync as writeFileSync18 } from "node:fs";
+import { join as join45, normalize as normalize3, resolve as resolve15 } from "node:path";
 var DASHBOARD_PLUGIN_CALL = "playcademy({ dashboard: true })";
 function resolveScaffoldDirectory(dashboard, requested) {
   const normalized = normalizeDashboardConfig(dashboard);
@@ -24905,8 +25064,8 @@ async function scaffoldDashboard(options) {
   const { config, configPath, configDir } = await loadConfigWithPath(options.configPath);
   setCliContext({ workspace: configDir });
   const directory = resolveScaffoldDirectory(config.dashboard, options.directory);
-  const destDir = resolve14(configDir, directory);
-  if (existsSync32(destDir) && readdirSync4(destDir).length > 0) {
+  const destDir = resolve15(configDir, directory);
+  if (existsSync33(destDir) && readdirSync4(destDir).length > 0) {
     throw new Error(
       `${directory} already exists and is not empty. Remove it or pass a different directory.`
     );
@@ -24938,10 +25097,10 @@ async function scaffoldDashboard(options) {
   displayNextSteps(pm, directory);
 }
 function renamePackage(destDir, projectName) {
-  const pkgPath = join44(destDir, "package.json");
-  const pkg = JSON.parse(readFileSync15(pkgPath, "utf8"));
+  const pkgPath = join45(destDir, "package.json");
+  const pkg = JSON.parse(readFileSync16(pkgPath, "utf8"));
   pkg.name = `${generateSlug(projectName)}-dashboard`;
-  writeFileSync17(pkgPath, `${JSON.stringify(pkg, null, 2)}
+  writeFileSync18(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `);
 }
 async function configureVitePlugin(destDir) {
@@ -24955,7 +25114,7 @@ async function configureVitePlugin(destDir) {
 async function enableDashboardInConfig(configPath, directory) {
   const value = dashboardConfigValue(directory);
   const valueSource = value === true ? "true" : `{ directory: '${directory}' }`;
-  const content = readFileSync15(configPath, "utf8");
+  const content = readFileSync16(configPath, "utf8");
   if (configPath.endsWith(".json")) {
     const parsed = JSON.parse(content);
     if (parsed.dashboard !== void 0 && parsed.dashboard !== false) {
@@ -24968,13 +25127,13 @@ async function enableDashboardInConfig(configPath, directory) {
       "dashboard",
       value
     ]);
-    writeFileSync17(configPath, `${JSON.stringify(Object.fromEntries(entries), null, 4)}
+    writeFileSync18(configPath, `${JSON.stringify(Object.fromEntries(entries), null, 4)}
 `);
     return;
   }
   const disabledKey = /(["']?dashboard["']?\s*:\s*)false/;
   if (disabledKey.test(content)) {
-    writeFileSync17(configPath, content.replace(disabledKey, `$1${valueSource}`));
+    writeFileSync18(configPath, content.replace(disabledKey, `$1${valueSource}`));
     await formatConfigWithPrettier(configPath);
     return;
   }
@@ -24988,7 +25147,7 @@ async function enableDashboardInConfig(configPath, directory) {
     ]);
     return;
   }
-  writeFileSync17(configPath, updated);
+  writeFileSync18(configPath, updated);
   await formatConfigWithPrettier(configPath);
 }
 function displayNextSteps(pm, directory) {
@@ -25003,17 +25162,17 @@ function displayNextSteps(pm, directory) {
   logger.newLine();
 }
 function scaffoldSampleApiRoute(destDir) {
-  const apiDir = join44(destDir, DASHBOARD_API_ROUTES_DIRECTORY);
-  if (existsSync32(apiDir)) {
+  const apiDir = join45(destDir, DASHBOARD_API_ROUTES_DIRECTORY);
+  if (existsSync33(apiDir)) {
     return;
   }
-  mkdirSync11(apiDir, { recursive: true });
-  writeFileSync17(join44(apiDir, "whoami.ts"), loadTemplateString("dashboard-sample-route.ts"));
-  const gitignorePath = join44(destDir, ".gitignore");
+  mkdirSync12(apiDir, { recursive: true });
+  writeFileSync18(join45(apiDir, "whoami.ts"), loadTemplateString("dashboard-sample-route.ts"));
+  const gitignorePath = join45(destDir, ".gitignore");
   const entry = "dashboard-env.d.ts";
-  const existing = existsSync32(gitignorePath) ? readFileSync15(gitignorePath, "utf8") : "";
+  const existing = existsSync33(gitignorePath) ? readFileSync16(gitignorePath, "utf8") : "";
   if (!existing.split("\n").some((line) => line.trim() === entry)) {
-    writeFileSync17(
+    writeFileSync18(
       gitignorePath,
       `${existing.replace(/\n*$/, "\n")}
 # Generated by Playcademy
@@ -25087,7 +25246,7 @@ async function loadProjectBase(configPath) {
 
 // src/lib/upgrade/channel.ts
 import { mkdir as mkdir6, readFile as readFile6, writeFile as writeFile5 } from "node:fs/promises";
-import { join as join45 } from "node:path";
+import { join as join46 } from "node:path";
 var RELEASE_CHANNELS = ["stable", "beta"];
 var CDN_BASE_URLS = {
   stable: "https://cdn.playcademy.net/cli",
@@ -25101,7 +25260,7 @@ function getLatestVersionUrl(channel) {
 }
 var CHANNEL_FILE = "channel";
 function getChannelFilePath() {
-  return join45(getConfigDir(), CHANNEL_FILE);
+  return join46(getConfigDir(), CHANNEL_FILE);
 }
 function channelFromVersion(version3) {
   return version3.includes("-beta") ? "beta" : "stable";
@@ -25135,18 +25294,18 @@ var KNOWN_KEYS = [
   "@playcademy/sdk",
   "@playcademy/vite-plugin"
 ];
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var FLOOR_VERSION_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
 function validateCompatibilityManifest(data) {
-  if (!isRecord3(data)) {
+  if (!isRecord4(data)) {
     return null;
   }
   if (typeof data.updatedAt !== "string") {
     return null;
   }
-  if (!isRecord3(data.minimumVersions)) {
+  if (!isRecord4(data.minimumVersions)) {
     return null;
   }
   const minimumVersions = {};
@@ -25183,7 +25342,7 @@ async function fetchCompatibilityManifest(channel) {
 }
 
 // src/lib/deploy/game/baseline-evidence.ts
-import { existsSync as existsSync33 } from "fs";
+import { existsSync as existsSync34 } from "fs";
 import { readFile as readFile7 } from "fs/promises";
 async function loadBaselineEvidence() {
   const migrationsDir = await getMigrationsDirectory();
@@ -25199,7 +25358,7 @@ async function loadBaselineEvidence() {
   let previous = { tables: {} };
   for (const entry of sorted) {
     const snapshotPath = migrationSnapshotPath(migrationsDir, entry.idx);
-    if (!existsSync33(snapshotPath)) {
+    if (!existsSync34(snapshotPath)) {
       return null;
     }
     const snapshot = JSON.parse(await readFile7(snapshotPath, "utf8"));
@@ -25561,13 +25720,13 @@ async function loadDeployConfig(configPath) {
 }
 
 // src/lib/deploy/dashboard.ts
-import { existsSync as existsSync35 } from "node:fs";
-import { join as join48 } from "node:path";
+import { existsSync as existsSync36 } from "node:fs";
+import { join as join49 } from "node:path";
 import { underline as underline3 } from "colorette";
 
 // ../utils/src/zip.ts
 import { mkdir as mkdir7, readdir, readFile as readFile8, writeFile as writeFile6 } from "fs/promises";
-import { join as join46, relative as relative7, sep as sep4 } from "path";
+import { join as join47, relative as relative8, sep as sep5 } from "path";
 import JSZip2 from "jszip";
 async function createZipFromDirectory(sourceDir) {
   try {
@@ -25575,8 +25734,8 @@ async function createZipFromDirectory(sourceDir) {
     const entries = await readdir(sourceDir, { withFileTypes: true, recursive: true });
     for (const entry of entries) {
       if (entry.isFile()) {
-        const filePath = join46(entry.parentPath, entry.name);
-        const entryName = relative7(sourceDir, filePath).replaceAll(sep4, "/");
+        const filePath = join47(entry.parentPath, entry.name);
+        const entryName = relative8(sourceDir, filePath).replaceAll(sep5, "/");
         zip.file(entryName, readFile8(filePath));
       }
     }
@@ -25703,8 +25862,8 @@ async function executeUpdates(workspace, deps) {
 }
 
 // src/lib/deploy/version-gate.ts
-import { existsSync as existsSync34, readFileSync as readFileSync16 } from "node:fs";
-import { join as join47 } from "node:path";
+import { existsSync as existsSync35, readFileSync as readFileSync17 } from "node:fs";
+import { join as join48 } from "node:path";
 
 // src/lib/upgrade/version.ts
 var SAFE_VERSION_PATTERN = /^(?:[0-9a-zA-Z][0-9a-zA-Z._\-+]*|[vV][0-9a-zA-Z][0-9a-zA-Z._\-+]*)$/;
@@ -25825,12 +25984,12 @@ function isDevCliVersion(version3) {
   return version3.startsWith("0.0.0") || version3.includes("-dev");
 }
 function resolveInstalledVersion(name, cwd) {
-  const pkgJsonPath = join47(cwd, "node_modules", name, "package.json");
-  if (!existsSync34(pkgJsonPath)) {
+  const pkgJsonPath = join48(cwd, "node_modules", name, "package.json");
+  if (!existsSync35(pkgJsonPath)) {
     return null;
   }
   try {
-    const parsed = JSON.parse(readFileSync16(pkgJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync17(pkgJsonPath, "utf8"));
     return typeof parsed.version === "string" ? parsed.version : null;
   } catch {
     return null;
@@ -25990,7 +26149,7 @@ async function deployDashboard(options) {
       () => runShell(dashboard.buildCommand, { cwd: dashboard.directory })
     );
   }
-  if (!existsSync35(join48(dashboard.buildPath, "index.html"))) {
+  if (!existsSync36(join49(dashboard.buildPath, "index.html"))) {
     throw new Error(
       `Dashboard build output at ${dashboard.buildPath} has no index.html; check the dashboard's build configuration`
     );
@@ -26603,7 +26762,7 @@ function displayDeploymentDiff(options) {
 }
 
 // src/lib/deploy/game/interaction.ts
-import { join as join50 } from "path";
+import { join as join51 } from "path";
 import { bold as bold9 } from "colorette";
 import { ApiError as ApiError4 } from "@playcademy/sdk/internal";
 
@@ -26670,7 +26829,7 @@ var DEPLOY_REFUSAL_CODES = new Set(REFUSAL_CODES);
 
 // src/lib/deploy/game/rollback-check.ts
 import { readFile as readFile9 } from "node:fs/promises";
-import { resolve as resolve15 } from "node:path";
+import { resolve as resolve16 } from "node:path";
 import JSZip3 from "jszip";
 var PLAYCADEMY_MANIFEST_FILE = "playcademy.manifest.json";
 var TRACKED_VERSIONS = [
@@ -26697,11 +26856,11 @@ function rollbackDisplayName(name) {
   return TRACKED_VERSIONS.find((entry) => entry.key === name).displayName;
 }
 function isManifestV2(manifest) {
-  return isRecord3(manifest) && manifest.version === "2" && isRecord3(manifest.versions);
+  return isRecord4(manifest) && manifest.version === "2" && isRecord4(manifest.versions);
 }
 async function readBuildManifest(buildPath) {
   try {
-    const zip = await JSZip3.loadAsync(await readFile9(resolve15(buildPath)));
+    const zip = await JSZip3.loadAsync(await readFile9(resolve16(buildPath)));
     const manifestFile = zip.file(PLAYCADEMY_MANIFEST_FILE) ?? Object.values(zip.files).find(
       (file) => !file.dir && file.name.endsWith(`/${PLAYCADEMY_MANIFEST_FILE}`)
     );
@@ -26746,7 +26905,7 @@ async function detectVersionRollback(context2, plan, fetchLiveGame) {
 }
 
 // src/lib/deploy/game/timeback-drift.ts
-import { basename as basename3, join as join49 } from "node:path";
+import { basename as basename3, join as join50 } from "node:path";
 async function detectDeployTimebackDrift(context2) {
   const timebackConfig = context2.fullConfig?.integrations?.timeback;
   const gameId = context2.existingGame?.id;
@@ -26871,7 +27030,7 @@ async function applyDeployTimebackConfigSync(args) {
     timebackConfig,
     snapshot.platformConfigs
   );
-  const configPath = join49(context2.projectPath, context2.configFileName);
+  const configPath = join50(context2.projectPath, context2.configFileName);
   await updateTimebackConfig(configPath, nextTimeback);
   fullConfig.integrations.timeback = nextTimeback;
   logger.success(
@@ -26958,14 +27117,14 @@ function getLocalOverrideCourseChangeCounts(snapshot) {
 }
 
 // src/lib/deploy/game/validate.ts
-import { existsSync as existsSync36 } from "fs";
-import { resolve as resolve16 } from "path";
+import { existsSync as existsSync37 } from "fs";
+import { resolve as resolve17 } from "path";
 function validateBuildPath(path4) {
   if (!path4.trim()) {
     return "Build path is required";
   }
-  const resolvedPath = resolve16(path4.trim());
-  if (!existsSync36(resolvedPath)) {
+  const resolvedPath = resolve17(path4.trim());
+  if (!existsSync37(resolvedPath)) {
     return `Build path not found: ${path4.trim()}`;
   }
   return true;
@@ -27520,7 +27679,7 @@ async function applyPlatformValuesToLocalConfig(args) {
     writeDisplayName
   });
   applyUpdatesToContext(context2, updates, writeDisplayName);
-  const configPath = join50(context2.projectPath, context2.configFileName);
+  const configPath = join51(context2.projectPath, context2.configFileName);
   const result = await updateConfigScalars(configPath, updates);
   reportConfigUpdate(result, unresolvableLabels, context2.configFileName);
   return true;
@@ -27635,7 +27794,7 @@ var PLAYCADEMY_PLATFORM_VALUES = ["web", "godot"];
 function narrowToPlaycademyPlatform(value) {
   return PLAYCADEMY_PLATFORM_VALUES.includes(value) ? value : null;
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function extractDeployServerError(error) {
@@ -27643,7 +27802,7 @@ function extractDeployServerError(error) {
     return null;
   }
   const details = error.details;
-  if (!isRecord4(details)) {
+  if (!isRecord5(details)) {
     return null;
   }
   if (typeof details.code === "string") {
@@ -27652,7 +27811,7 @@ function extractDeployServerError(error) {
   if (Array.isArray(details.events)) {
     for (let i = details.events.length - 1; i >= 0; i--) {
       const event = details.events[i];
-      if (isRecord4(event) && isRecord4(event.details) && typeof event.details.code === "string") {
+      if (isRecord5(event) && isRecord5(event.details) && typeof event.details.code === "string") {
         return { code: event.details.code, message: error.message, details: event.details };
       }
     }
@@ -27672,7 +27831,7 @@ function verdictLines(value) {
   if (!Array.isArray(value)) {
     return [];
   }
-  return value.filter(isRecord4).filter((entry) => typeof entry.tag === "string").map(
+  return value.filter(isRecord5).filter((entry) => typeof entry.tag === "string").map(
     (entry) => `  ${entry.tag}${typeof entry.detail === "string" ? `: ${entry.detail}` : ""}`
   );
 }
@@ -27702,7 +27861,7 @@ function reportDeploymentStateConflict(serverError, claimedBaselineHash, current
 function migrationFailureGuidance(args) {
   const { tag: tag2, d1Message, details, context: context2 } = args;
   const resolveHint = `  \`${repairCommand(`db mark ${tag2} --applied`)}\``;
-  const assessment = isRecord4(details.alreadyApplied) ? details.alreadyApplied : null;
+  const assessment = isRecord5(details.alreadyApplied) ? details.alreadyApplied : null;
   const present = stringList(assessment?.present);
   const missing = stringList(assessment?.missing);
   if (assessment?.verdict === "all-present") {
@@ -27941,7 +28100,7 @@ function renderDeployServerError(error, context2) {
     }
     case DEPLOY_ERROR_CODES.checksumMismatch: {
       const mismatches = Array.isArray(details.mismatches) ? details.mismatches : [];
-      const tags = mismatches.filter(isRecord4).map((mismatch) => mismatch.tag).filter((tag2) => typeof tag2 === "string");
+      const tags = mismatches.filter(isRecord5).map((mismatch) => mismatch.tag).filter((tag2) => typeof tag2 === "string");
       logger.admonition("warning", "Migration Checksum Mismatch", checksumMismatchLines(tags));
       return true;
     }
@@ -28257,7 +28416,7 @@ function logDeploymentPlanDebug(plan, context2) {
 
 // src/lib/deploy/game/preparation.ts
 import { stat } from "node:fs/promises";
-import { join as join51 } from "node:path";
+import { join as join52 } from "node:path";
 
 // ../data/src/domains/game/helpers.ts
 import { and, eq } from "drizzle-orm";
@@ -29114,8 +29273,8 @@ async function bundleAndHash(context2) {
     });
     const bundleHash = hashContent(bundle.code);
     const [serverSize, dbSize] = await Promise.all([
-      getDirectorySize(join51(context2.projectPath, GAME_SERVER_ROOT_DIRECTORY)),
-      getDirectorySize(join51(context2.projectPath, DEFAULT_DATABASE_DIRECTORY))
+      getDirectorySize(join52(context2.projectPath, GAME_SERVER_ROOT_DIRECTORY)),
+      getDirectorySize(join52(context2.projectPath, DEFAULT_DATABASE_DIRECTORY))
     ]);
     context2.currentBackendBundle = bundle;
     context2.currentBackendBundleHash = bundleHash;
@@ -29285,12 +29444,12 @@ function hasOptionalFieldsMissing(missing) {
 }
 
 // src/lib/deploy/game/steps.ts
-import { existsSync as existsSync37 } from "fs";
+import { existsSync as existsSync38 } from "fs";
 import { readFile as readFile10 } from "fs/promises";
-import { basename as basename4, resolve as resolve17 } from "path";
+import { basename as basename4, resolve as resolve18 } from "path";
 async function prepareBuildFile(buildPath) {
-  const resolvedPath = resolve17(buildPath);
-  if (resolvedPath.endsWith(".zip") && existsSync37(resolvedPath)) {
+  const resolvedPath = resolve18(buildPath);
+  if (resolvedPath.endsWith(".zip") && existsSync38(resolvedPath)) {
     const buffer = await readFile10(resolvedPath);
     const uint8Array = new Uint8Array(buffer);
     const blob = new Blob([uint8Array], { type: "application/zip" });
@@ -29595,11 +29754,11 @@ import { dim as dim9 } from "colorette";
 
 // src/lib/nudge/state.ts
 import { mkdir as mkdir8, readFile as readFile11, writeFile as writeFile7 } from "node:fs/promises";
-import { join as join52 } from "node:path";
+import { join as join53 } from "node:path";
 var NUDGE_STATE_FILE = "nudge-state.json";
 var NUDGE_COOLDOWN_MS = 24 * 60 * 60 * 1e3;
 function getStatePath() {
-  return join52(getConfigDir(), NUDGE_STATE_FILE);
+  return join53(getConfigDir(), NUDGE_STATE_FILE);
 }
 async function loadNudgeState() {
   try {
@@ -29675,35 +29834,35 @@ async function maybeShowUpdateNudge(options) {
 }
 
 // src/lib/db/path.ts
-import { copyFileSync, existsSync as existsSync38, mkdirSync as mkdirSync12, readdirSync as readdirSync5, unlinkSync } from "fs";
-import { join as join53 } from "path";
+import { copyFileSync, existsSync as existsSync39, mkdirSync as mkdirSync13, readdirSync as readdirSync5, unlinkSync } from "fs";
+import { join as join54 } from "path";
 var DB_DIRECTORY = CLI_DIRECTORIES.DATABASE;
 var INITIAL_DB_NAME = CLI_FILES.INITIAL_DATABASE;
 function ensureDirectoryExists(dir) {
-  if (!existsSync38(dir)) {
-    mkdirSync12(dir, { recursive: true });
+  if (!existsSync39(dir)) {
+    mkdirSync13(dir, { recursive: true });
   }
 }
 function findMiniflareDatabase(dbDir) {
-  const miniflareDir = join53(dbDir, MINIFLARE_D1_DIRECTORY);
-  if (!existsSync38(miniflareDir)) {
+  const miniflareDir = join54(dbDir, MINIFLARE_D1_DIRECTORY);
+  if (!existsSync39(miniflareDir)) {
     return null;
   }
   const sqliteFiles = readdirSync5(miniflareDir).filter((file) => file.endsWith(".sqlite"));
   if (sqliteFiles.length === 0) {
     return null;
   }
-  return join53(miniflareDir, sqliteFiles[0]);
+  return join54(miniflareDir, sqliteFiles[0]);
 }
 function migrateInitialDbToTarget(initialPath, targetPath) {
-  if (!existsSync38(initialPath)) {
+  if (!existsSync39(initialPath)) {
     return;
   }
   copyFileSync(initialPath, targetPath);
   unlinkSync(initialPath);
 }
 function getDevDbPath() {
-  const initialDbPath = join53(DB_DIRECTORY, INITIAL_DB_NAME);
+  const initialDbPath = join54(DB_DIRECTORY, INITIAL_DB_NAME);
   ensureDirectoryExists(DB_DIRECTORY);
   const miniflareDbPath = findMiniflareDatabase(DB_DIRECTORY);
   if (miniflareDbPath) {
@@ -30404,10 +30563,10 @@ async function bundleSeedWorker(seedFilePath, projectPath) {
 // src/lib/db/reset.ts
 import { execSync as execSync8 } from "child_process";
 import { rmSync as rmSync3 } from "fs";
-import { join as join54 } from "path";
+import { join as join55 } from "path";
 async function resetDatabase(workspace, mf, options = { debug: false }) {
   const { debug } = options;
-  const dbDir = join54(workspace, CLI_DIRECTORIES.DATABASE);
+  const dbDir = join55(workspace, CLI_DIRECTORIES.DATABASE);
   await runStep(
     "Resetting database...",
     async () => {
@@ -30819,7 +30978,7 @@ function startCallbackServer(timeoutMs, expectedState) {
     bound = res;
     bindFailed = rej;
   });
-  const result = new Promise((resolve18) => {
+  const result = new Promise((resolve19) => {
     let server = null;
     let timeoutId = null;
     let didBind = false;
@@ -30838,7 +30997,7 @@ function startCallbackServer(timeoutMs, expectedState) {
     }
     timeoutId = setTimeout(() => {
       cleanup(() => {
-        resolve18({
+        resolve19({
           success: false,
           error: "Authentication timed out. Please try again."
         });
@@ -30856,7 +31015,7 @@ function startCallbackServer(timeoutMs, expectedState) {
         res.writeHead(200, { "Content-Type": "text/html" });
         res.end(SUCCESS_HTML);
         cleanup(() => {
-          resolve18(parsed);
+          resolve19(parsed);
         });
         return;
       }
@@ -30874,7 +31033,7 @@ function startCallbackServer(timeoutMs, expectedState) {
         bindFailed(new Error(message2));
       }
       cleanup(() => {
-        resolve18({ success: false, error: message2 });
+        resolve19({ success: false, error: message2 });
       });
     });
     server.listen(CALLBACK_PORT);
@@ -31016,7 +31175,7 @@ async function promptForPassword() {
 
 // src/lib/bucket/collect.ts
 import { readdirSync as readdirSync6, statSync as statSync5 } from "fs";
-import { join as join55, relative as relative8, sep as sep5 } from "path";
+import { join as join56, relative as relative9, sep as sep6 } from "path";
 function isEnvFile(name) {
   const lower = name.toLowerCase();
   return lower === ".env" || lower === ".envrc" || lower.startsWith(".env.");
@@ -31025,8 +31184,8 @@ function isAlwaysSkippedName(segment) {
   return BUCKET_ALWAYS_SKIP.includes(segment) || isEnvFile(segment);
 }
 function shouldSkipFile(filePath, baseDir, gitignorePatterns) {
-  const relativePath = relative8(baseDir, filePath);
-  for (const part of relativePath.split(sep5)) {
+  const relativePath = relative9(baseDir, filePath);
+  for (const part of relativePath.split(sep6)) {
     if (isAlwaysSkippedName(part)) {
       return true;
     }
@@ -31038,7 +31197,7 @@ function collectFiles(directory, baseDir, gitignorePatterns) {
   try {
     const entries = readdirSync6(directory, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = join55(directory, entry.name);
+      const fullPath = join56(directory, entry.name);
       if (!shouldSkipFile(fullPath, baseDir, gitignorePatterns)) {
         if (entry.isDirectory()) {
           files.push(...collectFiles(fullPath, baseDir, gitignorePatterns));
@@ -31046,7 +31205,7 @@ function collectFiles(directory, baseDir, gitignorePatterns) {
           const stats = statSync5(fullPath);
           files.push({
             absolutePath: fullPath,
-            relativePath: relative8(baseDir, fullPath),
+            relativePath: relative9(baseDir, fullPath),
             size: stats.size
           });
         }
@@ -31084,10 +31243,10 @@ async function confirmDestructive(message2, hint) {
 import { ApiError as ApiError6 } from "@playcademy/sdk/internal";
 
 // src/lib/bucket/local.ts
-import { join as join56 } from "path";
+import { join as join57 } from "path";
 import { Miniflare as Miniflare3 } from "miniflare";
 async function openLocalBucket() {
-  const bucketDir = join56(getWorkspace(), CLI_DIRECTORIES.BUCKET);
+  const bucketDir = join57(getWorkspace(), CLI_DIRECTORIES.BUCKET);
   const mf = new Miniflare3({
     modules: [{ type: "ESModule", path: "index.mjs", contents: "" }],
     r2Buckets: [CLOUDFLARE_BINDINGS.BUCKET],
@@ -31312,12 +31471,12 @@ async function runDeletePlan(plan, adapter, location, options) {
 }
 
 // src/lib/bucket/dev.ts
-import { existsSync as existsSync39 } from "fs";
-import { join as join57 } from "path";
+import { existsSync as existsSync40 } from "fs";
+import { join as join58 } from "path";
 var ASSET_DEV_ROUTE_PREFIX = ASSET_ROUTE_PREFIX;
 function hasCustomAssetsRoute(projectRoot, config) {
   const routesDir = getGameRoutesDirectory(projectRoot, config);
-  return existsSync39(join57(routesDir, "assets")) || existsSync39(join57(routesDir, "assets.ts"));
+  return existsSync40(join58(routesDir, "assets")) || existsSync40(join58(routesDir, "assets.ts"));
 }
 function openLocalAssetBucket() {
   return openLocalBucket();
@@ -31343,7 +31502,7 @@ async function readLocalAsset(bucket, servingKey) {
 
 // src/lib/bucket/hash.ts
 import { createHash as createHash5 } from "crypto";
-import { readFileSync as readFileSync17 } from "fs";
+import { readFileSync as readFileSync18 } from "fs";
 import { extname as extname3 } from "path";
 var HASH_LENGTH = 8;
 function computeHash(buffer) {
@@ -31358,7 +31517,7 @@ function insertHash(key, hash) {
 }
 function hashFiles(files) {
   return files.map((file) => {
-    const buffer = readFileSync17(file.absolutePath);
+    const buffer = readFileSync18(file.absolutePath);
     const contentHash = computeHash(buffer);
     const key = getBucketKey(file.relativePath);
     return {
@@ -32588,7 +32747,7 @@ async function connectToLogStream(config) {
       if (backfillTask && !interrupted) {
         await Promise.race([
           backfillTask,
-          new Promise((resolve18) => setTimeout(resolve18, BACKFILL_EXIT_GRACE_MS))
+          new Promise((resolve19) => setTimeout(resolve19, BACKFILL_EXIT_GRACE_MS))
         ]);
       }
       report?.();
@@ -33293,7 +33452,7 @@ function formatExit(name, code, signal) {
   return `${name} exited`;
 }
 function upgradeStandalone(targetVersion, channel) {
-  return new Promise((resolve18, reject) => {
+  return new Promise((resolve19, reject) => {
     const curl = spawn2("curl", ["-fsSL", INSTALL_SCRIPT_URL], {
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -33327,7 +33486,7 @@ function upgradeStandalone(targetVersion, channel) {
       if (error) {
         reject(error);
       } else {
-        resolve18({ stdout: stdout2, stderr });
+        resolve19({ stdout: stdout2, stderr });
       }
     }
     function tryFinalize() {
@@ -33395,7 +33554,7 @@ function upgradeStandalone(targetVersion, channel) {
 }
 
 // src/lib/upgrade/verify.ts
-import { spawnSync } from "node:child_process";
+import { spawnSync as spawnSync2 } from "node:child_process";
 function extractReportedVersion(stdout2) {
   const lastLine = stdout2.trim().split("\n").at(-1)?.trim();
   if (!lastLine) {
@@ -33409,7 +33568,7 @@ function extractReportedVersion(stdout2) {
 }
 function verifyInstalledBinary(expectedVersion) {
   const expected = normalizeVersion(expectedVersion);
-  const result = spawnSync(process.execPath, ["--version"], {
+  const result = spawnSync2(process.execPath, ["--version"], {
     encoding: "utf8",
     timeout: 3e4
   });
@@ -33429,10 +33588,10 @@ function verifyInstalledBinary(expectedVersion) {
 
 // src/lib/upgrade/windows.ts
 import { createHash as createHash6 } from "node:crypto";
-import { existsSync as existsSync40 } from "node:fs";
+import { existsSync as existsSync41 } from "node:fs";
 import { copyFile, mkdir as mkdir9, open as open2, rename, rm as rm3 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
-import { basename as basename5, dirname as dirname9, join as join58 } from "node:path";
+import { basename as basename5, dirname as dirname10, join as join59 } from "node:path";
 var COMPANION_TOOLS = ["workerd", "esbuild"];
 function windowsArtifacts(arch = process.arch) {
   if (arch !== "x64") {
@@ -33459,8 +33618,8 @@ function cliDestinations(execPath, canonical, existingLocalBin) {
 }
 function resolveCliDestinations() {
   const canonical = nativeBinaryPath("playcademy");
-  const localBin = join58(homedir3(), ".local", "bin", basename5(canonical));
-  return cliDestinations(process.execPath, canonical, existsSync40(localBin) ? localBin : null);
+  const localBin = join59(homedir3(), ".local", "bin", basename5(canonical));
+  return cliDestinations(process.execPath, canonical, existsSync41(localBin) ? localBin : null);
 }
 function parseChecksums(text4) {
   const checksums = /* @__PURE__ */ new Map();
@@ -33517,7 +33676,7 @@ async function upgradeWindows(targetVersion, channel) {
     return { remote, expected, dests };
   });
   await Promise.all(
-    [...new Set(plans.flatMap((plan) => plan.dests.map((dest) => dirname9(dest))))].map(
+    [...new Set(plans.flatMap((plan) => plan.dests.map((dest) => dirname10(dest))))].map(
       (dir) => mkdir9(dir, { recursive: true })
     )
   );
@@ -33664,6 +33823,8 @@ async function resolveTarget(targetVersion, channelOverride) {
 }
 export {
   ASSET_DEV_ROUTE_PREFIX,
+  CATALOG_PATH,
+  CatalogError,
   ConfigError,
   DEFAULT_DASHBOARD_DIRECTORY,
   DeployBlockedError,
@@ -33691,10 +33852,12 @@ export {
   applySecretsChanges,
   assembleLogicalLevel,
   assertDestructiveConfirmToken,
+  assertExtractorOutput,
   assertRemoteWhenEnvGiven,
   assessmentFixturePath,
   blockDeploy,
   bootstrapDashboardAdmin,
+  buildCatalog,
   buildCollectorUrl,
   buildDatabasePlan,
   buildDatabaseResetPayload,
@@ -33820,6 +33983,7 @@ export {
   executeSeedFile,
   executeUpdates,
   exitAfterStdoutDrain,
+  extractCatalog,
   extractDeployServerError,
   fetchCompatibilityManifest,
   fetchDashboardUrl,
@@ -33956,7 +34120,7 @@ export {
   isPluginConfigured,
   isProcessExitLikeError,
   isPushAdopted,
-  isRecord3 as isRecord,
+  isRecord4 as isRecord,
   isResolvableDriftLabel,
   isRetryable,
   isSchemaAdopted,
@@ -34058,6 +34222,7 @@ export {
   refuseRun,
   removeDeployedGame,
   removeProfile,
+  renderCatalog,
   renderDeleteRun,
   renderDeployServerError,
   renderRestoreUnsupported,
@@ -34167,5 +34332,6 @@ export {
   validateQueueKey,
   validateTimebackCourseRequirements,
   withLocalBucket,
-  writeAssessmentFixtureBundle
+  writeAssessmentFixtureBundle,
+  writeCatalog
 };

package/dist/runtime/dashboard-runtime/manifest.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "0.28.1-beta.13",
-  "sdkVersion": "0.16.1-beta.13",
-  "runtimeBuildId": "366f48676d4f",
-  "inputFingerprint": "366f48676d4f59f82245bac7de237150ecf177448b51bd9e048499e3ce8c0e20",
+  "cliVersion": "0.28.1-beta.14",
+  "sdkVersion": "0.16.1-beta.14",
+  "runtimeBuildId": "3ce61e6be9e1",
+  "inputFingerprint": "3ce61e6be9e1a0a36a9263642202c3a2d3227b315087e86599fba386a455f421",
   "entry": "index.js"
 }

package/dist/runtime/game-runtime/index.js

@@ -12056,9 +12056,9 @@ var init_list = __esm({
 // ../edge-play/src/game/lib/metadata.ts
 function getRuntimeMetadata() {
   return {
-    cliVersion: true ? "0.28.1-beta.13" : "0.0.0-dev",
-    sdkVersion: true ? "0.16.1-beta.13" : "0.0.0-dev",
-    buildId: true ? "366f48676d4f" : "dev-source"
+    cliVersion: true ? "0.28.1-beta.14" : "0.0.0-dev",
+    sdkVersion: true ? "0.16.1-beta.14" : "0.0.0-dev",
+    buildId: true ? "3ce61e6be9e1" : "dev-source"
   };
 }
 var init_metadata = __esm({

package/dist/runtime/game-runtime/manifest.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "0.28.1-beta.13",
-  "sdkVersion": "0.16.1-beta.13",
-  "runtimeBuildId": "366f48676d4f",
-  "inputFingerprint": "366f48676d4f59f82245bac7de237150ecf177448b51bd9e048499e3ce8c0e20",
+  "cliVersion": "0.28.1-beta.14",
+  "sdkVersion": "0.16.1-beta.14",
+  "runtimeBuildId": "3ce61e6be9e1",
+  "inputFingerprint": "3ce61e6be9e1a0a36a9263642202c3a2d3227b315087e86599fba386a455f421",
   "entry": "index.js"
 }

package/dist/utils.d.ts

@@ -141,6 +141,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -173,6 +186,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**

package/dist/utils.js

@@ -388,7 +388,7 @@ var DASHBOARD_API_ROUTES_DIRECTORY = "api";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21-beta.13",
+  version: "0.0.21-beta.14",
   type: "module",
   exports: {
     "./server": {
@@ -828,7 +828,10 @@ function nestColor(content, color2) {
 function customTransform(text) {
   let result = text;
   result = result.replace(/<<([^>]+)>>/g, (_, url) => blueBright(underline(url)));
-  result = result.replace(/<([^>]+)>/g, (_, inner) => blueBright(`<${inner}>`));
+  result = result.replace(
+    /<([^>]+)>/g,
+    (match, inner) => blueBright(/[./]/.test(inner) ? inner : match)
+  );
   result = result.replace(/`([^`]+)`/g, (_, code) => nestColor(code, greenBright));
   return result;
 }
@@ -2831,7 +2834,7 @@ import { existsSync as existsSync9, mkdirSync as mkdirSync2, writeFileSync as wr
 import { dirname as dirname4, join as join14 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.28.1-beta.13";
+var cliVersion = false ? "0.0.0-dev" : "0.28.1-beta.14";
 
 // src/lib/build/binary-resource.ts
 function writeFileTree(baseDir, files) {

package/dist/version.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.28.1-beta.13";
+var cliVersion = false ? "0.0.0-dev" : "0.28.1-beta.14";
 export {
   cliVersion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.28.1-beta.13",
+    "version": "0.28.1-beta.14",
     "type": "module",
     "exports": {
         ".": {
@@ -55,7 +55,7 @@
     },
     "dependencies": {
         "@inquirer/prompts": "^7.8.6",
-        "@playcademy/sdk": "0.16.1-beta.13",
+        "@playcademy/sdk": "0.16.1-beta.14",
         "chokidar": "^4.0.3",
         "colorette": "^2.0.20",
         "commander": "^14.0.1",