memorylink 1.0.0

package/dist/commands/setup.js

@@ -0,0 +1,405 @@
+"use strict";
+/**
+ * Setup Commands
+ *
+ * AI-specific setup for Cursor, Claude, ChatGPT, etc.
+ * Creates configuration files that teach AI tools to use MemoryLink
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupCursorCommand = setupCursorCommand;
+exports.setupClaudeCommand = setupClaudeCommand;
+exports.setupChatGPTCommand = setupChatGPTCommand;
+exports.setupCopilotCommand = setupCopilotCommand;
+exports.setupAllCommand = setupAllCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const utils_js_1 = require("../utils.js");
+// ===========================================
+// CURSOR SETUP
+// ===========================================
+const CURSOR_RULES = `# MemoryLink Integration for Cursor AI
+
+## Before Making ANY Changes
+
+1. **Read Protected Files**: Check \`.memorylink/protected.txt\` - DO NOT modify these files.
+2. **Read Project Context**: Check \`.memorylink/memory.log\` for project decisions and context.
+3. **Check Past Solutions**: Review \`.memorylink/learnings.log\` before solving problems.
+   - Entries marked SUCCESS = use these approaches
+   - Entries marked FAILED = DO NOT repeat these
+
+## After Making Changes
+
+1. **Log Changes**: Record what you changed and why
+2. **Log Learnings**: If you solved a problem, note whether it worked (SUCCESS/FAILED)
+
+## File Locations
+
+\`\`\`
+.memorylink/
+├── protected.txt    # Files I cannot modify
+├── memory.log       # Project context and decisions
+├── changes.log      # Audit trail of all changes
+└── learnings.log    # Past solutions (SUCCESS/FAILED)
+\`\`\`
+
+## Example Workflow
+
+Before editing \`api.ts\`:
+1. Check if \`api.ts\` is in protected.txt → If yes, ask permission first
+2. Read memory.log for API-related context
+3. Check learnings.log for past API solutions
+
+After fixing a bug:
+1. Note the change in changes.log
+2. If the fix worked, add to learnings.log with SUCCESS
+3. If the fix failed, add to learnings.log with FAILED
+
+## Important Rules
+
+- NEVER edit files listed in protected.txt without explicit permission
+- ALWAYS check learnings.log before suggesting solutions to avoid repeating failures
+- Keep memory.log updated with important decisions
+
+## MemoryLink-First Workflow (Optimize Document Creation)
+
+### Before Creating Documents:
+1. **Check MemoryLink First:** Use \`memorylink get-context\` instead of creating planning docs
+2. **Use MemoryLink for State:** Store decisions in memory.log, not in separate docs
+3. **Log Learnings:** Use learnings.log instead of creating "what worked" docs
+
+### When to Create Documents:
+- **User-Requested:** Only if user explicitly asks for a document
+- **External Sharing:** Documents for humans (README, guides, etc.)
+- **Complex Analysis:** Multi-step analysis that needs structure
+
+### When to Use MemoryLink:
+- **Project Decisions:** Use memory.log (not decision docs)
+- **What Worked/Failed:** Use learnings.log (not summary docs)
+- **Change Tracking:** Use changes.log (not change logs)
+- **Context for Next Session:** Use get-context command (not reading old docs)
+
+### Document Creation Guidelines:
+- **Avoid:** Creating "planning" documents (use MemoryLink memory.log)
+- **Avoid:** Creating "summary" documents (use MemoryLink learnings.log)
+- **Avoid:** Creating "state" documents (use MemoryLink get-context)
+- **Create:** Only user-facing documentation (README, guides, troubleshooting)
+
+### Workflow Optimization:
+1. **Start Session:** Run \`memorylink get-context\` (don't read old planning docs)
+2. **During Work:** Log to MemoryLink (don't create summary docs)
+3. **End Session:** MemoryLink remembers (no need for summary doc)
+4. **Next Session:** MemoryLink provides context (no need to read old docs)
+
+### Why This Matters:
+- **Document Creation = Memory Workaround:** Creating docs because you lack memory
+- **MemoryLink = Solution:** Use MemoryLink instead of creating redundant docs
+- **Efficiency:** Reduces document proliferation and redundant reading
+`;
+async function setupCursorCommand(options = {}) {
+    const { verbose } = options;
+    (0, utils_js_1.log)('Setting up MemoryLink for Cursor', verbose);
+    const root = (0, utils_js_1.findRoot)() || process.cwd();
+    if (!(0, utils_js_1.isInitialized)(root)) {
+        (0, utils_js_1.error)('MemoryLink not initialized. Run: memorylink init');
+        process.exit(1);
+    }
+    // Get active rules/preferences from memory.log (Qwen's Hello World requirement)
+    const memoryPath = (0, utils_js_1.getFilePath)('MEMORY', root);
+    let activeRules = [];
+    if (fs.existsSync(memoryPath) && (0, utils_js_1.isJsonlFormat)(memoryPath)) {
+        const entries = (0, utils_js_1.readJsonlEntries)(memoryPath);
+        activeRules = entries.filter(e => e.status === 'ACTIVE' &&
+            (e.type === 'rule' || e.type === 'preference'));
+    }
+    // Generate active rules section
+    let activeRulesSection = '';
+    if (activeRules.length > 0) {
+        activeRulesSection = '## 🚨 ACTIVE RULES & PREFERENCES (OVERRIDE DEFAULT BEHAVIOR)\n\n';
+        activeRulesSection += '**These rules MUST be followed. They override default assistant behavior.**\n\n';
+        activeRules.forEach((rule, index) => {
+            const tagsStr = rule.tags?.length ? ` [${rule.tags.join(', ')}]` : '';
+            activeRulesSection += `${index + 1}. **${rule.type.toUpperCase()}**: ${rule.details}${tagsStr}\n`;
+        });
+        activeRulesSection += '\n---\n\n';
+        if (verbose) {
+            (0, utils_js_1.info)(`Found ${activeRules.length} active rule(s)/preference(s) to inject`);
+        }
+    }
+    const cursorrules = path.join(root, '.cursorrules');
+    // Check if .cursorrules exists
+    if (fs.existsSync(cursorrules)) {
+        const existing = fs.readFileSync(cursorrules, 'utf-8');
+        // Check if already has MemoryLink
+        if (existing.includes('MemoryLink')) {
+            (0, utils_js_1.warn)('.cursorrules already contains MemoryLink configuration');
+            (0, utils_js_1.info)('Run `memorylink sync-rules` to update with latest rules/preferences');
+            return;
+        }
+        // Append to existing with active rules at the top
+        const updated = activeRulesSection + existing + '\n\n' + CURSOR_RULES;
+        fs.writeFileSync(cursorrules, updated);
+        (0, utils_js_1.success)('Added MemoryLink rules to existing .cursorrules');
+        if (activeRules.length > 0) {
+            (0, utils_js_1.info)(`Injected ${activeRules.length} active rule(s)/preference(s) at the top`);
+        }
+    }
+    else {
+        // Create new with active rules at the top
+        const content = activeRulesSection + CURSOR_RULES;
+        fs.writeFileSync(cursorrules, content);
+        (0, utils_js_1.success)('Created .cursorrules with MemoryLink integration');
+        if (activeRules.length > 0) {
+            (0, utils_js_1.info)(`Injected ${activeRules.length} active rule(s)/preference(s) at the top`);
+        }
+    }
+    console.log('');
+    (0, utils_js_1.info)('Cursor AI will now:');
+    console.log('  • See active rules/preferences at the top of .cursorrules');
+    console.log('  • Check protected.txt before editing files');
+    console.log('  • Read memory.log for project context');
+    console.log('  • Check learnings.log before solving problems');
+    console.log('');
+    if (activeRules.length > 0) {
+        (0, utils_js_1.info)('✅ Hello World test ready: Active rules are now in .cursorrules');
+        (0, utils_js_1.info)('   Cursor will see these rules automatically on next chat');
+    }
+    else {
+        (0, utils_js_1.info)('💡 Add rules with: memorylink memory "rule" --type rule');
+        (0, utils_js_1.info)('   Then run: memorylink sync-rules (or setup cursor again)');
+    }
+    console.log('');
+}
+// ===========================================
+// CLAUDE SETUP
+// ===========================================
+const CLAUDE_INSTRUCTIONS = `# MemoryLink Project Context
+
+## How to Use This Project
+
+This project uses MemoryLink for AI memory management. Before making any changes:
+
+### 1. Check Protected Files
+Read \`.memorylink/protected.txt\` - these files should NOT be modified without explicit permission.
+
+### 2. Read Project Context  
+Check \`.memorylink/memory.log\` for important decisions and context about this project.
+
+### 3. Learn from Past Solutions
+Review \`.memorylink/learnings.log\`:
+- SUCCESS entries = approaches that worked
+- FAILED entries = approaches that did NOT work - do not repeat these
+
+### 4. After Making Changes
+- Log significant changes to \`.memorylink/changes.log\`
+- Log problem solutions to \`.memorylink/learnings.log\` with SUCCESS or FAILED
+
+## Quick Reference
+
+\`\`\`
+.memorylink/protected.txt  → Files I cannot edit
+.memorylink/memory.log     → Project context
+.memorylink/learnings.log  → What worked/didn't work
+.memorylink/changes.log    → Audit trail
+\`\`\`
+
+## Rules
+1. NEVER edit protected files
+2. Check learnings BEFORE suggesting solutions
+3. Ask if unsure about a file's protection status
+`;
+async function setupClaudeCommand(options = {}) {
+    const { verbose } = options;
+    (0, utils_js_1.log)('Setting up MemoryLink for Claude', verbose);
+    const root = (0, utils_js_1.findRoot)() || process.cwd();
+    if (!(0, utils_js_1.isInitialized)(root)) {
+        (0, utils_js_1.error)('MemoryLink not initialized. Run: memorylink init');
+        process.exit(1);
+    }
+    const claudeFile = path.join(root, 'CLAUDE_INSTRUCTIONS.md');
+    if (fs.existsSync(claudeFile)) {
+        (0, utils_js_1.warn)('CLAUDE_INSTRUCTIONS.md already exists');
+        (0, utils_js_1.info)('Skipping to avoid overwrite. Delete it first if you want to regenerate.');
+        return;
+    }
+    fs.writeFileSync(claudeFile, CLAUDE_INSTRUCTIONS);
+    (0, utils_js_1.success)('Created CLAUDE_INSTRUCTIONS.md');
+    console.log('');
+    (0, utils_js_1.info)('To use with Claude:');
+    console.log('  1. Upload CLAUDE_INSTRUCTIONS.md at the start of your chat');
+    console.log('  2. Or paste its contents into your first message');
+    console.log('  3. Or add to Claude\'s custom instructions (Pro feature)');
+    console.log('');
+}
+// ===========================================
+// CHATGPT SETUP
+// ===========================================
+const CHATGPT_INSTRUCTIONS = `# MemoryLink Integration
+
+This project uses MemoryLink for AI memory management.
+
+## Before ANY code changes:
+
+1. **Protected Files**: Check .memorylink/protected.txt
+   - Files listed here should NOT be modified
+   - Ask permission before touching protected files
+
+2. **Project Context**: Read .memorylink/memory.log
+   - Contains project decisions and important context
+   - Use this information when making suggestions
+
+3. **Past Solutions**: Check .memorylink/learnings.log
+   - SUCCESS = this approach worked, use it
+   - FAILED = this approach did NOT work, avoid it
+
+## After making changes:
+
+- Note what changed and why
+- If you solved a problem, remember if it worked (SUCCESS) or not (FAILED)
+
+## File Structure:
+.memorylink/
+├── protected.txt    → DO NOT edit these files
+├── memory.log       → Project context
+├── changes.log      → What was changed
+└── learnings.log    → What worked/failed
+
+## Key Rules:
+1. Check protected.txt FIRST
+2. Never repeat FAILED solutions
+3. Use SUCCESS solutions as templates
+`;
+async function setupChatGPTCommand(options = {}) {
+    const { verbose } = options;
+    (0, utils_js_1.log)('Setting up MemoryLink for ChatGPT', verbose);
+    const root = (0, utils_js_1.findRoot)() || process.cwd();
+    if (!(0, utils_js_1.isInitialized)(root)) {
+        (0, utils_js_1.error)('MemoryLink not initialized. Run: memorylink init');
+        process.exit(1);
+    }
+    const chatgptFile = path.join(root, 'CHATGPT_INSTRUCTIONS.md');
+    if (fs.existsSync(chatgptFile)) {
+        (0, utils_js_1.warn)('CHATGPT_INSTRUCTIONS.md already exists');
+        (0, utils_js_1.info)('Skipping to avoid overwrite. Delete it first if you want to regenerate.');
+        return;
+    }
+    fs.writeFileSync(chatgptFile, CHATGPT_INSTRUCTIONS);
+    (0, utils_js_1.success)('Created CHATGPT_INSTRUCTIONS.md');
+    console.log('');
+    (0, utils_js_1.info)('To use with ChatGPT:');
+    console.log('  1. Upload CHATGPT_INSTRUCTIONS.md to your chat');
+    console.log('  2. ChatGPT will follow the MemoryLink rules');
+    console.log('  3. For ChatGPT Plus: Add to "Custom Instructions"');
+    console.log('');
+}
+// ===========================================
+// COPILOT SETUP
+// ===========================================
+const COPILOT_INSTRUCTIONS = `# MemoryLink Integration for GitHub Copilot
+
+## Project Memory System
+
+This project uses MemoryLink for cross-AI memory. Key files:
+
+- .memorylink/protected.txt - Files that should not be auto-completed/modified
+- .memorylink/memory.log - Project context and decisions
+- .memorylink/learnings.log - Past solutions (SUCCESS/FAILED)
+
+## For Copilot Users
+
+1. Before accepting suggestions for protected files, check protected.txt
+2. Use memory.log context when writing new code
+3. Check learnings.log when debugging similar issues
+
+## Integration Notes
+
+Copilot cannot directly read these files, but you can:
+1. Open .memorylink files in a split pane for reference
+2. Use comments to remind yourself of context
+3. Use memorylink CLI to check before major changes
+`;
+async function setupCopilotCommand(options = {}) {
+    const { verbose } = options;
+    (0, utils_js_1.log)('Setting up MemoryLink for Copilot', verbose);
+    const root = (0, utils_js_1.findRoot)() || process.cwd();
+    if (!(0, utils_js_1.isInitialized)(root)) {
+        (0, utils_js_1.error)('MemoryLink not initialized. Run: memorylink init');
+        process.exit(1);
+    }
+    const copilotFile = path.join(root, '.github', 'copilot-instructions.md');
+    const githubDir = path.join(root, '.github');
+    // Create .github directory if needed
+    if (!fs.existsSync(githubDir)) {
+        fs.mkdirSync(githubDir, { recursive: true });
+    }
+    if (fs.existsSync(copilotFile)) {
+        (0, utils_js_1.warn)('.github/copilot-instructions.md already exists');
+        (0, utils_js_1.info)('Skipping to avoid overwrite. Delete it first if you want to regenerate.');
+        return;
+    }
+    fs.writeFileSync(copilotFile, COPILOT_INSTRUCTIONS);
+    (0, utils_js_1.success)('Created .github/copilot-instructions.md');
+    console.log('');
+    (0, utils_js_1.info)('Copilot will now see these instructions in your project.');
+    console.log('');
+}
+// ===========================================
+// SETUP ALL
+// ===========================================
+async function setupAllCommand(options = {}) {
+    console.log('');
+    console.log('\x1b[36m╔══════════════════════════════════════════════════════════╗\x1b[0m');
+    console.log('\x1b[36m║                                                          ║\x1b[0m');
+    console.log('\x1b[36m║   🔧 Setting up MemoryLink for ALL AI tools              ║\x1b[0m');
+    console.log('\x1b[36m║                                                          ║\x1b[0m');
+    console.log('\x1b[36m╚══════════════════════════════════════════════════════════╝\x1b[0m');
+    console.log('');
+    console.log('\x1b[1m[1/4] Cursor AI\x1b[0m');
+    await setupCursorCommand({ ...options, verbose: false });
+    console.log('\x1b[1m[2/4] Claude\x1b[0m');
+    await setupClaudeCommand({ ...options, verbose: false });
+    console.log('\x1b[1m[3/4] ChatGPT\x1b[0m');
+    await setupChatGPTCommand({ ...options, verbose: false });
+    console.log('\x1b[1m[4/4] GitHub Copilot\x1b[0m');
+    await setupCopilotCommand({ ...options, verbose: false });
+    console.log('');
+    console.log('\x1b[32m╔══════════════════════════════════════════════════════════╗\x1b[0m');
+    console.log('\x1b[32m║                                                          ║\x1b[0m');
+    console.log('\x1b[32m║   ✅ All AI tools configured!                            ║\x1b[0m');
+    console.log('\x1b[32m║                                                          ║\x1b[0m');
+    console.log('\x1b[32m╚══════════════════════════════════════════════════════════╝\x1b[0m');
+    console.log('');
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/snippet.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MemoryLink - Code Snippet Command
+ * Store actual code snippets (not just file references)
+ *
+ * Critical feature: Users need to store reusable code patterns and examples
+ */
+import type { GlobalOptions } from '../types.js';
+interface SnippetOptions extends GlobalOptions {
+    code?: string;
+    file?: string;
+    lines?: string;
+    language?: string;
+    context?: string;
+    tags?: string;
+    force?: boolean;
+}
+/**
+ * Code Snippet Command
+ * Store code snippets in memory.log
+ */
+export declare function snippetCommand(description: string, options?: SnippetOptions): Promise<void>;
+export {};
+//# sourceMappingURL=snippet.d.ts.map

package/dist/commands/snippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../src/commands/snippet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,aAAa,CAAC;AAGrB,UAAU,cAAe,SAAQ,aAAa;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAwGD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsHf"}

package/dist/commands/snippet.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * MemoryLink - Code Snippet Command
+ * Store actual code snippets (not just file references)
+ *
+ * Critical feature: Users need to store reusable code patterns and examples
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snippetCommand = snippetCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const utils_js_1 = require("../utils.js");
+const migrate_js_1 = require("./migrate.js");
+const MAX_SNIPPET_SIZE = 1024; // 1KB limit
+/**
+ * Detect programming language from file extension
+ */
+function detectLanguage(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const languageMap = {
+        '.ts': 'typescript',
+        '.tsx': 'typescript',
+        '.js': 'javascript',
+        '.jsx': 'javascript',
+        '.py': 'python',
+        '.java': 'java',
+        '.go': 'go',
+        '.rs': 'rust',
+        '.cpp': 'cpp',
+        '.c': 'c',
+        '.cs': 'csharp',
+        '.php': 'php',
+        '.rb': 'ruby',
+        '.swift': 'swift',
+        '.kt': 'kotlin',
+        '.scala': 'scala',
+        '.sh': 'bash',
+        '.bash': 'bash',
+        '.zsh': 'bash',
+        '.sql': 'sql',
+        '.html': 'html',
+        '.css': 'css',
+        '.scss': 'scss',
+        '.json': 'json',
+        '.yaml': 'yaml',
+        '.yml': 'yaml',
+        '.xml': 'xml',
+        '.md': 'markdown',
+        '.vue': 'vue',
+        '.svelte': 'svelte',
+    };
+    return languageMap[ext];
+}
+/**
+ * Read code from file, optionally extracting specific lines
+ */
+function readCodeFromFile(filePath, root, lineRange) {
+    const fullPath = path.isAbsolute(filePath) ? filePath : path.join(root, filePath);
+    if (!fs.existsSync(fullPath)) {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    const stats = fs.statSync(fullPath);
+    if (stats.size > 10 * 1024 * 1024) { // 10MB limit
+        throw new Error(`File too large (${Math.round(stats.size / 1024)}KB). Use doc_ref for large files.`);
+    }
+    let content = fs.readFileSync(fullPath, 'utf-8');
+    const language = detectLanguage(filePath);
+    // Extract specific lines if requested
+    if (lineRange) {
+        const lines = content.split('\n');
+        const match = lineRange.match(/^(\d+)(?:-(\d+))?$/);
+        if (!match) {
+            throw new Error(`Invalid line range format. Use: '42' or '42-50'`);
+        }
+        const start = parseInt(match[1], 10) - 1; // Convert to 0-based
+        const end = match[2] ? parseInt(match[2], 10) : start + 1; // End is 1-based
+        if (start < 0 || start >= lines.length) {
+            throw new Error(`Line ${start + 1} is out of range (file has ${lines.length} lines)`);
+        }
+        if (end < start || end > lines.length) {
+            throw new Error(`Line range ${start + 1}-${end} is invalid (file has ${lines.length} lines)`);
+        }
+        content = lines.slice(start, end).join('\n');
+    }
+    return { code: content, language };
+}
+/**
+ * Validate code snippet size
+ */
+function validateCodeSize(code) {
+    const size = Buffer.byteLength(code, 'utf-8');
+    if (size > MAX_SNIPPET_SIZE) {
+        throw new Error(`Code snippet too large (${Math.round(size / 1024 * 100) / 100}KB, max ${MAX_SNIPPET_SIZE / 1024}KB). ` +
+            `Use doc_ref for larger files or split into multiple snippets.`);
+    }
+}
+/**
+ * Code Snippet Command
+ * Store code snippets in memory.log
+ */
+async function snippetCommand(description, options = {}) {
+    const { verbose, code, file, lines, language, context, tags: tagString, force = false } = options;
+    // Validate input
+    if (!description || description.trim().length === 0) {
+        (0, utils_js_1.error)('Description cannot be empty');
+        process.exit(1);
+    }
+    (0, utils_js_1.log)(`Adding code snippet: ${description}`, verbose);
+    // Check initialization
+    const root = (0, utils_js_1.findRoot)();
+    if (!root || !(0, utils_js_1.isInitialized)(root)) {
+        (0, utils_js_1.error)('MemoryLink is not initialized. Run: memorylink init');
+        process.exit(1);
+    }
+    // Check if migration is required
+    if ((0, migrate_js_1.checkMigrationRequired)(root)) {
+        (0, migrate_js_1.showMigrationWarning)();
+        process.exit(1);
+    }
+    // Get code content
+    let codeContent;
+    let detectedLanguage = language;
+    if (code) {
+        // Code provided directly
+        codeContent = code;
+    }
+    else if (file) {
+        // Read from file
+        try {
+            const result = readCodeFromFile(file, root, lines);
+            codeContent = result.code;
+            if (!detectedLanguage && result.language) {
+                detectedLanguage = result.language;
+            }
+        }
+        catch (err) {
+            (0, utils_js_1.error)(`Failed to read file: ${err.message}`);
+            process.exit(1);
+        }
+    }
+    else {
+        (0, utils_js_1.error)('Code required. Use --code "<code>" or --file <path>');
+        process.exit(1);
+    }
+    // Validate code is not empty
+    if (!codeContent || codeContent.trim().length === 0) {
+        (0, utils_js_1.error)('Code cannot be empty');
+        process.exit(1);
+    }
+    // Validate code size
+    try {
+        validateCodeSize(codeContent);
+    }
+    catch (err) {
+        (0, utils_js_1.error)(err.message);
+        process.exit(1);
+    }
+    // Secret detection
+    const contentToCheck = description + ' ' + codeContent;
+    if (!(0, utils_js_1.checkSecretsBeforeWrite)(contentToCheck, force)) {
+        process.exit(1);
+    }
+    const memoryPath = (0, utils_js_1.getFilePath)('MEMORY', root);
+    const tags = (0, utils_js_1.parseTags)(tagString);
+    // Normalize file path for storage (forward slashes, Git-compatible)
+    const normalizedFile = file ? (0, utils_js_1.normalizePathForStorage)(file, root) : undefined;
+    // Create code snippet entry
+    const entry = {
+        id: (0, utils_js_1.generateId)(),
+        ts: (0, utils_js_1.getTimestamp)(),
+        agent: 'user',
+        type: 'code_snippet',
+        details: description,
+        code: codeContent,
+        language: detectedLanguage,
+        file: normalizedFile,
+        lines: lines,
+        context: context,
+        tags,
+        status: 'ACTIVE',
+        forcedSecretCheck: force && (0, utils_js_1.checkSecretsBeforeWrite)(contentToCheck, true) ? true : undefined,
+    };
+    // Append with file locking
+    try {
+        await (0, utils_js_1.appendJsonlEntry)(memoryPath, entry);
+        (0, utils_js_1.success)(`Code snippet added (${Math.round(Buffer.byteLength(codeContent, 'utf-8'))} bytes)`);
+        if (verbose) {
+            (0, utils_js_1.info)(`Language: ${detectedLanguage || 'auto-detected'}`);
+            if (file) {
+                (0, utils_js_1.info)(`File: ${file}${lines ? ` (lines ${lines})` : ''}`);
+            }
+            if (context) {
+                (0, utils_js_1.info)(`Context: ${context}`);
+            }
+        }
+    }
+    catch (err) {
+        (0, utils_js_1.error)(`Failed to add code snippet: ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=snippet.js.map