@actuate-media/cli 0.11.2 → 0.12.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @actuate-media/cli@0.11.2 build /home/runner/work/actuatecms/actuatecms/packages/cli
+> @actuate-media/cli@0.12.0 build /home/runner/work/actuatecms/actuatecms/packages/cli
 > tsc
 

package/.turbo/turbo-test.log

@@ -1,60 +1,60 @@
 
-> @actuate-media/cli@0.11.2 test /home/runner/work/actuatecms/actuatecms/packages/cli
+> @actuate-media/cli@0.12.0 test /home/runner/work/actuatecms/actuatecms/packages/cli
 > vitest run
 
 
  RUN  v4.1.8 /home/runner/work/actuatecms/actuatecms/packages/cli
 
- ✓ dist/__tests__/db-sync.test.js (10 tests) 353ms
- ✓ dist/__tests__/seed.test.js (10 tests) 117ms
- ✓ src/__tests__/db-sync.test.ts (10 tests) 495ms
- ✓ dist/__tests__/deployment-diagnostics.test.js (9 tests) 99ms
- ✓ src/__tests__/seed.test.ts (10 tests) 146ms
- ✓ src/__tests__/deployment-diagnostics.test.ts (9 tests) 60ms
+ ✓ dist/__tests__/db-sync.test.js (10 tests) 233ms
+ ✓ dist/__tests__/seed.test.js (10 tests) 128ms
+ ✓ src/__tests__/db-sync.test.ts (10 tests) 219ms
+ ✓ dist/__tests__/deployment-diagnostics.test.js (9 tests) 35ms
+ ✓ src/__tests__/seed.test.ts (10 tests) 164ms
+ ✓ src/__tests__/deployment-diagnostics.test.ts (9 tests) 49ms
 - Reading canonical Actuate schema...
-stdout | dist/__tests__/db-init.test.js > db:init (WS-D D5 — canonical schema, no stale fragment) > command > injects canonical models with @@map and no duplicate datasource/generator
 ✔ Actuate CMS models added to schema.
 - Running prisma generate...
+stdout | dist/__tests__/db-init.test.js > db:init (WS-D D5 — canonical schema, no stale fragment) > command > injects canonical models with @@map and no duplicate datasource/generator
 ✔ Prisma client generated.
 ℹ Run `npx prisma migrate dev --name actuate-cms` to create the migration.
 
 stdout | dist/__tests__/db-init.test.js > db:init (WS-D D5 — canonical schema, no stale fragment) > command > fails clearly when cms-core cannot be located
-ℹ Install it first: `npm install @actuate-media/cms-core`.
 - Reading canonical Actuate schema...
-
 ✖ Could not locate @actuate-media/cms-core.
+ℹ Install it first: `npm install @actuate-media/cms-core`.
+
 - Reading canonical Actuate schema...
 ✔ Actuate CMS models added to schema.
-- Running prisma generate...
 stdout | dist/__tests__/db-init.test.js > db:init (WS-D D5 — canonical schema, no stale fragment) > command > is idempotent without --force
 ✔ Prisma client generated.
+- Running prisma generate...
 ℹ Run `npx prisma migrate dev --name actuate-cms` to create the migration.
 
 - Reading canonical Actuate schema...
 ℹ Actuate CMS models already present in schema. Use --force to overwrite.
- ✓ dist/__tests__/db-init.test.js (4 tests) 265ms
+ ✓ dist/__tests__/db-init.test.js (4 tests) 228ms
 - Reading canonical Actuate schema...
-✔ Actuate CMS models added to schema.
-- Running prisma generate...
 stdout | src/__tests__/db-init.test.ts > db:init (WS-D D5 — canonical schema, no stale fragment) > command > injects canonical models with @@map and no duplicate datasource/generator
 ✔ Prisma client generated.
 ℹ Run `npx prisma migrate dev --name actuate-cms` to create the migration.
 
+✔ Actuate CMS models added to schema.
+- Running prisma generate...
+- Reading canonical Actuate schema...
 stdout | src/__tests__/db-init.test.ts > db:init (WS-D D5 — canonical schema, no stale fragment) > command > fails clearly when cms-core cannot be located
+✖ Could not locate @actuate-media/cms-core.
 ℹ Install it first: `npm install @actuate-media/cms-core`.
-- Reading canonical Actuate schema...
 
-✖ Could not locate @actuate-media/cms-core.
 - Reading canonical Actuate schema...
 stdout | src/__tests__/db-init.test.ts > db:init (WS-D D5 — canonical schema, no stale fragment) > command > is idempotent without --force
 ✔ Prisma client generated.
-ℹ Run `npx prisma migrate dev --name actuate-cms` to create the migration.
-
 ✔ Actuate CMS models added to schema.
+ℹ Run `npx prisma migrate dev --name actuate-cms` to create the migration.
 - Running prisma generate...
+
 - Reading canonical Actuate schema...
 ℹ Actuate CMS models already present in schema. Use --force to overwrite.
- ✓ src/__tests__/db-init.test.ts (4 tests) 203ms
+ ✓ src/__tests__/db-init.test.ts (4 tests) 246ms
 stdout | dist/__tests__/mcp-init.test.js > mcp:init > creates both editor configs with placeholder key and git-ignores them
 ✔ Created .cursor/mcp.json
 
@@ -183,7 +183,7 @@ Next steps
   3. Restart Cursor / VS Code so the MCP server is picked up
   Tip: pass --url https://your-site.com to target a deployed CMS instead.
 
- ✓ dist/__tests__/mcp-init.test.js (6 tests) 330ms
+ ✓ dist/__tests__/mcp-init.test.js (6 tests) 249ms
 stdout | src/__tests__/mcp-init.test.ts > mcp:init > creates both editor configs with placeholder key and git-ignores them
 ✔ Created .cursor/mcp.json
 
@@ -312,13 +312,13 @@ Next steps
   3. Restart Cursor / VS Code so the MCP server is picked up
   Tip: pass --url https://your-site.com to target a deployed CMS instead.
 
- ✓ src/__tests__/mcp-init.test.ts (6 tests) 523ms
- ✓ dist/__tests__/form-seed.test.js (10 tests) 66ms
- ✓ src/__tests__/form-seed.test.ts (10 tests) 31ms
- ✓ dist/__tests__/vercel-env-matrix.test.js (6 tests) 50ms
- ✓ src/__tests__/vercel-env-matrix.test.ts (6 tests) 61ms
- ✓ dist/__tests__/load-dotenv.test.js (3 tests) 75ms
- ✓ src/__tests__/load-dotenv.test.ts (3 tests) 100ms
+ ✓ src/__tests__/mcp-init.test.ts (6 tests) 134ms
+ ✓ dist/__tests__/form-seed.test.js (10 tests) 31ms
+ ✓ src/__tests__/form-seed.test.ts (10 tests) 34ms
+ ✓ dist/__tests__/vercel-env-matrix.test.js (6 tests) 28ms
+ ✓ src/__tests__/vercel-env-matrix.test.ts (6 tests) 30ms
+ ✓ dist/__tests__/load-dotenv.test.js (3 tests) 37ms
+ ✓ src/__tests__/load-dotenv.test.ts (3 tests) 44ms
 - Reading canonical Actuate schema...
 ✔ Actuate CMS models added to schema.
 - Running prisma generate...
@@ -326,20 +326,20 @@ Next steps
 ✔ Prisma client generated.
 ℹ Run `npx prisma migrate dev --name actuate-cms` to create the migration.
 
- ✓ dist/__tests__/schema-fragment.test.js (1 test) 119ms
+ ✓ dist/__tests__/schema-fragment.test.js (1 test) 80ms
 - Reading canonical Actuate schema...
 ✔ Actuate CMS models added to schema.
-- Running prisma generate...
 stdout | src/__tests__/schema-fragment.test.ts > db:init schema fragment > injects all deploy-critical Actuate models
 ✔ Prisma client generated.
+- Running prisma generate...
 ℹ Run `npx prisma migrate dev --name actuate-cms` to create the migration.
 
- ✓ src/__tests__/schema-fragment.test.ts (1 test) 114ms
- ✓ dist/__tests__/init.test.js (2 tests) 33ms
- ✓ src/__tests__/init.test.ts (2 tests) 30ms
+ ✓ src/__tests__/schema-fragment.test.ts (1 test) 66ms
+ ✓ dist/__tests__/init.test.js (2 tests) 16ms
+ ✓ src/__tests__/init.test.ts (2 tests) 15ms
 
  Test Files  20 passed (20)
       Tests  122 passed (122)
-   Start at  18:10:11
-   Duration  28.76s (transform 2.79s, setup 0ms, import 7.35s, tests 3.27s, environment 13ms)
+   Start at  05:27:27
+   Duration  21.87s (transform 2.20s, setup 0ms, import 5.83s, tests 2.07s, environment 21ms)
 

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @actuate-media/cli
 
+## 0.12.0
+
+### Minor Changes
+
+- bc51a1d: Align SEO audit with live page meta output, expand audit checks, wire redirect/link signals, and add `actuate migrate:meta` for bulk meta backfill.
+
+## 0.11.3
+
+### Patch Changes
+
+- 9d4e24c: Hide the redundant site name headline on the login screen and in the admin sidebar when a logo image is displayed.
+
+  Serve favicons as properly sized 32×32 PNGs (and 180×180 apple-touch icons) from dedicated public routes so SVG and oversized sources render correctly in browser tabs.
+
+  Align SEO audit schema/canonical detection with public page rendering, add `actuate migrate:schema` to backfill structuredDataType on existing content, and fix route-contract tests for new favicon endpoints.
+
 ## 0.11.2
 
 ### Patch Changes

package/dist/commands/migrate-meta.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerMigrateMetaCommand(program: Command): void;
+//# sourceMappingURL=migrate-meta.d.ts.map

package/dist/commands/migrate-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-meta.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgGnC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUjE"}

package/dist/commands/migrate-meta.js

@@ -0,0 +1,81 @@
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import ora from 'ora';
+import { connectProjectDatabase } from '../utils/database.js';
+import { loadProjectEnv } from '../utils/load-dotenv.js';
+import { logger } from '../utils/logger.js';
+async function loadProjectConfig(configPath) {
+    try {
+        const { setActuateConfig } = await import('@actuate-media/cms-core');
+        const { tsImport } = await import('tsx/esm/api');
+        const abs = pathToFileURL(resolve(configPath)).href;
+        const mod = (await tsImport(abs, import.meta.url));
+        const config = mod.default ?? mod.config;
+        if (config && typeof config === 'object') {
+            setActuateConfig(config);
+        }
+    }
+    catch {
+        logger.warn(`Could not load ${configPath} — meta defaults will use collection slug heuristics only.`);
+    }
+}
+/** `actuate migrate:meta` — backfill metaTitle/metaDescription on content documents. */
+async function runMigrateMeta(options) {
+    const dryRun = options.dryRun ?? false;
+    const batchSize = options.batchSize ? Number.parseInt(options.batchSize, 10) : undefined;
+    if (batchSize !== undefined && (!Number.isFinite(batchSize) || batchSize <= 0)) {
+        logger.error('--batch-size must be a positive integer.');
+        process.exit(1);
+    }
+    await loadProjectEnv(process.cwd()).then((env) => {
+        for (const [key, value] of Object.entries(env)) {
+            if (value !== undefined && process.env[key] === undefined) {
+                process.env[key] = value;
+            }
+        }
+    });
+    await loadProjectConfig(options.config ?? 'actuate.config.ts');
+    let connection = null;
+    const spinner = ora(dryRun ? 'Scanning content documents (dry run)…' : 'Backfilling meta title/description…').start();
+    try {
+        connection = await connectProjectDatabase();
+        const db = connection.db;
+        const { migrateMetaFields } = await import('@actuate-media/cms-core');
+        const admin = await db.user.findFirst({ where: { role: 'ADMIN' } });
+        if (!admin) {
+            spinner.fail('No ADMIN user found. Create an admin (setup wizard or seed) first.');
+            process.exit(1);
+        }
+        const ctx = { userId: admin.id, role: 'ADMIN', db: connection.db, locale: 'en' };
+        const result = await migrateMetaFields(ctx, { dryRun, batchSize });
+        spinner.succeed(dryRun
+            ? `Dry run complete — ${result.migrated} document(s) would be updated.`
+            : `Updated ${result.migrated} document(s).`);
+        logger.info(`  Scanned:  ${result.scanned}`);
+        logger.info(`  Migrated: ${result.migrated}`);
+        logger.info(`  Skipped:  ${result.skipped}`);
+        if (result.migratedIds.length > 0) {
+            logger.info(`  IDs:      ${result.migratedIds.join(', ')}`);
+        }
+        logger.info('');
+        logger.info('Next: re-run the SEO audit in Settings → SEO → Audit.');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        spinner.fail(`Meta migration failed: ${message}`);
+        process.exit(1);
+    }
+    finally {
+        await connection?.disconnect();
+    }
+}
+export function registerMigrateMetaCommand(program) {
+    program
+        .command('migrate:meta')
+        .description('Backfill metaTitle/metaDescription from title templates and key takeaways. Idempotent.')
+        .option('--dry-run', 'Report what would change without writing')
+        .option('--batch-size <n>', 'Documents to scan per DB page (default 100)')
+        .option('--config <path>', 'Path to actuate.config.ts', 'actuate.config.ts')
+        .action(runMigrateMeta);
+}
+//# sourceMappingURL=migrate-meta.js.map

package/dist/commands/migrate-meta.js.map

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

package/dist/commands/migrate-schema.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerMigrateSchemaCommand(program: Command): void;
+//# sourceMappingURL=migrate-schema.d.ts.map

package/dist/commands/migrate-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-schema.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmGnC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUnE"}

package/dist/commands/migrate-schema.js

@@ -0,0 +1,84 @@
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import ora from 'ora';
+import { connectProjectDatabase } from '../utils/database.js';
+import { loadProjectEnv } from '../utils/load-dotenv.js';
+import { logger } from '../utils/logger.js';
+async function loadProjectConfig(configPath) {
+    try {
+        const { setActuateConfig } = await import('@actuate-media/cms-core');
+        const { tsImport } = await import('tsx/esm/api');
+        const abs = pathToFileURL(resolve(configPath)).href;
+        const mod = (await tsImport(abs, import.meta.url));
+        const config = mod.default ?? mod.config;
+        if (config && typeof config === 'object') {
+            setActuateConfig(config);
+        }
+    }
+    catch {
+        logger.warn(`Could not load ${configPath} — schema defaults will use collection slug heuristics only.`);
+    }
+}
+/**
+ * `actuate migrate:schema` — backfill structuredDataType/schemaType and JSON-LD
+ * on published content documents. Idempotent.
+ */
+async function runMigrateSchema(options) {
+    const dryRun = options.dryRun ?? false;
+    const batchSize = options.batchSize ? Number.parseInt(options.batchSize, 10) : undefined;
+    if (batchSize !== undefined && (!Number.isFinite(batchSize) || batchSize <= 0)) {
+        logger.error('--batch-size must be a positive integer.');
+        process.exit(1);
+    }
+    await loadProjectEnv(process.cwd()).then((env) => {
+        for (const [key, value] of Object.entries(env)) {
+            if (value !== undefined && process.env[key] === undefined) {
+                process.env[key] = value;
+            }
+        }
+    });
+    await loadProjectConfig(options.config ?? 'actuate.config.ts');
+    let connection = null;
+    const spinner = ora(dryRun ? 'Scanning content documents (dry run)…' : 'Backfilling structured data fields…').start();
+    try {
+        connection = await connectProjectDatabase();
+        const db = connection.db;
+        const { migrateStructuredDataFields } = await import('@actuate-media/cms-core');
+        const admin = await db.user.findFirst({ where: { role: 'ADMIN' } });
+        if (!admin) {
+            spinner.fail('No ADMIN user found. Create an admin (setup wizard or seed) first.');
+            process.exit(1);
+        }
+        const ctx = { userId: admin.id, role: 'ADMIN', db: connection.db, locale: 'en' };
+        const result = await migrateStructuredDataFields(ctx, { dryRun, batchSize });
+        spinner.succeed(dryRun
+            ? `Dry run complete — ${result.migrated} document(s) would be updated.`
+            : `Updated ${result.migrated} document(s).`);
+        logger.info(`  Scanned:  ${result.scanned}`);
+        logger.info(`  Migrated: ${result.migrated}`);
+        logger.info(`  Skipped:  ${result.skipped}`);
+        if (result.migratedIds.length > 0) {
+            logger.info(`  IDs:      ${result.migratedIds.join(', ')}`);
+        }
+        logger.info('');
+        logger.info('Next: re-run the SEO audit in Settings → SEO → Audit.');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        spinner.fail(`Schema migration failed: ${message}`);
+        process.exit(1);
+    }
+    finally {
+        await connection?.disconnect();
+    }
+}
+export function registerMigrateSchemaCommand(program) {
+    program
+        .command('migrate:schema')
+        .description('Backfill structuredDataType/schemaType (and published JSON-LD) on content documents. Idempotent.')
+        .option('--dry-run', 'Report what would change without writing')
+        .option('--batch-size <n>', 'Documents to scan per DB page (default 100)')
+        .option('--config <path>', 'Path to actuate.config.ts', 'actuate.config.ts')
+        .action(runMigrateSchema);
+}
+//# sourceMappingURL=migrate-schema.js.map

package/dist/commands/migrate-schema.js.map

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

package/dist/index.js

@@ -2,6 +2,8 @@
 import { Command } from 'commander';
 import { registerMigrateCommand } from './commands/migrate.js';
 import { registerMigrateSectionsCommand } from './commands/migrate-sections.js';
+import { registerMigrateSchemaCommand } from './commands/migrate-schema.js';
+import { registerMigrateMetaCommand } from './commands/migrate-meta.js';
 import { registerGenerateCommand } from './commands/generate.js';
 import { registerSeedCommand } from './commands/seed.js';
 import { registerImportCommand } from './commands/import.js';
@@ -22,6 +24,8 @@ program
     .version('0.1.0');
 registerMigrateCommand(program);
 registerMigrateSectionsCommand(program);
+registerMigrateSchemaCommand(program);
+registerMigrateMetaCommand(program);
 registerGenerateCommand(program);
 registerSeedCommand(program);
 registerImportCommand(program);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAA;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,sBAAsB,CAAC,OAAO,CAAC,CAAA;AAC/B,8BAA8B,CAAC,OAAO,CAAC,CAAA;AACvC,uBAAuB,CAAC,OAAO,CAAC,CAAA;AAChC,mBAAmB,CAAC,OAAO,CAAC,CAAA;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAA;AAC/B,0BAA0B,CAAC,OAAO,CAAC,CAAA;AACnC,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAA;AAChC,mBAAmB,CAAC,OAAO,CAAC,CAAA;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,0BAA0B,CAAC,OAAO,CAAC,CAAA;AACnC,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,6BAA6B,CAAC,OAAO,CAAC,CAAA;AACtC,kBAAkB,CAAC,OAAO,CAAC,CAAA;AAE3B,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAA;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAA;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,sBAAsB,CAAC,OAAO,CAAC,CAAA;AAC/B,8BAA8B,CAAC,OAAO,CAAC,CAAA;AACvC,4BAA4B,CAAC,OAAO,CAAC,CAAA;AACrC,0BAA0B,CAAC,OAAO,CAAC,CAAA;AACnC,uBAAuB,CAAC,OAAO,CAAC,CAAA;AAChC,mBAAmB,CAAC,OAAO,CAAC,CAAA;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAA;AAC/B,0BAA0B,CAAC,OAAO,CAAC,CAAA;AACnC,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAA;AAChC,mBAAmB,CAAC,OAAO,CAAC,CAAA;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,0BAA0B,CAAC,OAAO,CAAC,CAAA;AACnC,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC9B,6BAA6B,CAAC,OAAO,CAAC,CAAA;AACtC,kBAAkB,CAAC,OAAO,CAAC,CAAA;AAE3B,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actuate-media/cli",
-  "version": "0.11.2",
+  "version": "0.12.0",
   "description": "CLI for Actuate CMS — migrations, codegen, imports, exports, and upgrades",
   "repository": {
     "type": "git",
@@ -28,7 +28,7 @@
   "devDependencies": {
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@actuate-media/cms-core": "0.76.3"
+    "@actuate-media/cms-core": "0.78.0"
   },
   "scripts": {
     "build": "tsc",

package/src/commands/migrate-meta.ts

@@ -0,0 +1,107 @@
+import { Command } from 'commander'
+import { resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import ora from 'ora'
+import { connectProjectDatabase } from '../utils/database.js'
+import { loadProjectEnv } from '../utils/load-dotenv.js'
+import { logger } from '../utils/logger.js'
+
+interface MigrateMetaOptions {
+  dryRun?: boolean
+  batchSize?: string
+  config?: string
+}
+
+async function loadProjectConfig(configPath: string): Promise<void> {
+  try {
+    const { setActuateConfig } = await import('@actuate-media/cms-core')
+    const { tsImport } = await import('tsx/esm/api')
+    const abs = pathToFileURL(resolve(configPath)).href
+    const mod = (await tsImport(abs, import.meta.url)) as {
+      default?: unknown
+      config?: unknown
+    }
+    const config = mod.default ?? mod.config
+    if (config && typeof config === 'object') {
+      setActuateConfig(config as never)
+    }
+  } catch {
+    logger.warn(
+      `Could not load ${configPath} — meta defaults will use collection slug heuristics only.`,
+    )
+  }
+}
+
+/** `actuate migrate:meta` — backfill metaTitle/metaDescription on content documents. */
+async function runMigrateMeta(options: MigrateMetaOptions): Promise<void> {
+  const dryRun = options.dryRun ?? false
+  const batchSize = options.batchSize ? Number.parseInt(options.batchSize, 10) : undefined
+  if (batchSize !== undefined && (!Number.isFinite(batchSize) || batchSize <= 0)) {
+    logger.error('--batch-size must be a positive integer.')
+    process.exit(1)
+  }
+
+  await loadProjectEnv(process.cwd()).then((env) => {
+    for (const [key, value] of Object.entries(env)) {
+      if (value !== undefined && process.env[key] === undefined) {
+        process.env[key] = value
+      }
+    }
+  })
+  await loadProjectConfig(options.config ?? 'actuate.config.ts')
+
+  let connection: { db: unknown; disconnect: () => Promise<void> } | null = null
+  const spinner = ora(
+    dryRun ? 'Scanning content documents (dry run)…' : 'Backfilling meta title/description…',
+  ).start()
+
+  try {
+    connection = await connectProjectDatabase()
+    const db = connection.db as {
+      user: { findFirst: (args: unknown) => Promise<{ id: string } | null> }
+    }
+
+    const { migrateMetaFields } = await import('@actuate-media/cms-core')
+
+    const admin = await db.user.findFirst({ where: { role: 'ADMIN' } })
+    if (!admin) {
+      spinner.fail('No ADMIN user found. Create an admin (setup wizard or seed) first.')
+      process.exit(1)
+    }
+
+    const ctx = { userId: admin.id, role: 'ADMIN', db: connection.db, locale: 'en' }
+    const result = await migrateMetaFields(ctx, { dryRun, batchSize })
+
+    spinner.succeed(
+      dryRun
+        ? `Dry run complete — ${result.migrated} document(s) would be updated.`
+        : `Updated ${result.migrated} document(s).`,
+    )
+    logger.info(`  Scanned:  ${result.scanned}`)
+    logger.info(`  Migrated: ${result.migrated}`)
+    logger.info(`  Skipped:  ${result.skipped}`)
+    if (result.migratedIds.length > 0) {
+      logger.info(`  IDs:      ${result.migratedIds.join(', ')}`)
+    }
+    logger.info('')
+    logger.info('Next: re-run the SEO audit in Settings → SEO → Audit.')
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err)
+    spinner.fail(`Meta migration failed: ${message}`)
+    process.exit(1)
+  } finally {
+    await connection?.disconnect()
+  }
+}
+
+export function registerMigrateMetaCommand(program: Command): void {
+  program
+    .command('migrate:meta')
+    .description(
+      'Backfill metaTitle/metaDescription from title templates and key takeaways. Idempotent.',
+    )
+    .option('--dry-run', 'Report what would change without writing')
+    .option('--batch-size <n>', 'Documents to scan per DB page (default 100)')
+    .option('--config <path>', 'Path to actuate.config.ts', 'actuate.config.ts')
+    .action(runMigrateMeta)
+}

package/src/commands/migrate-schema.ts

@@ -0,0 +1,110 @@
+import { Command } from 'commander'
+import { resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import ora from 'ora'
+import { connectProjectDatabase } from '../utils/database.js'
+import { loadProjectEnv } from '../utils/load-dotenv.js'
+import { logger } from '../utils/logger.js'
+
+interface MigrateSchemaOptions {
+  dryRun?: boolean
+  batchSize?: string
+  config?: string
+}
+
+async function loadProjectConfig(configPath: string): Promise<void> {
+  try {
+    const { setActuateConfig } = await import('@actuate-media/cms-core')
+    const { tsImport } = await import('tsx/esm/api')
+    const abs = pathToFileURL(resolve(configPath)).href
+    const mod = (await tsImport(abs, import.meta.url)) as {
+      default?: unknown
+      config?: unknown
+    }
+    const config = mod.default ?? mod.config
+    if (config && typeof config === 'object') {
+      setActuateConfig(config as never)
+    }
+  } catch {
+    logger.warn(
+      `Could not load ${configPath} — schema defaults will use collection slug heuristics only.`,
+    )
+  }
+}
+
+/**
+ * `actuate migrate:schema` — backfill structuredDataType/schemaType and JSON-LD
+ * on published content documents. Idempotent.
+ */
+async function runMigrateSchema(options: MigrateSchemaOptions): Promise<void> {
+  const dryRun = options.dryRun ?? false
+  const batchSize = options.batchSize ? Number.parseInt(options.batchSize, 10) : undefined
+  if (batchSize !== undefined && (!Number.isFinite(batchSize) || batchSize <= 0)) {
+    logger.error('--batch-size must be a positive integer.')
+    process.exit(1)
+  }
+
+  await loadProjectEnv(process.cwd()).then((env) => {
+    for (const [key, value] of Object.entries(env)) {
+      if (value !== undefined && process.env[key] === undefined) {
+        process.env[key] = value
+      }
+    }
+  })
+  await loadProjectConfig(options.config ?? 'actuate.config.ts')
+
+  let connection: { db: unknown; disconnect: () => Promise<void> } | null = null
+  const spinner = ora(
+    dryRun ? 'Scanning content documents (dry run)…' : 'Backfilling structured data fields…',
+  ).start()
+
+  try {
+    connection = await connectProjectDatabase()
+    const db = connection.db as {
+      user: { findFirst: (args: unknown) => Promise<{ id: string } | null> }
+    }
+
+    const { migrateStructuredDataFields } = await import('@actuate-media/cms-core')
+
+    const admin = await db.user.findFirst({ where: { role: 'ADMIN' } })
+    if (!admin) {
+      spinner.fail('No ADMIN user found. Create an admin (setup wizard or seed) first.')
+      process.exit(1)
+    }
+
+    const ctx = { userId: admin.id, role: 'ADMIN', db: connection.db, locale: 'en' }
+    const result = await migrateStructuredDataFields(ctx, { dryRun, batchSize })
+
+    spinner.succeed(
+      dryRun
+        ? `Dry run complete — ${result.migrated} document(s) would be updated.`
+        : `Updated ${result.migrated} document(s).`,
+    )
+    logger.info(`  Scanned:  ${result.scanned}`)
+    logger.info(`  Migrated: ${result.migrated}`)
+    logger.info(`  Skipped:  ${result.skipped}`)
+    if (result.migratedIds.length > 0) {
+      logger.info(`  IDs:      ${result.migratedIds.join(', ')}`)
+    }
+    logger.info('')
+    logger.info('Next: re-run the SEO audit in Settings → SEO → Audit.')
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err)
+    spinner.fail(`Schema migration failed: ${message}`)
+    process.exit(1)
+  } finally {
+    await connection?.disconnect()
+  }
+}
+
+export function registerMigrateSchemaCommand(program: Command): void {
+  program
+    .command('migrate:schema')
+    .description(
+      'Backfill structuredDataType/schemaType (and published JSON-LD) on content documents. Idempotent.',
+    )
+    .option('--dry-run', 'Report what would change without writing')
+    .option('--batch-size <n>', 'Documents to scan per DB page (default 100)')
+    .option('--config <path>', 'Path to actuate.config.ts', 'actuate.config.ts')
+    .action(runMigrateSchema)
+}

package/src/index.ts

@@ -2,6 +2,8 @@
 import { Command } from 'commander'
 import { registerMigrateCommand } from './commands/migrate.js'
 import { registerMigrateSectionsCommand } from './commands/migrate-sections.js'
+import { registerMigrateSchemaCommand } from './commands/migrate-schema.js'
+import { registerMigrateMetaCommand } from './commands/migrate-meta.js'
 import { registerGenerateCommand } from './commands/generate.js'
 import { registerSeedCommand } from './commands/seed.js'
 import { registerImportCommand } from './commands/import.js'
@@ -29,6 +31,8 @@ program
 
 registerMigrateCommand(program)
 registerMigrateSectionsCommand(program)
+registerMigrateSchemaCommand(program)
+registerMigrateMetaCommand(program)
 registerGenerateCommand(program)
 registerSeedCommand(program)
 registerImportCommand(program)