kodingo-cli 1.0.24 → 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/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.24",
+  "version": "1.0.25",
   "description": "Kodingo CLI",
   "license": "MIT",
   "private": false,