code-survey 1.0.0

package/dist/mcp-server.d.ts

@@ -0,0 +1 @@
+export declare function runMcpServer(): void;

package/dist/package-parser.d.ts

@@ -0,0 +1,2 @@
+import type { PackageDependencies } from './types.ts';
+export declare function parsePackageDependencies(dir: string): PackageDependencies;

package/dist/parser.d.ts

@@ -0,0 +1,7 @@
+import type { LanguageParser, ParseResult, ParseOptions } from './types.ts';
+export declare class CodebaseParser {
+    private parsers;
+    initialize(fileExtensions?: Set<string> | string[]): Promise<void>;
+    getParserForFile(filePath: string): LanguageParser | null;
+    parseFile(filePath: string, code: string, options?: ParseOptions): ParseResult;
+}

package/dist/parsers/base.d.ts

@@ -0,0 +1,9 @@
+import Parser from 'web-tree-sitter';
+import type { LanguageParser, ParseResult, ParseOptions } from '../types.ts';
+export declare function ensureParserInit(): Promise<void>;
+export declare abstract class BaseTreeSitterParser implements LanguageParser {
+    protected parser: Parser;
+    protected lang: Parser.Language;
+    initialize(wasmPath: string): Promise<void>;
+    abstract parse(code: string, options?: ParseOptions): ParseResult;
+}

package/dist/parsers/csharp.d.ts

@@ -0,0 +1,5 @@
+import type { ParseResult, ParseOptions } from '../types.ts';
+import { BaseTreeSitterParser } from './base.ts';
+export declare class CSharpParser extends BaseTreeSitterParser {
+    parse(code: string, options?: ParseOptions): ParseResult;
+}

package/dist/parsers/go.d.ts

@@ -0,0 +1,5 @@
+import type { ParseResult, ParseOptions } from '../types.ts';
+import { BaseTreeSitterParser } from './base.ts';
+export declare class GoParser extends BaseTreeSitterParser {
+    parse(code: string, options?: ParseOptions): ParseResult;
+}

package/dist/parsers/java.d.ts

@@ -0,0 +1,5 @@
+import type { ParseResult, ParseOptions } from '../types.ts';
+import { BaseTreeSitterParser } from './base.ts';
+export declare class JavaParser extends BaseTreeSitterParser {
+    parse(code: string, options?: ParseOptions): ParseResult;
+}

package/dist/parsers/javascript.d.ts

@@ -0,0 +1,5 @@
+import type { ParseResult, ParseOptions } from '../types.ts';
+import { BaseTreeSitterParser } from './base.ts';
+export declare class JavaScriptParser extends BaseTreeSitterParser {
+    parse(code: string, options?: ParseOptions): ParseResult;
+}

package/dist/parsers/python.d.ts

@@ -0,0 +1,5 @@
+import type { ParseResult, ParseOptions } from '../types.ts';
+import { BaseTreeSitterParser } from './base.ts';
+export declare class PythonParser extends BaseTreeSitterParser {
+    parse(code: string, options?: ParseOptions): ParseResult;
+}

package/dist/parsers/rust.d.ts

@@ -0,0 +1,5 @@
+import type { ParseResult, ParseOptions } from '../types.ts';
+import { BaseTreeSitterParser } from './base.ts';
+export declare class RustParser extends BaseTreeSitterParser {
+    parse(code: string, options?: ParseOptions): ParseResult;
+}

package/dist/parsers/typescript.d.ts

@@ -0,0 +1,5 @@
+import type { ParseResult, ParseOptions } from '../types.ts';
+import { BaseTreeSitterParser } from './base.ts';
+export declare class TypeScriptParser extends BaseTreeSitterParser {
+    parse(code: string, options?: ParseOptions): ParseResult;
+}

package/dist/resolver.d.ts

@@ -0,0 +1,5 @@
+import type { FileEntry, NamespaceEntry, PackageDependencies } from './types.ts';
+export declare function resolveImports(files: Record<string, FileEntry>, namespaces: Record<string, NamespaceEntry>, packageDeps: PackageDependencies): {
+    externalImports: Record<string, string[]>;
+    internalLinks: Record<string, string[]>;
+};

package/dist/scanner.d.ts

@@ -0,0 +1,7 @@
+export interface ScannedFile {
+    relativePath: string;
+    absolutePath: string;
+    hash: string;
+}
+export declare function calculateHash(filePath: string): string;
+export declare function scanDirectory(rootDir: string, customExcludes?: string[], maxDepth?: number): ScannedFile[];

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+export interface ProjectMetadata {
+    name: string;
+    languages: string[];
+    root: string;
+}
+export interface PackageDependencies {
+    npm?: Record<string, string>;
+    nuget?: Record<string, string>;
+    go?: Record<string, string>;
+    maven?: Record<string, string>;
+    pip?: Record<string, string>;
+}
+export interface ImportEntry {
+    source: string;
+    symbols: string[];
+}
+export interface SymbolEntry {
+    name: string;
+    type: 'class' | 'interface' | 'struct' | 'method' | 'function' | 'variable' | 'type';
+    location: string;
+    doc?: string;
+    signature?: string;
+}
+export declare function formatLocation(start: number, end: number): string;
+export declare function formatDocstring(text: string): string;
+export interface FileEntry {
+    hash: string;
+    imports: ImportEntry[];
+    exports: SymbolEntry[];
+    symbols: SymbolEntry[];
+}
+export interface NamespaceEntry {
+    files: string[];
+    exports: string[];
+}
+export interface CodeSurveySchema {
+    version: string;
+    $schema?: string;
+    project: ProjectMetadata;
+    packageDependencies: PackageDependencies;
+    files: Record<string, FileEntry>;
+    namespaces: Record<string, NamespaceEntry>;
+    externalImports: Record<string, string[]>;
+    internalLinks: Record<string, string[]>;
+}
+export interface ParseOptions {
+    includeInternalVars?: boolean;
+    includeDocs?: boolean;
+    symbolsFilter?: string[];
+    includeSignatures?: boolean;
+}
+export interface ParseResult {
+    imports: ImportEntry[];
+    exports: SymbolEntry[];
+    symbols: SymbolEntry[];
+    namespace?: string;
+}
+export interface LanguageParser {
+    initialize(wasmPath: string): Promise<void>;
+    parse(code: string, options?: ParseOptions): ParseResult;
+}
+export interface CodeSurveyResult {
+    filesCount: number;
+    symbolsCount: {
+        class: number;
+        interface: number;
+        struct: number;
+        method: number;
+        function: number;
+        variable: number;
+        type: number;
+    };
+    data: CodeSurveySchema;
+}

package/dist/wasm/wasm-loader.d.ts

@@ -0,0 +1 @@
+export declare function getWasmPath(language: string): Promise<string>;

package/dist/writer.d.ts

@@ -0,0 +1,21 @@
+import type { CodeSurveySchema } from './types.ts';
+export declare function sortCodeSurveyData(data: CodeSurveySchema): CodeSurveySchema;
+export declare function generateDeterministicJson(data: CodeSurveySchema): string;
+export declare function generateDeterministicYaml(data: CodeSurveySchema): string;
+export declare function generateDeterministicMermaid(data: CodeSurveySchema): string;
+export declare function generateProjectMarkdown(data: CodeSurveySchema): string;
+export declare function generateDependenciesMarkdown(data: CodeSurveySchema): string;
+export declare function generateFilesMarkdown(data: CodeSurveySchema, options?: {
+    includeToc?: boolean;
+}): string;
+export declare function generateNamespacesMarkdown(data: CodeSurveySchema): string;
+export declare function generateLinksMarkdown(data: CodeSurveySchema): string;
+export declare function generateDeterministicMarkdown(data: CodeSurveySchema, options?: {
+    includeToc?: boolean;
+}): string;
+export declare function writeSurveyOutput(schemaObj: CodeSurveySchema, options: {
+    output?: string;
+    format?: 'json' | 'yaml' | 'markdown' | 'mermaid';
+    split?: boolean;
+    includeToc?: boolean;
+}): void;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "code-survey",
+  "version": "1.0.0",
+  "description": "Deterministic codebase surveying tool for coding agents",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "code-survey": "./dist/bin/code-survey.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "deno test --allow-read --allow-write --allow-sys --allow-env --allow-run --allow-net tests/",
+    "test:node": "node --experimental-strip-types --test tests/**/*.test.ts",
+    "build": "rm -rf dist && npx tsc --declaration --emitDeclarationOnly --outDir dist --noEmit false && mv dist/src/* dist/ && rm -rf dist/src dist/bin && bun build src/index.ts --outfile dist/index.js --target node --external web-tree-sitter --external tree-sitter-wasms --external yaml && bun build bin/code-survey.ts --outfile dist/bin/code-survey.js --target node --external web-tree-sitter --external tree-sitter-wasms --external yaml",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "code-survey",
+    "codemap",
+    "ast",
+    "parser",
+    "dependency-graph"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "tree-sitter-wasms": "^0.1.11",
+    "web-tree-sitter": "^0.22.4",
+    "yaml": "^2.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  }
+}