kodingo-cli 1.0.11 → 1.0.12

package/dist/cli.js

@@ -12,6 +12,7 @@ const affirm_1 = require("./commands/affirm");
 const ignore_1 = require("./commands/ignore");
 const deny_1 = require("./commands/deny");
 const scan_git_1 = require("./commands/scan-git");
+const scan_claude_1 = require("./commands/scan-claude");
 const init_1 = require("./commands/init");
 const install_hook_1 = require("./commands/install-hook");
 const update_1 = require("./commands/update");
@@ -202,4 +203,15 @@ program
         payload.repo = String(options.repo);
     await (0, install_hook_1.installHookCommand)(payload);
 });
+// ── scan-claude ──────────────────────────────────────────────────────────────
+program
+    .command("scan-claude")
+    .description("Scan Claude Code session files and extract decisions into Kortex memory")
+    .option("--repo <path>", "repo path to scan")
+    .action(async (options) => {
+    const payload = {};
+    if (options.repo)
+        payload.repo = String(options.repo);
+    await (0, scan_claude_1.scanClaudeCommand)(payload);
+});
 program.parse(process.argv);

package/dist/commands/scan-claude.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * kodingo scan-claude
+ *
+ * Reads Claude Code session files from .claude/sessions/ in the repo root
+ * and extracts decisions, rationale, and rejected approaches that never
+ * made it into a commit — signal that would otherwise be lost forever.
+ *
+ * Claude Code writes JSONL session files at:
+ *   <repo>/.claude/sessions/<session-id>.jsonl
+ *
+ * Each line is a message in the conversation. We scan for:
+ *   - Assistant messages containing architectural decisions or tradeoffs
+ *   - Tool results showing code that was written then abandoned
+ *   - Explicit reasoning blocks
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanClaudeCommand = scanClaudeCommand;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const persistence_config_1 = require("../utils/persistence-config");
+// ── Heuristics for extracting decisions ──────────────────────────────────────
+const DECISION_PATTERNS = [
+    /\b(?:decided|decision|chose|choosing|going with|we['']ll use|using|opted for|approach is)\b/i,
+    /\b(?:tradeoff|trade-off|because|reason|rationale|the issue is|the problem is)\b/i,
+    /\b(?:instead of|rather than|alternative|we could|we should|don['']t use|avoid)\b/i,
+    /\b(?:architecture|pattern|design|structure|strategy|approach)\b/i,
+];
+const REJECTION_PATTERNS = [
+    /\b(?:rejected|abandoned|won['']t work|doesn['']t work|not going to|let['']s not|avoid this)\b/i,
+    /\b(?:tried|attempted|doesn['']t fit|too complex|too slow|bad idea)\b/i,
+];
+function scoreText(text) {
+    let score = 0;
+    for (const pat of DECISION_PATTERNS) {
+        if (pat.test(text))
+            score += 2;
+    }
+    for (const pat of REJECTION_PATTERNS) {
+        if (pat.test(text))
+            score += 1;
+    }
+    return score;
+}
+function extractTextFromContent(content) {
+    if (typeof content === "string")
+        return content;
+    return content
+        .filter(b => b.type === "text" && b.text)
+        .map(b => b.text)
+        .join("\n");
+}
+// Split assistant message into paragraph-sized chunks
+function splitIntoParagraphs(text) {
+    return text
+        .split(/\n{2,}/)
+        .map(p => p.trim())
+        .filter(p => p.length > 80);
+}
+function buildTitle(text) {
+    const first = text.split(/[.\n]/)[0].trim();
+    return first.length > 100 ? first.slice(0, 97) + "..." : first;
+}
+// ── Session parser ────────────────────────────────────────────────────────────
+function parseSessionFile(filePath) {
+    const messages = [];
+    const lines = fs_1.default.readFileSync(filePath, "utf-8").split("\n").filter(Boolean);
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            // Claude Code JSONL format: { role, content, ... }
+            if (parsed.role && parsed.content !== undefined) {
+                messages.push(parsed);
+            }
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return messages;
+}
+function extractMemoriesFromSession(messages, sessionId, repoPath) {
+    const memories = [];
+    for (const msg of messages) {
+        if (msg.role !== "assistant")
+            continue;
+        const text = extractTextFromContent(msg.content);
+        if (!text)
+            continue;
+        const paragraphs = splitIntoParagraphs(text);
+        for (const para of paragraphs) {
+            const score = scoreText(para);
+            if (score < 2)
+                continue;
+            const isRejection = REJECTION_PATTERNS.some(p => p.test(para));
+            memories.push({
+                type: isRejection ? "note" : "decision",
+                title: buildTitle(para),
+                content: para,
+                tags: ["claude-session", isRejection ? "rejected-approach" : "ai-reasoning"],
+                repoPath,
+                status: "proposed",
+                confidence: Math.min(0.3 + score * 0.05, 0.6),
+                externalId: `claude-session:${sessionId}:${Buffer.from(para.slice(0, 40)).toString("base64").slice(0, 16)}`,
+            });
+        }
+    }
+    return memories;
+}
+// ── Command ───────────────────────────────────────────────────────────────────
+async function scanClaudeCommand(options = {}) {
+    const repoRoot = resolveRepoRoot(options);
+    const sessionsDir = path_1.default.join(repoRoot, ".claude", "sessions");
+    if (!fs_1.default.existsSync(sessionsDir)) {
+        console.log(`No Claude Code sessions found at ${sessionsDir}`);
+        console.log("Claude Code sessions are created when you use Claude Code in this repo.");
+        return;
+    }
+    const sessionFiles = fs_1.default.readdirSync(sessionsDir)
+        .filter(f => f.endsWith(".jsonl"))
+        .map(f => path_1.default.join(sessionsDir, f));
+    if (!sessionFiles.length) {
+        console.log("No session files found.");
+        return;
+    }
+    const { initDb, saveMemory, getMemoryByExternalId } = (0, persistence_config_1.getPersistence)();
+    await initDb();
+    let totalSaved = 0;
+    let totalSkipped = 0;
+    for (const filePath of sessionFiles) {
+        const sessionId = path_1.default.basename(filePath, ".jsonl");
+        let messages;
+        try {
+            messages = parseSessionFile(filePath);
+        }
+        catch {
+            console.warn(`  Skipping unreadable session: ${sessionId}`);
+            continue;
+        }
+        const candidates = extractMemoriesFromSession(messages, sessionId, repoRoot);
+        for (const candidate of candidates) {
+            // Deduplicate by externalId
+            if (candidate.externalId) {
+                const existing = await getMemoryByExternalId(candidate.externalId, repoRoot);
+                if (existing) {
+                    totalSkipped++;
+                    continue;
+                }
+            }
+            await saveMemory(candidate);
+            totalSaved++;
+        }
+    }
+    console.log(`Claude session scan complete.`);
+    console.log(`  Sessions scanned : ${sessionFiles.length}`);
+    console.log(`  Memories saved   : ${totalSaved}`);
+    console.log(`  Already stored   : ${totalSkipped}`);
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function resolveRepoRoot(options) {
+    if (options.repo?.trim()) {
+        return findRepoRoot(path_1.default.resolve(options.repo.trim()));
+    }
+    return findRepoRoot(process.cwd());
+}
+function findRepoRoot(startPath) {
+    let current = startPath;
+    while (true) {
+        if (fs_1.default.existsSync(path_1.default.join(current, ".git")))
+            return current;
+        const parent = path_1.default.dirname(current);
+        if (parent === current)
+            return startPath;
+        current = parent;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodingo-cli",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Kodingo CLI",
   "license": "MIT",
   "private": false,