@bugsbunnycodes1998/cartographer-core 0.1.0

package/dist/types/analysis.d.ts

@@ -0,0 +1,51 @@
+export type SupportedLanguage = "typescript" | "javascript" | "python" | "rust" | "go" | "java";
+export interface FileEntry {
+    relativePath: string;
+    absolutePath: string;
+    language: SupportedLanguage | null;
+    sizeBytes: number;
+}
+export interface ImportStatement {
+    source: string;
+    resolvedPath: string | null;
+    names: string[];
+    isTypeOnly: boolean;
+}
+export interface ExportStatement {
+    name: string;
+    kind: "function" | "class" | "variable" | "type" | "interface" | "re-export" | "default";
+    isTypeOnly: boolean;
+}
+export interface FunctionCallSite {
+    calleeName: string;
+    line: number;
+}
+export interface FunctionDeclaration {
+    name: string;
+    startLine: number;
+    endLine: number;
+    params: string[];
+    returnType: string | null;
+    isExported: boolean;
+    isAsync: boolean;
+    body: string;
+    complexity: number;
+    calls: FunctionCallSite[];
+}
+export interface FileAnalysis {
+    filePath: string;
+    language?: SupportedLanguage;
+    content: string;
+    loc: number;
+    imports: ImportStatement[];
+    exports: ExportStatement[];
+    functions: FunctionDeclaration[];
+}
+export interface ModuleInfo {
+    id: string;
+    name: string;
+    rootDir: string;
+    files: string[];
+    detectionMethod: "barrel" | "top-level-dir" | "python-package" | "cargo-workspace" | "go-module" | "java-package";
+}
+//# sourceMappingURL=analysis.d.ts.map

package/dist/types/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/types/analysis.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;AAEhG,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IACzF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,QAAQ,GAAG,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,WAAW,GAAG,cAAc,CAAC;CACnH"}

package/dist/types/analysis.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analysis.js.map

package/dist/types/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/types/analysis.ts"],"names":[],"mappings":""}

package/dist/types/config.d.ts

@@ -0,0 +1,19 @@
+export interface ProgressEvent {
+    stage: "ingestion" | "parsing" | "modules" | "dependencies" | "graph" | "layout" | "export" | "git" | "health" | "llm" | "call_graph" | "expeditions";
+    message: string;
+    current?: number;
+    total?: number;
+}
+export interface AnalyzeOptions {
+    rootDir: string;
+    scopeDir?: string;
+    languages?: string[];
+    outputDir?: string;
+    skipGit?: boolean;
+    skipLlm?: boolean;
+    quick?: boolean;
+    openaiApiKey?: string;
+    llmConcurrency?: number;
+    onProgress?: (event: ProgressEvent) => void;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,YAAY,GAAG,aAAa,CAAC;IACtJ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/edges.d.ts

@@ -0,0 +1,8 @@
+export type EdgeKind = "imports" | "calls" | "extends" | "implements" | "data_flow";
+export interface GraphEdge {
+    sourceId: string;
+    targetId: string;
+    kind: EdgeKind;
+    weight: number;
+}
+//# sourceMappingURL=edges.d.ts.map

package/dist/types/edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.d.ts","sourceRoot":"","sources":["../../src/types/edges.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;AAEpF,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/edges.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=edges.js.map

package/dist/types/edges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.js","sourceRoot":"","sources":["../../src/types/edges.ts"],"names":[],"mappings":""}

package/dist/types/expeditions.d.ts

@@ -0,0 +1,19 @@
+export type ExpeditionKind = "grand_tour" | "request_flow" | "danger_zones" | "knowledge_silos" | "custom";
+export interface ExpeditionStep {
+    nodeId: string;
+    zoomLevel: 0 | 1 | 2 | 3;
+    narration: string;
+    highlightEdges: string[];
+    highlightNodes: string[];
+    duration: number;
+    action?: "enter_building" | "highlight_function" | "show_diff";
+}
+export interface Expedition {
+    id: string;
+    title: string;
+    description: string;
+    kind: ExpeditionKind;
+    estimatedMinutes: number;
+    steps: ExpeditionStep[];
+}
+//# sourceMappingURL=expeditions.d.ts.map

package/dist/types/expeditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expeditions.d.ts","sourceRoot":"","sources":["../../src/types/expeditions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAE3G,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,WAAW,CAAC;CAChE;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}

package/dist/types/expeditions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=expeditions.js.map

package/dist/types/expeditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expeditions.js","sourceRoot":"","sources":["../../src/types/expeditions.ts"],"names":[],"mappings":""}

package/dist/types/graph.d.ts

@@ -0,0 +1,29 @@
+import type { GraphNode } from "./nodes.js";
+import type { GraphEdge } from "./edges.js";
+import type { Expedition } from "./expeditions.js";
+export interface GraphMeta {
+    repo: string;
+    analyzedAt: string;
+    languages: string[];
+    totalFiles: number;
+    totalModules: number;
+    architectureStyle: string;
+    systemSummary: string;
+}
+export interface EvolutionSnapshot {
+    commitHash: string;
+    timestamp: string;
+    author: string;
+    nodesAdded: string[];
+    nodesRemoved: string[];
+    nodesModified: string[];
+    summary: string;
+}
+export interface CartographerGraph {
+    meta: GraphMeta;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    expeditions: Expedition[];
+    evolution: EvolutionSnapshot[];
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/types/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/types/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC"}

package/dist/types/graph.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph.js.map

package/dist/types/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/types/graph.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { NodeKind, ArchitecturalLayer, Position3D, Dimensions3D, GraphNode } from "./nodes.js";
+export type { EdgeKind, GraphEdge } from "./edges.js";
+export type { GraphMeta, EvolutionSnapshot, CartographerGraph } from "./graph.js";
+export type { ProgressEvent, AnalyzeOptions } from "./config.js";
+export type { SupportedLanguage, FileEntry, ImportStatement, ExportStatement, FunctionCallSite, FunctionDeclaration, FileAnalysis, ModuleInfo, } from "./analysis.js";
+export type { ExpeditionKind, ExpeditionStep, Expedition } from "./expeditions.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACpG,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/nodes.d.ts

@@ -0,0 +1,35 @@
+export type NodeKind = "module" | "file" | "function" | "class" | "type" | "interface";
+export type ArchitecturalLayer = "api" | "middleware" | "business_logic" | "data_access" | "utility" | "configuration" | "presentation" | "infrastructure" | "testing";
+export interface Position3D {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface Dimensions3D {
+    width: number;
+    height: number;
+    depth: number;
+}
+export interface GraphNode {
+    id: string;
+    kind: NodeKind;
+    name: string;
+    path: string | null;
+    parentId: string | null;
+    loc: number;
+    complexity: number;
+    healthScore: number;
+    createdAt: string | null;
+    lastModified: string | null;
+    totalCommits: number;
+    busFactor: number;
+    primaryOwner: string | null;
+    churnScore: number;
+    summary: string | null;
+    explanation: string | null;
+    layer: ArchitecturalLayer | null;
+    tags: string[];
+    position: Position3D;
+    dimensions: Dimensions3D;
+}
+//# sourceMappingURL=nodes.d.ts.map

package/dist/types/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/types/nodes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;AAEvF,MAAM,MAAM,kBAAkB,GAC1B,KAAK,GACL,YAAY,GACZ,gBAAgB,GAChB,aAAa,GACb,SAAS,GACT,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAGxB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAGpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IAGnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IAGf,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,YAAY,CAAC;CAC1B"}

package/dist/types/nodes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nodes.js.map

package/dist/types/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/types/nodes.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@bugsbunnycodes1998/cartographer-core",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist/"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-wasm.js",
+    "dev": "tsc -p tsconfig.json --watch"
+  },
+  "dependencies": {
+    "web-tree-sitter": "^0.24.7",
+    "better-sqlite3": "^11.8.1",
+    "ignore": "^7.0.3",
+    "consola": "^3.4.0",
+    "d3-hierarchy": "^3.1.2",
+    "d3-force": "^3.0.0",
+    "isomorphic-git": "^1.27.1",
+    "openai": "^4.70.0",
+    "p-limit": "^6.0.0"
+  },
+  "devDependencies": {
+    "tree-sitter-wasms": "^0.1.12",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/d3-hierarchy": "^3.1.7",
+    "@types/d3-force": "^3.0.10"
+  }
+}