hungry-ghost-hive 0.45.0 → 0.46.0

package/src/orchestrator/prompt-templates.test.ts

@@ -164,6 +164,82 @@ describe('Prompt Templates', () => {
       expect(prompt).toContain('complexity: ?');
     });
 
+    it('should include markdown_path in prompt when set on a story', () => {
+      const stories: StoryRow[] = [
+        {
+          id: 'STORY-003',
+          title: 'Story With Markdown',
+          description: 'DB description',
+          complexity_score: 3,
+          status: 'planned',
+          team_id: 'team-1',
+          requirement_id: null,
+          acceptance_criteria: null,
+          story_points: null,
+          assigned_agent_id: null,
+          branch_name: null,
+          pr_url: null,
+          jira_issue_key: null,
+          jira_issue_id: null,
+          jira_project_key: null,
+          jira_subtask_key: null,
+          jira_subtask_id: null,
+          external_issue_key: null,
+          external_issue_id: null,
+          external_project_key: null,
+          external_subtask_key: null,
+          external_subtask_id: null,
+          external_provider: null,
+          in_sprint: 0,
+          markdown_path: '/stories/STORY-003.md',
+          created_at: '2024-01-01',
+          updated_at: '2024-01-01',
+        },
+      ];
+      const prompt = generateSeniorPrompt(teamName, repoUrl, repoPath, stories);
+
+      expect(prompt).toContain('/stories/STORY-003.md');
+      expect(prompt).toContain('read the story markdown file');
+    });
+
+    it('should fall back to DB description when markdown_path is null', () => {
+      const stories: StoryRow[] = [
+        {
+          id: 'STORY-004',
+          title: 'Story Without Markdown',
+          description: 'DB only description',
+          complexity_score: 2,
+          status: 'planned',
+          team_id: 'team-1',
+          requirement_id: null,
+          acceptance_criteria: null,
+          story_points: null,
+          assigned_agent_id: null,
+          branch_name: null,
+          pr_url: null,
+          jira_issue_key: null,
+          jira_issue_id: null,
+          jira_project_key: null,
+          jira_subtask_key: null,
+          jira_subtask_id: null,
+          external_issue_key: null,
+          external_issue_id: null,
+          external_project_key: null,
+          external_subtask_key: null,
+          external_subtask_id: null,
+          external_provider: null,
+          in_sprint: 0,
+          markdown_path: null,
+          created_at: '2024-01-01',
+          updated_at: '2024-01-01',
+        },
+      ];
+      const prompt = generateSeniorPrompt(teamName, repoUrl, repoPath, stories);
+
+      expect(prompt).toContain('DB only description');
+      expect(prompt).not.toContain('read the story markdown file');
+    });
+
     it('should handle empty stories list', () => {
       const stories: StoryRow[] = [];
       const prompt = generateSeniorPrompt(teamName, repoUrl, repoPath, stories);
@@ -814,3 +890,190 @@ describe('Prompt Templates', () => {
     });
   });
 });
+
+describe('Chrome Tab Isolation', () => {
+  const teamName = 'TestTeam';
+  const repoUrl = 'https://github.com/test/repo.git';
+  const repoPath = 'repos/test-repo';
+  const sessionName = 'hive-test-session';
+
+  const CHROME_TAB_MARKER = 'Chrome Browser Tab Isolation';
+  const CHROME_TAB_CREATE = 'tabs_create_mcp';
+
+  describe('generateSeniorPrompt', () => {
+    it('should include chrome tab isolation section when chromeEnabled is true', () => {
+      const prompt = generateSeniorPrompt(teamName, repoUrl, repoPath, [], 'main', {
+        chromeEnabled: true,
+      });
+      expect(prompt).toContain(CHROME_TAB_MARKER);
+      expect(prompt).toContain(CHROME_TAB_CREATE);
+    });
+
+    it('should not include chrome tab isolation section when chromeEnabled is false', () => {
+      const prompt = generateSeniorPrompt(teamName, repoUrl, repoPath, [], 'main', {
+        chromeEnabled: false,
+      });
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+
+    it('should not include chrome tab isolation section when chromeEnabled is not set', () => {
+      const prompt = generateSeniorPrompt(teamName, repoUrl, repoPath, []);
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+  });
+
+  describe('generateIntermediatePrompt', () => {
+    it('should include chrome tab isolation section when chromeEnabled is true', () => {
+      const prompt = generateIntermediatePrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: true,
+      });
+      expect(prompt).toContain(CHROME_TAB_MARKER);
+      expect(prompt).toContain(CHROME_TAB_CREATE);
+    });
+
+    it('should not include chrome tab isolation section when chromeEnabled is false', () => {
+      const prompt = generateIntermediatePrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: false,
+      });
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+
+    it('should not include chrome tab isolation section when options not provided', () => {
+      const prompt = generateIntermediatePrompt(teamName, repoUrl, repoPath, sessionName);
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+  });
+
+  describe('generateJuniorPrompt', () => {
+    it('should include chrome tab isolation section when chromeEnabled is true', () => {
+      const prompt = generateJuniorPrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: true,
+      });
+      expect(prompt).toContain(CHROME_TAB_MARKER);
+      expect(prompt).toContain(CHROME_TAB_CREATE);
+    });
+
+    it('should not include chrome tab isolation section when chromeEnabled is false', () => {
+      const prompt = generateJuniorPrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: false,
+      });
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+
+    it('should not include chrome tab isolation section when options not provided', () => {
+      const prompt = generateJuniorPrompt(teamName, repoUrl, repoPath, sessionName);
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+  });
+
+  describe('generateQAPrompt', () => {
+    it('should include chrome tab isolation section when chromeEnabled is true', () => {
+      const prompt = generateQAPrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: true,
+      });
+      expect(prompt).toContain(CHROME_TAB_MARKER);
+      expect(prompt).toContain(CHROME_TAB_CREATE);
+    });
+
+    it('should not include chrome tab isolation section when chromeEnabled is false', () => {
+      const prompt = generateQAPrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: false,
+      });
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+
+    it('should not include chrome tab isolation section when options not provided', () => {
+      const prompt = generateQAPrompt(teamName, repoUrl, repoPath, sessionName);
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+  });
+
+  describe('generateFeatureTestPrompt', () => {
+    it('should include chrome tab isolation section when chromeEnabled is true', () => {
+      const prompt = generateFeatureTestPrompt(
+        teamName,
+        repoUrl,
+        repoPath,
+        sessionName,
+        'feature/test',
+        'REQ-001',
+        'e2e/tests',
+        { chromeEnabled: true }
+      );
+      expect(prompt).toContain(CHROME_TAB_MARKER);
+      expect(prompt).toContain(CHROME_TAB_CREATE);
+    });
+
+    it('should not include chrome tab isolation section when chromeEnabled is false', () => {
+      const prompt = generateFeatureTestPrompt(
+        teamName,
+        repoUrl,
+        repoPath,
+        sessionName,
+        'feature/test',
+        'REQ-001',
+        'e2e/tests',
+        { chromeEnabled: false }
+      );
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+
+    it('should not include chrome tab isolation section when options not provided', () => {
+      const prompt = generateFeatureTestPrompt(
+        teamName,
+        repoUrl,
+        repoPath,
+        sessionName,
+        'feature/test',
+        'REQ-001',
+        'e2e/tests'
+      );
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+  });
+
+  describe('generateAuditorPrompt', () => {
+    it('should include chrome tab isolation section when chromeEnabled is true', () => {
+      const prompt = generateAuditorPrompt(sessionName, repoPath, repoUrl, {
+        chromeEnabled: true,
+      });
+      expect(prompt).toContain(CHROME_TAB_MARKER);
+      expect(prompt).toContain(CHROME_TAB_CREATE);
+    });
+
+    it('should not include chrome tab isolation section when chromeEnabled is false', () => {
+      const prompt = generateAuditorPrompt(sessionName, repoPath, repoUrl, {
+        chromeEnabled: false,
+      });
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+
+    it('should not include chrome tab isolation section when options not provided', () => {
+      const prompt = generateAuditorPrompt(sessionName, repoPath, repoUrl);
+      expect(prompt).not.toContain(CHROME_TAB_MARKER);
+    });
+  });
+
+  describe('tab isolation instructions content', () => {
+    it('should instruct agents to store and reuse tab ID', () => {
+      const prompt = generateIntermediatePrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: true,
+      });
+      expect(prompt).toContain('tab ID');
+    });
+
+    it('should instruct agents to recreate tab when closed externally', () => {
+      const prompt = generateIntermediatePrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: true,
+      });
+      expect(prompt).toContain('closed externally');
+    });
+
+    it('should warn agents not to use other agents tabs', () => {
+      const prompt = generateIntermediatePrompt(teamName, repoUrl, repoPath, sessionName, 'main', {
+        chromeEnabled: true,
+      });
+      expect(prompt).toContain('Never interact with tabs you did not create');
+    });
+  });
+});

package/src/orchestrator/prompt-templates.ts

@@ -6,6 +6,8 @@ export interface AgentPromptOptions {
   includeProgressUpdates?: boolean;
   /** The tech lead tmux session name for messaging. Defaults to 'hive-tech-lead' for backwards compatibility. */
   techLeadSession?: string;
+  /** Whether Chrome browser tools are enabled for this agent session. */
+  chromeEnabled?: boolean;
 }
 
 /**
@@ -66,6 +68,35 @@ function resolveTechLeadSession(options?: AgentPromptOptions): string {
   return options?.techLeadSession || 'hive-tech-lead';
 }
 
+/**
+ * Generate the Chrome tab isolation section for agent prompts.
+ * Instructs agents to create a dedicated tab at session start and use it
+ * exclusively for all browser operations, preventing tab interference between
+ * concurrent agents.
+ */
+function chromeTabIsolationSection(): string {
+  return `# Chrome Browser Tab Isolation
+Chrome browser tools are enabled for this session. Each agent must use its own dedicated tab to prevent interference with other agents running concurrently.
+
+## Tab Lifecycle
+
+**At session start**, create your dedicated tab immediately:
+\`\`\`
+Use mcp__claude-in-chrome__tabs_create_mcp to create a new tab.
+Store the returned tab ID — you will use it for all browser operations.
+\`\`\`
+
+**For all browser operations**, always pass your stored tab ID to every \`mcp__claude-in-chrome__*\` tool call. Never interact with tabs you did not create.
+
+**If your tab is closed externally** (tool returns a tab-not-found error):
+\`\`\`
+Call mcp__claude-in-chrome__tabs_create_mcp again to get a new tab ID.
+Update your stored tab ID and continue.
+\`\`\`
+
+**At session end**, close your tab using the browser tools to free resources.`;
+}
+
 function repositorySection(repoPath: string, repoUrl: string): string {
   return `## Your Repository
 - Local path: ${repoPath}
@@ -243,15 +274,19 @@ export function generateSeniorPrompt(
       const externalInfo = s.external_subtask_key
         ? ` | External Subtask: ${s.external_subtask_key}`
         : '';
-      return `- [${s.id}] ${s.title} (complexity: ${s.complexity_score || '?'}${externalInfo})\n  ${s.description}`;
+      const descriptionOrMarkdown = s.markdown_path
+        ? `For full details, read the story markdown file: \`${s.markdown_path}\``
+        : s.description;
+      return `- [${s.id}] ${s.title} (complexity: ${s.complexity_score || '?'}${externalInfo})\n  ${descriptionOrMarkdown}`;
     })
     .join('\n\n');
 
   const sessionName = sessionNameOverride || formatSeniorSessionName(teamName);
+  const chromeSection = options?.chromeEnabled ? '\n\n' + chromeTabIsolationSection() : '';
 
   return `You are a Senior Developer on Team ${teamName}.
 Your tmux session: ${sessionName}
-
+${chromeSection}
 ${repositorySection(repoPath, repoUrl)}
 
 ## Your Responsibilities
@@ -327,10 +362,11 @@ export function generateIntermediatePrompt(
   const includeProgressUpdates = shouldIncludeProgressUpdates(options);
   const techLeadSession = resolveTechLeadSession(options);
   const seniorSession = formatSeniorSessionName(teamName);
+  const chromeSection = options?.chromeEnabled ? '\n\n' + chromeTabIsolationSection() : '';
 
   return `You are an Intermediate Developer on Team ${teamName}.
 Your tmux session: ${sessionName}
-
+${chromeSection}
 ${repositorySection(repoPath, repoUrl)}
 
 ## Your Responsibilities
@@ -399,10 +435,11 @@ export function generateJuniorPrompt(
   const includeProgressUpdates = shouldIncludeProgressUpdates(options);
   const techLeadSession = resolveTechLeadSession(options);
   const seniorSession = formatSeniorSessionName(teamName);
+  const chromeSection = options?.chromeEnabled ? '\n\n' + chromeTabIsolationSection() : '';
 
   return `You are a Junior Developer on Team ${teamName}.
 Your tmux session: ${sessionName}
-
+${chromeSection}
 ${repositorySection(repoPath, repoUrl)}
 
 ## Your Responsibilities
@@ -465,11 +502,13 @@ export function generateQAPrompt(
   repoUrl: string,
   repoPath: string,
   sessionName: string,
-  targetBranch: string = 'main'
+  targetBranch: string = 'main',
+  options?: AgentPromptOptions
 ): string {
+  const chromeSection = options?.chromeEnabled ? '\n\n' + chromeTabIsolationSection() : '';
   return `You are a QA Engineer on Team ${teamName}.
 Your tmux session: ${sessionName}
-
+${chromeSection}
 ${repositorySection(repoPath, repoUrl)}
 
 ## Your Responsibilities
@@ -567,6 +606,7 @@ export function generateFeatureTestPrompt(
 ): string {
   const includeProgressUpdates = shouldIncludeProgressUpdates(options);
   const techLeadSession = resolveTechLeadSession(options);
+  const chromeSection = options?.chromeEnabled ? '\n\n' + chromeTabIsolationSection() : '';
   const reportResultsSection = includeProgressUpdates
     ? `**If all tests pass:**
 \`\`\`bash
@@ -592,7 +632,7 @@ hive msg send ${techLeadSession} "E2E tests FAILED for ${requirementId} on ${fea
 
   return `You are a Feature Test Agent on Team ${teamName}.
 Your tmux session: ${sessionName}
-
+${chromeSection}
 ${repositorySection(repoPath, repoUrl)}
 
 ## Your Mission
@@ -670,9 +710,10 @@ export function generateAuditorPrompt(
   options?: AgentPromptOptions
 ): string {
   const techLeadSession = resolveTechLeadSession(options);
+  const chromeSection = options?.chromeEnabled ? '\n\n' + chromeTabIsolationSection() : '';
   return `You are a Hive Auditor Agent.
 Your tmux session: ${sessionName}
-
+${chromeSection}
 ${repositorySection(repoPath, repoUrl)}
 
 ## Your Mission

package/src/orchestrator/scheduler.test.ts

@@ -1,8 +1,11 @@
 // Licensed under the Hungry Ghost Hive License. See LICENSE.
 
+import { existsSync, mkdirSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
 import type { Database } from 'sql.js';
 import initSqlJs from 'sql.js';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { getLogsByEventType } from '../db/queries/logs.js';
 import { createPullRequest } from '../db/queries/pull-requests.js';
@@ -17,6 +20,7 @@ import {
 import { createTeam } from '../db/queries/teams.js';
 import * as worktreeModule from '../git/worktree.js';
 import * as tmuxModule from '../tmux/manager.js';
+import { generateSessionName } from '../tmux/manager.js';
 import { getAgentWorkload, selectAgentWithLeastWorkload } from './agent-selector.js';
 import {
   getCapacityPoints,
@@ -107,13 +111,15 @@ CREATE TABLE IF NOT EXISTS teams (
 
 CREATE TABLE IF NOT EXISTS agents (
     id TEXT PRIMARY KEY,
-    type TEXT NOT NULL CHECK (type IN ('tech_lead', 'senior', 'intermediate', 'junior', 'qa')),
+    type TEXT NOT NULL CHECK (type IN ('tech_lead', 'senior', 'intermediate', 'junior', 'qa', 'feature_test', 'auditor')),
     team_id TEXT REFERENCES teams(id),
     tmux_session TEXT,
     model TEXT,
     status TEXT DEFAULT 'idle' CHECK (status IN ('idle', 'working', 'blocked', 'terminated')),
     current_story_id TEXT,
     memory_state TEXT,
+    last_seen TIMESTAMP,
+    worktree_path TEXT,
     created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
     updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
 );
@@ -141,6 +147,7 @@ CREATE TABLE IF NOT EXISTS stories (
     assigned_agent_id TEXT REFERENCES agents(id),
     branch_name TEXT,
     pr_url TEXT,
+    markdown_path TEXT,
     created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
     updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
 );
@@ -793,6 +800,50 @@ describe('Scheduler Orphaned Story Recovery', () => {
     expect(recovered).toContain(story1.id);
     expect(recovered).toContain(story2.id);
   });
+
+  it('should write markdown files when storiesDir is provided during orphan recovery', () => {
+    const storiesDir = join(tmpdir(), `hive-test-stories-${Date.now()}`);
+    mkdirSync(storiesDir, { recursive: true });
+
+    try {
+      const team = createTeam(db, {
+        name: 'MD Test Team',
+        repoUrl: 'https://github.com/test/repo',
+        repoPath: 'test',
+      });
+
+      const terminatedAgentId = 'agent-md-terminated';
+      db.run(
+        `INSERT INTO agents (id, type, team_id, status, created_at, updated_at)
+         VALUES (?, ?, ?, ?, datetime('now'), datetime('now'))`,
+        [terminatedAgentId, 'intermediate', team.id, 'terminated']
+      );
+
+      const story = createStory(db, {
+        teamId: team.id,
+        title: 'Story with Markdown',
+        description: 'Should get a markdown file on recovery',
+      });
+      updateStory(db, story.id, {
+        assignedAgentId: terminatedAgentId,
+        status: 'in_progress',
+      });
+
+      const recovered = detectAndRecoverOrphanedStories(db, '/tmp', storiesDir);
+
+      expect(recovered).toContain(story.id);
+
+      // Verify markdown file was written
+      const mdPath = join(storiesDir, `${story.id}.md`);
+      expect(existsSync(mdPath)).toBe(true);
+
+      // Verify markdown_path was set in DB
+      const updatedStory = getStoryById(db, story.id);
+      expect(updatedStory?.markdown_path).toBe(mdPath);
+    } finally {
+      rmSync(storiesDir, { recursive: true, force: true });
+    }
+  });
 });
 
 describe('Scheduler Refactor Capacity Policy', () => {
@@ -1905,6 +1956,9 @@ describe('Scheduler checkScaling', () => {
       repoPath: 'test',
     });
 
+    const gapHiveDir = join(mockConfig.rootDir, '.hive');
+    const gapSessionPrefix = generateSessionName('senior', team.name, undefined, gapHiveDir);
+
     for (const index of [2, 3, 4, 5]) {
       db.run(
         `INSERT INTO agents (id, type, team_id, tmux_session, status, current_story_id, created_at, updated_at)
@@ -1913,7 +1967,7 @@ describe('Scheduler checkScaling', () => {
           `senior-gap-${index}`,
           'senior',
           team.id,
-          `hive-senior-${team.name}-${index}`,
+          `${gapSessionPrefix}-${index}`,
           'working',
           `STORY-EXISTING-${index}`,
         ]
@@ -1935,7 +1989,7 @@ describe('Scheduler checkScaling', () => {
         db.run(
           `INSERT INTO agents (id, type, team_id, tmux_session, status, current_story_id, created_at, updated_at)
            VALUES (?, ?, ?, ?, ?, NULL, datetime('now'), datetime('now'))`,
-          ['senior-gap-6', 'senior', team.id, `hive-senior-${team.name}-6`, 'idle']
+          ['senior-gap-6', 'senior', team.id, `${gapSessionPrefix}-6`, 'idle']
         );
         return {
           id: 'senior-gap-6',
@@ -1943,7 +1997,7 @@ describe('Scheduler checkScaling', () => {
           team_id: team.id,
           status: 'idle',
           current_story_id: null,
-          tmux_session: `hive-senior-${team.name}-6`,
+          tmux_session: `${gapSessionPrefix}-6`,
         };
       });
 
@@ -2056,10 +2110,13 @@ describe('Scheduler checkScaling', () => {
       repoPath: 'test',
     });
 
+    const hiveDir = join(mockConfig.rootDir, '.hive');
+    const expectedSession = generateSessionName('senior', team.name, undefined, hiveDir);
+
     db.run(
       `INSERT INTO agents (id, type, team_id, tmux_session, status, current_story_id, created_at, updated_at)
        VALUES (?, ?, ?, ?, ?, ?, datetime('now'), datetime('now'))`,
-      ['senior-guard-1', 'senior', team.id, `hive-senior-${team.name}`, 'working', 'STORY-ACTIVE']
+      ['senior-guard-1', 'senior', team.id, expectedSession, 'working', 'STORY-ACTIVE']
     );
 
     const isRunningSpy = vi.spyOn(tmuxModule, 'isTmuxSessionRunning').mockResolvedValue(true);
@@ -2171,6 +2228,72 @@ describe('Scheduler checkScaling', () => {
   });
 });
 
+describe('Scheduler Markdown File Writing', () => {
+  let storiesDir: string;
+
+  beforeEach(() => {
+    storiesDir = join(
+      tmpdir(),
+      `hive-test-stories-${Date.now()}-${Math.random().toString(36).slice(2)}`
+    );
+    mkdirSync(storiesDir, { recursive: true });
+  });
+
+  afterEach(() => {
+    rmSync(storiesDir, { recursive: true, force: true });
+  });
+
+  it('should write markdown files when assigning stories via scheduler', async () => {
+    const team = createTeam(db, {
+      name: 'MD Write Team',
+      repoUrl: 'https://github.com/test/repo',
+      repoPath: 'test',
+    });
+
+    // Create an idle senior agent
+    db.run(
+      `INSERT INTO agents (id, type, team_id, status, created_at, updated_at)
+       VALUES (?, ?, ?, ?, datetime('now'), datetime('now'))`,
+      ['senior-md-1', 'senior', team.id, 'idle']
+    );
+
+    const story = createStory(db, {
+      teamId: team.id,
+      title: 'Markdown Test Story',
+      description: 'Should get a markdown file on assignment',
+    });
+    updateStory(db, story.id, { status: 'planned', complexityScore: 10, storyPoints: 8 });
+
+    // Create scheduler with rootDir pointing to a temp dir that has .hive/stories/
+    const hiveRoot = join(tmpdir(), `hive-md-root-${Date.now()}`);
+    const hiveStoriesDir = join(hiveRoot, '.hive', 'stories');
+    mkdirSync(hiveStoriesDir, { recursive: true });
+
+    const mdScheduler = new Scheduler(db, {
+      ...mockConfig,
+      rootDir: hiveRoot,
+    } as any);
+
+    // Mock spawnSenior to avoid actual tmux operations
+    vi.spyOn(mdScheduler as any, 'sendAssignmentHandoff').mockResolvedValue(undefined);
+
+    const result = await mdScheduler.assignStories();
+
+    expect(result.assigned).toBe(1);
+
+    // Verify markdown file was written
+    const mdPath = join(hiveStoriesDir, `${story.id}.md`);
+    expect(existsSync(mdPath)).toBe(true);
+
+    // Verify markdown_path was set in DB
+    const updatedStory = getStoryById(db, story.id);
+    expect(updatedStory?.markdown_path).toBe(mdPath);
+    expect(updatedStory?.status).toBe('in_progress');
+
+    rmSync(hiveRoot, { recursive: true, force: true });
+  });
+});
+
 describe('Scheduler Target Branch Propagation', () => {
   it('should retrieve target_branch from requirement when creating story', () => {
     const team = createTeam(db, {