@codified/cli 0.3.5 → 0.3.7

package/README.md

@@ -0,0 +1,115 @@
+# Codify
+
+**Living context graph for AI-native teams.**
+
+Codify mines your project history into a structured graph that captures decisions, features, customer signals, code artifacts, and their relationships. It then gives Claude Code ambient access to that context via MCP, so your AI assistant understands not just what your code does but *why* it was built that way.
+
+A built-in Gap Engine proactively detects missing context, stale assumptions, and untested decisions. Gaps get addressed automatically through graph mining and evidence collection.
+
+## Prerequisites
+
+- Node.js 22+
+- Docker (for PostgreSQL, NATS, Redis)
+- `ANTHROPIC_API_KEY` environment variable (for bootstrap, explain, and collect commands)
+
+## Install
+
+```bash
+npm install -g @codified/cli
+```
+
+## Quickstart
+
+```bash
+cd your-project
+codify up
+```
+
+`codify up` runs three steps in sequence:
+
+1. **init** -- Starts Docker services (PostgreSQL + AGE + pgvector, NATS, Redis), runs database migrations, and installs the MCP server config into Claude Code.
+2. **bootstrap** -- Mines your git history with Claude, extracting decisions, features, and relationships into the context graph.
+3. **start** -- Launches the MCP server on stdio. Claude Code connects automatically.
+
+After this, open Claude Code in your project. It now has full context about your codebase.
+
+## Commands
+
+### Getting Started
+
+| Command | Description |
+|---------|-------------|
+| `codify up` | One-command setup and start (init + bootstrap + start) |
+| `codify init` | Set up infrastructure and configure project |
+| `codify bootstrap` | Mine git history into the context graph |
+| `codify start` | Start the MCP server for Claude Code |
+
+### Working with Context
+
+| Command | Description |
+|---------|-------------|
+| `codify explain <question>` | Ask Claude a question about your project |
+| `codify search <query>` | Search the context graph by keyword |
+| `codify add` | Record a decision, signal, or other context |
+| `codify graph` | Visualize the context graph (Mermaid diagram) |
+| `codify status` | Show project health dashboard |
+
+### Gaps and Quality
+
+| Command | Description |
+|---------|-------------|
+| `codify gaps` | Show gaps detected by the Gap Engine |
+| `codify triage` | Interactively resolve gaps |
+| `codify collect` | Mine the graph for evidence to fill gaps |
+| `codify check <file>` | Check files for related context (CI-ready) |
+
+### Projects and Maintenance
+
+| Command | Description |
+|---------|-------------|
+| `codify project create/list/switch` | Manage multiple projects |
+| `codify timeline` | Show what changed in the graph over time |
+| `codify export` | Backup the graph to JSON |
+| `codify import` | Restore the graph from a JSON backup |
+| `codify watch` | Start continuous ingest polling |
+| `codify connect` | Connect external data sources |
+| `codify reset` | Reset the context graph (drop all data) |
+
+Run `codify <command> --help` for detailed options on any command.
+
+## MCP Integration
+
+Codify auto-installs its MCP server config during `codify init`. Claude Code connects automatically -- no manual configuration required.
+
+The MCP server exposes tools that Claude can call directly:
+
+- **codify_get_context** -- Retrieve context nodes by type or ID
+- **codify_search** -- Search the graph by keyword
+- **codify_explain** -- Claude-powered narrative synthesis from graph data
+- **codify_get_gaps** -- List detected context gaps
+- **codify_resolve_gap** -- Mark a gap as resolved with evidence
+- **codify_add_context** -- Add new context nodes to the graph
+- **codify_get_decision_trail** -- Trace the reasoning chain behind a decision
+- **codify_traverse** -- Walk the graph from any node
+- **codify_status** -- Graph health and statistics
+- **codify_collect** -- Mine evidence for open gaps
+- **codify_get_context_package** -- Get a bundled context snapshot for a topic
+
+## How It Works
+
+Codify uses PostgreSQL as its single storage engine:
+
+- **Apache AGE** for graph traversal (nodes, edges, relationships)
+- **pgvector** for semantic search (embedding-based similarity)
+- **NATS JetStream** for event-driven gap detection and metabolism
+- **Redis** for caching
+
+The context graph stores nodes (Decision, Feature, CustomerSignal, CodeArtifact, Gap, etc.) and typed edges representing their relationships. A Metabolism service continuously maintains graph health through freshness decay, contradiction detection, and deduplication.
+
+## Links
+
+- GitHub: [github.com/kurtxu88/codify](https://github.com/kurtxu88/codify)
+
+## License
+
+MIT

package/dist/commands/add.d.ts

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

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

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

package/dist/commands/add.js

@@ -0,0 +1,163 @@
+// codify add — record context into the graph from the terminal
+import { Command } from "commander";
+import { randomUUID } from "node:crypto";
+import { loadProjectConfig } from "../lib/config.js";
+// --- Color helpers (ANSI escape codes) ---
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const CYAN = "\x1b[36m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const MAGENTA = "\x1b[35m";
+const BLUE = "\x1b[34m";
+function typeColor(type) {
+    const colors = {
+        Decision: "\x1b[33m", // yellow
+        Feature: "\x1b[32m", // green
+        Metric: "\x1b[36m", // cyan
+        CustomerSignal: "\x1b[35m", // magenta
+        CodeArtifact: "\x1b[34m", // blue
+        Discussion: "\x1b[37m", // white
+    };
+    return `${colors[type] ?? DIM}${type}${RESET}`;
+}
+const NODE_TYPES = {
+    decision: { type: "Decision", defaultStatus: "accepted" },
+    feature: { type: "Feature", defaultStatus: "active" },
+    signal: { type: "CustomerSignal", defaultStatus: "active" },
+    artifact: { type: "CodeArtifact", defaultStatus: "active" },
+    discussion: { type: "Discussion", defaultStatus: "active" },
+    metric: { type: "Metric", defaultStatus: "active" },
+};
+// --- Insert helper ---
+async function insertNode(typeDef, title, 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 nodeId = randomUUID();
+        const tags = opts.tags ? opts.tags.split(",").map((t) => t.trim()).filter(Boolean) : [];
+        const properties = {
+            title,
+            status: typeDef.defaultStatus,
+        };
+        if (opts.description) {
+            properties.description = opts.description;
+        }
+        // Insert the node
+        await pool.query(`INSERT INTO nodes (id, type, layer, confidence, freshness, source_system, source_reference, source_agent_id, source_reliability, properties, tags)
+       VALUES ($1, $2, 'permanent', 0.8, 1.0, 'cli', 'codify-add', 'user', 0.8, $3, $4)`, [nodeId, typeDef.type, JSON.stringify(properties), tags]);
+        // If --link is provided, also create an edge
+        if (opts.link) {
+            const edgeType = opts.linkType ?? "relates_to";
+            const edgeId = randomUUID();
+            // Verify the target node exists
+            const targetResult = await pool.query("SELECT id FROM nodes WHERE id = $1", [opts.link]);
+            if (targetResult.rows.length === 0) {
+                console.warn(`\n  ${YELLOW}WARNING:${RESET} Target node ${opts.link} not found. Edge was not created.\n`);
+            }
+            else {
+                await pool.query(`INSERT INTO edges (id, type, source_id, target_id, confidence, weight, evidence)
+           VALUES ($1, $2, $3, $4, 0.8, 0.5, $5)`, [edgeId, edgeType, nodeId, opts.link, `CLI link: ${title}`]);
+            }
+        }
+        // Print success
+        console.log(`\n  ${GREEN}${BOLD}Context recorded.${RESET}\n`);
+        console.log(`  ${DIM}ID:${RESET}    ${CYAN}${nodeId}${RESET}`);
+        console.log(`  ${DIM}Type:${RESET}  [${typeColor(typeDef.type)}]`);
+        console.log(`  ${DIM}Title:${RESET} ${BOLD}${title}${RESET}`);
+        if (opts.description) {
+            console.log(`  ${DIM}Desc:${RESET}  ${opts.description}`);
+        }
+        if (tags.length > 0) {
+            console.log(`  ${DIM}Tags:${RESET}  ${tags.map((t) => `${MAGENTA}${t}${RESET}`).join(", ")}`);
+        }
+        if (opts.link) {
+            const edgeType = opts.linkType ?? "relates_to";
+            console.log(`  ${DIM}Link:${RESET}  ${BLUE}${edgeType}${RESET} -> ${opts.link}`);
+        }
+        console.log(`  ${DIM}Layer:${RESET} permanent  ${DIM}Confidence:${RESET} 0.80  ${DIM}Freshness:${RESET} 1.00`);
+        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 if (message.includes("violates foreign key constraint") && message.includes("edge_types")) {
+            const edgeType = opts.linkType ?? "relates_to";
+            console.error(`\n  ERROR: Edge type "${edgeType}" is not registered.`);
+            console.error("  Use a valid edge type: relates_to, caused_by, informed_by, evidence_for, etc.\n");
+        }
+        else {
+            console.error(`\n  ERROR: ${message}\n`);
+        }
+        process.exit(1);
+    }
+}
+// --- Build a subcommand for each node type ---
+function makeSubcommand(name, alias, typeDef, description) {
+    const cmd = new Command(name)
+        .description(description)
+        .argument("<title>", "Short title for the context node")
+        .option("--description <text>", "Detailed description or reasoning")
+        .option("--tags <tags>", "Comma-separated tags (e.g., auth,api)")
+        .option("--link <nodeId>", "Link to an existing node by ID")
+        .option("--link-type <edgeType>", "Edge type for the link (default: relates_to)", "relates_to")
+        .action(async (title, cmdOpts) => {
+        await insertNode(typeDef, title, {
+            description: cmdOpts.description,
+            tags: cmdOpts.tags,
+            link: cmdOpts.link,
+            linkType: cmdOpts.linkType,
+        });
+    });
+    if (alias) {
+        cmd.alias(alias);
+    }
+    return cmd;
+}
+// --- Subcommands ---
+const decisionSubcommand = makeSubcommand("decision", null, NODE_TYPES.decision, "Record a decision (e.g., 'Chose JWT for API auth')");
+const featureSubcommand = makeSubcommand("feature", null, NODE_TYPES.feature, "Record a feature (e.g., 'User auth flow')");
+const signalSubcommand = makeSubcommand("signal", "customer-signal", NODE_TYPES.signal, "Record a customer signal (e.g., '3 customers asked for dark mode')");
+const artifactSubcommand = makeSubcommand("artifact", "code-artifact", NODE_TYPES.artifact, "Record a code artifact (e.g., 'src/middleware/auth.ts')");
+const discussionSubcommand = makeSubcommand("discussion", null, NODE_TYPES.discussion, "Record a discussion (e.g., 'Team agreed on REST over GraphQL')");
+const metricSubcommand = makeSubcommand("metric", null, NODE_TYPES.metric, "Record a metric (e.g., 'API response time under 200ms')");
+// --- Main add command ---
+export const addCommand = new Command("add")
+    .description("Add context to the graph")
+    .addHelpText("after", `
+  Node types:
+    decision     Record a technical or product decision
+    feature      Record a product feature
+    signal       Record a customer signal (alias: customer-signal)
+    artifact     Record a code artifact (alias: code-artifact)
+    discussion   Record a team discussion
+    metric       Record a tracked metric
+
+  Examples:
+    codify add decision "Chose JWT for API auth" --description "Stateless, scalable" --tags auth,api
+    codify add signal "3 customers asked for dark mode" --tags ux,feature-request
+    codify add feature "User auth flow" --description "Login/signup with JWT"
+    codify add artifact "src/middleware/auth.ts" --tags auth
+    codify add discussion "Team agreed on REST over GraphQL" --tags api
+    codify add metric "API response time under 200ms" --tags performance
+`)
+    .addCommand(decisionSubcommand)
+    .addCommand(featureSubcommand)
+    .addCommand(signalSubcommand)
+    .addCommand(artifactSubcommand)
+    .addCommand(discussionSubcommand)
+    .addCommand(metricSubcommand);
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/commands/bootstrap.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,gBAAgB,SA+IzB,CAAC"}

package/dist/commands/bootstrap.js

@@ -0,0 +1,141 @@
+// codify bootstrap — mine the current project's git history into the context graph
+//
+// Uses the ingest service: LocalGitConnector → GitMiner (Claude-powered) → StagingPipeline
+// This is the proper pipeline — Claude interprets commit messages, PR descriptions,
+// and review comments to extract Decision, Feature, CodeArtifact, Discussion, Person nodes.
+import { Command } from "commander";
+import { spawnSync } from "node:child_process";
+import { loadProjectConfig } from "../lib/config.js";
+import { confirm } from "../lib/prompt.js";
+export const bootstrapCommand = new Command("bootstrap")
+    .description("Mine the current project's git history into the context graph")
+    .option("--limit <n>", "Maximum commits to process", "500")
+    .option("--skip-prs", "Skip GitHub PR fetching")
+    .option("--batch-size <n>", "Artifacts per miner batch", "10")
+    .option("--yes", "Skip confirmation prompt")
+    .action(async (opts) => {
+    try {
+        const cwd = process.cwd();
+        console.log("\n  Codify Bootstrap — Mining Git History\n");
+        // Check we're in a git repo
+        const gitCheck = spawnSync("git", ["rev-parse", "--is-inside-work-tree"], {
+            cwd,
+            stdio: "pipe",
+        });
+        if (gitCheck.status !== 0) {
+            console.error("  ERROR: Not in a git repository. Run from a git project.\n");
+            process.exit(1);
+        }
+        // Cost estimate
+        const commitCountResult = spawnSync("git", ["rev-list", "--count", "HEAD"], {
+            cwd,
+            stdio: "pipe",
+        });
+        let commitCount = parseInt(commitCountResult.stdout?.toString().trim() ?? "0", 10);
+        const limit = parseInt(opts.limit, 10);
+        if (commitCount > limit)
+            commitCount = limit;
+        console.log(`  Will process ${commitCount} commits (Claude API calls required).`);
+        if (!opts.yes) {
+            const proceed = await confirm("  Proceed?");
+            if (!proceed) {
+                console.log("  Aborted.\n");
+                process.exit(0);
+            }
+        }
+        console.log("");
+        // Load project config (.codify/config.json → env vars)
+        await loadProjectConfig();
+        // Verify DB connection
+        const { getPool } = 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);
+        }
+        // Check for ANTHROPIC_API_KEY
+        if (!process.env.ANTHROPIC_API_KEY) {
+            console.error("  ERROR: ANTHROPIC_API_KEY not set. The miner needs Claude to extract context.\n");
+            console.error("  Set it in your environment or .codify/config.json.\n");
+            process.exit(1);
+        }
+        // Initialize the ingest service
+        console.log("  [1/3] Initializing ingest service...");
+        const { createIngestService } = await import("@codify/agents");
+        const batchSize = parseInt(opts.batchSize, 10);
+        const ingest = await createIngestService({
+            minerBatchSize: batchSize,
+            enableDedup: true,
+            autoPromoteThreshold: 0.7,
+        });
+        // Connect the local-git connector to this project
+        console.log(`  OK    Connecting to ${cwd}`);
+        await ingest.registry.connect("local-git", {
+            type: "local",
+            credentials: { repoPath: cwd, maxCommits: String(limit) },
+        });
+        // Run bootstrap (full sync through connector → miner → pipeline)
+        console.log("\n  [2/3] Mining git history with Claude...");
+        console.log("         This uses AI to extract decisions, features, discussions,");
+        console.log("         and relationships from your commit and PR history.\n");
+        const totalBatches = Math.ceil(commitCount / batchSize);
+        console.log(`  Processing ${commitCount} commits in ~${totalBatches} batch${totalBatches === 1 ? "" : "es"}\n`);
+        const startTime = Date.now();
+        const batchTimes = [];
+        let batchNum = 0;
+        // Progress callback — logs per-batch progress with ETA
+        const originalLog = console.log;
+        const batchPattern = /mined|batch|processing/i;
+        const patchedLog = (...args) => {
+            const msg = String(args[0] ?? "");
+            if (batchPattern.test(msg)) {
+                batchNum++;
+                const now = Date.now();
+                batchTimes.push(now);
+                if (batchNum >= 2 && batchNum < totalBatches) {
+                    const elapsed = (now - startTime) / 1000;
+                    const avgBatchSec = elapsed / batchNum;
+                    const remaining = Math.round(avgBatchSec * (totalBatches - batchNum));
+                    const mins = Math.floor(remaining / 60);
+                    const secs = remaining % 60;
+                    const eta = mins > 0 ? `${mins}m ${secs}s` : `${secs}s`;
+                    originalLog(`  Batch ${batchNum}/${totalBatches} (${Math.round((batchNum / totalBatches) * 100)}%) — ~${eta} remaining`);
+                    return;
+                }
+            }
+            originalLog(...args);
+        };
+        console.log = patchedLog;
+        const result = await ingest.bootstrap.run("local-git");
+        console.log = originalLog;
+        const durationSec = ((Date.now() - startTime) / 1000).toFixed(1);
+        // Summary
+        console.log(`\n  Your context graph is live!\n`);
+        console.log(`  ${result.totalArtifacts} artifacts mined in ${durationSec}s\n`);
+        console.log(`  Nodes: ${result.pipeline.created.length} created, ${result.pipeline.merged.length} merged`);
+        if (result.pipeline.rejected.length > 0) {
+            console.log(`  Skipped: ${result.pipeline.rejected.length}`);
+        }
+        console.log(`\n  Run 'codify status' to see your graph.`);
+        console.log(`  Claude Code now has full context about your project.\n`);
+    }
+    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=bootstrap.js.map

package/dist/commands/bootstrap.js.map

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

package/dist/commands/check.d.ts

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

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

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