@kkelly-offical/kkcode 0.1.2

package/src/commands/longagent.mjs

@@ -0,0 +1,100 @@
+import { Command } from "commander"
+import { LongAgentManager } from "../orchestration/longagent-manager.mjs"
+
+export function createLongagentCommand() {
+  const cmd = new Command("longagent").description("manage longagent sessions")
+
+  cmd
+    .command("status")
+    .description("show one longagent session or list all")
+    .option("--session <id>", "session id")
+    .action(async (options) => {
+      if (options.session) {
+        const item = await LongAgentManager.get(options.session)
+        if (!item) {
+          console.error(`not found: ${options.session}`)
+          process.exitCode = 1
+          return
+        }
+        console.log(JSON.stringify(item, null, 2))
+        return
+      }
+      const list = await LongAgentManager.list()
+      console.log(JSON.stringify(list, null, 2))
+    })
+
+  cmd
+    .command("plan")
+    .description("show frozen stage plan for a longagent session")
+    .requiredOption("--session <id>", "session id")
+    .action(async (options) => {
+      const item = await LongAgentManager.get(options.session)
+      if (!item) {
+        console.error(`not found: ${options.session}`)
+        process.exitCode = 1
+        return
+      }
+      if (!item.stagePlan) {
+        console.error(`no frozen plan found for session: ${options.session}`)
+        process.exitCode = 1
+        return
+      }
+      console.log(JSON.stringify(item.stagePlan, null, 2))
+    })
+
+  cmd
+    .command("stop")
+    .description("emergency stop for a running longagent session")
+    .requiredOption("--session <id>", "session id")
+    .option("--force", "confirm emergency stop")
+    .action(async (options) => {
+      if (!options.force) {
+        console.error("longagent stop is emergency-only. re-run with --force to confirm.")
+        process.exitCode = 1
+        return
+      }
+      const result = await LongAgentManager.stop(options.session)
+      if (!result) {
+        console.error(`not found: ${options.session}`)
+        process.exitCode = 1
+        return
+      }
+      console.log(`emergency stop requested: ${options.session}`)
+    })
+
+  cmd
+    .command("resume")
+    .description("clear stop flag for session")
+    .requiredOption("--session <id>", "session id")
+    .action(async (options) => {
+      const result = await LongAgentManager.clearStop(options.session)
+      if (!result) {
+        console.error(`not found: ${options.session}`)
+        process.exitCode = 1
+        return
+      }
+      console.log(`stop flag cleared: ${options.session}`)
+    })
+
+  cmd
+    .command("stage-retry")
+    .description("mark one stage for manual retry in longagent state")
+    .requiredOption("--session <id>", "session id")
+    .requiredOption("--stage <id>", "stage id")
+    .action(async (options) => {
+      const current = await LongAgentManager.get(options.session)
+      if (!current) {
+        console.error(`not found: ${options.session}`)
+        process.exitCode = 1
+        return
+      }
+      const out = await LongAgentManager.update(options.session, {
+        retryStageId: options.stage,
+        stageStatus: "retry_requested",
+        stopRequested: false
+      })
+      console.log(`stage retry requested: ${options.stage} (session=${out.sessionId})`)
+    })
+
+  return cmd
+}

package/src/commands/mcp.mjs

@@ -0,0 +1,89 @@
+import { Command } from "commander"
+import { buildContext, printContextWarnings } from "../context.mjs"
+import { McpRegistry } from "../mcp/registry.mjs"
+
+export function createMcpCommand() {
+  const cmd = new Command("mcp").description("manage MCP servers and tools")
+
+  cmd
+    .command("list")
+    .description("list configured and healthy MCP servers")
+    .action(async () => {
+      const ctx = await buildContext()
+      printContextWarnings(ctx)
+      await McpRegistry.initialize(ctx.configState.config)
+      console.log(JSON.stringify(McpRegistry.listServers(), null, 2))
+    })
+
+  cmd
+    .command("tools")
+    .description("list MCP tools")
+    .action(async () => {
+      const ctx = await buildContext()
+      printContextWarnings(ctx)
+      await McpRegistry.initialize(ctx.configState.config)
+      console.log(JSON.stringify(McpRegistry.listTools(), null, 2))
+    })
+
+  cmd
+    .command("resources")
+    .description("list resources for MCP server")
+    .requiredOption("--server <name>", "server name")
+    .action(async (options) => {
+      const ctx = await buildContext()
+      printContextWarnings(ctx)
+      await McpRegistry.initialize(ctx.configState.config)
+      const list = await McpRegistry.listResources(options.server)
+      console.log(JSON.stringify(list, null, 2))
+    })
+
+  cmd
+    .command("templates")
+    .description("list templates for MCP server")
+    .requiredOption("--server <name>", "server name")
+    .action(async (options) => {
+      const ctx = await buildContext()
+      printContextWarnings(ctx)
+      await McpRegistry.initialize(ctx.configState.config)
+      const list = await McpRegistry.listTemplates(options.server)
+      console.log(JSON.stringify(list, null, 2))
+    })
+
+  cmd
+    .command("test")
+    .description("test MCP health and tool discovery")
+    .option("--json", "print JSON output", false)
+    .action(async (options) => {
+      const ctx = await buildContext()
+      printContextWarnings(ctx)
+      await McpRegistry.initialize(ctx.configState.config)
+      const snapshot = McpRegistry.healthSnapshot()
+      const tools = McpRegistry.listTools()
+      const healthy = snapshot.filter((item) => item.ok).length
+      const unhealthy = snapshot.length - healthy
+
+      if (options.json) {
+        console.log(JSON.stringify({
+          configured: snapshot.length,
+          healthy,
+          unhealthy,
+          tools: tools.length,
+          servers: snapshot
+        }, null, 2))
+        return
+      }
+
+      console.log(`configured: ${snapshot.length}`)
+      console.log(`healthy: ${healthy}`)
+      console.log(`unhealthy: ${unhealthy}`)
+      console.log(`tools: ${tools.length}`)
+      for (const item of snapshot) {
+        const status = item.ok ? "ok" : "fail"
+        const reason = item.reason || "-"
+        const error = item.error ? ` | ${item.error}` : ""
+        console.log(`- ${item.name} [${item.transport}] ${status} (${reason})${error}`)
+      }
+    })
+
+  return cmd
+}

package/src/commands/permission.mjs

@@ -0,0 +1,36 @@
+import { Command } from "commander"
+import { buildContext, printContextWarnings } from "../context.mjs"
+import { PermissionEngine } from "../permission/engine.mjs"
+
+export function createPermissionCommand() {
+  const cmd = new Command("permission").description("inspect permission rules and session grants")
+
+  cmd
+    .command("show")
+    .description("show configured permission policy")
+    .action(async () => {
+      const ctx = await buildContext()
+      printContextWarnings(ctx)
+      console.log(JSON.stringify(ctx.configState.config.permission, null, 2))
+    })
+
+  cmd
+    .command("session")
+    .description("show granted allow_session keys for one session")
+    .requiredOption("--id <id>", "session id")
+    .action(async (options) => {
+      const list = PermissionEngine.listSession(options.id)
+      console.log(JSON.stringify(list, null, 2))
+    })
+
+  cmd
+    .command("reset")
+    .description("clear in-memory grants for one session")
+    .requiredOption("--id <id>", "session id")
+    .action(async (options) => {
+      PermissionEngine.clearSession(options.id)
+      console.log(`permission cache cleared for session ${options.id}`)
+    })
+
+  return cmd
+}

package/src/commands/prompt.mjs

@@ -0,0 +1,42 @@
+import path from "node:path"
+import { readdir, readFile } from "node:fs/promises"
+import { Command } from "commander"
+
+const SESSION_PROMPT_DIR = path.resolve("src/session/prompt")
+const TOOL_PROMPT_DIR = path.resolve("src/tool/prompt")
+
+async function listFiles(dir) {
+  const entries = await readdir(dir, { withFileTypes: true }).catch(() => [])
+  return entries.filter((entry) => entry.isFile()).map((entry) => entry.name)
+}
+
+export function createPromptCommand() {
+  const cmd = new Command("prompt").description("inspect prompt placement and files")
+
+  cmd
+    .command("list")
+    .description("list session/tool prompt files")
+    .action(async () => {
+      const sessionFiles = await listFiles(SESSION_PROMPT_DIR)
+      const toolFiles = await listFiles(TOOL_PROMPT_DIR)
+      console.log(`session prompts: ${SESSION_PROMPT_DIR}`)
+      for (const file of sessionFiles) console.log(`- ${file}`)
+      console.log(``)
+      console.log(`tool prompts: ${TOOL_PROMPT_DIR}`)
+      for (const file of toolFiles) console.log(`- ${file}`)
+    })
+
+  cmd
+    .command("show")
+    .description("show one prompt file")
+    .requiredOption("--type <type>", "session|tool")
+    .requiredOption("--name <name>", "prompt filename")
+    .action(async (options) => {
+      const dir = options.type === "session" ? SESSION_PROMPT_DIR : TOOL_PROMPT_DIR
+      const file = path.join(dir, options.name)
+      const content = await readFile(file, "utf8")
+      console.log(content.trim())
+    })
+
+  return cmd
+}

package/src/commands/review.mjs

@@ -0,0 +1,266 @@
+import path from "node:path"
+import { readFile } from "node:fs/promises"
+import { execSync } from "node:child_process"
+import { Command } from "commander"
+import { buildContext, printContextWarnings } from "../context.mjs"
+import { parseUnifiedDiff, previewLines } from "../review/diff-parser.mjs"
+import { scoreRisk, sortReviewFiles } from "../review/risk-score.mjs"
+import { defaultReviewState, readReviewState, writeReviewState } from "../review/review-store.mjs"
+import { clearRejections, enqueueRejection, listRejections } from "../review/rejection-queue.mjs"
+import { paint } from "../theme/color.mjs"
+import { applyReviewDecision, getSession, listSessions } from "../session/store.mjs"
+
+function getGitDiff() {
+  try {
+    execSync("git rev-parse --is-inside-work-tree", { stdio: "ignore" })
+    return execSync("git diff --no-color", { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] })
+  } catch {
+    return ""
+  }
+}
+
+async function loadDiff(diffFile) {
+  if (!diffFile) return getGitDiff()
+  return readFile(path.resolve(diffFile), "utf8")
+}
+
+function renderFile(file, index, lines, theme) {
+  const title = `${index + 1}. ${file.path} (+${file.added} -${file.removed}) risk=${file.riskScore}`
+  console.log(paint(title, file.riskScore >= 9 ? theme.semantic.error : file.riskScore >= 6 ? theme.semantic.warn : theme.semantic.info))
+  if (file.reasons.length) {
+    console.log(`   reasons: ${file.reasons.join("; ")}`)
+  }
+  const preview = previewLines(file, lines)
+  for (const line of preview) {
+    if (line.startsWith("+") && !line.startsWith("+++")) {
+      console.log(paint(`   ${line}`, theme.components.diff_add))
+      continue
+    }
+    if (line.startsWith("-") && !line.startsWith("---")) {
+      console.log(paint(`   ${line}`, theme.components.diff_del))
+      continue
+    }
+    console.log(`   ${line}`)
+  }
+  if (file.rawLines.length > lines) {
+    console.log(paint(`   ... (${file.rawLines.length - lines} more lines, use "kkcode review expand --index ${index}" )`, theme.base.muted))
+  }
+}
+
+function summarize(files) {
+  const added = files.reduce((sum, file) => sum + file.added, 0)
+  const removed = files.reduce((sum, file) => sum + file.removed, 0)
+  const risk = files.reduce((sum, file) => sum + file.riskScore, 0)
+  return { fileCount: files.length, added, removed, risk }
+}
+
+async function resolveReviewSessionId(requestedSessionId, cwd) {
+  if (requestedSessionId) {
+    const data = await getSession(requestedSessionId)
+    if (!data) return null
+    return requestedSessionId
+  }
+  const latest = await listSessions({ cwd, limit: 1, includeChildren: true })
+  if (!latest.length) return null
+  return latest[0].id
+}
+
+export function createReviewCommand() {
+  const cmd = new Command("review").description("review code changes with risk-first previews")
+
+  cmd
+    .command("open")
+    .description("build review state from diff and show first previews")
+    .option("--diff-file <file>", "use a diff file instead of git diff")
+    .option("--session <id>", "bind review decisions to this session id")
+    .option("--lines <n>", "preview lines per file")
+    .action(async (options) => {
+      const ctx = await buildContext()
+      printContextWarnings(ctx)
+      const config = ctx.configState.config
+      const theme = ctx.themeState.theme
+      const previewCount = Number(options.lines ?? config.review.default_lines)
+      const diff = await loadDiff(options.diffFile ?? null)
+      const files = parseUnifiedDiff(diff).map((file) => {
+        const risk = scoreRisk(file)
+        return {
+          ...file,
+          riskScore: risk.score,
+          reasons: risk.reasons,
+          status: "pending"
+        }
+      })
+      if (files.length === 0) {
+        console.log("no diff content found")
+        return
+      }
+      const sorted = sortReviewFiles(files, config.review.sort)
+      const state = defaultReviewState()
+      const sessionId = await resolveReviewSessionId(options.session ?? null, process.cwd())
+      if (options.session && !sessionId) {
+        console.error(`session not found: ${options.session}`)
+        process.exitCode = 1
+        return
+      }
+      state.sessionId = sessionId
+      state.files = sorted
+      state.currentIndex = 0
+      await writeReviewState(state)
+      const summary = summarize(sorted)
+      console.log(`summary: files=${summary.fileCount} added=${summary.added} removed=${summary.removed} totalRisk=${summary.risk}`)
+      const risky = sorted.filter((file) => file.riskScore >= 6).slice(0, 5)
+      if (risky.length) {
+        console.log("high-risk files:")
+        for (const file of risky) {
+          console.log(`- ${file.path} (risk=${file.riskScore})`)
+        }
+      }
+      if (state.sessionId) {
+        console.log(`bound session: ${state.sessionId}`)
+      } else {
+        console.log("bound session: (none)")
+      }
+      for (const [index, file] of sorted.entries()) {
+        renderFile(file, index, previewCount, theme)
+      }
+    })
+
+  cmd
+    .command("next")
+    .description("move to next file preview")
+    .action(async () => {
+      const ctx = await buildContext()
+      const config = ctx.configState.config
+      const theme = ctx.themeState.theme
+      const state = await readReviewState()
+      if (!state.files.length) {
+        console.error("review state empty. Run `kkcode review open` first.")
+        process.exitCode = 1
+        return
+      }
+      state.currentIndex = Math.min(state.currentIndex + 1, state.files.length - 1)
+      await writeReviewState(state)
+      renderFile(state.files[state.currentIndex], state.currentIndex, config.review.default_lines, theme)
+    })
+
+  cmd
+    .command("expand")
+    .description("expand current or selected file preview")
+    .option("--index <n>", "file index, zero-based")
+    .action(async (options) => {
+      const ctx = await buildContext()
+      const theme = ctx.themeState.theme
+      const config = ctx.configState.config
+      const state = await readReviewState()
+      if (!state.files.length) {
+        console.error("review state empty. Run `kkcode review open` first.")
+        process.exitCode = 1
+        return
+      }
+      const index = options.index !== undefined ? Math.max(0, Number(options.index)) : state.currentIndex
+      const file = state.files[index]
+      if (!file) {
+        console.error(`invalid index: ${index}`)
+        process.exitCode = 1
+        return
+      }
+      const max = config.review.max_expand_lines
+      renderFile(file, index, max, theme)
+    })
+
+  cmd
+    .command("approve")
+    .description("approve current or selected review file")
+    .option("--index <n>", "file index, zero-based")
+    .action(async (options) => {
+      const state = await readReviewState()
+      if (!state.files.length) {
+        console.error("review state empty. Run `kkcode review open` first.")
+        process.exitCode = 1
+        return
+      }
+      const index = options.index !== undefined ? Math.max(0, Number(options.index)) : state.currentIndex
+      const file = state.files[index]
+      if (!file) {
+        console.error(`invalid index: ${index}`)
+        process.exitCode = 1
+        return
+      }
+      file.status = "approved"
+      await writeReviewState(state)
+      if (state.sessionId) {
+        await applyReviewDecision(state.sessionId, {
+          file: file.path,
+          status: "approved",
+          riskScore: file.riskScore
+        }).catch(() => {})
+      } else {
+        console.log("warning: no bound session id; decision not persisted to session history")
+      }
+      console.log(`approved: ${file.path}`)
+    })
+
+  cmd
+    .command("reject")
+    .description("reject current or selected review file")
+    .requiredOption("--reason <reason>", "reject reason")
+    .option("--index <n>", "file index, zero-based")
+    .action(async (options) => {
+      const state = await readReviewState()
+      if (!state.files.length) {
+        console.error("review state empty. Run `kkcode review open` first.")
+        process.exitCode = 1
+        return
+      }
+      const index = options.index !== undefined ? Math.max(0, Number(options.index)) : state.currentIndex
+      const file = state.files[index]
+      if (!file) {
+        console.error(`invalid index: ${index}`)
+        process.exitCode = 1
+        return
+      }
+      file.status = "rejected"
+      file.rejectReason = options.reason
+      await writeReviewState(state)
+      await enqueueRejection(
+        {
+          file: file.path,
+          reason: options.reason,
+          riskScore: file.riskScore
+        },
+        process.cwd()
+      )
+      if (state.sessionId) {
+        await applyReviewDecision(state.sessionId, {
+          file: file.path,
+          status: "rejected",
+          reason: options.reason,
+          riskScore: file.riskScore
+        }).catch(() => {})
+      } else {
+        console.log("warning: no bound session id; decision not persisted to session history")
+      }
+      console.log(`rejected: ${file.path}`)
+      console.log(`reason: ${options.reason}`)
+    })
+
+  cmd
+    .command("feedback")
+    .description("show or clear queued rejection feedback")
+    .option("--clear", "clear all queued feedback", false)
+    .action(async (options) => {
+      if (options.clear) {
+        await clearRejections(process.cwd())
+        console.log("rejection feedback queue cleared")
+        return
+      }
+      const list = await listRejections(process.cwd())
+      if (!list.length) {
+        console.log("no rejection feedback found")
+        return
+      }
+      console.log(JSON.stringify(list, null, 2))
+    })
+
+  return cmd
+}

package/src/commands/rule.mjs

@@ -0,0 +1,34 @@
+import { Command } from "commander"
+import { loadRuleBlocks, renderRulesPrompt } from "../rules/load-rules.mjs"
+
+export function createRuleCommand() {
+  const cmd = new Command("rule").description("inspect global/project rule prompts")
+
+  cmd
+    .command("list")
+    .description("list loaded rule files")
+    .action(async () => {
+      const blocks = await loadRuleBlocks(process.cwd())
+      if (!blocks.length) {
+        console.log("no rules found")
+        return
+      }
+      for (const block of blocks) {
+        console.log(`- [${block.scope}] ${block.file}`)
+      }
+    })
+
+  cmd
+    .command("show")
+    .description("show merged rules prompt")
+    .action(async () => {
+      const text = await renderRulesPrompt(process.cwd())
+      if (!text) {
+        console.log("no rules found")
+        return
+      }
+      console.log(text)
+    })
+
+  return cmd
+}