@adhdev/daemon-core 0.9.82-rc.49 → 0.9.82-rc.490

package/src/daemon/dev-server.ts

@@ -1050,547 +1050,6 @@ export class DevServer implements DevServerContext {
     return handleAutoImplement(this, type, req, res);
   }
 
-  private buildAutoImplPrompt(
-    type: string,
-    provider: any,
-    providerDir: string,
-    functions: string[],
-    domContext: any,
-    referenceScripts: Record<string, string>,
-    userComment?: string,
-    referenceType?: string | null,
-  ): string {
-    if (provider.category === 'cli') {
-      return this.buildCliAutoImplPrompt(type, provider, providerDir, functions, referenceScripts, userComment, referenceType);
-    }
-
-    const lines: string[] = [];
-
-    // ── System instructions ──
-    lines.push('You are implementing browser automation scripts for an IDE provider.');
-    lines.push('Be concise. Do NOT explain your reasoning. Just edit files directly.');
-    lines.push('');
-
-    // ── Target ──
-    lines.push(`# Target: ${provider.name || type} (${type})`);
-    lines.push(`Provider directory: \`${providerDir}\``);
-    lines.push('');
-
-    // ── funcToFile mapping (needed early for file classification) ──
-    const funcToFile: Record<string, string> = {
-      readChat: 'read_chat.js', sendMessage: 'send_message.js',
-      resolveAction: 'resolve_action.js', listSessions: 'list_sessions.js',
-      listChats: 'list_chats.js', switchSession: 'switch_session.js',
-      newSession: 'new_session.js', focusEditor: 'focus_editor.js',
-      openPanel: 'open_panel.js', listModels: 'list_models.js',
-      listModes: 'list_modes.js', setModel: 'set_model.js', setMode: 'set_mode.js',
-    };
-    const targetFileNames = new Set(functions.map(fn => funcToFile[fn]).filter(Boolean));
-
-    // ── Existing target files (inline, so no reading needed) ──
-    const scriptsDir = path.join(providerDir, 'scripts');
-    const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
-    if (latestScriptsDir) {
-      lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
-      lines.push('');
-
-      // Target files: editable
-      lines.push('## ✏️ Target Files (EDIT THESE)');
-      lines.push('These are the ONLY files you are allowed to modify. Replace the TODO stubs with working implementations.');
-      lines.push('');
-      for (const file of fs.readdirSync(latestScriptsDir)) {
-        if (file.endsWith('.js') && targetFileNames.has(file)) {
-          try {
-            const content = fs.readFileSync(path.join(latestScriptsDir, file), 'utf-8');
-            lines.push(`### \`${file}\` ✏️ EDIT`);
-            lines.push('```javascript');
-            lines.push(content);
-            lines.push('```');
-            lines.push('');
-          } catch { /* skip */ }
-        }
-      }
-
-      // Non-target files: reference only
-      const refFiles = fs.readdirSync(latestScriptsDir).filter(f => f.endsWith('.js') && !targetFileNames.has(f));
-      if (refFiles.length > 0) {
-        lines.push('## 🔒 Other Scripts (REFERENCE ONLY — DO NOT EDIT)');
-        lines.push('These files are shown for context only. Do NOT modify them under any circumstances.');
-        lines.push('');
-        for (const file of refFiles) {
-          try {
-            const content = fs.readFileSync(path.join(latestScriptsDir, file), 'utf-8');
-            lines.push(`### \`${file}\` 🔒`);
-            lines.push('```javascript');
-            lines.push(content);
-            lines.push('```');
-            lines.push('');
-          } catch { /* skip */ }
-        }
-      }
-    }
-
-    // ── DOM context ──
-    if (domContext) {
-      lines.push('## Live DOM Analysis (from CDP)');
-      lines.push('Use these selectors in your implementations:');
-      lines.push('```json');
-      lines.push(JSON.stringify(domContext, null, 2));
-      lines.push('```');
-      lines.push('');
-    }
-
-    // ── Reference implementation ── (funcToFile already defined above)
-
-    if (Object.keys(referenceScripts).length > 0) {
-      lines.push(`## Reference Implementation (from ${referenceType || 'antigravity'} provider)`);
-      lines.push('These are WORKING scripts from another IDE. Adapt the PATTERNS (not selectors) for the target IDE.');
-      lines.push('');
-      for (const fn of functions) {
-        const fileName = funcToFile[fn];
-        if (fileName && referenceScripts[fileName]) {
-          lines.push(`### ${fn} → \`${fileName}\``);
-          lines.push('```javascript');
-          lines.push(referenceScripts[fileName]);
-          lines.push('```');
-          lines.push('');
-        }
-      }
-      if (referenceScripts['scripts.js']) {
-        lines.push('### Router → `scripts.js`');
-        lines.push('```javascript');
-        lines.push(referenceScripts['scripts.js']);
-        lines.push('```');
-        lines.push('');
-      }
-    }
-
-    // ── Markdown Guides (Provider Fix) ──
-    const docsDir = path.join(providerDir, '../../docs');
-    const loadGuide = (name: string) => {
-      try {
-        const p = path.join(docsDir, name);
-        if (fs.existsSync(p)) return fs.readFileSync(p, 'utf-8');
-      } catch { /* ignore */ }
-      return null;
-    };
-
-    const providerGuide = loadGuide('PROVIDER_GUIDE.md');
-    if (providerGuide) {
-      lines.push('## Documentation: PROVIDER_GUIDE.md');
-      lines.push('```markdown');
-      lines.push(providerGuide);
-      lines.push('```');
-      lines.push('');
-    }
-
-    const cdpGuide = loadGuide('CDP_SELECTOR_GUIDE.md');
-    if (cdpGuide) {
-      lines.push('## Documentation: CDP_SELECTOR_GUIDE.md');
-      lines.push('```markdown');
-      lines.push(cdpGuide);
-      lines.push('```');
-      lines.push('');
-    }
-
-    // ── Task ──
-    lines.push('## Task');
-    lines.push(`Edit files in \`${providerDir}\` to implement: **${functions.join(', ')}**`);
-    lines.push('');
-
-    // ── Rules ──
-    lines.push('## Rules');
-    lines.push('0. **🚫 SCOPE CONSTRAINT**: You may ONLY edit files marked ✏️ EDIT above. ALL other files are READ-ONLY. Do NOT modify, rewrite, refactor, or "improve" any file not explicitly marked as editable — even if you notice bugs or improvements. No exceptions.');
-    lines.push('1. **Scripts WITHOUT params** → IIFE: `(() => { ... })()`');
-    lines.push('2. **Scripts WITH params** → arrow: `(params) => { ... }` — router calls `(${script})(${JSON.stringify(params)})`');
-    lines.push('3. If live DOM analysis is included above, use it. Otherwise, discover selectors yourself via CDP before coding.');
-    lines.push('4. Always wrap in try-catch, return `JSON.stringify(result)`');
-    lines.push('5. Do NOT modify `scripts.js` router — only edit individual `*.js` files');
-    lines.push('6. All scripts run in the browser (CDP evaluate) — use DOM APIs only');
-    lines.push('7. **Cross-Platform Compatibility**: If you use ARIA labels that contain keyboard shortcuts (e.g., `Cascade (⌘L)`), you MUST use substring matches (`aria-label*="Cascade"`) or handle both macOS (`⌘`, `Cmd`) and Windows (`Ctrl`) so the script does not break on other operating systems.');
-    lines.push('8. **CRITICAL: DO NOT explore the filesystem or read other providers.** The reference implementation pattern is already provided below. Do not run `find`, `rg`, or `cat` on upstream providers. Doing so wastes context tokens and will crash the agent session. Focus entirely on modifying the target files.');
-    lines.push('9. Do NOT delete any files. Implement the logic by replacing the empty stubs.');
-    lines.push('');
-
-    // ── Output contracts ──
-    lines.push('## Required Return Format');
-    lines.push('| Function | Return JSON |');
-    lines.push('|---|---|');
-    lines.push('| readChat | `{ id, status, title, messages: [{role, content, index, kind?, meta?}], inputContent, activeModal, controlValues?, summaryMetadata? }` — optional `kind`: standard, thought, tool, terminal; prefer explicit `controlValues` for current selections and `summaryMetadata` for compact always-visible UI metadata |');
-    lines.push('| sendMessage | `{ sent: false, needsTypeAndSend: true, selector }` |');
-    lines.push('| resolveAction | `{ resolved: true/false, clicked? }` |');
-    lines.push('| listSessions | `{ sessions: [{ id, title, active, index }] }` |');
-    lines.push('| switchSession | `{ switched: true/false }` |');
-    lines.push('| newSession | `{ created: true/false }` |');
-    lines.push('| listModels | `{ models: [{ name, id }], current }` |');
-    lines.push('| setModel | `{ success: true/false }` |');
-    lines.push('| listModes | `{ modes: [{ name, id }], current }` |');
-    lines.push('| setMode | `{ success: true/false }` |');
-    lines.push('| focusEditor | `{ focused: true/false, error? }` |');
-    lines.push('| openPanel | `{ opened: true/false, visible: true/false, focused?: true, error? }` |');
-    lines.push('');
-
-    // ── readChat.status lifecycle spec ──
-    lines.push('## 🔴 CRITICAL: readChat `status` Lifecycle');
-    lines.push('The `status` field in readChat controls how the dashboard and daemon auto-approve-loop behave.');
-    lines.push('Getting this wrong will break the entire automation pipeline. The status MUST reflect the ACTUAL current state:');
-    lines.push('');
-    lines.push('| Status | When to use | How to detect |');
-    lines.push('|---|---|---|');
-    lines.push('| `idle` | AI is NOT generating, no approval needed | Default state. No stop button, no spinners, no approval pills/buttons |');
-    lines.push('| `generating` | AI is actively streaming/thinking | ANY of: (1) Submit button icon SVG changes (e.g. arrow→stop square, fill="none"→fill="currentColor"), (2) Stop/Cancel button visible, (3) CSS animation, (4) Structural markers (aria-labels that only appear during generation) |');
-    lines.push('| `waiting_approval` | AI stopped and needs user action | Actionable buttons like Run/Skip/Accept/Reject are visible AND clickable |');
-    lines.push('');
-    lines.push('### ⚠️ Status Detection Gotchas (MUST READ!)');
-    lines.push('1. **DO NOT rely on button text/labels in the user\'s language.** OS locale may be Korean, Japanese, etc. Button text like "Cancel" or "Stop" will be localized. Instead, detect STRUCTURAL indicators: SVG icon changes, CSS classes, aria-labels from the extension\'s own React/Radix UI (which stay in English regardless of OS locale).');
-    lines.push('2. **Use sendMessage to CREATE a generating state, then CAPTURE the DOM.** Send a LONG prompt (e.g. "Write an extremely detailed 5000-word essay...") so the AI takes 10+ seconds. Then periodically capture the DOM during generation to find which elements appear/change. Compare idle vs generating DOM snapshots to find reliable structural markers.');
-    lines.push('3. **Look for SVG icon changes in the submit button.** Many IDEs change the submit button icon from an arrow (send) to a square (stop) during generation. Check the SVG `fill` attribute or path data.');
-    lines.push('4. **FALSE POSITIVES from old messages**: Chat history may contain text like "Command Awaiting Approval" from PAST turns. ONLY match small leaf elements (under 80 chars) or use explicit button/pill selectors.');
-    lines.push('5. **Awaiting Approval pill without actions**: Some IDEs show a floating pill/banner that is just a scroll-to indicator. If NO actionable buttons exist, the status should be `idle`, NOT `waiting_approval`.');
-    lines.push('6. **activeModal must include actions**: When `status` is `waiting_approval`, the `activeModal` object MUST include a non-empty `actions` array.');
-    lines.push('');
-
-    lines.push('## Action');
-    lines.push('1. Edit the script files to implement working code');
-    lines.push('2. After editing, TEST each function using the DevConsole API (see below)');
-    lines.push('3. If a test fails, fix the implementation and re-test');
-    lines.push('4. **IMPORTANT VERIFICATION LOGIC**: When verifying your implementation, beware of state contamination! You MUST perform strict Integration Testing:');
-    lines.push('   - `openPanel`: Toggle buttons are usually located in the top header, sidebar, or activity bar. Prefer finding and clicking these native UI buttons over extreme CSS injection hacks if possible.');
-    lines.push('   - `listSessions`: If sessions are unmounted when the panel is closed, try to explicitly interact with the UI to open the history/sessions view (e.g., clicking a history icon usually found near the chat header) BEFORE scraping.');
-    lines.push('   - `switchSession`: Prove your switch was successful by subsequently calling `readChat` and explicitly checking that the chat context has actually changed.');
-    lines.push('');
-
-    // ── DevConsole API for verification ──
-    lines.push('## DOM Exploration');
-    if (domContext) {
-      lines.push('A lightweight DOM snapshot is included above, but you MUST still verify selectors yourself before finalizing the scripts.');
-    } else {
-      lines.push('No DOM snapshot is included here. You MUST use your command-line tools to discover the IDE structure dynamically.');
-    }
-    lines.push('');
-    lines.push('### 1. Evaluate JS to explore IDE DOM');
-    lines.push('Use cURL to run JavaScript inside the IDE:');
-    lines.push('```bash');
-    lines.push(`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/cdp/evaluate \\`);
-    lines.push(`  -H "Content-Type: application/json" \\`);
-    lines.push(`  -d '{"expression": "document.body.innerHTML.substring(0, 1000)", "ideType": "${type}"}'`);
-    lines.push('```');
-    lines.push('');
-    lines.push('### 2. Test your generated function');
-    lines.push('Once you save the file, test it by running:');
-    lines.push('```bash');
-    lines.push(`curl -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/providers/reload`);
-    lines.push(`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/scripts/run -H "Content-Type: application/json" -d '{"script": "readChat", "type": "${type}", "ideType": "${type}"}'`);
-    lines.push('```');
-    lines.push('');
-    lines.push('### Task Workflow');
-    lines.push('1. Write bash scripts to `curl` the CDP evaluate API above to find exactly where `.chat-message`, etc., are located.');
-    lines.push('2. Iteratively explore until you are confident in your selectors.');
-    lines.push('3. Edit the `.js` files using the selectors you discovered.');
-    lines.push('4. Reload providers and TEST your script via the API.');
-    lines.push('');
-    lines.push('### 🔥 Advanced UI Parsing (CRUCIAL for `readChat`)');
-    lines.push('Your `readChat` must flawlessly parse complex UI elements (tables, code blocks, tool calls, and AI thoughts). The quality must match the `antigravity` reference.');
-    lines.push('To achieve this, you MUST generate a live test scenario:');
-    lines.push(`1. Early in your process, send a rich prompt to the IDE using the API:`);
-    lines.push(`   \`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/scripts/run -H "Content-Type: application/json" -d '{"script": "sendMessage", "type": "${type}", "ideType": "${type}", "args": {"message": "Write a python script, draw a markdown table, use a tool, and show your reasoning/thought process"}}'\``);
-    lines.push('2. Wait a few seconds for the IDE AI to generate these elements in the UI.');
-    lines.push('3. Use CDP evaluate to deeply inspect the DOM structure of the newly generated tables, code blocks, thought blocks, and tool calls.');
-    lines.push('4. Ensure `readChat` extracts `content` with precise markdown formatting (especially for tables/code) and assigns correct `kind` tags (`thought`, `tool`, `terminal`).');
-    lines.push('');
-
-    // ── Mandatory Integration Test ──
-    lines.push('## 🧪 MANDATORY: Status Integration Test');
-    lines.push('Before finishing, you MUST run this end-to-end test to verify readChat status transitions work:');
-    lines.push('');
-    lines.push('### Step 1: Baseline — confirm idle');
-    lines.push('```bash');
-    lines.push(`curl -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/providers/reload`);
-    lines.push(`RESULT=$(curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/scripts/run -H "Content-Type: application/json" -d '{"script": "readChat", "type": "${type}", "ideType": "${type}"}')`);
-    lines.push(`echo "$RESULT" | python3 -c "import sys,json; d=json.load(sys.stdin); r=d.get('result',d); r=json.loads(r) if isinstance(r,str) else r; assert r.get('status')=='idle', f'Expected idle, got {r.get(chr(34)+chr(115)+chr(116)+chr(97)+chr(116)+chr(117)+chr(115)+chr(34))}'; print('Step 1 PASS: status=idle')"`);
-    lines.push('```');
-    lines.push('');
-    lines.push('### Step 2: Send a LONG message that triggers extended generation (10+ seconds)');
-    lines.push('```bash');
-    lines.push(`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/scripts/run -H "Content-Type: application/json" -d '{"script": "sendMessage", "type": "${type}", "ideType": "${type}", "args": {"message": "Write an extremely detailed 5000-word essay about the history of artificial intelligence from Alan Turing to 2025. Be very thorough and verbose."}}'`);
-    lines.push('sleep 3');
-    lines.push('```');
-    lines.push('');
-    lines.push('### Step 3: Check generating OR completed');
-    lines.push('The AI may still be generating OR may have finished already. Either generating or idle is acceptable:');
-    lines.push('```bash');
-    lines.push(`RESULT=$(curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/scripts/run -H "Content-Type: application/json" -d '{"script": "readChat", "type": "${type}", "ideType": "${type}"}')`);
-    lines.push(`echo "$RESULT" | python3 -c "import sys,json; d=json.load(sys.stdin); r=d.get('result',d); r=json.loads(r) if isinstance(r,str) else r; s=r.get('status'); assert s in ('generating','idle','waiting_approval'), f'Unexpected: {s}'; print(f'Step 3 PASS: status={s}')"`);
-    lines.push('```');
-    lines.push('');
-    lines.push('### Step 4: Wait for completion and verify new message');
-    lines.push('```bash');
-    lines.push('sleep 10');
-    lines.push(`RESULT=$(curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/scripts/run -H "Content-Type: application/json" -d '{"script": "readChat", "type": "${type}", "ideType": "${type}"}')`);
-    lines.push(`echo "$RESULT" | python3 -c "import sys,json; d=json.load(sys.stdin); r=d.get('result',d); r=json.loads(r) if isinstance(r,str) else r; s=r.get('status'); msgs=r.get('messages',[]); assert s=='idle', f'Expected idle, got {s}'; assert len(msgs)>0, 'No messages'; print(f'Step 4 PASS: status={s}, messages={len(msgs)}')"`);
-    lines.push('```');
-    lines.push('');
-    lines.push('If ANY step fails, fix your implementation and re-run the test. Do NOT finish until all 4 steps pass.');
-    lines.push('');
-    // ── User-provided additional instructions ──
-    if (userComment) {
-      lines.push('## ⚠️ User Instructions (HIGH PRIORITY)');
-      lines.push('The user has provided the following additional instructions. Follow them strictly:');
-      lines.push('');
-      lines.push(userComment);
-      lines.push('');
-    }
-
-    lines.push('Start NOW. Do not ask for permission. Explore the DOM -> Code -> Test.');
-
-    return lines.join('\n');
-  }
-
-  private buildCliAutoImplPrompt(
-    type: string,
-    provider: any,
-    providerDir: string,
-    functions: string[],
-    referenceScripts: Record<string, string>,
-    userComment?: string,
-    referenceType?: string | null,
-  ): string {
-    const lines: string[] = [];
-
-    lines.push('You are implementing PTY parsing scripts for a CLI provider.');
-    lines.push('Be concise. Do NOT explain your reasoning. Edit files directly and verify with the local DevServer.');
-    lines.push('');
-
-    lines.push(`# Target: ${provider.name || type} (${type})`);
-    lines.push(`Provider directory: \`${providerDir}\``);
-    lines.push('Provider category: `cli`');
-    lines.push('');
-
-    const funcToFile: Record<string, string> = {
-      parseSession: 'parse_session.js',
-      detectStatus: 'detect_status.js',
-      parseApproval: 'parse_approval.js',
-    };
-    const targetFileNames = new Set(functions.map(fn => funcToFile[fn]).filter(Boolean));
-
-    const scriptsDir = path.join(providerDir, 'scripts');
-    const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
-    if (latestScriptsDir) {
-      lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
-      lines.push('');
-
-      // Target files: editable
-      lines.push('## ✏️ Target Files (EDIT THESE)');
-      lines.push('These are the ONLY files you are allowed to modify. Replace TODO or heuristic-only logic with working PTY-aware implementations.');
-      lines.push('');
-      for (const file of fs.readdirSync(latestScriptsDir)) {
-        if (!file.endsWith('.js')) continue;
-        if (!targetFileNames.has(file)) continue;
-        try {
-          const content = fs.readFileSync(path.join(latestScriptsDir, file), 'utf-8');
-          lines.push(`### \`${file}\` ✏️ EDIT`);
-          lines.push('```javascript');
-          lines.push(content);
-          lines.push('```');
-          lines.push('');
-        } catch {
-          // ignore
-        }
-      }
-
-      // Non-target files: reference only
-      const refFiles = fs.readdirSync(latestScriptsDir).filter(f => f.endsWith('.js') && !targetFileNames.has(f));
-      if (refFiles.length > 0) {
-        lines.push('## 🔒 Other Scripts (REFERENCE ONLY — DO NOT EDIT)');
-        lines.push('These files are shown for context only. Do NOT modify them under any circumstances.');
-        lines.push('');
-        for (const file of refFiles) {
-          try {
-            const content = fs.readFileSync(path.join(latestScriptsDir, file), 'utf-8');
-            lines.push(`### \`${file}\` 🔒`);
-            lines.push('```javascript');
-            lines.push(content);
-            lines.push('```');
-            lines.push('');
-          } catch {
-            // ignore
-          }
-        }
-      }
-    }
-
-
-
-    if (Object.keys(referenceScripts).length > 0) {
-      lines.push(`## Reference Implementation (from ${referenceType || 'another CLI'} provider)`);
-      lines.push('These are working CLI PTY parser scripts. Reuse the parsing shape and runtime contract, but adapt to the target CLI screen.');
-      lines.push('');
-      for (const fn of functions) {
-        const fileName = funcToFile[fn];
-        if (fileName && referenceScripts[fileName]) {
-          lines.push(`### ${fn} → \`${fileName}\``);
-          lines.push('```javascript');
-          lines.push(referenceScripts[fileName]);
-          lines.push('```');
-          lines.push('');
-        }
-      }
-      if (referenceScripts['scripts.js']) {
-        lines.push('### Router → `scripts.js`');
-        lines.push('```javascript');
-        lines.push(referenceScripts['scripts.js']);
-        lines.push('```');
-        lines.push('');
-      }
-    }
-
-    // ── Markdown Guides (Provider Fix) ──
-    const docsDir = path.join(providerDir, '../../docs');
-    const loadGuide = (name: string) => {
-      try {
-        const p = path.join(docsDir, name);
-        if (fs.existsSync(p)) return fs.readFileSync(p, 'utf-8');
-      } catch { /* ignore */ }
-      return null;
-    };
-
-    const providerGuide = loadGuide('PROVIDER_GUIDE.md');
-    if (providerGuide) {
-      lines.push('## Documentation: PROVIDER_GUIDE.md');
-      lines.push('```markdown');
-      lines.push(providerGuide);
-      lines.push('```');
-      lines.push('');
-    }
-
-    lines.push('## Runtime Contract');
-    lines.push('The daemon runtime is already implemented in `packages/daemon-core/src/cli-adapters/provider-cli-adapter.ts`.');
-    lines.push('Your scripts receive PTY-derived input and must return plain JS objects.');
-    lines.push('');
-    lines.push('| Function | Input | Return |');
-    lines.push('|---|---|---|');
-    lines.push('| `parseSession` | `{ buffer, rawBuffer, recentBuffer, screenText, messages, partialResponse }` | `{ id, status, title, messages, activeModal }` |');
-    lines.push('| `detectStatus` | `{ tail, screenText, rawBuffer }` | `idle`, `generating`, `waiting_approval`, or `error` |');
-    lines.push('| `parseApproval` | `{ buffer, rawBuffer, tail }` | `{ message, buttons }` or `null` |');
-    lines.push('');
-    lines.push('## Primary Source of Truth');
-    lines.push('The runtime now provides a reliable current-screen snapshot. Treat `screenText` as the primary source of truth for the LIVE visible UI.');
-    lines.push('That means:');
-    lines.push('- Use `screenText` first for prompt detection, approval UI, status, and visible assistant content.');
-    lines.push('- Use `rawBuffer` only as supporting evidence when ANSI/style/cursor cues matter.');
-    lines.push('- Use `buffer` only when the visible screen does not contain enough text to recover the latest assistant answer.');
-    lines.push('- Do NOT build the parser around stale transcript noise if the current screen already gives the answer.');
-    lines.push('');
-
-    lines.push('## Rules');
-    lines.push('0. **🚫 SCOPE CONSTRAINT**: You may ONLY edit files marked ✏️ EDIT above. ALL other files are READ-ONLY. Do NOT modify, rewrite, refactor, or "improve" any file not explicitly marked as editable — even if you notice bugs or improvements. No exceptions.');
-    lines.push('1. These scripts run in Node.js CommonJS, not in the browser. Do NOT use DOM APIs.');
-    lines.push('2. Prefer `screenText` for current visible UI state. It is now the PTY equivalent of a trustworthy live DOM snapshot.');
-    lines.push('3. Use `messages` as prior transcript state so redraws do not duplicate old turns on every parse.');
-    lines.push('4. Use `partialResponse` for the actively streaming assistant text when status is `generating`.');
-    lines.push('5. `detectStatus` must stay lightweight and current-screen-oriented. Prefer the active bottom-of-screen region over stale history.');
-    lines.push('6. `parseApproval` should understand the live approval area and return clean button labels from the CURRENT visible modal.');
-    lines.push('7. Use `rawBuffer` only when ANSI/control-sequence artifacts or style cues matter. Do not depend on raw escape noise unless necessary.');
-    lines.push('8. Keep exports compatible with the existing `scripts.js` router (`module.exports = function ...`).');
-    lines.push('9. Do NOT modify ANY file not explicitly marked ✏️ EDIT above. No exceptions — no "tiny supporting changes" to other files.');
-    lines.push('10. When the verification API returns `instanceId`, keep using that exact instance for follow-up `send`, `resolve`, `raw`, and `stop` calls. Do not assume type-only routing is safe if multiple sessions exist.');
-    lines.push('11. Do NOT repeatedly dump the same target files. Read the target scripts once, reproduce the bug, then move directly to patching.');
-    lines.push('12. If the user instructions include concrete screen text, raw PTY snippets, or a specific repro, treat that as the primary acceptance criteria.');
-    lines.push('13. After the first successful live repro, stop broad diagnosis. Edit the scripts, reload, and verify. Do not burn tokens on repeated re-inspection without code changes.');
-    lines.push('14. If the visible current screen is clean and sufficient, do NOT fall back to complex buffer heuristics. Simpler current-screen parsing is preferred.');
-    lines.push('15. Before changing parser logic, verify whether `provider.json` submit/approval behavior (`sendDelayMs`, `approvalKeys`, submit strategy) is the simpler and more correct fix.');
-    lines.push('');
-
-    lines.push('## Task');
-    lines.push(`Edit files in \`${providerDir}\` to implement: **${functions.join(', ')}**`);
-    lines.push('');
-
-    lines.push('## Verification API');
-    lines.push('Use the DevServer CLI debug endpoints, not DOM/CDP routes.');
-    lines.push('');
-    lines.push('### 1. Launch the target CLI');
-    lines.push('```bash');
-    lines.push(`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/launch \\`);
-    lines.push('  -H "Content-Type: application/json" \\');
-    lines.push(`  -d '{"type":"${type}","workingDir":"${providerDir.replace(/\\/g, '\\\\')}"}'`);
-    lines.push('```');
-    lines.push('');
-    lines.push('### 2. Inspect parsed + raw adapter state');
-    lines.push('```bash');
-    lines.push(`curl -sS http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/debug/${type}`);
-    lines.push(`curl -sS http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/trace/${type}`);
-    lines.push(`curl -sS http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/status`);
-    lines.push('```');
-    lines.push('');
-    lines.push('The debug payload should be read in this priority order:');
-    lines.push('1. `screenText` / current visible state');
-    lines.push('2. parsed `status`, `messages`, `activeModal`');
-    lines.push('3. `rawBuffer` only for style/control-sequence cues');
-    lines.push('4. `buffer` only when the current screen is insufficient');
-    lines.push('');
-    lines.push('Extract the current `instanceId` from the launch or status response and keep using it below.');
-    lines.push('');
-    lines.push('### 3. Send a realistic approval-triggering prompt');
-    lines.push('```bash');
-    lines.push(`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/send \\`);
-    lines.push('  -H "Content-Type: application/json" \\');
-    lines.push(`  -d '{"type":"${type}","instanceId":"<INSTANCE_ID>","text":"Create a file at tmp/adhdev_provider_fix_test.py that prints the current working directory and the squares of 1 through 5, then run python3 tmp/adhdev_provider_fix_test.py and tell me the exact output."}'`);
-    lines.push('```');
-    lines.push('');
-    lines.push('### 4. If approval appears, resolve it until the CLI reaches idle');
-    lines.push('```bash');
-    lines.push(`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/resolve \\`);
-    lines.push('  -H "Content-Type: application/json" \\');
-    lines.push(`  -d '{"type":"${type}","instanceId":"<INSTANCE_ID>","buttonIndex":0}'`);
-    lines.push(`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/raw \\`);
-    lines.push('  -H "Content-Type: application/json" \\');
-    lines.push(`  -d '{"type":"${type}","instanceId":"<INSTANCE_ID>","keys":"1"}'`);
-    lines.push('```');
-    lines.push('');
-    lines.push('Use `resolve` when the parsed modal buttons are correct. Use `raw` when the CLI expects a literal keystroke like `1`, `y`, or Enter. Repeat until idle.');
-    lines.push('');
-    lines.push('### Patch Discipline');
-    lines.push('Once the repro is confirmed, immediately edit the target files. Avoid loops where you keep re-reading long files or re-running the same debug commands without changing code.');
-    lines.push('');
-    lines.push('### 5. Verify the side effects outside the CLI');
-    lines.push('```bash');
-    lines.push('test -f tmp/adhdev_provider_fix_test.py');
-    lines.push('python3 tmp/adhdev_provider_fix_test.py');
-    lines.push('```');
-    lines.push('');
-    lines.push('### 6. Stop the CLI when finished');
-    lines.push('```bash');
-    lines.push(`curl -sS -X POST http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/stop \\`);
-    lines.push('  -H "Content-Type: application/json" \\');
-    lines.push(`  -d '{"type":"${type}","instanceId":"<INSTANCE_ID>"}'`);
-    lines.push('```');
-    lines.push('');
-
-    lines.push('## Required Validation');
-    lines.push('1. Confirm `detectStatus` changes sensibly between startup, generating, approval, and idle.');
-    lines.push('2. Confirm `parseSession` produces a stable transcript without duplicating past turns when the PTY redraws.');
-    lines.push('3. Confirm the latest assistant message streams through `partialResponse` while generation is in progress.');
-    lines.push('4. Confirm approval parsing returns meaningful button labels when the CLI requests permission.');
-    lines.push('5. Confirm the Python file was actually created and executed, not just described in chat text.');
-    lines.push('6. Confirm the final assistant transcript includes the exact Python output, including the working directory line and the five square numbers.');
-    lines.push('7. Re-run the debug endpoints after edits. Do NOT finish until the parsed result looks correct.');
-    lines.push('8. Confirm the parser still works after a redraw or scroll change without duplicating transcript history.');
-    lines.push('9. Confirm the implementation prefers current-screen signals over stale history when both are present.');
-    lines.push('');
-
-    if (userComment) {
-      lines.push('## ⚠️ User Instructions (HIGH PRIORITY)');
-      lines.push('The user has provided the following additional instructions. Follow them strictly:');
-      lines.push('');
-      lines.push(userComment);
-      lines.push('');
-    }
-
-    lines.push('Start NOW. Launch the CLI, inspect PTY state, edit the scripts, and verify via the CLI debug endpoints.');
-
-    return lines.join('\n');
-  }
-
   private handleAutoImplSSE(type: string, req: http.IncomingMessage, res: http.ServerResponse): void {
     handleAutoImplSSE(this, type, req, res);
   }