@saasicat/cli 0.27.0 → 1.0.0-rc.0

package/README.md

@@ -10,7 +10,7 @@ Cross-cutting helpers for consumer CLIs. Provides:
 - `ManifestCliFlow` + `DEFAULT_MANIFEST_CHECKS` (12 platform checks) —
   `<app> manifest dump|validate|hash|diff|check`
 
-Spec: [`saas-platform-spec/cli-conventions.md`](https://github.com/uelker70/saasicat/blob/main/packages/saas-platform-spec/cli-conventions.md).
+Spec: [`cli-conventions.md`][conventions] in `@saasicat/spec`.
 
 ## Plugin Architecture
 
@@ -126,7 +126,7 @@ domain commands on top.
 
 ## Exit codes
 
-Per [`cli-conventions.md`](https://github.com/uelker70/saasicat/blob/main/packages/saas-platform-spec/cli-conventions.md) §6:
+Per [`cli-conventions.md`][conventions] §6:
 
 | Code | Meaning                                 |
 | ---- | --------------------------------------- |
@@ -139,3 +139,5 @@ Per [`cli-conventions.md`](https://github.com/uelker70/saasicat/blob/main/packag
 | 6    | conflict                                |
 | 7    | drift (e.g. manifest check: error)      |
 | 99   | internal                                |
+
+[conventions]: https://github.com/uelker70/saasicat/blob/main/packages/spec/cli-conventions.md

package/bin/saasicat.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 // `saasicat` — bootstrap CLI for the SaaSiCat framework.
+// naming-history: the codemod help below names the pre-1.0 spellings it rewrites.
 //
 // Sub-commands:
 //   schema apply [--prisma-schema=PATH] [--fragments=01,02,03]
@@ -16,6 +17,9 @@
 //       Prisma's DSL cannot express to the migration it just wrote.
 //
 //   init --project-key=X --quota=key:Model [--quota=…]... [--app-name=X] [--api-base=X]
+//   codemod v1-imports [--dir=X] [--dry-run]
+//   codemod v1-rename  [--dir=X] [--dry-run]
+//   codemod v1         [--dir=X] [--dry-run]   — both, in that order
 //        [--skip-hasher] [--dry-run] [--dir=.]
 //       Writes the platform wiring — config, persistence, manifest
 //       contribution, admin module, one provider per quota — and adds
@@ -43,7 +47,10 @@ import {
     findFkPointers,
     hasConstraints,
     assertValidProjectKey,
+    buildImportMap,
     migrationCreatedBy,
+    rewriteImports,
+    rewriteNames,
     reportConstraints,
     patchAppModule,
     patchOptionsFor,
@@ -523,6 +530,124 @@ async function writeConstraintsIntoMigration(args, migrationsBefore) {
     }
 }
 
+/**
+ * Rewrites `@saasicat/ui-vue` imports to the 1.0 export map.
+ *
+ * The rules come from the same table the platform's own move ran on, shipped
+ * with this package — so what a consumer's imports become cannot disagree with
+ * where the files actually went.
+ */
+async function cmdCodemodV1Imports(args) {
+    const root = resolve(args.dir ?? '.');
+    const dryRun = args['dry-run'] === true;
+
+    const table = JSON.parse(await readFile(codemodTable('v1-imports.map.json'), 'utf8'));
+    const map = buildImportMap(table);
+
+    const unmapped = new Map();
+    let rewritten = 0;
+    let touched = 0;
+    await walkSources(root, async (full, source) => {
+        const result = rewriteImports(source, map);
+        for (const [subpath, n] of result.unmapped) {
+            unmapped.set(subpath, (unmapped.get(subpath) ?? 0) + n);
+        }
+        if (result.rewritten === 0) return;
+        if (!dryRun) await writeFile(full, result.text);
+        rewritten += result.rewritten;
+        touched += 1;
+    });
+
+    console.log(
+        `${dryRun ? 'Would rewrite' : 'Rewrote'} ${rewritten} import(s) in ${touched} file(s).`,
+    );
+    if (unmapped.size === 0) return;
+
+    console.log('');
+    console.log('These have no new home — they need a decision, not a rewrite:');
+    for (const [subpath, n] of [...unmapped].sort()) {
+        console.log(`  ${String(n).padStart(3)}×  @saasicat/ui-vue/${subpath}`);
+    }
+    console.log('');
+    console.log('  They moved into `features/` or `internal/`, which the 1.0 surface does');
+    console.log('  not publish: they were domain or page-private components, and importing');
+    console.log('  them tied your app to our internal structure. Copy what you need into');
+    console.log('  your own repository.');
+}
+
+/**
+ * Rewrites the names 1.0 changed: identifier stems, registry keys, the one
+ * token that had two meanings, and the e2e helper's subpath.
+ *
+ * Same shape as `v1-imports`, same table discipline: the rules are read from
+ * `codemods/v1-rename.map.json`, shipped with this package, so what a
+ * consumer's code becomes is what the platform's own rename was checked
+ * against.
+ */
+async function cmdCodemodV1Rename(args) {
+    const root = resolve(args.dir ?? '.');
+    const dryRun = args['dry-run'] === true;
+    const table = JSON.parse(await readFile(codemodTable('v1-rename.map.json'), 'utf8'));
+
+    const ambiguous = new Map();
+    let rewritten = 0;
+    let touched = 0;
+    await walkSources(root, async (full, source) => {
+        const result = rewriteNames(source, table);
+        for (const name of result.ambiguous) {
+            ambiguous.set(name, (ambiguous.get(name) ?? 0) + 1);
+        }
+        if (result.rewritten === 0) return;
+        if (!dryRun) await writeFile(full, result.text);
+        rewritten += result.rewritten;
+        touched += 1;
+    });
+
+    console.log(
+        `${dryRun ? 'Would rewrite' : 'Rewrote'} ${rewritten} name(s) in ${touched} file(s).`,
+    );
+    if (ambiguous.size === 0) return;
+
+    console.log('');
+    console.log('These need a decision, not a rewrite:');
+    for (const [name, n] of [...ambiguous].sort()) {
+        console.log(`  ${String(n).padStart(3)}×  ${name}`);
+    }
+    console.log('');
+    console.log('  FEATURE_UI_REGISTRY_TOKEN meant one registry in `@saasicat/nest/billing`');
+    console.log('  and another in `@saasicat/nest/catalog`. Import it from the entry you');
+    console.log('  mean — BILLING_FEATURE_UI_REGISTRY_TOKEN or CATALOG_FEATURE_UI_REGISTRY_TOKEN.');
+}
+
+/** Where a shipped codemod table lives, resolved through the package itself. */
+function codemodTable(name) {
+    return join(dirname(require_.resolve('@saasicat/cli')), '..', 'codemods', name);
+}
+
+// Anything a build wrote is skipped, whatever it is called: `dist`, `dist-app`,
+// `dist-dev` — a consumer's declaration output carries the old names too, and
+// rewriting it would only make the next build disagree with it.
+const CODEMOD_SKIP = new Set(['node_modules', '.git', '.output', 'coverage']);
+const isBuildOutput = (name) => name === 'dist' || name.startsWith('dist-');
+const CODEMOD_EXTENSIONS = /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs|vue|md)$/;
+
+/** Every source file under `root` a codemod may touch, with its text. */
+async function walkSources(root, visit) {
+    const walk = async (dir) => {
+        for (const entry of await readdir(dir, { withFileTypes: true })) {
+            if (CODEMOD_SKIP.has(entry.name) || isBuildOutput(entry.name)) continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+                continue;
+            }
+            if (!CODEMOD_EXTENSIONS.test(entry.name)) continue;
+            await visit(full, await readFile(full, 'utf8'));
+        }
+    };
+    await walk(root);
+}
+
 /** Reads a repeated flag (`--quota=a --quota=b`) off argv. */
 function repeatedFlag(argv, name) {
     return argv
@@ -662,6 +787,18 @@ async function patchAppModuleFile(root, plan, args) {
 
 async function main() {
     const [, , cmd, sub, ...rest] = process.argv;
+    if (cmd === 'codemod' && sub === 'v1-imports') {
+        return cmdCodemodV1Imports(parseArgs(rest));
+    }
+    if (cmd === 'codemod' && sub === 'v1-rename') {
+        return cmdCodemodV1Rename(parseArgs(rest));
+    }
+    if (cmd === 'codemod' && sub === 'v1') {
+        // Imports first: the rename table keys its per-entry tokens by the
+        // specifier they are imported from, which the import rewrite settles.
+        await cmdCodemodV1Imports(parseArgs(rest));
+        return cmdCodemodV1Rename(parseArgs(rest));
+    }
     if (cmd === 'init') {
         return cmdInit(parseArgs([sub, ...rest].filter(Boolean)), process.argv.slice(3));
     }
@@ -694,6 +831,14 @@ async function main() {
         console.log('          every plan must declare one, or the catalogue does not load.');
         console.log('  init --project-key=myapp --quota=notes:Note --quota=seats:Seat');
         console.log('');
+        console.log('  codemod v1 [--dir=.] [--dry-run]');
+        console.log('          the whole 1.0 migration: v1-imports, then v1-rename');
+        console.log('  codemod v1-imports [--dir=.] [--dry-run]');
+        console.log('          rewrite @saasicat/ui-vue imports to the 1.0 export map');
+        console.log('  codemod v1-rename [--dir=.] [--dry-run]');
+        console.log('          rewrite the names 1.0 changed: SaasPlatform*, Symbol.for keys,');
+        console.log('          FEATURE_UI_REGISTRY_TOKEN, @saasicat/ui-vue/testing-e2e/*');
+        console.log('');
         console.log('Optional --prisma-schema=PATH (default prisma/schema.prisma).');
         console.log('Optional --tenant-model=X --user-model=Y for apply/migrate — enables');
         console.log('         the foreign keys from the platform tables to your models.');

package/codemods/v1-imports.map.json

@@ -0,0 +1,135 @@
+{
+    "_comment": [
+        "The 4.1 move, as data rather than as commands.",
+        "",
+        "Two axes decide every destination, and each directory answers exactly one",
+        "question (AP3 \u00a73.6): the LAYER a file belongs to (client / vue / quasar /",
+        "SFC) and how far it is REUSED \u2014 ui (surface-neutral, many domains) \u2192",
+        "features (one domain, many pages) \u2192 internal/<page> (one page) \u2192 pages",
+        "(one route).",
+        "",
+        "Written down because the mapping is the reviewable part. A 210-file move",
+        "expressed as `git mv` lines is a diff nobody can check; expressed as a",
+        "table, the question is whether each row is right.",
+        "",
+        "Two destinations differ from the sketch in AP3 \u00a73.6, and the reason is a",
+        "measurement rather than a preference. Consumers import `FeatureGate.vue` 19",
+        "times and `MfaPromptDialog.vue` 5 times across notesapp, vereinsfux and",
+        "autohauspro \u2014 `FeatureGate` is the single most imported component in the",
+        "package. AP3 places FeatureGate in `features/entitlement/`, and `features/`",
+        "is explicitly not exported; MfaPromptDialog is used by one page, which by",
+        "the reuse axis alone would put it in `internal/`. Either placement removes a",
+        "component three consumer repositories depend on.",
+        "",
+        "So both stay on the exported surface. A component a consumer embeds in their",
+        "own application is part of the public surface no matter how many of OUR",
+        "pages use it \u2014 the reuse axis measures our reuse, and that is not the same",
+        "question."
+    ],
+    "moves": {
+        "components/admin-page/AdminPage.vue": "ui/page/AdminPage.vue",
+        "components/admin-page/AdminHero.vue": "ui/page/AdminHero.vue",
+        "components/admin-page/AdminBody.vue": "ui/page/AdminBody.vue",
+        "components/admin-page/AdminSection.vue": "ui/page/AdminSection.vue",
+        "components/admin-page/AdminFilters.vue": "ui/page/AdminFilters.vue",
+        "components/admin-page/AdminAccordion.vue": "ui/page/AdminAccordion.vue",
+        "components/admin-page/AdminTable.vue": "ui/data/AdminTable.vue",
+        "components/admin-page/AdminPaginator.vue": "ui/data/AdminPaginator.vue",
+        "components/admin-page/AdminStatistics.vue": "ui/data/AdminStatistics.vue",
+        "components/admin-page/AdminKpi.vue": "ui/data/AdminKpi.vue",
+        "components/KvBlock.vue": "ui/data/KvBlock.vue",
+        "components/admin-page/AdminRefreshBtn.vue": "ui/feedback/AdminRefreshBtn.vue",
+        "components/wizard-stepper/WizardStepper.vue": "ui/page/WizardStepper.vue",
+        "components/plan/PlanCycleToggle.vue": "@saasicat/ui-vue-tenant/plan/PlanCycleToggle.vue",
+        "components/plan/PlanGrid.vue": "@saasicat/ui-vue-tenant/plan/PlanGrid.vue",
+        "components/plan/PriceSummary.vue": "@saasicat/ui-vue-tenant/plan/PriceSummary.vue",
+        "components/plan/PromoCodeInput.vue": "@saasicat/ui-vue-tenant/plan/PromoCodeInput.vue",
+        "components/plan/PublicBundleGrid.vue": "@saasicat/ui-vue-tenant/plan/PublicBundleGrid.vue",
+        "components/plan-create-dialog/PlanCreateDialog.vue": "features/plan/PlanCreateDialog.vue",
+        "components/plan-list/PlanList.vue": "features/plan/PlanList.vue",
+        "components/plan-matrix/PlanMatrix.vue": "features/plan/PlanMatrix.vue",
+        "components/plan-review/PlanReview.vue": "features/plan/PlanReview.vue",
+        "components/plan-detail/PlanDetail.vue": "features/plan/PlanDetail.vue",
+        "components/plan-detail/PlanTerminateDialog.vue": "features/plan/PlanTerminateDialog.vue",
+        "components/plan-detail/PlanAuditLog.vue": "features/plan/internal/PlanAuditLog.vue",
+        "components/plan-detail/PlanDetailKpis.vue": "features/plan/internal/PlanDetailKpis.vue",
+        "components/plan-detail/PlanTitleEdit.vue": "features/plan/internal/PlanTitleEdit.vue",
+        "components/plan-detail/PlanVersionDiffPanel.vue": "features/plan/internal/PlanVersionDiffPanel.vue",
+        "components/plan-detail/PlanVersionsPanel.vue": "features/plan/internal/PlanVersionsPanel.vue",
+        "components/plan-detail/types.ts": "features/plan/internal/plan-detail.types.ts",
+        "components/plan-version-editor/PlanVersionEditor.vue": "features/plan/PlanVersionEditor.vue",
+        "components/plan-version-editor/PlanCatalogPreview.vue": "features/plan/internal/PlanCatalogPreview.vue",
+        "components/plan-version-editor/PlanComponentPool.vue": "features/plan/internal/PlanComponentPool.vue",
+        "components/plan-version-editor/PlanVersionBasket.vue": "features/plan/internal/PlanVersionBasket.vue",
+        "components/plan-version-editor/PlanVersionDiffDialog.vue": "features/plan/internal/PlanVersionDiffDialog.vue",
+        "components/plan-version-editor/PlanVersionEditorHeader.vue": "features/plan/internal/PlanVersionEditorHeader.vue",
+        "components/plan-version-editor/types.ts": "features/plan/internal/plan-version-editor.types.ts",
+        "components/bundle-editor/BundleVersionInlineEditor.vue": "features/bundle/BundleVersionInlineEditor.vue",
+        "components/bundle-editor/BundleVersionStrip.vue": "features/bundle/BundleVersionStrip.vue",
+        "components/BundleVersionPublishDialog.vue": "features/bundle/BundleVersionPublishDialog.vue",
+        "components/bundle-editor/BundleCreatePanel.vue": "features/bundle/internal/BundleCreatePanel.vue",
+        "components/bundle-editor/BundleFeaturesEditor.vue": "features/bundle/internal/BundleFeaturesEditor.vue",
+        "components/bundle-editor/BundlePlanCompatPicker.vue": "features/bundle/internal/BundlePlanCompatPicker.vue",
+        "components/bundle-editor/BundleQuotasEditor.vue": "features/bundle/internal/BundleQuotasEditor.vue",
+        "components/bundle-editor/BundleStatusBanner.vue": "features/bundle/internal/BundleStatusBanner.vue",
+        "components/bundle-editor/bundle-version-status.ts": "features/bundle/internal/bundle-version-status.ts",
+        "components/bundle-editor/catalog-i18n.ts": "features/bundle/internal/catalog-i18n.ts",
+        "components/FeatureGate.vue": "ui/entitlement/FeatureGate.vue",
+        "components/dialogs/PilotCreateDialog.vue": "internal/dialogs/PilotCreateDialog.vue",
+        "components/dialogs/PilotEditDialog.vue": "internal/dialogs/PilotEditDialog.vue",
+        "components/dialogs/PromoCodeCreateDialog.vue": "internal/dialogs/PromoCodeCreateDialog.vue",
+        "components/dialogs/PromoCodeDialogFields.vue": "internal/dialogs/PromoCodeDialogFields.vue",
+        "components/dialogs/PromoCodeEditDialog.vue": "internal/dialogs/PromoCodeEditDialog.vue",
+        "components/dialogs/pilot-dialog.css": "internal/dialogs/pilot-dialog.css",
+        "components/dialogs/types.ts": "internal/dialogs/types.ts",
+        "pages-standard/AdminLayout.vue": "layouts/AdminLayout.vue",
+        "pages-standard/SuperAdminLoginPage.vue": "auth/SuperAdminLoginPage.vue",
+        "pages-standard/SuperAdminSetupWizard.vue": "auth/SuperAdminSetupWizard.vue",
+        "pages-standard/AdminManifestErrorPage.vue": "pages/AdminManifestErrorPage.vue",
+        "pages-standard/AuditPage.vue": "pages/AuditPage.vue",
+        "pages-standard/BundlesPage.vue": "pages/BundlesPage.vue",
+        "pages-standard/DashboardPage.vue": "pages/DashboardPage.vue",
+        "pages-standard/DiscoveryPage.vue": "pages/DiscoveryPage.vue",
+        "pages-standard/EmailHistoryPage.vue": "pages/EmailHistoryPage.vue",
+        "pages-standard/MarketingCatalogPage.vue": "pages/MarketingCatalogPage.vue",
+        "pages-standard/PilotsPage.vue": "pages/PilotsPage.vue",
+        "pages-standard/PlansPage.vue": "pages/PlansPage.vue",
+        "pages-standard/PlatformEmailPage.vue": "pages/PlatformEmailPage.vue",
+        "pages-standard/PromoCodeDetailPage.vue": "pages/PromoCodeDetailPage.vue",
+        "pages-standard/PromoCodesPage.vue": "pages/PromoCodesPage.vue",
+        "pages-standard/SubscriptionsPage.vue": "pages/SubscriptionsPage.vue",
+        "pages-standard/TenantDetailPage.vue": "pages/TenantDetailPage.vue",
+        "pages-standard/TenantsPage.vue": "pages/TenantsPage.vue",
+        "pages-standard/UsersPage.vue": "pages/UsersPage.vue",
+        "pages-standard/email-history.types.ts": "internal/email-history/email-history.types.ts",
+        "pages-standard/platform-email.types.ts": "internal/platform-email/platform-email.types.ts",
+        "components/MfaPromptDialog.vue": "ui/overlay/MfaPromptDialog.vue",
+        "components/LocaleSwitcher.vue": "ui/page/LocaleSwitcher.vue",
+        "components/ThemeSwitcher.vue": "ui/page/ThemeSwitcher.vue",
+        "components/MarketingPromotionsTab.vue": "features/marketing/MarketingPromotionsTab.vue",
+        "components/TenantActionConfirmDialog.vue": "features/tenant/TenantActionConfirmDialog.vue",
+        "components/VersionDiffPreview.vue": "features/bundle/VersionDiffPreview.vue",
+        "pages-standard/sa-theme.css": "ui/theme/sa-theme.css"
+    },
+    "moveDirectories": {
+        "pages-standard/bundles-page": "internal/bundles-page",
+        "pages-standard/discovery-page": "internal/discovery-page",
+        "pages-standard/marketing-catalog": "internal/marketing-catalog",
+        "pages-standard/plan-versions": "internal/plan-versions",
+        "pages-standard/plans-page": "internal/plans-page",
+        "pages-standard/tenant-detail": "internal/tenant-detail",
+        "pages-standard/tenants": "internal/tenants"
+    },
+    "packages": {
+        "_": "Subpaths that left @saasicat/ui-vue for a package of their own. The value is a full specifier, and the codemod emits it verbatim.",
+        "pages-tenant/": "@saasicat/ui-vue-tenant/"
+    },
+    "stays": {
+        "client/": "framework-free layer, unchanged",
+        "vue/": "composables, unchanged",
+        "quasar/": "the one non-SFC place that may import quasar, unchanged",
+        "ui/theme/": "already in its destination (AP2)",
+        "testing-e2e/ \u2192 testing/": "renamed in phase 5 (5.8); `codemod v1-rename` rewrites the specifier",
+        "pages-standard/sa-theme.css \u2192 ui/theme/": "moved so that pages-standard/ can go; renamed to theme.css in 4.2"
+    }
+}

package/codemods/v1-rename.map.json

@@ -0,0 +1,45 @@
+{
+    "_namingHistory": "The 1.0 rename as data. Every old spelling below is named on purpose: this table is what `saasicat codemod v1-rename` runs on, and `tests/one-spelling.test.js` reads this key as the declaration.",
+    "_comment": [
+        "Phase 5 (AP1) renamed four things a consumer's code can carry:",
+        "identifier stems, registry keys, one token that had two meanings, and",
+        "one export subpath. Each section is one of those, and the codemod",
+        "applies them in that order.",
+        "",
+        "`identifierStems` is matched anywhere in an identifier — the stem alone",
+        "covers `SaasPlatformModule`, `createSaasPlatformTestModule` and",
+        "`CreateSaasPlatformTestModuleOptions` without listing them. The lowercase",
+        "`saasicat` (scope, files) is not a stem and is never touched.",
+        "",
+        "`registryKeys` rewrites the string a `Symbol.for` is called with. A",
+        "consumer that spelled a key themselves gets the same symbol the platform",
+        "now registers; without this their injection would resolve to nothing.",
+        "",
+        "`entryTokens` is keyed by the import specifier, because the old name",
+        "meant different registries in different entries. An import of it from",
+        "anywhere else is reported, not guessed."
+    ],
+    "identifierStems": {
+        "SaasPlatform": "SaaSiCat",
+        "Saasicat": "SaaSiCat",
+        "SaaSicat": "SaaSiCat"
+    },
+    "registryKeys": {
+        "saas-platform/": "saasicat/nest/",
+        "saas-platform-nest/": "saasicat/nest/",
+        "saas-platform-cli/": "saasicat/cli/",
+        "@saasicat/ui-vue/": "saasicat/ui-vue/",
+        "FakeTransactionRunner.tx": "saasicat/nest/FakeTransactionRunner.tx"
+    },
+    "entryTokens": {
+        "@saasicat/nest/billing": {
+            "FEATURE_UI_REGISTRY_TOKEN": "BILLING_FEATURE_UI_REGISTRY_TOKEN"
+        },
+        "@saasicat/nest/catalog": {
+            "FEATURE_UI_REGISTRY_TOKEN": "CATALOG_FEATURE_UI_REGISTRY_TOKEN"
+        }
+    },
+    "subpaths": {
+        "@saasicat/ui-vue/testing-e2e/": "@saasicat/ui-vue/testing/"
+    }
+}

package/dist/.build-stamp

@@ -0,0 +1 @@
+87fdb737df2d686fe3d296add0d87c2a3765371380b486e2ff20fda896b3db65

package/dist/index.cjs

@@ -64,6 +64,7 @@ __export(index_exports, {
   MfaSetupFlow: () => MfaSetupFlow,
   PLATFORM_DOCTOR_CHECK_PROVIDERS: () => PLATFORM_DOCTOR_CHECK_PROVIDERS,
   PlanCatalogDoctorCheck: () => PlanCatalogDoctorCheck,
+  UI_VUE_SPECIFIER: () => UI_VUE_SPECIFIER,
   USER_MANAGEMENT_PORT_TOKEN: () => USER_MANAGEMENT_PORT_TOKEN,
   USER_PORT_TOKEN: () => USER_PORT_TOKEN,
   UserCommands: () => UserCommands,
@@ -78,6 +79,7 @@ __export(index_exports, {
   blankStringLiterals: () => blankStringLiterals,
   blockBodyLines: () => blockBodyLines,
   breaksContract: () => breaksContract,
+  buildImportMap: () => buildImportMap,
   checkSchema: () => checkSchema,
   constraintsFor: () => constraintsFor,
   enableFkPointers: () => enableFkPointers,
@@ -89,10 +91,12 @@ __export(index_exports, {
   foreignKeyOf: () => foreignKeyOf,
   hasBackRelation: () => hasBackRelation,
   hasConstraints: () => hasConstraints,
+  isNoLongerPublic: () => isNoLongerPublic,
   isOneToOne: () => isOneToOne,
   kebabCase: () => kebabCase,
   migrationCreatedBy: () => migrationCreatedBy,
   minimumQuotasPerPlan: () => minimumQuotasPerPlan,
+  namedImports: () => namedImports,
   parseBlockAttributes: () => parseBlockAttributes,
   parseEnumValues: () => parseEnumValues,
   parseFields: () => parseFields,
@@ -106,20 +110,23 @@ __export(index_exports, {
   quotaKeyPattern: () => quotaKeyPattern,
   relationNameOf: () => relationNameOf,
   reportConstraints: () => reportConstraints,
+  rewriteImports: () => rewriteImports,
+  rewriteNames: () => rewriteNames,
+  rewriteSubpath: () => rewriteSubpath,
   stripLineComment: () => stripLineComment,
   structuralOnly: () => structuralOnly,
   tablesAddressedBy: () => tablesAddressedBy
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/tokens.ts
-var CLI_CONTEXT_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/Config");
-var USER_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/UserPort");
-var USER_MANAGEMENT_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/UserManagementPort");
-var AUDIT_QUERY_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/AuditQueryPort");
-var DOCTOR_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/DoctorChecks");
-var MANIFEST_ACCESS_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/ManifestAccessPort");
-var MANIFEST_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/ManifestChecks");
+// src/cli.tokens.ts
+var CLI_CONTEXT_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/Config");
+var USER_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/UserPort");
+var USER_MANAGEMENT_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/UserManagementPort");
+var AUDIT_QUERY_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/AuditQueryPort");
+var DOCTOR_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/DoctorChecks");
+var MANIFEST_ACCESS_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/ManifestAccessPort");
+var MANIFEST_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/ManifestChecks");
 
 // src/cli-context.service.ts
 var os = __toESM(require("os"), 1);
@@ -1827,6 +1834,187 @@ function patchOptionsFor(plan) {
 }
 __name(patchOptionsFor, "patchOptionsFor");
 
+// src/codemods/v1-imports.ts
+var PUBLIC_PREFIXES = [
+  "ui/",
+  "layouts/",
+  "auth/",
+  "pages/"
+];
+function buildImportMap(table) {
+  const map = /* @__PURE__ */ new Map();
+  for (const [from, to] of Object.entries(table.moves)) {
+    const onSurface = PUBLIC_PREFIXES.some((prefix) => to.startsWith(prefix));
+    if (!onSurface && !to.startsWith("@")) continue;
+    if (from.startsWith("components/")) {
+      map.set(from, to);
+      continue;
+    }
+    if (!from.startsWith("pages-standard/")) continue;
+    const file = from.slice("pages-standard/".length);
+    if (file.includes("/")) continue;
+    map.set(from, to);
+    map.set(`pages/${file}`, to);
+  }
+  for (const [from, to] of Object.entries(table.packages ?? {})) {
+    if (from === "_") continue;
+    map.set(from, to);
+  }
+  for (const [from, to] of Object.entries(table.moveDirectories ?? {})) {
+    map.set(`${from}/`, `${to}/`);
+  }
+  return map;
+}
+__name(buildImportMap, "buildImportMap");
+function wentPrivate(map, subpath) {
+  for (const [prefix, target] of map) {
+    if (prefix.endsWith("/") && target.startsWith("internal/") && subpath.startsWith(prefix)) {
+      return true;
+    }
+  }
+  return false;
+}
+__name(wentPrivate, "wentPrivate");
+function rewriteSubpath(map, subpath) {
+  const direct = map.get(subpath);
+  if (direct !== void 0 && direct !== subpath) return direct;
+  for (const [prefix, target] of map) {
+    if (prefix.endsWith("/") && target.startsWith("@") && subpath.startsWith(prefix)) {
+      return `${target}${subpath.slice(prefix.length)}`;
+    }
+  }
+  if (subpath.startsWith("pages-standard/") && !wentPrivate(map, subpath)) {
+    const file = subpath.slice("pages-standard/".length);
+    if (!file.includes("/")) return `pages/${file}`;
+  }
+  return null;
+}
+__name(rewriteSubpath, "rewriteSubpath");
+function isNoLongerPublic(map, subpath) {
+  if (subpath.startsWith("components/")) return !map.has(subpath);
+  return subpath.startsWith("pages-standard/") && wentPrivate(map, subpath);
+}
+__name(isNoLongerPublic, "isNoLongerPublic");
+var UI_VUE_SPECIFIER = /@saasicat\/ui-vue\/([A-Za-z0-9/_.-]+)/g;
+function rewriteImports(text, map) {
+  const unmapped = /* @__PURE__ */ new Map();
+  let rewritten = 0;
+  const next = text.replace(UI_VUE_SPECIFIER, (whole, subpath) => {
+    const to = rewriteSubpath(map, subpath);
+    if (to === null) {
+      if (isNoLongerPublic(map, subpath)) {
+        unmapped.set(subpath, (unmapped.get(subpath) ?? 0) + 1);
+      }
+      return whole;
+    }
+    rewritten += 1;
+    return to.startsWith("@") ? to : `@saasicat/ui-vue/${to}`;
+  });
+  return {
+    text: next,
+    rewritten,
+    unmapped
+  };
+}
+__name(rewriteImports, "rewriteImports");
+
+// src/codemods/v1-rename.ts
+var escape = /* @__PURE__ */ __name((s) => s.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&"), "escape");
+var FROM_SPECIFIER = /from\s*(['"])([^'"]+)\1/g;
+var isSpace = /* @__PURE__ */ __name((ch) => ch === " " || ch === "	" || ch === "\n" || ch === "\r", "isSpace");
+function namedImports(text) {
+  const found = [];
+  for (const match of text.matchAll(FROM_SPECIFIER)) {
+    let i = (match.index ?? 0) - 1;
+    while (i >= 0 && isSpace(text[i])) i -= 1;
+    if (text[i] !== "}") continue;
+    const close = i;
+    const open = text.lastIndexOf("{", close);
+    if (open < 0) continue;
+    i = open - 1;
+    while (i >= 0 && isSpace(text[i])) i -= 1;
+    let head = text.slice(Math.max(0, i - 3), i + 1);
+    if (head === "type") {
+      i -= 4;
+      while (i >= 0 && isSpace(text[i])) i -= 1;
+      head = text.slice(Math.max(0, i - 5), i + 1);
+    } else {
+      head = text.slice(Math.max(0, i - 5), i + 1);
+    }
+    if (head !== "import") continue;
+    const names = text.slice(open + 1, close).split(",").map((raw) => {
+      const words = raw.trim().split(/\s+/);
+      if (words[0] === "type") words.shift();
+      return words[0] ?? "";
+    }).filter((name) => name.length > 0);
+    found.push({
+      names,
+      specifier: match[2]
+    });
+  }
+  return found;
+}
+__name(namedImports, "namedImports");
+function rewriteNames(text, table) {
+  let next = text;
+  let rewritten = 0;
+  const ambiguous = /* @__PURE__ */ new Set();
+  const perEntry = /* @__PURE__ */ new Map();
+  for (const { names, specifier } of namedImports(text)) {
+    const mapping = table.entryTokens[specifier];
+    for (const name of names) {
+      const knownSomewhere = Object.values(table.entryTokens).some((m) => name in m);
+      if (!knownSomewhere) continue;
+      const already = perEntry.get(name);
+      if (mapping && name in mapping && (already === void 0 || already === mapping[name])) {
+        perEntry.set(name, mapping[name]);
+      } else {
+        if (already !== void 0) perEntry.delete(name);
+        ambiguous.add(`${name} from '${specifier}'`);
+      }
+    }
+  }
+  for (const [from, to] of perEntry) {
+    next = next.replace(new RegExp(`\\b${escape(from)}\\b`, "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  for (const [from, to] of Object.entries(table.identifierStems)) {
+    next = next.replace(new RegExp(escape(from), "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  for (const [from, to] of Object.entries(table.registryKeys)) {
+    const symbolFor = new RegExp(`(Symbol\\.for\\(\\s*['"\`])${escape(from)}`, "g");
+    next = next.replace(symbolFor, (_, head) => {
+      rewritten += 1;
+      return `${head}${to}`;
+    });
+    if (from.startsWith("@")) continue;
+    const literal = new RegExp(`(['"\`])${escape(from)}`, "g");
+    next = next.replace(literal, (_, quote) => {
+      rewritten += 1;
+      return `${quote}${to}`;
+    });
+  }
+  for (const [from, to] of Object.entries(table.subpaths)) {
+    next = next.replace(new RegExp(escape(from), "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  return {
+    text: next,
+    rewritten,
+    ambiguous: [
+      ...ambiguous
+    ].sort()
+  };
+}
+__name(rewriteNames, "rewriteNames");
+
 // src/init/patch-app-module.ts
 var MARKER = "SaaSiCatModule.forRoot";
 function patchAppModule(source, options) {
@@ -1951,7 +2139,7 @@ var LIMIT_FILTER_IMPORTS = [
   "import { LimitExceededFilter } from '@saasicat/nest/billing';"
 ].join("\n");
 
-// src/module.ts
+// src/cli-context.module.ts
 var import_common8 = require("@nestjs/common");
 var import_nest5 = require("@saasicat/nest");
 function _ts_decorate8(decorators, target, key, desc) {
@@ -3037,6 +3225,7 @@ UserCommands = _ts_decorate14([
   MfaSetupFlow,
   PLATFORM_DOCTOR_CHECK_PROVIDERS,
   PlanCatalogDoctorCheck,
+  UI_VUE_SPECIFIER,
   USER_MANAGEMENT_PORT_TOKEN,
   USER_PORT_TOKEN,
   UserCommands,
@@ -3051,6 +3240,7 @@ UserCommands = _ts_decorate14([
   blankStringLiterals,
   blockBodyLines,
   breaksContract,
+  buildImportMap,
   checkSchema,
   constraintsFor,
   enableFkPointers,
@@ -3062,10 +3252,12 @@ UserCommands = _ts_decorate14([
   foreignKeyOf,
   hasBackRelation,
   hasConstraints,
+  isNoLongerPublic,
   isOneToOne,
   kebabCase,
   migrationCreatedBy,
   minimumQuotasPerPlan,
+  namedImports,
   parseBlockAttributes,
   parseEnumValues,
   parseFields,
@@ -3079,6 +3271,9 @@ UserCommands = _ts_decorate14([
   quotaKeyPattern,
   relationNameOf,
   reportConstraints,
+  rewriteImports,
+  rewriteNames,
+  rewriteSubpath,
   stripLineComment,
   structuralOnly,
   tablesAddressedBy

package/dist/index.d.cts

@@ -820,6 +820,90 @@ declare function assertValidProjectKey(projectKey: string): void;
 /** The same, for a quota key. `additionalProperties: false` makes it a hard rule. */
 declare function assertValidQuotaKey(quotaKey: string): void;
 
+/** One entry of the move table: where a file was, and where it went. */
+interface MoveTable {
+    readonly moves: Readonly<Record<string, string>>;
+    /**
+     * Prefixes that left the package entirely. The value is a full specifier
+     * — `@saasicat/ui-vue-tenant/` — and is emitted verbatim.
+     */
+    readonly packages?: Readonly<Record<string, string>>;
+    /**
+     * Directories whose files left the surface as a whole — the page-private
+     * parts under `pages-standard/<page>/` that became `internal/<page>/`.
+     */
+    readonly moveDirectories?: Readonly<Record<string, string>>;
+}
+/**
+ * Old subpath → new subpath, derived from the move table.
+ *
+ * Both spellings of a page that moved are mapped, because both were reachable:
+ * `pages/AdminLayout.vue` and `pages-standard/AdminLayout.vue` named one file.
+ */
+declare function buildImportMap(table: MoveTable): Map<string, string>;
+/**
+ * What a subpath becomes, or null when it is already right.
+ *
+ * A `pages-standard/` path with no entry in the table is a page that did not
+ * move: it keeps its name under the surviving alias.
+ */
+declare function rewriteSubpath(map: ReadonlyMap<string, string>, subpath: string): string | null;
+/**
+ * Whether a subpath was public before and is not any more.
+ *
+ * Reported rather than rewritten: it moved into `features/` or `internal/`,
+ * which the 1.0 surface does not publish, so there is no destination to point
+ * at. Leaving it silently would hand the consumer a build error with no
+ * explanation of what happened.
+ */
+declare function isNoLongerPublic(map: ReadonlyMap<string, string>, subpath: string): boolean;
+/** Every `@saasicat/ui-vue/<subpath>` occurrence in a source text. */
+declare const UI_VUE_SPECIFIER: RegExp;
+interface RewriteResult {
+    readonly text: string;
+    readonly rewritten: number;
+    /** Subpaths that lost their export, with how often each appeared. */
+    readonly unmapped: ReadonlyMap<string, number>;
+}
+/** Applies the map to one file's text. */
+declare function rewriteImports(text: string, map: ReadonlyMap<string, string>): RewriteResult;
+
+/** One entry of the rename table. */
+interface RenameTable {
+    /** An identifier stem, matched anywhere in an identifier, and its replacement. */
+    readonly identifierStems: Readonly<Record<string, string>>;
+    /** A registry-key prefix (or a whole key) inside a string literal, and its replacement. */
+    readonly registryKeys: Readonly<Record<string, string>>;
+    /** Per import specifier: a name that means something different per entry. */
+    readonly entryTokens: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** A module specifier prefix and its replacement. */
+    readonly subpaths: Readonly<Record<string, string>>;
+}
+interface RenameResult {
+    readonly text: string;
+    readonly rewritten: number;
+    /**
+     * Names the table knows only per entry, imported from somewhere the table
+     * does not cover. Reported rather than guessed: which registry the
+     * consumer meant is not in the text.
+     */
+    readonly ambiguous: readonly string[];
+}
+/**
+ * The specifier and the bound names of every `import { … } from '…'`.
+ *
+ * Read backwards from each `from`, one character at a time, instead of with
+ * one regular expression over the statement: `\{([^}]*)\}\s+from` and its
+ * siblings backtrack quadratically on a file full of `import {{`, and the
+ * file is a consumer's — whatever they wrote, this must finish.
+ */
+declare function namedImports(text: string): Array<{
+    names: string[];
+    specifier: string;
+}>;
+/** Applies the table to one file's text. Idempotent: a second run changes nothing. */
+declare function rewriteNames(text: string, table: RenameTable): RenameResult;
+
 interface PatchAppModuleOptions {
     /** Import specifier for the persistence bundle, or null when not generated. */
     persistenceImport: string | null;
@@ -1063,4 +1147,4 @@ declare class UserCommands extends CommandRunner {
     parsePassword(val: string): string;
 }
 
-export { AUDIT_QUERY_PORT_TOKEN, AdminCommands, AdminManifestDoctorCheck, AdminMfaSetupCommand, AdminWhoamiCommand, type ApplyResult, AuditCommands, AuditTailCommand, AuditTailFlow, type AuditTailOptions, type BlockAttributeKind, type BlockAttributes, CLI_CONTEXT_CONFIG_TOKEN, CONSTRAINTS_MARKER, type CheckSeverity, type CliContextConfig, CliContextModule, type CliContextModuleOptions, CliContextService, CliError, type CliIdentity, type ConstraintsOutcome, type ConstraintsReport, DEFAULT_MANIFEST_CHECKS, DOCTOR_CHECKS_TOKEN, DiscoveryCommands, DiscoveryScanCommand, DiscoverySnapshotDoctorCheck, type DoctorCheck, type DoctorCheckResult, DoctorCommands, DoctorFlow, type DoctorReport, type EnableFkResult, type FieldMismatch, type FieldMismatchReason, type FieldSignature, type FkModelNames, type FkPointer, type InitOptions, type InitPlan, LIMIT_FILTER_IMPORTS, LIMIT_FILTER_PROVIDER, MANIFEST_ACCESS_PORT_TOKEN, MANIFEST_CHECKS_TOKEN, type ManifestCheck, ManifestCheckCommand, type ManifestCheckReport, type ManifestCheckResult, ManifestCliFlow, ManifestCommands, type ManifestDiff, ManifestDumpCommand, ManifestHashCommand, ManifestValidateCommand, MfaSetupFlow, type MfaSetupOptions, type MfaSetupResult, type MissingBlockAttribute, type MissingEnumValue, type MissingField, PLATFORM_DOCTOR_CHECK_PROVIDERS, type ParsedSchema, type PatchAppModuleOptions, type PatchOptionsFromPlan, type PatchResult, PlanCatalogDoctorCheck, type PlannedFile, type QuotaProviderFile, type QuotaSpec, type SchemaCheckReport, USER_MANAGEMENT_PORT_TOKEN, USER_PORT_TOKEN, UserCommands, UserPortDoctorCheck, WhoAmIFlow, type WhoAmIResult, appendConstraints, applyFragmentBlocks, applyTokens, assertModelsExist, assertValidProjectKey, assertValidQuotaKey, blankStringLiterals, blockBodyLines, breaksContract, checkSchema, constraintsFor, enableFkPointers, extractBlockNames, extractBlocks, extractModelBlocks, extractModelNames, findFkPointers, foreignKeyOf, hasBackRelation, hasConstraints, isOneToOne, kebabCase, migrationCreatedBy, minimumQuotasPerPlan, parseBlockAttributes, parseEnumValues, parseFields, parseQuota, parseSchema, pascalCase, patchAppModule, patchOptionsFor, planInit, projectKeyPattern, quotaKeyPattern, relationNameOf, reportConstraints, stripLineComment, structuralOnly, tablesAddressedBy };
+export { AUDIT_QUERY_PORT_TOKEN, AdminCommands, AdminManifestDoctorCheck, AdminMfaSetupCommand, AdminWhoamiCommand, type ApplyResult, AuditCommands, AuditTailCommand, AuditTailFlow, type AuditTailOptions, type BlockAttributeKind, type BlockAttributes, CLI_CONTEXT_CONFIG_TOKEN, CONSTRAINTS_MARKER, type CheckSeverity, type CliContextConfig, CliContextModule, type CliContextModuleOptions, CliContextService, CliError, type CliIdentity, type ConstraintsOutcome, type ConstraintsReport, DEFAULT_MANIFEST_CHECKS, DOCTOR_CHECKS_TOKEN, DiscoveryCommands, DiscoveryScanCommand, DiscoverySnapshotDoctorCheck, type DoctorCheck, type DoctorCheckResult, DoctorCommands, DoctorFlow, type DoctorReport, type EnableFkResult, type FieldMismatch, type FieldMismatchReason, type FieldSignature, type FkModelNames, type FkPointer, type InitOptions, type InitPlan, LIMIT_FILTER_IMPORTS, LIMIT_FILTER_PROVIDER, MANIFEST_ACCESS_PORT_TOKEN, MANIFEST_CHECKS_TOKEN, type ManifestCheck, ManifestCheckCommand, type ManifestCheckReport, type ManifestCheckResult, ManifestCliFlow, ManifestCommands, type ManifestDiff, ManifestDumpCommand, ManifestHashCommand, ManifestValidateCommand, MfaSetupFlow, type MfaSetupOptions, type MfaSetupResult, type MissingBlockAttribute, type MissingEnumValue, type MissingField, type MoveTable, PLATFORM_DOCTOR_CHECK_PROVIDERS, type ParsedSchema, type PatchAppModuleOptions, type PatchOptionsFromPlan, type PatchResult, PlanCatalogDoctorCheck, type PlannedFile, type QuotaProviderFile, type QuotaSpec, type RenameResult, type RenameTable, type RewriteResult, type SchemaCheckReport, UI_VUE_SPECIFIER, USER_MANAGEMENT_PORT_TOKEN, USER_PORT_TOKEN, UserCommands, UserPortDoctorCheck, WhoAmIFlow, type WhoAmIResult, appendConstraints, applyFragmentBlocks, applyTokens, assertModelsExist, assertValidProjectKey, assertValidQuotaKey, blankStringLiterals, blockBodyLines, breaksContract, buildImportMap, checkSchema, constraintsFor, enableFkPointers, extractBlockNames, extractBlocks, extractModelBlocks, extractModelNames, findFkPointers, foreignKeyOf, hasBackRelation, hasConstraints, isNoLongerPublic, isOneToOne, kebabCase, migrationCreatedBy, minimumQuotasPerPlan, namedImports, parseBlockAttributes, parseEnumValues, parseFields, parseQuota, parseSchema, pascalCase, patchAppModule, patchOptionsFor, planInit, projectKeyPattern, quotaKeyPattern, relationNameOf, reportConstraints, rewriteImports, rewriteNames, rewriteSubpath, stripLineComment, structuralOnly, tablesAddressedBy };

package/dist/index.d.ts

@@ -820,6 +820,90 @@ declare function assertValidProjectKey(projectKey: string): void;
 /** The same, for a quota key. `additionalProperties: false` makes it a hard rule. */
 declare function assertValidQuotaKey(quotaKey: string): void;
 
+/** One entry of the move table: where a file was, and where it went. */
+interface MoveTable {
+    readonly moves: Readonly<Record<string, string>>;
+    /**
+     * Prefixes that left the package entirely. The value is a full specifier
+     * — `@saasicat/ui-vue-tenant/` — and is emitted verbatim.
+     */
+    readonly packages?: Readonly<Record<string, string>>;
+    /**
+     * Directories whose files left the surface as a whole — the page-private
+     * parts under `pages-standard/<page>/` that became `internal/<page>/`.
+     */
+    readonly moveDirectories?: Readonly<Record<string, string>>;
+}
+/**
+ * Old subpath → new subpath, derived from the move table.
+ *
+ * Both spellings of a page that moved are mapped, because both were reachable:
+ * `pages/AdminLayout.vue` and `pages-standard/AdminLayout.vue` named one file.
+ */
+declare function buildImportMap(table: MoveTable): Map<string, string>;
+/**
+ * What a subpath becomes, or null when it is already right.
+ *
+ * A `pages-standard/` path with no entry in the table is a page that did not
+ * move: it keeps its name under the surviving alias.
+ */
+declare function rewriteSubpath(map: ReadonlyMap<string, string>, subpath: string): string | null;
+/**
+ * Whether a subpath was public before and is not any more.
+ *
+ * Reported rather than rewritten: it moved into `features/` or `internal/`,
+ * which the 1.0 surface does not publish, so there is no destination to point
+ * at. Leaving it silently would hand the consumer a build error with no
+ * explanation of what happened.
+ */
+declare function isNoLongerPublic(map: ReadonlyMap<string, string>, subpath: string): boolean;
+/** Every `@saasicat/ui-vue/<subpath>` occurrence in a source text. */
+declare const UI_VUE_SPECIFIER: RegExp;
+interface RewriteResult {
+    readonly text: string;
+    readonly rewritten: number;
+    /** Subpaths that lost their export, with how often each appeared. */
+    readonly unmapped: ReadonlyMap<string, number>;
+}
+/** Applies the map to one file's text. */
+declare function rewriteImports(text: string, map: ReadonlyMap<string, string>): RewriteResult;
+
+/** One entry of the rename table. */
+interface RenameTable {
+    /** An identifier stem, matched anywhere in an identifier, and its replacement. */
+    readonly identifierStems: Readonly<Record<string, string>>;
+    /** A registry-key prefix (or a whole key) inside a string literal, and its replacement. */
+    readonly registryKeys: Readonly<Record<string, string>>;
+    /** Per import specifier: a name that means something different per entry. */
+    readonly entryTokens: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** A module specifier prefix and its replacement. */
+    readonly subpaths: Readonly<Record<string, string>>;
+}
+interface RenameResult {
+    readonly text: string;
+    readonly rewritten: number;
+    /**
+     * Names the table knows only per entry, imported from somewhere the table
+     * does not cover. Reported rather than guessed: which registry the
+     * consumer meant is not in the text.
+     */
+    readonly ambiguous: readonly string[];
+}
+/**
+ * The specifier and the bound names of every `import { … } from '…'`.
+ *
+ * Read backwards from each `from`, one character at a time, instead of with
+ * one regular expression over the statement: `\{([^}]*)\}\s+from` and its
+ * siblings backtrack quadratically on a file full of `import {{`, and the
+ * file is a consumer's — whatever they wrote, this must finish.
+ */
+declare function namedImports(text: string): Array<{
+    names: string[];
+    specifier: string;
+}>;
+/** Applies the table to one file's text. Idempotent: a second run changes nothing. */
+declare function rewriteNames(text: string, table: RenameTable): RenameResult;
+
 interface PatchAppModuleOptions {
     /** Import specifier for the persistence bundle, or null when not generated. */
     persistenceImport: string | null;
@@ -1063,4 +1147,4 @@ declare class UserCommands extends CommandRunner {
     parsePassword(val: string): string;
 }
 
-export { AUDIT_QUERY_PORT_TOKEN, AdminCommands, AdminManifestDoctorCheck, AdminMfaSetupCommand, AdminWhoamiCommand, type ApplyResult, AuditCommands, AuditTailCommand, AuditTailFlow, type AuditTailOptions, type BlockAttributeKind, type BlockAttributes, CLI_CONTEXT_CONFIG_TOKEN, CONSTRAINTS_MARKER, type CheckSeverity, type CliContextConfig, CliContextModule, type CliContextModuleOptions, CliContextService, CliError, type CliIdentity, type ConstraintsOutcome, type ConstraintsReport, DEFAULT_MANIFEST_CHECKS, DOCTOR_CHECKS_TOKEN, DiscoveryCommands, DiscoveryScanCommand, DiscoverySnapshotDoctorCheck, type DoctorCheck, type DoctorCheckResult, DoctorCommands, DoctorFlow, type DoctorReport, type EnableFkResult, type FieldMismatch, type FieldMismatchReason, type FieldSignature, type FkModelNames, type FkPointer, type InitOptions, type InitPlan, LIMIT_FILTER_IMPORTS, LIMIT_FILTER_PROVIDER, MANIFEST_ACCESS_PORT_TOKEN, MANIFEST_CHECKS_TOKEN, type ManifestCheck, ManifestCheckCommand, type ManifestCheckReport, type ManifestCheckResult, ManifestCliFlow, ManifestCommands, type ManifestDiff, ManifestDumpCommand, ManifestHashCommand, ManifestValidateCommand, MfaSetupFlow, type MfaSetupOptions, type MfaSetupResult, type MissingBlockAttribute, type MissingEnumValue, type MissingField, PLATFORM_DOCTOR_CHECK_PROVIDERS, type ParsedSchema, type PatchAppModuleOptions, type PatchOptionsFromPlan, type PatchResult, PlanCatalogDoctorCheck, type PlannedFile, type QuotaProviderFile, type QuotaSpec, type SchemaCheckReport, USER_MANAGEMENT_PORT_TOKEN, USER_PORT_TOKEN, UserCommands, UserPortDoctorCheck, WhoAmIFlow, type WhoAmIResult, appendConstraints, applyFragmentBlocks, applyTokens, assertModelsExist, assertValidProjectKey, assertValidQuotaKey, blankStringLiterals, blockBodyLines, breaksContract, checkSchema, constraintsFor, enableFkPointers, extractBlockNames, extractBlocks, extractModelBlocks, extractModelNames, findFkPointers, foreignKeyOf, hasBackRelation, hasConstraints, isOneToOne, kebabCase, migrationCreatedBy, minimumQuotasPerPlan, parseBlockAttributes, parseEnumValues, parseFields, parseQuota, parseSchema, pascalCase, patchAppModule, patchOptionsFor, planInit, projectKeyPattern, quotaKeyPattern, relationNameOf, reportConstraints, stripLineComment, structuralOnly, tablesAddressedBy };
+export { AUDIT_QUERY_PORT_TOKEN, AdminCommands, AdminManifestDoctorCheck, AdminMfaSetupCommand, AdminWhoamiCommand, type ApplyResult, AuditCommands, AuditTailCommand, AuditTailFlow, type AuditTailOptions, type BlockAttributeKind, type BlockAttributes, CLI_CONTEXT_CONFIG_TOKEN, CONSTRAINTS_MARKER, type CheckSeverity, type CliContextConfig, CliContextModule, type CliContextModuleOptions, CliContextService, CliError, type CliIdentity, type ConstraintsOutcome, type ConstraintsReport, DEFAULT_MANIFEST_CHECKS, DOCTOR_CHECKS_TOKEN, DiscoveryCommands, DiscoveryScanCommand, DiscoverySnapshotDoctorCheck, type DoctorCheck, type DoctorCheckResult, DoctorCommands, DoctorFlow, type DoctorReport, type EnableFkResult, type FieldMismatch, type FieldMismatchReason, type FieldSignature, type FkModelNames, type FkPointer, type InitOptions, type InitPlan, LIMIT_FILTER_IMPORTS, LIMIT_FILTER_PROVIDER, MANIFEST_ACCESS_PORT_TOKEN, MANIFEST_CHECKS_TOKEN, type ManifestCheck, ManifestCheckCommand, type ManifestCheckReport, type ManifestCheckResult, ManifestCliFlow, ManifestCommands, type ManifestDiff, ManifestDumpCommand, ManifestHashCommand, ManifestValidateCommand, MfaSetupFlow, type MfaSetupOptions, type MfaSetupResult, type MissingBlockAttribute, type MissingEnumValue, type MissingField, type MoveTable, PLATFORM_DOCTOR_CHECK_PROVIDERS, type ParsedSchema, type PatchAppModuleOptions, type PatchOptionsFromPlan, type PatchResult, PlanCatalogDoctorCheck, type PlannedFile, type QuotaProviderFile, type QuotaSpec, type RenameResult, type RenameTable, type RewriteResult, type SchemaCheckReport, UI_VUE_SPECIFIER, USER_MANAGEMENT_PORT_TOKEN, USER_PORT_TOKEN, UserCommands, UserPortDoctorCheck, WhoAmIFlow, type WhoAmIResult, appendConstraints, applyFragmentBlocks, applyTokens, assertModelsExist, assertValidProjectKey, assertValidQuotaKey, blankStringLiterals, blockBodyLines, breaksContract, buildImportMap, checkSchema, constraintsFor, enableFkPointers, extractBlockNames, extractBlocks, extractModelBlocks, extractModelNames, findFkPointers, foreignKeyOf, hasBackRelation, hasConstraints, isNoLongerPublic, isOneToOne, kebabCase, migrationCreatedBy, minimumQuotasPerPlan, namedImports, parseBlockAttributes, parseEnumValues, parseFields, parseQuota, parseSchema, pascalCase, patchAppModule, patchOptionsFor, planInit, projectKeyPattern, quotaKeyPattern, relationNameOf, reportConstraints, rewriteImports, rewriteNames, rewriteSubpath, stripLineComment, structuralOnly, tablesAddressedBy };

package/dist/index.js

@@ -1,14 +1,14 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
-// src/tokens.ts
-var CLI_CONTEXT_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/Config");
-var USER_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/UserPort");
-var USER_MANAGEMENT_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/UserManagementPort");
-var AUDIT_QUERY_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/AuditQueryPort");
-var DOCTOR_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/DoctorChecks");
-var MANIFEST_ACCESS_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/ManifestAccessPort");
-var MANIFEST_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/ManifestChecks");
+// src/cli.tokens.ts
+var CLI_CONTEXT_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/Config");
+var USER_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/UserPort");
+var USER_MANAGEMENT_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/UserManagementPort");
+var AUDIT_QUERY_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/AuditQueryPort");
+var DOCTOR_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/DoctorChecks");
+var MANIFEST_ACCESS_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/ManifestAccessPort");
+var MANIFEST_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/ManifestChecks");
 
 // src/cli-context.service.ts
 import * as os from "os";
@@ -1716,6 +1716,187 @@ function patchOptionsFor(plan) {
 }
 __name(patchOptionsFor, "patchOptionsFor");
 
+// src/codemods/v1-imports.ts
+var PUBLIC_PREFIXES = [
+  "ui/",
+  "layouts/",
+  "auth/",
+  "pages/"
+];
+function buildImportMap(table) {
+  const map = /* @__PURE__ */ new Map();
+  for (const [from, to] of Object.entries(table.moves)) {
+    const onSurface = PUBLIC_PREFIXES.some((prefix) => to.startsWith(prefix));
+    if (!onSurface && !to.startsWith("@")) continue;
+    if (from.startsWith("components/")) {
+      map.set(from, to);
+      continue;
+    }
+    if (!from.startsWith("pages-standard/")) continue;
+    const file = from.slice("pages-standard/".length);
+    if (file.includes("/")) continue;
+    map.set(from, to);
+    map.set(`pages/${file}`, to);
+  }
+  for (const [from, to] of Object.entries(table.packages ?? {})) {
+    if (from === "_") continue;
+    map.set(from, to);
+  }
+  for (const [from, to] of Object.entries(table.moveDirectories ?? {})) {
+    map.set(`${from}/`, `${to}/`);
+  }
+  return map;
+}
+__name(buildImportMap, "buildImportMap");
+function wentPrivate(map, subpath) {
+  for (const [prefix, target] of map) {
+    if (prefix.endsWith("/") && target.startsWith("internal/") && subpath.startsWith(prefix)) {
+      return true;
+    }
+  }
+  return false;
+}
+__name(wentPrivate, "wentPrivate");
+function rewriteSubpath(map, subpath) {
+  const direct = map.get(subpath);
+  if (direct !== void 0 && direct !== subpath) return direct;
+  for (const [prefix, target] of map) {
+    if (prefix.endsWith("/") && target.startsWith("@") && subpath.startsWith(prefix)) {
+      return `${target}${subpath.slice(prefix.length)}`;
+    }
+  }
+  if (subpath.startsWith("pages-standard/") && !wentPrivate(map, subpath)) {
+    const file = subpath.slice("pages-standard/".length);
+    if (!file.includes("/")) return `pages/${file}`;
+  }
+  return null;
+}
+__name(rewriteSubpath, "rewriteSubpath");
+function isNoLongerPublic(map, subpath) {
+  if (subpath.startsWith("components/")) return !map.has(subpath);
+  return subpath.startsWith("pages-standard/") && wentPrivate(map, subpath);
+}
+__name(isNoLongerPublic, "isNoLongerPublic");
+var UI_VUE_SPECIFIER = /@saasicat\/ui-vue\/([A-Za-z0-9/_.-]+)/g;
+function rewriteImports(text, map) {
+  const unmapped = /* @__PURE__ */ new Map();
+  let rewritten = 0;
+  const next = text.replace(UI_VUE_SPECIFIER, (whole, subpath) => {
+    const to = rewriteSubpath(map, subpath);
+    if (to === null) {
+      if (isNoLongerPublic(map, subpath)) {
+        unmapped.set(subpath, (unmapped.get(subpath) ?? 0) + 1);
+      }
+      return whole;
+    }
+    rewritten += 1;
+    return to.startsWith("@") ? to : `@saasicat/ui-vue/${to}`;
+  });
+  return {
+    text: next,
+    rewritten,
+    unmapped
+  };
+}
+__name(rewriteImports, "rewriteImports");
+
+// src/codemods/v1-rename.ts
+var escape = /* @__PURE__ */ __name((s) => s.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&"), "escape");
+var FROM_SPECIFIER = /from\s*(['"])([^'"]+)\1/g;
+var isSpace = /* @__PURE__ */ __name((ch) => ch === " " || ch === "	" || ch === "\n" || ch === "\r", "isSpace");
+function namedImports(text) {
+  const found = [];
+  for (const match of text.matchAll(FROM_SPECIFIER)) {
+    let i = (match.index ?? 0) - 1;
+    while (i >= 0 && isSpace(text[i])) i -= 1;
+    if (text[i] !== "}") continue;
+    const close = i;
+    const open = text.lastIndexOf("{", close);
+    if (open < 0) continue;
+    i = open - 1;
+    while (i >= 0 && isSpace(text[i])) i -= 1;
+    let head = text.slice(Math.max(0, i - 3), i + 1);
+    if (head === "type") {
+      i -= 4;
+      while (i >= 0 && isSpace(text[i])) i -= 1;
+      head = text.slice(Math.max(0, i - 5), i + 1);
+    } else {
+      head = text.slice(Math.max(0, i - 5), i + 1);
+    }
+    if (head !== "import") continue;
+    const names = text.slice(open + 1, close).split(",").map((raw) => {
+      const words = raw.trim().split(/\s+/);
+      if (words[0] === "type") words.shift();
+      return words[0] ?? "";
+    }).filter((name) => name.length > 0);
+    found.push({
+      names,
+      specifier: match[2]
+    });
+  }
+  return found;
+}
+__name(namedImports, "namedImports");
+function rewriteNames(text, table) {
+  let next = text;
+  let rewritten = 0;
+  const ambiguous = /* @__PURE__ */ new Set();
+  const perEntry = /* @__PURE__ */ new Map();
+  for (const { names, specifier } of namedImports(text)) {
+    const mapping = table.entryTokens[specifier];
+    for (const name of names) {
+      const knownSomewhere = Object.values(table.entryTokens).some((m) => name in m);
+      if (!knownSomewhere) continue;
+      const already = perEntry.get(name);
+      if (mapping && name in mapping && (already === void 0 || already === mapping[name])) {
+        perEntry.set(name, mapping[name]);
+      } else {
+        if (already !== void 0) perEntry.delete(name);
+        ambiguous.add(`${name} from '${specifier}'`);
+      }
+    }
+  }
+  for (const [from, to] of perEntry) {
+    next = next.replace(new RegExp(`\\b${escape(from)}\\b`, "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  for (const [from, to] of Object.entries(table.identifierStems)) {
+    next = next.replace(new RegExp(escape(from), "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  for (const [from, to] of Object.entries(table.registryKeys)) {
+    const symbolFor = new RegExp(`(Symbol\\.for\\(\\s*['"\`])${escape(from)}`, "g");
+    next = next.replace(symbolFor, (_, head) => {
+      rewritten += 1;
+      return `${head}${to}`;
+    });
+    if (from.startsWith("@")) continue;
+    const literal = new RegExp(`(['"\`])${escape(from)}`, "g");
+    next = next.replace(literal, (_, quote) => {
+      rewritten += 1;
+      return `${quote}${to}`;
+    });
+  }
+  for (const [from, to] of Object.entries(table.subpaths)) {
+    next = next.replace(new RegExp(escape(from), "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  return {
+    text: next,
+    rewritten,
+    ambiguous: [
+      ...ambiguous
+    ].sort()
+  };
+}
+__name(rewriteNames, "rewriteNames");
+
 // src/init/patch-app-module.ts
 var MARKER = "SaaSiCatModule.forRoot";
 function patchAppModule(source, options) {
@@ -1840,7 +2021,7 @@ var LIMIT_FILTER_IMPORTS = [
   "import { LimitExceededFilter } from '@saasicat/nest/billing';"
 ].join("\n");
 
-// src/module.ts
+// src/cli-context.module.ts
 import { Module } from "@nestjs/common";
 import { asProvider } from "@saasicat/nest";
 function _ts_decorate8(decorators, target, key, desc) {
@@ -2925,6 +3106,7 @@ export {
   MfaSetupFlow,
   PLATFORM_DOCTOR_CHECK_PROVIDERS,
   PlanCatalogDoctorCheck,
+  UI_VUE_SPECIFIER,
   USER_MANAGEMENT_PORT_TOKEN,
   USER_PORT_TOKEN,
   UserCommands,
@@ -2939,6 +3121,7 @@ export {
   blankStringLiterals,
   blockBodyLines,
   breaksContract,
+  buildImportMap,
   checkSchema,
   constraintsFor,
   enableFkPointers,
@@ -2950,10 +3133,12 @@ export {
   foreignKeyOf,
   hasBackRelation,
   hasConstraints,
+  isNoLongerPublic,
   isOneToOne,
   kebabCase,
   migrationCreatedBy,
   minimumQuotasPerPlan,
+  namedImports,
   parseBlockAttributes,
   parseEnumValues,
   parseFields,
@@ -2967,6 +3152,9 @@ export {
   quotaKeyPattern,
   relationNameOf,
   reportConstraints,
+  rewriteImports,
+  rewriteNames,
+  rewriteSubpath,
   stripLineComment,
   structuralOnly,
   tablesAddressedBy

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/cli",
-  "version": "0.27.0",
+  "version": "1.0.0-rc.0",
   "description": "CLI helpers for SaaS platform consumers. Provides CliContextService (identity, MFA, production confirm, audit tag).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -21,16 +21,17 @@
   "files": [
     "dist",
     "bin",
-    "templates"
+    "templates",
+    "codemods"
   ],
   "bin": {
     "saasicat": "./bin/saasicat.js"
   },
   "dependencies": {
     "qrcode-terminal": "^0.12.0",
-    "@saasicat/nest": "^0.27.0",
-    "@saasicat/spec": "^0.27.0",
-    "@saasicat/types": "^0.27.0"
+    "@saasicat/nest": "^1.0.0-rc.0",
+    "@saasicat/spec": "^1.0.0-rc.0",
+    "@saasicat/types": "^1.0.0-rc.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",
@@ -49,7 +50,7 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/uelker70/saasicat.git",
-    "directory": "packages/saas-platform-cli"
+    "directory": "packages/cli"
   },
   "bugs": {
     "url": "https://github.com/uelker70/saasicat/issues"
@@ -60,6 +61,6 @@
   "scripts": {
     "build": "node ../../scripts/build-and-prune.mjs \"tsup src/index.ts --format esm,cjs --dts --external @saasicat/types --external @saasicat/nest --external @nestjs/common --external nest-commander --external qrcode-terminal\"",
     "pretest": "pnpm run build",
-    "test": "node --test tests/**/*.test.js"
+    "test": "node --test 'tests/*.test.js'"
   }
 }