@principles/core 1.73.0

package/dist/prompt-builder/__tests__/prompt-builder-core.test.js

@@ -0,0 +1,283 @@
+/**
+ * Unit tests for @principles/core/prompt-builder primitives.
+ *
+ * Phase: PRI-75 Prompt Injection SDK Migration Phase 1
+ */
+import { describe, it, expect } from 'vitest';
+import { buildAttitudeDirective, detectCorrectionCue, extractMessageContent, isMinimalTrigger, truncateInjectionToBudget, } from '../index.js';
+// ─── buildAttitudeDirective tests ─────────────────────────────────────────────
+describe('buildAttitudeDirective', () => {
+    it('GFI = 0 → EFFICIENT', () => {
+        const result = buildAttitudeDirective(0);
+        expect(result).toContain('EFFICIENT');
+        expect(result).toContain('GFI: 0');
+    });
+    it('GFI = 39 → EFFICIENT', () => {
+        const result = buildAttitudeDirective(39);
+        expect(result).toContain('EFFICIENT');
+    });
+    it('GFI = 40 → CONCILIATORY (boundary)', () => {
+        const result = buildAttitudeDirective(40);
+        expect(result).toContain('CONCILIATORY');
+        expect(result).toContain('GFI: 40');
+    });
+    it('GFI = 69 → CONCILIATORY', () => {
+        const result = buildAttitudeDirective(69);
+        expect(result).toContain('CONCILIATORY');
+    });
+    it('GFI = 70 → HUMBLE_RECOVERY (boundary)', () => {
+        const result = buildAttitudeDirective(70);
+        expect(result).toContain('HUMBLE_RECOVERY');
+        expect(result).toContain('GFI: 70');
+    });
+    it('GFI = 100 → HUMBLE_RECOVERY', () => {
+        const result = buildAttitudeDirective(100);
+        expect(result).toContain('HUMBLE_RECOVERY');
+        expect(result).toContain('GFI: 100');
+    });
+});
+// ─── detectCorrectionCue tests ────────────────────────────────────────────────
+describe('detectCorrectionCue', () => {
+    it('detects 中文 cue: 不是这个', () => {
+        expect(detectCorrectionCue('不是这个')).toBe('不是这个');
+    });
+    it('detects 中文 cue: 不对', () => {
+        expect(detectCorrectionCue('不对')).toBe('不对');
+    });
+    it('detects 中文 cue: 错了', () => {
+        expect(detectCorrectionCue('错了')).toBe('错了');
+    });
+    it('detects 中文 cue: 重新来', () => {
+        expect(detectCorrectionCue('重新来')).toBe('重新来');
+    });
+    it('detects 英文 cue: you are wrong', () => {
+        expect(detectCorrectionCue('You are wrong')).toBe('you are wrong');
+    });
+    it('detects 英文 cue: try again', () => {
+        expect(detectCorrectionCue('try again')).toBe('try again');
+    });
+    it('detects 英文 cue: redo', () => {
+        expect(detectCorrectionCue('redo')).toBe('redo');
+    });
+    it('returns null when no cue detected', () => {
+        expect(detectCorrectionCue('hello world')).toBeNull();
+        expect(detectCorrectionCue('what is this')).toBeNull();
+    });
+    it('strips punctuation before matching', () => {
+        expect(detectCorrectionCue('不是这个!')).toBe('不是这个');
+        expect(detectCorrectionCue('不对?')).toBe('不对');
+        expect(detectCorrectionCue('you are wrong.')).toBe('you are wrong');
+        expect(detectCorrectionCue('try again!')).toBe('try again');
+    });
+    it('handles mixed language input', () => {
+        expect(detectCorrectionCue('Please redo — 不是这个')).toBe('不是这个');
+    });
+});
+// ─── extractMessageContent tests ──────────────────────────────────────────────
+describe('extractMessageContent', () => {
+    it('returns string content as-is', () => {
+        expect(extractMessageContent('hello world')).toBe('hello world');
+    });
+    it('extracts from { content: string }', () => {
+        expect(extractMessageContent({ content: 'hello' })).toBe('hello');
+    });
+    it('extracts from text part array', () => {
+        const msg = {
+            content: [
+                { type: 'text', text: 'hello' },
+                { type: 'text', text: ' world' },
+            ],
+        };
+        // Parts are joined with \n (actual implementation behavior)
+        expect(extractMessageContent(msg)).toBe('hello\n world');
+    });
+    it('returns empty string for empty object', () => {
+        expect(extractMessageContent({})).toBe('');
+    });
+    it('returns empty string for null', () => {
+        expect(extractMessageContent(null)).toBe('');
+    });
+    it('returns empty string for undefined', () => {
+        expect(extractMessageContent(undefined)).toBe('');
+    });
+    it('returns empty string for non-object primitive', () => {
+        expect(extractMessageContent(123)).toBe('');
+    });
+});
+// ─── isMinimalTrigger tests ─────────────────────────────────────────────────
+describe('isMinimalTrigger', () => {
+    it('heartbeat trigger → true', () => {
+        expect(isMinimalTrigger('heartbeat')).toBe(true);
+    });
+    it('cron trigger → true', () => {
+        expect(isMinimalTrigger('cron')).toBe(true);
+    });
+    it('subagent sessionId → true', () => {
+        expect(isMinimalTrigger('user', 'session:subagent:123')).toBe(true);
+        expect(isMinimalTrigger('heartbeat', 'foo:subagent:bar')).toBe(true);
+    });
+    it('regular trigger and sessionId → false', () => {
+        expect(isMinimalTrigger('user', 'regular-session-123')).toBe(false);
+        expect(isMinimalTrigger('user', 'test-session')).toBe(false);
+    });
+    it('handles undefined trigger → false', () => {
+        expect(isMinimalTrigger(undefined)).toBe(false);
+    });
+    it('handles undefined sessionId → false', () => {
+        expect(isMinimalTrigger('user', undefined)).toBe(false);
+    });
+});
+// ─── truncateInjectionToBudget tests ──────────────────────────────────────────
+describe('truncateInjectionToBudget', () => {
+    // Helper to create appendSystemContext with project_context
+    const withProjectContext = (content) => `<project_context>\n${content}\n</project_context>`;
+    // Helper to create appendSystemContext with thinking_os
+    const withThinkingOs = (content) => `<thinking_os>\n${content}\n</thinking_os>`;
+    // Helper to create appendSystemContext with evolution_principles
+    const withEvolutionPrinciples = (content) => `<evolution_principles>\n${content}\n</evolution_principles>`;
+    // Helper to create prependContext with long reason: line
+    const withLongReason = (reason) => `task: diagnose\nreason: ${reason}\nscore: 75`;
+    it('returns unchanged when total is within budget', () => {
+        const ps = '<system>identity</system>';
+        const pc = 'directive';
+        const ac = withProjectContext('small');
+        const result = truncateInjectionToBudget(ps, pc, ac);
+        expect(result.prependSystemContext).toBe(ps);
+        expect(result.prependContext).toBe(pc);
+        expect(result.appendSystemContext).toBe(ac);
+        expect(result.truncated).toBe(false);
+        expect(result.truncationLog).toEqual([]);
+    });
+    it('strips project_context when over budget (normal mode)', () => {
+        const ps = '<system>identity</system>';
+        const pc = 'directive';
+        // 9000 budget - 25 (ps) - 9 (pc) = 8966 minimum; use 9100 to leave headroom
+        const projContent = 'x'.repeat(9100);
+        const ac = withProjectContext(projContent);
+        const result = truncateInjectionToBudget(ps, pc, ac);
+        expect(result.appendSystemContext).toContain('[stripped: project_context]');
+        expect(result.truncationLog).toContain('project_context');
+        expect(result.truncated).toBe(true);
+    });
+    it('strips project_context using exact content replacement when blocks provided', () => {
+        const ps = '<system>identity</system>';
+        const pc = 'directive';
+        // Must exceed budget: 9000 - 25 - 9 = 8966
+        const projContent = 'exact-content-here'.repeat(500); // ~6500 chars
+        const ac = withProjectContext(projContent);
+        const result = truncateInjectionToBudget(ps, pc, ac, {
+            blocks: { projectContextContent: projContent },
+        });
+        // Exact match replacement
+        expect(result.appendSystemContext).toBe('<project_context>\n[stripped: project_context]\n</project_context>');
+    });
+    it('diagnosticianMode strips thinking_os when over budget', () => {
+        const ps = '<system>identity</system>';
+        const pc = 'directive';
+        // After stripping project_context, total must still be > 9000 to continue stripping.
+        // project_context stripped size ≈ 35 chars. So thinking_os must be > 9000 - 35 - 25 - 9 ≈ 8931.
+        // Use 9100 to be safe.
+        const ac = withThinkingOs('y'.repeat(9100)) + '\n' + withProjectContext('x'.repeat(9100));
+        const result = truncateInjectionToBudget(ps, pc, ac, { diagnosticianMode: true });
+        expect(result.appendSystemContext).toContain('[stripped: thinking_os]');
+        expect(result.truncationLog).toContain('thinking_os');
+    });
+    it('diagnosticianMode strips evolution_principles when over budget', () => {
+        const ps = '<system>identity</system>';
+        const pc = 'directive';
+        // Same logic - need remaining content after project_context strip to be > 9000
+        const ac = withEvolutionPrinciples('z'.repeat(9100)) +
+            '\n' +
+            withProjectContext('x'.repeat(9100));
+        const result = truncateInjectionToBudget(ps, pc, ac, { diagnosticianMode: true });
+        expect(result.appendSystemContext).toContain('[stripped: evolution_principles]');
+        expect(result.truncationLog).toContain('evolution_principles');
+    });
+    it('diagnosticianMode strips reflection_log when over budget', () => {
+        const ps = '<system>identity</system>';
+        const pc = 'directive';
+        // Once the larger project_context, thinking_os, and evolution_principles
+        // sections are stripped, the prompt is back under budget; reflection_log is
+        // preserved because the guard exits as soon as the prompt is safe.
+        const ac = withThinkingOs('y'.repeat(9100)) +
+            '\n' +
+            withEvolutionPrinciples('z'.repeat(9100)) +
+            '\n' +
+            '<reflection_log>\nreflections here\n</reflection_log>\n' +
+            withProjectContext('x'.repeat(9100));
+        const result = truncateInjectionToBudget(ps, pc, ac, { diagnosticianMode: true });
+        expect(result.truncationLog).not.toContain('reflection_log');
+        expect(result.appendSystemContext).toContain('reflections here');
+    });
+    it('diagnosticianMode truncates reason: lines to 129 chars', () => {
+        const ps = '<system>identity</system>';
+        // reason: prefix is 8 chars, so 200 + 8 = 208 total
+        const longReason = 'a'.repeat(200);
+        const pc = withLongReason(longReason);
+        // For reason truncation to trigger, total after all 4 strips must be > 9000.
+        // After strips: ~35×4 + 45 = 185. pc = 233.
+        // Total after strips = 25 + 233 + 185 = 443 < 9000. Won't trigger!
+        // Need pc to be massive. Let's make pc > 9000 - 25 - 185 = 8790.
+        const bigPc = pc + '\n' + 'x'.repeat(9000);
+        const ac = withThinkingOs('y'.repeat(9100)) +
+            '\n' +
+            withEvolutionPrinciples('z'.repeat(9100)) +
+            '\n' +
+            '<reflection_log>\nreflections here\n</reflection_log>\n' +
+            withProjectContext('x'.repeat(9100));
+        const result = truncateInjectionToBudget(ps, bigPc, ac, { diagnosticianMode: true });
+        // Find the truncated line in prependContext
+        const reasonLine = result.prependContext.split('\n').find((l) => l.startsWith('reason:'));
+        // 129 chars content + 'reason: ' (8) = 137 chars total, + '...[truncated]' = 148
+        expect(reasonLine?.length).toBeLessThanOrEqual(148);
+        expect(reasonLine).toContain('...[truncated]');
+        expect(result.truncationLog).toContain('diagnostician_reason');
+    });
+    it('exits early after stripping project_context when within budget', () => {
+        const ps = '<system>id</system>';
+        const pc = 'dir';
+        // Total must exceed budget: 9000 - 11 - 5 = 8984 minimum
+        const ac = withProjectContext('x'.repeat(9100));
+        const result = truncateInjectionToBudget(ps, pc, ac);
+        expect(result.appendSystemContext).toContain('[stripped: project_context]');
+        expect(result.truncationLog).toEqual(['project_context']);
+    });
+    it('fallback preserves prependSystemContext and prependContext', () => {
+        const ps = '<system>identity</system>';
+        // For fallback to trigger, total after all 4 strips must be > 9000.
+        // After all 4 strips: ~35×4 + 45 = 185 chars for ac.
+        // So pc must be > 9000 - 25 - 185 = 8790. Use 9000.
+        const pc = 'directive line' + 'x'.repeat(9000);
+        const ac = withThinkingOs('x'.repeat(3000)) +
+            '\n' +
+            withEvolutionPrinciples('x'.repeat(3000)) +
+            '\n' +
+            '<reflection_log>\n' + 'x'.repeat(100) + '\n</reflection_log>\n' +
+            withProjectContext('x'.repeat(3000));
+        const result = truncateInjectionToBudget(ps, pc, ac, { diagnosticianMode: true });
+        expect(result.appendSystemContext).toContain('Context sections stripped due to prompt size constraints');
+        expect(result.appendSystemContext).toContain('diagnostician-priority');
+        expect(result.prependSystemContext).toBe(ps);
+        expect(result.prependContext).toBe(pc);
+        expect(result.truncationLog).toContain('fallback');
+    });
+    it('returns non-empty appendSystemContext when all content stripped', () => {
+        const ps = '<system>id</system>';
+        const pc = 'dir';
+        const ac = withProjectContext('x'.repeat(10000));
+        const result = truncateInjectionToBudget(ps, pc, ac);
+        expect(result.appendSystemContext.length).toBeGreaterThan(0);
+        expect(result.truncated).toBe(true);
+    });
+    it('normal mode does NOT strip thinking_os/evolution_principles', () => {
+        const ps = '<system>id</system>';
+        const pc = 'dir';
+        // 9000 - 11 - 5 = 8984 minimum, use 9100
+        const ac = withThinkingOs('content') + '\n' + withProjectContext('x'.repeat(9100));
+        const result = truncateInjectionToBudget(ps, pc, ac, { diagnosticianMode: false });
+        expect(result.appendSystemContext).toContain('[stripped: project_context]');
+        expect(result.appendSystemContext).not.toContain('[stripped: thinking_os]');
+        expect(result.truncationLog).toEqual(['project_context']);
+    });
+});
+//# sourceMappingURL=prompt-builder-core.test.js.map

package/dist/prompt-builder/__tests__/prompt-builder-core.test.js.map

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

package/dist/prompt-builder/__tests__/routing-guidance.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for @principles/core/prompt-builder routing guidance.
+ *
+ * Phase: PRI-74 Routing Guidance Migration (follow-up to PRI-75 Prompt Injection SDK Migration)
+ *
+ * These tests verify the pure classification logic migrated from
+ * packages/openclaw-plugin/src/core/local-worker-routing.ts.
+ * No I/O dependencies — all inputs are plain objects.
+ */
+export {};
+//# sourceMappingURL=routing-guidance.test.d.ts.map

package/dist/prompt-builder/__tests__/routing-guidance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-guidance.test.d.ts","sourceRoot":"","sources":["../../../src/prompt-builder/__tests__/routing-guidance.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/prompt-builder/__tests__/routing-guidance.test.js

@@ -0,0 +1,305 @@
+/**
+ * Unit tests for @principles/core/prompt-builder routing guidance.
+ *
+ * Phase: PRI-74 Routing Guidance Migration (follow-up to PRI-75 Prompt Injection SDK Migration)
+ *
+ * These tests verify the pure classification logic migrated from
+ * packages/openclaw-plugin/src/core/local-worker-routing.ts.
+ * No I/O dependencies — all inputs are plain objects.
+ */
+import { describe, it, expect } from 'vitest';
+import { classifyTaskKind, buildReason, buildBlockers, computeCombinedText, containsKeyword, READER_KEYWORDS, EDITOR_KEYWORDS, HIGH_ENTROPY_KEYWORDS, } from '../index.js';
+// ─── containsKeyword tests ─────────────────────────────────────────────────────
+describe('containsKeyword', () => {
+    it('returns true when keyword is found (case-insensitive)', () => {
+        expect(containsKeyword('READ a file', READER_KEYWORDS)).toBe(true);
+        expect(containsKeyword('EDIT the config', EDITOR_KEYWORDS)).toBe(true);
+        expect(containsKeyword('DESIGN a system', HIGH_ENTROPY_KEYWORDS)).toBe(true);
+    });
+    it('returns false when keyword is not found', () => {
+        expect(containsKeyword('read a file', HIGH_ENTROPY_KEYWORDS)).toBe(false);
+        expect(containsKeyword('do something', READER_KEYWORDS)).toBe(false);
+    });
+    it('returns false when text is undefined', () => {
+        expect(containsKeyword(undefined, READER_KEYWORDS)).toBe(false);
+        expect(containsKeyword(undefined, EDITOR_KEYWORDS)).toBe(false);
+        expect(containsKeyword(undefined, HIGH_ENTROPY_KEYWORDS)).toBe(false);
+    });
+});
+// ─── computeCombinedText tests ───────────────────────────────────────────────
+describe('computeCombinedText', () => {
+    it('combines taskIntent, taskDescription, expectedOutputShape, and complexityHints', () => {
+        const input = {
+            taskIntent: 'read_file',
+            taskDescription: 'Read the config file',
+            expectedOutputShape: 'json',
+            complexityHints: ['simple'],
+        };
+        const text = computeCombinedText(input);
+        expect(text).toContain('read_file');
+        expect(text).toContain('read the config file');
+        expect(text).toContain('json');
+        expect(text).toContain('simple');
+    });
+    it('returns empty string when all fields are undefined', () => {
+        const text = computeCombinedText({});
+        expect(text).toBe('');
+    });
+    it('does not include requestedTools in combined text', () => {
+        const input = {
+            requestedTools: ['bash', 'rm'],
+            taskIntent: 'cleanup',
+        };
+        const text = computeCombinedText(input);
+        expect(text).not.toContain('bash');
+        expect(text).toContain('cleanup');
+    });
+    it('does not mutate input', () => {
+        const input = { taskIntent: 'test', taskDescription: 'desc' };
+        const inputCopy = { ...input };
+        computeCombinedText(input);
+        expect(input).toEqual(inputCopy);
+    });
+});
+// ─── classifyTaskKind — reader_eligible ─────────────────────────────────────
+describe('classifyTaskKind — reader_eligible', () => {
+    it('intent=read with no description → reader_eligible', () => {
+        const result = classifyTaskKind({ taskIntent: 'read_file' });
+        expect(result).toBe('reader_eligible');
+    });
+    it('intent=read with desc=read → reader_eligible', () => {
+        const result = classifyTaskKind({ taskIntent: 'read', taskDescription: 'read a file' });
+        expect(result).toBe('reader_eligible');
+    });
+    it('intent=grep with desc=search → reader_eligible', () => {
+        const result = classifyTaskKind({ taskIntent: 'grep', taskDescription: 'search logs' });
+        expect(result).toBe('reader_eligible');
+    });
+    it('intent=cat with desc empty → reader_eligible', () => {
+        const result = classifyTaskKind({ taskIntent: 'cat' });
+        expect(result).toBe('reader_eligible');
+    });
+});
+// ─── classifyTaskKind — editor_eligible ─────────────────────────────────────
+describe('classifyTaskKind — editor_eligible', () => {
+    it('intent=edit with no description → editor_eligible', () => {
+        const result = classifyTaskKind({ taskIntent: 'edit_file' });
+        expect(result).toBe('editor_eligible');
+    });
+    it('intent=edit with desc=edit → editor_eligible', () => {
+        const result = classifyTaskKind({ taskIntent: 'edit', taskDescription: 'edit the config' });
+        expect(result).toBe('editor_eligible');
+    });
+    it('intent=fix with desc=fix → editor_eligible', () => {
+        const result = classifyTaskKind({ taskIntent: 'fix', taskDescription: 'fix the bug' });
+        expect(result).toBe('editor_eligible');
+    });
+    it('intent=refactor with no description → editor_eligible', () => {
+        const result = classifyTaskKind({ taskIntent: 'refactor' });
+        expect(result).toBe('editor_eligible');
+    });
+});
+// ─── classifyTaskKind — high_entropy_disallowed ───────────────────────────────
+describe('classifyTaskKind — high_entropy_disallowed', () => {
+    it('design keyword in taskIntent → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskIntent: 'design_system' });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('architect keyword in taskDescription → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskDescription: 'architect a new system' });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('plan keyword in both intent and description → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskIntent: 'plan', taskDescription: 'plan the migration' });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('complexityHints includes multi_step → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskIntent: 'read', complexityHints: ['multi_step'] });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('complexityHints includes cross_file → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskIntent: 'edit', complexityHints: ['cross_file'] });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('complexityHints includes ambiguous → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskIntent: 'do_something', complexityHints: ['ambiguous'] });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('complexityHints includes requires_planning → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskIntent: 'fix', complexityHints: ['requires_planning'] });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('>= 4 requestedFiles → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({
+            taskIntent: 'edit',
+            taskDescription: 'edit multiple files',
+            requestedFiles: ['a.txt', 'b.txt', 'c.txt', 'd.txt'],
+        });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('investigate keyword → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskIntent: 'investigate', taskDescription: 'investigate the issue' });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+    it('research keyword → high_entropy_disallowed', () => {
+        const result = classifyTaskKind({ taskDescription: 'research best practices' });
+        expect(result).toBe('high_entropy_disallowed');
+    });
+});
+// ─── classifyTaskKind — ambiguous_scope ──────────────────────────────────────
+describe('classifyTaskKind — ambiguous_scope', () => {
+    it('taskDescription too short (< 20 chars) → ambiguous_scope', () => {
+        const result = classifyTaskKind({ taskDescription: 'fix something' });
+        expect(result).toBe('ambiguous_scope');
+    });
+    it('taskDescription = "todo" → ambiguous_scope', () => {
+        const result = classifyTaskKind({ taskDescription: 'todo' });
+        expect(result).toBe('ambiguous_scope');
+    });
+    it('taskDescription = "fix" → ambiguous_scope', () => {
+        const result = classifyTaskKind({ taskDescription: 'fix' });
+        expect(result).toBe('ambiguous_scope');
+    });
+    it('taskDescription contains "why" question word → ambiguous_scope', () => {
+        const result = classifyTaskKind({ taskDescription: 'why is this not working?' });
+        expect(result).toBe('ambiguous_scope');
+    });
+    it('taskDescription contains "how" question word → ambiguous_scope', () => {
+        const result = classifyTaskKind({ taskDescription: 'how do I fix this?' });
+        expect(result).toBe('ambiguous_scope');
+    });
+    it('taskDescription contains "should" question word → ambiguous_scope', () => {
+        const result = classifyTaskKind({ taskDescription: 'should I refactor this?' });
+        expect(result).toBe('ambiguous_scope');
+    });
+    it('both taskIntent and taskDescription empty → ambiguous_scope', () => {
+        const result = classifyTaskKind({});
+        expect(result).toBe('ambiguous_scope');
+    });
+    it('taskIntent undefined with taskDescription provided → ambiguous_scope by default', () => {
+        // Ambiguous: intent missing and doesn't match any known category
+        const result = classifyTaskKind({ taskDescription: 'do something specific and clear' });
+        expect(result).toBe('ambiguous_scope');
+    });
+});
+// ─── buildReason tests ────────────────────────────────────────────────────────
+describe('buildReason', () => {
+    it('reader_eligible includes task name and classification', () => {
+        const reason = buildReason('reader_eligible', { taskIntent: 'read_file' });
+        expect(reason).toContain('reader_eligible');
+        expect(reason).toContain('read_file');
+    });
+    it('editor_eligible includes task name and classification', () => {
+        const reason = buildReason('editor_eligible', { taskDescription: 'fix the bug' });
+        expect(reason).toContain('editor_eligible');
+    });
+    it('high_entropy_disallowed with large-scale edit mentions file count', () => {
+        const reason = buildReason('high_entropy_disallowed', {
+            taskIntent: 'edit',
+            requestedFiles: ['a', 'b', 'c', 'd', 'e'],
+        });
+        expect(reason).toContain('high_entropy_disallowed');
+        expect(reason).toContain('5');
+    });
+    it('ambiguous_scope mentions vague/short/question', () => {
+        const reason = buildReason('ambiguous_scope', { taskDescription: 'fix' });
+        expect(reason).toContain('ambiguous_scope');
+    });
+    it('profile_mismatch includes profile incompatibility', () => {
+        const reason = buildReason('profile_mismatch', { taskIntent: 'read' });
+        expect(reason).toContain('profile');
+    });
+    it('deployment_unavailable mentions routing', () => {
+        const reason = buildReason('deployment_unavailable', {});
+        expect(reason).toContain('deployment');
+    });
+    it('uses "(unnamed)" when no intent or description', () => {
+        const reason = buildReason('reader_eligible', {});
+        expect(reason).toContain('(unnamed)');
+    });
+});
+// ─── buildBlockers tests ──────────────────────────────────────────────────────
+describe('buildBlockers', () => {
+    it('reader_eligible → empty blockers', () => {
+        const blockers = buildBlockers('reader_eligible', {});
+        expect(blockers).toEqual([]);
+    });
+    it('editor_eligible → empty blockers', () => {
+        const blockers = buildBlockers('editor_eligible', {});
+        expect(blockers).toEqual([]);
+    });
+    it('high_entropy_disallowed → 2 blockers (keyword trigger, no complexity hint)', () => {
+        const blockers = buildBlockers('high_entropy_disallowed', {});
+        expect(blockers).toHaveLength(2);
+        expect(blockers.some(b => b.includes('high-entropy keywords'))).toBe(true);
+        expect(blockers.some(b => b.includes('main agent'))).toBe(true);
+    });
+    it('high_entropy_disallowed with complexity hint → 3 blockers', () => {
+        const blockers = buildBlockers('high_entropy_disallowed', {
+            taskIntent: 'edit',
+            complexityHints: ['multi_step'],
+        });
+        expect(blockers).toHaveLength(3);
+        expect(blockers.some(b => b.includes('high-entropy keywords'))).toBe(true);
+        expect(blockers.some(b => b.includes('complexity hint'))).toBe(true);
+        expect(blockers.some(b => b.includes('main agent'))).toBe(true);
+    });
+    it('high_entropy_disallowed with large-scale edit → large-scale blocker', () => {
+        const blockers = buildBlockers('high_entropy_disallowed', {
+            taskIntent: 'edit',
+            requestedFiles: ['a', 'b', 'c', 'd', 'e'],
+        });
+        expect(blockers.some(b => b.includes('large-scale'))).toBe(true);
+    });
+    it('ambiguous_scope → 4 blockers', () => {
+        const blockers = buildBlockers('ambiguous_scope', {});
+        expect(blockers).toHaveLength(4);
+    });
+    it('ambiguous_scope includes vague / open-ended / main agent', () => {
+        const blockers = buildBlockers('ambiguous_scope', {});
+        expect(blockers.some(b => b.includes('vague'))).toBe(true);
+        expect(blockers.some(b => b.includes('open-ended'))).toBe(true);
+        expect(blockers.some(b => b.includes('main agent'))).toBe(true);
+    });
+    it('profile_mismatch → 2 blockers', () => {
+        const blockers = buildBlockers('profile_mismatch', {});
+        expect(blockers).toHaveLength(2);
+    });
+    it('deployment_unavailable → 3 blockers', () => {
+        const blockers = buildBlockers('deployment_unavailable', {});
+        expect(blockers).toHaveLength(3);
+    });
+});
+// ─── Immutability ─────────────────────────────────────────────────────────────
+describe('classifyTaskKind — immutability', () => {
+    it('input is not mutated', () => {
+        const input = {
+            taskIntent: 'read',
+            taskDescription: 'read a file',
+            complexityHints: ['simple'],
+        };
+        const inputCopy = JSON.parse(JSON.stringify(input));
+        classifyTaskKind(input);
+        expect(input).toEqual(inputCopy);
+    });
+});
+// ─── RoutingClassification type coverage ──────────────────────────────────────
+describe('RoutingClassification type coverage', () => {
+    it('all 6 classification values are valid', () => {
+        const classifications = [
+            'reader_eligible',
+            'editor_eligible',
+            'high_entropy_disallowed',
+            'ambiguous_scope',
+            'profile_mismatch',
+            'deployment_unavailable',
+        ];
+        for (const c of classifications) {
+            const reason = buildReason(c, { taskIntent: 'test' });
+            const blockers = buildBlockers(c, {});
+            expect(typeof reason).toBe('string');
+            expect(Array.isArray(blockers)).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=routing-guidance.test.js.map