@wrongstack/tools 0.306.4 → 0.307.0

package/dist/codebase-index/repo-map.d.ts

@@ -0,0 +1,20 @@
+import { type SkeletonOptions } from './skeleton-extractor.js';
+export interface RepoMapOptions {
+    projectRoot: string;
+    maxTokens?: number | undefined;
+    focusFiles?: string[] | undefined;
+    options?: SkeletonOptions | undefined;
+}
+export interface RepoMapResult {
+    map: string;
+    filesCount: number;
+    totalFilesScanned: number;
+    estimatedTokens: number;
+    rankedFiles: string[];
+}
+/**
+ * Generate a reference-weighted, token-budgeted Repository Map.
+ * Packs the most architecturally central symbols across the codebase into ~800-1500 tokens.
+ */
+export declare function generateRepoMap(opts: RepoMapOptions): Promise<RepoMapResult>;
+//# sourceMappingURL=repo-map.d.ts.map

package/dist/codebase-index/skeleton-extractor.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Skeleton Extractor — High-speed AST-based file outline and body reduction.
+ *
+ * Strips function, method, and class implementations while preserving
+ * signatures, type definitions, imports, and docstrings. Achieves 70–90%
+ * token reduction for LLM context injection and repository understanding.
+ */
+import type { SymbolLang } from './schema.js';
+export interface SkeletonSymbolRange {
+    name?: string | undefined;
+    kind?: string | undefined;
+    startLine: number;
+    endLine: number;
+    bodyStartLine?: number | undefined;
+    bodyEndLine?: number | undefined;
+}
+export interface SkeletonOptions {
+    /** Keep JSDoc / docstring comments. Defaults to true. */
+    includeDocs?: boolean | undefined;
+    /** Collapse multi-line import blocks into a single summary line. Defaults to false. */
+    collapseImports?: boolean | undefined;
+    /** Keep only exported / public declarations. Defaults to false. */
+    exportsOnly?: boolean | undefined;
+    /** Include original start-end line numbers in stripped block comments (e.g. L32-L45). Defaults to true. */
+    includeLineNumbers?: boolean | undefined;
+    /** Maximum recursion depth for nested scopes. */
+    maxDepth?: number | undefined;
+}
+export interface FileSkeletonResult {
+    file: string;
+    lang: SymbolLang;
+    skeleton: string;
+    symbols?: SkeletonSymbolRange[] | undefined;
+    stats: {
+        originalLines: number;
+        skeletonLines: number;
+        tokenSavingsPercent: number;
+        symbolCount: number;
+    };
+}
+/**
+ * Extract an AST-based skeleton from a file's content.
+ */
+export declare function extractFileSkeleton(opts: {
+    file: string;
+    content: string;
+    lang?: SymbolLang;
+    options?: SkeletonOptions;
+}): Promise<FileSkeletonResult>;
+/**
+ * Extract skeletons for all indexable files under a directory.
+ */
+export declare function extractDirectorySkeleton(opts: {
+    dirPath: string;
+    maxFiles?: number;
+    options?: SkeletonOptions;
+}): Promise<{
+    files: FileSkeletonResult[];
+    combinedSkeleton: string;
+    totalOriginalLines: number;
+    totalSkeletonLines: number;
+    overallSavingsPercent: number;
+}>;
+//# sourceMappingURL=skeleton-extractor.d.ts.map

package/dist/codebase-index/tree-sitter-parser.d.ts

@@ -55,4 +55,15 @@ export declare function __smokeRootType(opts: {
     content: string;
     lang: SymbolLang;
 }): Promise<string>;
+/**
+ * Parse source code using Tree-Sitter and return the AST and parser.
+ * Caller MUST call `tree.delete()` and `parser.delete()` in a finally block.
+ */
+export declare function parseTreeSitterAst(opts: {
+    content: string;
+    lang: SymbolLang;
+}): Promise<{
+    tree: import('web-tree-sitter').Tree;
+    parser: import('web-tree-sitter').Parser;
+} | null>;
 //# sourceMappingURL=tree-sitter-parser.d.ts.map