indexer-cli 0.2.1

package/README.md

@@ -0,0 +1,156 @@
+# indexer-cli
+
+Project indexer that installs a repo-discovery skill for coding agents and helps them spend fewer tokens finding the right code.
+
+## Overview
+
+The main feature of `indexer-cli` is not just search on its own: it turns your repository into something coding agents
+can navigate efficiently. Running `indexer-cli init` installs a project-local `repo-discovery` skill that nudges Claude,
+OpenCode, and similar tools to use indexed repository discovery first instead of wasting tokens on blind `grep`,
+`find`, and repeated file reads.
+
+Under the hood, `indexer-cli` indexes source code, generates vector embeddings through a local Ollama instance, and
+stores everything in a per-project `.indexer-cli/` directory. That gives both humans and agents fast natural-language
+search, repo structure snapshots, and low-friction incremental reindexing without any daemon or background service.
+
+## Features
+
+- **Code-agent repo skill**: `init` installs a project-local `repo-discovery` skill for Claude and OpenCode workflows
+- **Token savings for agents**: Pushes agents toward indexed discovery instead of expensive blind search and repeated context loading
+- **Multi-language support**: TypeScript/JavaScript, Python, C#, GDScript, Ruby
+- **Semantic code search**: Natural language queries over your entire codebase
+- **Incremental indexing**: Uses `git diff` to re-index only changed files, bulk-copies unchanged vectors
+- **Local-first**: All data stored in `.indexer-cli/` inside the project (SQLite + LanceDB)
+- **Ollama-powered embeddings**: Uses `jina-8k` model (768-dim vectors) via a local Ollama instance
+- **Architecture snapshot**: Generates dependency graphs, entry points, and file stats
+- **Symbol extraction**: Functions, classes, interfaces, and imports are all indexed
+- **Adaptive chunking**: Smart code splitting at function, module, or single-file granularity
+
+## Prerequisites
+
+- [Ollama](https://ollama.ai) installed manually. `indexer-cli setup` will verify it, start the daemon if needed, and prepare the `jina-8k` model.
+
+## Installation
+
+```bash
+npm install -g indexer-cli
+```
+
+Requires Node.js 18+ and build tools (python3, make, C++ compiler) for native dependencies.
+
+After installing, run `indexer-cli setup` once to verify local prerequisites and prepare the `jina-8k` model. `setup` does not auto-install Ollama; install Ollama yourself from https://ollama.com/download first.
+
+### Uninstall
+
+```bash
+npm uninstall -g indexer-cli
+```
+
+## Quick Start
+
+```bash
+# 1. Initialize indexing and install the repo-discovery skill
+cd /path/to/your/project
+indexer-cli init
+
+# 2. Index the codebase
+indexer-cli index
+
+# 3. Search semantically yourself
+indexer-cli search "authentication middleware"
+```
+
+After `init`, the repo also contains `.claude/skills/repo-discovery/SKILL.md`, so coding agents can be steered toward
+`indexer-cli search`, `indexer-cli structure`, and `indexer-cli architecture` before they start burning tokens on broad
+filesystem scans.
+
+## Why agents save tokens with this
+
+Without a repo-local skill, agents often spend tokens on repetitive repository discovery: broad `grep`, repeated file
+reads, and trial-and-error navigation. With `indexer-cli`, the skill tells them to start from indexed search and
+structured repo views instead.
+
+In practice, that means:
+
+- less irrelevant context pulled into the prompt
+- fewer repeated search passes over the same files
+- faster navigation to the right symbol, module, or entry point
+- better reuse of a local repo index instead of raw token-heavy exploration
+
+## Agent Integration
+
+When you run `indexer-cli init`, the CLI creates a project-local repo-discovery skill at
+`.claude/skills/repo-discovery/SKILL.md` and adds `.claude/` to `.gitignore`.
+
+That skill tells coding agents to start repository discovery with commands like:
+
+```bash
+indexer-cli search "<query>" --json
+indexer-cli structure --json --path-prefix src/<area>
+indexer-cli architecture --json
+indexer-cli index --status --json
+```
+
+This is especially useful in Claude and OpenCode setups, where project-local skills can guide the agent away from
+blind `grep`/`find` usage and toward indexed search first, which usually means less wasted context and lower token
+usage during repo discovery.
+
+## CLI Commands
+
+### `indexer-cli setup`
+
+Check system prerequisites and prepare the Ollama embedding model. `setup` can install some system tools where appropriate, but Ollama itself must be installed manually first. Works on macOS and Linux.
+
+### `indexer-cli init`
+
+Create the `.indexer-cli/` directory, initialize the SQLite database and LanceDB vector store, and add `.indexer-cli/`
+to `.gitignore` in the current working directory. Also writes the project-local repo-discovery skill to
+`.claude/skills/repo-discovery/SKILL.md` and adds `.claude/` to `.gitignore`.
+
+### `indexer-cli index`
+
+Index all supported source files in the current working directory.
+
+| Option      | Description                                            |
+|-------------|--------------------------------------------------------|
+| `--full`    | Force a full reindex instead of incremental            |
+| `--dry-run` | Preview what would be indexed without writing anything |
+| `--status`  | Show indexing status for the current project           |
+| `--tree`    | Show indexed file tree (use with `--status`)           |
+| `--json`    | Output status as JSON (use with `--status`)            |
+
+### `indexer-cli search <query>`
+
+Run a semantic search against the indexed codebase. Automatically re-indexes changed files if needed.
+
+| Option                   | Default | Description                                                                                                  |
+|--------------------------|---------|--------------------------------------------------------------------------------------------------------------|
+| `--top-k <number>`       | 10      | Number of results to return                                                                                  |
+| `--path-prefix <string>` | —       | Limit results to files under this path                                                                       |
+| `--chunk-types <string>` | —       | Comma-separated filter: `full_file`, `imports`, `preamble`, `declaration`, `module_section`, `impl`, `types` |
+| `--json`                 | —       | Output results as JSON                                                                                       |
+
+### `indexer-cli structure`
+
+Print a file tree annotated with extracted symbols for the current working directory. Automatically re-indexes changed
+files if needed.
+
+| Option                   | Description                                                                                               |
+|--------------------------|-----------------------------------------------------------------------------------------------------------|
+| `--path-prefix <string>` | Limit output to files under this path                                                                     |
+| `--kind <string>`        | Filter by symbol kind: `function`, `class`, `method`, `interface`, `type`, `variable`, `module`, `signal` |
+| `--json`                 | Output structure as JSON                                                                                  |
+
+### `indexer-cli architecture`
+
+Print an architecture snapshot for the current working directory: file statistics, detected entry points, and a
+dependency graph.
+
+### `indexer-cli uninstall`
+
+Remove the `.indexer-cli/` directory from the current working directory. Also removes the generated
+`.claude/skills/repo-discovery/` skill directory when present, then prompts for confirmation before deleting.
+
+## License
+
+MIT

package/bin/indexer-cli.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+const { spawnSync } = require("node:child_process");
+const { existsSync } = require("node:fs");
+const { dirname, resolve } = require("node:path");
+
+function resolveTsxCliPath({ existsSyncFn = existsSync } = {}) {
+	const fallbackPath = resolve(
+		__dirname,
+		"..",
+		"node_modules",
+		"tsx",
+		"dist",
+		"cli.mjs",
+	);
+	if (existsSyncFn(fallbackPath)) {
+		return fallbackPath;
+	}
+
+	try {
+		const tsxPackageJson = require.resolve("tsx/package.json", {
+			paths: [resolve(__dirname, "..")],
+		});
+		const tsxCliPath = resolve(dirname(tsxPackageJson), "dist", "cli.mjs");
+		if (existsSyncFn(tsxCliPath)) {
+			return tsxCliPath;
+		}
+	} catch {
+		return null;
+	}
+
+	return null;
+}
+
+function buildLaunchSpec({
+	argv = process.argv.slice(2),
+	existsSyncFn = existsSync,
+} = {}) {
+	const distEntry = resolve(__dirname, "..", "dist", "cli", "entry.js");
+	if (existsSyncFn(distEntry)) {
+		return { command: process.execPath, args: [distEntry, ...argv] };
+	}
+
+	const tsxCliPath = resolveTsxCliPath({ existsSyncFn });
+	if (tsxCliPath) {
+		const srcEntry = resolve(__dirname, "..", "src", "cli", "entry.ts");
+		return { command: process.execPath, args: [tsxCliPath, srcEntry, ...argv] };
+	}
+
+	throw new Error(
+		"Unable to start indexer-cli: neither dist/cli/entry.js nor a local tsx runtime was found. Run `npm ci` and `npm run build` in the repository before invoking the CLI.",
+	);
+}
+
+function main() {
+	try {
+		require("better-sqlite3");
+	} catch {
+		console.error(
+			[
+				"",
+				"\u26A0 indexer-cli: native modules could not be loaded.",
+				"  This usually means build tools (python3, make, C++ compiler) are missing.",
+				"",
+				"  Install build tools, then run:",
+				"    npm install -g indexer-cli",
+				"",
+			].join("\n"),
+		);
+		process.exit(1);
+	}
+
+	const { command, args } = buildLaunchSpec();
+	const result = spawnSync(command, args, {
+		stdio: "inherit",
+		env: process.env,
+	});
+
+	if (result.error) {
+		throw result.error;
+	}
+
+	if (result.status !== null) {
+		process.exit(result.status);
+	}
+
+	process.exit(1);
+}
+
+module.exports = {
+	buildLaunchSpec,
+	main,
+	resolveTsxCliPath,
+};
+
+if (require.main === module) {
+	main();
+}

package/dist/_temp_test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/_temp_test.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// temp
+//# sourceMappingURL=_temp_test.js.map

package/dist/_temp_test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_temp_test.js","sourceRoot":"","sources":["../src/_temp_test.ts"],"names":[],"mappings":";;AAAA,OAAO"}

package/dist/chunking/adaptive.d.ts

@@ -0,0 +1,15 @@
+export interface AdaptiveChunk {
+    content: string;
+    startLine: number;
+    endLine: number;
+    type?: string;
+    primarySymbol?: string;
+}
+export interface AdaptiveChunkContext {
+    filePath: string;
+    content: string;
+    language: string;
+}
+export declare class AdaptiveChunker {
+    chunk(context: AdaptiveChunkContext): AdaptiveChunk[];
+}

package/dist/chunking/adaptive.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdaptiveChunker = void 0;
+class AdaptiveChunker {
+    chunk(context) {
+        const lines = context.content.split(/\r?\n/);
+        if (lines.length === 0 || context.content.trim().length === 0) {
+            return [];
+        }
+        if (lines.length <= 220) {
+            return [
+                {
+                    content: context.content.trim(),
+                    startLine: 1,
+                    endLine: lines.length,
+                    type: 'full_file',
+                },
+            ];
+        }
+        const chunks = [];
+        const chunkSize = context.language === 'typescript' ? 180 : 220;
+        const overlap = 20;
+        for (let start = 0; start < lines.length; start += chunkSize - overlap) {
+            const endExclusive = Math.min(lines.length, start + chunkSize);
+            const content = lines.slice(start, endExclusive).join('\n').trim();
+            if (!content) {
+                continue;
+            }
+            chunks.push({
+                content,
+                startLine: start + 1,
+                endLine: endExclusive,
+                type: chunks.length === 0 ? 'module_section' : 'impl',
+            });
+            if (endExclusive >= lines.length) {
+                break;
+            }
+        }
+        return chunks;
+    }
+}
+exports.AdaptiveChunker = AdaptiveChunker;
+//# sourceMappingURL=adaptive.js.map

package/dist/chunking/adaptive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive.js","sourceRoot":"","sources":["../../src/chunking/adaptive.ts"],"names":[],"mappings":";;;AAcA,MAAa,eAAe;IAC1B,KAAK,CAAC,OAA6B;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACxB,OAAO;gBACL;oBACE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;oBAC/B,SAAS,EAAE,CAAC;oBACZ,OAAO,EAAE,KAAK,CAAC,MAAM;oBACrB,IAAI,EAAE,WAAW;iBAClB;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAChE,MAAM,OAAO,GAAG,EAAE,CAAC;QAEnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;YACvE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;YAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACnE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YAED,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO;gBACP,SAAS,EAAE,KAAK,GAAG,CAAC;gBACpB,OAAO,EAAE,YAAY;gBACrB,IAAI,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM;aACtD,CAAC,CAAC;YAEH,IAAI,YAAY,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA3CD,0CA2CC"}

package/dist/chunking/function.d.ts

@@ -0,0 +1,6 @@
+import type { Chunk, ChunkingContext, ChunkingStrategy } from './types.js';
+export declare class FunctionLevelChunker implements ChunkingStrategy {
+    chunk(context: ChunkingContext): Chunk[];
+    private isTopLevelDeclaration;
+    private extractSymbol;
+}

package/dist/chunking/function.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FunctionLevelChunker = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+class FunctionLevelChunker {
+    chunk(context) {
+        const { filePath, content } = context;
+        const sourceFile = typescript_1.default.createSourceFile(filePath, content, typescript_1.default.ScriptTarget.Latest, true);
+        const chunks = [];
+        let importsEndPos = 0;
+        let preambleEndPos = 0;
+        for (const statement of sourceFile.statements) {
+            if (typescript_1.default.isImportDeclaration(statement) || typescript_1.default.isImportEqualsDeclaration(statement)) {
+                importsEndPos = statement.getEnd();
+                preambleEndPos = statement.getEnd();
+                continue;
+            }
+            if (typescript_1.default.isTypeAliasDeclaration(statement) || typescript_1.default.isInterfaceDeclaration(statement)) {
+                preambleEndPos = statement.getEnd();
+                continue;
+            }
+            break;
+        }
+        if (importsEndPos > 0) {
+            const importsContent = content.slice(0, importsEndPos);
+            const endLine = sourceFile.getLineAndCharacterOfPosition(importsEndPos).line + 1;
+            chunks.push({
+                content: importsContent,
+                startLine: 0,
+                endLine,
+                type: 'imports',
+                symbols: [],
+            });
+        }
+        if (preambleEndPos > importsEndPos) {
+            const preambleStartPos = importsEndPos;
+            const preambleContent = content.slice(preambleStartPos, preambleEndPos);
+            const startLine = sourceFile.getLineAndCharacterOfPosition(preambleStartPos).line;
+            const endLine = sourceFile.getLineAndCharacterOfPosition(preambleEndPos).line + 1;
+            chunks.push({
+                content: preambleContent,
+                startLine,
+                endLine,
+                type: 'preamble',
+                symbols: [],
+            });
+        }
+        sourceFile.forEachChild((node) => {
+            if (node.getEnd() <= preambleEndPos)
+                return;
+            if (this.isTopLevelDeclaration(node)) {
+                const start = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+                const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
+                const symbol = this.extractSymbol(node);
+                chunks.push({
+                    content: node.getText(),
+                    startLine: start.line,
+                    endLine: end.line + 1,
+                    type: 'declaration',
+                    primarySymbol: symbol?.name,
+                    symbols: symbol ? [symbol.name] : [],
+                });
+            }
+        });
+        return chunks;
+    }
+    isTopLevelDeclaration(node) {
+        return (typescript_1.default.isFunctionDeclaration(node) ||
+            typescript_1.default.isClassDeclaration(node) ||
+            typescript_1.default.isVariableStatement(node) ||
+            typescript_1.default.isModuleDeclaration(node));
+    }
+    extractSymbol(node) {
+        if (typescript_1.default.isFunctionDeclaration(node) && node.name) {
+            return { name: node.name.getText(), kind: 'function' };
+        }
+        if (typescript_1.default.isClassDeclaration(node) && node.name) {
+            return { name: node.name.getText(), kind: 'class' };
+        }
+        if (typescript_1.default.isVariableStatement(node)) {
+            const declaration = node.declarationList.declarations[0];
+            if (declaration && typescript_1.default.isIdentifier(declaration.name)) {
+                return { name: declaration.name.getText(), kind: 'variable' };
+            }
+        }
+        if (typescript_1.default.isModuleDeclaration(node) && node.name) {
+            return { name: node.name.getText(), kind: 'module' };
+        }
+        return null;
+    }
+}
+exports.FunctionLevelChunker = FunctionLevelChunker;
+//# sourceMappingURL=function.js.map

package/dist/chunking/function.js.map

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

package/dist/chunking/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './single.js';
+export * from './function.js';
+export * from './module.js';
+export * from './adaptive.js';

package/dist/chunking/index.js

@@ -0,0 +1,22 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./single.js"), exports);
+__exportStar(require("./function.js"), exports);
+__exportStar(require("./module.js"), exports);
+__exportStar(require("./adaptive.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/chunking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chunking/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,8CAA4B;AAC5B,gDAA8B"}

package/dist/chunking/module.d.ts

@@ -0,0 +1,6 @@
+import type { Chunk, ChunkingContext, ChunkingStrategy } from './types.js';
+export declare class ModuleLevelChunker implements ChunkingStrategy {
+    private readonly MAX_CHUNK_LINES;
+    private readonly OVERLAP_LINES;
+    chunk(context: ChunkingContext): Chunk[];
+}

package/dist/chunking/module.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleLevelChunker = void 0;
+class ModuleLevelChunker {
+    MAX_CHUNK_LINES = 200;
+    OVERLAP_LINES = 20;
+    chunk(context) {
+        const lines = context.content.split('\n');
+        const chunks = [];
+        let currentLine = 0;
+        while (currentLine < lines.length) {
+            const endLine = Math.min(currentLine + this.MAX_CHUNK_LINES, lines.length);
+            const chunkLines = lines.slice(currentLine, endLine);
+            let content = chunkLines.join('\n');
+            if (currentLine > 0) {
+                content = `// ...\n${content}`;
+            }
+            chunks.push({
+                content,
+                startLine: currentLine,
+                endLine,
+                type: 'module_section',
+                symbols: [],
+            });
+            if (endLine >= lines.length)
+                break;
+            currentLine = endLine - this.OVERLAP_LINES;
+        }
+        return chunks;
+    }
+}
+exports.ModuleLevelChunker = ModuleLevelChunker;
+//# sourceMappingURL=module.js.map

package/dist/chunking/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/chunking/module.ts"],"names":[],"mappings":";;;AAEA,MAAa,kBAAkB;IACZ,eAAe,GAAG,GAAG,CAAC;IACtB,aAAa,GAAG,EAAE,CAAC;IAEpC,KAAK,CAAC,OAAwB;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,OAAO,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3E,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAErD,IAAI,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEpC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,GAAG,WAAW,OAAO,EAAE,CAAC;YACjC,CAAC;YAED,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO;gBACP,SAAS,EAAE,WAAW;gBACtB,OAAO;gBACP,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM;gBAAE,MAAM;YAEnC,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC;QAC7C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAlCD,gDAkCC"}

package/dist/chunking/single.d.ts

@@ -0,0 +1,4 @@
+import type { Chunk, ChunkingContext, ChunkingStrategy } from './types.js';
+export declare class SingleFileChunker implements ChunkingStrategy {
+    chunk(context: ChunkingContext): Chunk[];
+}

package/dist/chunking/single.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SingleFileChunker = void 0;
+class SingleFileChunker {
+    chunk(context) {
+        const lines = context.content.split('\n');
+        return [
+            {
+                content: context.content,
+                startLine: 0,
+                endLine: lines.length,
+                type: 'full_file',
+                symbols: [],
+            },
+        ];
+    }
+}
+exports.SingleFileChunker = SingleFileChunker;
+//# sourceMappingURL=single.js.map

package/dist/chunking/single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single.js","sourceRoot":"","sources":["../../src/chunking/single.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAC5B,KAAK,CAAC,OAAwB;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO;YACL;gBACE,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,KAAK,CAAC,MAAM;gBACrB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,EAAE;aACZ;SACF,CAAC;IACJ,CAAC;CACF;AAbD,8CAaC"}

package/dist/chunking/types.d.ts

@@ -0,0 +1,17 @@
+export type ChunkType = 'full_file' | 'imports' | 'preamble' | 'declaration' | 'module_section' | 'impl' | 'types';
+export interface Chunk {
+    content: string;
+    startLine: number;
+    endLine: number;
+    type: ChunkType;
+    primarySymbol?: string;
+    symbols?: string[];
+}
+export interface ChunkingContext {
+    filePath: string;
+    content: string;
+    language: string;
+}
+export interface ChunkingStrategy {
+    chunk(context: ChunkingContext): Chunk[];
+}

package/dist/chunking/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/chunking/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/chunking/types.ts"],"names":[],"mappings":""}

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

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