memorylink 1.0.0

package/src/test-runner/run-tests.ts

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+/**
+ * Professional Test Runner CLI
+ * Usage: npx tsx src/test-runner/run-tests.ts [options]
+ */
+
+import { TestRunner } from './TestRunner.js';
+import * as path from 'path';
+import * as fs from 'fs/promises';
+
+interface Options {
+  scenariosFile?: string;
+  concurrency?: number;
+  verbose?: boolean;
+  output?: string;
+  batch?: number;
+  resume?: boolean;
+  checkpoint?: string;
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const options: Options = {
+    scenariosFile: '4000_HARD_SCENARIOS.sh',
+    concurrency: 20, // Increased default for better performance
+    verbose: false,
+    output: 'test-results.json',
+    resume: false,
+    checkpoint: '.test-checkpoint.json',
+  };
+
+  // Parse arguments
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--file' || args[i] === '-f') {
+      options.scenariosFile = args[++i];
+    } else if (args[i] === '--concurrency' || args[i] === '-c') {
+      options.concurrency = parseInt(args[++i]) || 10;
+    } else if (args[i] === '--verbose' || args[i] === '-v') {
+      options.verbose = true;
+    } else if (args[i] === '--output' || args[i] === '-o') {
+      options.output = args[++i];
+    } else if (args[i] === '--batch' || args[i] === '-b') {
+      options.batch = parseInt(args[++i]);
+    } else if (args[i] === '--resume' || args[i] === '-r') {
+      options.resume = true;
+      i++;
+    } else if (args[i] === '--checkpoint' || args[i] === '-c') {
+      options.checkpoint = args[++i];
+    } else if (args[i] === '--help' || args[i] === '-h') {
+      console.log(`
+MemoryLink Professional Test Runner
+
+Usage: npx tsx src/test-runner/run-tests.ts [options]
+
+Options:
+  -f, --file <path>        Path to scenarios file (default: 4000_HARD_SCENARIOS.sh)
+  -c, --concurrency <num>  Number of parallel tests (default: 10)
+  -v, --verbose            Show detailed output for each test
+  -o, --output <path>      Output file for JSON report (default: test-results.json)
+  -b, --batch <num>        Run only specific batch (1-8)
+  -r, --resume             Resume from last checkpoint
+  -c, --checkpoint <path>  Checkpoint file path
+  -h, --help               Show this help message
+
+Examples:
+  npx tsx src/test-runner/run-tests.ts
+  npx tsx src/test-runner/run-tests.ts --concurrency 20 --batch 3
+  npx tsx src/test-runner/run-tests.ts --verbose --output results.json
+`);
+      process.exit(0);
+    }
+  }
+
+  console.log('═══════════════════════════════════════════════════════════════════════════════');
+  console.log('  🧪 MemoryLink Professional Test Runner');
+  console.log('═══════════════════════════════════════════════════════════════════════════════');
+  console.log('');
+
+  const runner = new TestRunner(
+    options.concurrency,
+    options.verbose,
+    options.checkpoint,
+    options.resume || false
+  );
+
+  try {
+    // Load scenarios
+    const scenariosPath = path.resolve(process.cwd(), options.scenariosFile!);
+    console.log(`📂 Loading scenarios from: ${scenariosPath}`);
+    await runner.loadScenarios(scenariosPath);
+
+    // Filter by batch if specified
+    if (options.batch) {
+      const allScenarios = (runner as any).scenarios;
+      (runner as any).scenarios = allScenarios.filter((s: any) => s.batch === options.batch);
+      console.log(`📦 Filtered to Batch ${options.batch}: ${(runner as any).scenarios.length} scenarios`);
+    }
+
+    // Run tests
+    const result = await runner.runAll();
+
+    // Display results
+    console.log('\n═══════════════════════════════════════════════════════════════════════════════');
+    console.log('📊 TEST RESULTS');
+    console.log('═══════════════════════════════════════════════════════════════════════════════');
+    console.log('');
+    console.log(`Total Scenarios: ${result.total}`);
+    console.log(`✅ Passed: ${result.passed}`);
+    console.log(`❌ Failed: ${result.failed}`);
+    console.log(`📈 Pass Rate: ${result.passRate.toFixed(2)}%`);
+    console.log(`⏱️  Duration: ${(result.duration / 1000).toFixed(2)}s`);
+    console.log('');
+
+    // Show failures
+    if (result.failures.length > 0) {
+      console.log('❌ FAILURES:');
+      result.failures.slice(0, 10).forEach(f => {
+        console.log(`   - Scenario ${f.scenario.id}: ${f.scenario.description}`);
+        if (options.verbose && f.error) {
+          console.log(`     Error: ${f.error.substring(0, 100)}`);
+        }
+      });
+      if (result.failures.length > 10) {
+        console.log(`   ... and ${result.failures.length - 10} more`);
+      }
+      console.log('');
+    }
+
+    // Generate report
+    const reportPath = path.resolve(process.cwd(), options.output!);
+    await runner.generateReport(result, reportPath);
+
+    // Final verdict
+    if (result.failed === 0) {
+      console.log('🎯 RESULT: ✅ ALL SCENARIOS PASSED (100%)');
+      console.log('');
+      console.log('═══════════════════════════════════════════════════════════════════════════════');
+      console.log('  🚀 MemoryLink v1.0 - PRODUCTION READY');
+      console.log('═══════════════════════════════════════════════════════════════════════════════');
+      process.exit(0);
+    } else {
+      console.log(`⚠️  RESULT: ${result.failed} scenario(s) failed`);
+      process.exit(1);
+    }
+  } catch (error: any) {
+    console.error('❌ Test execution failed:', error.message);
+    process.exit(1);
+  }
+}
+
+main().catch(console.error);
+

package/src/types.ts

@@ -0,0 +1,533 @@
+/**
+ * MemoryLink - Core Types and Interfaces
+ * Universal memory layer for AI coding assistants
+ * 
+ * v1.0 UPDATE: All logs now use JSONL format for robust parsing,
+ * schema validation, and future extensibility.
+ */
+
+// ============================================
+// ENTRY STATUS TYPES
+// ============================================
+
+// Log entry status for learnings
+export type LearningStatus = 'SUCCESS' | 'FAILED';
+
+// Entry lifecycle status
+export type EntryStatus = 'ACTIVE' | 'DEPRECATED' | 'DELETED';
+
+// Memory entry types
+export type MemoryType = 'note' | 'decision' | 'doc_ref' | 'context' | 'rule' | 'preference' | 'code_snippet' | 'code_structure';
+
+// ============================================
+// JSONL ENTRY INTERFACES (v1.0)
+// ============================================
+
+/**
+ * Base interface for all JSONL log entries
+ */
+export interface BaseEntry {
+  id: string;           // UUID v4
+  ts: string;           // ISO 8601 timestamp
+  agent: string;        // "cursor", "claude", "chatgpt", "user", etc.
+  status: EntryStatus;  // Entry lifecycle status
+  tags?: string[];      // Searchable keywords
+  forcedSecretCheck?: boolean; // If --force was used to bypass secret detection
+}
+
+/**
+ * Memory log entry (JSONL format)
+ * File: .memorylink/memory.log
+ * 
+ * v1.4: Enhanced with Buddy-Check fields (backward compatible)
+ * v1.3 and earlier records will have defaults applied during migration
+ */
+export interface MemoryEntry extends BaseEntry {
+  type: MemoryType;     // Type of memory entry
+  details: string;      // Main content/message
+  path?: string;        // For doc_ref: path to referenced file
+  hash?: string;        // For doc_ref: file hash for integrity
+  replacesId?: string;  // ID of entry this replaces (for updates)
+  // For code_snippet type:
+  code?: string;        // Actual code content
+  language?: string;    // Programming language (typescript, python, etc.)
+  file?: string;        // Source file path (for code_snippet)
+  lines?: string;       // Line range (e.g., "42-50" or "42")
+  context?: string;     // Why this snippet is important
+  // For code_structure type (v1.2):
+  dependencies?: string[];  // Files this depends on
+  complexity?: number;      // Code complexity score
+  
+  // v1.4 Buddy-Check fields (optional for backward compatibility)
+  schemaVersion?: string;   // "1.4.0" if v1.4 record, undefined for v1.3
+  recordVersion?: number;   // Version number for this record
+  projectPath?: string;     // Project path (defaults to current dir)
+  location?: RecordLocation; // Code location if applicable
+  sensitivity?: Sensitivity; // Defaults to 'internal' if missing
+  trustLevel?: TrustLevel;   // Defaults to 'medium' if missing
+  memoryStatus?: MemoryStatus; // Defaults to 'VERIFIED' for human, 'DRAFT' for agent
+  sourceType?: SourceType;   // Defaults based on agent field
+  provenance?: Provenance;   // Defaults from ts/agent fields
+  expiresAt?: string;        // Optional TTL
+  incident?: boolean;        // Optional incident flag
+  // v1.5 Phase 2: Project scoping
+  projectScope?: string;     // Optional project/feature scope (e.g., "frontend", "backend")
+}
+
+/**
+ * Learning log entry (JSONL format)
+ * File: .memorylink/learnings.log
+ */
+export interface LearningEntry extends BaseEntry {
+  problem: string;      // Problem description
+  solution: string;     // Solution that was tried
+  outcome: LearningStatus; // SUCCESS or FAILED
+  reason?: string;      // Why it succeeded/failed
+  confidence?: number;  // 0-1 confidence score
+  replacesId?: string;  // ID of entry this replaces
+}
+
+/**
+ * Change log entry (JSONL format)
+ * File: .memorylink/changes.log
+ */
+export interface ChangeEntry extends BaseEntry {
+  file: string;         // File path that was changed
+  action: 'created' | 'edited' | 'deleted' | 'renamed';
+  reason: string;       // Why the change was made
+  user?: string;        // User who initiated (if known)
+  diff?: string;        // Optional diff summary
+  // Enhanced context fields (v1.2+):
+  justification?: string;  // Detailed justification for the change
+  reviewedBy?: string;     // Person who reviewed the change
+  tested?: string;        // Testing status/notes
+  impact?: string;        // Human-readable impact description
+  // For change_impact type (v1.2):
+  type?: 'change' | 'change_impact';
+  impactData?: {
+    direct_dependents: number;
+    indirect_dependents: number;
+    breaking_changes: string[];
+    migration_required: boolean;
+  };
+}
+
+/**
+ * Protected file entry
+ * File: .memorylink/protected.txt (plain text, one per line)
+ */
+export interface ProtectedFile {
+  path: string;
+  addedAt: string;
+  reason?: string;
+}
+
+// ============================================
+// LEGACY TYPES (for migration)
+// ============================================
+
+/**
+ * Legacy memory entry (pre-v1.0 text format)
+ * Format: [TIMESTAMP] MESSAGE [tags]
+ */
+export interface LegacyMemoryEntry {
+  timestamp: string;
+  message: string;
+  tags?: string[];
+}
+
+/**
+ * Legacy learning entry (pre-v1.0 text format)
+ * Format: [TIMESTAMP] [STATUS] PROBLEM -> SOLUTION [tags]
+ */
+export interface LegacyLearningEntry {
+  timestamp: string;
+  problem: string;
+  solution: string;
+  status: LearningStatus;
+  tags?: string[];
+}
+
+/**
+ * Legacy change entry (pre-v1.0 text format)
+ * Format: [TIMESTAMP] FILE: REASON (agent)
+ */
+export interface LegacyChangeEntry {
+  timestamp: string;
+  file: string;
+  reason: string;
+  agent?: string;
+}
+
+// Configuration
+export interface MemoryLinkConfig {
+  version: string;
+  initialized: string;
+  watchIgnore: string[];
+  // v1.4: Mode configuration for Buddy-Check
+  mode?: 'developer' | 'enterprise';
+  strict?: boolean;
+  // v1.5 Phase 2: Lock timeout configuration
+  lockTimeoutMinutes?: number;
+  // v1.5 Phase 2: Smart filtering weights
+  smart?: {
+    weights?: {
+      trust?: { high?: number; medium?: number; low?: number };
+      status?: { verified?: number; draft?: number; default?: number };
+      recency?: { day1?: number; day7?: number; day30?: number; day90?: number; older?: number };
+      file?: { exact?: number; partial?: number; directory?: number };
+      task?: { max?: number };
+    };
+    threshold?: number; // Minimum score to include (default: 10)
+  };
+  // v1.6: Telemetry configuration (opt-in only, OFF by default)
+  telemetry?: {
+    enabled?: boolean;        // Default: false (opt-in only)
+    endpoint?: string | null; // HTTP endpoint for events (null = disabled)
+    apiKey?: string | null;   // Optional API key for authentication
+  };
+}
+
+// Export options
+export interface ExportOptions extends GlobalOptions {
+  format?: 'json' | 'jsonl';
+  limit?: number;
+}
+
+// Doctor check result (v1.3)
+export interface DoctorCheck {
+  name: string;
+  status: 'pass' | 'fail' | 'warn';
+  message: string;
+  suggestion?: string;  // Auto-fix suggestion for this issue
+}
+
+// ============================================
+// V1.4 BUDDY-CHECK TYPES
+// ============================================
+
+/**
+ * Buddy-Check status (v1.4)
+ * GREEN: No errors, safe to proceed
+ * YELLOW: Warnings but no hard errors
+ * RED: Critical errors, should block
+ */
+export type BuddyStatus = 'GREEN' | 'YELLOW' | 'RED';
+
+/**
+ * Buddy-Check issue (v1.4)
+ */
+export interface BuddyIssue {
+  id?: string;             // record id if applicable
+  type: string;            // SCHEMA, BROKEN_REF, SECRET, PII, STALE, CONFLICT, POLICY, etc.
+  severity: 'info' | 'warning' | 'error';
+  message: string;
+  projectPath?: string;
+  suggestion?: string;     // Optional fix suggestion
+}
+
+/**
+ * Human override information (v1.4)
+ */
+export interface BuddyOverride {
+  approvedBy: string;
+  reason: string;
+  timestamp: string;       // ISO 8601 UTC
+}
+
+/**
+ * Buddy-Check report (v1.4)
+ */
+export interface BuddyReport {
+  status: BuddyStatus;
+  summary: string;
+  issues: BuddyIssue[];
+  override?: BuddyOverride;
+  timestamp?: string;      // When report was generated
+  runType?: 'preflight' | 'postflight';
+  agentId?: string;       // Agent that triggered the check
+  branch?: string;        // Git branch
+  recordsUsed?: number;    // Number of records checked
+  highTrust?: number;      // Count of high trust records
+  mediumTrust?: number;    // Count of medium trust records
+  lowTrust?: number;       // Count of low trust records
+  staleCount?: number;     // Count of stale records
+  durationMs?: number;     // Check duration in milliseconds
+}
+
+// Status report
+export interface StatusReport {
+  initialized: boolean;
+  protectedCount: number;
+  memoryCount: number;
+  changesCount: number;
+  learningsCount: number;
+  successCount: number;
+  failedCount: number;
+}
+
+// ============================================
+// CLI OPTIONS
+// ============================================
+
+export interface GlobalOptions {
+  verbose?: boolean;
+}
+
+export interface MemoryOptions extends GlobalOptions {
+  tags?: string;
+  type?: MemoryType;
+  force?: boolean;      // Bypass secret detection
+  template?: string;    // Template name (v1.3 - Week 6)
+  scope?: string;       // v1.5 Phase 2: Project scope (e.g., "frontend", "backend")
+}
+
+export interface LearnOptions extends GlobalOptions {
+  status: LearningStatus;
+  tags?: string;
+  reason?: string;
+  force?: boolean;      // Bypass secret detection
+  template?: string;    // Template name (v1.3 - Week 6)
+}
+
+export interface ChangeOptions extends GlobalOptions {
+  justification?: string;  // Detailed justification
+  reviewedBy?: string;     // Reviewer name
+  tested?: string;         // Testing status
+  impact?: string;         // Impact description
+  action?: 'created' | 'edited' | 'deleted' | 'renamed';
+  agent?: string;
+  force?: boolean;      // Bypass secret detection
+}
+
+export interface WatchOptions extends GlobalOptions {
+  ignore?: string[];
+}
+
+export interface GetContextOptions extends GlobalOptions {
+  limit?: number;
+  since?: string;       // Duration like "7d", "2w", "1m"
+  tag?: string;
+  type?: MemoryType;
+  format?: 'default' | 'raw' | 'json' | 'cursor' | 'claude' | 'chatgpt'; // AI-specific formatting
+  page?: number;        // Page number for pagination
+  perPage?: number;     // Results per page
+  stream?: boolean;     // Use streaming mode (memory-efficient)
+  smart?: boolean;      // v1.5 Phase 1: Smart filtering with ranking
+  task?: string;        // v1.5 Phase 1: Task description for smart filtering
+  scope?: string;       // v1.5 Phase 2: Filter by project scope
+}
+
+export interface ListOptions extends GlobalOptions {
+  limit?: number;
+  since?: string;       // Duration like "7d", "2w", "1m"
+  tag?: string;
+  status?: EntryStatus | LearningStatus;
+  json?: boolean;       // Output as JSON
+}
+
+export interface SearchOptions extends GlobalOptions {
+  tag?: string;
+  since?: string;
+  limit?: number;
+  type?: string;        // "memory", "learning", "change", or "all"
+  semantic?: boolean;   // Use semantic search instead of keyword matching (TF-IDF)
+  vector?: boolean;     // Use vector search (embeddings) - requires index
+  threshold?: number;   // Semantic similarity threshold (0-1)
+  json?: boolean;
+}
+
+export interface DoctorOptions extends GlobalOptions {
+  fix?: boolean;        // Auto-fix issues where possible
+  scanSecrets?: boolean;
+}
+
+// File paths configuration
+export const MEMORYLINK_DIR = '.memorylink';
+export const FILES = {
+  PROTECTED: 'protected.txt',
+  MEMORY: 'memory.log',
+  CHANGES: 'changes.log',
+  LEARNINGS: 'learnings.log',
+  CONFIG: 'config.json',
+  IGNORE: '.memorylinkignore',
+  RULES: 'rules.md',
+  PREFERENCES: 'preferences.json',
+  AGENTS: 'AGENTS.md',
+} as const;
+
+// Default ignore patterns
+export const DEFAULT_IGNORE_PATTERNS = [
+  'node_modules/**',
+  '.git/**',
+  'dist/**',
+  'build/**',
+  '.next/**',
+  '.nuxt/**',
+  'coverage/**',
+  '*.log',
+  '.DS_Store',
+  'Thumbs.db',
+  '.env*',
+  '*.lock',
+  'package-lock.json',
+  'yarn.lock',
+  'pnpm-lock.yaml',
+];
+
+// ============================================
+// SECRET DETECTION PATTERNS
+// ============================================
+
+export interface SecretPattern {
+  name: string;
+  pattern: RegExp;
+}
+
+export const SECRET_PATTERNS: SecretPattern[] = [
+  // API Keys - Common Providers
+  { name: 'OpenAI API Key', pattern: /sk-[a-zA-Z0-9]{8,}/ },  // sk- followed by 8+ chars
+  { name: 'OpenAI Project Key', pattern: /sk-proj-[a-zA-Z0-9]{8,}/ },
+  { name: 'Anthropic API Key', pattern: /sk-ant-[a-zA-Z0-9-]{8,}/ },
+  { name: 'Stripe Secret Key', pattern: /sk_live_[a-zA-Z0-9]{8,}/ },
+  { name: 'Stripe Test Key', pattern: /sk_test_[a-zA-Z0-9]{8,}/ },
+  { name: 'AWS Access Key', pattern: /AKIA[0-9A-Z]{16}/ },
+  { name: 'AWS Secret Key', pattern: /AWS_SECRET_ACCESS_KEY\s*[:=]\s*['"]?[a-zA-Z0-9/+=]{8,}['"]?/i },
+  { name: 'GitHub Token', pattern: /ghp_[a-zA-Z0-9]{20,}/ },
+  { name: 'GitHub Token (PAT)', pattern: /github_pat_[a-zA-Z0-9_]{20,}/ },
+  { name: 'Google API Key', pattern: /AIza[0-9A-Za-z-_]{30,}/ },
+  { name: 'Slack Token', pattern: /xox[baprs]-[0-9]{8,}/ },
+  
+  // Generic patterns - More aggressive
+  { name: 'API Key Assignment', pattern: /api[_-]?key\s*[:=]\s*['"]?[a-zA-Z0-9_-]{8,}['"]?/i },
+  { name: 'Secret Assignment', pattern: /secret\s*[:=]\s*['"]?[a-zA-Z0-9_-]{8,}['"]?/i },
+  { name: 'Token Assignment', pattern: /token\s*[:=]\s*['"]?[a-zA-Z0-9_-]{12,}['"]?/i },
+  { name: 'Password Assignment', pattern: /password\s*[:=]\s*['"]?[^\s'"]{4,}['"]?/i },
+  { name: 'Passwd Assignment', pattern: /passwd\s*[:=]\s*['"]?[^\s'"]{4,}['"]?/i },
+  { name: 'Pwd Assignment', pattern: /\bpwd\s*[:=]\s*['"]?[^\s'"]{4,}['"]?/i },
+  { name: 'Database URL with Password', pattern: /postgres(ql)?:\/\/[^:]+:[^@]+@/i },
+  { name: 'Redis URL with Password', pattern: /redis:\/\/:[^@]+@/i },
+  { name: 'MongoDB URL with Password', pattern: /mongodb(\+srv)?:\/\/[^:]+:[^@]+@/i },
+  { name: 'Private Key', pattern: /-----BEGIN (?:[A-Z]+ )?PRIVATE KEY-----/ },
+  { name: 'Bearer Token', pattern: /bearer\s+[a-zA-Z0-9_-]{16,}/i },
+  
+  // Key-like strings (looks like actual keys, not variable names)
+  { name: 'Potential API Key', pattern: /['"]\s*sk[_-][a-zA-Z0-9]{16,}\s*['"]/ },
+];
+
+// ============================================
+// DURATION PARSING
+// ============================================
+
+export type DurationUnit = 'd' | 'w' | 'm' | 'y';
+
+export const DURATION_MS: Record<DurationUnit, number> = {
+  d: 24 * 60 * 60 * 1000,        // 1 day
+  w: 7 * 24 * 60 * 60 * 1000,    // 1 week
+  m: 30 * 24 * 60 * 60 * 1000,   // 1 month (approx)
+  y: 365 * 24 * 60 * 60 * 1000,  // 1 year (approx)
+};
+
+// ============================================
+// V1.4 SCHEMA TYPES (Buddy-Check)
+// ============================================
+
+/**
+ * Memory record status for Buddy-Check
+ * DRAFT: Unverified, needs human review
+ * VERIFIED: Human-approved or CI-verified
+ */
+export type MemoryStatus = 'DRAFT' | 'VERIFIED';
+
+/**
+ * Sensitivity classification for memory records
+ * public: Safe to share publicly
+ * internal: Internal use only
+ * secret: Contains sensitive information
+ */
+export type Sensitivity = 'public' | 'internal' | 'secret';
+
+/**
+ * Trust level for memory records
+ * high: Verified, recent, from trusted source
+ * medium: Default for most records
+ * low: Stale, unverified, or from untrusted source
+ */
+export type TrustLevel = 'high' | 'medium' | 'low';
+
+/**
+ * Source type of the memory record
+ * human: Created by human user
+ * code: Extracted from code analysis
+ * agent: Created by AI agent
+ * external: From external system
+ */
+export type SourceType = 'human' | 'code' | 'agent' | 'external';
+
+/**
+ * Record type for v1.4 schema
+ * NODE: Code structure node
+ * EDGE: Dependency relationship
+ * NOTE: General note/decision
+ * EVENT: Change event
+ */
+export type RecordType = 'NODE' | 'EDGE' | 'NOTE' | 'EVENT';
+
+/**
+ * Provenance information for memory records
+ */
+export interface Provenance {
+  createdAt: string;          // ISO 8601 UTC
+  createdBy: string;          // user or agent id
+  model?: string;             // AI model name (e.g., "claude-3.5-sonnet")
+  tool?: string;              // cursor, vscode, cli, etc.
+  commitOid?: string;         // Git commit OID
+  branch?: string;            // Git branch name
+  prNumber?: string;          // Pull request number
+  kind: 'user' | 'app' | 'signed-token';
+  tokenIssuer?: string;       // Token issuer for signed-token kind
+}
+
+/**
+ * Location information for code-related records
+ */
+export interface RecordLocation {
+  lineStart: number;
+  lineEnd: number;
+  commit: string;             // commitOid
+}
+
+/**
+ * v1.4 Memory Record (enhanced schema for Buddy-Check)
+ * This is the new canonical format for all memory records
+ */
+export interface MemoryRecord {
+  id: string;
+  schemaVersion: string;        // "1.4.0"
+  recordVersion: number;        // start at 1, increment on update
+
+  type: RecordType;
+  projectPath: string;
+  branch?: string;
+  location?: RecordLocation;
+  content: string;
+
+  sensitivity: Sensitivity;
+  trustLevel: TrustLevel;
+  status: MemoryStatus;         // 'DRAFT' or 'VERIFIED'
+
+  sourceType: SourceType;
+  provenance: Provenance;
+
+  expiresAt?: string;           // optional TTL hint (ISO 8601)
+  incident?: boolean;           // optional incident flag
+  projectScope?: string;        // v1.5 Phase 2: Optional project/feature scope (e.g., "frontend", "backend", "auth-module")
+}
+
+// ============================================
+// VERSION INFO
+// ============================================
+
+export const MEMORYLINK_VERSION = '1.0.0';
+export const JSONL_SCHEMA_VERSION = '1.0';
+