@kentwynn/kgraph 0.1.19 → 0.1.21

package/README.md

@@ -2,7 +2,7 @@
 
 Persistent repository intelligence for AI coding tools.
 
-KGraph gives Codex, GitHub Copilot, Cursor, and Claude Code a local knowledge layer for your repo: file maps, symbols, imports, relationships, and durable notes from previous AI sessions. The goal is simple: your assistant should not spend every session re-learning the same codebase.
+KGraph gives Codex, GitHub Copilot, Cursor, Claude Code, Gemini CLI, Windsurf, and Cline a local knowledge layer for your repo: file maps, symbols, imports, relationships, and durable notes from previous AI sessions. The goal is simple: your assistant should not spend every session re-learning the same codebase.
 
 ## The Workflow
 
@@ -10,7 +10,7 @@ Use KGraph in two steps:
 
 ```bash
 # Required once per repository
-kgraph init --integrations codex,copilot,cursor,claude-code
+kgraph init --integrations codex,copilot,cursor,claude-code,gemini,windsurf,cline
 
 # Normal daily command
 kgraph "auth token refresh"
@@ -51,6 +51,7 @@ KGraph stores the reusable parts locally:
 - What files exist and what language they use.
 - What symbols each source file defines.
 - Which files import each other.
+- Which TypeScript/JavaScript functions and methods directly call each other when KGraph can infer it cheaply.
 - Which notes, decisions, debugging findings, and gotchas were captured from prior sessions.
 - Which cognition references are current, mixed, stale, or unresolved after code moves.
 
@@ -89,7 +90,7 @@ From the root of a repository:
 kgraph init
 
 # 2. Optional: connect AI tools so they know the KGraph workflow
-kgraph integrate add codex copilot cursor claude-code
+kgraph integrate add codex copilot cursor claude-code gemini windsurf cline
 
 # 3. Run the normal workflow for a topic
 kgraph "auth token refresh"
@@ -120,7 +121,7 @@ kgraph init
 Required once per repo. Creates `.kgraph/` and the local config.
 
 ```bash
-kgraph init --integrations codex,copilot,cursor,claude-code
+kgraph init --integrations codex,copilot,cursor,claude-code,gemini,windsurf,cline
 ```
 
 Initializes KGraph and writes local instruction files for supported AI tools.
@@ -196,7 +197,7 @@ Show processed cognition sessions.
 KGraph integrations are local files. They do not start background agents, call AI providers, or send data anywhere.
 
 ```bash
-kgraph integrate add codex copilot cursor claude-code
+kgraph integrate add codex copilot cursor claude-code gemini windsurf cline
 kgraph integrate list
 kgraph integrate remove cursor
 ```
@@ -207,6 +208,11 @@ kgraph integrate remove cursor
 | GitHub Copilot | `.github/copilot-instructions.md`, `.github/prompts/*` |
 | Cursor | `.cursor/rules/kgraph.mdc` |
 | Claude Code | `CLAUDE.md`, `.claude/commands/*` |
+| Gemini CLI | `GEMINI.md` |
+| Windsurf | `.windsurf/rules/kgraph.md` |
+| Cline | `.clinerules/kgraph.md` |
+
+Antigravity is supported through the existing agent instruction surfaces it can read, especially `AGENTS.md` and `GEMINI.md`; it does not need a separate KGraph adapter yet.
 
 KGraph preserves existing user-authored content and updates only its marked instruction blocks or generated command files.
 
@@ -235,7 +241,7 @@ The files are local, inspectable, and human-readable. There is no database, tele
 
 KGraph deeply scans:
 
-- TypeScript and JavaScript
+- TypeScript and JavaScript, including lightweight function/method call relationships
 - Python
 - Go
 - Rust
@@ -243,7 +249,7 @@ KGraph deeply scans:
 - C and C++
 - C#
 
-Other common file types still appear in the file map with generic metadata, so context queries can still point to docs, config, SQL, CSS, HTML, YAML, and similar files.
+Other languages keep practical file, import, and symbol depth without full call graph analysis. Common file types still appear in the file map with generic metadata, so context queries can still point to docs, config, SQL, CSS, HTML, YAML, and similar files.
 
 ## Visualization
 
@@ -251,7 +257,7 @@ Other common file types still appear in the file map with generic metadata, so c
 kgraph visualize
 ```
 
-The graph shows files, symbols, imports, cognition notes, and relationship edges. Cognition notes are colored by reference health:
+The graph shows files, symbols, imports, TypeScript/JavaScript call edges, ownership edges, cognition notes, and relationship edges. Cognition notes are colored by reference health:
 
 - current
 - mixed

package/dist/cli/help.js

@@ -2,7 +2,7 @@ import { Chalk } from 'chalk';
 import figlet from 'figlet';
 export function renderRootHelp(useColor = supportsColor()) {
     const theme = new Chalk({ level: useColor ? 3 : 0 });
-    const command = (name, description) => `  ${theme.green(name.padEnd(30))} ${description}`;
+    const command = (name, description) => `  ${theme.green(name.padEnd(42))} ${description}`;
     const logo = renderLogo();
     return [
         '',
@@ -11,7 +11,7 @@ export function renderRootHelp(useColor = supportsColor()) {
         `  ${theme.bold('KGraph')} ${theme.dim('Persistent repo intelligence for AI coding tools')}`,
         '',
         `  ${theme.hex('#c084fc')('Build a local knowledge layer that helps Codex, Copilot, Cursor,')}`,
-        `  ${theme.hex('#c084fc')('and Claude Code reuse repo structure, decisions, and debugging history.')}`,
+        `  ${theme.hex('#c084fc')('Claude Code, Gemini, Windsurf, and Cline reuse repo intelligence.')}`,
         '',
         theme.bold('Usage'),
         '  kgraph [topic]',
@@ -19,7 +19,7 @@ export function renderRootHelp(useColor = supportsColor()) {
         '',
         theme.bold('Start'),
         command('init', 'Required once: create .kgraph/ workspace'),
-        command('init --integrations codex,cursor', 'Initialize and connect AI tools'),
+        command('init --integrations codex,gemini', 'Initialize and connect AI tools'),
         '',
         theme.bold('Daily workflow'),
         command('kgraph', 'Refresh scan maps and process pending cognition notes'),
@@ -38,7 +38,7 @@ export function renderRootHelp(useColor = supportsColor()) {
         '',
         theme.bold('Integrations'),
         command('integrate list', 'Show configured AI tool integrations'),
-        command('integrate add codex copilot', 'Write KGraph instructions for AI tools'),
+        command('integrate add gemini windsurf cline', 'Write KGraph instructions for AI tools'),
         command('integrate remove cursor', 'Remove KGraph-managed instruction blocks'),
         '',
         theme.bold('Options'),
@@ -46,7 +46,7 @@ export function renderRootHelp(useColor = supportsColor()) {
         command('-h, --help', 'Show this help'),
         '',
         `${theme.yellow('Examples')}`,
-        '  kgraph init --integrations codex,copilot,cursor',
+        '  kgraph init --integrations codex,copilot,cursor,claude-code,gemini,windsurf,cline',
         '  kgraph "blog admin token usage"',
         '  kgraph doctor',
         '',
@@ -56,7 +56,7 @@ export function renderRootHelp(useColor = supportsColor()) {
 }
 export function renderWorkflowBanner(stats, useColor = supportsColor()) {
     const theme = new Chalk({ level: useColor ? 3 : 0 });
-    const command = (name, description) => `  ${theme.green(name.padEnd(30))} ${description}`;
+    const command = (name, description) => `  ${theme.green(name.padEnd(42))} ${description}`;
     return [
         '',
         theme.hex('#7dd3fc').bold(renderLogo()),

package/dist/config/config.js

@@ -25,10 +25,13 @@ export const DEFAULT_CONFIG = {
         'specs',
         '.cursor',
         '.claude',
+        '.windsurf',
+        '.clinerules',
         '.github/copilot-instructions.md',
         '.github/prompts',
         'AGENTS.md',
         'CLAUDE.md',
+        'GEMINI.md',
         'REQUIREMENTS.md',
         '*.log',
         '*.tgz',
@@ -132,7 +135,15 @@ function normalizeIntegrations(value) {
             seen.has(candidate.name)) {
             continue;
         }
-        if (!['claude-code', 'codex', 'copilot', 'cursor'].includes(candidate.name)) {
+        if (![
+            'claude-code',
+            'cline',
+            'codex',
+            'copilot',
+            'cursor',
+            'gemini',
+            'windsurf',
+        ].includes(candidate.name)) {
             continue;
         }
         seen.add(candidate.name);

package/dist/context/context-query.js

@@ -39,6 +39,13 @@ export async function queryContext(workspace, config, maps, query) {
             ...domain.item.symbols,
         ]),
     ]);
+    for (const relationship of maps.relationshipMap.relationships) {
+        if (relatedIds.has(relationship.sourceId) ||
+            relatedIds.has(relationship.targetId)) {
+            relatedIds.add(relationship.sourceId);
+            relatedIds.add(relationship.targetId);
+        }
+    }
     const rankedRelationships = rankByFields(query, maps.relationshipMap.relationships, [
         { name: 'source', value: (relationship) => relationship.sourceId },
         { name: 'target', value: (relationship) => relationship.targetId },

package/dist/integrations/adapters/cline.d.ts

@@ -0,0 +1,2 @@
+import type { IntegrationAdapter } from '../integration-registry.js';
+export declare const clineAdapter: IntegrationAdapter;

package/dist/integrations/adapters/cline.js

@@ -0,0 +1,17 @@
+export const clineAdapter = {
+    name: 'cline',
+    label: 'Cline',
+    targetPath: '.clinerules/kgraph.md',
+    instructions: `# KGraph Workflow
+
+- **Before exploring the repository**, run \`kgraph "<topic>"\` to refresh maps, process pending inbox notes, and load focused repo intelligence. Use the returned files, symbols, relationships, and cognition before any broad exploration.
+- Run \`kgraph doctor\` when setup, maps, inbox processing, or integrations look wrong. Run \`kgraph doctor --quality\` when context shows stale/noisy cognition references.
+- At the end of any session that changed repository files, check the KGraph capture workflow before finishing.
+- If the file change has future value, write one concise Markdown note to \`.kgraph/inbox/<slug>.md\`; otherwise explicitly skip capture as trivial.
+- Skip capture only for read-only work, trivial formatting, typo-only docs, dependency-only churn, mechanical cleanup with no future value, or sessions where no repo files changed.
+- Do not run KGraph repeatedly. Run it once at the start with \`kgraph "<topic>"\`. If repo files changed, write any needed inbox note first, then run \`kgraph\` once at the end.
+- Run \`kgraph repair --dry-run\` before cleanup when stale/noisy cognition needs fixing. Run \`kgraph repair\` only when the user asks to apply that cleanup.
+- Run \`kgraph visualize\` to open the interactive dependency graph at http://localhost:4242 with PNG export.
+- Run \`kgraph history\` to review the timeline of past cognition sessions with git author attribution.
+`,
+};

package/dist/integrations/adapters/gemini.d.ts

@@ -0,0 +1,2 @@
+import type { IntegrationAdapter } from '../integration-registry.js';
+export declare const geminiAdapter: IntegrationAdapter;

package/dist/integrations/adapters/gemini.js

@@ -0,0 +1,17 @@
+export const geminiAdapter = {
+    name: 'gemini',
+    label: 'Gemini CLI',
+    targetPath: 'GEMINI.md',
+    instructions: `## KGraph Workflow
+
+- **Before exploring the repository**, run \`kgraph "<topic>"\` to refresh maps, process pending inbox notes, and load focused repo intelligence. Use the returned files, symbols, relationships, and cognition before any broad exploration.
+- Run \`kgraph doctor\` when setup, maps, inbox processing, or integrations look wrong. Run \`kgraph doctor --quality\` when context shows stale/noisy cognition references.
+- At the end of any session that changed repository files, check the KGraph capture workflow before finishing.
+- If the file change has future value, write one concise Markdown note to \`.kgraph/inbox/<slug>.md\`; otherwise explicitly skip capture as trivial.
+- Skip capture only for read-only work, trivial formatting, typo-only docs, dependency-only churn, mechanical cleanup with no future value, or sessions where no repo files changed.
+- Do not run KGraph repeatedly. Run it once at the start with \`kgraph "<topic>"\`. If repo files changed, write any needed inbox note first, then run \`kgraph\` once at the end.
+- Run \`kgraph repair --dry-run\` before cleanup when stale/noisy cognition needs fixing. Run \`kgraph repair\` only when the user asks to apply that cleanup.
+- Run \`kgraph visualize\` to open the interactive dependency graph at http://localhost:4242 with PNG export.
+- Run \`kgraph history\` to review the timeline of past cognition sessions with git author attribution.
+`,
+};

package/dist/integrations/adapters/windsurf.d.ts

@@ -0,0 +1,2 @@
+import type { IntegrationAdapter } from '../integration-registry.js';
+export declare const windsurfAdapter: IntegrationAdapter;

package/dist/integrations/adapters/windsurf.js

@@ -0,0 +1,17 @@
+export const windsurfAdapter = {
+    name: 'windsurf',
+    label: 'Windsurf',
+    targetPath: '.windsurf/rules/kgraph.md',
+    instructions: `# KGraph Workflow
+
+- **Before exploring the repository**, run \`kgraph "<topic>"\` to refresh maps, process pending inbox notes, and load focused repo intelligence. Use the returned files, symbols, relationships, and cognition before any broad exploration.
+- Run \`kgraph doctor\` when setup, maps, inbox processing, or integrations look wrong. Run \`kgraph doctor --quality\` when context shows stale/noisy cognition references.
+- At the end of any session that changed repository files, check the KGraph capture workflow before finishing.
+- If the file change has future value, write one concise Markdown note to \`.kgraph/inbox/<slug>.md\`; otherwise explicitly skip capture as trivial.
+- Skip capture only for read-only work, trivial formatting, typo-only docs, dependency-only churn, mechanical cleanup with no future value, or sessions where no repo files changed.
+- Do not run KGraph repeatedly. Run it once at the start with \`kgraph "<topic>"\`. If repo files changed, write any needed inbox note first, then run \`kgraph\` once at the end.
+- Run \`kgraph repair --dry-run\` before cleanup when stale/noisy cognition needs fixing. Run \`kgraph repair\` only when the user asks to apply that cleanup.
+- Run \`kgraph visualize\` to open the interactive dependency graph at http://localhost:4242 with PNG export.
+- Run \`kgraph history\` to review the timeline of past cognition sessions with git author attribution.
+`,
+};

package/dist/integrations/integration-registry.js

@@ -1,12 +1,18 @@
 import { claudeCodeAdapter } from "./adapters/claude-code.js";
+import { clineAdapter } from "./adapters/cline.js";
 import { codexAdapter } from "./adapters/codex.js";
 import { copilotAdapter } from "./adapters/copilot.js";
 import { cursorAdapter } from "./adapters/cursor.js";
+import { geminiAdapter } from "./adapters/gemini.js";
+import { windsurfAdapter } from "./adapters/windsurf.js";
 const ADAPTERS = [
     claudeCodeAdapter,
+    clineAdapter,
     codexAdapter,
     copilotAdapter,
-    cursorAdapter
+    cursorAdapter,
+    geminiAdapter,
+    windsurfAdapter
 ].sort((left, right) => left.name.localeCompare(right.name));
 export function listIntegrationAdapters() {
     return ADAPTERS;

package/dist/scanner/ts-symbol-extractor.js

@@ -6,11 +6,14 @@ export function extractTsSymbols(sourceText, filePath) {
     const dependencies = [];
     const relationships = [];
     const warnings = [];
+    const symbolIdsByNode = new Map();
+    const symbolsByName = new Map();
+    const importedBindings = new Map();
     const addSymbol = (name, kind, node, exported = false, parentName) => {
         const start = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
         const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
         const id = [filePath, kind, parentName, name, start.line + 1, end.line + 1].filter(Boolean).join("#");
-        symbols.push({
+        const symbol = {
             id,
             name,
             kind,
@@ -19,7 +22,12 @@ export function extractTsSymbols(sourceText, filePath) {
             endLine: end.line + 1,
             exported,
             parentName
-        });
+        };
+        symbols.push(symbol);
+        symbolIdsByNode.set(node, id);
+        const byName = symbolsByName.get(name) ?? [];
+        byName.push(symbol);
+        symbolsByName.set(name, byName);
         relationships.push({
             sourceType: "file",
             sourceId: filePath,
@@ -28,8 +36,9 @@ export function extractTsSymbols(sourceText, filePath) {
             relationshipType: "contains",
             confidence: "high"
         });
+        return symbol;
     };
-    const visit = (node, parentName) => {
+    const collectSymbols = (node, parentName) => {
         if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
             const specifier = node.moduleSpecifier.text;
             const dependency = {
@@ -48,6 +57,7 @@ export function extractTsSymbols(sourceText, filePath) {
                 relationshipType: "import",
                 confidence: dependency.resolvedFile ? "high" : "medium"
             });
+            collectImportedBindings(node, specifier, dependency.resolvedFile, importedBindings);
         }
         if (ts.isExportDeclaration(node)) {
             const name = node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier) ? node.moduleSpecifier.text : "export";
@@ -66,10 +76,18 @@ export function extractTsSymbols(sourceText, filePath) {
             }
         }
         if (ts.isClassDeclaration(node) && node.name) {
-            addSymbol(node.name.text, "class", node, isExported(node), parentName);
+            const classSymbol = addSymbol(node.name.text, "class", node, isExported(node), parentName);
             node.members.forEach((member) => {
                 if (ts.isMethodDeclaration(member) && member.name && ts.isIdentifier(member.name)) {
-                    addSymbol(member.name.text, "method", member, false, node.name?.text);
+                    const methodSymbol = addSymbol(member.name.text, "method", member, false, node.name?.text);
+                    relationships.push({
+                        sourceType: "symbol",
+                        sourceId: classSymbol.id,
+                        targetType: "symbol",
+                        targetId: methodSymbol.id,
+                        relationshipType: "symbol-contains",
+                        confidence: "high"
+                    });
                 }
             });
         }
@@ -79,16 +97,85 @@ export function extractTsSymbols(sourceText, filePath) {
         if (ts.isTypeAliasDeclaration(node)) {
             addSymbol(node.name.text, "type", node, isExported(node), parentName);
         }
-        ts.forEachChild(node, (child) => visit(child, parentName));
+        ts.forEachChild(node, (child) => collectSymbols(child, parentName));
+    };
+    const collectCalls = (node, currentSymbolId) => {
+        const nextSymbolId = symbolIdsByNode.get(node) ?? currentSymbolId;
+        if (ts.isCallExpression(node) && nextSymbolId) {
+            const target = resolveCallTarget(node, symbolsByName, importedBindings);
+            if (target) {
+                relationships.push({
+                    sourceType: "symbol",
+                    sourceId: nextSymbolId,
+                    targetType: target.targetType,
+                    targetId: target.targetId,
+                    relationshipType: "calls",
+                    confidence: target.confidence
+                });
+            }
+        }
+        ts.forEachChild(node, (child) => collectCalls(child, nextSymbolId));
     };
     try {
-        visit(sourceFile);
+        collectSymbols(sourceFile);
+        collectCalls(sourceFile);
     }
     catch (error) {
         warnings.push(error instanceof Error ? error.message : String(error));
     }
     return { symbols, dependencies, relationships, warnings };
 }
+function collectImportedBindings(node, specifier, resolvedFile, importedBindings) {
+    const clause = node.importClause;
+    if (!clause) {
+        return;
+    }
+    if (clause.name) {
+        importedBindings.set(clause.name.text, { specifier, resolvedFile });
+    }
+    const bindings = clause.namedBindings;
+    if (bindings && ts.isNamedImports(bindings)) {
+        for (const element of bindings.elements) {
+            importedBindings.set(element.name.text, { specifier, resolvedFile });
+        }
+    }
+}
+function resolveCallTarget(node, symbolsByName, importedBindings) {
+    const expression = node.expression;
+    if (ts.isIdentifier(expression)) {
+        const localSymbols = symbolsByName
+            .get(expression.text)
+            ?.filter((symbol) => symbol.kind === "function" || symbol.kind === "method");
+        if (localSymbols?.[0]) {
+            return {
+                targetType: "symbol",
+                targetId: localSymbols[0].id,
+                confidence: "high"
+            };
+        }
+        const imported = importedBindings.get(expression.text);
+        if (imported) {
+            return {
+                targetType: "symbol",
+                targetId: imported.resolvedFile ? `${imported.resolvedFile}#${expression.text}` : expression.text,
+                confidence: imported.resolvedFile ? "medium" : "low"
+            };
+        }
+        return {
+            targetType: "symbol",
+            targetId: expression.text,
+            confidence: "low"
+        };
+    }
+    if (ts.isPropertyAccessExpression(expression)) {
+        return {
+            targetType: "symbol",
+            targetId: expression.getText(),
+            confidence: "low"
+        };
+    }
+    return undefined;
+}
 function isExported(node) {
     return ts.canHaveModifiers(node) && Boolean(ts.getModifiers(node)?.some((mod) => mod.kind === ts.SyntaxKind.ExportKeyword));
 }

package/dist/types/config.d.ts

@@ -12,7 +12,7 @@ export interface DomainHint {
     paths?: string[];
     tags?: string[];
 }
-export type IntegrationName = "claude-code" | "codex" | "copilot" | "cursor";
+export type IntegrationName = "claude-code" | "cline" | "codex" | "copilot" | "cursor" | "gemini" | "windsurf";
 export interface IntegrationConfig {
     name: IntegrationName;
     enabled: boolean;

package/dist/types/maps.d.ts

@@ -1,7 +1,7 @@
 export type ScanStatus = "mapped" | "generic" | "failed";
 export type DependencyKind = "local" | "package" | "unknown";
 export type SymbolKind = "function" | "class" | "method" | "type" | "interface" | "export" | "import";
-export type RelationshipType = "import" | "contains" | "mentions" | "belongs-to-domain" | "stale-reference" | "moved-from";
+export type RelationshipType = "import" | "contains" | "symbol-contains" | "calls" | "mentions" | "belongs-to-domain" | "stale-reference" | "moved-from";
 export interface RepositoryFile {
     id: string;
     path: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kentwynn/kgraph",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Persistent repo intelligence for AI coding assistants.",
   "type": "module",
   "bin": {