memorylink 1.0.0

package/dist/commands/learn.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * MemoryLink - Learn Command
+ * Track successful and failed solutions
+ *
+ * v1.0 UPDATE: Now uses JSONL format with file locking and secret detection
+ */
+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.learnCommand = learnCommand;
+exports.listLearningsCommand = listLearningsCommand;
+exports.clearLearningsCommand = clearLearningsCommand;
+const fs = __importStar(require("fs"));
+const utils_js_1 = require("../utils.js");
+const migrate_js_1 = require("./migrate.js");
+const quality_js_1 = require("../utils/quality.js");
+async function learnCommand(problem, solution, options) {
+    const { verbose, status, tags: tagString, reason, force = false } = options;
+    // Validate inputs - reject empty problem/solution
+    if (!problem || problem.trim().length === 0) {
+        (0, utils_js_1.error)('Problem description cannot be empty');
+        process.exit(1);
+    }
+    if (!solution || solution.trim().length === 0) {
+        (0, utils_js_1.error)('Solution description cannot be empty');
+        process.exit(1);
+    }
+    (0, utils_js_1.log)(`Adding learning: ${problem} -> ${solution} (${status})`, 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);
+    }
+    // Validate status
+    if (status !== 'SUCCESS' && status !== 'FAILED') {
+        (0, utils_js_1.error)('Status must be SUCCESS or FAILED');
+        process.exit(1);
+    }
+    // Secret detection at write time (check both problem and solution)
+    const contentToCheck = `${problem} ${solution} ${reason || ''}`;
+    if (!(0, utils_js_1.checkSecretsBeforeWrite)(contentToCheck, force)) {
+        process.exit(1);
+    }
+    const learningsPath = (0, utils_js_1.getFilePath)('LEARNINGS', root);
+    const tags = (0, utils_js_1.parseTags)(tagString);
+    // Create JSONL entry
+    const entry = {
+        id: (0, utils_js_1.generateId)(),
+        ts: (0, utils_js_1.getTimestamp)(),
+        agent: 'user',
+        problem,
+        solution,
+        outcome: status,
+        reason,
+        tags,
+        status: 'ACTIVE',
+        forcedSecretCheck: force ? true : undefined,
+    };
+    // Quality validation (Week 5)
+    const qualityScore = (0, quality_js_1.scoreLearningEntry)(entry);
+    const qualityLevel = (0, quality_js_1.getQualityLevel)(qualityScore.score);
+    if (qualityScore.score < 60) {
+        (0, utils_js_1.warn)(`⚠️  Low quality learning (score: ${qualityScore.score}/100)`);
+        console.log('');
+        console.log((0, quality_js_1.formatQualityScore)(qualityScore));
+        console.log('');
+        // Ask user if they want to proceed (non-interactive: just warn)
+        (0, utils_js_1.warn)('Learning will be saved, but consider improving it for better searchability.');
+        console.log('');
+    }
+    else if (qualityScore.score < 80 && !verbose) {
+        // Show suggestions for good but not excellent entries
+        (0, utils_js_1.info)(`Quality score: ${qualityScore.score}/100 (${qualityLevel})`);
+        if (qualityScore.suggestions.length > 0) {
+            (0, utils_js_1.info)('💡 Suggestions:');
+            qualityScore.suggestions.forEach(suggestion => {
+                (0, utils_js_1.info)(`   ${suggestion}`);
+            });
+            console.log('');
+        }
+    }
+    // Append with file locking
+    try {
+        await (0, utils_js_1.appendJsonlEntry)(learningsPath, entry);
+        if (status === 'SUCCESS') {
+            (0, utils_js_1.success)(`Learning added - SUCCESS (${(0, utils_js_1.shortId)(entry.id)})`);
+        }
+        else {
+            (0, utils_js_1.warn)(`Learning added - FAILED (${(0, utils_js_1.shortId)(entry.id)})`);
+        }
+        if (verbose) {
+            (0, utils_js_1.info)(`Entry: ${JSON.stringify(entry)}`);
+        }
+    }
+    catch (err) {
+        (0, utils_js_1.error)(`Failed to add learning: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        process.exit(1);
+    }
+}
+async function listLearningsCommand(options = {}) {
+    const { verbose, limit = 20, tag, since, status, json } = options;
+    (0, utils_js_1.log)('Listing learnings', 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);
+    }
+    const learningsPath = (0, utils_js_1.getFilePath)('LEARNINGS', root);
+    // Check format and suggest migration if needed
+    if (!(0, utils_js_1.isJsonlFormat)(learningsPath)) {
+        (0, utils_js_1.warn)('Legacy format detected. Run: memorylink migrate');
+        console.log('');
+        // Fall back to legacy display
+        await listLearningsLegacy(learningsPath, limit, status, tag);
+        return;
+    }
+    // Read JSONL entries
+    let entries = (0, utils_js_1.readJsonlEntries)(learningsPath);
+    // Apply filters
+    if (tag) {
+        entries = (0, utils_js_1.filterByTag)(entries, tag);
+    }
+    if (since) {
+        entries = (0, utils_js_1.filterBySince)(entries, since);
+    }
+    if (status) {
+        // Filter by outcome (SUCCESS/FAILED)
+        entries = entries.filter(e => e.outcome === status);
+    }
+    // Only show ACTIVE entries by default
+    entries = entries.filter(e => e.status === 'ACTIVE');
+    if (entries.length === 0) {
+        (0, utils_js_1.info)('No learnings found');
+        console.log('');
+        console.log('Add learnings with: memorylink learn "problem" "solution" --status SUCCESS');
+        return;
+    }
+    // Count successes and failures
+    const successCount = entries.filter(e => e.outcome === 'SUCCESS').length;
+    const failedCount = entries.filter(e => e.outcome === 'FAILED').length;
+    // Sort by timestamp (newest last)
+    entries.sort((a, b) => new Date(a.ts).getTime() - new Date(b.ts).getTime());
+    // Get last N entries
+    const displayEntries = entries.slice(-limit);
+    // JSON output
+    if (json) {
+        console.log(JSON.stringify(displayEntries, null, 2));
+        return;
+    }
+    // Human-readable output
+    console.log('');
+    (0, utils_js_1.info)(`Learnings (${successCount} ✓ success, ${failedCount} ✗ failed):`);
+    console.log('');
+    for (const entry of displayEntries) {
+        const date = new Date(entry.ts);
+        const shortDate = date.toLocaleDateString() + ' ' + date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+        const isSuccess = entry.outcome === 'SUCCESS';
+        const statusColor = isSuccess ? '\x1b[32m' : '\x1b[31m';
+        const statusIcon = isSuccess ? '✓' : '✗';
+        const tagsStr = entry.tags?.length ? `\x1b[36m[${entry.tags.join(', ')}]\x1b[0m` : '';
+        const idStr = `\x1b[90m(${(0, utils_js_1.shortId)(entry.id)})\x1b[0m`;
+        console.log(`   \x1b[90m${shortDate}\x1b[0m ${statusColor}${statusIcon}\x1b[0m ${entry.problem}`);
+        console.log(`              → ${entry.solution} ${tagsStr} ${idStr}`);
+        if (entry.reason) {
+            console.log(`              \x1b[90m(${entry.reason})\x1b[0m`);
+        }
+    }
+    console.log('');
+    if (entries.length > limit) {
+        (0, utils_js_1.info)(`Showing ${limit} of ${entries.length}. Use --limit to see more.`);
+    }
+}
+/**
+ * Legacy format display (for pre-migration compatibility)
+ */
+async function listLearningsLegacy(learningsPath, limit, status, tag) {
+    const content = fs.readFileSync(learningsPath, 'utf-8');
+    let entries = content.split('\n').filter(line => line.trim() && !line.startsWith('#'));
+    // Filter by status if specified
+    if (status) {
+        entries = entries.filter(entry => entry.includes(`[${status}]`) || entry.includes(`${status}]`));
+    }
+    // Filter by tag if specified
+    if (tag) {
+        entries = entries.filter(entry => entry.toLowerCase().includes(`[${tag.toLowerCase()}`));
+    }
+    if (entries.length === 0) {
+        (0, utils_js_1.info)('No learnings found');
+        console.log('');
+        console.log('Add learnings with: memorylink learn "problem" "solution" --status SUCCESS');
+        return;
+    }
+    // Count successes and failures
+    const successCount = entries.filter(e => e.includes('SUCCESS')).length;
+    const failedCount = entries.filter(e => e.includes('FAILED')).length;
+    // Get last N entries
+    const displayEntries = entries.slice(-limit);
+    console.log('');
+    (0, utils_js_1.info)(`Learnings (${successCount} ✓ success, ${failedCount} ✗ failed):`);
+    console.log('');
+    for (const entry of displayEntries) {
+        // Parse legacy entry
+        const match = entry.match(/\[(.*?)\]\s*\[(.*?)\]\s*(.+?)\s*->\s*(.+?)(\s*\[.*\])?$/);
+        if (match) {
+            const [, timestamp, statusPart, problem, solution, tags] = match;
+            const date = new Date(timestamp);
+            const shortDate = date.toLocaleDateString() + ' ' + date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+            const isSuccess = statusPart.includes('SUCCESS');
+            const statusColor = isSuccess ? '\x1b[32m' : '\x1b[31m';
+            const statusIcon = isSuccess ? '✓' : '✗';
+            console.log(`   \x1b[90m${shortDate}\x1b[0m ${statusColor}${statusIcon}\x1b[0m ${problem}`);
+            console.log(`              → ${solution}\x1b[36m${tags || ''}\x1b[0m`);
+        }
+        else {
+            console.log(`   ${entry}`);
+        }
+    }
+    console.log('');
+    if (entries.length > limit) {
+        (0, utils_js_1.info)(`Use --limit to see more entries`);
+    }
+}
+async function clearLearningsCommand(options = {}) {
+    const { verbose } = options;
+    (0, utils_js_1.log)('Clearing learnings log', 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);
+    }
+    const learningsPath = (0, utils_js_1.getFilePath)('LEARNINGS', root);
+    // Clear to empty file (JSONL format - no header needed)
+    try {
+        fs.writeFileSync(learningsPath, '');
+        (0, utils_js_1.success)('Learnings log cleared');
+    }
+    catch (err) {
+        (0, utils_js_1.error)(`Failed to clear learnings: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=learn.js.map

package/dist/commands/learn.js.map

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

package/dist/commands/lock.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MemoryLink - Lock Command (v1.5)
+ * Agent locking to prevent multi-agent conflicts
+ */
+import type { GlobalOptions } from '../types.js';
+export interface LockOptions extends GlobalOptions {
+    agent?: string;
+    files?: string;
+    timeout?: number;
+}
+/**
+ * Acquire a lock
+ */
+export declare function lockAcquireCommand(options?: LockOptions): Promise<void>;
+/**
+ * Release a lock
+ */
+export declare function lockReleaseCommand(options?: GlobalOptions): Promise<void>;
+/**
+ * Show lock status
+ */
+export declare function lockStatusCommand(options?: GlobalOptions): Promise<void>;
+/**
+ * Renew a lock (extend timeout)
+ */
+export declare function lockRenewCommand(options?: LockOptions): Promise<void>;
+/**
+ * Check if lock exists and is valid (for preflight integration)
+ */
+export declare function checkLock(root: string): {
+    locked: boolean;
+    agentId?: string;
+    expiresAt?: Date;
+};
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/commands/lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA8Gf;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAAE,CA4B/F"}

package/dist/commands/lock.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * MemoryLink - Lock Command (v1.5)
+ * Agent locking to prevent multi-agent conflicts
+ */
+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.lockAcquireCommand = lockAcquireCommand;
+exports.lockReleaseCommand = lockReleaseCommand;
+exports.lockStatusCommand = lockStatusCommand;
+exports.lockRenewCommand = lockRenewCommand;
+exports.checkLock = checkLock;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const utils_js_1 = require("../utils.js");
+const types_js_1 = require("../types.js");
+const DEFAULT_TIMEOUT_MINUTES = 30;
+/**
+ * Acquire a lock
+ */
+async function lockAcquireCommand(options = {}) {
+    // TODO v1.6: Record telemetry event (command start)
+    // import { recordEvent, checkIsGitRepo, checkHasConfig, getErrorKind } from '../telemetry.js';
+    // await recordEvent({
+    //   command: 'lock',
+    //   result: 'success', // Will be updated to 'error' if command fails
+    //   flags: { acquire: true, timeout: options.timeout },
+    //   isGitRepo: checkIsGitRepo(),
+    //   hasConfig: checkHasConfig(),
+    // });
+    const root = (0, utils_js_1.findRoot)();
+    if (!root || !(0, utils_js_1.isInitialized)(root)) {
+        // TODO v1.6: Record telemetry event (command error)
+        // await recordEvent({
+        //   command: 'lock',
+        //   result: 'error',
+        //   exitCode: 1,
+        //   errorKind: 'NOT_INITIALIZED',
+        //   isGitRepo: checkIsGitRepo(),
+        //   hasConfig: checkHasConfig(),
+        // });
+        (0, utils_js_1.error)('MemoryLink is not initialized. Run: memorylink init');
+        process.exit(1);
+    }
+    // Get timeout from config or use default (v1.5 Phase 2 enhancement)
+    const config = (0, utils_js_1.readConfig)(root);
+    const configTimeout = config?.lockTimeoutMinutes;
+    const defaultTimeout = configTimeout || DEFAULT_TIMEOUT_MINUTES;
+    const { verbose, agent, files, timeout = defaultTimeout } = options;
+    (0, utils_js_1.log)('Acquiring lock', verbose);
+    const lockPath = path.join(root, types_js_1.MEMORYLINK_DIR, '.lock');
+    // Check for existing lock
+    if (fs.existsSync(lockPath)) {
+        try {
+            const lockData = JSON.parse(fs.readFileSync(lockPath, 'utf-8'));
+            const expiresAt = new Date(lockData.expiresAt);
+            const now = new Date();
+            if (now < expiresAt) {
+                // Lock is still valid
+                (0, utils_js_1.error)(`Lock already held by agent: ${lockData.agentId}`);
+                (0, utils_js_1.info)(`  Expires at: ${expiresAt.toLocaleString()}`);
+                if (lockData.files && lockData.files.length > 0) {
+                    (0, utils_js_1.info)(`  Files: ${lockData.files.join(', ')}`);
+                }
+                process.exit(1);
+            }
+            else {
+                // Lock expired, remove it
+                (0, utils_js_1.warn)('Existing lock expired, removing...');
+                fs.unlinkSync(lockPath);
+            }
+        }
+        catch {
+            // Invalid lock file, remove it
+            (0, utils_js_1.warn)('Invalid lock file, removing...');
+            fs.unlinkSync(lockPath);
+        }
+    }
+    // Generate agent ID if not provided
+    const agentId = agent || `agent-${Date.now()}`;
+    // Parse files if provided
+    const fileList = files ? files.split(',').map(f => f.trim()) : undefined;
+    // Get Git info if available
+    let branch;
+    let commit;
+    try {
+        const { execSync } = await import('child_process');
+        branch = execSync('git rev-parse --abbrev-ref HEAD', {
+            cwd: root,
+            encoding: 'utf-8'
+        }).trim();
+        commit = execSync('git rev-parse HEAD', {
+            cwd: root,
+            encoding: 'utf-8'
+        }).trim();
+    }
+    catch {
+        // Git not available, continue without
+    }
+    // Create lock
+    const now = new Date();
+    const expiresAt = new Date(now.getTime() + timeout * 60 * 1000);
+    const lockData = {
+        agentId,
+        files: fileList,
+        timestamp: (0, utils_js_1.getTimestamp)(),
+        expiresAt: expiresAt.toISOString(),
+        branch,
+        commit,
+    };
+    fs.writeFileSync(lockPath, JSON.stringify(lockData, null, 2));
+    (0, utils_js_1.success)(`Lock acquired by: ${agentId}`);
+    (0, utils_js_1.info)(`  Expires at: ${expiresAt.toLocaleString()}`);
+    if (fileList && fileList.length > 0) {
+        (0, utils_js_1.info)(`  Files: ${fileList.join(', ')}`);
+    }
+    if (branch) {
+        (0, utils_js_1.info)(`  Branch: ${branch}`);
+    }
+}
+/**
+ * Release a lock
+ */
+async function lockReleaseCommand(options = {}) {
+    const { verbose } = options;
+    (0, utils_js_1.log)('Releasing lock', verbose);
+    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);
+    }
+    const lockPath = path.join(root, types_js_1.MEMORYLINK_DIR, '.lock');
+    if (!fs.existsSync(lockPath)) {
+        (0, utils_js_1.warn)('No lock found');
+        return;
+    }
+    fs.unlinkSync(lockPath);
+    (0, utils_js_1.success)('Lock released');
+}
+/**
+ * Show lock status
+ */
+async function lockStatusCommand(options = {}) {
+    const { verbose } = options;
+    (0, utils_js_1.log)('Checking lock status', verbose);
+    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);
+    }
+    const lockPath = path.join(root, types_js_1.MEMORYLINK_DIR, '.lock');
+    if (!fs.existsSync(lockPath)) {
+        (0, utils_js_1.info)('No lock active');
+        return;
+    }
+    try {
+        const lockData = JSON.parse(fs.readFileSync(lockPath, 'utf-8'));
+        const expiresAt = new Date(lockData.expiresAt);
+        const now = new Date();
+        const isExpired = now >= expiresAt;
+        console.log('');
+        console.log('\x1b[1m🔒 Lock Status\x1b[0m');
+        console.log('');
+        if (isExpired) {
+            (0, utils_js_1.warn)('Lock expired (but not released)');
+            console.log(`  Expired at: ${expiresAt.toLocaleString()}`);
+        }
+        else {
+            const remaining = Math.round((expiresAt.getTime() - now.getTime()) / 1000 / 60);
+            (0, utils_js_1.success)('Lock active');
+            console.log(`  Agent: ${lockData.agentId}`);
+            console.log(`  Expires in: ${remaining} minutes`);
+            console.log(`  Expires at: ${expiresAt.toLocaleString()}`);
+        }
+        if (lockData.files && lockData.files.length > 0) {
+            console.log(`  Files: ${lockData.files.join(', ')}`);
+        }
+        if (lockData.branch) {
+            console.log(`  Branch: ${lockData.branch}`);
+        }
+        if (lockData.commit) {
+            console.log(`  Commit: ${lockData.commit.substring(0, 8)}`);
+        }
+        console.log('');
+    }
+    catch (err) {
+        (0, utils_js_1.error)(`Invalid lock file: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+/**
+ * Renew a lock (extend timeout)
+ */
+async function lockRenewCommand(options = {}) {
+    const { verbose, timeout = DEFAULT_TIMEOUT_MINUTES } = options;
+    (0, utils_js_1.log)('Renewing lock', verbose);
+    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);
+    }
+    const lockPath = path.join(root, types_js_1.MEMORYLINK_DIR, '.lock');
+    if (!fs.existsSync(lockPath)) {
+        (0, utils_js_1.error)('No lock found to renew');
+        process.exit(1);
+    }
+    // Load existing lock
+    let lockData;
+    try {
+        lockData = JSON.parse(fs.readFileSync(lockPath, 'utf-8'));
+        const expiresAt = new Date(lockData.expiresAt);
+        const now = new Date();
+        if (now >= expiresAt) {
+            (0, utils_js_1.error)('Lock has expired. Acquire a new lock instead.');
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        (0, utils_js_1.error)(`Invalid lock file: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    // Extend expiry time
+    const now = new Date();
+    const newExpiresAt = new Date(now.getTime() + timeout * 60 * 1000);
+    lockData.expiresAt = newExpiresAt.toISOString();
+    lockData.timestamp = (0, utils_js_1.getTimestamp)();
+    fs.writeFileSync(lockPath, JSON.stringify(lockData, null, 2));
+    // Log renewal to observability
+    try {
+        const { logBuddyCheckRun } = await import('../utils/observability.js');
+        logBuddyCheckRun({
+            status: 'GREEN',
+            summary: `Lock renewed by ${lockData.agentId}`,
+            issues: [],
+            timestamp: new Date().toISOString(),
+            runType: 'preflight',
+            agentId: lockData.agentId,
+        }, root);
+    }
+    catch {
+        // Observability logging is optional
+    }
+    (0, utils_js_1.success)(`Lock renewed by: ${lockData.agentId}`);
+    (0, utils_js_1.info)(`  New expiry: ${newExpiresAt.toLocaleString()}`);
+    (0, utils_js_1.info)(`  Extended by: ${timeout} minutes`);
+}
+/**
+ * Check if lock exists and is valid (for preflight integration)
+ */
+function checkLock(root) {
+    const lockPath = path.join(root, types_js_1.MEMORYLINK_DIR, '.lock');
+    if (!fs.existsSync(lockPath)) {
+        return { locked: false };
+    }
+    try {
+        const lockData = JSON.parse(fs.readFileSync(lockPath, 'utf-8'));
+        const expiresAt = new Date(lockData.expiresAt);
+        const now = new Date();
+        if (now >= expiresAt) {
+            // Expired, remove it
+            fs.unlinkSync(lockPath);
+            return { locked: false };
+        }
+        return {
+            locked: true,
+            agentId: lockData.agentId,
+            expiresAt,
+        };
+    }
+    catch {
+        // Invalid lock file, remove it
+        fs.unlinkSync(lockPath);
+        return { locked: false };
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/commands/lock.js.map

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