claude-coder 1.7.0 → 1.8.0

package/src/hooks.js

@@ -1,160 +0,0 @@
-'use strict';
-
-const { inferPhaseStep } = require('./indicator');
-const { log } = require('./config');
-
-const DEFAULT_EDIT_THRESHOLD = 15;
-const SESSION_RESULT_FILENAME = 'session_result.json';
-
-function logToolCall(logStream, input) {
-  if (!logStream) return;
-  const target = input.tool_input?.file_path || input.tool_input?.path || '';
-  const cmd = input.tool_input?.command || '';
-  const pattern = input.tool_input?.pattern || '';
-  const detail = target || cmd.slice(0, 200) || (pattern ? `pattern: ${pattern}` : '');
-  if (detail) {
-    logStream.write(`[${new Date().toISOString()}] ${input.tool_name}: ${detail}\n`);
-  }
-}
-
-/**
- * Detect whether a tool call writes to session_result.json.
- * Covers both the Write tool (exact path match) and Bash redirect writes.
- */
-function isSessionResultWrite(toolName, toolInput) {
-  if (toolName === 'Write') {
-    const target = toolInput?.file_path || toolInput?.path || '';
-    return target.endsWith(SESSION_RESULT_FILENAME);
-  }
-  if (toolName === 'Bash') {
-    const cmd = toolInput?.command || '';
-    if (!cmd.includes(SESSION_RESULT_FILENAME)) return false;
-    return />\s*[^\s]*session_result/.test(cmd);
-  }
-  return false;
-}
-
-/**
- * Create unified session hooks with stall detection, edit guard,
- * and completion detection (auto-shorten timeout after session_result written).
- * @param {Indicator} indicator
- * @param {WriteStream|null} logStream
- * @param {object} [options]
- * @param {boolean}         [options.enableStallDetection=false]
- * @param {number}          [options.stallTimeoutMs=1200000]
- * @param {AbortController} [options.abortController]
- * @param {boolean}         [options.enableEditGuard=false]
- * @param {boolean}         [options.enableCompletionDetection=true]
- * @param {number}          [options.completionTimeoutMs=300000]
- * @returns {{ hooks: object, cleanup: () => void, isStalled: () => boolean }}
- */
-function createSessionHooks(indicator, logStream, options = {}) {
-  const {
-    enableStallDetection = false,
-    stallTimeoutMs = 1200000,
-    abortController = null,
-    enableEditGuard = false,
-    editThreshold = DEFAULT_EDIT_THRESHOLD,
-    enableCompletionDetection = true,
-    completionTimeoutMs = 300000,
-  } = options;
-
-  const editCounts = {};
-  let stallDetected = false;
-  let stallChecker = null;
-  let completionDetectedAt = 0;
-
-  if (enableStallDetection) {
-    stallChecker = setInterval(() => {
-      const now = Date.now();
-      const idleMs = now - indicator.lastToolTime;
-
-      if (completionDetectedAt > 0) {
-        const sinceCompletion = now - completionDetectedAt;
-        if (sinceCompletion > completionTimeoutMs && !stallDetected) {
-          stallDetected = true;
-          const secSince = Math.floor(sinceCompletion / 1000);
-          log('warn', `session_result 已写入 ${secSince} 秒前，模型未自行终止，自动中断`);
-          if (logStream) {
-            logStream.write(`[${new Date().toISOString()}] COMPLETION_TIMEOUT: session_result 写入后 ${secSince}s 无终止，自动中断\n`);
-          }
-          if (abortController) {
-            abortController.abort();
-            log('warn', '已发送中断信号（完成检测）');
-          }
-          return;
-        }
-      }
-
-      if (idleMs > stallTimeoutMs && !stallDetected) {
-        stallDetected = true;
-        const idleMin = Math.floor(idleMs / 60000);
-        log('warn', `无新工具调用超过 ${idleMin} 分钟，自动中断 session`);
-        if (logStream) {
-          logStream.write(`[${new Date().toISOString()}] STALL: 无工具调用 ${idleMin} 分钟，自动中断\n`);
-        }
-        if (abortController) {
-          abortController.abort();
-          log('warn', '已发送中断信号');
-        }
-      }
-    }, 30000);
-  }
-
-  const hooks = {
-    PreToolUse: [{
-      matcher: '*',
-      hooks: [async (input) => {
-        inferPhaseStep(indicator, input.tool_name, input.tool_input);
-        logToolCall(logStream, input);
-
-        if (enableEditGuard) {
-          const target = input.tool_input?.file_path || input.tool_input?.path || '';
-          if (['Write', 'Edit', 'MultiEdit'].includes(input.tool_name) && target) {
-            editCounts[target] = (editCounts[target] || 0) + 1;
-            if (editCounts[target] > editThreshold) {
-              return {
-                hookSpecificOutput: {
-                  hookEventName: 'PreToolUse',
-                  permissionDecision: 'deny',
-                  permissionDecisionReason: `已对 ${target} 编辑 ${editCounts[target]} 次，疑似死循环。请重新审视方案后再继续。`,
-                },
-              };
-            }
-          }
-        }
-
-        return {};
-      }]
-    }],
-    PostToolUse: [{
-      matcher: '*',
-      hooks: [async (input) => {
-        indicator.updatePhase('thinking');
-        indicator.updateStep('');
-        indicator.toolTarget = '';
-
-        if (enableCompletionDetection && !completionDetectedAt) {
-          if (isSessionResultWrite(input.tool_name, input.tool_input)) {
-            completionDetectedAt = Date.now();
-            const shortMin = Math.ceil(completionTimeoutMs / 60000);
-            log('info', `检测到 session_result 写入，${shortMin} 分钟内模型未终止将自动中断`);
-            if (logStream) {
-              logStream.write(`[${new Date().toISOString()}] COMPLETION_DETECTED: session_result.json written, ${shortMin}min grace period\n`);
-            }
-          }
-        }
-
-        return {};
-      }]
-    }],
-  };
-
-  return {
-    hooks,
-    cleanup() { if (stallChecker) clearInterval(stallChecker); },
-    isStalled() { return stallDetected; },
-  };
-}
-
-module.exports = { createSessionHooks };

package/src/prompts.js

@@ -1,295 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { paths, loadConfig, getProjectRoot } = require('./config');
-const { loadTasks, findNextTask, getStats } = require('./tasks');
-
-// --------------- Template Engine ---------------
-
-/**
- * Replace {{key}} placeholders with values from vars object.
- * - Uses Object.prototype.hasOwnProperty.call to prevent prototype pollution
- * - Coerces values to string via String() for type safety
- * - Collapses 3+ consecutive newlines (from empty variables) into double newline
- * - Only matches \w+ inside {{ }}, so JSON braces and %{...} are safe
- */
-function renderTemplate(template, vars = {}) {
-  return template
-    .replace(/\{\{(\w+)\}\}/g, (_, key) =>
-      Object.prototype.hasOwnProperty.call(vars, key) ? String(vars[key]) : ''
-    )
-    .replace(/^\s+$/gm, '')     // remove lines that became whitespace-only after replacement
-    .replace(/\n{3,}/g, '\n\n') // collapse 3+ consecutive newlines into double
-    .trim();
-}
-
-/**
- * Read a prompt template file and render it with variables.
- * Falls back to empty string if file doesn't exist.
- */
-function loadAndRender(filepath, vars = {}) {
-  if (!fs.existsSync(filepath)) return '';
-  const template = fs.readFileSync(filepath, 'utf8');
-  return renderTemplate(template, vars);
-}
-
-// --------------- System Prompt ---------------
-
-/**
- * Build system prompt by combining prompt files.
- * CLAUDE.md and SCAN_PROTOCOL.md are read as-is (no variable injection).
- */
-function buildSystemPrompt(includeScanProtocol = false) {
-  const p = paths();
-  let prompt = fs.readFileSync(p.claudeMd, 'utf8');
-  if (includeScanProtocol && fs.existsSync(p.scanProtocol)) {
-    prompt += '\n\n' + fs.readFileSync(p.scanProtocol, 'utf8');
-  }
-  return prompt;
-}
-
-// --------------- Coding Session ---------------
-
-/**
- * Build user prompt for coding sessions.
- * Computes conditional hints, then injects them into coding_user.md template.
- */
-function buildCodingPrompt(sessionNum, opts = {}) {
-  const p = paths();
-  const config = loadConfig();
-  const consecutiveFailures = opts.consecutiveFailures || 0;
-  const projectRoot = getProjectRoot();
-
-  // Hint 1: Playwright MCP availability
-  const mcpHint = config.mcpPlaywright
-    ? '前端/全栈任务可用 Playwright MCP（browser_navigate、browser_snapshot、browser_click 等）做端到端测试。'
-    : '';
-
-  // Hint 2: Retry context from previous failures
-  let retryContext = '';
-  if (consecutiveFailures > 0 && opts.lastValidateLog) {
-    retryContext = `\n注意：上次会话校验失败，原因：${opts.lastValidateLog}。请避免同样的问题。`;
-  }
-
-  // Hint 3: Environment readiness
-  let envHint = '';
-  if (consecutiveFailures === 0 && sessionNum > 1) {
-    envHint = '环境已就绪，第二步可跳过 claude-coder init，仅确认服务存活。涉及新依赖时仍需运行 claude-coder init。';
-  }
-
-  // Hint 4: Existing test records
-  let testHint = '';
-  if (fs.existsSync(p.testsFile)) {
-    try {
-      const count = (JSON.parse(fs.readFileSync(p.testsFile, 'utf8')).test_cases || []).length;
-      if (count > 0) testHint = `tests.json 已有 ${count} 条验证记录，Step 5 时先查已有记录避免重复验证。`;
-    } catch { /* ignore */ }
-  }
-
-  // Hint 5: Project documentation awareness + profile quality check
-  let docsHint = '';
-  if (fs.existsSync(p.profile)) {
-    try {
-      const profile = JSON.parse(fs.readFileSync(p.profile, 'utf8'));
-      const docs = profile.existing_docs || [];
-      if (docs.length > 0) {
-        docsHint = `项目文档: ${docs.join(', ')}。Step 4 编码前先读与任务相关的文档，了解接口约定和编码规范。完成后若新增了模块或 API，更新对应文档。`;
-      }
-      if (profile.tech_stack?.backend?.framework &&
-          (!profile.services || profile.services.length === 0)) {
-        docsHint += ' 注意：project_profile.json 的 services 为空，请在本次 session 末尾补全 services 数组（command, port, health_check）。';
-      }
-      if (!docs.length) {
-        docsHint += ' 注意：project_profile.json 的 existing_docs 为空，请在 Step 6 收尾时补全文档列表。';
-      }
-    } catch { /* ignore */ }
-  }
-
-  // Hint 6: Task context (harness pre-read, saves Agent 2-3 Read calls)
-  let taskHint = '';
-  try {
-    const taskData = loadTasks();
-    if (taskData) {
-      const next = findNextTask(taskData);
-      const stats = getStats(taskData);
-      if (next) {
-        taskHint = `任务上下文: ${next.id} "${next.description}" (${next.status}), ` +
-          `category=${next.category}, steps=${next.steps.length}步。` +
-          `进度: ${stats.done}/${stats.total} done, ${stats.failed} failed。` +
-          `项目绝对路径: ${projectRoot}。运行时目录: ${projectRoot}/.claude-coder/（隐藏目录）。` +
-          `第一步无需读取 tasks.json（已注入），直接确认任务后进入 Step 2。`;
-      }
-    }
-  } catch { /* ignore */ }
-
-  // Hint 6b: Test environment variables (readable + writable by Agent)
-  let testEnvHint = '';
-  if (p.testEnvFile && fs.existsSync(p.testEnvFile)) {
-    testEnvHint = `测试凭证文件: ${projectRoot}/.claude-coder/test.env（含 API Key、测试账号等），测试前用 source ${projectRoot}/.claude-coder/test.env 加载。发现新凭证需求时可追加写入（KEY=value 格式）。`;
-  } else {
-    testEnvHint = `如需持久化测试凭证（API Key、测试账号密码等），写入 ${projectRoot}/.claude-coder/test.env（KEY=value 格式，每行一个）。后续 session 会自动感知。`;
-  }
-
-  // Hint 6c: Playwright mode awareness
-  let playwrightAuthHint = '';
-  if (config.mcpPlaywright) {
-    const mode = config.playwrightMode;
-    switch (mode) {
-      case 'persistent':
-        playwrightAuthHint = 'Playwright MCP 使用 persistent 模式（user-data-dir），浏览器登录状态持久保存在本地配置中，无需额外登录操作。';
-        break;
-      case 'isolated':
-        playwrightAuthHint = fs.existsSync(p.playwrightAuth)
-          ? `Playwright MCP 使用 isolated 模式，已检测到登录状态文件（playwright-auth.json），每次会话自动加载 cookies 和 localStorage。`
-          : 'Playwright MCP 使用 isolated 模式，但未检测到登录状态文件。如目标页面需要登录，请先运行 claude-coder auth <URL>。';
-        break;
-      case 'extension':
-        playwrightAuthHint = 'Playwright MCP 使用 extension 模式，已连接用户真实浏览器，直接复用浏览器已有的登录态和扩展。注意：操作会影响用户正在使用的浏览器。';
-        break;
-    }
-  }
-
-  // Hint 7: Session memory (read flat session_result.json)
-  let memoryHint = '';
-  if (fs.existsSync(p.sessionResult)) {
-    try {
-      const sr = JSON.parse(fs.readFileSync(p.sessionResult, 'utf8'));
-      if (sr?.session_result) {
-        memoryHint = `上次会话: ${sr.session_result}（${sr.status_before || '?'} → ${sr.status_after || '?'}）` +
-          (sr.notes ? `, 要点: ${sr.notes.slice(0, 150)}` : '') + '。';
-      }
-    } catch { /* ignore */ }
-  }
-
-  // Hint 8: Service management (continuous vs single-shot mode)
-  const maxSessions = opts.maxSessions || 50;
-  const serviceHint = maxSessions === 1
-    ? '单次模式：收尾时停止所有后台服务。'
-    : '连续模式：收尾时不要停止后台服务，保持服务运行以便下个 session 继续使用。';
-
-  return loadAndRender(p.codingUser, {
-    sessionNum,
-    mcpHint,
-    retryContext,
-    envHint,
-    testHint,
-    docsHint,
-    taskHint,
-    testEnvHint,
-    playwrightAuthHint,
-    memoryHint,
-    serviceHint,
-  });
-}
-
-// --------------- Scan Session ---------------
-
-/**
- * Build user prompt for scan sessions.
- * Scan only generates profile — task decomposition is handled by add session.
- */
-function buildScanPrompt(projectType, requirement) {
-  const p = paths();
-  const requirementLine = requirement
-    ? `用户需求概述: ${requirement.slice(0, 500)}`
-    : '';
-
-  return loadAndRender(p.scanUser, {
-    projectType,
-    requirement: requirementLine,
-  });
-}
-
-// --------------- Add Session ---------------
-
-/**
- * Build lightweight system prompt for add sessions.
- * CLAUDE.md is NOT injected to avoid role conflict and save ~2000 tokens.
- */
-function buildAddSystemPrompt() {
-  return '你是一个任务分解专家，擅长将模糊需求拆解为结构化、可执行的原子任务。你只分析需求和分解任务，不实现任何代码。';
-}
-
-/**
- * Build user prompt for add sessions.
- * Structure: Role (primacy) → Dynamic context → ADD_GUIDE.md (reference) → Instruction (recency)
- */
-function buildAddPrompt(instruction) {
-  const p = paths();
-  const projectRoot = getProjectRoot();
-
-  // --- Load ADD_GUIDE.md reference document ---
-  let addGuide = '';
-  if (fs.existsSync(p.addGuide)) {
-    addGuide = fs.readFileSync(p.addGuide, 'utf8');
-  }
-
-  // --- Context injection: project tech stack ---
-  let profileContext = '';
-  if (fs.existsSync(p.profile)) {
-    try {
-      const profile = JSON.parse(fs.readFileSync(p.profile, 'utf8'));
-      const stack = profile.tech_stack || {};
-      const parts = [];
-      if (stack.backend?.framework) parts.push(`后端: ${stack.backend.framework}`);
-      if (stack.frontend?.framework) parts.push(`前端: ${stack.frontend.framework}`);
-      if (stack.backend?.language) parts.push(`语言: ${stack.backend.language}`);
-      if (parts.length) profileContext = `项目技术栈: ${parts.join(', ')}`;
-    } catch { /* ignore */ }
-  }
-
-  // --- Context injection: existing tasks summary ---
-  let taskContext = '';
-  let recentExamples = '';
-  try {
-    const taskData = loadTasks();
-    if (taskData) {
-      const stats = getStats(taskData);
-      const features = taskData.features || [];
-      const maxId = features.length ? features[features.length - 1].id : 'feat-000';
-      const maxPriority = features.length ? Math.max(...features.map(f => f.priority || 0)) : 0;
-      const categories = [...new Set(features.map(f => f.category))].join(', ');
-
-      taskContext = `已有 ${stats.total} 个任务（${stats.done} done, ${stats.pending} pending, ${stats.failed} failed）。` +
-        `最大 id: ${maxId}, 最大 priority: ${maxPriority}。已有 category: ${categories}。`;
-
-      const recent = features.slice(-3);
-      if (recent.length) {
-        recentExamples = '已有任务格式参考（保持一致性）：\n' +
-          recent.map(f => `  ${f.id}: "${f.description}" (category=${f.category}, steps=${f.steps.length}步, depends_on=[${f.depends_on.join(',')}])`).join('\n');
-      }
-    }
-  } catch { /* ignore */ }
-
-  // --- Conditional: Playwright test rule hint ---
-  let testRuleHint = '';
-  const testRulePath = path.join(p.loopDir, 'test_rule.md');
-  const hasMcp = fs.existsSync(p.mcpConfig);
-  if (fs.existsSync(testRulePath) && hasMcp) {
-    testRuleHint = '【Playwright 测试规则】项目已配置 Playwright MCP（.mcp.json），' +
-      '`.claude-coder/test_rule.md` 包含测试规范（Smart Snapshot、等待策略、步骤模板等）。端到端测试任务请参考 test_rule.md。';
-  }
-
-  return loadAndRender(p.addUser, {
-    profileContext,
-    taskContext,
-    recentExamples,
-    projectRoot,
-    addGuide,
-    testRuleHint,
-    instruction,
-  });
-}
-
-// --------------- Exports ---------------
-
-module.exports = {
-  renderTemplate,
-  loadAndRender,
-  buildSystemPrompt,
-  buildCodingPrompt,
-  buildScanPrompt,
-  buildAddSystemPrompt,
-  buildAddPrompt,
-};

package/src/scanner.js

@@ -1,62 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const { paths, log, ensureLoopDir } = require('./config');
-const { runScanSession } = require('./session');
-
-function validateProfile() {
-  const p = paths();
-  if (!fs.existsSync(p.profile)) return { valid: false, issues: ['profile 不存在'] };
-
-  let profile;
-  try {
-    profile = JSON.parse(fs.readFileSync(p.profile, 'utf8'));
-  } catch {
-    return { valid: false, issues: ['profile JSON 格式错误'] };
-  }
-
-  const issues = [];
-
-  if (!profile.tech_stack?.backend?.framework && !profile.tech_stack?.frontend?.framework) {
-    issues.push('tech_stack 缺少 backend 或 frontend 框架');
-  }
-  if (profile.tech_stack?.backend?.framework &&
-      (!profile.services || profile.services.length === 0)) {
-    issues.push('有后端框架但 services 为空（缺少启动命令和端口）');
-  }
-  if (!profile.existing_docs || profile.existing_docs.length === 0) {
-    issues.push('existing_docs 为空（至少需要 README.md）');
-  }
-
-  return { valid: issues.length === 0, issues };
-}
-
-async function scan(requirement, opts = {}) {
-  const p = paths();
-  ensureLoopDir();
-
-  const maxAttempts = 3;
-  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-    log('info', `初始化尝试 ${attempt} / ${maxAttempts} ...`);
-
-    const result = await runScanSession(requirement, opts);
-
-    if (fs.existsSync(p.profile)) {
-      const profileCheck = validateProfile();
-      if (!profileCheck.valid) {
-        log('warn', `profile 质量问题: ${profileCheck.issues.join('; ')}`);
-      }
-      log('ok', '项目扫描完成');
-      return { success: true, cost: result.cost };
-    }
-
-    if (attempt < maxAttempts) {
-      log('warn', '初始化未完成，将重试...');
-    }
-  }
-
-  log('error', `初始化失败：已重试 ${maxAttempts} 次，关键文件仍未生成`);
-  return { success: false, cost: null };
-}
-
-module.exports = { scan, validateProfile };