@productbrain/cli 0.1.0-beta.71 → 0.1.0-beta.75

package/dist/__tests__/state.test.js

@@ -0,0 +1,97 @@
+/**
+ * Unit tests for resolveSetupState() and detectRenderTier().
+ * WP-325 S1 — foundation module, four stage paths + three render tier paths.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { resolveSetupState, detectRenderTier } from '../lib/state.js';
+vi.mock('../lib/config.js', () => ({
+    getConfigSafe: vi.fn(),
+}));
+vi.mock('../lib/workspace-probe.js', () => ({
+    probeWorkspace: vi.fn(),
+}));
+vi.mock('../lib/session.js', () => ({
+    readSession: vi.fn(),
+}));
+vi.mock('../lib/runner.js', () => ({
+    isJsonMode: vi.fn(),
+}));
+import { getConfigSafe } from '../lib/config.js';
+import { probeWorkspace } from '../lib/workspace-probe.js';
+import { readSession } from '../lib/session.js';
+import { isJsonMode } from '../lib/runner.js';
+const mockGetConfigSafe = vi.mocked(getConfigSafe);
+const mockProbeWorkspace = vi.mocked(probeWorkspace);
+const mockReadSession = vi.mocked(readSession);
+const mockIsJsonMode = vi.mocked(isJsonMode);
+beforeEach(() => {
+    vi.resetAllMocks();
+});
+// ---------------------------------------------------------------------------
+// resolveSetupState — four stage paths
+// ---------------------------------------------------------------------------
+describe('resolveSetupState', () => {
+    it('returns unconfigured when no API key is present', async () => {
+        mockGetConfigSafe.mockReturnValue({ ok: false, reason: 'no key' });
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('unconfigured');
+        expect(state.nextAction).toBe('pb login');
+        expect(state.missingSteps.length).toBeGreaterThan(0);
+        expect(mockProbeWorkspace).not.toHaveBeenCalled();
+    });
+    it('returns authenticated when key is present but workspace is unreachable', async () => {
+        mockGetConfigSafe.mockReturnValue({ ok: true, apiKey: 'key', siteUrl: 'https://test.convex.site' });
+        mockProbeWorkspace.mockResolvedValue(null);
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('authenticated');
+        expect(state.nextAction).toBe('pb connect');
+        expect(mockReadSession).not.toHaveBeenCalled();
+    });
+    it('returns workspace-bound when connected but no active session', async () => {
+        mockGetConfigSafe.mockReturnValue({ ok: true, apiKey: 'key', siteUrl: 'https://test.convex.site' });
+        mockProbeWorkspace.mockResolvedValue({ name: 'Test WS', entryCount: 42 });
+        mockReadSession.mockReturnValue(null);
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('workspace-bound');
+        expect(state.workspaceName).toBe('Test WS');
+        expect(state.entryCount).toBe(42);
+        expect(state.sessionActive).toBe(false);
+        expect(state.nextAction).toBe('pb session start');
+    });
+    it('returns active when key + workspace + session are all present', async () => {
+        mockGetConfigSafe.mockReturnValue({ ok: true, apiKey: 'key', siteUrl: 'https://test.convex.site' });
+        mockProbeWorkspace.mockResolvedValue({ name: 'Test WS', entryCount: 99 });
+        mockReadSession.mockReturnValue({ sessionId: 'sess-1', workspaceId: 'ws-1', workspaceName: 'Test WS', startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [] });
+        const state = await resolveSetupState();
+        expect(state.stage).toBe('active');
+        expect(state.sessionActive).toBe(true);
+        expect(state.workspaceName).toBe('Test WS');
+        expect(state.entryCount).toBe(99);
+        expect(state.missingSteps).toHaveLength(0);
+        expect(state.nextAction).toBe('pb orient -b');
+    });
+});
+// ---------------------------------------------------------------------------
+// detectRenderTier — three render paths
+// ---------------------------------------------------------------------------
+describe('detectRenderTier', () => {
+    const originalIsTTY = process.stdout.isTTY;
+    afterEach(() => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, writable: true });
+    });
+    it('returns json when isJsonMode() is true', () => {
+        mockIsJsonMode.mockReturnValue(true);
+        expect(detectRenderTier()).toBe('json');
+    });
+    it('returns plain when not a TTY and not json mode', () => {
+        mockIsJsonMode.mockReturnValue(false);
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        expect(detectRenderTier()).toBe('plain');
+    });
+    it('returns ink when TTY and not json mode', () => {
+        mockIsJsonMode.mockReturnValue(false);
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        expect(detectRenderTier()).toBe('ink');
+    });
+});
+//# sourceMappingURL=state.test.js.map

package/dist/__tests__/state.test.js.map

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

package/dist/__tests__/update.test.js

@@ -1,15 +1,15 @@
 /**
- * pb update — verify convexCallWithSession sequence and args.
+ * pb update — verify kernelCallWithSession sequence and args.
  * TEN-341 test contract: happy path, no session, empty entryId.
  */
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { runUpdate } from '../commands/update.js';
 import { CLIError } from '../lib/errors.js';
-const convexCallWithSessionMock = vi.fn();
-const convexCallMock = vi.fn();
+const kernelCallWithSessionMock = vi.fn();
+const kernelCallMock = vi.fn();
 vi.mock('../lib/client.js', () => ({
-    convexCallWithSession: (...args) => convexCallWithSessionMock(...args),
-    convexCall: (...args) => convexCallMock(...args),
+    kernelCallWithSession: (...args) => kernelCallWithSessionMock(...args),
+    kernelCall: (...args) => kernelCallMock(...args),
     // McpError exported so update.ts can import the type (not used at runtime in tests).
     McpError: class McpError extends Error {
         details;
@@ -50,7 +50,7 @@ describe('runUpdate', () => {
         vi.clearAllMocks();
         mockSession = { sessionId: 'sess-test' };
         // BET-192: updateEntry returns warnings + normalization breakdown (symmetric with createEntry)
-        convexCallWithSessionMock.mockResolvedValue({
+        kernelCallWithSessionMock.mockResolvedValue({
             id: 'j571abc123def456',
             warnings: [],
             normalization: { remapped: {}, rejected: [], accepted: [] },
@@ -58,7 +58,7 @@ describe('runUpdate', () => {
             validationWarnings: [],
         });
         // Post-update refresh: default to returning a minimal entry.
-        convexCallMock.mockResolvedValue({
+        kernelCallMock.mockResolvedValue({
             entryId: 'BET-151',
             name: 'Test Entry',
             status: 'active',
@@ -72,7 +72,7 @@ describe('runUpdate', () => {
             note: 'Updated description',
         });
         writeSpy.mockRestore();
-        expect(convexCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
             entryId: 'BET-151',
             changedBy: 'agent:sess-test',
             data: { description: 'new description' },
@@ -88,7 +88,7 @@ describe('runUpdate', () => {
             note: 'Resolved',
         });
         writeSpy.mockRestore();
-        expect(convexCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
             entryId: 'TEN-703',
             changedBy: 'agent:sess-test',
             name: 'New name',
@@ -103,7 +103,7 @@ describe('runUpdate', () => {
             workflowStatus: 'shipped',
         });
         writeSpy.mockRestore();
-        expect(convexCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
             entryId: 'BET-271',
             changedBy: 'agent:sess-test',
             workflowStatus: 'shipped',
@@ -116,7 +116,7 @@ describe('runUpdate', () => {
             field: ['rationale=a=b=c'],
         });
         writeSpy.mockRestore();
-        expect(convexCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.updateEntry', {
             entryId: 'DEC-264',
             changedBy: 'agent:sess-test',
             data: { rationale: 'a=b=c' },
@@ -126,21 +126,21 @@ describe('runUpdate', () => {
         mockSession = null;
         await expect(runUpdate({ entryId: 'BET-151', field: ['x=1'] })).rejects.toThrow(CLIError);
         await expect(runUpdate({ entryId: 'BET-151', field: ['x=1'] })).rejects.toThrow('No active session');
-        expect(convexCallWithSessionMock).not.toHaveBeenCalled();
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalled();
     });
     it('throws CLIError with empty entryId', async () => {
         await expect(runUpdate({ entryId: '  ', field: ['x=1'] })).rejects.toThrow(CLIError);
         await expect(runUpdate({ entryId: '  ', field: ['x=1'] })).rejects.toThrow('Entry ID is required');
-        expect(convexCallWithSessionMock).not.toHaveBeenCalled();
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalled();
     });
     it('throws CLIError when nothing to update', async () => {
         await expect(runUpdate({ entryId: 'BET-151' })).rejects.toThrow(CLIError);
         await expect(runUpdate({ entryId: 'BET-151' })).rejects.toThrow('Nothing to update');
-        expect(convexCallWithSessionMock).not.toHaveBeenCalled();
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalled();
     });
     // ── Structured validation error tests ────────────────────────────────────
     it('throws CLIError with structured select field error message', async () => {
-        convexCallWithSessionMock.mockRejectedValue(makeMcpError("Entry data validation failed: Field \"appetite\" must be one of: small, medium, large. Got: 'Small Batch'. Fix the values and try again.", 'VALIDATION_FAILED', [{
+        kernelCallWithSessionMock.mockRejectedValue(makeMcpError("Entry data validation failed: Field \"appetite\" must be one of: small, medium, large. Got: 'Small Batch'. Fix the values and try again.", 'VALIDATION_FAILED', [{
                 fieldKey: 'appetite',
                 fieldLabel: 'appetite',
                 invalidValue: 'Small Batch',
@@ -154,14 +154,14 @@ describe('runUpdate', () => {
         expect(err.message).toContain("Got: 'Small Batch'");
     });
     it('throws CLIError with plain error message when no structured details', async () => {
-        convexCallWithSessionMock.mockRejectedValue(makeMcpError('Entry not found.', 'NOT_FOUND'));
+        kernelCallWithSessionMock.mockRejectedValue(makeMcpError('Entry not found.', 'NOT_FOUND'));
         const err = await runUpdate({ entryId: 'BET-999', field: ['x=1'] }).catch((e) => e);
         expect(err).toBeInstanceOf(CLIError);
         expect(err.message).toContain('Entry not found.');
     });
     // ── Slice 3: post-update refresh ─────────────────────────────────────────
     it('calls chain.getEntry after successful update and includes entry in output', async () => {
-        convexCallMock.mockResolvedValue({
+        kernelCallMock.mockResolvedValue({
             entryId: 'BET-151',
             name: 'My Bet',
             status: 'active',
@@ -170,13 +170,13 @@ describe('runUpdate', () => {
         await runUpdate({ entryId: 'BET-151', field: ['description=new'] });
         const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
         writeSpy.mockRestore();
-        expect(convexCallMock).toHaveBeenCalledWith('chain.getEntry', { entryId: 'BET-151' });
+        expect(kernelCallMock).toHaveBeenCalledWith('chain.getEntry', { entryId: 'BET-151' });
         // Pretty output: receipt then entry block
         expect(output).toContain('Updated BET-151');
         expect(output).toContain('My Bet');
     });
     it('still shows update receipt when post-update getEntry fails (graceful degradation)', async () => {
-        convexCallMock.mockRejectedValue(new Error('network error'));
+        kernelCallMock.mockRejectedValue(new Error('network error'));
         const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
         await runUpdate({ entryId: 'BET-151', field: ['description=new'] });
         const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
@@ -187,7 +187,7 @@ describe('runUpdate', () => {
     });
     // ── BET-192 / FEAT-575: Normalization warning tests ──────────────────────
     it('throws CLIError when fields are rejected (BET-192, BET-271)', async () => {
-        convexCallWithSessionMock.mockResolvedValue({
+        kernelCallWithSessionMock.mockResolvedValue({
             id: 'j571abc123def456',
             warnings: ['Unknown field "foo" dropped. Available fields: description, doneWhen'],
             normalization: { remapped: {}, rejected: ['foo'], accepted: ['description'] },
@@ -207,7 +207,7 @@ describe('runUpdate', () => {
         writeSpy.mockRestore();
     });
     it('displays no warnings when all fields are valid (BET-192)', async () => {
-        convexCallWithSessionMock.mockResolvedValue({
+        kernelCallWithSessionMock.mockResolvedValue({
             id: 'j571abc123def456',
             warnings: [],
             normalization: { remapped: {}, rejected: [], accepted: ['description'] },

package/dist/__tests__/workspace.test.js

@@ -13,9 +13,9 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { runWorkspaceVerify, runWorkspaceRepair, runDefinitionsDiff } from '../commands/workspace.js';
 // ── Mocks ──────────────────────────────────────────────────────────────────
-const convexCallMock = vi.fn();
+const kernelCallMock = vi.fn();
 vi.mock('../lib/client.js', () => ({
-    convexCall: (...args) => convexCallMock(...args),
+    kernelCall: (...args) => kernelCallMock(...args),
 }));
 vi.mock('../lib/config.js', () => ({
     getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
@@ -84,12 +84,12 @@ const missingSeedsResult = {
 describe('formatWorkspaceVerify', () => {
     beforeEach(() => vi.clearAllMocks());
     it('renders workspace name in the heading', async () => {
-        convexCallMock.mockResolvedValue(healthyResult);
+        kernelCallMock.mockResolvedValue(healthyResult);
         const output = await captureStdout(() => runWorkspaceVerify());
         expect(output).toContain('Acme Workspace');
     });
     it('shows healthy status when all checks pass', async () => {
-        convexCallMock.mockResolvedValue(healthyResult);
+        kernelCallMock.mockResolvedValue(healthyResult);
         const output = await captureStdout(() => runWorkspaceVerify());
         expect(output).toContain('healthy');
         // No gaps section
@@ -97,7 +97,7 @@ describe('formatWorkspaceVerify', () => {
         expect(output).not.toContain('pb workspace repair');
     });
     it('shows all four check labels', async () => {
-        convexCallMock.mockResolvedValue(healthyResult);
+        kernelCallMock.mockResolvedValue(healthyResult);
         const output = await captureStdout(() => runWorkspaceVerify());
         expect(output).toContain('Collections aligned');
         expect(output).toContain('Glossary seeded');
@@ -105,7 +105,7 @@ describe('formatWorkspaceVerify', () => {
         expect(output).toContain('Default circle');
     });
     it('shows incomplete status with gaps section', async () => {
-        convexCallMock.mockResolvedValue(incompletResult);
+        kernelCallMock.mockResolvedValue(incompletResult);
         const output = await captureStdout(() => runWorkspaceVerify());
         expect(output).toContain('incomplete');
         expect(output).toContain('Gaps');
@@ -113,13 +113,13 @@ describe('formatWorkspaceVerify', () => {
         expect(output).toContain('pb workspace repair');
     });
     it('shows missing-seeds status', async () => {
-        convexCallMock.mockResolvedValue(missingSeedsResult);
+        kernelCallMock.mockResolvedValue(missingSeedsResult);
         const output = await captureStdout(() => runWorkspaceVerify());
         expect(output).toContain('missing-seeds');
         expect(output).toContain('collections missing');
     });
     it('lists all gaps individually', async () => {
-        convexCallMock.mockResolvedValue(incompletResult);
+        kernelCallMock.mockResolvedValue(incompletResult);
         const output = await captureStdout(() => runWorkspaceVerify());
         for (const gap of incompletResult.gaps) {
             expect(output).toContain(gap);
@@ -144,31 +144,31 @@ describe('formatWorkspaceRepair', () => {
         alreadyHealthy: false,
     };
     it('renders already-healthy message when alreadyHealthy is true', async () => {
-        convexCallMock.mockResolvedValue(alreadyHealthyResult);
+        kernelCallMock.mockResolvedValue(alreadyHealthyResult);
         const output = await captureStdout(() => runWorkspaceRepair());
         expect(output).toContain('already healthy');
         expect(output).not.toContain('Scheduled');
     });
     it('lists scheduled jobs when seeds were missing', async () => {
-        convexCallMock.mockResolvedValue(repairedResult);
+        kernelCallMock.mockResolvedValue(repairedResult);
         const output = await captureStdout(() => runWorkspaceRepair());
         expect(output).toContain('Scheduled');
         expect(output).toContain('seedSystemEntries');
         expect(output).toContain('seedSemanticTypes');
     });
     it('lists skipped jobs when already present', async () => {
-        convexCallMock.mockResolvedValue(repairedResult);
+        kernelCallMock.mockResolvedValue(repairedResult);
         const output = await captureStdout(() => runWorkspaceRepair());
         expect(output).toContain('Skipped');
         expect(output).toContain('seedDefaultCircle');
     });
     it('shows async-confirmation hint when seeds were scheduled', async () => {
-        convexCallMock.mockResolvedValue(repairedResult);
+        kernelCallMock.mockResolvedValue(repairedResult);
         const output = await captureStdout(() => runWorkspaceRepair());
         expect(output).toContain('pb workspace verify');
     });
     it('renders workspace name', async () => {
-        convexCallMock.mockResolvedValue(repairedResult);
+        kernelCallMock.mockResolvedValue(repairedResult);
         const output = await captureStdout(() => runWorkspaceRepair());
         expect(output).toContain('Fixed Workspace');
     });
@@ -215,7 +215,7 @@ describe('formatDefinitionsDiff — via runDefinitionsDiff mock', () => {
         const dir = mkdtempSync(join(tmpdir(), 'pb-test-'));
         const file = join(dir, 'defs.json');
         writeFileSync(file, JSON.stringify([]));
-        convexCallMock.mockResolvedValue([]);
+        kernelCallMock.mockResolvedValue([]);
         const output = await captureStdout(() => runDefinitionsDiff({ file }));
         expect(output).toContain('No definitions found');
         rmSync(dir, { recursive: true, force: true });
@@ -228,7 +228,7 @@ describe('formatDefinitionsDiff — via runDefinitionsDiff mock', () => {
         const file = join(dir, 'defs.json');
         const def = { slug: 'bets', name: 'Bets', description: 'Work packages' };
         writeFileSync(file, JSON.stringify([def]));
-        convexCallMock.mockResolvedValue([def]);
+        kernelCallMock.mockResolvedValue([def]);
         const output = await captureStdout(() => runDefinitionsDiff({ file }));
         expect(output).toContain('Identical');
         expect(output).toContain('1');
@@ -242,7 +242,7 @@ describe('formatDefinitionsDiff — via runDefinitionsDiff mock', () => {
         const dir = mkdtempSync(join(tmpdir(), 'pb-test-'));
         const file = join(dir, 'defs.json');
         writeFileSync(file, JSON.stringify([{ slug: 'experiments', name: 'Experiments' }]));
-        convexCallMock.mockResolvedValue([]);
+        kernelCallMock.mockResolvedValue([]);
         const output = await captureStdout(() => runDefinitionsDiff({ file }));
         expect(output).toContain('Only local');
         expect(output).toContain('experiments');
@@ -255,7 +255,7 @@ describe('formatDefinitionsDiff — via runDefinitionsDiff mock', () => {
         const dir = mkdtempSync(join(tmpdir(), 'pb-test-'));
         const file = join(dir, 'defs.json');
         writeFileSync(file, JSON.stringify([]));
-        convexCallMock.mockResolvedValue([{ slug: 'tensions', name: 'Tensions' }]);
+        kernelCallMock.mockResolvedValue([{ slug: 'tensions', name: 'Tensions' }]);
         const output = await captureStdout(() => runDefinitionsDiff({ file }));
         expect(output).toContain('Only server');
         expect(output).toContain('tensions');
@@ -268,7 +268,7 @@ describe('formatDefinitionsDiff — via runDefinitionsDiff mock', () => {
         const dir = mkdtempSync(join(tmpdir(), 'pb-test-'));
         const file = join(dir, 'defs.json');
         writeFileSync(file, JSON.stringify([{ slug: 'bets', name: 'Old name' }]));
-        convexCallMock.mockResolvedValue([{ slug: 'bets', name: 'New name' }]);
+        kernelCallMock.mockResolvedValue([{ slug: 'bets', name: 'New name' }]);
         const output = await captureStdout(() => runDefinitionsDiff({ file }));
         expect(output).toContain('Different');
         expect(output).toContain('bets');
@@ -283,7 +283,7 @@ describe('formatDefinitionsDiff — via runDefinitionsDiff mock', () => {
         const localDef = { slug: 'bets', name: 'Bets' };
         writeFileSync(file, JSON.stringify([localDef]));
         // Server returns same data but with Convex metadata — should still be identical
-        convexCallMock.mockResolvedValue([{ ...localDef, _id: 'abc123', _creationTime: 1234567890 }]);
+        kernelCallMock.mockResolvedValue([{ ...localDef, _id: 'abc123', _creationTime: 1234567890 }]);
         const output = await captureStdout(() => runDefinitionsDiff({ file }));
         expect(output).toContain('Identical');
         expect(output).toContain('All definitions match');
@@ -298,7 +298,7 @@ describe('formatDefinitionsDiff — via runDefinitionsDiff mock', () => {
         const identical = { slug: 'bets', name: 'Bets' };
         const changed = { slug: 'tensions', name: 'Old tensions' };
         writeFileSync(file, JSON.stringify([identical, changed]));
-        convexCallMock.mockResolvedValue([identical, { slug: 'tensions', name: 'New tensions' }]);
+        kernelCallMock.mockResolvedValue([identical, { slug: 'tensions', name: 'New tensions' }]);
         const output = await captureStdout(() => runDefinitionsDiff({ file }));
         // 1 identical / 2 total
         expect(output).toContain('1/2');

package/dist/commands/accept.js

@@ -10,7 +10,7 @@
  * skipped for manual review. Reports what was approved and what was skipped.
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { convexCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand } from '../lib/runner.js';
 import { CLIError, ErrorCode } from '../lib/errors.js';
 import { formatAcceptReceipt, formatAutoAcceptReport, } from '../formatters/proposals.js';
@@ -22,7 +22,7 @@ export async function runAccept(options) {
     if (options.auto) {
         await runCliCommand({
             fn: async () => {
-                const proposals = await convexCall('governance.listProposals', {});
+                const proposals = await kernelCall('governance.listProposals', {});
                 const approved = [];
                 const skipped = [];
                 for (const p of proposals) {
@@ -38,7 +38,7 @@ export async function runAccept(options) {
                         continue;
                     }
                     try {
-                        await convexCall('governance.respondToProposal', {
+                        await kernelCall('governance.respondToProposal', {
                             proposalId: p._id,
                             verdict: 'approve',
                         });
@@ -65,7 +65,7 @@ export async function runAccept(options) {
     }
     await runCliCommand({
         fn: async () => {
-            return await convexCall('governance.respondToProposal', {
+            return await kernelCall('governance.respondToProposal', {
                 proposalId: options.proposalId,
                 verdict: 'approve',
             });

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

@@ -56,7 +56,7 @@ export type ChangelogRow = {
     timestamp: number;
     definitionSlug: string;
 };
-export type CockpitTab = 'workspaces' | 'seeds' | 'changelog';
+export type CockpitTab = 'workspaces' | 'seeds' | 'changelog' | 'manage';
 export type CockpitProps = {
     workspaces: WorkspaceRow[];
     currentKeyWorkspaceId: string | null;
@@ -70,8 +70,10 @@ export type CockpitProps = {
     seedRows: SeedRow[];
     /** Changelog rows for heatmap. WP-317 E8 / S4. */
     changelogRows: ChangelogRow[];
+    /** Called when ManageTab destructive flow becomes active/inactive. WP-324 S2. */
+    onFlowActive?: (active: boolean) => void;
 };
-export declare function Cockpit({ workspaces, currentKeyWorkspaceId, onExit, onDrillIn, onRunFix, siteUrl, seedRows, changelogRows }: CockpitProps): import("react/jsx-runtime").JSX.Element;
+export declare function Cockpit({ workspaces, currentKeyWorkspaceId, onExit, onDrillIn, onRunFix, siteUrl, seedRows, changelogRows, onFlowActive }: CockpitProps): import("react/jsx-runtime").JSX.Element;
 export type WorkspaceHealthData = {
     readiness: unknown;
     collections: unknown;

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

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