memorylink 1.0.0

package/scripts/test-new-scenarios.sh

@@ -0,0 +1,374 @@
+#!/bin/bash
+
+# MemoryLink v1.5.1 - New Scenario Test Suite
+# Tests various edge cases and advanced features
+
+set -e
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+# Colors
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+PASSED=0
+FAILED=0
+TOTAL=0
+
+test_scenario() {
+    local name="$1"
+    local command="$2"
+    local expected_exit="${3:-0}"
+    
+    TOTAL=$((TOTAL + 1))
+    echo -e "${BLUE}Test $TOTAL: $name${NC}"
+    
+    if eval "$command" > /dev/null 2>&1; then
+        exit_code=$?
+        if [ $exit_code -eq $expected_exit ]; then
+            echo -e "${GREEN}  ✓ PASSED${NC}"
+            PASSED=$((PASSED + 1))
+            return 0
+        else
+            echo -e "${RED}  ✗ FAILED (exit code: $exit_code, expected: $expected_exit)${NC}"
+            FAILED=$((FAILED + 1))
+            return 1
+        fi
+    else
+        exit_code=$?
+        if [ $exit_code -eq $expected_exit ]; then
+            echo -e "${GREEN}  ✓ PASSED (expected failure)${NC}"
+            PASSED=$((PASSED + 1))
+            return 0
+        else
+            echo -e "${RED}  ✗ FAILED (exit code: $exit_code, expected: $expected_exit)${NC}"
+            FAILED=$((FAILED + 1))
+            return 1
+        fi
+    fi
+}
+
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "${BLUE}  MemoryLink v1.5.1 - New Scenario Test Suite${NC}"
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo ""
+
+# Build first
+echo "Building MemoryLink..."
+npm run build > /dev/null 2>&1
+echo ""
+
+# ============================================================================
+# SCENARIO GROUP 1: Smart Filtering Edge Cases
+# ============================================================================
+echo -e "${YELLOW}=== Group 1: Smart Filtering Edge Cases ===${NC}"
+echo ""
+
+# Test smart filtering with empty task
+test_scenario "Smart filter with empty task" \
+    "node dist/cli.js get-context --smart --task '' --limit 5"
+
+# Test smart filtering with very long task description
+test_scenario "Smart filter with long task description" \
+    "node dist/cli.js get-context --smart --task '$(printf 'a%.0s' {1..500})' --limit 3"
+
+# Test smart filtering with special characters
+test_scenario "Smart filter with special characters" \
+    "node dist/cli.js get-context --smart --task 'test@#$%^&*()[]{}|\\:;\"<>?,./' --limit 5"
+
+# Test smart filtering with task mentioning file
+test_scenario "Smart filter with task mentioning file" \
+    "node dist/cli.js get-context --smart --task 'cli.ts command registration' --limit 3"
+
+# Test smart filtering with task mentioning specific file and interface
+test_scenario "Smart filter with task about file and interface" \
+    "node dist/cli.js get-context --smart --task 'types.ts memory entry interface definition' --limit 5"
+
+# ============================================================================
+# SCENARIO GROUP 2: Project Scoping Edge Cases
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 2: Project Scoping Edge Cases ===${NC}"
+echo ""
+
+# Test memory with various scope formats
+test_scenario "Memory with simple scope" \
+    "node dist/cli.js memory 'Test with simple scope' --scope 'project-a'"
+
+# Test memory with scope containing hyphens
+test_scenario "Memory with hyphenated scope" \
+    "node dist/cli.js memory 'Test with hyphenated scope' --scope 'project-alpha-beta'"
+
+# Test memory with scope containing underscores
+test_scenario "Memory with underscored scope" \
+    "node dist/cli.js memory 'Test with underscored scope' --scope 'project_alpha_beta'"
+
+# Test memory with numeric scope
+test_scenario "Memory with numeric scope" \
+    "node dist/cli.js memory 'Test with numeric scope' --scope 'project-123'"
+
+# Test get-context with scope filter
+test_scenario "Get context with scope filter" \
+    "node dist/cli.js get-context --scope 'project-a' --limit 3"
+
+# Test memory command with invalid scope (should fail)
+test_scenario "Memory with invalid scope (too long)" \
+    "node dist/cli.js memory 'Test' --scope '$(printf 'a%.0s' {1..200})'" \
+    1
+
+# Test memory command with invalid scope (special chars)
+test_scenario "Memory with invalid scope (special chars)" \
+    "node dist/cli.js memory 'Test' --scope 'project@#$%'" \
+    1
+
+# ============================================================================
+# SCENARIO GROUP 3: Checkpoint Operations
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 3: Checkpoint Operations ===${NC}"
+echo ""
+
+# Create a checkpoint
+test_scenario "Create checkpoint" \
+    "node dist/cli.js checkpoint create 'test-checkpoint-$(date +%s)'"
+
+# List checkpoints
+test_scenario "List checkpoints" \
+    "node dist/cli.js checkpoint list"
+
+# List checkpoints (verify output)
+test_scenario "List checkpoints (verify)" \
+    "node dist/cli.js checkpoint list | head -5"
+
+# Diff checkpoints (if we have at least 2)
+test_scenario "Diff checkpoints" \
+    "node dist/cli.js checkpoint diff HEAD HEAD~1 2>/dev/null || node dist/cli.js checkpoint list | head -1"
+
+# ============================================================================
+# SCENARIO GROUP 4: Lock Operations Edge Cases
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 4: Lock Operations Edge Cases ===${NC}"
+echo ""
+
+# Check lock status
+test_scenario "Check lock status" \
+    "node dist/cli.js lock status"
+
+# Try to acquire lock
+test_scenario "Acquire lock" \
+    "node dist/cli.js lock acquire --timeout 5"
+
+# Check lock status after acquire
+test_scenario "Check lock status (after acquire)" \
+    "node dist/cli.js lock status"
+
+# Try to renew lock
+test_scenario "Renew lock" \
+    "node dist/cli.js lock renew --timeout 10"
+
+# Release lock
+test_scenario "Release lock" \
+    "node dist/cli.js lock release"
+
+# Try to acquire lock with very short timeout
+test_scenario "Acquire lock with short timeout" \
+    "node dist/cli.js lock acquire --timeout 1"
+
+test_scenario "Release lock again" \
+    "node dist/cli.js lock release"
+
+# ============================================================================
+# SCENARIO GROUP 5: Stats with Various Filters
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 5: Stats with Various Filters ===${NC}"
+echo ""
+
+# Stats with default format
+test_scenario "Stats (default format)" \
+    "node dist/cli.js stats"
+
+# Stats with JSON format
+test_scenario "Stats (JSON format)" \
+    "node dist/cli.js stats --format json"
+
+# Stats with since filter (1 day)
+test_scenario "Stats since 1 day" \
+    "node dist/cli.js stats --since '1 day ago'"
+
+# Stats with since filter (1 week)
+test_scenario "Stats since 1 week" \
+    "node dist/cli.js stats --since '1 week ago'"
+
+# Stats with since filter (1 month)
+test_scenario "Stats since 1 month" \
+    "node dist/cli.js stats --since '1 month ago'"
+
+# Stats without recommendations
+test_scenario "Stats without recommendations" \
+    "node dist/cli.js stats --no-recommendations"
+
+# Stats with both filters
+test_scenario "Stats with since and no-recommendations" \
+    "node dist/cli.js stats --since '1 week ago' --no-recommendations --format json"
+
+# ============================================================================
+# SCENARIO GROUP 6: Context Retrieval Variations
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 6: Context Retrieval Variations ===${NC}"
+echo ""
+
+# Get context with default limit
+test_scenario "Get context (default)" \
+    "node dist/cli.js get-context"
+
+# Get context with small limit
+test_scenario "Get context (limit 1)" \
+    "node dist/cli.js get-context --limit 1"
+
+# Get context with large limit
+test_scenario "Get context (limit 50)" \
+    "node dist/cli.js get-context --limit 50"
+
+# Get context with scope
+test_scenario "Get context with scope" \
+    "node dist/cli.js get-context --scope 'project-a' --limit 5"
+
+# Get context with smart filtering
+test_scenario "Get context with smart filtering" \
+    "node dist/cli.js get-context --smart --limit 5"
+
+# Get context with verbose output
+test_scenario "Get context (verbose)" \
+    "node dist/cli.js get-context --limit 2 --verbose"
+
+# ============================================================================
+# SCENARIO GROUP 7: Memory Operations Variations
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 7: Memory Operations Variations ===${NC}"
+echo ""
+
+# Memory with just description
+test_scenario "Memory (description only)" \
+    "node dist/cli.js memory 'Simple memory entry $(date +%s)'"
+
+# Memory with description and scope
+test_scenario "Memory (description + scope)" \
+    "node dist/cli.js memory 'Memory with scope $(date +%s)' --scope 'test-scope'"
+
+# Memory with very long description
+test_scenario "Memory (long description)" \
+    "node dist/cli.js memory '$(printf 'Long entry %.0s' {1..100}) $(date +%s)'"
+
+# Memory with special characters
+test_scenario "Memory (special characters)" \
+    "node dist/cli.js memory 'Test with special chars: @#$%^&*() $(date +%s)'"
+
+# ============================================================================
+# SCENARIO GROUP 8: Scopes Command
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 8: Scopes Command ===${NC}"
+echo ""
+
+# List scopes
+test_scenario "List scopes" \
+    "node dist/cli.js scopes list"
+
+# List scopes (verify output)
+test_scenario "List scopes (verify)" \
+    "node dist/cli.js scopes list | head -10"
+
+# ============================================================================
+# SCENARIO GROUP 9: Doctor Command Variations
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 9: Doctor Command Variations ===${NC}"
+echo ""
+
+# Preflight check
+test_scenario "Doctor preflight" \
+    "node dist/cli.js doctor --preflight"
+
+# Preflight with JSON
+test_scenario "Doctor preflight (JSON)" \
+    "node dist/cli.js doctor --preflight --json"
+
+# Postflight check
+test_scenario "Doctor postflight" \
+    "node dist/cli.js doctor --postflight"
+
+# Postflight with JSON
+test_scenario "Doctor postflight (JSON)" \
+    "node dist/cli.js doctor --postflight --json"
+
+# ============================================================================
+# SCENARIO GROUP 10: Combined Operations
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 10: Combined Operations ===${NC}"
+echo ""
+
+# Memory + Get Context
+test_scenario "Memory then get context" \
+    "node dist/cli.js memory 'Combined test $(date +%s)' --scope 'combined' && node dist/cli.js get-context --scope 'combined' --limit 2"
+
+# Lock + Memory + Release
+test_scenario "Lock, memory, release" \
+    "node dist/cli.js lock acquire --timeout 5 && node dist/cli.js memory 'Locked operation $(date +%s)' && node dist/cli.js lock release"
+
+# Checkpoint + Stats
+test_scenario "Checkpoint then stats" \
+    "node dist/cli.js checkpoint create 'stats-test-$(date +%s)' && node dist/cli.js stats --format json"
+
+# Preflight + Memory + Postflight
+test_scenario "Preflight, memory, postflight" \
+    "node dist/cli.js doctor --preflight --json > /dev/null && node dist/cli.js memory 'Workflow test $(date +%s)' && node dist/cli.js doctor --postflight --json > /dev/null"
+
+# ============================================================================
+# SCENARIO GROUP 11: Error Handling & Edge Cases
+# ============================================================================
+echo ""
+echo -e "${YELLOW}=== Group 11: Error Handling & Edge Cases ===${NC}"
+echo ""
+
+# Invalid command (Commander.js shows help, so exit code may vary)
+test_scenario "Invalid command" \
+    "node dist/cli.js invalid-command 2>&1 | grep -q 'error\|Unknown\|invalid' || true"
+
+# Get context with invalid limit (may be handled gracefully)
+test_scenario "Get context with invalid limit" \
+    "node dist/cli.js get-context --limit -1 2>&1 | head -1"
+
+# Stats with invalid since format (should handle gracefully)
+test_scenario "Stats with invalid since format" \
+    "node dist/cli.js stats --since 'invalid-date-format'"
+
+# ============================================================================
+# FINAL SUMMARY
+# ============================================================================
+echo ""
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "${BLUE}  Test Results Summary${NC}"
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo ""
+echo -e "Total Tests: ${TOTAL}"
+echo -e "${GREEN}Passed: ${PASSED}${NC}"
+echo -e "${RED}Failed: ${FAILED}${NC}"
+echo ""
+
+if [ $FAILED -eq 0 ]; then
+    echo -e "${GREEN}🎉 ALL TESTS PASSED!${NC}"
+    exit 0
+else
+    echo -e "${RED}⚠️  Some tests failed${NC}"
+    exit 1
+fi
+

package/scripts/test-quick-random.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+
+# MemoryLink v1.5.1 - Quick Random Scenario Test (5 minutes)
+# For faster testing while maintaining randomness
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Test configuration
+TEST_DURATION=300   # 5 minutes
+TEST_INTERVAL=10    # Run test every 10 seconds
+ITERATIONS=30       # 30 iterations
+
+# Test counters
+TOTAL_TESTS=0
+PASSED_TESTS=0
+FAILED_TESTS=0
+
+# Random generators
+SCOPES=("frontend" "backend" "api" "auth" "database")
+AGENTS=("cursor-ai" "claude-ai" "gpt-4")
+TAGS=("typescript" "react" "node" "api" "test")
+TASKS=("refactor" "fix bug" "add feature" "optimize")
+
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "${BLUE}  MemoryLink v1.5.1 - Quick Random Scenario Test${NC}"
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo ""
+
+# Check initialization
+if [ ! -d ".memorylink" ]; then
+    echo -e "${YELLOW}Initializing MemoryLink...${NC}"
+    node dist/cli.js init --force > /dev/null 2>&1
+fi
+
+# Test function
+test_step() {
+    local name="$1"
+    local cmd="$2"
+    ((TOTAL_TESTS++))
+    
+    if eval "$cmd" > /dev/null 2>&1; then
+        echo -e "${GREEN}  ✓ ${name}${NC}"
+        ((PASSED_TESTS++))
+        return 0
+    else
+        echo -e "${RED}  ✗ ${name}${NC}"
+        ((FAILED_TESTS++))
+        return 1
+    fi
+}
+
+# Random functions
+random_scope() { echo "${SCOPES[$RANDOM % ${#SCOPES[@]}]}"; }
+random_agent() { echo "${AGENTS[$RANDOM % ${#AGENTS[@]}]}"; }
+random_tag() { echo "${TAGS[$RANDOM % ${#TAGS[@]}]}"; }
+random_task() { echo "${TASKS[$RANDOM % ${#TASKS[@]}]}"; }
+
+# Run iterations
+for ((i=1; i<=ITERATIONS; i++)); do
+    echo -e "${CYAN}Iteration ${i}/${ITERATIONS}${NC}"
+    
+    # Random scenario
+    case $((RANDOM % 8)) in
+        0) test_step "Memory + Scope" "node dist/cli.js memory 'Test $(date +%s)' --scope '$(random_scope)' --tags '$(random_tag)'" ;;
+        1) test_step "Preflight" "node dist/cli.js doctor --preflight --json | jq -e '.status' > /dev/null" ;;
+        2) test_step "Postflight" "node dist/cli.js doctor --postflight --json | jq -e '.status' > /dev/null" ;;
+        3) test_step "Checkpoint" "node dist/cli.js checkpoint create --name 'test-$(date +%s)'" ;;
+        4) test_step "Lock" "node dist/cli.js lock acquire --agent '$(random_agent)' --timeout 15 && node dist/cli.js lock release" ;;
+        5) test_step "Smart Filter" "node dist/cli.js get-context --smart --task '$(random_task)' --limit 3" ;;
+        6) test_step "Scope Filter" "node dist/cli.js get-context --scope '$(random_scope)' --limit 3" ;;
+        7) test_step "Stats" "node dist/cli.js stats --format json | jq -e '.totalRuns' > /dev/null" ;;
+    esac
+    
+    sleep $TEST_INTERVAL
+done
+
+# Summary
+echo ""
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "${GREEN}Passed: ${PASSED_TESTS}${NC} | ${RED}Failed: ${FAILED_TESTS}${NC} | ${BLUE}Total: ${TOTAL_TESTS}${NC}"
+
+if [ $FAILED_TESTS -eq 0 ]; then
+    echo -e "${GREEN}✓ All tests passed!${NC}"
+    exit 0
+else
+    echo -e "${RED}✗ Some tests failed${NC}"
+    exit 1
+fi
+

package/scripts/test-runtime.sh

@@ -0,0 +1,129 @@
+#!/bin/bash
+# MemoryLink v1.4 - Runtime Testing Script
+# Tests CLI commands and generates test report
+
+set -e
+
+echo "🧪 MemoryLink v1.4 Runtime Testing"
+echo "=================================="
+echo ""
+
+PASSED=0
+FAILED=0
+
+# Colors
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# Test 1: Preflight Check
+echo "Test 1: Preflight Check"
+if memorylink doctor --preflight --json > /tmp/preflight-test.json 2>&1; then
+    STATUS=$(cat /tmp/preflight-test.json | jq -r '.status // "UNKNOWN"' 2>/dev/null || echo "UNKNOWN")
+    if [ "$STATUS" != "UNKNOWN" ]; then
+        echo -e "${GREEN}✅ PASS${NC}: Preflight returns status: $STATUS"
+        ((PASSED++))
+    else
+        echo -e "${RED}❌ FAIL${NC}: Preflight JSON invalid"
+        ((FAILED++))
+    fi
+else
+    echo -e "${RED}❌ FAIL${NC}: Preflight command failed"
+    ((FAILED++))
+fi
+echo ""
+
+# Test 2: Postflight Check
+echo "Test 2: Postflight Check"
+if memorylink doctor --postflight --changed --json > /tmp/postflight-test.json 2>&1; then
+    STATUS=$(cat /tmp/postflight-test.json | jq -r '.status // "UNKNOWN"' 2>/dev/null || echo "UNKNOWN")
+    if [ "$STATUS" != "UNKNOWN" ]; then
+        echo -e "${GREEN}✅ PASS${NC}: Postflight returns status: $STATUS"
+        ((PASSED++))
+    else
+        echo -e "${RED}❌ FAIL${NC}: Postflight JSON invalid"
+        ((FAILED++))
+    fi
+else
+    echo -e "${RED}❌ FAIL${NC}: Postflight command failed"
+    ((FAILED++))
+fi
+echo ""
+
+# Test 3: Report Files
+echo "Test 3: Report Files"
+if [ -f ".memorylink/preflight.json" ] && [ -f ".memorylink/postflight.json" ]; then
+    echo -e "${GREEN}✅ PASS${NC}: Report files exist"
+    ((PASSED++))
+else
+    echo -e "${RED}❌ FAIL${NC}: Report files missing"
+    ((FAILED++))
+fi
+echo ""
+
+# Test 4: Observability Log
+echo "Test 4: Observability Log"
+if [ -f ".memorylink/observability.log" ]; then
+    ENTRIES=$(wc -l < .memorylink/observability.log)
+    if [ "$ENTRIES" -gt 0 ]; then
+        echo -e "${GREEN}✅ PASS${NC}: Observability log has $ENTRIES entries"
+        ((PASSED++))
+    else
+        echo -e "${YELLOW}⚠ WARN${NC}: Observability log empty"
+    fi
+else
+    echo -e "${YELLOW}⚠ WARN${NC}: Observability log not found"
+fi
+echo ""
+
+# Test 5: Config Mode
+echo "Test 5: Config Mode"
+if [ -f ".memorylink/config.json" ]; then
+    MODE=$(cat .memorylink/config.json | jq -r '.mode // "unknown"' 2>/dev/null || echo "unknown")
+    STRICT=$(cat .memorylink/config.json | jq -r '.strict // false' 2>/dev/null || echo "false")
+    if [ "$MODE" != "unknown" ]; then
+        echo -e "${GREEN}✅ PASS${NC}: Config mode: $MODE, strict: $STRICT"
+        ((PASSED++))
+    else
+        echo -e "${RED}❌ FAIL${NC}: Config invalid"
+        ((FAILED++))
+    fi
+else
+    echo -e "${RED}❌ FAIL${NC}: Config file missing"
+    ((FAILED++))
+fi
+echo ""
+
+# Test 6: Migration (dry-run)
+echo "Test 6: Migration (dry-run)"
+if memorylink migrate --to 1.4 --dry-run > /tmp/migrate-test.txt 2>&1; then
+    if grep -q "Would migrate" /tmp/migrate-test.txt || grep -q "already in v1.4" /tmp/migrate-test.txt; then
+        echo -e "${GREEN}✅ PASS${NC}: Migration dry-run works"
+        ((PASSED++))
+    else
+        echo -e "${YELLOW}⚠ WARN${NC}: Migration output unexpected"
+    fi
+else
+    echo -e "${RED}❌ FAIL${NC}: Migration command failed"
+    ((FAILED++))
+fi
+echo ""
+
+# Summary
+echo "=================================="
+echo "Test Summary:"
+echo -e "${GREEN}Passed: $PASSED${NC}"
+if [ $FAILED -gt 0 ]; then
+    echo -e "${RED}Failed: $FAILED${NC}"
+fi
+echo ""
+
+if [ $FAILED -eq 0 ]; then
+    echo -e "${GREEN}✅ All tests passed!${NC}"
+    exit 0
+else
+    echo -e "${RED}❌ Some tests failed${NC}"
+    exit 1
+fi
+