kodingo-cli 1.0.23 → 1.0.25

package/dist/cli.js

@@ -18,6 +18,9 @@ const init_1 = require("./commands/init");
 const install_hook_1 = require("./commands/install-hook");
 const update_1 = require("./commands/update");
 const sync_1 = require("./commands/sync");
+const context_1 = require("./commands/context");
+const guardrails_1 = require("./commands/guardrails");
+const session_brief_1 = require("./commands/session-brief");
 const aging_1 = require("./commands/aging");
 const program = new commander_1.Command();
 program.name("kodingo").description("Kodingo CLI").version("1.0.4");
@@ -226,4 +229,22 @@ program
         payload.repo = String(options.repo);
     await (0, scan_repo_1.scanRepoCommand)(payload);
 });
+program
+    .command("context")
+    .description("Get affirmed memories for a file — designed for AI agents")
+    .requiredOption("-f, --file <path>", "File path to get context for")
+    .option("--prompt", "Output as prompt-ready string instead of JSON")
+    .option("--limit <n>", "Max memories to return", "20")
+    .action((opts) => (0, context_1.contextCommand)(opts.file, { prompt: opts.prompt, limit: parseInt(opts.limit) }));
+program
+    .command("guardrails")
+    .description("Get project guardrails — rules and rejected patterns for AI agents")
+    .option("--prompt", "Output as prompt-ready string instead of JSON")
+    .action((opts) => (0, guardrails_1.guardrailsCommand)({ prompt: opts.prompt }));
+program
+    .command("session-brief")
+    .description("Get a compact project intelligence brief — call at the start of an AI coding session")
+    .option("--prompt", "Output as prompt-ready string instead of JSON")
+    .option("--limit <n>", "Max memories to include", "30")
+    .action((opts) => (0, session_brief_1.sessionBriefCommand)({ prompt: opts.prompt, limit: parseInt(opts.limit) }));
 program.parse(process.argv);

package/dist/commands/context.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextCommand = contextCommand;
+/**
+ * kodingo context --file <path>
+ *
+ * Returns all affirmed memories relevant to a file.
+ * Designed for AI agents — call before touching a file.
+ * Output: JSON by default, prompt-ready string with --prompt flag.
+ */
+const path = __importStar(require("path"));
+const persistence_config_1 = require("../utils/persistence-config");
+const API_BASE_DEFAULT = "https://kodingo-api.onrender.com";
+function normalizePath(p) {
+    return p.replace(/\\\\/g, "/").toLowerCase();
+}
+function getCredentials() {
+    const config = (0, persistence_config_1.readConfig)();
+    const cwd = normalizePath(process.cwd());
+    const ws = (0, persistence_config_1.readWorkspaceConfig)(cwd);
+    const token = ws?.token ?? config.token ?? "";
+    const apiUrl = ws?.apiUrl ?? config.apiUrl ?? API_BASE_DEFAULT;
+    return { token, apiUrl };
+}
+async function contextCommand(filePath, options) {
+    const { token, apiUrl } = getCredentials();
+    if (!token) {
+        console.error("No token found. Run `kodingo init` first.");
+        process.exit(1);
+    }
+    const limit = options.limit ?? 20;
+    const repoName = path.basename(process.cwd());
+    const relFile = path.relative(process.cwd(), path.resolve(filePath));
+    try {
+        // Fetch memories for this file (by repo path)
+        const res = await fetch(`${apiUrl}/memory?repo=${encodeURIComponent(relFile)}&status=affirmed&limit=${limit}`, { headers: { "X-Kodingo-Token": token } });
+        if (!res.ok) {
+            console.error(`API error: ${res.status}`);
+            process.exit(1);
+        }
+        const data = await res.json();
+        const memories = data.memories ?? [];
+        if (!options.prompt) {
+            console.log(JSON.stringify({ file: relFile, repo: repoName, count: memories.length, memories }, null, 2));
+            return;
+        }
+        // Prompt-ready format
+        if (!memories.length) {
+            console.log(`No affirmed memories found for ${relFile}.`);
+            return;
+        }
+        const lines = [
+            `# Kortex context for ${relFile}`,
+            `# ${memories.length} affirmed decision${memories.length !== 1 ? "s" : ""} your team has made about this file:`,
+            "",
+        ];
+        for (const m of memories) {
+            lines.push(`## ${m.title ?? "Decision"}`);
+            lines.push(m.content);
+            if (m.symbol)
+                lines.push(`Symbol: ${m.symbol}`);
+            lines.push(`Confidence: ${(m.confidence * 100).toFixed(0)}%`);
+            lines.push("");
+        }
+        lines.push("# End of Kortex context. Respect these decisions in your changes.");
+        console.log(lines.join("\n"));
+    }
+    catch (err) {
+        console.error("Failed to fetch context:", err.message);
+        process.exit(1);
+    }
+}

package/dist/commands/guardrails.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guardrailsCommand = guardrailsCommand;
+const persistence_config_1 = require("../utils/persistence-config");
+const API_BASE_DEFAULT = "https://kodingo-api.onrender.com";
+function normalizePath(p) {
+    return p.replace(/\\\\/g, "/").toLowerCase();
+}
+function getCredentials() {
+    const config = (0, persistence_config_1.readConfig)();
+    const cwd = normalizePath(process.cwd());
+    const ws = (0, persistence_config_1.readWorkspaceConfig)(cwd);
+    const token = ws?.token ?? config.token ?? "";
+    const apiUrl = ws?.apiUrl ?? config.apiUrl ?? API_BASE_DEFAULT;
+    return { token, apiUrl };
+}
+async function guardrailsCommand(options) {
+    const { token, apiUrl } = getCredentials();
+    if (!token) {
+        console.error("No token found. Run `kodingo init` first.");
+        process.exit(1);
+    }
+    try {
+        // Fetch denied memories (things explicitly ruled out)
+        const [deniedRes, affiredRes] = await Promise.all([
+            fetch(`${apiUrl}/memory?status=denied&limit=50`, { headers: { "X-Kodingo-Token": token } }),
+            fetch(`${apiUrl}/memory?status=affirmed&limit=50`, { headers: { "X-Kodingo-Token": token } }),
+        ]);
+        const denied = deniedRes.ok ? (await deniedRes.json()).memories ?? [] : [];
+        const affirmed = affiredRes.ok ? (await affiredRes.json()).memories ?? [] : [];
+        // High confidence affirmed = guardrails (confidence >= 0.7)
+        const rules = affirmed.filter((m) => m.confidence >= 0.7);
+        if (!options.prompt) {
+            console.log(JSON.stringify({ rules: rules.length, denied: denied.length, rules_list: rules, denied_list: denied }, null, 2));
+            return;
+        }
+        const lines = ["# Kortex guardrails — decisions your team has enforced", ""];
+        if (rules.length) {
+            lines.push("## Rules to follow:");
+            for (const m of rules) {
+                lines.push(`- ${m.title ?? m.content.slice(0, 100)}`);
+                if (m.symbol)
+                    lines.push(`  (applies to: ${m.symbol})`);
+            }
+            lines.push("");
+        }
+        if (denied.length) {
+            lines.push("## Patterns explicitly rejected by your team (do NOT use):");
+            for (const m of denied) {
+                lines.push(`- ${m.title ?? m.content.slice(0, 100)}`);
+                if (m.symbol)
+                    lines.push(`  (rejected for: ${m.symbol})`);
+            }
+            lines.push("");
+        }
+        if (!rules.length && !denied.length) {
+            lines.push("No guardrails defined yet. Affirm and deny memories to build them.");
+        }
+        lines.push("# End of Kortex guardrails.");
+        console.log(lines.join("\n"));
+    }
+    catch (err) {
+        console.error("Failed to fetch guardrails:", err.message);
+        process.exit(1);
+    }
+}

package/dist/commands/init.js

@@ -56,6 +56,20 @@ const API_BASE = "https://kodingo-api.onrender.com";
 const APP_URL = "https://kodingo.xyz";
 const CONFIG_DIR = path.join(os.homedir(), ".kodingo");
 const AUTH_TOKEN_PATH = path.join(CONFIG_DIR, "auth.json");
+// ── Machine ID ────────────────────────────────────────────────────────────────
+function generateMachineId() {
+    const raw = `${os.hostname()}::${os.userInfo().username}::${process.platform}`;
+    return require("crypto").createHash("sha256").update(raw).digest("hex").slice(0, 32);
+}
+function getMachineId() {
+    const config = (0, persistence_config_1.readConfig)();
+    if (config.machineId)
+        return config.machineId;
+    const machineId = generateMachineId();
+    const existing = (0, persistence_config_1.readConfig)();
+    (0, persistence_config_1.writeConfig)({ ...existing, machineId });
+    return machineId;
+}
 // ── Auth token storage ────────────────────────────────────────────────────────
 function readAuthToken() {
     try {
@@ -255,7 +269,8 @@ function registerInitCommand(program) {
             const apiUrl = API_BASE;
             // preserve existing workspaces, never overwrite global token
             const existingConfig = (0, persistence_config_1.readConfig)();
-            (0, persistence_config_1.writeConfig)({ ...existingConfig, mode: "cloud", apiUrl });
+            const machineId = getMachineId();
+            (0, persistence_config_1.writeConfig)({ ...existingConfig, mode: "cloud", apiUrl, machineId });
             (0, persistence_config_1.writeWorkspaceConfig)(repoRoot, { mode: "cloud", apiUrl, token: selectedProject.token });
             ensureGitignoreEntry(repoRoot, ".kortex/");
             console.log(`✔ Connected. Token saved to ${persistence_config_1.CONFIG_PATH}`);

package/dist/commands/scan-repo.js

@@ -38,7 +38,7 @@ const IGNORED_DIRS = [
     "node_modules", ".git", ".kortex", "dist", "build",
     "out", ".next", "coverage", "__pycache__", "vendor",
 ];
-const MAX_SYMBOLS = 50;
+const MAX_SYMBOLS = 200;
 const BATCH_SIZE = 5;
 const BATCH_DELAY_MS = 1200;
 function findRepoRoot(startPath) {
@@ -107,8 +107,12 @@ async function fetchExistingSymbols(token, repo) {
                 break;
             const data = await res.json();
             for (const m of data.memories ?? []) {
-                if (m.symbol)
+                if (m.symbol) {
+                    // Store both symbol-only and symbol::repo keys for accurate matching
                     known.add(m.symbol);
+                    if (m.repo)
+                        known.add(`${m.symbol}::${m.repo}`);
+                }
             }
             offset += limit;
             if (offset >= (data.total ?? 0))
@@ -195,7 +199,9 @@ async function scanRepoCommand(options = {}) {
         if (seen.has(key))
             continue;
         seen.add(key);
-        if (!existingSymbols.has(sym.name))
+        const symRepoKey = `${sym.name}::${path_1.default.basename(sym.file)}`;
+        const hasMemory = existingSymbols.has(symRepoKey) || existingSymbols.has(sym.name);
+        if (!hasMemory)
             toCapture.push(sym);
     }
     if (toCapture.length === 0) {

package/dist/commands/session-brief.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionBriefCommand = sessionBriefCommand;
+/**
+ * kodingo session-brief
+ *
+ * Returns a compact summary of the most important decisions across the project.
+ * Designed for AI agents — call once at the start of a new coding session.
+ * Output: JSON by default, prompt-ready string with --prompt flag.
+ */
+const persistence_config_1 = require("../utils/persistence-config");
+const path = __importStar(require("path"));
+const API_BASE_DEFAULT = "https://kodingo-api.onrender.com";
+function normalizePath(p) {
+    return p.replace(/\\\\/g, "/").toLowerCase();
+}
+function getCredentials() {
+    const config = (0, persistence_config_1.readConfig)();
+    const cwd = normalizePath(process.cwd());
+    const ws = (0, persistence_config_1.readWorkspaceConfig)(cwd);
+    const token = ws?.token ?? config.token ?? "";
+    const apiUrl = ws?.apiUrl ?? config.apiUrl ?? API_BASE_DEFAULT;
+    return { token, apiUrl };
+}
+async function sessionBriefCommand(options) {
+    const { token, apiUrl } = getCredentials();
+    if (!token) {
+        console.error("No token found. Run `kodingo init` first.");
+        process.exit(1);
+    }
+    const limit = options.limit ?? 30;
+    const repoName = path.basename(process.cwd());
+    try {
+        // Top affirmed memories sorted by confidence
+        const res = await fetch(`${apiUrl}/memory?status=affirmed&limit=${limit}`, { headers: { "X-Kodingo-Token": token } });
+        if (!res.ok) {
+            console.error(`API error: ${res.status}`);
+            process.exit(1);
+        }
+        const data = await res.json();
+        const memories = (data.memories ?? []).sort((a, b) => b.confidence - a.confidence);
+        if (!options.prompt) {
+            console.log(JSON.stringify({
+                repo: repoName,
+                total_affirmed: data.total,
+                showing: memories.length,
+                memories,
+            }, null, 2));
+            return;
+        }
+        const lines = [
+            `# Kortex session brief for ${repoName}`,
+            `# ${data.total} total affirmed decisions. Showing top ${memories.length} by confidence.`,
+            `# Read these before writing any code.`,
+            "",
+        ];
+        // Group by type
+        const byType = {};
+        for (const m of memories) {
+            const t = m.type ?? "context";
+            if (!byType[t])
+                byType[t] = [];
+            byType[t].push(m);
+        }
+        for (const [type, items] of Object.entries(byType)) {
+            lines.push(`## ${type.charAt(0).toUpperCase() + type.slice(1)} decisions`);
+            for (const m of items) {
+                const conf = (m.confidence * 100).toFixed(0);
+                const symbol = m.symbol ? ` [${m.symbol}]` : "";
+                lines.push(`- ${m.title ?? m.content.slice(0, 100)}${symbol} (${conf}% confidence)`);
+            }
+            lines.push("");
+        }
+        lines.push("# End of Kortex session brief. These decisions represent your team\'s collective intelligence.");
+        console.log(lines.join("\n"));
+    }
+    catch (err) {
+        console.error("Failed to fetch session brief:", err.message);
+        process.exit(1);
+    }
+}

package/package.json

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