@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.84af65cd215b6ca1

package/dist/migration/restructure.js

@@ -0,0 +1,645 @@
+import { existsSync } from "node:fs";
+import { cp, mkdir, readdir, readFile, rename, rm, stat, writeFile, } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { getPersistedChecklistPath, PERSISTED_CHECKLIST_FILE, seedMigrationChecklistState, } from "../ai-service/checklist/persisted-checklist-store.js";
+import { preparePackageJsonForCloudNpm } from "../npm/prepare-package-json-for-cloud-npm.js";
+import { findRouterFile, parseRouterFile } from "../router-parser.js";
+import { readIntegrationWritePolicy } from "./integration-write-policy.js";
+import { computeRecommendedUserDeps, } from "./recommended-user-deps.js";
+/** Top-level directories we never move into the backup (they would bloat
+ * it, or -- in the case of `scratch` itself -- recurse infinitely). */
+const GUARDED_TOP_LEVEL = new Set([
+    ".cache",
+    ".git",
+    ".superblocks",
+    ".turbo",
+    "build",
+    "coverage",
+    "dist",
+    "node_modules",
+    "scratch",
+]);
+/** Top-level entries that, if present in backup, map onto fullstack client/. */
+const BACKUP_TO_CLIENT_MAPPINGS = [
+    // Pages are overwhelmingly user-authored; always overwrite the template
+    // stub (which is a blank <div>).
+    {
+        backupSubpath: "pages",
+        clientSubpath: "pages",
+        diffAgainstTemplate: false,
+    },
+    // Components may be stock shadcn files that match the fullstack template
+    // byte-for-byte. Skip those to avoid a giant no-op diff.
+    {
+        backupSubpath: "components",
+        clientSubpath: "components",
+        diffAgainstTemplate: true,
+    },
+    // Custom hooks (e.g. useAuthApi) live at the v2 app root under hooks/ and
+    // are imported as `@/hooks/...`. Copy user-authored files, but keep
+    // template-owned wrappers like useApi.ts / useApiData.ts.
+    {
+        backupSubpath: "hooks",
+        clientSubpath: "hooks",
+        diffAgainstTemplate: false,
+        preserveExistingDest: true,
+    },
+    // These are one-file directories in both templates; diff to avoid
+    // overwriting template improvements when the user never touched them.
+    { backupSubpath: "lib", clientSubpath: "lib", diffAgainstTemplate: true },
+];
+/** Single-file diff targets at the backup root. Each one: if the v2 app
+ * shipped a version that differs from the fullstack template's baseline,
+ * port it over; otherwise leave the template copy in place.
+ *
+ * `router.tsx` / `App.tsx` / `root.tsx` are critical here: the shadcn-demo-app
+ * legacy template registers real user routes via `router.tsx`, and the
+ * fullstack template's default router only wires up a blank `Home` stub.
+ * Without porting the user's router, the migrated `client/pages/*` files
+ * exist on disk but are unrouted, so the live-edit tree looks like a
+ * default/empty app and the editor falls through to the v2 UI.
+ */
+const BACKUP_SINGLE_FILE_DIFFS = [
+    { backupPath: "index.css", clientPath: "client/index.css" },
+    { backupPath: "router.tsx", clientPath: "client/router.tsx" },
+    { backupPath: "App.tsx", clientPath: "client/App.tsx" },
+    { backupPath: "root.tsx", clientPath: "client/root.tsx" },
+];
+export const SCRATCH_DIR_NAME = "scratch";
+export const BACKUP_SUBDIR_NAME = "v2-backup";
+export const MIGRATION_STATE_FILE = "migration-state.json";
+export const MIGRATION_CHECKLIST_FILE = PERSISTED_CHECKLIST_FILE;
+export const MIGRATION_STATE_VERSION = 1;
+export async function migrateToFullstack(args) {
+    const { appRootDirPath, templateSourceDirPath, logger } = args;
+    logger.info("[migrate] Starting v2->v3 restructure", {
+        appRootDirPath,
+        templateSourceDirPath,
+    });
+    await assertDirectoryExists(appRootDirPath, "app root");
+    await assertDirectoryExists(templateSourceDirPath, "template source");
+    const scratchDirPath = join(appRootDirPath, SCRATCH_DIR_NAME);
+    const backupDirPath = join(scratchDirPath, BACKUP_SUBDIR_NAME);
+    await assertBackupSlotIsEmpty(backupDirPath);
+    await moveAllTopLevelIntoBackup({ appRootDirPath, backupDirPath, logger });
+    await copyTemplateIntoAppRoot({
+        appRootDirPath,
+        templateSourceDirPath,
+        logger,
+    });
+    await preparePackageJsonForCloudNpm({ appRootDirPath, logger });
+    let restructuredFiles = 0;
+    restructuredFiles += await remapBackupDirsIntoClient({
+        backupDirPath,
+        appRootDirPath,
+        templateSourceDirPath,
+        logger,
+    });
+    restructuredFiles += await remapBackupSingleFiles({
+        backupDirPath,
+        appRootDirPath,
+        templateSourceDirPath,
+        logger,
+    });
+    const apiStubResult = await stubV2Apis({
+        backupDirPath,
+        appRootDirPath,
+        logger,
+    });
+    // Compute the install recommendations AFTER api stubs land so the import
+    // scan sees the v3 server/apis layout too. We never write to the active
+    // package.json here — Clark drives all installs via build_installPackages
+    // during the migration turn, which keeps the manifest free of v2-template
+    // packages the migrated code does not actually import.
+    const recommendedDepsResult = await computeRecommendedUserDeps({
+        appRootDirPath,
+        backupDirPath,
+        logger,
+    });
+    if (recommendedDepsResult.unimportedBackupDeps.length > 0) {
+        logger.info("[migrate] Dropped v2 backup deps that are not imported by migrated code", { unimportedBackupDeps: recommendedDepsResult.unimportedBackupDeps });
+    }
+    if (recommendedDepsResult.importedButMissingFromBackup.length > 0) {
+        logger.warn("[migrate] Migrated code imports packages absent from the v2 backup; recommending @latest", {
+            importedButMissingFromBackup: recommendedDepsResult.importedButMissingFromBackup,
+        });
+    }
+    restructuredFiles += apiStubResult.apiStubs.length;
+    const stateFilePath = join(scratchDirPath, MIGRATION_STATE_FILE);
+    const integrationWritePolicy = args.integrationWritePolicy ??
+        (await readPersistedIntegrationWritePolicy(stateFilePath));
+    const state = {
+        version: MIGRATION_STATE_VERSION,
+        startedAt: new Date().toISOString(),
+        targetTemplateName: "app-fullstack",
+        sourceTemplateName: process.env.SUPERBLOCKS_APP_TEMPLATE_NAME ?? "shadcn-demo-app",
+        backupDirPath: relative(appRootDirPath, backupDirPath),
+        ...(integrationWritePolicy !== undefined && { integrationWritePolicy }),
+        ...(recommendedDepsResult.recommendedUserDeps.length > 0 && {
+            recommendedUserDeps: recommendedDepsResult.recommendedUserDeps,
+        }),
+        ...(recommendedDepsResult.importedButMissingFromBackup.length > 0 && {
+            recommendedUserDepsPinnedToLatest: recommendedDepsResult.importedButMissingFromBackup,
+        }),
+        apiChecklist: apiStubResult.checklist,
+    };
+    const stateBody = JSON.stringify(state, null, 2) + "\n";
+    const tmpStatePath = stateFilePath + ".tmp";
+    await writeFile(tmpStatePath, stateBody, "utf-8");
+    await rename(tmpStatePath, stateFilePath);
+    logger.info("[migrate] Wrote migration-state.json", { stateFilePath });
+    const migrationChecklist = await seedMigrationChecklistState({
+        appRootDirPath,
+        apiChecklist: apiStubResult.checklist.map((entry) => ({
+            name: entry.name,
+            stubPath: entry.stubPath,
+        })),
+        pageRoutes: await discoverMigratedPageRoutes({
+            appRootDirPath,
+            backupDirPath,
+            logger,
+        }),
+    });
+    const migrationChecklistFilePath = getPersistedChecklistPath(appRootDirPath);
+    logger.info("[migrate] Wrote migration-checklist.json", {
+        migrationChecklistFilePath,
+        itemCount: migrationChecklist.items.length,
+    });
+    // Update the local template marker read by the csb-mock-server so the
+    // restarted dev-server process launches with `app-fullstack` env vars
+    // (entryPoint `client/root.tsx`, etc.). Production SABS gets the new
+    // template from the server-side row at pod start; the mock has no such
+    // signal and would otherwise cache the pre-migration template forever.
+    // Harmless in non-mock environments — the file is mock-specific.
+    const sbTemplatePath = join(appRootDirPath, ".sb_template");
+    await writeFile(sbTemplatePath, "app-fullstack", "utf-8");
+    logger.info("[migrate] Wrote .sb_template", { sbTemplatePath });
+    return {
+        scratchDirPath,
+        backupDirPath,
+        restructuredFiles,
+        apiStubs: apiStubResult.apiStubs,
+        stateFilePath,
+        migrationChecklistFilePath,
+    };
+}
+/**
+ * Inverse of the restructure step that moves the live tree into
+ * `scratch/v2-backup/`. Used on migration abort so the dev server can boot
+ * the legacy layout even when DBFS download-first is skipped (warm pod, hash
+ * match) or races autosync before the pod is recycled.
+ */
+export async function restoreFromV2Backup(args) {
+    const { appRootDirPath, logger } = args;
+    const scratchDirPath = join(appRootDirPath, SCRATCH_DIR_NAME);
+    const backupDirPath = join(scratchDirPath, BACKUP_SUBDIR_NAME);
+    if (!existsSync(backupDirPath)) {
+        return { restored: false };
+    }
+    logger.info("[migrate] Restoring live tree from scratch/v2-backup", {
+        appRootDirPath,
+        backupDirPath,
+    });
+    const topLevelEntries = await readdir(appRootDirPath, {
+        withFileTypes: true,
+    });
+    for (const entry of topLevelEntries) {
+        if (GUARDED_TOP_LEVEL.has(entry.name))
+            continue;
+        if (entry.name === SCRATCH_DIR_NAME)
+            continue;
+        await rm(join(appRootDirPath, entry.name), {
+            recursive: true,
+            force: true,
+        });
+        logger.debug("[migrate] Removed v3 top-level entry before restore", {
+            entry: entry.name,
+        });
+    }
+    const backupEntries = await readdir(backupDirPath, { withFileTypes: true });
+    for (const entry of backupEntries) {
+        const from = join(backupDirPath, entry.name);
+        const to = join(appRootDirPath, entry.name);
+        await rename(from, to);
+        logger.debug("[migrate] Restored from backup", { entry: entry.name });
+    }
+    await rm(scratchDirPath, { recursive: true, force: true });
+    const sbTemplatePath = join(appRootDirPath, ".sb_template");
+    if (existsSync(sbTemplatePath)) {
+        await rm(sbTemplatePath, { force: true });
+        logger.debug("[migrate] Removed .sb_template marker written during restructure");
+    }
+    logger.info("[migrate] Restored live tree from scratch/v2-backup");
+    return { restored: true };
+}
+async function readPersistedIntegrationWritePolicy(stateFilePath) {
+    const appRootDirPath = dirname(dirname(stateFilePath));
+    try {
+        const policy = await readIntegrationWritePolicy(appRootDirPath);
+        return Object.keys(policy).length > 0 ? policy : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// --------------- Step 1: move current tree into scratch/v2-backup ---------------
+async function assertBackupSlotIsEmpty(backupDirPath) {
+    if (existsSync(backupDirPath)) {
+        // If the backup already exists we would silently overwrite the user's
+        // existing rollback point, which is the worst possible failure mode.
+        throw new Error(`Refusing to overwrite existing backup at ${backupDirPath}. A prior migration is either in progress or left behind state; resolve it manually before retrying.`);
+    }
+}
+async function moveAllTopLevelIntoBackup(opts) {
+    const { appRootDirPath, backupDirPath, logger } = opts;
+    await mkdir(backupDirPath, { recursive: true });
+    const entries = await readdir(appRootDirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (GUARDED_TOP_LEVEL.has(entry.name))
+            continue;
+        // The scratch dir was just created one level up from the backup; skip it
+        // even if the GUARDED list changes later -- moving scratch/ into itself
+        // would recurse forever.
+        if (entry.name === SCRATCH_DIR_NAME)
+            continue;
+        const from = join(appRootDirPath, entry.name);
+        const to = join(backupDirPath, entry.name);
+        await rename(from, to);
+        logger.debug("[migrate] Moved to backup", { entry: entry.name });
+    }
+}
+// --------------- Step 2: overlay fullstack template onto app root ---------------
+async function copyTemplateIntoAppRoot(opts) {
+    const { appRootDirPath, templateSourceDirPath, logger } = opts;
+    const entries = await readdir(templateSourceDirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        // Match the same guarded set so we never copy in build output / installs
+        // from the bundled template (the copy script already filters these, but
+        // defense in depth guards against the monorepo fallback path).
+        if (GUARDED_TOP_LEVEL.has(entry.name))
+            continue;
+        const from = join(templateSourceDirPath, entry.name);
+        const to = join(appRootDirPath, entry.name);
+        await cp(from, to, { recursive: true });
+    }
+    logger.debug("[migrate] Template overlaid onto app root");
+}
+// --------------- Step 3: remap backup content onto the new layout ---------------
+async function remapBackupDirsIntoClient(opts) {
+    const { backupDirPath, appRootDirPath, templateSourceDirPath, logger } = opts;
+    let copied = 0;
+    for (const mapping of BACKUP_TO_CLIENT_MAPPINGS) {
+        const src = join(backupDirPath, mapping.backupSubpath);
+        if (!existsSync(src))
+            continue;
+        const dst = join(appRootDirPath, "client", mapping.clientSubpath);
+        const templateEquivalent = join(templateSourceDirPath, "client", mapping.clientSubpath);
+        copied += await copyTreeWithDiff({
+            src,
+            dst,
+            templateBaseline: mapping.diffAgainstTemplate ? templateEquivalent : null,
+            preserveExistingDest: mapping.preserveExistingDest === true,
+            // pages/<Page>/apis/ is where v2 YAML APIs live; they are handled by
+            // the API stub pass separately, so keep them out of the client/ tree.
+            skipSubpath: mapping.backupSubpath === "pages" ? "apis" : null,
+            logger,
+        });
+    }
+    return copied;
+}
+async function remapBackupSingleFiles(opts) {
+    const { backupDirPath, appRootDirPath, templateSourceDirPath, logger } = opts;
+    let copied = 0;
+    for (const mapping of BACKUP_SINGLE_FILE_DIFFS) {
+        const backupFile = join(backupDirPath, mapping.backupPath);
+        if (!existsSync(backupFile))
+            continue;
+        const destFile = join(appRootDirPath, mapping.clientPath);
+        const templateFile = join(templateSourceDirPath, mapping.clientPath);
+        if (existsSync(templateFile) &&
+            (await filesEqual(backupFile, templateFile))) {
+            logger.debug("[migrate] Skipping unmodified single file", {
+                file: mapping.backupPath,
+            });
+            continue;
+        }
+        await mkdir(dirname(destFile), { recursive: true });
+        await cp(backupFile, destFile);
+        copied += 1;
+    }
+    return copied;
+}
+async function copyTreeWithDiff(opts) {
+    const { src, dst, templateBaseline, preserveExistingDest, skipSubpath, logger, } = opts;
+    let copied = 0;
+    const stack = [src];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        const entries = await readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const absEntry = join(current, entry.name);
+            const relFromSrc = relative(src, absEntry);
+            // Drop top-level `apis/` under pages/<Page>/ (handled by stubV2Apis).
+            if (skipSubpath && relFromSrc.split("/").includes(skipSubpath)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                stack.push(absEntry);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            const destFile = join(dst, relFromSrc);
+            if (preserveExistingDest && existsSync(destFile)) {
+                logger.debug("[migrate] Keeping template file", {
+                    path: relFromSrc,
+                });
+                continue;
+            }
+            if (templateBaseline) {
+                const baselineFile = join(templateBaseline, relFromSrc);
+                if (existsSync(baselineFile) &&
+                    (await filesEqual(absEntry, baselineFile))) {
+                    logger.debug("[migrate] Skipping unmodified file", {
+                        path: relFromSrc,
+                    });
+                    continue;
+                }
+            }
+            await mkdir(dirname(destFile), { recursive: true });
+            await cp(absEntry, destFile);
+            copied += 1;
+        }
+    }
+    return copied;
+}
+// --------------- Step 4: stub v2 APIs --------------------------------------------
+async function stubV2Apis(opts) {
+    const { backupDirPath, appRootDirPath, logger } = opts;
+    const yamls = await findApiYamls(backupDirPath);
+    const apiStubs = [];
+    const checklist = [];
+    const seenNames = new Set();
+    for (const yamlPath of yamls) {
+        const rawName = await extractApiName(yamlPath).catch(() => null);
+        const fallback = dirname(yamlPath).split("/").pop() ?? "Api";
+        const baseName = toValidApiName(rawName ?? fallback);
+        const uniqueName = ensureUniqueName(baseName, seenNames);
+        seenNames.add(uniqueName);
+        const stubRelPath = join("server", "apis", uniqueName, "api.ts");
+        const stubAbsPath = join(appRootDirPath, stubRelPath);
+        await mkdir(dirname(stubAbsPath), { recursive: true });
+        await writeFile(stubAbsPath, renderApiStub(uniqueName, yamlPath, backupDirPath), "utf-8");
+        apiStubs.push(stubRelPath);
+        checklist.push({
+            name: uniqueName,
+            yamlPathInBackup: relative(backupDirPath, yamlPath),
+            stubPath: stubRelPath,
+            status: "stub",
+        });
+    }
+    await writeApiRegistry({ appRootDirPath, stubs: checklist, logger });
+    logger.info("[migrate] Stubbed v2 APIs", { count: apiStubs.length });
+    return { apiStubs, checklist };
+}
+async function findApiYamls(rootDir) {
+    const results = [];
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const abs = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(abs);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (entry.name !== "api.yaml" && entry.name !== "api.yml")
+                continue;
+            // Only treat files inside an `apis/` directory as v2 API definitions
+            // so we do not pick up unrelated YAML that happens to be named api.yaml.
+            const parts = relative(rootDir, abs).split("/");
+            if (!parts.includes("apis"))
+                continue;
+            results.push(abs);
+        }
+    }
+    return results.sort();
+}
+async function discoverMigratedPageRoutes(args) {
+    const routerRoutes = await discoverRoutesFromBackupRouter(args);
+    if (routerRoutes.length > 0) {
+        return routerRoutes;
+    }
+    return discoverRoutesFromBackupPages(args.backupDirPath);
+}
+async function discoverRoutesFromBackupRouter(args) {
+    try {
+        const routerFilePath = await findRouterFile(args.backupDirPath);
+        const routeDefinitions = await parseRouterFile(routerFilePath, args.backupDirPath);
+        return [
+            ...new Set(routeDefinitions.map((route) => normalizeRoutePath(route.path))),
+        ]
+            .filter(Boolean)
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch (error) {
+        args.logger.debug("[migrate] Could not discover routes from backup router", {
+            appRootDirPath: args.appRootDirPath,
+            error: error instanceof Error
+                ? { message: error.message, name: error.name }
+                : { message: String(error), name: "Error" },
+        });
+        return [];
+    }
+}
+async function discoverRoutesFromBackupPages(backupDirPath) {
+    const pagesRoot = join(backupDirPath, "pages");
+    if (!existsSync(pagesRoot)) {
+        return [];
+    }
+    const indexFiles = [];
+    const stack = [pagesRoot];
+    const indexFileNames = new Set([
+        "index.js",
+        "index.jsx",
+        "index.ts",
+        "index.tsx",
+    ]);
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let entries;
+        try {
+            entries = await readdir(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const abs = join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(abs);
+                continue;
+            }
+            if (entry.isFile() && indexFileNames.has(entry.name)) {
+                indexFiles.push(abs);
+            }
+        }
+    }
+    const routePaths = indexFiles
+        .map((filePath) => {
+        const dirFromPages = relative(pagesRoot, dirname(filePath));
+        if (!dirFromPages || dirFromPages === ".") {
+            return "/";
+        }
+        return normalizeRoutePath(`/${dirFromPages.replaceAll("\\", "/")}`);
+    })
+        .filter(Boolean);
+    return [...new Set(routePaths)].sort((a, b) => a.localeCompare(b));
+}
+function normalizeRoutePath(path) {
+    if (!path) {
+        return "/";
+    }
+    const normalized = path.replaceAll("\\", "/").trim();
+    if (!normalized || normalized === ".") {
+        return "/";
+    }
+    const withLeadingSlash = normalized.startsWith("/")
+        ? normalized
+        : `/${normalized}`;
+    return withLeadingSlash.replace(/\/{2,}/g, "/");
+}
+async function extractApiName(yamlPath) {
+    const raw = await readFile(yamlPath, "utf-8");
+    const parsed = parseYaml(raw);
+    if (parsed &&
+        typeof parsed === "object" &&
+        "metadata" in parsed &&
+        typeof parsed.metadata === "object" &&
+        parsed.metadata &&
+        typeof parsed.metadata.name ===
+            "string") {
+        return parsed.metadata.name;
+    }
+    return null;
+}
+/** Produce a JS-identifier-safe PascalCase-ish name. Not perfect, but
+ * deterministic, and mirrors the server's v2 API slug requirements enough
+ * for the stubs to compile. */
+function toValidApiName(name) {
+    const cleaned = name.replace(/[^A-Za-z0-9_]/g, "_");
+    if (cleaned.length === 0)
+        return "Api";
+    if (/^[0-9]/.test(cleaned))
+        return "_" + cleaned;
+    return cleaned;
+}
+function ensureUniqueName(name, seen) {
+    if (!seen.has(name))
+        return name;
+    let i = 2;
+    while (seen.has(`${name}_${i}`))
+        i += 1;
+    return `${name}_${i}`;
+}
+function renderApiStub(name, yamlPath, backupDirPath) {
+    const originalRel = relative(backupDirPath, yamlPath);
+    // scratch/v2-backup/ lives under the app root; spell the full project-
+    // relative path in the TODO so users can jump straight to the source.
+    const scratchRel = join(SCRATCH_DIR_NAME, BACKUP_SUBDIR_NAME, originalRel);
+    return `import { api, z } from "@superblocksteam/sdk-api";
+
+/**
+ * Auto-generated v2->v3 migration stub.
+ *
+ * Original v2 definition lives at:
+ *   ${scratchRel}
+ *
+ * The v2 YAML has been preserved in scratch/v2-backup/ so you can port the
+ * block logic (and any custom integrations) into the run() below. Input/
+ * output schemas are intentionally empty until you wire them up -- leaving
+ * them unchanged will fail at runtime, which is the desired forcing
+ * function.
+ */
+export default api({
+  name: "${name}",
+  input: z.object({}),
+  output: z.object({}).optional(),
+  async run() {
+    return "TODO";
+  },
+});
+`;
+}
+async function writeApiRegistry(opts) {
+    const { appRootDirPath, stubs, logger } = opts;
+    const registryPath = join(appRootDirPath, "server", "apis", "index.ts");
+    // Sort by API name so the registry is stable regardless of the order in
+    // which we walked the backup directory. Users eyeballing this file
+    // expect alphabetical order, and diffs on subsequent manual edits are
+    // easier to read.
+    const orderedStubs = [...stubs].sort((a, b) => a.name.localeCompare(b.name));
+    const imports = orderedStubs
+        .map((s) => `import ${s.name} from "./${s.name}/api.js";`)
+        .join("\n");
+    const entries = orderedStubs.map((s) => `  ${s.name},`).join("\n");
+    const contents = `/**
+ * API Registry - Central export for all APIs.
+ *
+ * Regenerated by the v2->v3 migration. Each entry here corresponds to a
+ * pre-migration YAML API preserved under scratch/v2-backup/. Feel free to
+ * add / remove entries by hand as you port the logic; the restructure
+ * script is idempotent against manual edits (it will not run again unless
+ * the user re-initiates migration).
+ */
+
+${imports}
+
+const apis = {
+${entries}
+} as const;
+
+export default apis;
+
+/** Type for useApi inference - exported for client type-only imports */
+export type ApiRegistry = typeof apis;
+`;
+    await mkdir(dirname(registryPath), { recursive: true });
+    await writeFile(registryPath, contents, "utf-8");
+    logger.debug("[migrate] Rewrote server/apis/index.ts", {
+        registryPath,
+        count: stubs.length,
+    });
+}
+// --------------- Helpers ---------------------------------------------------------
+async function assertDirectoryExists(path, label) {
+    try {
+        const s = await stat(path);
+        if (!s.isDirectory()) {
+            throw new Error(`${label} path exists but is not a directory: ${path}`);
+        }
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error(`${label} directory does not exist: ${path}`);
+        }
+        throw err;
+    }
+}
+async function filesEqual(a, b) {
+    const [aBuf, bBuf] = await Promise.all([readFile(a), readFile(b)]);
+    if (aBuf.length !== bBuf.length)
+        return false;
+    return aBuf.equals(bBuf);
+}
+//# sourceMappingURL=restructure.js.map

package/dist/migration/restructure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restructure.js","sourceRoot":"","sources":["../../src/migration/restructure.ts"],"names":[],"mappings":"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"}