thincoder 0.7.8 → 0.8.0

package/src/tui/agent-turn.mjs

@@ -0,0 +1,254 @@
+import { runAgent, ContinueError } from "../agent.mjs"
+import { saveSession } from "../session.mjs"
+import { sliceByWidth } from "./render.mjs"
+import { ansi, C } from "./ansi.mjs"
+
+/** 执行一轮 agent 对话（从 submit 或队列取出调用）。
+ *  从 index.mjs 抽出：agent 循环 + 回调构建 + 错误处理 + 队列处理。
+ *  ctx: { agent, state, pushLine, pushLabel, render, scheduleRender,
+ *         ensureAssistantLabel, askPermission, askQuestion,
+ *         handleSlash, summarize } */
+export async function runAgentTurn(ctx, text) {
+  const { agent, state, pushLine, pushLabel, render, scheduleRender, ensureAssistantLabel, askPermission, askQuestion, handleSlash, summarize } = ctx
+  pushLabel(`❯ You:`, ansi.bold + C.user)
+  pushLine(text, C.text)
+
+  // 任务开始前自动打存档点 (git 仓库内；失败静默，不挡任务）
+  try {
+    const { createCheckpoint } = await import("../git/checkpoint.mjs")
+    await createCheckpoint(agent.cwd)
+  } catch {
+    // 存档失败不影响任务
+  }
+
+  ctx.assistantLabeled = false
+  state.processing = true
+  state.status = "Processing..."
+  state.streaming = ""
+  state.reasoning = ""
+  state.subTasks = {}
+  state.currentTool = null
+  state.processingStarted = Date.now()
+  state.controller = new AbortController()
+  // 处理中每秒刷新一次状态栏 (运行计时）
+  const ticker = setInterval(() => {
+    if (state.processing) render()
+  }, 1000)
+  render()
+
+  const flushStream = () => {
+    if (state.reasoning) {
+      pushLine(state.reasoning, C.reason)
+      state.reasoning = ""
+    }
+    if (state.streaming) {
+      pushLine(state.streaming, C.text)
+      state.streaming = ""
+    }
+  }
+
+  const callbacks = {
+    onToken: (t) => {
+      // 子 agent 流式输出：前缀格式 role#id/ → 提取 id，更新对应 subTask 的流式文本
+      const subMatch = t.match(/^(\w+)#(\d+)\//)
+      if (subMatch) {
+        const key = `${subMatch[1]}#${subMatch[2]}`
+        const payload = t.slice(subMatch[0].length)
+        if (!state.subTasks[key]) {
+          state.subTasks[key] = { key, role: subMatch[1], text: "", tool: null, done: false, started: Date.now() }
+        }
+        state.subTasks[key].text += payload
+        if (state.subTasks[key].text.length > 2000) {
+          state.subTasks[key].text = state.subTasks[key].text.slice(-2000)
+        }
+        scheduleRender()
+        return
+      }
+      ensureAssistantLabel()
+      state.streaming += t
+      scheduleRender()
+    },
+    onReasoning: (t) => {
+      // 子 agent 的思考 token 同样带 role#id/ 前缀，进 subTasks 面板
+      const subMatch = t.match(/^(\w+)#(\d+)\//)
+      if (subMatch) {
+        const key = `${subMatch[1]}#${subMatch[2]}`
+        if (!state.subTasks[key]) {
+          state.subTasks[key] = { key, role: subMatch[1], text: "", tool: null, done: false, started: Date.now() }
+        }
+        scheduleRender()
+        return
+      }
+      ensureAssistantLabel()
+      state.reasoning += t
+      scheduleRender()
+    },
+    onToolCall: (name, args) => {
+      // 子 agent 工具调用：前缀 role#id/toolName → 更新对应 subTask 的当前工具
+      const subMatch = name.match(/^(\w+)#(\d+)\//)
+      if (subMatch) {
+        const key = `${subMatch[1]}#${subMatch[2]}`
+        const toolName = name.slice(subMatch[0].length)
+        if (!state.subTasks[key]) {
+          state.subTasks[key] = { key, role: subMatch[1], text: "", tool: null, done: false, started: Date.now() }
+        }
+        state.subTasks[key].tool = toolName
+        state.subTasks[key].toolArgs = args
+        state.subTasks[key].text = ""
+        scheduleRender()
+        return
+      }
+      flushStream()
+      ensureAssistantLabel()
+      state.currentTool = name
+      pushLine(`  [tool] ${name} ${summarize(args)}`, C.tool)
+    },
+    onToolResult: (name, result) => {
+      state.currentTool = null
+      // 子 agent 结束：标记最早创建的 running subTask 为 done
+      const isSubagent = name === "subagent"
+      if (isSubagent) {
+        const running = Object.entries(state.subTasks)
+          .filter(([, s]) => !s.done)
+          .sort(([, a], [, b]) => a.started - b.started)
+        if (running.length > 0) {
+          const [key] = running[0]
+          state.subTasks[key].done = true
+          state.subTasks[key].tool = null
+        }
+        // 子 agent 报告摘要 (最多 8 行）直接展示在对话区
+        const lines = result.split("\n")
+        const preview = lines.slice(0, 8).map((l) => l.slice(0, 120)).join("\n")
+        if (preview) pushLine(preview, C.dim)
+        if (lines.length > 8) pushLine(`  ... (${lines.length - 8} more lines)`, C.dim)
+        // 3 秒后清除面板中 done 的条目
+        setTimeout(() => {
+          for (const key of Object.keys(state.subTasks)) {
+            if (state.subTasks[key].done) delete state.subTasks[key]
+          }
+          if (state.processing) render()
+        }, 3000)
+      }
+      const stream = state.toolStreams[name]
+      if (stream) {
+        const tail = stream.trimEnd().slice(-4000)
+        if (tail) pushLine(tail, C.dim)
+        delete state.toolStreams[name]
+      }
+      if (!isSubagent) {
+        const first = result.split("\n")[0]
+        pushLine(`  [done] ${name} → ${sliceByWidth(first, 100)}`, C.dim)
+      }
+    },
+    onToolOutput: (name, chunk) => {
+      state.toolStreams[name] = (state.toolStreams[name] ?? "") + chunk
+      scheduleRender()
+    },
+    onPermissionRequest: (name, args) => askPermission(name, args),
+    onQuestion: (text, options) => askQuestion(text, options),
+    onCompress: () => {
+      pushLine("  [context] Context too long, auto-compacted (early conversation summarized by LLM, task state preserved)", C.warn)
+    },
+    onUsage: (usage) => {
+      state.tokens.prompt += usage.prompt_tokens ?? 0
+      state.tokens.completion += usage.completion_tokens ?? 0
+      state.tokens.cacheHit += usage.prompt_cache_hit_tokens ?? 0
+      state.tokens.cacheMiss += usage.prompt_cache_miss_tokens ?? 0
+    },
+    // 节流等待 (主动闸门 / 429 退避）：状态栏明示，防用户以为卡死
+    onWait: ({ phase, seconds }) => {
+      state.status = phase === "gate" ? `TPM throttle wait ~${seconds}s` : `Rate-limited 429, retry in ${seconds}s`
+      render()
+    },
+    onTaskUpdate: (items) => {
+      state.tasks = items
+      const done = items.filter((i) => i.status === "done").length
+      // 留痕带上current任务标题：回看历史时知道进行到哪一项
+      const current = items.find((i) => i.status === "in_progress")
+      pushLine(`  [task] ${done}/${items.length}${current ? ` ▶ ${current.title}` : ""}`, C.dim)
+      render()
+    },
+    // 增量保存：每 5 个工具 turn 落一次盘，中途崩溃丢失窗口从一整轮缩到几轮
+    onTurnEnd: (() => {
+      let n = 0
+      return () => {
+        if (++n % 5 !== 0) return
+        try { saveSession(agent, state.lines) } catch {}
+      }
+    })(),
+  }
+
+  for (let resume = false; ; resume = true) {
+    try {
+      await runAgent(agent, text, callbacks, { signal: state.controller.signal, resume })
+      flushStream()
+      break // 正常完成，退出循环
+    } catch (error) {
+      flushStream()
+      if (error.name === "AbortError" || state.controller?.signal.aborted) {
+        pushLine("[stopped]", C.warn)
+        break
+      }
+      if (error instanceof ContinueError) {
+        pushLabel(`❯ Continue`, ansi.bold + C.warn)
+        pushLine(`Ran ${error.turn} turns (limit ${error.turn}). Continue?`, C.warn)
+        // 暂停询问：复用 permission 机制
+        const willContinue = await new Promise((resolve) => {
+          state.permission = {
+            name: "continue",
+            args: { turns: error.turn },
+            resolve,
+          }
+          state.status = `Continue after ${error.turn} turns?`
+          render()
+        })
+        state.permission = null
+        if (!willContinue) {
+          pushLine("[continue cancelled]", C.warn)
+          break
+        }
+        pushLine("[continuing…]", C.tool)
+        // 重创新 AbortController：旧 signal 一旦 abort 过，resume 会立即失败 (防御性，current路径不可达但耦合紧）
+        state.controller = new AbortController()
+        continue
+      }
+      pushLine(`[error] ${error.message}`, C.error)
+      break
+    }
+  }
+
+  clearInterval(ticker)
+  state.processing = false
+  state.subTasks = {}
+  state.controller = null
+  state.status = "Ready"
+  // 全部完成时自动收起 todo 面板 (对齐 kimi-code TUI；agent.tasks 本身保留）
+  if (state.tasks.length > 0 && state.tasks.every((t) => t.status === "done")) {
+    state.tasks = []
+  }
+  // 每轮结束后保存会话 (崩溃也不丢）
+  try {
+    saveSession(agent, state.lines)
+  } catch {
+    // 存失败不打断使用
+  }
+  render()
+
+  // 队列里有待执行消息：自动取下一条执行
+  if (state.queue.length > 0) {
+    const next = state.queue.shift()
+    // 队列里的斜杠命令直接执行
+    if (next.text.startsWith("/")) {
+      await handleSlash(next.text)
+      render()
+      // 斜杠命令执行完也继续检查队列
+      if (state.queue.length > 0 && !state.processing) {
+        const next2 = state.queue.shift()
+        await runAgentTurn(ctx, next2.text)
+      }
+    } else {
+      pushLabel(`❯ You: (from queue)`, ansi.bold + C.user)
+      await runAgentTurn(ctx, next.text)
+    }
+  }
+}

package/src/tui/ansi.mjs

@@ -0,0 +1,32 @@
+/**
+ * tui-ansi.mjs — ANSI 转义序列与终端颜色常量
+ * 零依赖，纯常量导出。
+ */
+
+export const ESC = "\x1b"
+export const ansi = {
+  hideCursor: `${ESC}[?25l`,
+  showCursor: `${ESC}[?25h`,
+  altBuffer: `${ESC}[?1049h`,
+  mainBuffer: `${ESC}[?1049l`,
+  mouseOn: `${ESC}[?1000h${ESC}[?1006h`,
+  mouseOff: `${ESC}[?1000l${ESC}[?1006l`,
+  home: `${ESC}[H`,
+  clearLine: `${ESC}[K`,
+  reset: `${ESC}[0m`,
+  dim: `${ESC}[2m`,
+  bold: `${ESC}[1m`,
+  fg: (n) => `${ESC}[${30 + n}m`,
+  gray: `${ESC}[90m`,
+}
+
+export const C = {
+  user: ansi.fg(4),
+  assistant: ansi.fg(2),
+  text: ansi.fg(7),
+  reason: `${ESC}[2m${ESC}[3m`,
+  tool: ansi.fg(6),
+  error: ansi.fg(1),
+  dim: ansi.gray,
+  warn: ansi.fg(3),
+}

package/src/tui/clipboard.mjs

@@ -0,0 +1,48 @@
+import { C } from "./ansi.mjs"
+
+/** Ctrl+V / Alt+V：读取剪贴板图片 → 写入工作目录临时文件 → 输入框插入 read_image 命令。
+ *  从 index.mjs 抽出。
+ *  ctx: { agent, state, pushLine, render } */
+export async function pasteClipboardImage(ctx) {
+  const { agent, state, pushLine, render } = ctx
+  const { execFile } = await import("node:child_process")
+  const { mkdir, stat, unlink } = await import("node:fs/promises")
+  const { join } = await import("node:path")
+
+  const run = (cmd, args) => new Promise((resolve, reject) => {
+    execFile(cmd, args, { timeout: 10000 }, (err, stdout) => { if (err) reject(err); else resolve(stdout) })
+  })
+
+  const dest = join(agent.cwd, `.thincoder-paste-${Date.now()}.png`)
+  const isWin = process.platform === "win32"
+  const isMac = process.platform === "darwin"
+
+  try {
+    if (isWin) {
+      const psScript = `Add-Type -AssemblyName System.Windows.Forms; if ([System.Windows.Forms.Clipboard]::ContainsImage()) { [System.Windows.Forms.Clipboard]::GetImage().Save('${dest.replace(/\\/g, "\\\\")}', [System.Drawing.Imaging.ImageFormat]::Png); exit 0 } else { exit 1 }`
+      await run("powershell", ["-NoProfile", "-Command", psScript])
+    } else if (isMac) {
+      const script = `try; set f to (POSIX file "${dest}"); set img to the clipboard as «class PNGf»; set fd to open for access f with write permission; write img to fd; close access fd; end try`
+      await run("osascript", ["-e", script])
+    } else {
+      await run("bash", ["-c", `xclip -selection clipboard -t image/png -o > "${dest}" 2>/dev/null || { which wl-paste >/dev/null 2>&1 && wl-paste -t image/png > "${dest}" 2>/dev/null; } || exit 1`])
+    }
+  } catch {
+    pushLine("Clipboard does not contain an image, or clipboard access failed", C.dim)
+    try { await unlink(dest) } catch {}
+    return
+  }
+
+  const st = await stat(dest).catch(() => null)
+  if (!st || st.size === 0) {
+    pushLine("Clipboard does not contain an image, or clipboard access failed", C.dim)
+    try { await unlink(dest) } catch {}
+    return
+  }
+
+  const cmd = `read_image ${dest}`
+  state.input.splice(state.cursor, 0, ...[...cmd])
+  state.cursor += cmd.length
+  pushLine(`[image pasted → ${dest}]`, C.tool)
+  render()
+}

package/src/tui/cmd-auto.mjs

@@ -0,0 +1,21 @@
+import { ansi, C } from "./ansi.mjs"
+
+/** /auto 命令：切换 auto-approve 模式。
+ *  ctx: { agent, pushLine, pushLabel } */
+export async function handleAutoCommand(ctx) {
+  const { agent, pushLine, pushLabel } = ctx
+  agent.autoApprove = !agent.autoApprove
+  agent._pendingReminders = agent._pendingReminders ?? []
+  if (agent.autoApprove) {
+    agent._pendingReminders.push("[System reminder: AUTO mode is now ON. All tool calls are automatically approved — you may write, edit, and run commands without asking. Use this for long autonomous tasks. The user can still interrupt.]")
+  } else {
+    agent._pendingReminders.push("[System reminder: AUTO mode is now OFF. Destructive tool calls now require user approval again. Confirm before writing files, running commands, or spawning subagents.]")
+  }
+  pushLabel(`❯ Auto`, ansi.bold + (agent.autoApprove ? C.warn : C.tool))
+  pushLine(
+    agent.autoApprove
+      ? `AUTO ON: all tool calls (write/bash/subagent) auto-approved. For long tasks. /auto to disable.`
+      : `AUTO OFF: destructive tool calls require per-use approval again.`,
+    agent.autoApprove ? C.warn : C.dim,
+  )
+}

package/src/tui/cmd-clear.mjs

@@ -0,0 +1,26 @@
+/** /clear 命令：清屏（二次确认防误触）。
+ *  ctx: { state, openPicker, render } */
+export async function handleClearCommand(ctx) {
+  const { state, openPicker, render } = ctx
+  if (state.lines.length > 0) {
+    openPicker({
+      title: "Clear screen?",
+      entries: [
+        { type: "item", text: "Yes, clear all conversation output", action: "yes" },
+        { type: "item", text: "Cancel", action: "no" },
+      ],
+      defaultIndex: 1,
+      onSelect: (e) => {
+        if (e.action === "yes") {
+          state.lines = []
+          state.streaming = ""
+          render()
+        }
+      },
+    })
+    return
+  }
+  state.lines = []
+  state.streaming = ""
+  render()
+}

package/src/tui/cmd-config.mjs

@@ -0,0 +1,72 @@
+import { existsSync, readFileSync } from "node:fs"
+import { ansi, C } from "./ansi.mjs"
+
+/** /config 命令：设置 embedding key / 高级 path=value 配置。
+ *  从 slash-commands.mjs 抽出。
+ *  ctx: { agent, pushLine, pushLabel, openPicker, askQuestion, persistRaw, maskKey, ansi, C } */
+export async function handleConfigCommand(ctx) {
+  const { agent, pushLine, pushLabel, openPicker, askQuestion, persistRaw, maskKey } = ctx
+  const { configPath } = await import("../config.mjs")
+  const cp = configPath
+  const ac = agent.config?.agent ?? {}
+  const entries = [
+    { type: "header", text: "Current config" },
+    { type: "item", text: "Set embedding key (vector search)", action: "embedkey" },
+    { type: "item", text: "Advanced (set path value)", action: "set" },
+  ]
+  openPicker({
+    title: "Config",
+    entries,
+    onSelect: async (e) => {
+      if (e.action === "view") {
+        pushLabel(`❯ Config`, ansi.bold + C.tool)
+        pushLine(`Active: ${agent.activeProvider} / ${agent.provider.model}`, C.dim)
+        pushLine(`Key:    ${maskKey(agent.provider.apiKey)}`, C.dim)
+        const tn = `${ac.compactThreshold ?? 100000}${ac.compactThresholdAuto ? " (auto)" : ""}`
+        pushLine(`agent:  maxTurns=${ac.maxTurns ?? 100} | compactThreshold=${tn}`, C.dim)
+        pushLine(`embedding: ${agent.memory?.embedder ? `enabled (${agent.config?.embedding?.model ?? ""})` : "disabled (FTS only)"}`, C.dim)
+        pushLine(`Config file: ${cp}`, C.dim)
+        return
+      }
+      if (e.action === "embedkey") {
+        const embKey = await askQuestion("Enter embedding API key (default: SiliconFlow bge-m3):")
+        if (!embKey) return
+        agent.config.embedding ??= {}
+        agent.config.embedding.apiKey = embKey
+        await persistRaw((raw) => { raw.embedding = { ...(raw.embedding ?? {}), apiKey: embKey } })
+        if (agent.memory) {
+          const { createEmbedder } = await import("../embedding.mjs")
+          agent.memory.embedder = createEmbedder(agent.config.embedding)
+        }
+        pushLabel(`❯ Config`, ansi.bold + C.tool)
+        pushLine(`Embedding key saved, vector search enabled`, C.tool)
+        return
+      }
+      if (e.action === "set") {
+        const settext = await askQuestion("Enter: <path> <value> (e.g. agent.maxTurns 80, supports a.b nesting):")
+        if (!settext) return
+        const parts = settext.split(/\s+/)
+        const [path, value] = [parts[0], parts.slice(1).join(" ")]
+        if (!path || !value) { pushLine("Usage: <path> <value>  e.g. agent.maxTurns 80", C.error); return }
+        try {
+          const { configPath, loadConfig, saveConfig } = await import("../config.mjs")
+          const raw = existsSync(configPath) ? JSON.parse(readFileSync(configPath, "utf8")) : {}
+          const keys = path.split(".")
+          let obj = raw
+          for (let i = 0; i < keys.length - 1; i++) { obj[keys[i]] ??= {}; obj = obj[keys[i]] }
+          obj[keys[keys.length - 1]] = isNaN(value) ? value : Number(value)
+          saveConfig(raw)
+          const cfg = loadConfig()
+          agent.provider = cfg.provider
+          agent.providers = cfg.providersList
+          agent.activeProvider = cfg.activeProvider
+          agent.config = cfg
+          pushLabel(`❯ Config`, ansi.bold + C.tool)
+          pushLine(`Saved: ${path} = ${value}`, C.tool)
+        } catch (error) {
+          pushLine(`Save failed: ${error.message}`, C.error)
+        }
+      }
+    },
+  })
+}

package/src/tui/cmd-exit.mjs

@@ -0,0 +1,5 @@
+/** /exit 命令：退出 TUI。
+ *  ctx: { exit } — exit 是 index.mjs 注入的 cleanup + process.exit 回调 */
+export async function handleExitCommand(ctx) {
+  ctx.exit()
+}

package/src/tui/cmd-extract.mjs

@@ -0,0 +1,5 @@
+/** /extract 命令：从当前会话提取知识。
+ *  ctx: { runDistill } */
+export async function handleExtractCommand(ctx) {
+  await ctx.runDistill()
+}

package/src/tui/cmd-goal.mjs

@@ -0,0 +1,47 @@
+import { ansi, C } from "./ansi.mjs"
+
+/** /goal 命令：设置/查看/取消长期目标。
+ *  从 slash-commands.mjs 抽出。
+ *  ctx: { agent, pushLine, pushLabel, openPicker, askQuestion } */
+export async function handleGoalCommand(ctx) {
+  const { agent, pushLine, pushLabel, openPicker, askQuestion } = ctx
+  const entries = [
+    { type: "header", text: agent.goal ? `Current goal: ${agent.goal.objective.slice(0, 60)}` : "Actions" },
+    { type: "item", text: "Set new goal", action: "set" },
+  ]
+  if (agent.goal) {
+    entries.push({ type: "item", text: "Cancel goal", action: "cancel" })
+    entries.push({ type: "item", text: "View details", action: "view" })
+  }
+  openPicker({
+    title: "Goal",
+    entries,
+    onSelect: async (e) => {
+      if (e.action === "view") {
+        const statusText = { active: "active", complete: "completed", blocked: "blocked" }[agent.goal.status] ?? agent.goal.status
+        pushLabel(`❯ Goal`, ansi.bold + C.warn)
+        pushLine(`Goal: ${agent.goal.objective}`, C.tool)
+        if (agent.goal.criteria) pushLine(`  Criteria: ${agent.goal.criteria}`, C.dim)
+        pushLine(`  Status: ${statusText} │ Turns used: ${agent.goal.turnsUsed ?? 0} │ Set at: ${new Date(agent.goal.setAt).toLocaleString()}`, C.dim)
+        return
+      }
+      if (e.action === "cancel") {
+        agent.goal = null
+        pushLabel(`❯ Goal`, ansi.bold + C.dim)
+        pushLine(`Goal cancelled.`, C.dim)
+        return
+      }
+      // set — 需要输入目标文本
+      const goalText = await askQuestion("Enter goal description (; separates criteria)")
+      if (!goalText) return
+      const semi = goalText.indexOf("；") >= 0 ? "；" : goalText.indexOf(";") >= 0 ? ";" : null
+      const objective = semi ? goalText.slice(0, semi).trim() : goalText.trim()
+      const criteria = semi ? goalText.slice(semi + 1).trim() : ""
+      agent.goal = { objective, criteria, setAt: Date.now(), status: "active", turnsUsed: 0, _blockTally: null }
+      pushLabel(`❯ Goal`, ansi.bold + C.warn)
+      pushLine(`Goal set: ${objective}`, C.tool)
+      if (criteria) pushLine(`  Criteria: ${criteria}`, C.dim)
+      else pushLine(`  ⚠ No criteria — agent will be asked to provide verifiable criteria when using goal set`, C.warn)
+    },
+  })
+}

package/src/tui/cmd-help.mjs

@@ -0,0 +1,25 @@
+import { ansi, C } from "./ansi.mjs"
+
+/** /help 命令：列出所有斜杠命令及别名。
+ *  ctx: { pushLine, pushLabel, SLASH_COMMANDS } */
+export async function handleHelpCommand(ctx) {
+  const { pushLine, pushLabel, SLASH_COMMANDS } = ctx
+  const aliasList = { "/help": "/h", "/exit": "/x", "/model": "/m", "/plan": "/p", "/think": "/t", "/clear": "/c", "/new": "/n" }
+  const order = ["Agent", "Session", "Tools", "Config"]
+  const byGroup = new Map()
+  for (const c of SLASH_COMMANDS) {
+    if (!c.group) continue
+    if (!byGroup.has(c.group)) byGroup.set(c.group, [])
+    byGroup.get(c.group).push(c)
+  }
+  pushLabel(`❯ Help`, ansi.bold + C.tool)
+  for (const group of order) {
+    const cmds = byGroup.get(group)
+    if (!cmds) continue
+    pushLine(`  ${group}:`, C.dim)
+    for (const c of cmds) {
+      const alias = aliasList[c.name]
+      pushLine(`    ${c.name.padEnd(12)}${alias ? ` (${alias})`.padEnd(8) : "        "} ${c.desc}`, C.text)
+    }
+  }
+}

package/src/tui/cmd-init.mjs

@@ -0,0 +1,91 @@
+import { existsSync } from "node:fs"
+import { basename } from "node:path"
+import { ansi, C } from "./ansi.mjs"
+
+/** /init 命令：探测项目类型，生成 AGENTS.md 骨架。
+ *  从 slash-commands.mjs 抽出。
+ *  ctx: { agent, pushLine, pushLabel } */
+export async function handleInitCommand(ctx) {
+  const { agent, pushLine, pushLabel } = ctx
+  const { writeFile, readFile } = await import("node:fs/promises")
+  const { join } = await import("node:path")
+  const agPath = join(agent.cwd, "AGENTS.md")
+  if (existsSync(agPath)) {
+    pushLine(`AGENTS.md already exists: ${agPath}`, C.warn)
+    return
+  }
+
+  // 探测项目类型与关键信息
+  let name = basename(agent.cwd)
+  let lang = "", cmds = ""
+
+  // Node.js
+  try {
+    const pkg = JSON.parse(await readFile(join(agent.cwd, "package.json"), "utf8"))
+    if (pkg.name) name = pkg.name
+    lang = "Node.js"
+    const ks = Object.keys(pkg.scripts ?? {})
+    if (ks.length) cmds = ks.slice(0, 5).map(k => `- \`npm run ${k}\``).join("\n")
+  } catch {}
+
+  // Python
+  if (!lang) {
+    for (const f of ["requirements.txt", "pyproject.toml", "setup.py", "setup.cfg"]) {
+      if (existsSync(join(agent.cwd, f))) { lang = "Python"; break }
+    }
+    if (lang) cmds = "- `pip install -r requirements.txt`\n- `python -m pytest`"
+  }
+
+  // Go
+  if (!lang) {
+    if (existsSync(join(agent.cwd, "go.mod"))) {
+      lang = "Go"
+      cmds = "- `go build ./...`\n- `go test ./...`"
+    }
+  }
+
+  // Rust
+  if (!lang) {
+    if (existsSync(join(agent.cwd, "Cargo.toml"))) {
+      lang = "Rust"
+      cmds = "- `cargo build`\n- `cargo test`"
+    }
+  }
+
+  // Java / Kotlin
+  if (!lang) {
+    if (existsSync(join(agent.cwd, "pom.xml"))) { lang = "Java (Maven)"; cmds = "- `mvn test`" }
+    else if (existsSync(join(agent.cwd, "build.gradle")) || existsSync(join(agent.cwd, "build.gradle.kts"))) { lang = "Java/Kotlin (Gradle)"; cmds = "- `./gradlew test`" }
+  }
+
+  const lines = [
+    `# AGENTS.md — ${name} Project Guide`,
+    ``,
+    `## Project Overview`,
+    ``,
+    `Brief description of what this project does.`,
+    ``,
+    `## Tech Stack`,
+    ``,
+    lang ? `- Language: ${lang}` : `- Language: (detect and fill in)`,
+    `- Framework: (fill in if applicable)`,
+    ``,
+    `## Common Commands`,
+    ``,
+    cmds || `- (fill in build/test/run commands)`,
+    ``,
+    `## Coding Conventions`,
+    ``,
+    `- (fill in: naming, formatting, testing patterns)`,
+    ``,
+    `## Architecture Notes`,
+    ``,
+    `- (fill in: key modules, data flow, design decisions)`,
+  ]
+
+  const template = lines.join("\n")
+  await writeFile(agPath, template, "utf8")
+  pushLabel(`❯ Init`, ansi.bold + C.tool)
+  pushLine(`Generated AGENTS.md → ${agPath}${lang ? ` (${lang})` : ""}`, C.tool)
+  if (lang) pushLine("Tell me more about the project and I will fill in conventions and structure", C.dim)
+}