@codified/cli 0.3.4 → 0.3.6

package/dist/commands/check.js

@@ -0,0 +1,332 @@
+// codify check — context check for code review / CI gating
+import { Command } from "commander";
+import { loadProjectConfig } from "../lib/config.js";
+// --- Color helpers (ANSI escape codes) ---
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const RED = "\x1b[31m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const CYAN = "\x1b[36m";
+// --- Common path words to filter out ---
+const STOP_WORDS = new Set([
+    "src", "lib", "utils", "util", "helpers", "helper",
+    "index", "test", "tests", "spec", "specs",
+    "dist", "build", "out", "node_modules",
+    "components", "pages", "app", "main",
+]);
+// --- Extract keywords from file paths ---
+function extractKeywords(filePaths) {
+    const keywords = new Set();
+    for (const filePath of filePaths) {
+        // Split on path separators and dots (to remove extensions)
+        const parts = filePath
+            .replace(/\\/g, "/")
+            .split("/")
+            .flatMap((segment) => {
+            // Remove file extension from last segment
+            const withoutExt = segment.replace(/\.[^.]+$/, "");
+            // Split camelCase and kebab-case
+            return withoutExt
+                .split(/[-_]/)
+                .flatMap((part) => part.replace(/([a-z])([A-Z])/g, "$1 $2").split(" "))
+                .map((w) => w.toLowerCase())
+                .filter((w) => w.length > 1);
+        });
+        for (const part of parts) {
+            if (!STOP_WORDS.has(part)) {
+                keywords.add(part);
+            }
+        }
+    }
+    return [...keywords];
+}
+// --- Severity badge ---
+function severityBadge(severity) {
+    switch (severity) {
+        case "critical":
+            return `${RED}${BOLD}CRITICAL${RESET}`;
+        case "high":
+            return `${RED}HIGH${RESET}`;
+        case "medium":
+            return `${YELLOW}MEDIUM${RESET}`;
+        case "low":
+            return `${CYAN}LOW${RESET}`;
+        default:
+            return `${DIM}${severity?.toUpperCase() ?? "UNKNOWN"}${RESET}`;
+    }
+}
+// --- Command definition ---
+export const checkCommand = new Command("check")
+    .description("Check context graph for relevant decisions, gaps, and signals related to files")
+    .argument("<files...>", "File paths to check")
+    .option("--json", "Output raw JSON for piping")
+    .action(async (files, opts) => {
+    try {
+        await loadProjectConfig();
+        const { getPool, closePool } = await import("@codify/graph");
+        const pool = getPool();
+        try {
+            await pool.query("SELECT 1");
+        }
+        catch {
+            console.error("  ERROR: Cannot connect to PostgreSQL. Run 'codify init' first.\n");
+            process.exit(1);
+        }
+        // Extract keywords from file paths
+        const keywords = extractKeywords(files);
+        if (keywords.length === 0) {
+            if (opts.json) {
+                console.log(JSON.stringify({
+                    files,
+                    keywords: [],
+                    context: { decisions: [], gaps: [], signals: [], features: [], other: [] },
+                    exitCode: 0,
+                    reason: "No keywords extracted from file paths",
+                }, null, 2));
+            }
+            else {
+                console.log(`\n  ${BOLD}Codify — Context Check${RESET}\n`);
+                console.log(`  No keywords could be extracted from the provided paths.\n`);
+            }
+            await closePool();
+            process.exit(0);
+        }
+        // Build ILIKE conditions for keywords
+        const conditions = ["superseded_by IS NULL"];
+        const params = [];
+        let paramIdx = 1;
+        const keywordConditions = keywords.map((kw) => {
+            params.push(`%${kw}%`);
+            const idx = paramIdx++;
+            return `(properties::text ILIKE $${idx} OR metadata::text ILIKE $${idx})`;
+        });
+        // If single keyword, use just one condition; otherwise AND them together
+        conditions.push(`(${keywordConditions.join(" AND ")})`);
+        const sql = `SELECT id, type, properties, metadata, freshness
+         FROM nodes
+         WHERE ${conditions.join(" AND ")}
+         ORDER BY freshness DESC
+         LIMIT 20`;
+        const result = await pool.query(sql, params);
+        const nodes = result.rows;
+        // Group results by type
+        const decisions = [];
+        const gaps = [];
+        const signals = [];
+        const features = [];
+        const other = [];
+        for (const node of nodes) {
+            switch (node.type) {
+                case "Decision":
+                    decisions.push(node);
+                    break;
+                case "Gap":
+                    gaps.push(node);
+                    break;
+                case "CustomerSignal":
+                    signals.push(node);
+                    break;
+                case "Feature":
+                    features.push(node);
+                    break;
+                default:
+                    other.push(node);
+                    break;
+            }
+        }
+        // Determine exit code: exit 1 if any gap with severity critical/high and status not resolved/wont_fix
+        const blockingGaps = gaps.filter((g) => {
+            const severity = g.properties.severity ?? "";
+            const status = g.properties.status ?? "detected";
+            const isHighSeverity = severity === "critical" || severity === "high";
+            const isResolved = status === "resolved" || status === "wont_fix";
+            return isHighSeverity && !isResolved;
+        });
+        const exitCode = blockingGaps.length > 0 ? 1 : 0;
+        // Build reason string
+        let reason = "";
+        if (blockingGaps.length > 0) {
+            const critCount = blockingGaps.filter((g) => g.properties.severity === "critical").length;
+            const highCount = blockingGaps.filter((g) => g.properties.severity === "high").length;
+            const parts = [];
+            if (critCount > 0)
+                parts.push(`${critCount} critical-severity gap${critCount === 1 ? "" : "s"}`);
+            if (highCount > 0)
+                parts.push(`${highCount} high-severity gap${highCount === 1 ? "" : "s"}`);
+            reason = `${parts.join(" and ")} found`;
+        }
+        else if (nodes.length === 0) {
+            reason = "No context found";
+        }
+        else {
+            reason = "No blocking gaps";
+        }
+        // JSON output mode
+        if (opts.json) {
+            const getTitle = (n) => n.properties.title ?? n.metadata.title ??
+                n.properties.name ?? n.metadata.name ?? n.id;
+            console.log(JSON.stringify({
+                files,
+                keywords,
+                context: {
+                    decisions: decisions.map((n) => ({
+                        id: n.id,
+                        title: getTitle(n),
+                        rationale: n.properties.rationale ?? n.properties.reason ?? null,
+                        freshness: n.freshness,
+                    })),
+                    gaps: gaps.map((n) => ({
+                        id: n.id,
+                        title: getTitle(n),
+                        severity: n.properties.severity ?? "unknown",
+                        status: n.properties.status ?? "detected",
+                        freshness: n.freshness,
+                    })),
+                    signals: signals.map((n) => ({
+                        id: n.id,
+                        title: getTitle(n),
+                        freshness: n.freshness,
+                    })),
+                    features: features.map((n) => ({
+                        id: n.id,
+                        title: getTitle(n),
+                        freshness: n.freshness,
+                    })),
+                    other: other.map((n) => ({
+                        id: n.id,
+                        type: n.type,
+                        title: getTitle(n),
+                        freshness: n.freshness,
+                    })),
+                },
+                exitCode,
+                reason,
+            }, null, 2));
+            await closePool();
+            process.exit(exitCode);
+        }
+        // Pretty output
+        console.log(`\n  ${BOLD}Codify — Context Check${RESET}\n`);
+        console.log(`  Files: ${CYAN}${files.join(", ")}${RESET}`);
+        console.log(`  Keywords: ${DIM}${keywords.join(", ")}${RESET}\n`);
+        if (nodes.length === 0) {
+            console.log(`  No context found for ${files.join(", ")}. Run 'codify bootstrap' to populate the graph.\n`);
+            await closePool();
+            process.exit(0);
+        }
+        // Render grouped results
+        if (decisions.length > 0) {
+            console.log(`  ${BOLD}Decisions (${decisions.length}):${RESET}`);
+            for (const n of decisions) {
+                const title = n.properties.title ?? n.metadata.title ?? n.id;
+                const freshPct = Math.round((n.freshness ?? 0) * 100);
+                console.log(`    "${title}" ${DIM}(freshness: ${freshPct}%)${RESET}`);
+            }
+            console.log("");
+        }
+        if (gaps.length > 0) {
+            // Separate open vs resolved gaps
+            const openGaps = gaps.filter((g) => {
+                const status = g.properties.status ?? "detected";
+                return status !== "resolved" && status !== "wont_fix";
+            });
+            const resolvedGaps = gaps.filter((g) => {
+                const status = g.properties.status ?? "detected";
+                return status === "resolved" || status === "wont_fix";
+            });
+            if (openGaps.length > 0) {
+                console.log(`  ${BOLD}Open Gaps (${openGaps.length}):${RESET}`);
+                for (const n of openGaps) {
+                    const title = n.properties.title ?? n.metadata.title ?? n.id;
+                    const severity = n.properties.severity ?? "unknown";
+                    const isBlocking = severity === "critical" || severity === "high";
+                    const icon = isBlocking ? `${RED}!${RESET}` : `${YELLOW}*${RESET}`;
+                    console.log(`    ${icon} ${severityBadge(severity)}: "${title}"`);
+                }
+                console.log("");
+            }
+            if (resolvedGaps.length > 0) {
+                console.log(`  ${BOLD}Resolved Gaps (${resolvedGaps.length}):${RESET}`);
+                for (const n of resolvedGaps) {
+                    const title = n.properties.title ?? n.metadata.title ?? n.id;
+                    const status = n.properties.status ?? "resolved";
+                    console.log(`    ${GREEN}✓${RESET} "${title}" ${DIM}(${status})${RESET}`);
+                }
+                console.log("");
+            }
+        }
+        if (signals.length > 0) {
+            console.log(`  ${BOLD}Customer Signals (${signals.length}):${RESET}`);
+            for (const n of signals) {
+                const title = n.properties.title ?? n.metadata.title ?? n.id;
+                console.log(`    "${title}"`);
+            }
+            console.log("");
+        }
+        if (features.length > 0) {
+            console.log(`  ${BOLD}Features (${features.length}):${RESET}`);
+            for (const n of features) {
+                const title = n.properties.title ?? n.metadata.title ?? n.id;
+                console.log(`    "${title}"`);
+            }
+            console.log("");
+        }
+        if (other.length > 0) {
+            console.log(`  ${BOLD}Other (${other.length}):${RESET}`);
+            for (const n of other) {
+                const title = n.properties.title ?? n.metadata.title ?? n.id;
+                console.log(`    [${n.type}] "${title}"`);
+            }
+            console.log("");
+        }
+        // Footer summary
+        const summaryParts = [];
+        if (decisions.length > 0)
+            summaryParts.push(`${decisions.length} decision${decisions.length === 1 ? "" : "s"}`);
+        if (gaps.length > 0) {
+            const openCount = gaps.filter((g) => {
+                const status = g.properties.status ?? "detected";
+                return status !== "resolved" && status !== "wont_fix";
+            }).length;
+            if (openCount > 0) {
+                const maxSeverity = blockingGaps.length > 0
+                    ? blockingGaps.some((g) => g.properties.severity === "critical") ? "CRITICAL" : "HIGH"
+                    : "open";
+                summaryParts.push(`${openCount} gap${openCount === 1 ? "" : "s"} (${maxSeverity})`);
+            }
+        }
+        if (signals.length > 0)
+            summaryParts.push(`${signals.length} signal${signals.length === 1 ? "" : "s"}`);
+        if (features.length > 0)
+            summaryParts.push(`${features.length} feature${features.length === 1 ? "" : "s"}`);
+        console.log(`  ${"─".repeat(35)}`);
+        console.log(`  ${summaryParts.join(", ")}`);
+        if (exitCode === 1) {
+            console.log(`  Exit: ${RED}${BOLD}1${RESET} (${reason})`);
+        }
+        else {
+            console.log(`  Exit: ${GREEN}0${RESET} (${reason})`);
+        }
+        console.log("");
+        await closePool();
+        process.exit(exitCode);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("ECONNREFUSED")) {
+            console.error("\n  ERROR: Cannot connect to Codify services.");
+            console.error("  Run 'codify init' to start the infrastructure.\n");
+        }
+        else if (message.includes("ANTHROPIC_API_KEY")) {
+            console.error("\n  ERROR: ANTHROPIC_API_KEY not set.");
+            console.error("  Export your API key: export ANTHROPIC_API_KEY=sk-...\n");
+        }
+        else {
+            console.error(`\n  ERROR: ${message}\n`);
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/commands/cleanup.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const cleanupCommand: Command;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/commands/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkNpC,eAAO,MAAM,cAAc,SAEE,CAAC"}

package/dist/commands/cleanup.js

@@ -0,0 +1,166 @@
+// codify cleanup gaps — fix legacy gap descriptions containing UUIDs
+import { Command } from "commander";
+import { loadProjectConfig } from "../lib/config.js";
+// --- Color helpers (ANSI escape codes) ---
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const GREEN = "\x1b[32m";
+const CYAN = "\x1b[36m";
+const YELLOW = "\x1b[33m";
+// UUID regex pattern
+const UUID_RE = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
+/**
+ * Resolve a human-readable title for a node, using standard priority:
+ * properties.title > metadata.title > properties.name > metadata.name > id prefix
+ */
+function resolveTitle(properties, metadata, id) {
+    const p = properties ?? {};
+    const m = metadata ?? {};
+    return (p.title ??
+        m.title ??
+        p.name ??
+        m.name ??
+        id.slice(0, 8) + "...");
+}
+// --- Subcommand: gaps ---
+const gapsSubcommand = new Command("gaps")
+    .description("Fix gap descriptions that contain UUIDs instead of titles")
+    .option("--dry-run", "Show what would be fixed without making changes")
+    .action(async (opts) => {
+    try {
+        await loadProjectConfig();
+        const { getPool, closePool } = await import("@codify/graph");
+        const pool = getPool();
+        try {
+            await pool.query("SELECT 1");
+        }
+        catch {
+            console.error("  ERROR: Cannot connect to PostgreSQL. Run 'codify init' first.\n");
+            process.exit(1);
+        }
+        const isDryRun = !!opts.dryRun;
+        if (isDryRun) {
+            console.log(`\n  ${BOLD}Codify — Cleanup Gap Descriptions (dry run)${RESET}\n`);
+        }
+        else {
+            console.log(`\n  ${BOLD}Codify — Cleanup Gap Descriptions${RESET}\n`);
+        }
+        // Fetch all active Gap nodes
+        const gapsResult = await pool.query(`SELECT id, properties, metadata FROM nodes WHERE type = 'Gap' AND superseded_by IS NULL`);
+        const gaps = gapsResult.rows;
+        if (gaps.length === 0) {
+            console.log("  No gaps found in the graph.\n");
+            await closePool();
+            return;
+        }
+        // Cache for resolved node titles (UUID -> title string)
+        const titleCache = new Map();
+        async function resolveTitleForUuid(uuid) {
+            const cached = titleCache.get(uuid);
+            if (cached !== undefined)
+                return cached;
+            const result = await pool.query(`SELECT properties, metadata FROM nodes WHERE id = $1`, [uuid]);
+            let title;
+            if (result.rows.length === 0) {
+                // Node not found — use truncated UUID
+                title = uuid.slice(0, 8) + "...";
+            }
+            else {
+                const row = result.rows[0];
+                title = resolveTitle(row.properties, row.metadata, uuid);
+            }
+            titleCache.set(uuid, title);
+            return title;
+        }
+        /**
+         * Replace all UUIDs in a string with resolved titles (wrapped in quotes).
+         * Returns [newString, wasChanged].
+         */
+        async function replaceUuids(text) {
+            const uuids = text.match(UUID_RE);
+            if (!uuids || uuids.length === 0)
+                return [text, false];
+            let result = text;
+            for (const uuid of uuids) {
+                const title = await resolveTitleForUuid(uuid);
+                result = result.replace(uuid, `'${title}'`);
+            }
+            return [result, result !== text];
+        }
+        let fixedCount = 0;
+        let cleanCount = 0;
+        for (const gap of gaps) {
+            const props = gap.properties ?? {};
+            const description = props.description ?? "";
+            const title = props.title ?? "";
+            // Check if description or title contain UUIDs
+            const descHasUuid = UUID_RE.test(description);
+            UUID_RE.lastIndex = 0; // Reset regex state (global flag)
+            const titleHasUuid = UUID_RE.test(title);
+            UUID_RE.lastIndex = 0;
+            if (!descHasUuid && !titleHasUuid) {
+                cleanCount++;
+                continue;
+            }
+            // Resolve UUIDs in description and title
+            const [newDescription, descChanged] = await replaceUuids(description);
+            const [newTitle, titleChanged] = await replaceUuids(title);
+            if (!descChanged && !titleChanged) {
+                cleanCount++;
+                continue;
+            }
+            // Build the short ID for display
+            const shortId = gap.id.slice(0, 6);
+            // Show what changed
+            if (descChanged) {
+                const oldSnippet = description.length > 60 ? description.slice(0, 60) + "..." : description;
+                const newSnippet = newDescription.length > 60 ? newDescription.slice(0, 60) + "..." : newDescription;
+                console.log(`  ${GREEN}Fixed${RESET} gap ${CYAN}${shortId}${RESET}: '${oldSnippet}'`);
+                console.log(`    ${DIM}->${RESET} '${newSnippet}'`);
+            }
+            if (titleChanged) {
+                const oldSnippet = title.length > 60 ? title.slice(0, 60) + "..." : title;
+                const newSnippet = newTitle.length > 60 ? newTitle.slice(0, 60) + "..." : newTitle;
+                console.log(`  ${GREEN}Fixed${RESET} gap ${CYAN}${shortId}${RESET} title: '${oldSnippet}'`);
+                console.log(`    ${DIM}->${RESET} '${newSnippet}'`);
+            }
+            if (!isDryRun) {
+                // Update the node's properties, preserving all other fields
+                const updatedProps = { ...props };
+                if (descChanged)
+                    updatedProps.description = newDescription;
+                if (titleChanged)
+                    updatedProps.title = newTitle;
+                await pool.query(`UPDATE nodes SET properties = $1::jsonb, updated_at = now() WHERE id = $2`, [JSON.stringify(updatedProps), gap.id]);
+            }
+            fixedCount++;
+        }
+        // Summary
+        console.log("");
+        if (isDryRun) {
+            console.log(`  ${YELLOW}Dry run:${RESET} ${fixedCount} gap${fixedCount === 1 ? "" : "s"} would be fixed. ${cleanCount} already clean.`);
+        }
+        else {
+            console.log(`  Fixed ${BOLD}${fixedCount}${RESET} gap description${fixedCount === 1 ? "" : "s"}. ${cleanCount} already clean.`);
+        }
+        console.log("");
+        await closePool();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("ECONNREFUSED")) {
+            console.error("\n  ERROR: Cannot connect to Codify services.");
+            console.error("  Run 'codify init' to start the infrastructure.\n");
+        }
+        else {
+            console.error(`\n  ERROR: ${message}\n`);
+        }
+        process.exit(1);
+    }
+});
+// --- Parent command ---
+export const cleanupCommand = new Command("cleanup")
+    .description("Fix legacy data quality issues")
+    .addCommand(gapsSubcommand);
+//# sourceMappingURL=cleanup.js.map

package/dist/commands/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"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"}

package/dist/commands/collect.d.ts

@@ -0,0 +1,26 @@
+import { Command } from "commander";
+/**
+ * Core graph-mining logic: search for evidence nodes relevant to an affected node,
+ * create evidence_for edges, and return results.
+ *
+ * Exported so triage.ts can reuse it inline.
+ */
+export declare function collectEvidenceForGap(pool: {
+    query: <T extends Record<string, unknown> = Record<string, unknown>>(sql: string, params?: unknown[]) => Promise<{
+        rows: T[];
+    }>;
+}, gapId: string, affectedNodes: Array<{
+    id: string;
+    type: string;
+    title: string;
+}>): Promise<{
+    evidenceNodes: Array<{
+        id: string;
+        type: string;
+        title: string;
+        targetNodeId: string;
+    }>;
+    edgesCreated: number;
+}>;
+export declare const collectCommand: Command;
+//# sourceMappingURL=collect.d.ts.map

package/dist/commands/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/commands/collect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmDpC;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE;IACJ,KAAK,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,KACf,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;CAC7B,EACD,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,KAAK,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,GACD,OAAO,CAAC;IACT,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CA2FD;AAID,eAAO,MAAM,cAAc,SAiLvB,CAAC"}