@pennyfarthing/core 11.2.0 → 11.2.1

package/packages/core/dist/shared/capabilities.test.js

@@ -0,0 +1,217 @@
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { detectTeamsCapability, isTeamsEnvVarSet, isInteractiveMode, getTeammateMode, checkTeamsCapability, resolvePhaseExecution, } from './capabilities.js';
+describe('capabilities', () => {
+    // Save and restore env vars between tests
+    const savedEnv = {};
+    beforeEach(() => {
+        savedEnv.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS =
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+    });
+    afterEach(() => {
+        if (savedEnv.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS !== undefined) {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS =
+                savedEnv.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+        }
+        else {
+            delete process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+        }
+    });
+    // =========================================================================
+    // AC1: Check CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS environment variable
+    // =========================================================================
+    describe('isTeamsEnvVarSet', () => {
+        it('should return true when env var is set to "true"', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = 'true';
+            assert.strictEqual(isTeamsEnvVarSet(), true);
+        });
+        it('should return true when env var is set to "1"', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = '1';
+            assert.strictEqual(isTeamsEnvVarSet(), true);
+        });
+        it('should return false when env var is unset', () => {
+            delete process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+            assert.strictEqual(isTeamsEnvVarSet(), false);
+        });
+        it('should return false when env var is "false"', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = 'false';
+            assert.strictEqual(isTeamsEnvVarSet(), false);
+        });
+        it('should return false when env var is empty string', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = '';
+            assert.strictEqual(isTeamsEnvVarSet(), false);
+        });
+        it('should return false when env var is "0"', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = '0';
+            assert.strictEqual(isTeamsEnvVarSet(), false);
+        });
+    });
+    // =========================================================================
+    // AC2: Detect interactive vs -p mode
+    // =========================================================================
+    describe('isInteractiveMode', () => {
+        it('should return a boolean', () => {
+            const result = isInteractiveMode();
+            assert.strictEqual(typeof result, 'boolean');
+        });
+        // Note: Full interactive mode testing requires mocking process.argv
+        // and TTY state. The implementation should check:
+        // - process.argv does not contain '-p'
+        // - process.stdin.isTTY is true
+        // These are environment-dependent and tested via integration tests.
+        // The unit test verifies the function exists and returns boolean.
+    });
+    // =========================================================================
+    // AC3: Detect teammateMode setting
+    // =========================================================================
+    describe('getTeammateMode', () => {
+        it('should return null when no config path is provided and no default exists', () => {
+            // With no config, should return null (not configured)
+            const result = getTeammateMode('/nonexistent/path/config.json');
+            assert.strictEqual(result, null);
+        });
+        it('should return "in-process" or "tmux" when teammateMode is configured', () => {
+            // This test validates the return type constraint
+            const result = getTeammateMode();
+            // Must be one of the valid values or null
+            assert.ok(result === null || result === 'in-process' || result === 'tmux', `Expected null, "in-process", or "tmux" but got: ${result}`);
+        });
+    });
+    // =========================================================================
+    // AC4: Expose detection function returning result object
+    // =========================================================================
+    describe('detectTeamsCapability', () => {
+        it('should return a CapabilityResult with success field', () => {
+            const result = detectTeamsCapability();
+            assert.ok('success' in result, 'Result must have success field');
+            assert.strictEqual(typeof result.success, 'boolean');
+        });
+        it('should return data with all required fields when successful', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = 'true';
+            const result = detectTeamsCapability();
+            assert.strictEqual(result.success, true, 'Should succeed when env var is set');
+            assert.ok(result.data, 'Should have data field on success');
+            const data = result.data;
+            assert.ok('teamsAvailable' in data, 'data must have teamsAvailable');
+            assert.ok('envVarSet' in data, 'data must have envVarSet');
+            assert.ok('isInteractive' in data, 'data must have isInteractive');
+            assert.ok('teammateMode' in data, 'data must have teammateMode');
+        });
+        it('should report envVarSet=true when env var is set', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = 'true';
+            const result = detectTeamsCapability();
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.data.envVarSet, true);
+        });
+        it('should report envVarSet=false when env var is unset', () => {
+            delete process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+            const result = detectTeamsCapability();
+            // Should still succeed (detection itself works), but envVarSet=false
+            assert.strictEqual(result.success, true, 'Detection should always succeed');
+            assert.strictEqual(result.data.envVarSet, false);
+        });
+        it('should include reason when teams are unavailable', () => {
+            delete process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+            const result = detectTeamsCapability();
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.data.teamsAvailable, false);
+            assert.ok(result.data.reason, 'Should provide reason when teams unavailable');
+            assert.strictEqual(typeof result.data.reason, 'string');
+        });
+        it('should not have error field on successful detection', () => {
+            const result = detectTeamsCapability();
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.error, undefined);
+        });
+        it('should detect teamsAvailable=false when env var is missing', () => {
+            delete process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+            const result = detectTeamsCapability();
+            assert.strictEqual(result.data.teamsAvailable, false);
+        });
+    });
+    // =========================================================================
+    // AC5: pennyfarthing doctor reports teams capability status
+    // =========================================================================
+    describe('checkTeamsCapability', () => {
+        it('should return an array of check results', () => {
+            const results = checkTeamsCapability();
+            assert.ok(Array.isArray(results), 'Should return an array');
+            assert.ok(results.length > 0, 'Should return at least one check result');
+        });
+        it('should return results with valid CheckResult shape', () => {
+            const results = checkTeamsCapability();
+            for (const result of results) {
+                assert.ok('name' in result, 'Each result must have name');
+                assert.ok('status' in result, 'Each result must have status');
+                assert.ok(['pass', 'warn', 'fail'].includes(result.status), `Status must be pass/warn/fail, got: ${result.status}`);
+            }
+        });
+        it('should report pass when env var is set', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = 'true';
+            const results = checkTeamsCapability();
+            const envCheck = results.find((r) => r.name.toLowerCase().includes('env') ||
+                r.name.toLowerCase().includes('teams'));
+            assert.ok(envCheck, 'Should have a check for teams env var');
+            assert.strictEqual(envCheck.status, 'pass');
+        });
+        it('should report warn when env var is not set', () => {
+            delete process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+            const results = checkTeamsCapability();
+            const envCheck = results.find((r) => r.name.toLowerCase().includes('env') ||
+                r.name.toLowerCase().includes('teams'));
+            assert.ok(envCheck, 'Should have a check for teams env var');
+            assert.strictEqual(envCheck.status, 'warn', 'Missing env var should be a warning, not failure');
+        });
+        it('should include detail message in each result', () => {
+            const results = checkTeamsCapability();
+            for (const result of results) {
+                assert.ok(result.detail, `Check "${result.name}" should have a detail message`);
+            }
+        });
+    });
+    // =========================================================================
+    // AC6: Graceful degradation for phases with team: block
+    // =========================================================================
+    describe('resolvePhaseExecution', () => {
+        it('should return team mode when teams are available and phase has team block', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = 'true';
+            const phaseConfig = {
+                team: { agents: ['tea', 'architect'], strategy: 'parallel' },
+            };
+            const result = resolvePhaseExecution(phaseConfig);
+            assert.strictEqual(result.mode, 'team');
+            assert.strictEqual(result.degraded, false);
+        });
+        it('should degrade to solo-tandem when teams unavailable but phase has team block', () => {
+            delete process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+            const phaseConfig = {
+                team: { agents: ['tea', 'architect'], strategy: 'parallel' },
+            };
+            const result = resolvePhaseExecution(phaseConfig);
+            assert.strictEqual(result.mode, 'solo-tandem');
+            assert.strictEqual(result.degraded, true);
+            assert.ok(result.reason, 'Should explain why degradation occurred');
+        });
+        it('should return solo mode when phase has no team block', () => {
+            const phaseConfig = {};
+            const result = resolvePhaseExecution(phaseConfig);
+            assert.strictEqual(result.mode, 'solo');
+            assert.strictEqual(result.degraded, false);
+        });
+        it('should not mark as degraded when phase has no team block regardless of capability', () => {
+            process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = 'true';
+            const phaseConfig = {};
+            const result = resolvePhaseExecution(phaseConfig);
+            assert.strictEqual(result.degraded, false);
+        });
+        it('should include reason string when degraded', () => {
+            delete process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+            const phaseConfig = { team: { agents: ['dev'] } };
+            const result = resolvePhaseExecution(phaseConfig);
+            assert.strictEqual(result.degraded, true);
+            assert.strictEqual(typeof result.reason, 'string');
+            assert.ok(result.reason.length > 0, 'Reason should not be empty');
+        });
+    });
+});
+//# sourceMappingURL=capabilities.test.js.map

package/packages/core/dist/shared/capabilities.test.js.map

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

package/packages/core/dist/shared/spawn-prompt.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Spawn prompt builder for native Agent Teams.
+ *
+ * Generates lightweight spawn prompts for teammate activation.
+ * Prompts invoke `pf agent start {agent}` for full Prime activation,
+ * keeping the prompt under 500 tokens. Teammates get persona, sidecars,
+ * and session context from Prime — not from prompt injection.
+ *
+ * @module spawn-prompt
+ */
+/** Valid core agent names */
+export declare const CORE_AGENTS: readonly string[];
+/** Configuration for building a spawn prompt */
+export interface SpawnPromptConfig {
+    agent: string;
+    storyId: string;
+    task: string;
+    phase: string;
+    sessionFile?: string;
+}
+/** Result of spawn prompt generation */
+export interface SpawnPromptResult {
+    success: boolean;
+    prompt?: string;
+    tokenEstimate?: number;
+    error?: string;
+}
+/** Result of spawn prompt validation */
+export interface SpawnPromptValidation {
+    valid: boolean;
+    tokenCount: number;
+    errors: string[];
+}
+/**
+ * Build a spawn prompt for teammate activation.
+ */
+export declare function buildSpawnPrompt(config: SpawnPromptConfig): SpawnPromptResult;
+/**
+ * Estimate token count for a text string.
+ * Uses the ~4 chars per token heuristic.
+ */
+export declare function estimateTokenCount(text: string): number;
+/**
+ * Validate a spawn prompt against constraints.
+ */
+export declare function validateSpawnPrompt(prompt: string): SpawnPromptValidation;
+//# sourceMappingURL=spawn-prompt.d.ts.map

package/packages/core/dist/shared/spawn-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-prompt.d.ts","sourceRoot":"","sources":["../../src/shared/spawn-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6BAA6B;AAC7B,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAI/B,CAAC;AAEX,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAsC7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAiBzE"}

package/packages/core/dist/shared/spawn-prompt.js

@@ -0,0 +1,82 @@
+/**
+ * Spawn prompt builder for native Agent Teams.
+ *
+ * Generates lightweight spawn prompts for teammate activation.
+ * Prompts invoke `pf agent start {agent}` for full Prime activation,
+ * keeping the prompt under 500 tokens. Teammates get persona, sidecars,
+ * and session context from Prime — not from prompt injection.
+ *
+ * @module spawn-prompt
+ */
+/** Valid core agent names */
+export const CORE_AGENTS = [
+    'sm', 'tea', 'dev', 'reviewer', 'architect',
+    'pm', 'tech-writer', 'ux-designer', 'devops',
+    'orchestrator', 'ba',
+];
+const TOKEN_LIMIT = 500;
+const MAX_TASK_CHARS = 1200;
+/**
+ * Build a spawn prompt for teammate activation.
+ */
+export function buildSpawnPrompt(config) {
+    const { agent, storyId, task, phase, sessionFile } = config;
+    if (!agent) {
+        return { success: false, error: 'agent is required' };
+    }
+    if (!storyId) {
+        return { success: false, error: 'storyId is required' };
+    }
+    if (!task) {
+        return { success: false, error: 'task is required' };
+    }
+    if (!CORE_AGENTS.includes(agent)) {
+        return { success: false, error: `Unknown agent "${agent}". Valid agents: ${CORE_AGENTS.join(', ')}` };
+    }
+    const session = sessionFile || `.session/${storyId}-session.md`;
+    const truncatedTask = task.length > MAX_TASK_CHARS
+        ? task.slice(0, MAX_TASK_CHARS) + '...'
+        : task;
+    const prompt = [
+        `**FIRST:** Run this command to activate:`,
+        '```bash',
+        `pf agent start "${agent}"`,
+        '```',
+        '',
+        `**Story:** ${storyId}`,
+        `**Phase:** ${phase}`,
+        `**Task:** ${truncatedTask}`,
+        '',
+        `Read the session file at \`${session}\` for full workflow state and context.`,
+    ].join('\n');
+    const tokenEstimate = estimateTokenCount(prompt);
+    return { success: true, prompt, tokenEstimate };
+}
+/**
+ * Estimate token count for a text string.
+ * Uses the ~4 chars per token heuristic.
+ */
+export function estimateTokenCount(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Validate a spawn prompt against constraints.
+ */
+export function validateSpawnPrompt(prompt) {
+    const errors = [];
+    const tokenCount = estimateTokenCount(prompt);
+    if (tokenCount > TOKEN_LIMIT) {
+        errors.push(`Prompt exceeds token limit: ${tokenCount} > ${TOKEN_LIMIT}`);
+    }
+    if (!prompt.includes('pf agent start')) {
+        errors.push('Missing activation command (pf agent start)');
+    }
+    return {
+        valid: errors.length === 0,
+        tokenCount,
+        errors,
+    };
+}
+//# sourceMappingURL=spawn-prompt.js.map

package/packages/core/dist/shared/spawn-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-prompt.js","sourceRoot":"","sources":["../../src/shared/spawn-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW;IAC3C,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ;IAC5C,cAAc,EAAE,IAAI;CACZ,CAAC;AA0BX,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAyB;IACxD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,KAAK,oBAAoB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACxG,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,IAAI,YAAY,OAAO,aAAa,CAAC;IAChE,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,GAAG,cAAc;QAChD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,KAAK;QACvC,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,MAAM,GAAG;QACb,0CAA0C;QAC1C,SAAS;QACT,mBAAmB,KAAK,GAAG;QAC3B,KAAK;QACL,EAAE;QACF,cAAc,OAAO,EAAE;QACvB,cAAc,KAAK,EAAE;QACrB,aAAa,aAAa,EAAE;QAC5B,EAAE;QACF,8BAA8B,OAAO,yCAAyC;KAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE9C,IAAI,UAAU,GAAG,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,+BAA+B,UAAU,MAAM,WAAW,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,UAAU;QACV,MAAM;KACP,CAAC;AACJ,CAAC"}

package/packages/core/dist/shared/spawn-prompt.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spawn-prompt.test.d.ts.map

package/packages/core/dist/shared/spawn-prompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-prompt.test.d.ts","sourceRoot":"","sources":["../../src/shared/spawn-prompt.test.ts"],"names":[],"mappings":""}

package/packages/core/dist/shared/spawn-prompt.test.js

@@ -0,0 +1,251 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { buildSpawnPrompt, estimateTokenCount, validateSpawnPrompt, CORE_AGENTS, } from './spawn-prompt.js';
+describe('spawn-prompt', () => {
+    // Helper: valid config for reuse across tests
+    const validConfig = {
+        agent: 'dev',
+        storyId: '86-8',
+        task: 'Implement the buildSpawnPrompt function',
+        phase: 'green',
+        sessionFile: '.session/86-8-session.md',
+    };
+    // =========================================================================
+    // AC1: Spawn prompt runs `pf agent start {agent}` for full Prime activation
+    // =========================================================================
+    describe('AC1: Prime activation command', () => {
+        it('should include pf agent start command in the prompt', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true, 'Should succeed with valid config');
+            assert.ok(result.prompt, 'Should have prompt text');
+            assert.ok(result.prompt.includes('pf agent start'), 'Prompt must include pf agent start command');
+        });
+        it('should include the specific agent name in the activation command', () => {
+            const result = buildSpawnPrompt({ ...validConfig, agent: 'tea' });
+            assert.strictEqual(result.success, true);
+            assert.ok(result.prompt.includes('pf agent start "tea"') ||
+                result.prompt.includes("pf agent start 'tea'") ||
+                result.prompt.includes('pf agent start tea'), `Prompt must reference the agent name in activation command, got: ${result.prompt}`);
+        });
+        it('should place activation command prominently (not buried in middle)', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            // Activation command should appear in the first half of the prompt
+            const prompt = result.prompt;
+            const cmdIndex = prompt.indexOf('pf agent start');
+            assert.ok(cmdIndex < prompt.length / 2, 'Activation command should appear in the first half of the prompt');
+        });
+    });
+    // =========================================================================
+    // AC2: Spawn prompt includes story ID, task assignment, phase context
+    // =========================================================================
+    describe('AC2: Required context in prompt', () => {
+        it('should include the story ID in the prompt', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.prompt.includes('86-8'), 'Prompt must include story ID');
+        });
+        it('should include the task assignment in the prompt', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.prompt.includes('Implement the buildSpawnPrompt function'), 'Prompt must include task description');
+        });
+        it('should include the phase context in the prompt', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.prompt.includes('green'), 'Prompt must include phase name');
+        });
+        it('should include the session file path when provided', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.prompt.includes('.session/86-8-session.md'), 'Prompt must include session file path when provided');
+        });
+        it('should return error when agent is missing', () => {
+            const result = buildSpawnPrompt({
+                ...validConfig,
+                agent: '',
+            });
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error, 'Should have error message');
+        });
+        it('should return error when storyId is missing', () => {
+            const result = buildSpawnPrompt({
+                ...validConfig,
+                storyId: '',
+            });
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error, 'Should have error message');
+        });
+        it('should return error when task is missing', () => {
+            const result = buildSpawnPrompt({
+                ...validConfig,
+                task: '',
+            });
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error, 'Should have error message');
+        });
+    });
+    // =========================================================================
+    // AC3: Teammates activate via Prime, not prompt injection
+    // =========================================================================
+    describe('AC3: No prompt injection of context', () => {
+        it('should NOT contain inline persona definitions', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            const prompt = result.prompt.toLowerCase();
+            // Should not embed persona XML tags or character definitions
+            assert.ok(!prompt.includes('<persona'), 'Prompt must NOT contain inline persona definitions');
+        });
+        it('should NOT contain inline sidecar content', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            const prompt = result.prompt.toLowerCase();
+            assert.ok(!prompt.includes('<pattern'), 'Prompt must NOT contain inline sidecar patterns');
+            assert.ok(!prompt.includes('<gotcha'), 'Prompt must NOT contain inline sidecar gotchas');
+        });
+        it('should NOT contain inline agent behavior guide', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            const prompt = result.prompt;
+            // The agent-behavior guide is large — prompt should NOT embed it
+            assert.ok(!prompt.includes('<agent-exit-protocol>'), 'Prompt must NOT contain inline agent behavior guide');
+        });
+        it('should rely on pf agent start for context loading', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            // Must have the activation command — that IS the context loading mechanism
+            assert.ok(result.prompt.includes('pf agent start'), 'Must use pf agent start for context loading');
+        });
+    });
+    // =========================================================================
+    // AC4: Spawn prompt stays under 500 tokens
+    // =========================================================================
+    describe('AC4: Token budget constraint', () => {
+        it('should include token estimate in result', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            assert.ok(typeof result.tokenEstimate === 'number', 'Result must include token estimate');
+            assert.ok(result.tokenEstimate > 0, 'Token estimate must be positive');
+        });
+        it('should generate prompt under 500 tokens', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.tokenEstimate <= 500, `Prompt must be under 500 tokens, got ${result.tokenEstimate}`);
+        });
+        it('should stay under 500 tokens even with long task descriptions', () => {
+            const longTask = 'Implement comprehensive error handling across all API endpoints including retry logic, circuit breakers, and graceful degradation with user-facing error messages that are helpful but not leaking implementation details';
+            const result = buildSpawnPrompt({
+                ...validConfig,
+                task: longTask,
+            });
+            assert.strictEqual(result.success, true);
+            assert.ok(result.tokenEstimate <= 500, `Prompt with long task must still be under 500 tokens, got ${result.tokenEstimate}`);
+        });
+        it('estimateTokenCount should return reasonable estimate for known text', () => {
+            // "hello world" is 2 tokens in most tokenizers, ~11 chars / 4 ≈ 2-3
+            const estimate = estimateTokenCount('hello world');
+            assert.ok(estimate > 0, 'Should return positive number');
+            assert.ok(estimate < 10, 'Should be reasonable for short text');
+        });
+        it('estimateTokenCount should return 0 for empty string', () => {
+            assert.strictEqual(estimateTokenCount(''), 0);
+        });
+    });
+    // =========================================================================
+    // AC5: Works with all core agents
+    // =========================================================================
+    describe('AC5: All core agents supported', () => {
+        const expectedAgents = [
+            'sm', 'tea', 'dev', 'reviewer', 'architect',
+            'pm', 'tech-writer', 'ux-designer', 'devops',
+            'orchestrator', 'ba',
+        ];
+        it('should export CORE_AGENTS array with all core agents', () => {
+            assert.ok(Array.isArray(CORE_AGENTS), 'CORE_AGENTS must be an array');
+            for (const agent of expectedAgents) {
+                assert.ok(CORE_AGENTS.includes(agent), `CORE_AGENTS must include "${agent}"`);
+            }
+        });
+        it('should have at least 10 core agents', () => {
+            assert.ok(CORE_AGENTS.length >= 10, `Expected at least 10 core agents, got ${CORE_AGENTS.length}`);
+        });
+        for (const agent of expectedAgents) {
+            it(`should build prompt successfully for agent: ${agent}`, () => {
+                const result = buildSpawnPrompt({
+                    ...validConfig,
+                    agent,
+                });
+                assert.strictEqual(result.success, true, `Should succeed for agent "${agent}", got error: ${result.error}`);
+                assert.ok(result.prompt, `Should produce prompt for agent "${agent}"`);
+            });
+        }
+        it('should reject unknown agent names', () => {
+            const result = buildSpawnPrompt({
+                ...validConfig,
+                agent: 'nonexistent-agent',
+            });
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error?.toLowerCase().includes('unknown') ||
+                result.error?.toLowerCase().includes('invalid') ||
+                result.error?.toLowerCase().includes('not'), `Should indicate unknown agent, got: ${result.error}`);
+        });
+    });
+    // =========================================================================
+    // AC6: Teammate correctly reads session file and workflow state
+    // =========================================================================
+    describe('AC6: Session file and workflow state reference', () => {
+        it('should instruct teammate to read the session file', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            const prompt = result.prompt.toLowerCase();
+            assert.ok(prompt.includes('session') && prompt.includes('read'), 'Prompt should instruct teammate to read the session file');
+        });
+        it('should reference the workflow state', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            const prompt = result.prompt.toLowerCase();
+            assert.ok(prompt.includes('workflow') || prompt.includes('phase'), 'Prompt should reference workflow state or phase');
+        });
+        it('should work without explicit sessionFile (uses convention)', () => {
+            const config = {
+                agent: 'dev',
+                storyId: '86-8',
+                task: 'Implement feature',
+                phase: 'green',
+                // no sessionFile
+            };
+            const result = buildSpawnPrompt(config);
+            assert.strictEqual(result.success, true);
+            // Should derive session file path from storyId convention
+            assert.ok(result.prompt.includes('.session/86-8-session.md') ||
+                result.prompt.includes('session'), 'Should reference session file even without explicit path');
+        });
+    });
+    // =========================================================================
+    // validateSpawnPrompt
+    // =========================================================================
+    describe('validateSpawnPrompt', () => {
+        it('should validate a well-formed prompt as valid', () => {
+            const result = buildSpawnPrompt(validConfig);
+            assert.strictEqual(result.success, true);
+            const validation = validateSpawnPrompt(result.prompt);
+            assert.strictEqual(validation.valid, true);
+            assert.strictEqual(validation.errors.length, 0);
+        });
+        it('should reject prompt exceeding 500 tokens', () => {
+            // Create an artificially long prompt (500 tokens ≈ 2000 chars)
+            const longPrompt = 'x'.repeat(2500);
+            const validation = validateSpawnPrompt(longPrompt);
+            assert.strictEqual(validation.valid, false);
+            assert.ok(validation.tokenCount > 500);
+            assert.ok(validation.errors.some((e) => e.toLowerCase().includes('token')), 'Should report token limit violation');
+        });
+        it('should reject prompt missing activation command', () => {
+            const badPrompt = 'Just do the task for story 86-8';
+            const validation = validateSpawnPrompt(badPrompt);
+            assert.strictEqual(validation.valid, false);
+            assert.ok(validation.errors.some((e) => e.toLowerCase().includes('activation') || e.toLowerCase().includes('pf agent')), 'Should report missing activation command');
+        });
+    });
+});
+//# sourceMappingURL=spawn-prompt.test.js.map