memorylink 1.0.0

package/dist/telemetry.test.js

@@ -0,0 +1,324 @@
+"use strict";
+/**
+ * MemoryLink - Telemetry System Unit Tests
+ *
+ * Tests for privacy-safe telemetry event construction and error handling.
+ *
+ * These tests verify that:
+ * - Only safe, high-level data can be included in events
+ * - Forbidden fields (paths, code, secrets) cannot be added
+ * - Error categorization returns only safe categories
+ * - Telemetry operations are non-blocking and resilient
+ */
+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 });
+const globals_1 = require("@jest/globals");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const telemetry_js_1 = require("./telemetry.js");
+const types_js_1 = require("./types.js");
+// Mock utilities
+jest.mock('./utils.js', () => ({
+    findRoot: jest.fn(),
+    readConfig: jest.fn(),
+    getFilePath: jest.fn(),
+}));
+(0, globals_1.describe)('Telemetry System - Privacy & Safety Tests', () => {
+    let testRoot;
+    let telemetryLogPath;
+    (0, globals_1.beforeEach)(() => {
+        // Set up test environment
+        testRoot = '/tmp/memorylink-test';
+        telemetryLogPath = path.join(testRoot, types_js_1.MEMORYLINK_DIR, 'telemetry.log');
+        // Mock findRoot to return test directory
+        require('./utils.js').findRoot.mockReturnValue(testRoot);
+        // Create test directory structure
+        if (!fs.existsSync(path.join(testRoot, types_js_1.MEMORYLINK_DIR))) {
+            fs.mkdirSync(path.join(testRoot, types_js_1.MEMORYLINK_DIR), { recursive: true });
+        }
+    });
+    (0, globals_1.afterEach)(() => {
+        // Clean up test files
+        if (fs.existsSync(telemetryLogPath)) {
+            fs.unlinkSync(telemetryLogPath);
+        }
+    });
+    (0, globals_1.describe)('getErrorKind - Privacy Safety', () => {
+        (0, globals_1.it)('should return safe error category for file path errors', () => {
+            const err = new Error('File not found: /path/to/secret.txt');
+            const kind = (0, telemetry_js_1.getErrorKind)(err);
+            (0, globals_1.expect)(kind).toBe('FILE_NOT_FOUND');
+            (0, globals_1.expect)(kind).not.toContain('/path/to/secret.txt');
+            (0, globals_1.expect)(kind).not.toContain('secret');
+        });
+        (0, globals_1.it)('should return safe error category for config errors', () => {
+            const err = new Error('Config missing: /home/user/.memorylink/config.json');
+            const kind = (0, telemetry_js_1.getErrorKind)(err);
+            (0, globals_1.expect)(kind).toBe('CONFIG_INVALID');
+            (0, globals_1.expect)(kind).not.toContain('/home/user');
+            (0, globals_1.expect)(kind).not.toContain('.memorylink');
+        });
+        (0, globals_1.it)('should return safe error category for git errors', () => {
+            const err = new Error('Not a git repository: /repo/path');
+            const kind = (0, telemetry_js_1.getErrorKind)(err);
+            (0, globals_1.expect)(kind).toBe('NOT_GIT_REPO');
+            (0, globals_1.expect)(kind).not.toContain('/repo/path');
+        });
+        (0, globals_1.it)('should return safe error category for lock errors', () => {
+            const err = new Error('Lock acquire failed for agent: cursor');
+            const kind = (0, telemetry_js_1.getErrorKind)(err);
+            (0, globals_1.expect)(kind).toBe('LOCK_ACQUIRE_FAILED');
+            // Agent name is safe, but verify no paths
+            (0, globals_1.expect)(kind).not.toContain('/');
+        });
+        (0, globals_1.it)('should return UNEXPECTED_ERROR for unknown errors', () => {
+            const err = new Error('Some random error');
+            const kind = (0, telemetry_js_1.getErrorKind)(err);
+            (0, globals_1.expect)(kind).toBe('UNEXPECTED_ERROR');
+        });
+        (0, globals_1.it)('should handle errors with stack traces safely', () => {
+            const err = new Error('Test error');
+            err.stack = `Error: Test error
+        at /path/to/file.ts:42:10
+        at /another/path.ts:100:5`;
+            const kind = (0, telemetry_js_1.getErrorKind)(err);
+            // Should return a safe category, not include stack trace
+            (0, globals_1.expect)(['UNEXPECTED_ERROR', 'UNKNOWN']).toContain(kind);
+            (0, globals_1.expect)(kind).not.toContain('/path/to/file.ts');
+            (0, globals_1.expect)(kind).not.toContain('42:10');
+        });
+    });
+    (0, globals_1.describe)('TelemetryEvent - Type Safety', () => {
+        (0, globals_1.it)('should only allow safe fields in TelemetryEvent', () => {
+            const event = {
+                command: 'stats',
+                result: 'success',
+                exitCode: 0,
+                memorylinkVersion: '1.5.1',
+                nodeVersion: '18.17.0',
+                os: 'darwin',
+                isGitRepo: true,
+                hasConfig: true,
+                timestamp: new Date().toISOString(),
+                flags: { format: 'json' },
+            };
+            // TypeScript should prevent adding forbidden fields
+            // This test verifies the type system works
+            (0, globals_1.expect)(event.command).toBe('stats');
+            (0, globals_1.expect)(event.result).toBe('success');
+            (0, globals_1.expect)('filePath' in event).toBe(false);
+            (0, globals_1.expect)('code' in event).toBe(false);
+            (0, globals_1.expect)('secret' in event).toBe(false);
+        });
+        (0, globals_1.it)('should only allow safe error kinds', () => {
+            const safeKinds = [
+                'NOT_INITIALIZED',
+                'NOT_GIT_REPO',
+                'CONFIG_MISSING',
+                'LOCK_HELD',
+                'FILE_NOT_FOUND',
+                'UNEXPECTED_ERROR',
+            ];
+            safeKinds.forEach(kind => {
+                const event = {
+                    command: 'test',
+                    result: 'error',
+                    errorKind: kind,
+                    memorylinkVersion: '1.5.1',
+                    nodeVersion: '18.17.0',
+                    os: 'darwin',
+                    timestamp: new Date().toISOString(),
+                };
+                (0, globals_1.expect)(event.errorKind).toBe(kind);
+            });
+        });
+        (0, globals_1.it)('should prevent arbitrary strings in errorKind', () => {
+            // TypeScript should prevent this at compile time
+            // This test documents the expected behavior
+            const event = {
+                command: 'test',
+                result: 'error',
+                errorKind: 'NOT_INITIALIZED', // Only allowed values
+                memorylinkVersion: '1.5.1',
+                nodeVersion: '18.17.0',
+                os: 'darwin',
+                timestamp: new Date().toISOString(),
+            };
+            // errorKind should be constrained to ErrorKind union type
+            (0, globals_1.expect)(typeof event.errorKind).toBe('string');
+            (0, globals_1.expect)(['NOT_INITIALIZED', 'NOT_GIT_REPO', 'CONFIG_MISSING', 'LOCK_HELD', 'FILE_NOT_FOUND', 'UNEXPECTED_ERROR', 'UNKNOWN']).toContain(event.errorKind);
+        });
+    });
+    (0, globals_1.describe)('recordEvent - Privacy Compliance', () => {
+        (0, globals_1.beforeEach)(() => {
+            // Mock config to enable telemetry
+            require('./utils.js').readConfig.mockReturnValue({
+                telemetry: { enabled: true },
+                version: '1.5.1',
+            });
+        });
+        (0, globals_1.it)('should not include file paths in logged events', async () => {
+            await (0, telemetry_js_1.recordEvent)({
+                command: 'test',
+                result: 'success',
+                isGitRepo: true,
+                hasConfig: true,
+            });
+            // Read telemetry log
+            const logContent = fs.readFileSync(telemetryLogPath, 'utf-8');
+            const event = JSON.parse(logContent.trim());
+            // Verify no paths
+            (0, globals_1.expect)(JSON.stringify(event)).not.toMatch(/\/[a-zA-Z0-9\/_-]+/);
+            (0, globals_1.expect)(event.command).toBe('test');
+        });
+        (0, globals_1.it)('should not include code snippets in logged events', async () => {
+            await (0, telemetry_js_1.recordEvent)({
+                command: 'test',
+                result: 'success',
+                flags: { test: true },
+            });
+            const logContent = fs.readFileSync(telemetryLogPath, 'utf-8');
+            const event = JSON.parse(logContent.trim());
+            // Verify no code-like patterns
+            (0, globals_1.expect)(JSON.stringify(event)).not.toMatch(/function|const|let|var|class/);
+        });
+        (0, globals_1.it)('should not include secrets in logged events', async () => {
+            await (0, telemetry_js_1.recordEvent)({
+                command: 'test',
+                result: 'success',
+                flags: { apiKey: 'should-not-appear' },
+            });
+            const logContent = fs.readFileSync(telemetryLogPath, 'utf-8');
+            const event = JSON.parse(logContent.trim());
+            // Note: flags can contain strings, but we verify no secret-like patterns
+            // In practice, flags should only contain safe values
+            (0, globals_1.expect)(event.flags).toBeDefined();
+        });
+        (0, globals_1.it)('should only include safe, high-level data', async () => {
+            await (0, telemetry_js_1.recordEvent)({
+                command: 'doctor',
+                result: 'success',
+                exitCode: 0,
+                flags: { preflight: true, json: false },
+                isGitRepo: true,
+                hasConfig: true,
+            });
+            const logContent = fs.readFileSync(telemetryLogPath, 'utf-8');
+            const event = JSON.parse(logContent.trim());
+            // Verify only safe fields are present
+            (0, globals_1.expect)(event.command).toBe('doctor');
+            (0, globals_1.expect)(event.result).toBe('success');
+            (0, globals_1.expect)(event.exitCode).toBe(0);
+            (0, globals_1.expect)(event.memorylinkVersion).toBe('1.5.1');
+            (0, globals_1.expect)(event.os).toBeDefined();
+            (0, globals_1.expect)(event.nodeVersion).toBeDefined();
+            (0, globals_1.expect)(event.timestamp).toBeDefined();
+            (0, globals_1.expect)(event.isGitRepo).toBe(true);
+            (0, globals_1.expect)(event.hasConfig).toBe(true);
+            // Verify forbidden fields are NOT present
+            (0, globals_1.expect)(event.filePath).toBeUndefined();
+            (0, globals_1.expect)(event.code).toBeUndefined();
+            (0, globals_1.expect)(event.secret).toBeUndefined();
+            (0, globals_1.expect)(event.stackTrace).toBeUndefined();
+        });
+    });
+    (0, globals_1.describe)('recordEvent - Non-Blocking Behavior', () => {
+        (0, globals_1.it)('should not throw errors when telemetry fails', async () => {
+            // Mock config to enable telemetry
+            require('./utils.js').readConfig.mockReturnValue({
+                telemetry: { enabled: true },
+                version: '1.5.1',
+            });
+            // Mock fs.appendFileSync to throw
+            const originalAppendFileSync = fs.appendFileSync;
+            fs.appendFileSync = jest.fn().mockImplementation(() => {
+                throw new Error('Disk full');
+            });
+            // Should not throw
+            await (0, globals_1.expect)((0, telemetry_js_1.recordEvent)({
+                command: 'test',
+                result: 'success',
+            })).resolves.not.toThrow();
+            // Restore
+            fs.appendFileSync = originalAppendFileSync;
+        });
+        (0, globals_1.it)('should silently return when telemetry is disabled', async () => {
+            // Mock config to disable telemetry
+            require('./utils.js').readConfig.mockReturnValue({
+                telemetry: { enabled: false },
+                version: '1.5.1',
+            });
+            await (0, telemetry_js_1.recordEvent)({
+                command: 'test',
+                result: 'success',
+            });
+            // Should not create log file
+            (0, globals_1.expect)(fs.existsSync(telemetryLogPath)).toBe(false);
+        });
+        (0, globals_1.it)('should handle missing config gracefully', async () => {
+            // Mock config to return null
+            require('./utils.js').readConfig.mockReturnValue(null);
+            await (0, globals_1.expect)((0, telemetry_js_1.recordEvent)({
+                command: 'test',
+                result: 'success',
+            })).resolves.not.toThrow();
+            // Should not create log file
+            (0, globals_1.expect)(fs.existsSync(telemetryLogPath)).toBe(false);
+        });
+    });
+    (0, globals_1.describe)('Helper Functions', () => {
+        (0, globals_1.it)('checkIsGitRepo should return boolean only', () => {
+            const result = (0, telemetry_js_1.checkIsGitRepo)();
+            (0, globals_1.expect)(typeof result).toBe('boolean');
+            // Should not return path
+            (0, globals_1.expect)(typeof result).not.toBe('string');
+        });
+        (0, globals_1.it)('checkHasConfig should return boolean only', () => {
+            const result = (0, telemetry_js_1.checkHasConfig)();
+            (0, globals_1.expect)(typeof result).toBe('boolean');
+            // Should not return path
+            (0, globals_1.expect)(typeof result).not.toBe('string');
+        });
+        (0, globals_1.it)('isTelemetryEnabled should return boolean', () => {
+            // Mock config
+            require('./utils.js').readConfig.mockReturnValue({
+                telemetry: { enabled: true },
+            });
+            const result = (0, telemetry_js_1.isTelemetryEnabled)();
+            (0, globals_1.expect)(typeof result).toBe('boolean');
+        });
+    });
+});
+//# sourceMappingURL=telemetry.test.js.map

package/dist/telemetry.test.js.map

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

package/dist/test-runner/TestRunner.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Professional Test Runner for MemoryLink
+ * Supports parallel execution, progress tracking, and comprehensive reporting
+ */
+export interface TestScenario {
+    id: number;
+    description: string;
+    command: string;
+    expectedResult: 'pass' | 'fail';
+    category: string;
+    batch: number;
+}
+export interface TestResult {
+    scenario: TestScenario;
+    passed: boolean;
+    duration: number;
+    output?: string;
+    error?: string;
+}
+export interface TestSuiteResult {
+    total: number;
+    passed: number;
+    failed: number;
+    duration: number;
+    passRate: number;
+    results: TestResult[];
+    failures: TestResult[];
+}
+export declare class TestRunner {
+    private scenarios;
+    private results;
+    private maxConcurrency;
+    private verbose;
+    private checkpointFile;
+    private resumeMode;
+    constructor(maxConcurrency?: number, verbose?: boolean, checkpointFile?: string, resumeMode?: boolean);
+    /**
+     * Load scenarios from generated test file
+     */
+    loadScenarios(filePath: string): Promise<void>;
+    /**
+     * Save checkpoint for resume capability
+     */
+    private saveCheckpoint;
+    /**
+     * Load checkpoint for resume
+     */
+    private loadCheckpoint;
+    /**
+     * Execute a single test scenario (optimized for large scale)
+     */
+    executeScenario(scenario: TestScenario): Promise<TestResult>;
+    /**
+     * Execute scenarios in parallel batches (optimized for 10K-20K scenarios)
+     */
+    executeParallel(scenarios: TestScenario[]): Promise<TestResult[]>;
+    /**
+     * Run all scenarios (optimized for 10K-20K scenarios)
+     */
+    runAll(): Promise<TestSuiteResult>;
+    /**
+     * Generate comprehensive report
+     */
+    generateReport(result: TestSuiteResult, outputPath: string): Promise<void>;
+    private groupByCategory;
+    private groupByBatch;
+}
+//# sourceMappingURL=TestRunner.d.ts.map

package/dist/test-runner/TestRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestRunner.d.ts","sourceRoot":"","sources":["../../src/test-runner/TestRunner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAU;gBAG1B,cAAc,GAAE,MAAW,EAC3B,OAAO,GAAE,OAAe,EACxB,cAAc,CAAC,EAAE,MAAM,EACvB,UAAU,GAAE,OAAe;IAQ7B;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDpD;;OAEG;YACW,cAAc;IAc5B;;OAEG;YACW,cAAc;IAa5B;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAyDlE;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsFvE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAsDxC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BhF,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,YAAY;CAiBrB"}