ctxo-mcp 0.4.2 → 0.5.1

package/README.md

@@ -41,17 +41,16 @@ Ctxo is an **MCP server** that **enhances** your existing AI tools with dependen
 
 ## Quick Start
 
-```Shell
-# 1. Index your codebase
-npx ctxo-mcp index
-
-# 2. Add to your IDE's MCP config
-# (see IDE Setup below)
+One command sets up everything — index directory, MCP server registration, AI tool rules, and git hooks:
 
-# 3. Start using — your AI assistant now has 14 code intelligence tools
+```Shell
+npx ctxo-mcp init
 ```
 
-## IDE Setup
+That's it. The interactive wizard detects your AI tools, registers the ctxo MCP server in the correct config file (`.mcp.json`, `.vscode/mcp.json`, etc.), and generates usage rules so your assistant knows when to call each tool.
+
+<details>
+<summary>Manual MCP config (if not using <code>ctxo init</code>)</summary>
 
 **Claude Code / Cursor / Windsurf / Cline** — `.mcp.json`:
 
@@ -71,6 +70,8 @@ npx ctxo-mcp index
 { "context_servers": { "ctxo": { "command": { "path": "npx", "args": ["-y", "ctxo-mcp"] } } } }
 ```
 
+</details>
+
 ## 14 Tools
 
 | Tool                        | What it does                                                                             |
@@ -107,17 +108,23 @@ Onboarding?               → get_architectural_overlay → get_symbol_importanc
 ## CLI Commands
 
 ```Shell
-npx ctxo-mcp index                # Build full codebase index
-npx ctxo-mcp index --check        # CI gate: fail if index stale
-npx ctxo-mcp index --skip-history # Fast re-index without git history
-npx ctxo-mcp watch                # File watcher for incremental re-index
-npx ctxo-mcp init                 # Install git hooks (post-commit, post-merge)
-npx ctxo-mcp status               # Show index manifest
-npx ctxo-mcp sync                 # Rebuild SQLite cache from committed JSON
-npx ctxo-mcp stats                # Show usage statistics
-npx ctxo-mcp stats --json         # Machine-readable output
-npx ctxo-mcp stats --days 7       # Last 7 days only
-npx ctxo-mcp stats --clear        # Delete all session data
+# Setup
+npx ctxo-mcp init                          # Interactive setup (index, AI tool rules, git hooks)
+npx ctxo-mcp init --tools claude-code,cursor -y  # Non-interactive setup
+npx ctxo-mcp init --rules                  # Regenerate AI tool rules only
+npx ctxo-mcp init --dry-run                # Preview what would be created
+
+# Indexing
+npx ctxo-mcp index                         # Build full codebase index
+npx ctxo-mcp index --check                 # CI gate: fail if index stale
+npx ctxo-mcp index --skip-history          # Fast re-index without git history
+npx ctxo-mcp watch                         # File watcher for incremental re-index
+npx ctxo-mcp sync                          # Rebuild SQLite cache from committed JSON
+
+# Diagnostics
+npx ctxo-mcp status                        # Show index manifest
+npx ctxo-mcp doctor                        # Health check all subsystems (--json, --quiet)
+npx ctxo-mcp stats                         # Show usage statistics (--json, --days N, --clear)
 ```
 
 **Example output:**

package/dist/{staleness-detector-VSDPTPX7.js → chunk-PSKDDLSF.js}

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-JIDIH7DS.js";
 
 // src/core/staleness/staleness-detector.ts
 import { statSync, existsSync } from "fs";
@@ -34,7 +33,8 @@ var StalenessDetector = class {
     };
   }
 };
+
 export {
   StalenessDetector
 };
-//# sourceMappingURL=staleness-detector-VSDPTPX7.js.map
+//# sourceMappingURL=chunk-PSKDDLSF.js.map

package/dist/{staleness-detector-VSDPTPX7.js.map → chunk-PSKDDLSF.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/staleness/staleness-detector.ts"],"sourcesContent":["import { statSync, existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport interface StalenessWarning {\n  readonly staleFiles: string[];\n  readonly message: string;\n}\n\nexport class StalenessDetector {\n  private readonly projectRoot: string;\n  private readonly indexDir: string;\n\n  constructor(projectRoot: string, ctxoRoot: string) {\n    this.projectRoot = projectRoot;\n    this.indexDir = join(ctxoRoot, 'index');\n  }\n\n  check(indexedFiles: readonly string[]): StalenessWarning | undefined {\n    if (!existsSync(this.indexDir)) return undefined;\n\n    const staleFiles: string[] = [];\n\n    for (const relativePath of indexedFiles) {\n      const sourcePath = join(this.projectRoot, relativePath);\n      const indexPath = join(this.indexDir, `${relativePath}.json`);\n\n      if (!existsSync(sourcePath) || !existsSync(indexPath)) continue;\n\n      try {\n        const sourceMtime = Math.floor(statSync(sourcePath).mtimeMs / 1000);\n        const indexMtime = Math.floor(statSync(indexPath).mtimeMs / 1000);\n\n        if (sourceMtime > indexMtime) {\n          staleFiles.push(relativePath);\n        }\n      } catch {\n        // Skip files we can't stat\n      }\n    }\n\n    if (staleFiles.length === 0) return undefined;\n\n    return {\n      staleFiles,\n      message: `Index may be stale for ${staleFiles.length} file(s). Run \"ctxo index\" to refresh.`,\n    };\n  }\n}\n"],"mappings":";;;;AAAA,SAAS,UAAU,kBAAkB;AACrC,SAAS,YAAY;AAOd,IAAM,oBAAN,MAAwB;AAAA,EACZ;AAAA,EACA;AAAA,EAEjB,YAAY,aAAqB,UAAkB;AACjD,SAAK,cAAc;AACnB,SAAK,WAAW,KAAK,UAAU,OAAO;AAAA,EACxC;AAAA,EAEA,MAAM,cAA+D;AACnE,QAAI,CAAC,WAAW,KAAK,QAAQ,EAAG,QAAO;AAEvC,UAAM,aAAuB,CAAC;AAE9B,eAAW,gBAAgB,cAAc;AACvC,YAAM,aAAa,KAAK,KAAK,aAAa,YAAY;AACtD,YAAM,YAAY,KAAK,KAAK,UAAU,GAAG,YAAY,OAAO;AAE5D,UAAI,CAAC,WAAW,UAAU,KAAK,CAAC,WAAW,SAAS,EAAG;AAEvD,UAAI;AACF,cAAM,cAAc,KAAK,MAAM,SAAS,UAAU,EAAE,UAAU,GAAI;AAClE,cAAM,aAAa,KAAK,MAAM,SAAS,SAAS,EAAE,UAAU,GAAI;AAEhE,YAAI,cAAc,YAAY;AAC5B,qBAAW,KAAK,YAAY;AAAA,QAC9B;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,QAAI,WAAW,WAAW,EAAG,QAAO;AAEpC,WAAO;AAAA,MACL;AAAA,MACA,SAAS,0BAA0B,WAAW,MAAM;AAAA,IACtD;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/core/staleness/staleness-detector.ts"],"sourcesContent":["import { statSync, existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport interface StalenessWarning {\n  readonly staleFiles: string[];\n  readonly message: string;\n}\n\nexport class StalenessDetector {\n  private readonly projectRoot: string;\n  private readonly indexDir: string;\n\n  constructor(projectRoot: string, ctxoRoot: string) {\n    this.projectRoot = projectRoot;\n    this.indexDir = join(ctxoRoot, 'index');\n  }\n\n  check(indexedFiles: readonly string[]): StalenessWarning | undefined {\n    if (!existsSync(this.indexDir)) return undefined;\n\n    const staleFiles: string[] = [];\n\n    for (const relativePath of indexedFiles) {\n      const sourcePath = join(this.projectRoot, relativePath);\n      const indexPath = join(this.indexDir, `${relativePath}.json`);\n\n      if (!existsSync(sourcePath) || !existsSync(indexPath)) continue;\n\n      try {\n        const sourceMtime = Math.floor(statSync(sourcePath).mtimeMs / 1000);\n        const indexMtime = Math.floor(statSync(indexPath).mtimeMs / 1000);\n\n        if (sourceMtime > indexMtime) {\n          staleFiles.push(relativePath);\n        }\n      } catch {\n        // Skip files we can't stat\n      }\n    }\n\n    if (staleFiles.length === 0) return undefined;\n\n    return {\n      staleFiles,\n      message: `Index may be stale for ${staleFiles.length} file(s). Run \"ctxo index\" to refresh.`,\n    };\n  }\n}\n"],"mappings":";;;AAAA,SAAS,UAAU,kBAAkB;AACrC,SAAS,YAAY;AAOd,IAAM,oBAAN,MAAwB;AAAA,EACZ;AAAA,EACA;AAAA,EAEjB,YAAY,aAAqB,UAAkB;AACjD,SAAK,cAAc;AACnB,SAAK,WAAW,KAAK,UAAU,OAAO;AAAA,EACxC;AAAA,EAEA,MAAM,cAA+D;AACnE,QAAI,CAAC,WAAW,KAAK,QAAQ,EAAG,QAAO;AAEvC,UAAM,aAAuB,CAAC;AAE9B,eAAW,gBAAgB,cAAc;AACvC,YAAM,aAAa,KAAK,KAAK,aAAa,YAAY;AACtD,YAAM,YAAY,KAAK,KAAK,UAAU,GAAG,YAAY,OAAO;AAE5D,UAAI,CAAC,WAAW,UAAU,KAAK,CAAC,WAAW,SAAS,EAAG;AAEvD,UAAI;AACF,cAAM,cAAc,KAAK,MAAM,SAAS,UAAU,EAAE,UAAU,GAAI;AAClE,cAAM,aAAa,KAAK,MAAM,SAAS,SAAS,EAAE,UAAU,GAAI;AAEhE,YAAI,cAAc,YAAY;AAC5B,qBAAW,KAAK,YAAY;AAAA,QAC9B;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,QAAI,WAAW,WAAW,EAAG,QAAO;AAEpC,WAAO;AAAA,MACL;AAAA,MACA,SAAS,0BAA0B,WAAW,MAAM;AAAA,IACtD;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-JIDIH7DS.js → chunk-WNEGGJMV.js}

@@ -6,6 +6,9 @@ var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -22,7 +25,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 
 export {
   __esm,
+  __commonJS,
   __export,
   __toCommonJS
 };
-//# sourceMappingURL=chunk-JIDIH7DS.js.map
+//# sourceMappingURL=chunk-WNEGGJMV.js.map