memgrid 0.5.0

package/dist/serve/cli.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { MemGrid } from '../memgrid.js';
+import { TypeScriptScanner, JavaScriptScanner, PythonScanner, GoScanner, RustScanner, MarkdownScanner, RulesScanner, ConfigScanner, } from '../scanner/index.js';
+import { startMCPServer } from './mcp-server.js';
+const program = new Command();
+program
+    .name('memgrid')
+    .description('Project-level semantic memory for AI coding agents')
+    .version('0.5.0');
+program
+    .command('init')
+    .description('Scan project and generate initial memory grid')
+    .option('-f, --force', 'Force re-scan even if grid exists')
+    .option('--no-rules', 'Skip scanning .claude/rules/')
+    .option('--no-examples', 'Skip scanning .claude/examples/')
+    .action(async (options) => {
+    // Auto-detect applicable scanners
+    const root = process.cwd();
+    const languageScanners = [
+        { name: 'typescript', factory: () => new TypeScriptScanner(null, root) },
+        { name: 'javascript', factory: () => new JavaScriptScanner(null, root) },
+        { name: 'python', factory: () => new PythonScanner(null, root) },
+        { name: 'golang', factory: () => new GoScanner(null, root) },
+        { name: 'rust', factory: () => new RustScanner(null, root) },
+    ];
+    const detected = [];
+    for (const ls of languageScanners) {
+        if (ls.factory().detect(root))
+            detected.push(ls.name);
+    }
+    // Also detect universal scanners
+    if (new MarkdownScanner(root).detect(root))
+        detected.push('markdown');
+    if (options.rules !== false && new RulesScanner(root).detect(root))
+        detected.push('rules');
+    if (new ConfigScanner(root).detect(root))
+        detected.push('config');
+    const mg = new MemGrid(root);
+    console.log(`🔍 Scanning project (${detected.join(', ') || 'typescript'})...\n`);
+    const units = await mg.init({
+        projectRoot: process.cwd(),
+        includeRules: options.rules !== false,
+        includeExamples: options.examples !== false,
+        force: options.force || false,
+    });
+    const stats = await mg.stats();
+    console.log('📊 MemGrid initialized!\n');
+    console.log('Units generated:');
+    for (const [type, count] of Object.entries(stats.typeDistribution)) {
+        console.log(`  ${type}: ${count}`);
+    }
+    console.log(`\nTotal: ${stats.totalUnits} units`);
+    console.log(`Storage: .claude/memory-grid/`);
+});
+program
+    .command('sync')
+    .description('Incremental sync — re-scan only changed files (fast, for CI/CD or post-git-pull)')
+    .option('--no-rules', 'Skip scanning .claude/rules/')
+    .option('--no-examples', 'Skip scanning .claude/examples/')
+    .option('-t, --threshold <number>', 'Fuzzy match threshold (0.0-1.0)', '0.45')
+    .action(async (options) => {
+    const mg = new MemGrid(process.cwd());
+    console.log('🔄 Syncing (incremental)...\n');
+    const result = await mg.sync({
+        projectRoot: process.cwd(),
+        includeRules: options.rules !== false,
+        includeExamples: options.examples !== false,
+        fuzzyThreshold: parseFloat(options.threshold),
+    });
+    if (result.changedFiles.length === 0 && result.removedFiles.length === 0) {
+        console.log('✅ No changes detected — grid is up to date');
+        return;
+    }
+    console.log(`📁 Changed files:  ${result.changedFiles.length}`);
+    console.log(`🗑️  Removed files:  ${result.removedFiles.length}`);
+    console.log(`📝 Updated units:  ${result.updatedUnits}`);
+    console.log(`⚠️  Stale units:    ${result.staleUnits}`);
+    console.log(`🔗 Repaired links: ${result.repairedAssociations}`);
+    console.log(`💔 Broken links:   ${result.brokenAssociations}`);
+    console.log(`\n⏱️  Done in ${result.elapsedMs}ms`);
+});
+program
+    .command('search')
+    .description('Search memory grid for relevant units (hybrid: keyword + semantic)')
+    .argument('<query>', 'Search query')
+    .option('-n, --max <number>', 'Max results', '10')
+    .option('-H, --hops <number>', 'Max association hops', '2')
+    .option('-s, --semantic <number>', 'Semantic weight (0.0-1.0, default: 0.4)', '0.4')
+    .action(async (query, options) => {
+    const mg = new MemGrid(process.cwd());
+    const result = await mg.search(query, {
+        maxResults: parseInt(options.max),
+        maxHops: parseInt(options.hops),
+        semanticWeight: parseFloat(options.semantic),
+    });
+    console.log(mg.context(result));
+});
+program
+    .command('add')
+    .description('Add a memory unit manually')
+    .requiredOption('-t, --type <type>', 'Unit type')
+    .requiredOption('-s, --summary <summary>', 'One-line summary')
+    .requiredOption('-d, --description <desc>', 'Description')
+    .option('-f, --file <file>', 'Source file path')
+    .option('-l, --lines <lines>', 'Source line range')
+    .action(async (options) => {
+    const mg = new MemGrid(process.cwd());
+    const id = `${options.type}_manual_${Date.now()}`;
+    const unit = await mg.add({
+        id,
+        type: options.type,
+        summary: options.summary,
+        content: {
+            description: options.description,
+        },
+        source: options.file ? { file: options.file, lines: options.lines } : undefined,
+    });
+    console.log(`✅ Added: ${unit.id}`);
+});
+program
+    .command('stats')
+    .description('Show grid statistics')
+    .action(async () => {
+    const mg = new MemGrid(process.cwd());
+    const stats = await mg.stats();
+    console.log('📊 MemGrid Statistics\n');
+    console.log(`  Total units:    ${stats.totalUnits}`);
+    console.log(`  Active:         ${stats.activeUnits}`);
+    console.log(`  Archived:       ${stats.archivedUnits}`);
+    console.log(`  Last scan:      ${stats.lastScanAt || 'Never'}`);
+    console.log(`\n  Type distribution:`);
+    for (const [type, count] of Object.entries(stats.typeDistribution)) {
+        console.log(`    ${type}: ${count}`);
+    }
+});
+program
+    .command('serve')
+    .description('Start MCP Server (stdio transport)')
+    .action(async () => {
+    console.error('🚀 MemGrid MCP Server starting...');
+    await startMCPServer(process.cwd());
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/serve/cli.js.map

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

package/dist/serve/mcp-server.d.ts

@@ -0,0 +1,11 @@
+export declare class MemGridServer {
+    private server;
+    private mg;
+    constructor(projectRoot: string);
+    private registerTools;
+    private registerHandlers;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function startMCPServer(projectRoot: string): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/serve/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/serve/mcp-server.ts"],"names":[],"mappings":"AAgBA,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAU;gBAER,WAAW,EAAE,MAAM;IAW/B,OAAO,CAAC,aAAa;IAuHrB,OAAO,CAAC,gBAAgB;IAgJlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAGD,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,iBAcvD"}

package/dist/serve/mcp-server.js

@@ -0,0 +1,276 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { MemGrid } from '../memgrid.js';
+const VALID_TYPES = [
+    'method', 'component', 'pattern', 'config', 'error_solution',
+    'decision', 'skill_trigger', 'mcp_trigger', 'rule_trigger',
+    'style_preference', 'architecture_principle',
+];
+export class MemGridServer {
+    server;
+    mg;
+    constructor(projectRoot) {
+        this.mg = new MemGrid(projectRoot);
+        this.server = new Server({ name: 'memgrid', version: '0.4.0' }, { capabilities: { tools: {} } });
+        this.registerTools();
+        this.registerHandlers();
+    }
+    registerTools() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const tools = [
+                {
+                    name: 'memgrid_search',
+                    description: 'Search the project memory grid for relevant knowledge units. ' +
+                        'Returns method signatures, design patterns, coding style preferences, ' +
+                        'error solutions, and tooling triggers related to the query. ' +
+                        'Use this instead of reading every file to understand the project.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            query: {
+                                type: 'string',
+                                description: 'What are you trying to do? Describe the task in natural language.',
+                            },
+                            maxResults: {
+                                type: 'number',
+                                description: 'Maximum number of units to return (default: 10, max: 20)',
+                                default: 10,
+                            },
+                            maxHops: {
+                                type: 'number',
+                                description: 'How many association hops to traverse (default: 2, max: 3)',
+                                default: 2,
+                            },
+                            semanticWeight: {
+                                type: 'number',
+                                description: 'Hybrid search: 0.0 = keyword only, 1.0 = semantic only (default: 0.4)',
+                                default: 0.4,
+                            },
+                        },
+                        required: ['query'],
+                    },
+                },
+                {
+                    name: 'memgrid_add',
+                    description: 'Add or update a memory unit in the grid. Use this after completing a task ' +
+                        'to record what you learned: new methods, mistakes fixed, design decisions, ' +
+                        'or style preferences discovered.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            type: {
+                                type: 'string',
+                                description: 'Unit type: method, pattern, config, error_solution, decision, ' +
+                                    'skill_trigger, mcp_trigger, rule_trigger, style_preference, architecture_principle',
+                                enum: VALID_TYPES,
+                            },
+                            summary: {
+                                type: 'string',
+                                description: 'One-line summary of what this unit represents',
+                            },
+                            description: {
+                                type: 'string',
+                                description: 'Detailed description of the unit content',
+                            },
+                            sourceFile: {
+                                type: 'string',
+                                description: 'Source file path (if applicable)',
+                            },
+                            codeSnippet: {
+                                type: 'string',
+                                description: 'Relevant code snippet (if applicable)',
+                            },
+                            styleNotes: {
+                                type: 'string',
+                                description: 'Style or usage notes',
+                            },
+                            associations: {
+                                type: 'array',
+                                description: 'Links to other unit IDs',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        to: { type: 'string' },
+                                        relation: { type: 'string' },
+                                        weight: { type: 'number', default: 0.8 },
+                                    },
+                                },
+                            },
+                        },
+                        required: ['type', 'summary', 'description'],
+                    },
+                },
+                {
+                    name: 'memgrid_suggest',
+                    description: 'After completing a coding task, ask MemGrid to suggest which memory units ' +
+                        'should be added, updated, or archived. MemGrid analyzes the task outcome ' +
+                        'and compares against existing grid knowledge.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            taskSummary: {
+                                type: 'string',
+                                description: 'Brief summary of what the task was about',
+                            },
+                            outcome: {
+                                type: 'string',
+                                description: 'What was the outcome? What was built, fixed, or changed?',
+                            },
+                            filesModified: {
+                                type: 'array',
+                                description: 'List of files that were modified or created',
+                                items: { type: 'string' },
+                            },
+                        },
+                        required: ['taskSummary', 'outcome'],
+                    },
+                },
+            ];
+            return { tools };
+        });
+    }
+    registerHandlers() {
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case 'memgrid_search': {
+                        const query = args.query;
+                        const maxResults = Math.min(args.maxResults || 10, 20);
+                        const maxHops = Math.min(args.maxHops || 2, 3);
+                        const semanticWeight = args.semanticWeight ?? 0.4;
+                        const result = await this.mg.search(query, { maxResults, maxHops, semanticWeight });
+                        const context = this.mg.context(result);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: context,
+                                },
+                            ],
+                        };
+                    }
+                    case 'memgrid_add': {
+                        const { type, summary, description, sourceFile, codeSnippet, styleNotes, associations } = args;
+                        if (!VALID_TYPES.includes(type)) {
+                            return {
+                                content: [{ type: 'text', text: `Invalid type: "${type}". Must be one of: ${VALID_TYPES.join(', ')}` }],
+                                isError: true,
+                            };
+                        }
+                        const id = `${type}_${Date.now()}`;
+                        const unit = await this.mg.add({
+                            id,
+                            type: type,
+                            summary,
+                            content: {
+                                description,
+                                code_snippet: codeSnippet,
+                                style_notes: styleNotes,
+                            },
+                            source: sourceFile ? { file: sourceFile } : undefined,
+                            associations: (associations || []).map((a) => ({
+                                to: a.to,
+                                relation: a.relation,
+                                weight: a.weight || 0.8,
+                            })),
+                        });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `✅ Memory unit added: ${unit.id}\nType: ${unit.type}\nSummary: ${unit.summary}\nConfidence: ${unit.meta.confidence}`,
+                                },
+                            ],
+                        };
+                    }
+                    case 'memgrid_suggest': {
+                        const { taskSummary, outcome, filesModified } = args;
+                        // Search for existing units related to this task
+                        const result = await this.mg.search(taskSummary, { maxResults: 5, maxHops: 1 });
+                        const suggestions = [];
+                        suggestions.push(`## 📋 MemGrid Suggestions for: "${taskSummary}"\n`);
+                        // Suggest new method units for modified files
+                        if (filesModified && filesModified.length > 0) {
+                            const existingFiles = new Set(result.units
+                                .filter((u) => u.source?.file)
+                                .map((u) => u.source.file));
+                            const newFiles = filesModified.filter((f) => !existingFiles.has(f));
+                            if (newFiles.length > 0) {
+                                suggestions.push(`### 💡 Suggested new method units (${newFiles.length} new files):`);
+                                for (const file of newFiles) {
+                                    suggestions.push(`- Scan \`${file}\` with \`memgrid_init\` to extract methods`);
+                                }
+                                suggestions.push('');
+                            }
+                        }
+                        // Suggest updates for existing relevant units
+                        if (result.units.length > 0) {
+                            suggestions.push(`### 🔄 Related existing units (${result.units.length} found):`);
+                            for (const unit of result.units.slice(0, 5)) {
+                                suggestions.push(`- \`${unit.id}\` — ${unit.summary}`);
+                            }
+                            suggestions.push('\nReview and update if the task changed their behavior.');
+                        }
+                        // Suggest error_solution if outcome mentions fixes
+                        const fixKeywords = ['fix', 'bug', 'error', 'OOM', 'crash', '修复', '错误'];
+                        if (fixKeywords.some((k) => taskSummary.toLowerCase().includes(k) || outcome.toLowerCase().includes(k))) {
+                            suggestions.push('### 🐛 Suggested error_solution unit:');
+                            suggestions.push(`- Record this fix: what was the error, and what was the solution?`);
+                            suggestions.push(`- Use \`memgrid_add --type error_solution\` to add it.`);
+                            suggestions.push('');
+                        }
+                        // Suggest decision unit if the task seems architectural
+                        const decisionKeywords = ['refactor', 'architecture', 'pattern', 'design', '重构', '架构'];
+                        if (decisionKeywords.some((k) => taskSummary.includes(k))) {
+                            suggestions.push('### 🎯 Suggested decision unit:');
+                            suggestions.push('- Record why this architectural decision was made.');
+                            suggestions.push('- Use `memgrid_add --type decision` to capture the rationale.');
+                            suggestions.push('');
+                        }
+                        if (suggestions.length <= 2) {
+                            suggestions.push('No strong suggestions. The grid may not need updates for this task.');
+                        }
+                        return {
+                            content: [{ type: 'text', text: suggestions.join('\n') }],
+                        };
+                    }
+                    default:
+                        return {
+                            content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                            isError: true,
+                        };
+                }
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: `Error: ${error.message}` }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+    }
+    async stop() {
+        await this.server.close();
+    }
+}
+// CLI entry point
+export async function startMCPServer(projectRoot) {
+    const server = new MemGridServer(projectRoot);
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        await server.stop();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await server.stop();
+        process.exit(0);
+    });
+    await server.start();
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/serve/mcp-server.js.map

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

package/dist/shared/constants.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/shared/constants.js

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/shared/types.d.ts

@@ -0,0 +1,99 @@
+export type MemoryUnitType = 'method' | 'component' | 'pattern' | 'config' | 'error_solution' | 'decision' | 'skill_trigger' | 'mcp_trigger' | 'rule_trigger' | 'style_preference' | 'architecture_principle';
+export type RelationType = 'calls' | 'used_by' | 'implements_pattern' | 'follows_rule' | 'similar_pattern' | 'similar_error' | 'paired_with' | 'embodies' | 'belongs_to_module' | 'triggers';
+export interface Association {
+    to: string;
+    relation: RelationType;
+    weight: number;
+}
+export interface MemoryUnit {
+    id: string;
+    type: MemoryUnitType;
+    summary: string;
+    source?: {
+        file: string;
+        lines?: string;
+    };
+    signatures: string[];
+    content: {
+        description: string;
+        inputs?: string;
+        outputs?: string;
+        dependencies?: string[];
+        code_snippet?: string;
+        style_notes?: string;
+        trigger?: string;
+        action?: string;
+    };
+    associations: Association[];
+    meta: {
+        created: string;
+        updated: string;
+        confidence: number;
+        usage_count: number;
+        status: 'active' | 'stale' | 'archived';
+    };
+}
+/** SHA-256 hash of each scanned source file, keyed by relative path */
+export type FileSnapshot = Record<string, string>;
+export interface MemoryGrid {
+    version: string;
+    project: string;
+    lastScanAt: string;
+    stats: {
+        totalUnits: number;
+        activeUnits: number;
+        archivedUnits: number;
+        totalAssociations: number;
+    };
+    edgeIndex: Record<string, Association[]>;
+    fileSnapshot?: FileSnapshot;
+}
+/** Result of a sync operation */
+export interface SyncResult {
+    /** Files that changed (has hash delta) */
+    changedFiles: string[];
+    /** Files that were removed entirely */
+    removedFiles: string[];
+    /** Units added or updated */
+    updatedUnits: number;
+    /** Units marked stale (method name/line changed beyond fuzzy match) */
+    staleUnits: number;
+    /** Associations repaired via fuzzy match */
+    repairedAssociations: number;
+    /** Broken associations that couldn't be repaired */
+    brokenAssociations: number;
+    /** Total time in ms */
+    elapsedMs: number;
+}
+/** Options for sync */
+export interface SyncOptions {
+    projectRoot: string;
+    includeRules: boolean;
+    includeExamples: boolean;
+    /** Max fuzzy match distance (0.0 = exact, 1.0 = anything) */
+    fuzzyThreshold?: number;
+}
+export interface SearchResult {
+    query: string;
+    units: MemoryUnit[];
+    totalHops: number;
+    elapsedMs: number;
+}
+export interface ScanOptions {
+    projectRoot: string;
+    includeRules: boolean;
+    includeExamples: boolean;
+    force: boolean;
+}
+export interface SearchOptions {
+    maxResults?: number;
+    maxHops?: number;
+    semanticWeight?: number;
+}
+/** Single-file scan result from SyncEngine */
+export interface FileScanResult {
+    file: string;
+    units: MemoryUnit[];
+    hash: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/shared/types.js

@@ -0,0 +1,3 @@
+// === Memory Unit Types ===
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

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