kodingo-cli 1.0.24 → 1.0.26

package/dist/cli.js

@@ -18,6 +18,10 @@ 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 check_rules_1 = require("./commands/check-rules");
 const aging_1 = require("./commands/aging");
 const program = new commander_1.Command();
 program.name("kodingo").description("Kodingo CLI").version("1.0.4");
@@ -226,4 +230,26 @@ 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
+    .command("check-rules")
+    .description("Check staged diff against project guardrails — called by pre-commit hook")
+    .action(() => (0, check_rules_1.checkRulesCommand)());
 program.parse(process.argv);

package/dist/commands/check-rules.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkRulesCommand = checkRulesCommand;
+const child_process_1 = require("child_process");
+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 };
+}
+function getStagedDiff() {
+    try {
+        return (0, child_process_1.execSync)("git diff --cached", { encoding: "utf-8", timeout: 10000 });
+    }
+    catch {
+        return "";
+    }
+}
+function getProjectId(token, apiUrl) {
+    return fetch(`${apiUrl}/org/projects/by-token`, {
+        headers: { "X-Kodingo-Token": token },
+    })
+        .then(r => r.ok ? r.json() : null)
+        .then((d) => d?.project?.id ?? null)
+        .catch(() => null);
+}
+async function checkRulesCommand() {
+    const { token, apiUrl } = getCredentials();
+    if (!token)
+        return; // No token — silent pass, never block
+    const diff = getStagedDiff();
+    if (!diff.trim())
+        return; // Empty diff — nothing to check
+    try {
+        const projectId = await getProjectId(token, apiUrl);
+        if (!projectId)
+            return; // Can't resolve project — silent pass
+        const res = await fetch(`${apiUrl}/org/projects/${projectId}/rules/check`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", "X-Kodingo-Token": token },
+            body: JSON.stringify({ diff }),
+        });
+        if (!res.ok)
+            return; // API error — silent pass, never block on infrastructure failure
+        const data = await res.json();
+        const violations = data.violations ?? [];
+        if (!violations.length)
+            return; // All clear
+        // Hard block
+        console.error("\n╔════════════════════════════════════════════════════════════╗");
+        console.error("║          KORTEX GUARDRAIL VIOLATION — COMMIT BLOCKED        ║");
+        console.error("╚════════════════════════════════════════════════════════════╝\n");
+        console.error(`${violations.length} rule${violations.length !== 1 ? "s" : ""} violated:\n`);
+        for (const v of violations) {
+            console.error(`  ✕ ${v.title}`);
+            console.error(`    ${v.description}`);
+            if (v.explanation)
+                console.error(`    → ${v.explanation}`);
+            console.error("");
+        }
+        console.error("Fix the violations above or contact your engineering lead to update the rules.");
+        console.error("To bypass in an emergency: git commit --no-verify\n");
+        process.exit(1);
+    }
+    catch {
+        return; // Any unexpected error — silent pass
+    }
+}

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/install-hook.js

@@ -20,6 +20,28 @@ async function installHookCommand(options) {
         `"${kodingoBin}" scan-git --repo "$(git rev-parse --show-toplevel)" &`,
         "# </kodingo>",
     ].join("\n");
+    // Pre-commit hook — runs synchronously to enforce guardrails
+    const preCommitPath = path_1.default.join(hooksDir, "pre-commit");
+    const preCommitBlock = [
+        "# <kodingo-guardrails>",
+        "# Kortex: enforce project guardrails before commit",
+        `"${kodingoBin}" check-rules`,
+        "# </kodingo-guardrails>",
+    ].join("\n");
+    if (fs_1.default.existsSync(preCommitPath)) {
+        const existing = fs_1.default.readFileSync(preCommitPath, "utf-8");
+        if (!existing.includes("# <kodingo-guardrails>")) {
+            const updated = existing.endsWith("\n")
+                ? existing + "\n" + preCommitBlock + "\n"
+                : existing + "\n\n" + preCommitBlock + "\n";
+            fs_1.default.writeFileSync(preCommitPath, updated, "utf-8");
+        }
+    }
+    else {
+        const content = "#!/bin/sh\n\n" + preCommitBlock + "\n";
+        fs_1.default.writeFileSync(preCommitPath, content, "utf-8");
+    }
+    fs_1.default.chmodSync(preCommitPath, 0o755);
     if (fs_1.default.existsSync(hookPath)) {
         const existing = fs_1.default.readFileSync(hookPath, "utf-8");
         if (existing.includes("# <kodingo>")) {

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.26",
   "description": "Kodingo CLI",
   "license": "MIT",
   "private": false,