@principles/pd-cli 1.152.12 → 1.152.14

package/tests/commands/runtime-internalization-queue.test.ts

@@ -1,380 +0,0 @@
-/**
- * pd runtime internalization queue CLI unit tests.
- *
- * Tests the queue command handler: delegation to InternalizationQueueReadModel,
- * JSON/text output formatting, and exit code behavior.
- * The read model is mocked — its contract is tested in principles-core.
- */
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-
-const { mockGetSnapshot, mockClose } = vi.hoisted(() => ({
-  mockGetSnapshot: vi.fn(),
-  mockClose: vi.fn().mockResolvedValue(undefined),
-}));
-
-vi.mock('../../src/resolve-workspace.js', () => ({
-  resolveWorkspaceDir: vi.fn().mockReturnValue('/fake/workspace'),
-}));
-
-vi.mock('@principles/core/runtime-v2', () => ({
-  createInternalizationQueueReadModel: vi.fn().mockResolvedValue({
-    readModel: { getSnapshot: mockGetSnapshot, close: mockClose },
-    close: mockClose,
-  }),
-  resolveOutputLanguage: vi.fn().mockReturnValue({ outputLanguage: 'zh-CN' }),
-}));
-
-const { mockLoadPdConfig, mockComputeFlagsFromLoadResult } = vi.hoisted(() => ({
-  mockLoadPdConfig: vi.fn().mockReturnValue({ ok: true, effective: {}, source: 'defaults' }),
-  mockComputeFlagsFromLoadResult: vi.fn().mockReturnValue({
-    flags: {
-      internalization_auto_consumer: { id: 'internalization_auto_consumer', enabled: true, category: 'quiet' },
-    },
-    enabledChannels: ['prompt', 'code_tool_hook', 'defer_archive'],
-    warnings: [],
-  }),
-}));
-
-vi.mock('../../src/services/pd-config-loader.js', () => ({
-  loadPdConfig: mockLoadPdConfig,
-  computeFlagsFromLoadResult: mockComputeFlagsFromLoadResult,
-}));
-
-import { handleRuntimeInternalizationQueue } from '../../src/commands/runtime-internalization-queue.js';
-
-const WS = '/fake/workspace';
-
-function emptySnapshot() {
-  return {
-    pendingCount: 0,
-    retryWaitCount: 0,
-    countsByTaskKind: {},
-    countsByChannel: {},
-    invalidMetadataCount: 0,
-    sampleInvalidTaskIds: [],
-    blockedSummary: { count: 0, samples: [] },
-    dependencyFailedSummary: { count: 0, samples: [] },
-    retryWaitPendingSummary: { count: 0, samples: [] },
-    leaseConflictSummary: { count: 0, samples: [] },
-    unresolvableSummary: { count: 0, samples: [] },
-    readyTasks: [],
-    noReadyTasks: { reason: 'no_candidates', inspectedCount: 0 },
-    suppressedTasks: [],
-  };
-}
-
-describe('handleRuntimeInternalizationQueue', () => {
-  let consoleLogSpy: ReturnType<typeof vi.spyOn>;
-  let consoleErrorSpy: ReturnType<typeof vi.spyOn>;
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-    consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
-    consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
-    mockLoadPdConfig.mockReturnValue({ ok: true, effective: {}, source: 'defaults' });
-    mockComputeFlagsFromLoadResult.mockReturnValue({
-      flags: {
-        internalization_auto_consumer: { id: 'internalization_auto_consumer', enabled: true, category: 'quiet' },
-      },
-      enabledChannels: ['prompt', 'code_tool_hook', 'defer_archive'],
-      warnings: [],
-    });
-  });
-
-  afterEach(() => {
-    consoleLogSpy.mockRestore();
-    consoleErrorSpy.mockRestore();
-  });
-
-  // ── Empty queue ─────────────────────────────────────────────────────────────
-
-  it('empty queue returns no_candidates reason in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue(emptySnapshot());
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.noReadyTasks.reason).toBe('no_candidates');
-    expect(output.pendingCount).toBe(0);
-    expect(output.readyTasks).toEqual([]);
-  });
-
-  it('empty queue text output is human-readable', async () => {
-    mockGetSnapshot.mockResolvedValue(emptySnapshot());
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: false });
-
-    const text = consoleLogSpy.mock.calls.map(c => c.join(' ')).join('\n');
-    expect(text).toContain('no_ready_tasks');
-    expect(text).toContain('no_candidates');
-  });
-
-  // ── Invalid metadata ────────────────────────────────────────────────────────
-
-  it('invalid metadata is counted and sampled in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      invalidMetadataCount: 2,
-      sampleInvalidTaskIds: ['task_bad_1', 'task_bad_2'],
-      noReadyTasks: { reason: 'all_hydration_failed', inspectedCount: 2 },
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.invalidMetadataCount).toBe(2);
-    expect(output.sampleInvalidTaskIds).toEqual(['task_bad_1', 'task_bad_2']);
-    expect(output.noReadyTasks.reason).toBe('all_hydration_failed');
-  });
-
-  it('invalid metadata appears in text output', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      invalidMetadataCount: 3,
-      sampleInvalidTaskIds: ['task_bad_1'],
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: false });
-
-    const text = consoleLogSpy.mock.calls.map(c => c.join(' ')).join('\n');
-    expect(text).toContain('invalid_metadata');
-    expect(text).toContain('task_bad_1');
-  });
-
-  // ── Blocked dependency ─────────────────────────────────────────────────────
-
-  it('blocked task surfaces blockedBy task IDs in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      pendingCount: 1,
-      blockedSummary: {
-        count: 1,
-        samples: [{ taskId: 'task_001', taskKind: 'dreamer', blockedBy: ['task_000'] }],
-      },
-      noReadyTasks: { reason: 'all_blocked', inspectedCount: 1 },
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.blockedSummary.count).toBe(1);
-    expect(output.blockedSummary.samples[0].blockedBy).toContain('task_000');
-  });
-
-  it('blocked task text output shows blockedBy', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      blockedSummary: {
-        count: 1,
-        samples: [{ taskId: 'task_001', taskKind: 'dreamer', blockedBy: ['task_000'] }],
-      },
-      noReadyTasks: { reason: 'all_blocked', inspectedCount: 1 },
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: false });
-
-    const text = consoleLogSpy.mock.calls.map(c => c.join(' ')).join('\n');
-    expect(text).toContain('blocked');
-    expect(text).toContain('task_000');
-  });
-
-  // ── Dependency failed ───────────────────────────────────────────────────────
-
-  it('dependency_failed surfaces failedDependencies in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      dependencyFailedSummary: {
-        count: 1,
-        samples: [{ taskId: 'task_002', taskKind: 'philosopher', failedDependencies: ['task_001'] }],
-      },
-      noReadyTasks: { reason: 'all_dependency_failed', inspectedCount: 1 },
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.dependencyFailedSummary.count).toBe(1);
-    expect(output.dependencyFailedSummary.samples[0].failedDependencies).toContain('task_001');
-  });
-
-  it('dependency_failed text output shows failed deps', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      dependencyFailedSummary: {
-        count: 1,
-        samples: [{ taskId: 'task_002', taskKind: 'philosopher', failedDependencies: ['task_001'] }],
-      },
-      noReadyTasks: { reason: 'all_dependency_failed', inspectedCount: 1 },
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: false });
-
-    const text = consoleLogSpy.mock.calls.map(c => c.join(' ')).join('\n');
-    expect(text).toContain('dependency_failed');
-    expect(text).toContain('task_001');
-  });
-
-  // ── Ready tasks ─────────────────────────────────────────────────────────────
-
-  it('ready task appears in readyTasks array', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      pendingCount: 1,
-      readyTasks: [{ taskId: 'task_003', taskKind: 'scribe', channel: 'prompt' }],
-      noReadyTasks: null,
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.readyTasks).toContainEqual({ taskId: 'task_003', taskKind: 'scribe', channel: 'prompt' });
-  });
-
-  it('ready task text output shows ready count', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      readyTasks: [{ taskId: 'task_003', taskKind: 'scribe', channel: 'prompt' }],
-      noReadyTasks: null,
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: false });
-
-    const text = consoleLogSpy.mock.calls.map(c => c.join(' ')).join('\n');
-    expect(text).toContain('ready:');
-  });
-
-  // ── Counts by kind / channel ──────────────────────────────────────────────
-
-  it('countsByTaskKind and countsByChannel are included in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      pendingCount: 2,
-      retryWaitCount: 1,
-      countsByTaskKind: { dreamer: 2, scribe: 1 },
-      countsByChannel: { prompt: 3 },
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.countsByTaskKind.dreamer).toBe(2);
-    expect(output.countsByTaskKind.scribe).toBe(1);
-    expect(output.countsByChannel.prompt).toBe(3);
-  });
-
-  // ── nextAction / consumerStatus (PRI-381) ──────────────────────────────────
-
-  it('ready tasks + auto-consumer (core flag default) → consumerStatus=auto_consumer_enabled in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      pendingCount: 3,
-      readyTasks: [
-        { taskId: 'task_dreamer_1', taskKind: 'dreamer', channel: 'prompt' },
-        { taskId: 'task_dreamer_2', taskKind: 'dreamer', channel: 'prompt' },
-      ],
-      noReadyTasks: null,
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.consumerStatus).toBe('auto_consumer_enabled');
-    expect(output.nextAction).toBeUndefined();
-  });
-
-  it('ready tasks + auto-consumer enabled via config → consumerStatus=auto_consumer_enabled in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      pendingCount: 3,
-      readyTasks: [
-        { taskId: 'task_dreamer_1', taskKind: 'dreamer', channel: 'prompt' },
-      ],
-      noReadyTasks: null,
-    });
-    mockComputeFlagsFromLoadResult.mockReturnValue({
-      flags: {
-        internalization_auto_consumer: { id: 'internalization_auto_consumer', enabled: true, category: 'quiet' },
-      },
-      enabledChannels: ['prompt', 'code_tool_hook', 'defer_archive'],
-      warnings: [],
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.consumerStatus).toBe('auto_consumer_enabled');
-    expect(output.nextAction).toBeUndefined();
-  });
-
-  it('ready tasks + auto-consumer disabled via config → consumerStatus=manual_action_required + nextAction in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      pendingCount: 3,
-      readyTasks: [
-        { taskId: 'task_dreamer_1', taskKind: 'dreamer', channel: 'prompt' },
-      ],
-      noReadyTasks: null,
-    });
-    mockComputeFlagsFromLoadResult.mockReturnValue({
-      flags: {
-        internalization_auto_consumer: { id: 'internalization_auto_consumer', enabled: false, category: 'quiet' },
-      },
-      enabledChannels: ['prompt', 'code_tool_hook', 'defer_archive'],
-      warnings: [],
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.consumerStatus).toBe('manual_action_required');
-    expect(output.nextAction).toContain('pd runtime internalization run-once');
-  });
-
-  it('no ready tasks → no consumerStatus or nextAction in JSON', async () => {
-    mockGetSnapshot.mockResolvedValue(emptySnapshot());
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: true });
-
-    const output = JSON.parse(consoleLogSpy.mock.calls[0][0]);
-    expect(output.consumerStatus).toBeUndefined();
-    expect(output.nextAction).toBeUndefined();
-  });
-
-  it('ready tasks in text output show auto_consumer status (not manual nextAction when enabled)', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      pendingCount: 1,
-      readyTasks: [{ taskId: 'task_003', taskKind: 'dreamer', channel: 'prompt' }],
-      noReadyTasks: null,
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: false });
-
-    const text = consoleLogSpy.mock.calls.map(c => c.join(' ')).join('\n');
-    expect(text).toContain('auto_consumer_enabled');
-    expect(text).not.toContain('nextAction:');
-  });
-
-  it('ready tasks + auto-consumer disabled in text output shows manual_action_required + nextAction', async () => {
-    mockGetSnapshot.mockResolvedValue({
-      ...emptySnapshot(),
-      pendingCount: 1,
-      readyTasks: [{ taskId: 'task_003', taskKind: 'dreamer', channel: 'prompt' }],
-      noReadyTasks: null,
-    });
-    mockComputeFlagsFromLoadResult.mockReturnValue({
-      flags: {
-        internalization_auto_consumer: { id: 'internalization_auto_consumer', enabled: false, category: 'quiet' },
-      },
-      enabledChannels: ['prompt', 'code_tool_hook', 'defer_archive'],
-      warnings: [],
-    });
-
-    await handleRuntimeInternalizationQueue({ workspace: WS, json: false });
-
-    const text = consoleLogSpy.mock.calls.map(c => c.join(' ')).join('\n');
-    expect(text).toContain('manual_action_required');
-    expect(text).toContain('nextAction:');
-    expect(text).toContain('pd runtime internalization run-once');
-  });
-});