@productbrain/cli 0.1.0-beta.14 → 0.1.0-beta.14010

package/dist/commands/admin/seed.js

@@ -0,0 +1,642 @@
+/**
+ * pb admin seed — workspace and platform seed operations (WP-312 S3, FEAT-970).
+ *
+ * The seed list is generated from `convex/admin/commandManifestSeeds.ts` and
+ * `convex/admin/seed/registry.ts` into `seedRegistryEntries.generated.ts` (`npm run codegen`)
+ * for CLI help and ordering only — behavior is enforced server-side (STD-101).
+ */
+import * as clack from '@clack/prompts';
+import { adminCall } from '../../lib/client.js';
+import { resolveAdminConfig } from '../../lib/adminConfig.js';
+import { CLIError, ErrorCode } from '../../lib/errors.js';
+import { ask, confirm, intro, isInteractive, log, multiselect, note, outro } from '../../lib/prompts.js';
+import { readSession } from '../../lib/session.js';
+import { isJsonMode } from '../../lib/runner.js';
+import { MANIFEST_SEED_COMMAND_ENTRIES, REGISTRY_SEED_COMMAND_ENTRIES } from './seedRegistryEntries.generated.js';
+import { confirmRiskNoteTitle, requiresAdminDestructiveConfirmation, seedAllConfirmMessage, seedMultiselectConfirmMessage, seedRunConfirmMessage, } from '../../lib/deployment.js';
+import { withSpinner } from '../../lib/spinner.js';
+import { adminBanner, bold, confirmProdAction, cyan, dim, green, heading, hint, icons, red, yellow, } from '../../lib/style.js';
+/**
+ * Every seed operation `pb admin seed` can run, in `seed all` dependency order: the manifest
+ * seeds, then the registry ops that can run from the CLI (a transactional prestep cannot).
+ */
+export const SEED_COMMAND_ENTRIES = [
+    ...MANIFEST_SEED_COMMAND_ENTRIES,
+    ...REGISTRY_SEED_COMMAND_ENTRIES.filter((e) => e.runnable).map(({ name, description, requiresWorkspaceId, dryRunSupported }) => ({ name, description, requiresWorkspaceId, dryRunSupported })),
+];
+const SEED_BY_NAME = new Map(SEED_COMMAND_ENTRIES.map((e) => [e.name, e]));
+/** Manifest order for `pb admin seed all`. */
+export const SEED_MANIFEST_ORDER = SEED_COMMAND_ENTRIES.map((e) => e.name);
+function shortLabel(manifestName) {
+    return manifestName.startsWith('seed:') ? manifestName.slice('seed:'.length) : manifestName;
+}
+/**
+ * Convert a manifest name (which may be a bare slug for registry-generated entries)
+ * to the backend command name expected by the admin dispatch layer.
+ *
+ * Manifest entries are already stored as `seed:<slug>` — returned as-is.
+ * Registry-generated entries are stored as bare slugs (e.g. `seed-default-team`);
+ * the backend COMMAND_MAP expects `seed:<slug>`, so we add the prefix here.
+ */
+function toBackendCommand(manifestName) {
+    return manifestName.startsWith('seed:') ? manifestName : `seed:${manifestName}`;
+}
+/**
+ * Accept short-form or long-form seed op names; return the canonical backend command name.
+ *
+ * Manifest entries are stored as `seed:<slug>` (e.g. `seed:knowledge`).
+ * Registry-generated entries (WP-433 S1b) are stored as bare slugs (e.g.
+ * `seed-default-team`) to avoid the double-prefix `seed:seed-*` trap that
+ * arose when slugs like `seed-default-team` were naively stored as
+ * `seed:seed-default-team`.
+ *
+ * Both forms always return the backend command name (`seed:<bare-slug>`):
+ *   - `'default-team'` or `'seed-default-team'` → `'seed:seed-default-team'`
+ *     would be wrong; instead the bare slug stored in the map IS `seed-default-team`
+ *     and the backend command is `seed:seed-default-team`.
+ *
+ * Resolution order:
+ *   1. Try `seed:<t>` — covers manifest entries (`seed:knowledge`) and any input
+ *      that normalises to a key already stored with the `seed:` prefix.
+ *   2. Try bare `<t>` (stripping a leading `seed:` from the input if present) —
+ *      covers registry entries stored without the prefix.
+ *      When found via bare slug, return `seed:<bare>` so the caller always gets a
+ *      backend-compatible command name.
+ */
+export function normalizeSeedCommandName(input) {
+    const t = input.trim();
+    if (!t) {
+        throw new CLIError('Seed operation name is required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+        });
+    }
+    // 1. Try the `seed:`-prefixed form (covers all manifest entries).
+    const withPrefix = t.startsWith('seed:') ? t : `seed:${t}`;
+    if (SEED_BY_NAME.has(withPrefix))
+        return withPrefix;
+    // 2. Try the bare-slug form (covers registry-generated entries stored without `seed:`).
+    //    Strip one leading `seed:` if the input has it, so both
+    //    `seed-default-team` and `seed:seed-default-team` resolve to `seed-default-team`.
+    const bare = t.startsWith('seed:') ? t.slice('seed:'.length) : t;
+    if (SEED_BY_NAME.has(bare)) {
+        // Return the backend-compatible `seed:` form so callers can pass this directly
+        // to adminCall and the backend COMMAND_MAP will find it.
+        return `seed:${bare}`;
+    }
+    const known = SEED_MANIFEST_ORDER.map((n) => shortLabel(n)).join(', ');
+    throw new CLIError(`Unknown seed operation "${input}". Known short names: ${known}`, {
+        code: ErrorCode.VALIDATION_FAILED,
+        category: 'validation',
+    });
+}
+// WP-379 S5a's backfill-starter arg builder (buildBackfillStarterArgs) deleted at WP-776
+// S0 along with the seed:backfill-starter command it validated for.
+function resolveWorkspaceId(explicit) {
+    if (explicit)
+        return explicit;
+    return readSession()?.workspaceId;
+}
+function requireWorkspaceId(explicit) {
+    const id = resolveWorkspaceId(explicit);
+    if (!id) {
+        throw new CLIError('Workspace id required — pass --workspace-id or run `pb session start` in this project.', { code: ErrorCode.VALIDATION_FAILED, category: 'validation' });
+    }
+    return id;
+}
+export function buildSeedArgs(manifestName, opts) {
+    // Try exact match first (manifest entries stored as `seed:<slug>`).
+    // Fall back to bare-slug lookup (registry-generated entries stored without `seed:` prefix).
+    const bare = manifestName.startsWith('seed:') ? manifestName.slice('seed:'.length) : manifestName;
+    const def = SEED_BY_NAME.get(manifestName) ?? SEED_BY_NAME.get(bare);
+    if (!def) {
+        throw new CLIError(`Unknown seed command: ${manifestName}`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+        });
+    }
+    const args = {};
+    if (def.requiresWorkspaceId)
+        args.workspaceId = requireWorkspaceId(opts.workspaceId);
+    if (def.dryRunSupported && opts.dryRun)
+        args.dryRun = true;
+    return args;
+}
+function printSeedList() {
+    const rows = SEED_COMMAND_ENTRIES.map((e) => ({
+        name: shortLabel(e.name),
+        description: e.description,
+        workspace: e.requiresWorkspaceId ? 'yes' : 'no',
+        dryRun: e.dryRunSupported ? 'yes' : '—',
+    }));
+    if (isJsonMode()) {
+        process.stdout.write(JSON.stringify({ commands: rows }, null, 2) + '\n');
+        return;
+    }
+    try {
+        adminBanner(resolveAdminConfig().siteUrl);
+    }
+    catch { /* not configured */ }
+    const wName = Math.max(8, ...rows.map((r) => r.name.length));
+    const wWs = 9;
+    const wDr = 7;
+    process.stdout.write(`${bold('Name'.padEnd(wName))}  ${bold('Workspace'.padEnd(wWs))}  ${bold('Dry-run'.padEnd(wDr))}  ${bold('Description')}\n`);
+    process.stdout.write(dim('─'.repeat(wName + wWs + wDr + 40)) + '\n');
+    for (const r of rows) {
+        const dryRunStr = r.dryRun === 'yes' ? green(r.dryRun.padEnd(wDr)) : dim(r.dryRun.padEnd(wDr));
+        process.stdout.write(`${cyan(r.name.padEnd(wName))}  ${r.workspace.padEnd(wWs)}  ${dryRunStr}  ${dim(r.description)}\n`);
+    }
+    process.stdout.write('\n');
+    hint(`${SEED_COMMAND_ENTRIES.length} operations — behavior enforced server-side (commandManifest.ts + WP-433 S1b registry)`);
+    hint('pb admin seed run <name>     Run one operation');
+    hint('pb admin seed all            Run all in manifest order');
+}
+async function printSeedStatus(workspaceIdOpt) {
+    const readiness = await adminCall('inspect:readiness-config', {});
+    let collection = null;
+    const wsId = resolveWorkspaceId(workspaceIdOpt);
+    if (wsId) {
+        collection = await adminCall('inspect:collection', { workspaceId: wsId });
+    }
+    const statusNote = 'Per-seed run history is not tracked server-side yet — use workspace totals and readiness diagnose as signals.';
+    if (isJsonMode()) {
+        process.stdout.write(JSON.stringify({
+            note: statusNote,
+            readinessConfig: readiness,
+            workspaceCollections: collection,
+            workspaceId: wsId ?? null,
+        }, null, 2) + '\n');
+        return;
+    }
+    process.stdout.write(`${bold('Seed status')}\n\n`);
+    process.stdout.write(`  ${dim(statusNote)}\n\n`);
+    process.stdout.write(`${bold('Readiness config migration (inspect:readiness-config)')}\n`);
+    process.stdout.write(`  ${dim(JSON.stringify(readiness, null, 2).split('\n').join('\n  '))}\n\n`);
+    if (collection && typeof collection === 'object' && collection !== null && 'workspace' in collection) {
+        const c = collection;
+        process.stdout.write(`${bold('Workspace')}\n`);
+        process.stdout.write(`  ${c.workspace.name} (${c.workspace.slug})\n`);
+        process.stdout.write(`  Collections: ${c.totalCollections} — Entries: ${c.totalEntries}\n\n`);
+    }
+    else if (!wsId) {
+        process.stdout.write(`${dim('No workspace id — pass --workspace-id or use an active session for collection breakdown.')}\n\n`);
+    }
+}
+async function runSeedOperation(manifestName, opts) {
+    const args = buildSeedArgs(manifestName, opts);
+    return adminCall(manifestName, args);
+}
+/**
+ * WP-433 S1b D16 — render the system/fleet seed status report.
+ *
+ * Frame: this is a system-admin (operator) command. Output never says "your workspace" —
+ * always "the system" / "X workspaces" / a specific named workspace.
+ */
+function renderSeedStatusReport(data) {
+    if (!data || typeof data !== 'object') {
+        process.stdout.write(`${dim('No data returned.')}\n`);
+        return;
+    }
+    const report = data;
+    const mode = report.mode;
+    if (mode === 'fleet') {
+        const summary = report.summary;
+        const failures = report.failures ?? [];
+        process.stdout.write(`${bold(`System: ${summary.total} workspace${summary.total === 1 ? '' : 's'} total`)}\n\n`);
+        process.stdout.write(`  ${green(icons.pass)} ${summary.healthy} healthy (all assertions passed)\n`);
+        if (summary.failed > 0) {
+            process.stdout.write(`  ${red(icons.fail)} ${summary.failed} with failed assertions\n`);
+        }
+        if (summary.neverRun > 0) {
+            process.stdout.write(`  ${dim('!')} ${summary.neverRun} with never-run ops (likely created pre-registry)\n`);
+        }
+        if (failures.length === 0) {
+            process.stdout.write(`\n${dim('No failures or never-run ops to report.')}\n`);
+            return;
+        }
+        const failedRows = failures.filter((f) => f.status === 'failed' || f.status === 'stale'); // 'stale' rides with 'failed'
+        const neverRunRows = failures.filter((f) => f.status === 'never-run');
+        const repairOpLine = (op, wsId) => `pb admin seed run ${op} --workspace-id ${wsId}`;
+        if (failedRows.length > 0) {
+            process.stdout.write(`\n${red('Failures:')}\n`);
+            for (const f of failedRows) {
+                process.stdout.write(`  - ${cyan(`workspace-${f.workspaceId}`)} (${bold(f.workspaceName)}) — ${f.slug}: ${f.detail}\n`);
+                if (f.recommendedRepairOp) {
+                    process.stdout.write(`    repair: ${dim(repairOpLine(f.recommendedRepairOp, f.workspaceId))}\n`);
+                }
+            }
+        }
+        if (neverRunRows.length > 0) {
+            process.stdout.write(`\n${dim('Never-run ops:')}\n`);
+            for (const f of neverRunRows) {
+                process.stdout.write(`  - ${cyan(`workspace-${f.workspaceId}`)} (${bold(f.workspaceName)}) — ${f.slug} never invoked\n`);
+                if (f.recommendedRepairOp) {
+                    process.stdout.write(`    repair: ${dim(repairOpLine(f.recommendedRepairOp, f.workspaceId))}\n`);
+                }
+            }
+        }
+        return;
+    }
+    if (mode === 'drilldown') {
+        const workspaceName = report.workspaceName;
+        const workspaceId = report.workspaceId;
+        const rows = report.rows ?? [];
+        if (rows.length === 0) {
+            process.stdout.write(`${bold(`Workspace: ${workspaceName}`)} ${dim(`(${workspaceId})`)}\n\n`);
+            process.stdout.write(`${dim('No registered ops.')}\n`);
+            return;
+        }
+        // TEN-2021: group by level so non-tech operators don't conflate
+        // platform-substrate ops with on-demand repair tools.
+        const levelBySlug = new Map(REGISTRY_SEED_COMMAND_ENTRIES.map((e) => [e.name, e.level]));
+        const platformRows = rows.filter((r) => levelBySlug.get(r.slug) === 'platform');
+        const workspaceRows = rows.filter((r) => levelBySlug.get(r.slug) === 'workspace');
+        const repairRows = rows.filter((r) => levelBySlug.get(r.slug) === 'repair');
+        // TEN-2019 known soft-failure: platform-source workspace has no curated
+        // methods/skills entries to project. Not a workspace bug — render as ⚠.
+        const PLATFORM_SOURCE_EMPTY_MARKER = 'neither methods nor skills collection found';
+        const isPlatformSourceEmptyRow = (r) => r.status === 'failed' && r.detail.includes(PLATFORM_SOURCE_EMPTY_MARKER);
+        // ── Header: workspace identity + at-a-glance health summary ────────────────
+        const isSeedRow = (r) => {
+            const lvl = levelBySlug.get(r.slug);
+            return lvl === 'platform' || lvl === 'workspace';
+        };
+        const seedRows = rows.filter(isSeedRow);
+        const passCount = seedRows.filter((r) => r.status === 'passed').length;
+        const warnCount = seedRows.filter(isPlatformSourceEmptyRow).length;
+        const failCount = seedRows.filter((r) => r.status === 'failed' && !isPlatformSourceEmptyRow(r)).length;
+        process.stdout.write(`${bold('Workspace:')}  ${workspaceName}\n`);
+        process.stdout.write(`${bold('ID:')}         ${dim(workspaceId)}\n`);
+        process.stdout.write(`${bold('Health:')}     ${green(`${passCount} ${icons.pass}`)}   ${yellow(`${warnCount} ⚠`)}   ${red(`${failCount} ${icons.fail}`)}\n\n`);
+        // ── Row renderer: only show detail on ⚠ / ✗ via indented sub-line ──────────
+        const renderRow = (r) => {
+            const isWarn = isPlatformSourceEmptyRow(r);
+            const icon = isWarn ? yellow('⚠')
+                : r.status === 'passed' ? green(icons.pass)
+                    : (r.status === 'failed' || r.status === 'stale') ? red(icons.fail) // 'stale' (round 24): same action, different cause
+                        : dim('-');
+            process.stdout.write(`  ${icon}  ${cyan(r.slug)}\n`);
+            // Detail sub-line only for genuine signals (⚠ or ✗). ✓ and "-" are noise.
+            if (isWarn) {
+                process.stdout.write(`     ${dim('└─ Platform-curated content not yet published (TEN-2019).')}\n`);
+            }
+            else if (r.status === 'stale') {
+                process.stdout.write(`     ${dim(`└─ ${r.detail}`)}\n`);
+            }
+            else if (r.status === 'failed') {
+                const cleaned = r.detail.replace(new RegExp(`^${r.slug} assertion failed:\\s*`), '');
+                process.stdout.write(`     ${dim(`└─ ${cleaned}`)}\n`);
+            }
+        };
+        if (platformRows.length > 0) {
+            process.stdout.write(`${bold('Seeded on workspace creation')}\n`);
+            process.stdout.write(`${dim('Runs automatically when a new workspace is created.')}\n\n`);
+            for (const r of platformRows)
+                renderRow(r);
+            process.stdout.write('\n');
+        }
+        if (workspaceRows.length > 0) {
+            process.stdout.write(`${bold('Owner-level defaults')}\n`);
+            process.stdout.write(`${dim('Per-workspace state seeded for the owner.')}\n\n`);
+            for (const r of workspaceRows)
+                renderRow(r);
+            process.stdout.write('\n');
+        }
+        if (repairRows.length > 0) {
+            process.stdout.write(`${bold('Repair commands (manual)')}\n`);
+            process.stdout.write(`${dim('Used to fix older or drifted workspaces. Usually nothing to do.')}\n\n`);
+            for (const r of repairRows)
+                renderRow(r);
+        }
+        return;
+    }
+    if (mode === 'op-filter') {
+        const slug = report.slug;
+        const rows = report.rows ?? [];
+        process.stdout.write(`${bold(`Op: ${slug}`)} ${dim(`(${rows.length} workspace${rows.length === 1 ? '' : 's'})`)}\n\n`);
+        if (rows.length === 0) {
+            process.stdout.write(`${dim('Op not found in registry, or no workspaces exist.')}\n`);
+            return;
+        }
+        for (const r of rows) {
+            const icon = r.status === 'passed' ? green(icons.pass)
+                : (r.status === 'failed' || r.status === 'stale') ? red(icons.fail)
+                    : dim('-');
+            const detail = r.detail ? `  ${dim(r.detail)}` : '';
+            process.stdout.write(`  ${icon}  ${cyan(`workspace-${r.workspaceId}`)} (${bold(r.workspaceName)})${detail}\n`);
+        }
+        return;
+    }
+    process.stdout.write(`${dim('Unknown report mode.')}\n`);
+}
+/** Attach seed subcommands to the `seed` Commander node. */
+export function attachSeedCommands(seed) {
+    // Default action when `pb admin seed` is invoked with no subcommand.
+    seed.action(async () => {
+        if (isJsonMode()) {
+            process.stdout.write(JSON.stringify({
+                operations: SEED_COMMAND_ENTRIES.map((e) => ({
+                    name: shortLabel(e.name),
+                    requiresWorkspaceId: e.requiresWorkspaceId,
+                    dryRunSupported: e.dryRunSupported,
+                    description: e.description,
+                })),
+            }, null, 2) + '\n');
+            return;
+        }
+        let siteUrl = '';
+        try {
+            siteUrl = resolveAdminConfig().siteUrl;
+        }
+        catch { /* not configured */ }
+        if (siteUrl)
+            adminBanner(siteUrl);
+        if (isInteractive()) {
+            intro('Seed Operations');
+            const menuEntries = SEED_COMMAND_ENTRIES;
+            const selected = await multiselect({
+                message: 'Select operations to run (space to toggle, enter to confirm):',
+                options: menuEntries.map((e) => ({
+                    value: e.name,
+                    label: shortLabel(e.name),
+                    hint: [
+                        e.requiresWorkspaceId ? 'needs workspace' : 'platform-wide',
+                        e.dryRunSupported ? 'dry-run ✓' : '',
+                    ].filter(Boolean).join(' · '),
+                })),
+                required: false,
+            });
+            if (!Array.isArray(selected) || selected.length === 0) {
+                outro('Nothing selected — use pb admin seed run <name> for individual operations');
+                return;
+            }
+            // Resolve workspace-id upfront for any selected ops that need it
+            const needsWs = selected.some((name) => SEED_BY_NAME.get(name)?.requiresWorkspaceId);
+            let workspaceId;
+            if (needsWs) {
+                const sessionWsId = readSession()?.workspaceId;
+                if (sessionWsId) {
+                    workspaceId = sessionWsId;
+                    log.info(`Using session workspace: ${dim(sessionWsId)}`);
+                }
+                else {
+                    workspaceId = await ask({
+                        message: 'Workspace ID (required for selected operations):',
+                        validate: (v) => v.trim() ? undefined : 'Workspace ID is required',
+                    });
+                }
+            }
+            const needsConfirm = requiresAdminDestructiveConfirmation(siteUrl);
+            if (needsConfirm) {
+                const ok = await confirm({
+                    message: seedMultiselectConfirmMessage(siteUrl, selected.length),
+                    initialValue: false,
+                });
+                if (!ok) {
+                    outro('Cancelled');
+                    return;
+                }
+            }
+            // Run selected operations in order, stop on first failure (same policy as seed all)
+            const results = [];
+            for (const name of selected) {
+                try {
+                    await withSpinner(`Running ${shortLabel(name)}`, async () => {
+                        const args = buildSeedArgs(name, { workspaceId });
+                        await adminCall(toBackendCommand(name), args);
+                    });
+                    results.push({ name, ok: true });
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    results.push({ name, ok: false, error: msg });
+                    break;
+                }
+            }
+            const passed = results.filter((r) => r.ok).length;
+            const failed = results.filter((r) => !r.ok).length;
+            const summaryLines = results
+                .map((r) => r.ok ? `✓ ${shortLabel(r.name)}` : `✗ ${shortLabel(r.name)} — ${r.error}`)
+                .join('\n');
+            note(summaryLines, `${passed}/${selected.length} complete`);
+            if (failed > 0) {
+                process.exitCode = 1;
+                outro('Some operations failed — see above');
+            }
+            else {
+                outro(`${passed} operation(s) complete`);
+            }
+            return;
+        }
+        // Non-interactive (non-JSON) fallback — existing static preview
+        process.stdout.write(`${heading('Seed operations')}  ${dim(`(${SEED_COMMAND_ENTRIES.length})`)}\n\n`);
+        // Show first 6 entries as a preview
+        const preview = SEED_COMMAND_ENTRIES.slice(0, 6);
+        const wName = Math.max(...preview.map((e) => shortLabel(e.name).length));
+        for (const e of preview) {
+            const label = shortLabel(e.name);
+            const flags = e.dryRunSupported ? dim('  dry-run ✓') : '';
+            process.stdout.write(`  ${cyan(label.padEnd(wName))}  ${dim(e.description)}${flags}\n`);
+        }
+        if (SEED_COMMAND_ENTRIES.length > 6) {
+            process.stdout.write(`  ${dim(`... ${SEED_COMMAND_ENTRIES.length - 6} more — run pb admin seed list`)}\n`);
+        }
+        process.stdout.write('\n');
+        process.stdout.write(`  ${cyan('pb admin seed list')}             ${dim('Full list with workspace + dry-run flags')}\n`);
+        process.stdout.write(`  ${cyan('pb admin seed run <name>')}       ${dim('Run one operation')}\n`);
+        process.stdout.write(`  ${cyan('pb admin seed all')}              ${dim('Run all in manifest order')}\n`);
+        process.stdout.write(`  ${cyan('pb admin seed status')}           ${dim('Fleet-wide seed health (system admin)')}\n`);
+        process.stdout.write('\n');
+    });
+    seed
+        .command('list')
+        .description('List registered seed operations (names match server manifest)')
+        .action(() => {
+        printSeedList();
+    });
+    // WP-433 S1b D16 — fleet-wide seed status (system-admin command).
+    // Default behaviour: scan ALL workspaces in the deployment and report summary + failures.
+    // `--workspace-id <id>` drilldown flag triages a single workspace.
+    // `--op <slug>` fleet view filtered to one op.
+    // `--failed-only` fleet view skipping healthy workspaces.
+    // `--legacy-readiness` falls back to the pre-S1b workspace-readiness signals view.
+    seed
+        .command('status')
+        .description('Fleet-wide seed health (system admin). Default scans ALL workspaces. ' +
+        'Use --workspace-id to drill down, --op to filter one op, --failed-only for failures only.')
+        .option('--workspace-id <id>', 'Drill down to one workspace (operator triage)')
+        .option('--op <slug>', 'Filter fleet view to one op slug')
+        .option('--failed-only', 'Skip healthy workspaces; show failures only', false)
+        .option('--legacy-readiness', 'Use the older workspace readiness view', false)
+        .action(async (options) => {
+        if (options.legacyReadiness) {
+            if (!isJsonMode()) {
+                try {
+                    adminBanner(resolveAdminConfig().siteUrl);
+                }
+                catch { /* not configured */ }
+                intro('Seed: status (legacy readiness)');
+            }
+            await printSeedStatus(options.workspaceId);
+            if (!isJsonMode()) {
+                outro('Read-only status check complete');
+            }
+            return;
+        }
+        if (!isJsonMode()) {
+            try {
+                adminBanner(resolveAdminConfig().siteUrl);
+            }
+            catch { /* not configured */ }
+            intro('Seed status — system / fleet view');
+        }
+        const callArgs = {};
+        if (options.workspaceId)
+            callArgs.workspaceId = options.workspaceId;
+        if (options.op)
+            callArgs.opSlug = options.op;
+        if (options.failedOnly)
+            callArgs.failedOnly = true;
+        const data = await withSpinner('Scanning the system', () => adminCall('admin:seed-status', callArgs));
+        if (isJsonMode()) {
+            process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+            return;
+        }
+        renderSeedStatusReport(data);
+        outro('Done');
+    });
+    seed
+        .command('run')
+        .description('Run one seed operation by short or full manifest name')
+        .argument('<name>', 'e.g. knowledge or seed:knowledge')
+        .option('--dry-run', 'Pass dryRun when supported', false)
+        .option('--workspace-id <id>', 'Workspace id for workspace-scoped seeds')
+        .option('--confirm', 'Non-interactive prod acknowledgment for dangerous ops', false)
+        .action(async (name, options) => {
+        const { siteUrl } = resolveAdminConfig();
+        const manifestName = normalizeSeedCommandName(name);
+        const needsConfirm = requiresAdminDestructiveConfirmation(siteUrl);
+        // Remote / prod deployments require confirmation — not local or known dev-cloud.
+        if (needsConfirm) {
+            const ok = await confirmProdAction({
+                confirm: options.confirm,
+                isProduction: true,
+                message: seedRunConfirmMessage(siteUrl, manifestName),
+                noteTitle: confirmRiskNoteTitle(siteUrl),
+            });
+            if (!ok) {
+                process.stderr.write('Cancelled.\n');
+                process.exitCode = 1;
+                return;
+            }
+        }
+        if (!isJsonMode()) {
+            adminBanner(siteUrl);
+            intro(`seed:${shortLabel(manifestName)}`);
+        }
+        const data = await withSpinner(`Running ${manifestName}`, () => runSeedOperation(manifestName, {
+            workspaceId: options.workspaceId,
+            dryRun: options.dryRun,
+        }));
+        if (isJsonMode()) {
+            process.stdout.write(JSON.stringify({ command: manifestName, data }, null, 2) + '\n');
+            return;
+        }
+        const summaryLines = data && typeof data === 'object'
+            ? Object.entries(data)
+                .map(([k, v]) => `${k}: ${typeof v === 'object' ? JSON.stringify(v) : String(v)}`)
+                .slice(0, 8)
+                .join('\n')
+            : String(data ?? 'No response data');
+        note(summaryLines || 'No response data', manifestName);
+        outro('Complete');
+    });
+    // WP-379 S5a's `show-starter` / `backfill-starter` / `migrate-starter-fields` subcommands
+    // deleted at WP-776 S0 along with their Convex-side backing (convex/admin/seedStarterAdmin.ts).
+    seed
+        .command('all')
+        .description('Run all seed operations in manifest order')
+        .option('--workspace-id <id>', 'Workspace id for workspace-scoped seeds')
+        .option('--dry-run', 'Pass dryRun to operations that support it', false)
+        .option('--confirm', 'Required in production (non-interactive)', false)
+        .action(async (options) => {
+        const { siteUrl } = resolveAdminConfig();
+        const needsConfirm = requiresAdminDestructiveConfirmation(siteUrl);
+        if (needsConfirm) {
+            const ok = await confirmProdAction({
+                confirm: options.confirm,
+                isProduction: true,
+                message: seedAllConfirmMessage(siteUrl),
+                noteTitle: confirmRiskNoteTitle(siteUrl),
+            });
+            if (!ok) {
+                process.stderr.write('Cancelled.\n');
+                process.exitCode = 1;
+                return;
+            }
+        }
+        const results = [];
+        // ── JSON mode: silent execution, structured output ────────────────────
+        if (isJsonMode()) {
+            for (const cmd of SEED_MANIFEST_ORDER) {
+                try {
+                    const args = buildSeedArgs(cmd, { workspaceId: options.workspaceId, dryRun: options.dryRun });
+                    await adminCall(toBackendCommand(cmd), args);
+                    results.push({ command: cmd, ok: true });
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    results.push({ command: cmd, ok: false, error: msg });
+                    break;
+                }
+            }
+            if (results.some((r) => !r.ok))
+                process.exitCode = 1;
+            process.stdout.write(JSON.stringify({ results }, null, 2) + '\n');
+            return;
+        }
+        // ── Human mode: spinner per operation + finale summary panel ─────────
+        adminBanner(siteUrl);
+        intro('Seed All Operations');
+        const total = SEED_MANIFEST_ORDER.length;
+        let current = 0;
+        const startMs = Date.now();
+        const s = clack.spinner();
+        for (const cmd of SEED_MANIFEST_ORDER) {
+            current++;
+            const label = shortLabel(cmd);
+            s.start(`${current}/${total}  ${label}`);
+            try {
+                const args = buildSeedArgs(cmd, { workspaceId: options.workspaceId, dryRun: options.dryRun });
+                await adminCall(toBackendCommand(cmd), args);
+                s.stop(`${green(icons.pass)} ${label}`);
+                results.push({ command: cmd, ok: true });
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                s.stop(`${red(icons.fail)} ${label} — ${msg}`);
+                results.push({ command: cmd, ok: false, error: msg });
+                break;
+            }
+        }
+        const elapsed = ((Date.now() - startMs) / 1000).toFixed(1);
+        const passed = results.filter((r) => r.ok && !r.skipped).length;
+        const skippedCount = results.filter((r) => r.skipped).length;
+        const failed = results.filter((r) => !r.ok).length;
+        const summaryLines = [
+            `${green(icons.pass)} ${passed} succeeded`,
+            skippedCount > 0 ? `${dim(icons.dot)} ${skippedCount} skipped` : null,
+            failed > 0 ? `${red(icons.fail)} ${failed} failed` : null,
+            `${dim(`elapsed: ${elapsed}s`)}`,
+        ].filter(Boolean).join('\n');
+        note(summaryLines, `${passed + skippedCount}/${total} complete`);
+        if (failed > 0) {
+            process.exitCode = 1;
+            outro('Some operations failed — fix errors and re-run affected seeds individually');
+        }
+        else {
+            outro(`All ${passed} operations complete in ${elapsed}s`);
+        }
+    });
+}
+//# sourceMappingURL=seed.js.map