@productbrain/cli 0.1.0-beta.47 → 0.1.0-beta.4721

package/dist/commands/admin/run.test.js

@@ -0,0 +1,168 @@
+/**
+ * Tests for `pb admin run <name> [jsonArgs]` — the generic admin-manifest dispatcher
+ * (WP-592 S3 review fix).
+ *
+ * Covers:
+ *   - dispatches the given command name with parsed JSON args via adminCall
+ *   - defaults to {} when jsonArgs is omitted
+ *   - rejects invalid JSON before ever calling adminCall
+ *   - rejects a JSON array / scalar (must be an object) before ever calling adminCall
+ *   - prints the FULL result as JSON, untruncated
+ *   - an unknown-command error from adminCall (mirroring the server's
+ *     "Unknown admin command" refusal) propagates rather than being swallowed
+ *   - prints the deployment banner before dispatching (WP-592 S3 second-pass review fix)
+ *   - a deployment tier that requires confirmation gates the dispatch on confirmProdAction
+ *   - a tier that does not require confirmation (e.g. local) never consults confirmProdAction
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { Command } from 'commander';
+// Mock adminCall — the single server dispatch surface.
+vi.mock('../../lib/client.js', () => ({
+    adminCall: vi.fn(async () => ({})),
+}));
+vi.mock('../../lib/adminConfig.js', () => ({
+    resolveAdminConfig: vi.fn(() => ({ siteUrl: 'http://127.0.0.1:3210', source: 'env', profileName: null })),
+}));
+// Mock the banner + confirm primitives directly rather than relying on TTY/quiet-mode detection
+// in the test process — this asserts run.ts actually CALLS them with the right arguments, which
+// is the behavior the WP-592 S3 second-pass review finding is about (MAJOR 1).
+vi.mock('../../lib/style.js', () => ({
+    adminBanner: vi.fn(),
+    confirmProdAction: vi.fn(async () => true),
+}));
+vi.mock('../../lib/deployment.js', () => ({
+    requiresAdminDestructiveConfirmation: vi.fn(() => false),
+    confirmRiskNoteTitle: vi.fn(() => '⚠  Confirm'),
+}));
+import { attachRunCommand, parseRunArgs } from './run.js';
+import { adminCall } from '../../lib/client.js';
+import { adminBanner, confirmProdAction } from '../../lib/style.js';
+import { requiresAdminDestructiveConfirmation } from '../../lib/deployment.js';
+/** Build a Commander tree with `run` attached and parse argv. */
+async function runAdminRun(argv) {
+    const admin = new Command();
+    attachRunCommand(admin);
+    // exitOverride so a parse error throws instead of calling process.exit.
+    admin.exitOverride();
+    await admin.parseAsync(['node', 'pb', 'run', ...argv]);
+}
+let stdoutSpy;
+beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(adminCall).mockResolvedValue({ ok: true });
+    stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+});
+afterEach(() => {
+    stdoutSpy.mockRestore();
+    process.exitCode = 0;
+});
+describe('parseRunArgs', () => {
+    it('returns {} when jsonArgs is omitted', () => {
+        expect(parseRunArgs(undefined)).toEqual({});
+    });
+    it('returns {} for an empty/whitespace string', () => {
+        expect(parseRunArgs('   ')).toEqual({});
+    });
+    it('parses a valid JSON object', () => {
+        expect(parseRunArgs('{"workspaceId":"ws1","dryRun":false}')).toEqual({
+            workspaceId: 'ws1',
+            dryRun: false,
+        });
+    });
+    it('throws on invalid JSON', () => {
+        expect(() => parseRunArgs('{not json')).toThrow(/Invalid JSON args/);
+    });
+    it('throws on a JSON array (must be an object)', () => {
+        expect(() => parseRunArgs('[1,2,3]')).toThrow(/must be a JSON OBJECT/);
+    });
+    it('throws on a bare JSON scalar (must be an object)', () => {
+        expect(() => parseRunArgs('"just a string"')).toThrow(/must be a JSON OBJECT/);
+    });
+    it('throws on JSON null (must be an object)', () => {
+        expect(() => parseRunArgs('null')).toThrow(/must be a JSON OBJECT/);
+    });
+});
+describe('pb admin run <name> [jsonArgs]', () => {
+    it('dispatches the given command name with parsed JSON args', async () => {
+        await runAdminRun(['manage:archive-preset-residue', '{"workspaceId":"ws1"}']);
+        expect(adminCall).toHaveBeenCalledTimes(1);
+        expect(adminCall).toHaveBeenCalledWith('manage:archive-preset-residue', { workspaceId: 'ws1' });
+    });
+    it('defaults args to {} when jsonArgs is omitted', async () => {
+        await runAdminRun(['inspect:preset-residue-census']);
+        expect(adminCall).toHaveBeenCalledWith('inspect:preset-residue-census', {});
+    });
+    it('rejects invalid JSON before ever calling adminCall', async () => {
+        await expect(runAdminRun(['manage:archive-preset-residue', '{bad'])).rejects.toThrow(/Invalid JSON args/);
+        expect(adminCall).not.toHaveBeenCalled();
+    });
+    it('rejects a non-object JSON value before ever calling adminCall', async () => {
+        await expect(runAdminRun(['manage:archive-preset-residue', '[1,2]'])).rejects.toThrow(/must be a JSON OBJECT/);
+        expect(adminCall).not.toHaveBeenCalled();
+    });
+    it('prints the full result as JSON, untruncated', async () => {
+        const bigResult = {
+            outcome: 'dry_run',
+            candidates: Array.from({ length: 50 }, (_, i) => ({ entryId: `E-${i}`, classification: 'orphaned' })),
+        };
+        vi.mocked(adminCall).mockResolvedValueOnce(bigResult);
+        await runAdminRun(['manage:archive-preset-residue', '{"workspaceId":"ws1"}']);
+        const written = stdoutSpy.mock.calls.map((c) => String(c[0])).join('');
+        const parsed = JSON.parse(written);
+        expect(parsed.command).toBe('manage:archive-preset-residue');
+        expect(parsed.data.candidates).toHaveLength(50);
+    });
+    it('propagates an unknown-command error from adminCall rather than swallowing it', async () => {
+        vi.mocked(adminCall).mockRejectedValueOnce(new Error('Unknown admin command: "typo:command". Available: seed:knowledge, manage:archive-preset-residue, ...'));
+        await expect(runAdminRun(['typo:command'])).rejects.toThrow(/Unknown admin command/);
+    });
+    it('prints the deployment banner before dispatching, naming the resolved credential source (WP-681)', async () => {
+        await runAdminRun(['manage:archive-preset-residue', '{"workspaceId":"ws1"}']);
+        expect(adminBanner).toHaveBeenCalledTimes(1);
+        expect(adminBanner).toHaveBeenCalledWith('http://127.0.0.1:3210', 'shell env vars');
+    });
+    it('WP-681: names a repo-pinned local profile distinctly from the global active profile', async () => {
+        const adminConfig = await import('../../lib/adminConfig.js');
+        vi.mocked(adminConfig.resolveAdminConfig).mockReturnValueOnce({
+            siteUrl: 'https://trustworthy-kangaroo-277.convex.site',
+            source: 'local-profile',
+            profileName: 'product-brain',
+        });
+        await runAdminRun(['manage:archive-preset-residue', '{"workspaceId":"ws1"}']);
+        expect(adminBanner).toHaveBeenCalledWith('https://trustworthy-kangaroo-277.convex.site', 'product-brain (repo-pinned)');
+    });
+    it('WP-681: the confirm-gate message on a production tier names the resolved profile too', async () => {
+        vi.mocked(requiresAdminDestructiveConfirmation).mockReturnValueOnce(true);
+        vi.mocked(confirmProdAction).mockResolvedValueOnce(true);
+        const adminConfig = await import('../../lib/adminConfig.js');
+        vi.mocked(adminConfig.resolveAdminConfig).mockReturnValueOnce({
+            siteUrl: 'https://gateway.productbrain.io',
+            source: 'global-profile',
+            profileName: 'randy-s-pkm',
+        });
+        await runAdminRun(['manage:archive-preset-residue', '--confirm', '{"workspaceId":"ws1"}']);
+        expect(confirmProdAction).toHaveBeenCalledWith(expect.objectContaining({ message: expect.stringContaining('randy-s-pkm (global)') }));
+    });
+    it('does not consult confirmProdAction on a tier that does not require confirmation', async () => {
+        vi.mocked(requiresAdminDestructiveConfirmation).mockReturnValueOnce(false);
+        await runAdminRun(['manage:archive-preset-residue', '{"workspaceId":"ws1"}']);
+        expect(confirmProdAction).not.toHaveBeenCalled();
+        expect(adminCall).toHaveBeenCalledTimes(1);
+    });
+    it('gates the dispatch on confirmProdAction when the deployment tier requires confirmation', async () => {
+        vi.mocked(requiresAdminDestructiveConfirmation).mockReturnValueOnce(true);
+        vi.mocked(confirmProdAction).mockResolvedValueOnce(true);
+        await runAdminRun(['manage:archive-preset-residue', '--confirm', '{"workspaceId":"ws1"}']);
+        expect(confirmProdAction).toHaveBeenCalledTimes(1);
+        expect(confirmProdAction).toHaveBeenCalledWith(expect.objectContaining({ confirm: true, isProduction: true }));
+        expect(adminCall).toHaveBeenCalledTimes(1);
+    });
+    it('refuses the dispatch when confirmProdAction resolves false on a tier that requires confirmation', async () => {
+        vi.mocked(requiresAdminDestructiveConfirmation).mockReturnValueOnce(true);
+        vi.mocked(confirmProdAction).mockResolvedValueOnce(false);
+        await runAdminRun(['manage:archive-preset-residue', '{"workspaceId":"ws1"}']);
+        expect(confirmProdAction).toHaveBeenCalledTimes(1);
+        expect(adminCall).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=run.test.js.map

package/dist/commands/admin/run.test.js.map

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

package/dist/commands/admin/seed.d.ts

@@ -3,6 +3,10 @@
  *
  * Seed metadata is duplicated from `convex/admin/commandManifest.ts` for CLI help
  * and ordering only — behavior is enforced server-side (STD-101).
+ *
+ * WP-433 S1b D13: the 4 substrate-repair migrations + backfill-default-team are
+ * generated from `convex/admin/seed/registry.ts` (single SSOT) into
+ * `seedRegistryEntries.generated.ts`. Run `npm run codegen` to refresh after registry edits.
  */
 import { Command } from 'commander';
 export type SeedCommandMeta = {
@@ -18,14 +22,53 @@ export type SeedCommandMeta = {
  * Order matches `ADMIN_COMMANDS` seed block in commandManifest.ts — dependency order for `seed all`.
  */
 export declare const SEED_COMMAND_ENTRIES: readonly SeedCommandMeta[];
-/** Manifest order for `pb admin seed all`. */
+/**
+ * Manifest order for `pb admin seed all`.
+ *
+ * Includes the static legacy seeds plus the registry-generated runnable entries so
+ * `seed all` exercises the full surface (D13 SSOT).
+ */
 export declare const SEED_MANIFEST_ORDER: readonly string[];
-/** Accept `knowledge` or `seed:knowledge`. */
+/**
+ * Accept short-form or long-form seed op names; return the canonical backend command name.
+ *
+ * Static entries (legacy) are stored as `seed:<slug>` (e.g. `seed:knowledge`).
+ * Registry-generated entries (WP-433 S1b) are stored as bare slugs (e.g.
+ * `seed-system-glossary`) to avoid the double-prefix `seed:seed-*` trap that
+ * arose when slugs like `seed-system-glossary` were naively stored as
+ * `seed:seed-system-glossary`.
+ *
+ * Both forms always return the backend command name (`seed:<bare-slug>`):
+ *   - `'system-glossary'` or `'seed-system-glossary'` → `'seed:seed-system-glossary'`
+ *     would be wrong; instead the bare slug stored in the map IS `seed-system-glossary`
+ *     and the backend command is `seed:seed-system-glossary`.
+ *
+ * Resolution order:
+ *   1. Try `seed:<t>` — covers legacy static 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 declare function normalizeSeedCommandName(input: string): string;
+/**
+ * Build args for seed:backfill-starter with CLI-side validation.
+ *
+ * Rules:
+ *   - confirm:true requires workspaceScope to be explicitly provided
+ *   - dryRun defaults to true when confirm is false
+ *
+ * Exported for testing.
+ */
+export declare function buildBackfillStarterArgs(opts: {
+    confirm?: boolean;
+    dryRun?: boolean;
+    workspaceScope?: string;
+}): Record<string, unknown>;
 export declare function buildSeedArgs(manifestName: string, opts: {
     workspaceId?: string;
     dryRun?: boolean;
-    presetId?: string;
 }): Record<string, unknown>;
 /** Attach seed subcommands to the `seed` Commander node. */
 export declare function attachSeedCommands(seed: Command): void;

package/dist/commands/admin/seed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/commands/admin/seed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,MAAM,MAAM,eAAe,GAAG;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,eAAe,EAqFjD,CAAC;AAIX,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAA4C,CAAC;AAM9F,8CAA8C;AAC9C,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB9D;AAkBD,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCzB;AA2FD,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAwUtD"}
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/commands/admin/seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC,MAAM,MAAM,eAAe,GAAG;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,eAAe,EA4GjD,CAAC;AAwBX;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAEhD,CAAC;AAkBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA4B9D;AAID;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuB1B;AAkBD,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB;AAuRD,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAkjBtD"}