@kkelly-offical/kkcode 0.1.6 → 0.2.1

package/src/ui/repl-background-panel.mjs

@@ -0,0 +1,7 @@
+export function renderBackgroundSummaryPanel(backgroundSummary) {
+  if (!backgroundSummary) return []
+  return [
+    `background=${backgroundSummary.active} active (pending:${backgroundSummary.counts.pending}, running:${backgroundSummary.counts.running})`,
+    `background.terminal=completed:${backgroundSummary.counts.completed} interrupted:${backgroundSummary.counts.interrupted} error:${backgroundSummary.counts.error}`
+  ]
+}

package/src/ui/repl-capability-panel.mjs

@@ -0,0 +1,9 @@
+export function renderCapabilityPanel(snapshot) {
+  if (!snapshot) return []
+  return [
+    "capability surface:",
+    `  mode=${snapshot.mode}`,
+    `  commands=${snapshot.customCommands} skills=${snapshot.skills} tools=${snapshot.tools}`,
+    `  mcp=${snapshot.healthyMcp}/${snapshot.mcpServers} healthy agents=${snapshot.agents}`
+  ]
+}

package/src/ui/repl-dashboard.mjs

@@ -1,4 +1,5 @@
 import { homedir } from "node:os"
+import { resolve } from "node:path"
 import { paint } from "../theme/color.mjs"
 
 function stripAnsi(text) {
@@ -101,11 +102,50 @@ function centerLine(text, width) {
 function shortenPath(path) {
   const home = homedir()
   if (!path) return ""
-  const replaced = path.startsWith(home) ? `~${path.slice(home.length)}` : path
+  const normalizedPath = resolve(path).replace(/\\/g, "/")
+  const homeNorm = home ? resolve(home).replace(/\\/g, "/") : ""
+  const replaced = (home && normalizedPath.startsWith(`${homeNorm}/`)) || normalizedPath === homeNorm
+    ? `~${normalizedPath.slice(homeNorm.length)}`
+    : path
   if (replaced.length <= 72) return replaced
   return `...${replaced.slice(-69)}`
 }
 
+function formatMcpStatus(summary) {
+  if (!summary) return []
+  const lines = [
+    `MCP: configured ${summary.configured}, healthy ${summary.healthy}, tools ${summary.tools || 0}`
+  ]
+  if (!summary.configured) {
+    lines.push("  quickstart: kkcode mcp init --project --with-skills")
+    return lines
+  }
+  for (const entry of summary.entries || []) {
+    const byServer = summary.byServer?.[entry.name]
+    const toolCount = byServer !== undefined ? ` (${byServer} tools)` : ""
+    lines.push(`  ${entry.ok ? "✓" : "×"} ${entry.name}${toolCount}`)
+  }
+  return lines
+}
+
+function formatSkillStatus(summary) {
+  if (!summary) return []
+  const mdTotal = summary.template + summary.skillMd
+  const lines = [
+    `Skills: ${summary.total} loaded`,
+    `  markdown: ${mdTotal} (templates: ${summary.template}, dirs: ${summary.skillMd})`,
+    `  mcp prompts: ${summary.mcpPrompt}`,
+    `  programmable: ${summary.programmable}`
+  ]
+  if (summary.total === 0) {
+    lines.push("  quickstart: kkcode skill init --project")
+  }
+  if (summary.total > 0) {
+    lines.push("  try: /code-review /test-plan")
+  }
+  return lines
+}
+
 function renderTag(theme, label, fg = "#0b0b0b", bg = theme.base.accent) {
   return paint(` ${label} `, fg, { bg, bold: true })
 }
@@ -179,6 +219,8 @@ export function renderReplDashboard({
   providers,
   recentSessions,
   customCommandCount,
+  mcpSummary = null,
+  skillSummary = null,
   cwd,
   columns = null
 }) {
@@ -204,7 +246,9 @@ export function renderReplDashboard({
         `Mode: ${state.mode}`,
         `Provider: ${state.providerType}`,
         `Model: ${state.model}`,
-        `Custom commands: ${customCommandCount}`
+        `Custom commands: ${customCommandCount}`,
+        ...formatMcpStatus(mcpSummary),
+        ...formatSkillStatus(skillSummary)
       ]
     },
     {
@@ -226,6 +270,12 @@ export function renderReplDashboard({
       title: "Tips",
       color: theme.semantic.warn,
       items: [
+        ...[
+          "Commands for bootstrap:",
+          "  kkcode mcp discover",
+          "  kkcode mcp init --project",
+          "  kkcode skill init"
+        ],
         "Use /dash to redraw this panel",
         "Use /clear to clear screen",
         "Use /model <id> to override model",
@@ -239,7 +289,7 @@ export function renderReplDashboard({
     },
     {
       title: "Providers",
-      color: theme.modes.ask,
+      color: theme.modes.assistant,
       items: [providers.length ? providers.join(" | ") : "(none configured)"]
     },
     {
@@ -247,7 +297,7 @@ export function renderReplDashboard({
       color: theme.modes.longagent,
       items: [
         "/history /resume /commands /reload",
-        "/ask /plan /agent /longagent"
+        "/assistant /plan /agent /longagent"
       ]
     }
   ]

package/src/ui/repl-help.mjs

@@ -0,0 +1,110 @@
+function padRight(text, width) {
+  const value = String(text || "")
+  return value.length >= width ? value : value + " ".repeat(width - value.length)
+}
+
+export function buildHelpText({ providers = [], userRootPath = "" } = {}) {
+  const W = 30
+  const row = (cmd, desc) => `  ${padRight(cmd, W)} ${desc}`
+  const lines = ["", "Commands:"]
+
+  lines.push("")
+  lines.push("  Session")
+  lines.push(row("/new,/n", "start a new session"))
+  lines.push(row("/resume [id],/r [id]", "resume a previous session"))
+  lines.push(row("/history", "list recent sessions"))
+  lines.push(row("/session,/s", "print current session id"))
+  lines.push(row("/compact", "summarize conversation to free context"))
+  lines.push(row("/undo", "undo last code changes"))
+
+  lines.push("")
+  lines.push("  Mode & Provider")
+  lines.push(row("/assistant /plan /agent /code /longagent", "quick mode switch to the public execution lanes"))
+  lines.push(row("/mode <name>,/m <name>", "switch mode (assistant|plan|agent|code|coding|longagent)"))
+  lines.push(row("/longagent 4stage|hybrid", "switch longagent impl"))
+  lines.push(row("/provider <type>,/p <type>", `switch provider (${providers.join("|") || "configured"})`))
+  lines.push(row("/provider edit <name>", "edit existing provider config"))
+  lines.push(row("/model <id>", "set active model"))
+  lines.push(row("", "assistant = personal CLI + Q&A lane · plan = spec only · agent/code = coding · longagent = staged"))
+
+  lines.push("")
+  lines.push("  Profile & Workspace")
+  lines.push(row("/profile", "view or edit your user profile"))
+  lines.push(row("/like", "show welcome screen / re-run onboarding"))
+  lines.push(row("/trust", "trust this workspace"))
+  lines.push(row("/untrust", "revoke workspace trust"))
+
+  lines.push("")
+  lines.push("  Tools & Display")
+  lines.push(row("/permission [...]", "adjust permission mode/policy"))
+  lines.push(row("/paste [text]", "paste clipboard image"))
+  lines.push(row("/status", "show current runtime state"))
+  lines.push(row("/dash,/home", "redraw dashboard"))
+  lines.push(row("/clear,/cls", "clear terminal"))
+  lines.push(row("/keys,/k", "show key map"))
+
+  lines.push("")
+  lines.push("  Custom Extensions")
+  lines.push(row("/commands", "list custom slash commands"))
+  lines.push(row("/create-skill <desc>", "generate a new skill via AI"))
+  lines.push(row("/create-agent <desc>", "generate a new sub-agent via AI"))
+  lines.push(row("/reload", "reload commands, skills, agents"))
+
+  lines.push("")
+  lines.push(row("/help,/h,/?", "show this help"))
+  lines.push(row("/exit,/quit,/q", "quit"))
+
+  lines.push("")
+  lines.push("Configuration:")
+  lines.push(`  Global config     ${userRootPath}/config.yaml`)
+  lines.push("  Project config    kkcode.config.yaml / .kkcode/config.yaml")
+  lines.push("  Custom commands   .kkcode/commands/    (project-level slash commands)")
+  lines.push(`  Custom skills     ${userRootPath}/skills/    or .kkcode/skills/`)
+  lines.push(`  Custom agents     ${userRootPath}/agents/    or .kkcode/agents/`)
+  lines.push("  Custom tools      .kkcode/tools/       (project-level tool definitions)")
+  lines.push("  Hooks             .kkcode/hooks/       (project-level hook scripts)")
+  lines.push("  Plugin packages   .kkcode-plugin/ or .kkcode/plugins/<name>/")
+  lines.push("  Rules             .kkcode/rules/       (project-level prompt rules)")
+  lines.push("  Instructions      .kkcode/instructions.md or KKCODE.md")
+  lines.push("  MCP servers       config.* -> mcp.servers")
+  lines.push("")
+  lines.push("Key config settings:")
+  lines.push("  provider.default              default provider name")
+  lines.push("  provider.<name>.api_key_env   env var for API key")
+  lines.push("  provider.<name>.default_model default model id")
+  lines.push("  agent.default_mode            startup mode (assistant|plan|agent|code|longagent)")
+  lines.push("  agent.longagent.git.enabled   git branch mgmt (true|false|\"ask\")")
+  lines.push("  permission.mode               tool approvals (auto|manual|yolo)")
+  lines.push("  permission.default_policy     manual policy (ask|allow|deny)")
+  lines.push("  usage.budget.session_usd      per-session cost limit")
+  lines.push("")
+  lines.push("See notice.md in project root for full configuration guide.")
+  return lines.join("\n")
+}
+
+export function buildShortcutLegend() {
+  return [
+    "",
+    "Shortcut Map:",
+    "  /h      Help",
+    "  /n      New session",
+    "  /r      Resume latest session",
+    "  /m      Switch mode",
+    "  /p      Switch provider",
+    "  /k      Show this key map",
+    "  /permission [show|auto|yolo|ask|allow|deny|non-tty <allow_once|deny>|save [project|user]|session-clear]",
+    "  /dash   Redraw dashboard",
+    "  /clear  Clear screen",
+    "  /assistant /plan /agent /code /longagent  Quick lane switch",
+    "",
+    "TUI keys:",
+    "  Enter choose slash suggestion / submit prompt",
+    "  Ctrl+J insert newline (Shift+Enter if terminal supports)",
+    "  /paste paste image from clipboard (Ctrl+V if terminal supports)",
+    "  Up/Down navigate suggestion/history",
+    "  Left/Right/Home/End edit cursor",
+    "  Ctrl+Up/Down scroll log   Ctrl+Home/End oldest/latest",
+    "  Tab cycle lane (assistant -> agent -> longagent -> plan)",
+    "  Esc interrupt turn  Ctrl+C×2 exit"
+  ].join("\n")
+}

package/src/ui/repl-operator-panel.mjs

@@ -0,0 +1,12 @@
+export function renderOperatorPanel(snapshot) {
+  if (!snapshot) return []
+  const lines = [
+    "operator surface:",
+    `  recoverable=${snapshot.recoverableCount}`,
+    `  background.active=${snapshot.activeBackground}`
+  ]
+  for (const action of snapshot.actions || []) {
+    lines.push(`  next: ${action}`)
+  }
+  return lines
+}

package/src/ui/repl-route-feedback.mjs

@@ -0,0 +1,35 @@
+function formatModeLabel(mode) {
+  if (mode === "assistant") return "assistant（个人助手）"
+  if (mode === "agent") return "agent/code（编码）"
+  return String(mode || "assistant")
+}
+
+export function buildRouteFeedback({ route, currentMode, routeSummary = "" } = {}) {
+  if (!route) {
+    return {
+      changedMessage: null,
+      forcedMessage: null,
+      suggestionMessage: null,
+      stayedMessage: null,
+      summaryMessage: null
+    }
+  }
+
+  const routeExplanation = route.explanation || route.reason || ""
+
+  return {
+    changedMessage: route.changed
+      ? `⟳ 自动切换到 ${formatModeLabel(route.mode)} 模式（${routeExplanation}）`
+      : null,
+    forcedMessage: route.forced && route.suggestion
+      ? `⚠ 这看起来是个简单任务（${routeExplanation}），建议用 ${route.suggestion} 模式。输入 y 继续用 longagent，或 n 切换到 ${route.suggestion}。`
+      : null,
+    suggestionMessage: route.suggestion === "longagent" && (currentMode === "assistant" || currentMode === "agent")
+      ? `💡 这看起来是个复杂任务（${routeExplanation}），可以用 /longagent 切换到 longagent 模式获得更好效果。`
+      : null,
+    stayedMessage: !route.changed && !route.suggestion && !(route.forced && route.suggestion) && route.reason !== "low_confidence"
+      ? `↳ 保持 ${formatModeLabel(currentMode)} 模式（${routeExplanation}）`
+      : null,
+    summaryMessage: routeSummary ? `   ${routeSummary}` : null
+  }
+}

package/src/ui/repl-status-view.mjs

@@ -0,0 +1,76 @@
+import { renderStatusBar } from "../theme/status-bar.mjs"
+import { renderReplDashboard, renderReplLogo, renderStartupHint } from "./repl-dashboard.mjs"
+import { formatRuntimeStateText } from "./repl-turn-summary.mjs"
+import { renderOperatorPanel } from "./repl-operator-panel.mjs"
+
+export function renderReplStatusLine({
+  state,
+  configState,
+  theme,
+  tokenMeter,
+  cost,
+  costSavings = 0,
+  contextMeter = null,
+  longagentState = null
+}) {
+  return renderStatusBar({
+    mode: state.mode,
+    model: state.model,
+    permission: configState.config.permission.mode || configState.config.permission.default_policy,
+    tokenMeter,
+    aggregation: configState.config.usage.aggregation,
+    cost,
+    savings: costSavings,
+    contextMeter,
+    showCost: configState.config.ui.status.show_cost,
+    showTokenMeter: configState.config.ui.status.show_token_meter,
+    theme,
+    layout: configState.config.ui.layout,
+    longagentState: state.mode === "longagent" ? longagentState : null,
+    memoryLoaded: state.memoryLoaded
+  })
+}
+
+export function renderRuntimeDashboardView({
+  theme,
+  state,
+  providers,
+  recentSessions,
+  mcpSummary,
+  skillSummary,
+  backgroundSummary,
+  runtimeSummary,
+  operatorSnapshot = null,
+  customCommandCount,
+  cwd,
+  columns = null
+}) {
+  return [
+    renderReplDashboard({
+      theme,
+      state,
+      providers,
+      recentSessions,
+      mcpSummary,
+      skillSummary,
+      backgroundSummary,
+      customCommandCount,
+      cwd,
+      columns
+    }),
+    "",
+    formatRuntimeStateText(state, mcpSummary, skillSummary, backgroundSummary, runtimeSummary),
+    ...(operatorSnapshot ? ["", ...renderOperatorPanel(operatorSnapshot)] : [])
+  ].join("\n")
+}
+
+export function renderStartupScreen({ theme, recentSessions, columns = null }) {
+  const logo = renderReplLogo({ theme, columns })
+  const hint = renderStartupHint(recentSessions)
+  return hint ? `${logo}\n${hint}\n` : logo
+}
+
+export function renderFrameDashboardHeader({ showDashboard, theme, columns = null }) {
+  if (!showDashboard) return []
+  return renderReplLogo({ theme, columns }).split("\n")
+}

package/src/ui/repl-task-panel.mjs

@@ -0,0 +1,5 @@
+import { formatPlanProgress } from "./activity-renderer.mjs"
+
+export function renderTaskProgressPanel(taskProgress, formatter = formatPlanProgress) {
+  return formatter(taskProgress)
+}

package/src/ui/repl-transcript-panel.mjs

@@ -0,0 +1,56 @@
+export function buildTranscriptViewport({
+  logs = [],
+  width,
+  logRows,
+  scrollOffset,
+  wrapLogLines,
+  clipAnsiLine,
+  paint,
+  theme
+}) {
+  const wrappedAllLogs = wrapLogLines(logs, width)
+  const maxOffset = Math.max(0, wrappedAllLogs.length - logRows)
+  const clampedOffset = Math.max(0, Math.min(maxOffset, scrollOffset))
+  const end = Math.max(0, wrappedAllLogs.length - clampedOffset)
+  const start = Math.max(0, end - logRows)
+  const wrappedLogs = wrappedAllLogs.slice(start, end)
+  const scrollMeta = {
+    logRows,
+    totalRows: wrappedAllLogs.length,
+    maxOffset
+  }
+
+  const scrollHint = clampedOffset > 0
+    ? paint(`  Ctrl+Up/Down scroll | +${clampedOffset} lines`, theme.semantic.warn)
+    : paint("  Ctrl+Up/Down scroll | Ctrl+Home oldest | Ctrl+End latest", theme.base.muted, { dim: true })
+
+  const totalLog = wrappedAllLogs.length
+  const showScrollbar = totalLog > logRows
+  let thumbStart = 0
+  let thumbEnd = 0
+  if (showScrollbar) {
+    thumbStart = Math.floor((start / totalLog) * logRows)
+    thumbEnd = Math.min(logRows, thumbStart + Math.max(1, Math.round((logRows / totalLog) * logRows)))
+  }
+
+  const lines = []
+  for (let i = 0; i < logRows; i++) {
+    const content = wrappedLogs[i] || ""
+    if (showScrollbar) {
+      const bar = i >= thumbStart && i < thumbEnd
+        ? paint("┃", theme.semantic.warn)
+        : paint("│", theme.base.border, { dim: true })
+      lines.push(clipAnsiLine(content, width - 2) + " " + bar)
+    } else {
+      lines.push(clipAnsiLine(content, width))
+    }
+  }
+
+  return {
+    lines,
+    scrollHint,
+    scrollMeta,
+    scrollOffset: clampedOffset,
+    wrappedLogs
+  }
+}

package/src/ui/repl-turn-summary.mjs

@@ -0,0 +1,135 @@
+import { paint } from "../theme/color.mjs"
+import { renderBackgroundSummaryPanel } from "./repl-background-panel.mjs"
+
+export function formatRuntimeStateText(state, mcpSummary = null, skillSummary = null, backgroundSummary = null, runtimeSummary = null) {
+  const lines = [
+    `session=${state.sessionId}`,
+    `mode=${state.mode}`,
+    `provider=${state.providerType}`,
+    `model=${state.model}`
+  ]
+  if (state.mode === "longagent" && state.longagentImpl) {
+    lines.push(`longagent.impl=${state.longagentImpl}`)
+  }
+  if (mcpSummary) {
+    lines.push(`mcp=${mcpSummary.healthy}/${mcpSummary.configured} healthy, ${mcpSummary.tools} tools`)
+    if (mcpSummary.configured === 0) {
+      lines.push("mcp.quickstart=kkcode mcp init --project")
+    }
+  }
+  if (skillSummary) {
+    const mdCount = skillSummary.template + skillSummary.skillMd
+    lines.push(`skills=${skillSummary.total} loaded (md:${mdCount}, mcp:${skillSummary.mcpPrompt}, mjs:${skillSummary.programmable})`)
+    if (skillSummary.total === 0) {
+      lines.push("skills.quickstart=kkcode skill init --project")
+    }
+  }
+  if (backgroundSummary) {
+    lines.push(...renderBackgroundSummaryPanel(backgroundSummary))
+  }
+  if (runtimeSummary) {
+    lines.push(`session.messages=${runtimeSummary.messageCount}`)
+    lines.push(`session.parts=${runtimeSummary.partCount}`)
+    lines.push(`session.recoverable=${runtimeSummary.recoverableCount}`)
+    if (runtimeSummary.audit) {
+      lines.push(`audit.total=${runtimeSummary.audit.total} error=${runtimeSummary.audit.errorCount}`)
+    }
+  }
+  return lines.join("\n")
+}
+
+export function normalizeFileChanges(toolEvents = []) {
+  const rows = []
+  for (const event of toolEvents || []) {
+    if (!event || !["write", "edit"].includes(event.name)) continue
+    const changes = Array.isArray(event?.metadata?.fileChanges) ? event.metadata.fileChanges : []
+    for (const item of changes) {
+      const path = String(item?.path || event.args?.path || "").trim()
+      if (!path) continue
+      rows.push({
+        path,
+        addedLines: Number(item?.addedLines || 0),
+        removedLines: Number(item?.removedLines || 0),
+        stageId: item?.stageId ? String(item.stageId) : "",
+        taskId: item?.taskId ? String(item.taskId) : ""
+      })
+    }
+  }
+
+  const grouped = new Map()
+  for (const row of rows) {
+    const key = `${row.path}::${row.stageId}::${row.taskId}`
+    const prev = grouped.get(key) || {
+      path: row.path,
+      addedLines: 0,
+      removedLines: 0,
+      stageId: row.stageId,
+      taskId: row.taskId
+    }
+    prev.addedLines += row.addedLines
+    prev.removedLines += row.removedLines
+    grouped.set(key, prev)
+  }
+  return [...grouped.values()]
+}
+
+export function renderFileChangeLines(fileChanges = [], limit = 20) {
+  const lines = []
+  const rows = fileChanges.slice(0, limit)
+  for (const item of rows) {
+    const scope = [item.stageId, item.taskId].filter(Boolean).join("/")
+    const suffix = scope ? paint(` (${scope})`, null, { dim: true }) : ""
+    const add = item.addedLines > 0
+      ? paint(`+${item.addedLines}`, "#00ff00", { bold: true })
+      : paint("+0", null, { dim: true })
+    const del = item.removedLines > 0
+      ? paint(`-${item.removedLines}`, "#ff4444", { bold: true })
+      : paint("-0", null, { dim: true })
+    lines.push(`  ${paint(item.path, "white")}  ${add} ${del}${suffix}`)
+  }
+  if (fileChanges.length > rows.length) {
+    lines.push(paint(`  ... +${fileChanges.length - rows.length} more file(s)`, null, { dim: true }))
+  }
+  return lines
+}
+
+export function normalizeDiagnostics(toolEvents = []) {
+  const summaries = []
+  for (const event of toolEvents || []) {
+    const diagnostics = event?.metadata?.diagnostics
+    if (!diagnostics) continue
+    const summary = diagnostics.summary || {}
+    const currentSummary = diagnostics.after?.summary || diagnostics.current?.summary || {}
+    const delta = diagnostics.delta || {}
+    summaries.push({
+      tool: String(event?.name || ""),
+      path: String(event?.args?.path || diagnostics.current?.diagnostics?.[0]?.file || diagnostics.baseline?.diagnostics?.[0]?.file || "").trim(),
+      introduced: Number(summary.introduced || delta.added?.length || 0),
+      persistent: Number(summary.persistent || delta.persisted?.length || 0),
+      resolved: Number(summary.resolved || delta.resolved?.length || 0),
+      unchanged: Boolean(summary.unchanged || delta.unchanged),
+      errorCount: Number(currentSummary.errorCount || currentSummary.errors || 0),
+      warningCount: Number(currentSummary.warningCount || currentSummary.warnings || 0),
+      status: String(summary.status || diagnostics.after?.status || diagnostics.current?.status || diagnostics.status || "")
+    })
+  }
+  return summaries
+}
+
+export function renderDiagnosticsLines(rows = [], limit = 10) {
+  const lines = []
+  const visible = rows.slice(0, limit)
+  for (const item of visible) {
+    const label = item.path || item.tool || "diagnostics"
+    const summary = item.unchanged
+      ? "no change"
+      : `+${item.introduced} / ${item.persistent} / -${item.resolved}`
+    const totals = `${item.errorCount} error(s), ${item.warningCount} warning(s)`
+    const status = item.status ? paint(` ${item.status}`, null, { dim: true }) : ""
+    lines.push(`  ${paint(label, "white")}  ${paint(summary, "yellow", { bold: true })}  ${paint(totals, null, { dim: true })}${status}`)
+  }
+  if (rows.length > visible.length) {
+    lines.push(paint(`  ... +${rows.length - visible.length} more diagnostics result(s)`, null, { dim: true }))
+  }
+  return lines
+}