kly 0.0.1

package/dist/index.d.mts

@@ -0,0 +1,307 @@
+import { Api, Model } from "@mariozechner/pi-ai";
+
+//#region src/types.d.ts
+type Language = "typescript" | "javascript" | "swift";
+type SymbolKind = "class" | "function" | "method" | "interface" | "type" | "enum" | "variable" | "protocol" | "struct";
+interface SymbolInfo {
+  name: string;
+  kind: SymbolKind;
+  description: string;
+}
+interface FileIndex {
+  path: string;
+  name: string;
+  description: string;
+  language: Language;
+  imports: string[];
+  exports: string[];
+  symbols: SymbolInfo[];
+  summary: string;
+  hash: string;
+  indexedAt: number;
+}
+interface KlyConfig {
+  llm: {
+    provider: string;
+    model: string;
+    apiKey: string;
+  };
+  include: string[];
+  exclude: string[];
+}
+interface ParseResult {
+  imports: string[];
+  exports: string[];
+  symbols: SymbolInfo[];
+}
+interface BranchState {
+  lastCommit: string;
+  lastBuilt: number;
+  forkedFrom?: string;
+}
+interface GitState {
+  version: number;
+  configHash: string;
+  branches: Record<string, BranchState>;
+}
+interface GitCommit {
+  hash: string;
+  author: string;
+  email: string;
+  date: number;
+  message: string;
+}
+interface ErrorFrame {
+  file: string;
+  line: number;
+  column?: number;
+  function?: string;
+}
+interface EnrichedFrame {
+  file: string;
+  line: number;
+  column?: number;
+  function?: string;
+  fileDescription: string;
+  fileSummary: string;
+  symbols: SymbolInfo[];
+  language: Language;
+  importedBy: string[];
+  importsFrom: string[];
+  lastModified: GitCommit | null;
+  recentCommits: GitCommit[];
+}
+interface EnrichedErrorStack {
+  frames: EnrichedFrame[];
+  affectedFiles: number;
+}
+interface GitDiff {
+  added: string[];
+  modified: string[];
+  deleted: string[];
+  renamed: Array<{
+    from: string;
+    to: string;
+  }>;
+}
+//#endregion
+//#region src/config.d.ts
+declare function getKlyDir(root: string): string;
+declare function getConfigPath(root: string): string;
+declare function getDbDir(root: string): string;
+declare function getDbPath(root: string, dbName: string): string;
+declare function getStatePath(root: string): string;
+declare function isInitialized(root: string): boolean;
+declare function initKlyDir(root: string, config?: KlyConfig): void;
+declare function loadConfig(root: string): KlyConfig;
+declare function hashConfig(config: KlyConfig): string;
+//#endregion
+//#region src/database.d.ts
+interface SearchResult {
+  file: FileIndex;
+  score: number;
+}
+declare class IndexDatabase {
+  private db;
+  constructor(dbPath: string);
+  private init;
+  getFile(filePath: string): FileIndex | undefined;
+  upsertFile(fileIndex: FileIndex): void;
+  upsertFiles(fileIndexes: FileIndex[]): void;
+  removeFile(filePath: string): void;
+  removeFiles(paths: string[]): void;
+  searchFiles(query: string, limit?: number): SearchResult[];
+  getAllFiles(): FileIndex[];
+  getFileCount(): number;
+  getLanguageStats(): Record<string, number>;
+  getMetadata(key: string): string | undefined;
+  setMetadata(key: string, value: string): void;
+  upsertDependencies(fromPath: string, toPaths: string[]): void;
+  upsertBatchDependencies(entries: Array<{
+    fromPath: string;
+    toPaths: string[];
+  }>): void;
+  removeDependencies(fromPath: string): void;
+  removeDependenciesBatch(fromPaths: string[]): void;
+  getDependencies(filePath: string): string[];
+  getDependents(filePath: string): string[];
+  removeAllDependencies(): void;
+  close(): void;
+  private updateFtsSymbolsText;
+}
+//#endregion
+//#region src/scanner.d.ts
+declare function scanFiles(root: string, config: KlyConfig): Promise<string[]>;
+//#endregion
+//#region src/hasher.d.ts
+declare function hashFile(root: string, filePath: string): string;
+declare function hasChanged(oldHash: string, newHash: string): boolean;
+//#endregion
+//#region src/git.d.ts
+declare function isGitRepo(root: string): boolean;
+declare function getCurrentBranch(root: string): string | null;
+declare function getCurrentCommit(root: string): string;
+declare function getChangedFiles(root: string, from: string, to?: string): GitDiff;
+declare function isAncestor(root: string, ancestor: string, descendant: string): boolean;
+declare function getMergeBase(root: string, a: string, b: string): string | null;
+declare function getFileHistory(root: string, filePath: string, limit?: number): GitCommit[];
+declare function branchToDbName(branch: string | null, commitHash?: string): string;
+//#endregion
+//#region src/store.d.ts
+declare function openDatabase(root: string, dbName?: string): IndexDatabase;
+declare function resolveDbName(root: string): string;
+declare function copyDatabase(root: string, fromName: string, toName: string): void;
+declare function loadState(root: string): GitState;
+declare function saveState(root: string, state: GitState): void;
+declare function getBranchState(state: GitState, dbName: string): BranchState | undefined;
+declare function setBranchState(state: GitState, dbName: string, branchState: BranchState): void;
+declare function getFileFromDb(root: string, filePath: string): FileIndex | undefined;
+declare function getAllFilesFromDb(root: string): FileIndex[];
+declare function listBranchDbs(root: string): string[];
+declare function removeBranchDb(root: string, dbName: string): void;
+//#endregion
+//#region src/diff-filter.d.ts
+interface FilteredDiff {
+  toIndex: string[];
+  toDelete: string[];
+  renamed: Array<{
+    from: string;
+    to: string;
+  }>;
+}
+declare function filterGitDiff(diff: GitDiff, config: KlyConfig): FilteredDiff;
+//#endregion
+//#region src/parser/base.d.ts
+declare abstract class BaseParser {
+  abstract readonly extensions: string[];
+  abstract parse(content: string, filePath: string): ParseResult;
+  supports(filePath: string): boolean;
+}
+//#endregion
+//#region src/parser/index.d.ts
+declare class ParserManager {
+  private parsers;
+  constructor();
+  getParser(filePath: string): BaseParser | undefined;
+  parse(content: string, filePath: string): ParseResult | null;
+  getLanguage(filePath: string): Language | undefined;
+}
+//#endregion
+//#region src/llm/index.d.ts
+interface LLMIndexResult {
+  name: string;
+  description: string;
+  summary: string;
+  symbols: {
+    name: string;
+    description: string;
+  }[];
+}
+declare class LLMService {
+  private model;
+  private batcher;
+  constructor(config: KlyConfig);
+  private getEnvKeyName;
+  indexFile(filePath: string, content: string, symbols: SymbolInfo[]): Promise<LLMIndexResult>;
+  indexFiles(files: {
+    path: string;
+    content: string;
+    symbols: SymbolInfo[];
+  }[]): Promise<Map<string, LLMIndexResult>>;
+  private parseResponse;
+}
+//#endregion
+//#region src/indexer.d.ts
+interface IndexProgress {
+  total: number;
+  completed: number;
+  current: string;
+  skipped: number;
+}
+type ProgressCallback = (progress: IndexProgress) => void;
+interface IndexOptions {
+  incremental?: boolean;
+  full?: boolean;
+  quiet?: boolean;
+  onProgress?: ProgressCallback;
+}
+interface BuildResult {
+  totalFiles: number;
+  newFiles: number;
+  updatedFiles: number;
+  deletedFiles: number;
+  unchangedFiles: number;
+  branch: string;
+  commit: string;
+  durationMs: number;
+}
+declare function buildIndex(root: string, options?: IndexOptions): Promise<BuildResult>;
+//#endregion
+//#region src/query.d.ts
+declare function searchFiles(db: IndexDatabase, query: string, limit?: number): SearchResult[];
+declare function searchFilesWithRerank(db: IndexDatabase, model: Model<Api>, query: string, topK?: number): Promise<SearchResult[]>;
+declare function filterByLanguage(db: IndexDatabase, language: string): FileIndex[];
+declare function filterByPath(db: IndexDatabase, pathPattern: string): FileIndex[];
+//#endregion
+//#region src/llm/reranker.d.ts
+/**
+ * Rerank search results using LLM.
+ * Takes FTS5 candidates and returns them reordered by semantic relevance.
+ */
+declare function rerankResults(model: Model<Api>, query: string, candidates: SearchResult[], topK?: number): Promise<SearchResult[]>;
+//#endregion
+//#region src/graph.d.ts
+type GraphFormat = "json" | "mermaid" | "ascii" | "svg";
+interface GraphNode {
+  path: string;
+  name: string;
+  language: Language;
+}
+interface GraphEdge {
+  from: string;
+  to: string;
+}
+interface DependencyGraph {
+  nodes: Map<string, GraphNode>;
+  edges: GraphEdge[];
+}
+declare function isRelativeImport(importPath: string): boolean;
+/**
+ * Resolve a relative import path to a file path that exists in the index.
+ */
+declare function resolveImport(fromFile: string, importPath: string, indexedPaths: Set<string>): string | undefined;
+/**
+ * Build a dependency graph from indexed files.
+ */
+declare function buildDependencyGraph(db: IndexDatabase, options?: {
+  focus?: string;
+  depth?: number;
+}): DependencyGraph;
+/**
+ * Generate Mermaid syntax from a dependency graph.
+ */
+declare function generateMermaid(graph: DependencyGraph): string;
+/**
+ * Render a Mermaid diagram string to ASCII/Unicode art.
+ */
+declare function renderGraphAscii(mermaid: string): string;
+/**
+ * Render a Mermaid diagram string to SVG.
+ */
+declare function renderGraphSvg(mermaid: string): string;
+//#endregion
+//#region src/enrich.d.ts
+/**
+ * Enrich error stack frames with file descriptions, dependencies, and git history.
+ *
+ * For each frame, looks up the file in the kly index and augments it with:
+ * - File description, summary, symbols, language (from index)
+ * - importedBy / importsFrom (from dependencies table)
+ * - Recent git commits (from git log)
+ *
+ * Frames whose files are not in the index are included with empty/default values.
+ */
+declare function enrichErrorStack(db: IndexDatabase, root: string, frames: ErrorFrame[]): EnrichedErrorStack;
+//#endregion
+export { type BranchState, type BuildResult, type DependencyGraph, type EnrichedErrorStack, type EnrichedFrame, type ErrorFrame, type FileIndex, type FilteredDiff, type GitCommit, type GitDiff, type GitState, type GraphEdge, type GraphFormat, type GraphNode, IndexDatabase, type IndexOptions, type IndexProgress, type KlyConfig, LLMService, type Language, type ParseResult, ParserManager, type ProgressCallback, type SearchResult, type SymbolInfo, type SymbolKind, branchToDbName, buildDependencyGraph, buildIndex, copyDatabase, enrichErrorStack, filterByLanguage, filterByPath, filterGitDiff, generateMermaid, getAllFilesFromDb, getBranchState, getChangedFiles, getConfigPath, getCurrentBranch, getCurrentCommit, getDbDir, getDbPath, getFileFromDb, getFileHistory, getKlyDir, getMergeBase, getStatePath, hasChanged, hashConfig, hashFile, initKlyDir, isAncestor, isGitRepo, isInitialized, isRelativeImport, listBranchDbs, loadConfig, loadState, openDatabase, removeBranchDb, renderGraphAscii, renderGraphSvg, rerankResults, resolveDbName, resolveImport, saveState, scanFiles, searchFiles, searchFilesWithRerank, setBranchState };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { A as getCurrentBranch, B as getConfigPath, C as openDatabase, D as setBranchState, E as saveState, F as isGitRepo, G as hashConfig, H as getDbPath, I as hasChanged, J as loadConfig, K as initKlyDir, L as hashFile, M as getFileHistory, N as getMergeBase, O as branchToDbName, P as isAncestor, R as scanFiles, S as loadState, T as resolveDbName, U as getKlyDir, V as getDbDir, W as getStatePath, _ as copyDatabase, a as searchFilesWithRerank, b as getFileFromDb, c as buildDependencyGraph, d as renderGraphAscii, f as renderGraphSvg, g as filterGitDiff, h as ParserManager, i as searchFiles, j as getCurrentCommit, k as getChangedFiles, l as generateMermaid, m as LLMService, n as filterByLanguage, o as rerankResults, p as resolveImport, q as isInitialized, r as filterByPath, s as buildIndex, t as enrichErrorStack, u as isRelativeImport, v as getAllFilesFromDb, w as removeBranchDb, x as listBranchDbs, y as getBranchState, z as IndexDatabase } from "./enrich-BHaZ2daX.mjs";
+export { IndexDatabase, LLMService, ParserManager, branchToDbName, buildDependencyGraph, buildIndex, copyDatabase, enrichErrorStack, filterByLanguage, filterByPath, filterGitDiff, generateMermaid, getAllFilesFromDb, getBranchState, getChangedFiles, getConfigPath, getCurrentBranch, getCurrentCommit, getDbDir, getDbPath, getFileFromDb, getFileHistory, getKlyDir, getMergeBase, getStatePath, hasChanged, hashConfig, hashFile, initKlyDir, isAncestor, isGitRepo, isInitialized, isRelativeImport, listBranchDbs, loadConfig, loadState, openDatabase, removeBranchDb, renderGraphAscii, renderGraphSvg, rerankResults, resolveDbName, resolveImport, saveState, scanFiles, searchFiles, searchFilesWithRerank, setBranchState };

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "kly",
+  "version": "0.0.1",
+  "description": "Code repository file-level indexing tool for AI agents",
+  "homepage": "https://github.com/xinyao27/kly#readme",
+  "bugs": {
+    "url": "https://github.com/xinyao27/kly/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "xinyao",
+    "email": "hi@xinyao.me"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xinyao27/kly.git"
+  },
+  "funding": "https://github.com/sponsors/xinyao27",
+  "bin": {
+    "kly": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./cli": "./dist/cli.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vp pack --watch",
+    "build": "vp pack",
+    "check": "vp check --fix",
+    "lint": "vp lint --fix",
+    "fmt": "vp fmt",
+    "test": "vp test",
+    "test:coverage": "vp test --coverage",
+    "prepublishOnly": "npm run build",
+    "up": "taze major -Ir",
+    "prepare": "vp config",
+    "postinstall": "node-gyp rebuild --directory=node_modules/tree-sitter || true",
+    "release": "bumpp"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@mariozechner/pi-ai": "^0.63.2",
+    "beautiful-mermaid": "^1.1.3",
+    "better-sqlite3": "^12.8.0",
+    "commander": "^14.0.3",
+    "globby": "^16.2.0",
+    "p-limit": "^7.3.0",
+    "tree-sitter": "^0.25.0",
+    "tree-sitter-swift": "^0.7.1",
+    "tree-sitter-typescript": "^0.23.2",
+    "yaml": "^2.8.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.5.0",
+    "@types/picomatch": "^4.0.2",
+    "@typescript/native-preview": "7.0.0-dev.20260317.1",
+    "bumpp": "^11.0.1",
+    "taze": "^19.10.0",
+    "typescript": "~6.0.2",
+    "vite": "npm:@voidzero-dev/vite-plus-core@latest",
+    "vite-plus": "latest"
+  },
+  "packageManager": "pnpm@10.33.0",
+  "pnpm": {
+    "overrides": {
+      "vite": "npm:@voidzero-dev/vite-plus-core@latest",
+      "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
+    }
+  },
+  "inlinedDependencies": {
+    "picomatch": "2.3.1"
+  }
+}