codestrate 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Coding Intelligence MCP — Type Definitions
+ *
+ * Best-effort indexing warning: symbol parsing uses regex/heuristic methods.
+ * May be inaccurate with overloads, nested classes, multiline signatures,
+ * generics, or dynamic imports.
+ */
+export interface RepoSnapshot {
+    path: string;
+    commitSha: string;
+    repoFingerprint: string;
+    branch: string;
+    files: RepoFile[];
+    buildSystem: string | null;
+    frameworks: string[];
+    entryPoints: string[];
+    commands: RepoCommands;
+}
+export interface RepoFile {
+    path: string;
+    language: string;
+    size: number;
+    lastModified: string;
+}
+export interface RepoCommands {
+    build: string | null;
+    test: string | null;
+    lint: string | null;
+}
+export type SymbolKind = "class" | "interface" | "function" | "method" | "variable" | "type" | "enum" | "module" | "component" | "unknown";
+export interface SymbolInfo {
+    name: string;
+    kind: SymbolKind;
+    file: string;
+    line: number;
+    column: number;
+    signature: string;
+    summary: string;
+    imports: string[];
+    calls: string[];
+    calledBy: string[];
+    relatedTests: string[];
+    commitSha: string;
+    repoFingerprint: string;
+}
+export interface SymbolRelation {
+    source: string;
+    target: string;
+    kind: "calls" | "extends" | "implements" | "imports" | "composes";
+}
+export interface GraphNode {
+    id: number;
+    symbolId?: number;
+    file: string;
+    name: string;
+    kind: string;
+    signature: string;
+    line?: number;
+    column?: number;
+}
+export interface GraphEdge {
+    id: number;
+    sourceNodeId: number;
+    targetNodeId: number;
+    kind: string;
+    line?: number;
+    column?: number;
+}
+export type MatchType = "text" | "symbol" | "filename";
+export interface SearchResult {
+    file: string;
+    line: number;
+    column: number;
+    context: string;
+    symbol: string | null;
+    score: number;
+    matchType: MatchType;
+}
+export type MemoryType = "semantic" | "episodic" | "procedural" | "negative";
+export interface ExperienceEvidence {
+    /** commit SHA — required */
+    commitSha: string;
+    /** files changed in the fix — required */
+    changedFiles: string[];
+    /** validation command that was run — required */
+    validationCommand: string;
+    /** hash of repo state — required */
+    repoFingerprint: string;
+    buildPassed?: boolean;
+    testsPassed?: boolean;
+    humanAccepted?: boolean;
+    commitCreated?: boolean;
+}
+export interface Experience {
+    id: string;
+    task: string;
+    diagnosis: string;
+    solution: string;
+    changedFiles: string[];
+    commit: string;
+    validation: ValidationResult[];
+    failedAttempts: string[];
+    evidence?: ExperienceEvidence;
+    quality: number;
+    timestamp: string;
+    repo: string;
+    type: "episodic";
+}
+export interface Memory {
+    id: string;
+    type: MemoryType;
+    content: string;
+    symbols: string[];
+    files: string[];
+    commit: string | null;
+    quality: number;
+    timestamp: string;
+    repo: string;
+    source: "manual" | "auto" | "derived";
+}
+export type ValidationTarget = "build" | "test" | "lint";
+export interface ValidationResult {
+    type: ValidationTarget;
+    passed: boolean;
+    command: string;
+    output: string;
+    errors: string[];
+    duration: number;
+    exitCode: number | null;
+}
+export interface ValidationConfig {
+    commands: Partial<Record<ValidationTarget, string>>;
+    timeout: number;
+    maxOutput: number;
+}
+export type ContextItemType = "repo_map" | "symbol" | "file" | "history" | "memory" | "rule";
+export interface ContextItem {
+    type: ContextItemType;
+    label: string;
+    content: string;
+    tokens: number;
+    relevance: number;
+}
+export interface ContextBundle {
+    task: string;
+    summary: string;
+    items: ContextItem[];
+    totalTokens: number;
+    hasMore: boolean;
+}
+export interface CIConfig {
+    repoPath: string;
+    storePath: string;
+    maxResponseChars: number;
+    validation: ValidationConfig;
+    embeddingMode: "none" | "subprocess" | "api";
+    embeddingApi?: {
+        url: string;
+        model: string;
+        apiKey: string;
+    };
+}
+export interface PaginationMeta {
+    total: number;
+    count: number;
+    offset: number;
+    hasMore: boolean;
+    nextOffset?: number;
+}
+export interface ToolResponse<T> {
+    data: T;
+    meta?: PaginationMeta;
+    truncated?: boolean;
+    truncationMessage?: string;
+}
+/**
+ * Wrap data for MCP `structuredContent` field.
+ * MCP SDK expects `structuredContent` to be `Record<string, unknown>`.
+ * Wrapping in a `{ data }` literal makes it type-safe without casts.
+ */
+export declare function asStructured<T>(data: T): Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,17 @@
+/**
+ * Coding Intelligence MCP — Type Definitions
+ *
+ * Best-effort indexing warning: symbol parsing uses regex/heuristic methods.
+ * May be inaccurate with overloads, nested classes, multiline signatures,
+ * generics, or dynamic imports.
+ */
+// ─── MCP structuredContent helper ───────────────────────
+/**
+ * Wrap data for MCP `structuredContent` field.
+ * MCP SDK expects `structuredContent` to be `Record<string, unknown>`.
+ * Wrapping in a `{ data }` literal makes it type-safe without casts.
+ */
+export function asStructured(data) {
+    return { data };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmOH,2DAA2D;AAC3D;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAI,IAAO;IACrC,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "codestrate",
+  "version": "0.1.0",
+  "description": "Code understanding via tree-sitter AST parsing, graph-based symbol navigation, and MCP integration for coding agents.",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "grammars"
+  ],
+  "bin": {
+    "codestrate": "dist/index.js",
+    "ci-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "npm run build && npx tsx tests/tree-sitter.test.ts && npx tsx tests/sqlite-graph.test.ts && npx tsx tests/smoke.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "better-sqlite3": "^12.11.1",
+    "web-tree-sitter": "^0.26.10",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "keywords": [
+    "mcp",
+    "coding-agent",
+    "code-intelligence",
+    "codestrate",
+    "claude-code",
+    "ast-parser",
+    "code-graph"
+  ],
+  "license": "MIT"
+}