indexer-cli 0.2.1

package/dist/cli/commands/setup.js

@@ -0,0 +1,425 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSetupCommand = registerSetupCommand;
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = __importDefault(require("node:os"));
+const PLATFORM = node_os_1.default.platform();
+const IS_MAC = PLATFORM === "darwin";
+const IS_LINUX = PLATFORM === "linux";
+if (!IS_MAC && !IS_LINUX) {
+    console.error(`Unsupported platform: ${PLATFORM}. Only macOS and Linux are supported.`);
+    process.exit(1);
+}
+function run(cmd, opts) {
+    const output = (0, node_child_process_1.execSync)(cmd, {
+        stdio: opts?.stdio ?? "pipe",
+        encoding: "utf8",
+    });
+    return normalizeCommandOutput(output);
+}
+function normalizeCommandOutput(output) {
+    if (typeof output === "string") {
+        return output.trim();
+    }
+    if (Buffer.isBuffer(output)) {
+        return output.toString("utf8").trim();
+    }
+    return "";
+}
+function cmdExists(cmd) {
+    try {
+        (0, node_child_process_1.execSync)(`command -v ${cmd}`, { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function bold(text) {
+    return `\x1b[1m${text}\x1b[0m`;
+}
+function green(text) {
+    return `\x1b[32m${text}\x1b[0m`;
+}
+function yellow(text) {
+    return `\x1b[33m${text}\x1b[0m`;
+}
+function red(text) {
+    return `\x1b[31m${text}\x1b[0m`;
+}
+function createSkippedResult(name, detail) {
+    return { name, status: "skipped", detail };
+}
+const results = [];
+// ── Node.js ─────────────────────────────────────────────────────────────
+function checkNode() {
+    if (!cmdExists("node")) {
+        console.log(`  ${yellow("⨯")} Node.js not found. Installing...`);
+        try {
+            if (IS_MAC && cmdExists("brew")) {
+                run("brew install node", { stdio: "inherit" });
+            }
+            else if (IS_LINUX && cmdExists("apt-get")) {
+                run("sudo apt-get update -qq", { stdio: "inherit" });
+                run("sudo apt-get install -y -qq nodejs", { stdio: "inherit" });
+            }
+            else {
+                return {
+                    name: "Node.js",
+                    status: "failed",
+                    detail: "Install manually: https://nodejs.org/en/download",
+                };
+            }
+        }
+        catch (e) {
+            return {
+                name: "Node.js",
+                status: "failed",
+                detail: `Install failed: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+    }
+    try {
+        const version = run("node --version");
+        const major = parseInt(version.replace(/^v/, "").split(".")[0], 10);
+        if (major >= 18) {
+            return { name: "Node.js", status: "ok", detail: version };
+        }
+        return {
+            name: "Node.js",
+            status: "failed",
+            detail: `${version} found, but 18+ required`,
+        };
+    }
+    catch {
+        return {
+            name: "Node.js",
+            status: "failed",
+            detail: "Failed to detect version",
+        };
+    }
+}
+// ── Git ─────────────────────────────────────────────────────────────────
+function checkGit() {
+    if (!cmdExists("git")) {
+        console.log(`  ${yellow("⨯")} git not found. Installing...`);
+        try {
+            if (IS_MAC && cmdExists("brew")) {
+                run("brew install git", { stdio: "inherit" });
+            }
+            else if (IS_LINUX && cmdExists("apt-get")) {
+                run("sudo apt-get install -y -qq git", { stdio: "inherit" });
+            }
+            else {
+                return {
+                    name: "Git",
+                    status: "failed",
+                    detail: "Install manually: https://git-scm.com",
+                };
+            }
+        }
+        catch (e) {
+            return {
+                name: "Git",
+                status: "failed",
+                detail: `Install failed: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+    }
+    try {
+        const version = run("git --version");
+        return { name: "Git", status: "ok", detail: version };
+    }
+    catch {
+        return {
+            name: "Git",
+            status: "failed",
+            detail: "Failed to detect version",
+        };
+    }
+}
+// ── Build tools ─────────────────────────────────────────────────────────
+function checkBuildTools() {
+    if (IS_MAC) {
+        try {
+            const path = run("xcode-select -p");
+            if (path) {
+                return { name: "Build tools (Xcode CLT)", status: "ok", detail: path };
+            }
+        }
+        catch {
+            // xcode-select -p throws when CLT not installed
+        }
+        console.log(`  ${yellow("⨯")} Xcode CLT not found. Installing...`);
+        try {
+            run("xcode-select --install", { stdio: "inherit" });
+            return {
+                name: "Build tools (Xcode CLT)",
+                status: "installed",
+                detail: "Follow the prompt to complete installation",
+            };
+        }
+        catch {
+            return {
+                name: "Build tools (Xcode CLT)",
+                status: "failed",
+                detail: "Run manually: xcode-select --install",
+            };
+        }
+    }
+    if (!(cmdExists("gcc") || cmdExists("cc")) || !cmdExists("make")) {
+        console.log(`  ${yellow("⨯")} Build tools not found. Installing...`);
+        try {
+            if (cmdExists("apt-get")) {
+                run("sudo apt-get update -qq", { stdio: "inherit" });
+                run("sudo apt-get install -y -qq build-essential", {
+                    stdio: "inherit",
+                });
+                return { name: "Build tools (gcc/make)", status: "installed" };
+            }
+            return {
+                name: "Build tools (gcc/make)",
+                status: "failed",
+                detail: "Install build-essential or equivalent manually",
+            };
+        }
+        catch (e) {
+            return {
+                name: "Build tools",
+                status: "failed",
+                detail: `Install failed: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+    }
+    try {
+        const gccVersion = run("gcc --version | head -1");
+        return { name: "Build tools (gcc/make)", status: "ok", detail: gccVersion };
+    }
+    catch {
+        return { name: "Build tools", status: "ok" };
+    }
+}
+// ── Python (needed by node-gyp for native modules) ──────────────────────
+function checkPython() {
+    const pythonCmd = cmdExists("python3")
+        ? "python3"
+        : cmdExists("python")
+            ? "python"
+            : null;
+    if (pythonCmd) {
+        try {
+            const version = run(`${pythonCmd} --version`);
+            return { name: "Python (for node-gyp)", status: "ok", detail: version };
+        }
+        catch {
+            // python exists but --version failed, skip
+        }
+    }
+    console.log(`  ${yellow("⨯")} Python not found. Installing...`);
+    try {
+        if (IS_MAC && cmdExists("brew")) {
+            run("brew install python3", { stdio: "inherit" });
+        }
+        else if (IS_LINUX && cmdExists("apt-get")) {
+            run("sudo apt-get install -y -qq python3", { stdio: "inherit" });
+        }
+        else {
+            return {
+                name: "Python (for node-gyp)",
+                status: "failed",
+                detail: "Install Python 3 manually",
+            };
+        }
+        return { name: "Python (for node-gyp)", status: "installed" };
+    }
+    catch (e) {
+        return {
+            name: "Python (for node-gyp)",
+            status: "failed",
+            detail: `Install failed: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+// ── Ollama ──────────────────────────────────────────────────────────────
+function checkOllama() {
+    if (!cmdExists("ollama")) {
+        return {
+            name: "Ollama",
+            status: "failed",
+            detail: "Install Ollama manually from https://ollama.com/download and re-run `indexer-cli setup`.",
+        };
+    }
+    try {
+        const version = run("ollama --version");
+        return { name: "Ollama", status: "ok", detail: version };
+    }
+    catch {
+        return { name: "Ollama", status: "ok", detail: "installed" };
+    }
+}
+function ensureOllamaRunning() {
+    if (!cmdExists("ollama")) {
+        return createSkippedResult("Ollama daemon", "Skipped until Ollama is installed manually.");
+    }
+    try {
+        const result = run("ollama ps");
+        void result;
+        return { name: "Ollama daemon", status: "ok", detail: "running" };
+    }
+    catch {
+        // ollama ps throws when daemon not running
+    }
+    console.log(`  Starting Ollama daemon...`);
+    try {
+        run("ollama serve > /dev/null 2>&1 &");
+        let attempts = 0;
+        while (attempts < 30) {
+            try {
+                run("ollama ps");
+                return {
+                    name: "Ollama daemon",
+                    status: "installed",
+                    detail: "started",
+                };
+            }
+            catch {
+                attempts++;
+                (0, node_child_process_1.execSync)("sleep 1", { stdio: "pipe" });
+            }
+        }
+        return {
+            name: "Ollama daemon",
+            status: "failed",
+            detail: "Timed out waiting for Ollama to start. Run `ollama serve` manually.",
+        };
+    }
+    catch (e) {
+        return {
+            name: "Ollama daemon",
+            status: "failed",
+            detail: `Failed to start: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+// ── jina-8k model ───────────────────────────────────────────────────────
+const BASE_MODEL = "unclemusclez/jina-embeddings-v2-base-code:q5";
+const CUSTOM_MODEL = "jina-8k";
+function checkJinaModel() {
+    if (!cmdExists("ollama")) {
+        return createSkippedResult(`Model ${CUSTOM_MODEL}`, "Skipped until Ollama is installed manually.");
+    }
+    try {
+        const models = run("ollama list");
+        if (models.includes(CUSTOM_MODEL)) {
+            return { name: `Model ${CUSTOM_MODEL}`, status: "ok", detail: "pulled" };
+        }
+    }
+    catch {
+        // ollama list failed or model not present
+    }
+    console.log(`  Pulling base model ${BASE_MODEL} (≈119MB)...`);
+    try {
+        run(`ollama pull ${BASE_MODEL}`, { stdio: "inherit" });
+    }
+    catch (e) {
+        return {
+            name: `Model ${CUSTOM_MODEL}`,
+            status: "failed",
+            detail: `Pull failed: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+    console.log(`  Creating ${CUSTOM_MODEL} with num_ctx 8192...`);
+    try {
+        const tmpdir = run("mktemp -d");
+        const modelfile = `${tmpdir}/Modelfile.jina-8k`;
+        const content = `FROM ${BASE_MODEL}\nPARAMETER num_ctx 8192\n`;
+        (0, node_child_process_1.execSync)(`cat > ${modelfile} << 'MODELEOF'\n${content}MODELEOF`, {
+            stdio: "pipe",
+            shell: "/bin/bash",
+        });
+        run(`ollama create ${CUSTOM_MODEL} -f ${modelfile}`, { stdio: "inherit" });
+        (0, node_child_process_1.execSync)(`rm -rf ${tmpdir}`, { stdio: "pipe" });
+        return { name: `Model ${CUSTOM_MODEL}`, status: "installed" };
+    }
+    catch (e) {
+        return {
+            name: `Model ${CUSTOM_MODEL}`,
+            status: "failed",
+            detail: `Create failed: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+function collectOllamaResults(deps) {
+    const ollamaResult = deps.checkOllama();
+    if (ollamaResult.status === "failed") {
+        return [
+            ollamaResult,
+            createSkippedResult("Ollama daemon", "Skipped until Ollama is installed manually."),
+            createSkippedResult(`Model ${CUSTOM_MODEL}`, "Skipped until Ollama is installed manually."),
+        ];
+    }
+    const daemonResult = deps.ensureOllamaRunning();
+    if (daemonResult.status === "failed") {
+        return [
+            ollamaResult,
+            daemonResult,
+            createSkippedResult(`Model ${CUSTOM_MODEL}`, "Skipped until the Ollama daemon is running."),
+        ];
+    }
+    return [ollamaResult, daemonResult, deps.checkJinaModel()];
+}
+// ── Summary ─────────────────────────────────────────────────────────────
+function printSummary() {
+    console.log("");
+    console.log(bold("  Setup Summary"));
+    console.log("  ─────────────────────────────────────────");
+    let allOk = true;
+    for (const r of results) {
+        const icon = r.status === "ok"
+            ? green("✓")
+            : r.status === "installed"
+                ? green("✓")
+                : r.status === "skipped"
+                    ? yellow("○")
+                    : red("✗");
+        const suffix = r.detail ? `  (${r.detail})` : "";
+        const label = r.status === "installed" ? `${r.name}  — installed` : r.name;
+        console.log(`  ${icon} ${label}${suffix}`);
+        if (r.status === "failed")
+            allOk = false;
+    }
+    console.log("");
+    if (!allOk) {
+        console.log(red("  Some dependencies failed. Resolve the issues above and re-run `indexer-cli setup`."));
+        process.exitCode = 1;
+    }
+    else {
+        console.log(green("  All dependencies ready. Run `indexer-cli init` in your project to start."));
+    }
+}
+// ── Main ────────────────────────────────────────────────────────────────
+function registerSetupCommand(program) {
+    program
+        .command("setup")
+        .description("Check system prerequisites and prepare Ollama for indexer-cli")
+        .action(() => {
+        console.log(bold("\n  indexer-cli dependency setup\n"));
+        console.log(`  Platform: ${node_os_1.default.type()} ${node_os_1.default.release()} (${node_os_1.default.arch()})\n`);
+        console.log(bold("  Checking system prerequisites..."));
+        results.push(checkNode());
+        results.push(checkGit());
+        results.push(checkBuildTools());
+        results.push(checkPython());
+        console.log(bold("\n  Checking Ollama & embedding model..."));
+        results.push(...collectOllamaResults({
+            checkOllama,
+            ensureOllamaRunning,
+            checkJinaModel,
+        }));
+        printSummary();
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/commands/setup.js.map

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

package/dist/cli/commands/skill-template.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SKILL.md template for Claude Code integration.
+ *
+ * Written to `.claude/skills/repo-discovery/SKILL.md` during `indexer-cli init`.
+ */
+export declare const SKILL_MD = "---\nname: repo-discovery\ndescription: Mandatory for repository discovery. Before grep/glob/find, first use indexer-cli whenever the task involves finding implementations, tracing behavior, locating symbols, identifying entry points, inspecting module structure, or understanding an unfamiliar area of this repo.\nallowed-tools: Bash(indexer-cli:*)\n---\n\n# Repository discovery with indexer-cli\n\nUse this skill for discovery tasks inside this repository.\n\n## Required behavior\n\nAlways start with indexer-cli for repository discovery.\nDo not use grep, glob, or find until indexer-cli was insufficient, or you need an exact literal text match after narrowing the area.\n\n## Load this skill when\n\n- You need to find where something is implemented\n- You need to trace a symbol, handler, feature, or behavior\n- You are entering an unfamiliar module or directory\n- You need structure, entry points, or dependency context\n- The task is exploratory and you do not yet know the right file\n\n## Skip this skill when\n\n- The exact file is already known and the task stays inside it\n- You only need an exact literal text match\n- The task is outside this repository\n\n## First command\n\nRun one of these first:\n\n```bash\nindexer-cli search \"<query>\" --json\nindexer-cli search \"<query>\" --json --path-prefix src/<area>\nindexer-cli search \"<query>\" --json --chunk-types impl,types\nindexer-cli structure --json --path-prefix src/<area>\nindexer-cli structure --json --kind class\nindexer-cli architecture --json\nindexer-cli index --status --json\n```\n\n## Reading search results\n\n`indexer-cli search --json` returns ranked code chunks, not whole files.\nEach result includes `filePath`, `startLine`, `endLine`, `score`, `primarySymbol`, and `content`.\n\n- Use `score` to prefer the most relevant chunks first and filter obvious low-relevance noise.\n- Use `primarySymbol` to see which function/class/type the chunk belongs to before opening the file.\n- Treat `content` as supporting context, but rank and filter with `score` + `primarySymbol` instead of raw text alone.\n\n## Reference\n\n### Chunk types (--chunk-types)\n\n`full_file`, `imports`, `preamble`, `declaration`, `module_section`, `impl`, `types`\n\n### Symbol kinds (--kind)\n\n`function`, `class`, `method`, `interface`, `type`, `variable`, `module`, `signal`\n";

package/dist/cli/commands/skill-template.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_MD = void 0;
+/**
+ * SKILL.md template for Claude Code integration.
+ *
+ * Written to `.claude/skills/repo-discovery/SKILL.md` during `indexer-cli init`.
+ */
+exports.SKILL_MD = `\
+---
+name: repo-discovery
+description: Mandatory for repository discovery. Before grep/glob/find, first use indexer-cli whenever the task involves finding implementations, tracing behavior, locating symbols, identifying entry points, inspecting module structure, or understanding an unfamiliar area of this repo.
+allowed-tools: Bash(indexer-cli:*)
+---
+
+# Repository discovery with indexer-cli
+
+Use this skill for discovery tasks inside this repository.
+
+## Required behavior
+
+Always start with indexer-cli for repository discovery.
+Do not use grep, glob, or find until indexer-cli was insufficient, or you need an exact literal text match after narrowing the area.
+
+## Load this skill when
+
+- You need to find where something is implemented
+- You need to trace a symbol, handler, feature, or behavior
+- You are entering an unfamiliar module or directory
+- You need structure, entry points, or dependency context
+- The task is exploratory and you do not yet know the right file
+
+## Skip this skill when
+
+- The exact file is already known and the task stays inside it
+- You only need an exact literal text match
+- The task is outside this repository
+
+## First command
+
+Run one of these first:
+
+\`\`\`bash
+indexer-cli search "<query>" --json
+indexer-cli search "<query>" --json --path-prefix src/<area>
+indexer-cli search "<query>" --json --chunk-types impl,types
+indexer-cli structure --json --path-prefix src/<area>
+indexer-cli structure --json --kind class
+indexer-cli architecture --json
+indexer-cli index --status --json
+\`\`\`
+
+## Reading search results
+
+\`indexer-cli search --json\` returns ranked code chunks, not whole files.
+Each result includes \`filePath\`, \`startLine\`, \`endLine\`, \`score\`, \`primarySymbol\`, and \`content\`.
+
+- Use \`score\` to prefer the most relevant chunks first and filter obvious low-relevance noise.
+- Use \`primarySymbol\` to see which function/class/type the chunk belongs to before opening the file.
+- Treat \`content\` as supporting context, but rank and filter with \`score\` + \`primarySymbol\` instead of raw text alone.
+
+## Reference
+
+### Chunk types (--chunk-types)
+
+\`full_file\`, \`imports\`, \`preamble\`, \`declaration\`, \`module_section\`, \`impl\`, \`types\`
+
+### Symbol kinds (--kind)
+
+\`function\`, \`class\`, \`method\`, \`interface\`, \`type\`, \`variable\`, \`module\`, \`signal\`
+`;
+//# sourceMappingURL=skill-template.js.map

package/dist/cli/commands/skill-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-template.js","sourceRoot":"","sources":["../../../src/cli/commands/skill-template.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8DvB,CAAC"}

package/dist/cli/commands/structure.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerStructureCommand(program: Command): void;