claude-crap 0.1.2

package/dist/ast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ast/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/ast/index.js

@@ -0,0 +1,23 @@
+/**
+ * Public SDK entry point for the tree-sitter based AST engine and the
+ * cyclomatic complexity walker.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import {
+ *   TreeSitterEngine,
+ *   computeCyclomaticComplexity,
+ *   detectLanguageFromPath,
+ *   type FileMetrics,
+ *   type FunctionMetrics,
+ *   type SupportedLanguage,
+ * } from "claude-crap/ast";
+ * ```
+ *
+ * @module ast
+ */
+export { TreeSitterEngine } from "./tree-sitter-engine.js";
+export { computeCyclomaticComplexity } from "./cyclomatic.js";
+export { LANGUAGE_TABLE, detectLanguageFromPath } from "./language-config.js";
+//# sourceMappingURL=index.js.map

package/dist/ast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ast/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQ3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/ast/language-config.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Per-language tree-sitter node classification tables.
+ *
+ * Every language grammar exposes a different set of node type names. To
+ * keep the AST engine language-agnostic we encode, for each supported
+ * language, three sets:
+ *
+ *   - `functionNodeTypes`  — nodes that represent a function/method/lambda.
+ *                             These are the units we report metrics for.
+ *   - `branchingNodeTypes` — nodes that add one independent path through
+ *                             the function. Used to compute cyclomatic
+ *                             complexity by counting occurrences.
+ *   - `nameField`          — the tree-sitter field name that holds the
+ *                             function's identifier, used to extract the
+ *                             function name for reporting.
+ *
+ * We also define which WASM grammar file to load per language. The paths
+ * are resolved at runtime against the `tree-sitter-wasms` package, but
+ * can be overridden via the engine constructor if you want to ship your
+ * own grammars.
+ *
+ * @module ast/language-config
+ */
+/**
+ * Languages currently supported by the AST engine. This is the same
+ * `enum` that appears in the `analyze_file_ast` tool schema — keep them
+ * in sync when adding a new language.
+ */
+export type SupportedLanguage = "csharp" | "javascript" | "typescript" | "python" | "java";
+/**
+ * Per-language classification record. Immutable by convention.
+ */
+export interface LanguageConfig {
+    /** Canonical language identifier (stable across releases). */
+    readonly id: SupportedLanguage;
+    /** WASM grammar filename inside `tree-sitter-wasms/out/`. */
+    readonly wasmName: string;
+    /** File extensions that should map to this language. */
+    readonly extensions: ReadonlyArray<string>;
+    /** Tree-sitter node types that represent callable units. */
+    readonly functionNodeTypes: ReadonlySet<string>;
+    /** Tree-sitter node types that add +1 to cyclomatic complexity. */
+    readonly branchingNodeTypes: ReadonlySet<string>;
+    /**
+     * Boolean / short-circuit operator node types. These are counted only
+     * when the node is an `"&&"`, `"||"`, `"??"` (etc.) operator, so the
+     * walker inspects the operator text on top of the node type.
+     */
+    readonly booleanOperators: ReadonlyArray<string>;
+    /**
+     * Child-field names we try in order to extract the function name. The
+     * walker reads the first non-empty match.
+     */
+    readonly nameFieldCandidates: ReadonlyArray<string>;
+}
+/**
+ * Complete language table. Look up by {@link SupportedLanguage} identifier.
+ */
+export declare const LANGUAGE_TABLE: Readonly<Record<SupportedLanguage, LanguageConfig>>;
+/**
+ * Infer a {@link SupportedLanguage} from a file path by matching its
+ * extension. Returns `null` when no known language matches. Useful when
+ * the caller does not already know the language and wants the engine to
+ * pick one automatically.
+ *
+ * @param filePath File path (absolute or relative).
+ * @returns        The detected language or `null`.
+ */
+export declare function detectLanguageFromPath(filePath: string): SupportedLanguage | null;
+//# sourceMappingURL=language-config.d.ts.map

package/dist/ast/language-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-config.d.ts","sourceRoot":"","sources":["../../src/ast/language-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,4DAA4D;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACrD;AAkJD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAM9E,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAQjF"}

package/dist/ast/language-config.js

@@ -0,0 +1,192 @@
+/**
+ * Per-language tree-sitter node classification tables.
+ *
+ * Every language grammar exposes a different set of node type names. To
+ * keep the AST engine language-agnostic we encode, for each supported
+ * language, three sets:
+ *
+ *   - `functionNodeTypes`  — nodes that represent a function/method/lambda.
+ *                             These are the units we report metrics for.
+ *   - `branchingNodeTypes` — nodes that add one independent path through
+ *                             the function. Used to compute cyclomatic
+ *                             complexity by counting occurrences.
+ *   - `nameField`          — the tree-sitter field name that holds the
+ *                             function's identifier, used to extract the
+ *                             function name for reporting.
+ *
+ * We also define which WASM grammar file to load per language. The paths
+ * are resolved at runtime against the `tree-sitter-wasms` package, but
+ * can be overridden via the engine constructor if you want to ship your
+ * own grammars.
+ *
+ * @module ast/language-config
+ */
+// -----------------------------------------------------------------------------
+// C#
+// -----------------------------------------------------------------------------
+// Grammar: https://github.com/tree-sitter/tree-sitter-c-sharp
+const CSHARP = {
+    id: "csharp",
+    wasmName: "tree-sitter-c_sharp.wasm",
+    extensions: [".cs"],
+    functionNodeTypes: new Set([
+        "method_declaration",
+        "local_function_statement",
+        "lambda_expression",
+        "anonymous_method_expression",
+        "constructor_declaration",
+        "destructor_declaration",
+        "operator_declaration",
+        "conversion_operator_declaration",
+        "accessor_declaration",
+    ]),
+    branchingNodeTypes: new Set([
+        "if_statement",
+        "else_clause",
+        "while_statement",
+        "do_statement",
+        "for_statement",
+        "for_each_statement",
+        "case_switch_label",
+        "case_pattern_switch_label",
+        "switch_expression_arm",
+        "catch_clause",
+        "conditional_expression",
+        "conditional_access_expression",
+        "when_clause",
+    ]),
+    booleanOperators: ["&&", "||", "??"],
+    nameFieldCandidates: ["name"],
+};
+// -----------------------------------------------------------------------------
+// JavaScript
+// -----------------------------------------------------------------------------
+// Grammar: https://github.com/tree-sitter/tree-sitter-javascript
+const JAVASCRIPT = {
+    id: "javascript",
+    wasmName: "tree-sitter-javascript.wasm",
+    extensions: [".js", ".jsx", ".mjs", ".cjs"],
+    functionNodeTypes: new Set([
+        "function_declaration",
+        "function_expression",
+        "arrow_function",
+        "method_definition",
+        "generator_function",
+        "generator_function_declaration",
+    ]),
+    branchingNodeTypes: new Set([
+        "if_statement",
+        "else_clause",
+        "while_statement",
+        "do_statement",
+        "for_statement",
+        "for_in_statement",
+        "for_of_statement",
+        "switch_case",
+        "catch_clause",
+        "ternary_expression",
+    ]),
+    booleanOperators: ["&&", "||", "??"],
+    nameFieldCandidates: ["name"],
+};
+// -----------------------------------------------------------------------------
+// TypeScript
+// -----------------------------------------------------------------------------
+// Grammar: https://github.com/tree-sitter/tree-sitter-typescript
+// The TypeScript grammar inherits most node types from JavaScript, so we
+// extend the JS tables rather than re-declaring them from scratch.
+const TYPESCRIPT = {
+    id: "typescript",
+    wasmName: "tree-sitter-typescript.wasm",
+    extensions: [".ts", ".tsx", ".mts", ".cts"],
+    functionNodeTypes: new Set([
+        ...JAVASCRIPT.functionNodeTypes,
+        "function_signature",
+        "method_signature",
+        "abstract_method_signature",
+    ]),
+    branchingNodeTypes: new Set([...JAVASCRIPT.branchingNodeTypes]),
+    booleanOperators: [...JAVASCRIPT.booleanOperators],
+    nameFieldCandidates: ["name"],
+};
+// -----------------------------------------------------------------------------
+// Python
+// -----------------------------------------------------------------------------
+// Grammar: https://github.com/tree-sitter/tree-sitter-python
+const PYTHON = {
+    id: "python",
+    wasmName: "tree-sitter-python.wasm",
+    extensions: [".py", ".pyi"],
+    functionNodeTypes: new Set(["function_definition", "lambda"]),
+    branchingNodeTypes: new Set([
+        "if_statement",
+        "elif_clause",
+        "else_clause",
+        "while_statement",
+        "for_statement",
+        "try_statement",
+        "except_clause",
+        "conditional_expression",
+        "match_statement",
+        "case_clause",
+    ]),
+    booleanOperators: ["and", "or"],
+    nameFieldCandidates: ["name"],
+};
+// -----------------------------------------------------------------------------
+// Java
+// -----------------------------------------------------------------------------
+// Grammar: https://github.com/tree-sitter/tree-sitter-java
+const JAVA = {
+    id: "java",
+    wasmName: "tree-sitter-java.wasm",
+    extensions: [".java"],
+    functionNodeTypes: new Set([
+        "method_declaration",
+        "constructor_declaration",
+        "lambda_expression",
+    ]),
+    branchingNodeTypes: new Set([
+        "if_statement",
+        "while_statement",
+        "do_statement",
+        "for_statement",
+        "enhanced_for_statement",
+        "switch_label",
+        "switch_rule",
+        "catch_clause",
+        "ternary_expression",
+    ]),
+    booleanOperators: ["&&", "||"],
+    nameFieldCandidates: ["name"],
+};
+/**
+ * Complete language table. Look up by {@link SupportedLanguage} identifier.
+ */
+export const LANGUAGE_TABLE = {
+    csharp: CSHARP,
+    javascript: JAVASCRIPT,
+    typescript: TYPESCRIPT,
+    python: PYTHON,
+    java: JAVA,
+};
+/**
+ * Infer a {@link SupportedLanguage} from a file path by matching its
+ * extension. Returns `null` when no known language matches. Useful when
+ * the caller does not already know the language and wants the engine to
+ * pick one automatically.
+ *
+ * @param filePath File path (absolute or relative).
+ * @returns        The detected language or `null`.
+ */
+export function detectLanguageFromPath(filePath) {
+    const lower = filePath.toLowerCase();
+    for (const config of Object.values(LANGUAGE_TABLE)) {
+        for (const ext of config.extensions) {
+            if (lower.endsWith(ext))
+                return config.id;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=language-config.js.map

package/dist/ast/language-config.js.map

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

package/dist/ast/tree-sitter-engine.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Tree-sitter based AST analysis engine.
+ *
+ * This module wraps `web-tree-sitter` (the WASM build of tree-sitter) to
+ * parse source files and extract deterministic per-function metrics. The
+ * WASM variant is used instead of the native bindings so that `npm install`
+ * never has to invoke a C compiler — matching the plugin's "zero install
+ * friction" promise.
+ *
+ * The engine is lazy:
+ *
+ *   - `web-tree-sitter` is initialized only on first use.
+ *   - Grammar WASM files are loaded on demand and cached per language.
+ *
+ * This keeps MCP server startup fast (crucial because Claude Code will
+ * spin the server up and tear it down across sessions).
+ *
+ * Usage:
+ *
+ * ```ts
+ * const engine = new TreeSitterEngine();
+ * const result = await engine.analyzeFile({
+ *   filePath: "src/foo.ts",
+ *   language: "typescript",
+ * });
+ * console.log(result.functions);
+ * ```
+ *
+ * @module ast/tree-sitter-engine
+ */
+import { type SupportedLanguage } from "./language-config.js";
+/**
+ * Per-function metrics returned by the engine.
+ */
+export interface FunctionMetrics {
+    /** Human-readable function name, or `"<anonymous>"` when not available. */
+    readonly name: string;
+    /** 1-based line where the function body starts. */
+    readonly startLine: number;
+    /** 1-based line where the function body ends. */
+    readonly endLine: number;
+    /** McCabe cyclomatic complexity (always ≥ 1). */
+    readonly cyclomaticComplexity: number;
+    /** Physical lines of code covered by the function (endLine - startLine + 1). */
+    readonly lineCount: number;
+}
+/**
+ * File-level metrics returned by the engine.
+ */
+export interface FileMetrics {
+    /** File path that was analyzed, echoed from the request for traceability. */
+    readonly filePath: string;
+    /** Language the file was parsed as. */
+    readonly language: SupportedLanguage;
+    /** Total physical lines in the file, including blanks and comments. */
+    readonly physicalLoc: number;
+    /** Physical lines that contain at least one non-whitespace character. */
+    readonly logicalLoc: number;
+    /** Per-function metrics sorted by starting line. */
+    readonly functions: ReadonlyArray<FunctionMetrics>;
+}
+/**
+ * Request accepted by {@link TreeSitterEngine.analyzeFile}.
+ */
+export interface AnalyzeFileRequest {
+    readonly filePath: string;
+    readonly language: SupportedLanguage;
+}
+/**
+ * Options accepted by the engine constructor. All fields are optional and
+ * safe defaults are used when omitted.
+ */
+export interface TreeSitterEngineOptions {
+    /**
+     * Directory where the language grammar WASM files live (one per
+     * language, e.g. `tree-sitter-typescript.wasm`). Defaults to the
+     * `tree-sitter-wasms/out` directory inside `node_modules`.
+     */
+    readonly grammarsDir?: string;
+    /**
+     * Directory where the `web-tree-sitter` runtime WASM (`tree-sitter.wasm`)
+     * lives. This is a different package from the grammars — the runtime
+     * ships with `web-tree-sitter` itself. Defaults to that package's
+     * install directory inside `node_modules`.
+     */
+    readonly runtimeDir?: string;
+    /**
+     * Override the WASM loader for tests. Receives the grammar filename
+     * and must return the raw bytes.
+     */
+    readonly loadGrammar?: (wasmPath: string) => Promise<Uint8Array>;
+}
+/**
+ * High-level AST engine. Instances are meant to be long-lived — create
+ * one at server startup and reuse it for every analysis request.
+ */
+export declare class TreeSitterEngine {
+    private parserCtor;
+    private readonly loadedLanguages;
+    private readonly grammarsDir;
+    private readonly runtimeDir;
+    private readonly loadGrammar;
+    private initPromise;
+    constructor(options?: TreeSitterEngineOptions);
+    /**
+     * Analyze a source file and return per-function and file-level metrics.
+     *
+     * @param req The analysis request.
+     * @returns   A {@link FileMetrics} snapshot ready to be serialized.
+     * @throws    When the file cannot be read or the grammar cannot be loaded.
+     */
+    analyzeFile(req: AnalyzeFileRequest): Promise<FileMetrics>;
+    /**
+     * Ensure a parser with the requested language grammar bound is ready.
+     * Both the Parser class and the grammar are initialized lazily and
+     * cached on first use.
+     *
+     * @param config Language configuration for the requested grammar.
+     * @returns      A fresh parser instance configured for the language.
+     */
+    private ensureParserFor;
+    /**
+     * Import and initialize `web-tree-sitter`. Isolated in its own method
+     * so the dynamic import runs exactly once per engine instance.
+     *
+     * `web-tree-sitter` uses `export = Parser` so under ESM interop the
+     * Parser class arrives on the `default` property of the imported
+     * namespace. `Parser.init()` is a STATIC method on the class, not a
+     * top-level module function.
+     */
+    private initParserModule;
+}
+//# sourceMappingURL=tree-sitter-engine.d.ts.map

package/dist/ast/tree-sitter-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-sitter-engine.d.ts","sourceRoot":"","sources":["../../src/ast/tree-sitter-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH,OAAO,EAAuC,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA2BnG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;IACzE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4C;IACxE,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE,uBAA4B;IAMjD;;;;;;OAMG;IACG,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBhE;;;;;;;OAOG;YACW,eAAe;IAyB7B;;;;;;;;OAQG;YACW,gBAAgB;CAsB/B"}