olympus-ai 2.7.4 → 3.2.0

package/README.md

@@ -4,13 +4,14 @@
 
 ### Multi-Agent Orchestration for Claude Code
 
-[![Version](https://img.shields.io/badge/version-2.7.3-gold)](https://github.com/mikev10/olympus/releases)
+[![npm version](https://img.shields.io/npm/v/olympus-ai.svg)](https://www.npmjs.com/package/olympus-ai)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Agents](https://img.shields.io/badge/Agents-18-blue)](https://github.com/mikev10/olympus)
+[![Agents](https://img.shields.io/badge/Agents-20+-blue)](https://github.com/mikev10/olympus)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/mikev10/olympus/claude.yml)](https://github.com/mikev10/olympus/actions)
 
 **Summon the gods of code.**
 
-[Install](#installation) • [Usage](#usage) • [Agents](#available-agents) • [Commands](#slash-commands)
+[Why Olympus?](#why-olympus) • [Quick Start](#quick-start) • [Self-Learning](#self-learning-system) • [Use Cases](#use-cases) • [Agents](#available-agents) • [Docs](#documentation)
 
 </div>
 
@@ -20,11 +21,86 @@
 
 Olympus is a multi-agent orchestration system for [Claude Code](https://docs.anthropic.com/claude-code). It provides:
 
-- **18 Specialized Agents** - Oracle, Prometheus, Olympian, and more
-- **13 Slash Commands** - `/olympus`, `/ultrawork`, `/plan`, `/ascent`, etc.
-- **Intelligent Model Routing** - Routes tasks to Haiku/Sonnet/Opus based on complexity
-- **The Ascent** - Persistence loop that ensures tasks complete before stopping
-- **Magic Keywords** - Say "ultrawork" to activate maximum performance mode
+- 🧠 **Self-Learning System** - Learns your preferences, patterns, and codebase over time
+- 🤖 **20+ Specialized Agents** - Oracle, Prometheus, Olympian, Librarian, and more
+- ⚡ **Smart Model Routing** - Auto-selects Haiku/Sonnet/Opus based on task complexity
+- 📋 **Todo Management** - Tracks progress with real-time updates
+- 🔄 **Background Execution** - Long-running tasks run async with notifications
+- 🎯 **Continuation Enforcement** - Never stops until all tasks are complete
+- 💬 **13+ Slash Commands** - `/ultrawork`, `/plan`, `/ascent`, and more
+- 🔮 **Magic Keywords** - Natural language triggers for enhanced modes
+
+---
+
+## Why Olympus?
+
+Olympus transforms Claude Code from a single agent into a **pantheon of specialized experts** that work together seamlessly.
+
+### 🧠 Self-Learning System
+
+**Olympus learns from your preferences and evolves over time.**
+
+- **Active Agent Learning** - Agents proactively record patterns, gotchas, and workarounds they discover during work
+- **Passive Feedback Capture** - Automatically detects corrections, preferences, and patterns from your interactions
+- **Pattern Extraction** - Identifies recurring feedback and adapts behavior accordingly
+- **Preference Learning** - Infers your communication style (concise vs. detailed, autonomous vs. collaborative)
+- **Agent Performance Tracking** - Monitors which agents succeed or fail for specific tasks
+- **Discovery Storage** - Structured JSONL storage with verification tracking and confidence scoring
+- **Context Injection** - Learned preferences and discoveries are automatically applied in new sessions
+
+**The more you use Olympus, the better it understands your workflow.**
+
+### ⚡ Intelligent Orchestration
+
+- **Smart Delegation** - Routes tasks to specialized agents based on complexity
+- **Model Routing** - Automatically selects Haiku/Sonnet/Opus to optimize cost and performance
+- **Parallel Execution** - Runs independent tasks concurrently for maximum throughput
+
+### 🎯 Continuous Delivery
+
+- **Todo Management** - Tracks progress across complex multi-step tasks
+- **Continuation Enforcement** - Never stops until all tasks are verified complete
+- **Background Operations** - Long-running builds, tests, and installs run async with notifications
+
+### 🔧 Developer Experience
+
+- **Zero Configuration** - Works out-of-the-box with sensible defaults
+- **Slash Commands** - 13+ productivity commands (`/ultrawork`, `/plan`, `/ascent`)
+- **Magic Keywords** - Natural language triggers for enhanced modes
+
+### 📊 Olympus vs. Manual Claude Usage
+
+| Feature | Manual Claude | Olympus |
+|---------|---------------|---------|
+| **Multi-Step Tasks** | Sequential, manual tracking | Automatic todo management |
+| **Parallel Execution** | One task at a time | 3-5x faster with concurrent agents |
+| **Learning** | Repeats mistakes | Learns from corrections automatically |
+| **Model Selection** | Manual switching | Smart routing (cost optimized) |
+| **Task Persistence** | Stops when asked | Continues until verified complete |
+| **Background Tasks** | Blocks waiting | Runs async with notifications |
+| **Agent Specialization** | Generic responses | 20+ experts for specific domains |
+
+---
+
+## Quick Start
+
+Get started in under 60 seconds:
+
+```bash
+# Install globally
+npm install -g olympus-ai
+
+# Initialize Olympus
+olympus-ai install
+
+# Start Claude Code
+claude
+
+# Try it out
+/olympus implement a REST API for user management
+```
+
+**That's it.** Olympus is now active and learning from your interactions.
 
 ---
 
@@ -112,6 +188,116 @@ Include these words anywhere in your prompt to activate enhanced modes:
 
 ---
 
+## Use Cases
+
+### 🏗️ Complex Refactoring
+
+```bash
+/ascent refactor the entire authentication module to use OAuth 2.0
+```
+
+**What happens:**
+- Creates todo list for all subtasks
+- Delegates to specialized agents (Oracle for architecture, Olympian for execution)
+- Runs tests in background
+- Continues until all tasks verified complete
+
+### 📊 Multi-Agent Research
+
+```bash
+/ultrawork research and document all API endpoints in the codebase
+```
+
+**What happens:**
+- Spawns multiple agents in parallel (Explore for search, Librarian for docs)
+- Aggregates findings
+- Generates comprehensive documentation
+- ~3x faster than sequential execution
+
+### 📋 Strategic Planning
+
+```bash
+/plan build a real-time chat application with WebSocket support
+```
+
+**What happens:**
+- Prometheus interviews you about requirements
+- Creates detailed work plan with phases
+- Identifies dependencies and risks
+- Saves plan to `.olympus/plans/` for execution
+
+### 🧠 Learning Your Workflow
+
+**Automatic - no command needed**
+
+You: "No, use TypeScript interfaces instead of types"
+→ Olympus records this preference
+
+You: "Use functional components, not class components"
+→ Olympus learns your React style
+
+**Next session:** Claude automatically applies these preferences without being told.
+
+---
+
+## Architecture
+
+Olympus operates as a three-tier orchestration system with a continuous learning loop:
+
+```mermaid
+graph TD
+    A[User Request] --> B[Orchestrator]
+    B --> C{Task Analysis}
+    C -->|Simple| D[Haiku Agent]
+    C -->|Standard| E[Sonnet Agent]
+    C -->|Complex| F[Opus Agent]
+    D --> G[Learning System]
+    E --> G
+    F --> G
+    G --> H[Feedback Storage]
+    H -.->|Next Session| B
+    B --> I[Todo Manager]
+    I --> J[Background Executor]
+    J --> K[Result]
+```
+
+### How It Works
+
+**Current Session Flow:**
+1. **User Request** → Arrives with learned context already injected at SessionStart
+2. **Orchestrator** → Analyzes task complexity and delegates to appropriate agents
+3. **Model Router** → Selects Haiku (simple), Sonnet (standard), or Opus (complex)
+4. **Agents Execute** → Specialized agents complete their tasks
+5. **Learning System** → Passively captures feedback from corrections, preferences, and patterns
+6. **Feedback Storage** → Stores learned preferences, agent performance, and discoveries
+7. **Result** → User sees the completed work
+
+**Learning & Context Injection (Between Sessions):**
+
+The learning system operates across session boundaries:
+
+- **During Session**: Captures feedback from user corrections ("No, use async/await"), preferences ("Always use TypeScript"), and agent discoveries (gotchas, workarounds)
+- **Storage**: Writes to `~/.claude/olympus/learning/` (global) and `.olympus/learning/` (project-specific)
+- **Next Session Start**: SessionStart hook automatically injects learned context into the initial prompt
+- **Context Types Injected**:
+  - User preferences (verbosity, autonomy, explicit rules)
+  - Recurring corrections (mistakes to avoid)
+  - Project conventions (tech stack, patterns)
+  - Agent performance notes (weak areas to watch)
+  - Recent discoveries (technical insights about your codebase)
+
+**Key Insight:** Context injection happens at the **beginning** of each session (via SessionStart hook), not in the result. This means every new conversation starts with Claude already aware of your preferences and past learnings.
+
+**Key Components:**
+- **Orchestrator** - Delegates tasks to specialized agents based on complexity
+- **Model Router** - Selects optimal tier (Haiku/Sonnet/Opus) to balance cost and capability
+- **Learning System** - Captures feedback passively and builds preference models
+- **Todo Manager** - Tracks multi-step task progress with real-time status updates
+- **Background Executor** - Runs long-running operations (builds, tests, installs) async with notifications
+- **Feedback Storage** - Persists learned preferences, patterns, and discoveries across sessions
+
+---
+
 ## Available Agents
 
 ### Task Execution
@@ -182,16 +368,139 @@ Plans are saved to `.olympus/plans/` in your project directory.
 
 ---
 
+## Self-Learning System
+
+Olympus continuously learns from your interactions to provide increasingly personalized assistance.
+
+### How It Works
+
+**Phase 1: Passive Feedback Capture**
+- Detects corrections: "No, that's wrong"
+- Identifies rejections: "Stop", "Cancel"
+- Recognizes clarifications: "I meant X"
+- Captures enhancements: "Also add Y"
+- Records praise: "Perfect", "Thanks"
+- Extracts explicit preferences: "Always use X"
+
+**Phase 2: Pattern Extraction**
+- Clusters similar feedback using Jaccard similarity
+- Identifies recurring corrections (minimum 3 occurrences)
+- Categorizes patterns: style, behavior, tooling, communication
+
+**Phase 3: Preference Learning**
+- Infers verbosity level (concise vs. detailed)
+- Determines autonomy preference (ask first vs. just do it)
+- Tracks agent-specific performance
+- Implements 30-day decay for outdated patterns
+
+**Phase 4: Context Injection**
+- Automatically applies learned preferences at session start
+- Injects relevant discoveries about your codebase
+- Limits injection to ~500 tokens to avoid context bloat
+
+**Phase 5: Agent Discovery**
+- Agents record technical insights about your project
+- Discoveries include: gotchas, workarounds, patterns, dependencies
+- Validated and deduplicated before storage
+- Retrieved contextually in future sessions
+
+### Storage Locations
+
+**Global Learning:**
+```
+~/.claude/olympus/learning/
+├── feedback-log.jsonl          # All feedback entries (auto-rotates at 10k lines)
+├── user-preferences.json        # Learned preferences
+├── agent-performance.json       # Per-agent metrics
+└── discoveries.jsonl            # Global discoveries (auto-rotates at 10k lines)
+```
+
+**Project-Specific Learning:**
+```
+.olympus/learning/
+├── session-state.json           # Current session state
+├── patterns.json                # Project patterns
+└── discoveries.jsonl            # Project discoveries (auto-rotates at 10k lines)
+```
+
+**Data Lifecycle:**
+- JSONL files automatically rotate when they exceed 10,000 lines
+- Archived files are saved with timestamps (e.g., `feedback-log.2026-01-28.old.jsonl`)
+- Manual cleanup available via CLI (see Managing Learning Data below)
+
+### Managing Learning Data
+
+View learning statistics and manage stored data using the CLI:
+
+```bash
+# View learning statistics
+olympus-ai learn --stats
+
+# Preview cleanup (dry run)
+olympus-ai learn --cleanup --dry-run
+
+# Clean up entries older than 180 days (default)
+olympus-ai learn --cleanup
+
+# Clean up with custom age threshold
+olympus-ai learn --cleanup --age 90
+
+# Remove archived files
+olympus-ai learn --cleanup --remove-archived
+
+# View current learnings
+olympus-ai learn --show
+
+# Analyze feedback and update patterns
+olympus-ai learn --analyze
+
+# Forget all learnings
+olympus-ai learn --forget
+```
+
+**Example output:**
+```
+Learning System Statistics
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Feedback Entries:    1247 (1.2 MB)
+Discoveries:         123
+Total Storage:       1.5 MB
+
+Top Verified Discoveries:
+  1. Prisma migrations must run before seeding (8×)
+  2. This codebase uses kebab-case for files (6×)
+  3. Environment variable DATABASE_URL required (5×)
+```
+
+### Example
+
+**Session 1:** You tell Claude "No, use async/await instead of .then()"
+→ Olympus records this as a correction
+
+**Session 2:** Similar situation arises
+→ You provide the same feedback
+
+**Session 3:** Olympus detects the pattern (3+ occurrences)
+→ Learns your preference: "Use async/await over Promise chains"
+
+**Session 4+:** This preference is automatically injected
+→ Claude proactively uses async/await without being told
+
+**The learning happens silently in the background. No configuration required.**
+
+---
+
 ## What Gets Installed
 
 ```
 ~/.claude/
-├── agents/                  # 18 agent definitions
+├── agents/                  # 20+ agent definitions
 │   ├── oracle.md
 │   ├── prometheus.md
 │   ├── olympian.md
 │   └── ...
-├── commands/                # 13 slash commands
+├── commands/                # 13+ slash commands
 │   ├── olympus/skill.md
 │   ├── ultrawork/skill.md
 │   ├── plan.md
@@ -245,6 +554,62 @@ rm -rf ~/.claude/agents ~/.claude/commands ~/.claude/hooks ~/.claude/CLAUDE.md
 
 ---
 
+## Contributing
+
+We welcome contributions! Here's how to get started:
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/mikev10/olympus.git
+cd olympus
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Test locally
+node dist/cli/index.js install --local
+```
+
+### Running Tests
+
+```bash
+npm test              # Run tests in watch mode
+npm run test:run      # Run tests once
+npm run test:coverage # Generate coverage report
+```
+
+### Project Structure
+
+```
+olympus/
+├── src/
+│   ├── agents/       # Agent definitions
+│   ├── features/     # Core features (routing, learning, etc.)
+│   ├── hooks/        # Event handlers
+│   ├── learning/     # Self-learning system
+│   └── cli/          # CLI commands
+├── agents/           # Agent markdown files (installed)
+├── commands/         # Slash command files (installed)
+└── scripts/          # Build and installation scripts
+```
+
+---
+
+## Documentation
+
+- 📖 [Getting Started Guide](docs/Olympus.md)
+- 🤖 [Agent Reference](docs/AGENTS.md)
+- 🏗️ [Architecture Overview](docs/ARCHITECTURE.md)
+- 🗺️ [Roadmap](docs/ROADMAP.md)
+- 📋 [Changelog](CHANGELOG.md)
+
+---
+
 ## License
 
 MIT - see [LICENSE](LICENSE)
@@ -260,3 +625,4 @@ MIT - see [LICENSE](LICENSE)
 **Summon the gods of code.**
 
 </div>
+

package/dist/__tests__/installer.test.js

@@ -231,7 +231,7 @@ describe('Installer Constants', () => {
         });
         it('should match package.json version', () => {
             // This is a runtime check - VERSION should match the package.json
-            expect(VERSION).toBe('2.5.0');
+            expect(VERSION).toBe('3.1.0');
         });
     });
     describe('File Paths', () => {

package/dist/__tests__/learning/cleanup.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cleanup.test.d.ts.map

package/dist/__tests__/learning/cleanup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/learning/cleanup.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/learning/cleanup.test.js

@@ -0,0 +1,122 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { cleanupLearning } from '../../learning/cleanup.js';
+const TEST_DIR = join(process.cwd(), '.test-cleanup');
+describe('Learning Cleanup', () => {
+    beforeEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+        mkdirSync(TEST_DIR, { recursive: true });
+        process.env.HOME = TEST_DIR;
+    });
+    afterEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+        delete process.env.HOME;
+    });
+    it('removes old feedback entries', () => {
+        const learningDir = join(TEST_DIR, '.claude', 'olympus', 'learning');
+        mkdirSync(learningDir, { recursive: true });
+        const logPath = join(learningDir, 'feedback-log.jsonl');
+        const oldDate = new Date();
+        oldDate.setDate(oldDate.getDate() - 200); // 200 days ago
+        const entries = [
+            {
+                id: 'old-1',
+                timestamp: oldDate.toISOString(),
+                session_id: 'session-1',
+                project_path: '/test',
+                event_type: 'revision',
+                user_message: 'Old message',
+                feedback_category: 'correction',
+                confidence: 0.9,
+            },
+            {
+                id: 'new-1',
+                timestamp: new Date().toISOString(),
+                session_id: 'session-2',
+                project_path: '/test',
+                event_type: 'revision',
+                user_message: 'New message',
+                feedback_category: 'correction',
+                confidence: 0.9,
+            },
+        ];
+        writeFileSync(logPath, entries.map(e => JSON.stringify(e)).join('\n') + '\n', 'utf-8');
+        const result = cleanupLearning('/test', { ageDays: 180, dryRun: false });
+        expect(result.feedback_entries_removed).toBe(1);
+        expect(result.space_freed_mb).toBeGreaterThan(0);
+    });
+    it('removes expired discoveries', () => {
+        const learningDir = join(TEST_DIR, '.claude', 'olympus', 'learning');
+        mkdirSync(learningDir, { recursive: true });
+        const discoveryPath = join(learningDir, 'discoveries.jsonl');
+        const expiredDate = new Date();
+        expiredDate.setDate(expiredDate.getDate() - 10);
+        const futureDate = new Date();
+        futureDate.setDate(futureDate.getDate() + 10);
+        const discoveries = [
+            {
+                id: 'expired-1',
+                timestamp: new Date().toISOString(),
+                session_id: 'session-1',
+                project_path: '/test',
+                category: 'workaround',
+                summary: 'Expired discovery',
+                details: 'This is expired',
+                agent_name: 'oracle',
+                confidence: 0.9,
+                verified: false,
+                verification_count: 0,
+                scope: 'global',
+                expires_at: expiredDate.toISOString(),
+                last_useful: new Date().toISOString(),
+            },
+            {
+                id: 'active-1',
+                timestamp: new Date().toISOString(),
+                session_id: 'session-1',
+                project_path: '/test',
+                category: 'pattern',
+                summary: 'Active discovery',
+                details: 'This is active',
+                agent_name: 'oracle',
+                confidence: 0.9,
+                verified: false,
+                verification_count: 0,
+                scope: 'global',
+                expires_at: futureDate.toISOString(),
+                last_useful: new Date().toISOString(),
+            },
+        ];
+        writeFileSync(discoveryPath, discoveries.map(d => JSON.stringify(d)).join('\n') + '\n', 'utf-8');
+        const result = cleanupLearning('/test', { compactExpired: true, dryRun: false });
+        expect(result.discoveries_removed).toBe(1);
+    });
+    it('dry run does not modify files', () => {
+        const learningDir = join(TEST_DIR, '.claude', 'olympus', 'learning');
+        mkdirSync(learningDir, { recursive: true });
+        const logPath = join(learningDir, 'feedback-log.jsonl');
+        const oldDate = new Date();
+        oldDate.setDate(oldDate.getDate() - 200);
+        const entry = {
+            id: 'old-1',
+            timestamp: oldDate.toISOString(),
+            session_id: 'session-1',
+            project_path: '/test',
+            event_type: 'revision',
+            user_message: 'Old message',
+            feedback_category: 'correction',
+            confidence: 0.9,
+        };
+        writeFileSync(logPath, JSON.stringify(entry) + '\n', 'utf-8');
+        const sizeBefore = require('fs').statSync(logPath).size;
+        cleanupLearning('/test', { ageDays: 180, dryRun: true });
+        const sizeAfter = require('fs').statSync(logPath).size;
+        expect(sizeBefore).toBe(sizeAfter);
+    });
+});
+//# sourceMappingURL=cleanup.test.js.map

package/dist/__tests__/learning/cleanup.test.js.map

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

package/dist/__tests__/learning/storage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage.test.d.ts.map

package/dist/__tests__/learning/storage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/learning/storage.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/learning/storage.test.js

@@ -0,0 +1,75 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { appendFeedback, readFeedbackLog } from '../../learning/storage.js';
+const TEST_DIR = join(process.cwd(), '.test-learning');
+describe('Storage with Rotation', () => {
+    beforeEach(() => {
+        // Override getLearningDir for testing
+        process.env.HOME = TEST_DIR;
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+        mkdirSync(TEST_DIR, { recursive: true });
+    });
+    afterEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+        delete process.env.HOME;
+    });
+    it('rotates JSONL file when exceeding threshold', () => {
+        const testEntry = {
+            id: 'test-1',
+            timestamp: new Date().toISOString(),
+            session_id: 'session-1',
+            project_path: '/test',
+            event_type: 'revision',
+            user_message: 'Test message',
+            feedback_category: 'correction',
+            confidence: 0.9,
+        };
+        // Create a file with many lines (simulating large file)
+        const learningDir = join(TEST_DIR, '.claude', 'olympus', 'learning');
+        mkdirSync(learningDir, { recursive: true });
+        const logPath = join(learningDir, 'feedback-log.jsonl');
+        // Write 10,001 lines to trigger rotation
+        const lines = [];
+        for (let i = 0; i < 10001; i++) {
+            lines.push(JSON.stringify({ ...testEntry, id: `test-${i}` }));
+        }
+        writeFileSync(logPath, lines.join('\n') + '\n', 'utf-8');
+        // Append new entry (should trigger rotation)
+        appendFeedback(testEntry);
+        // Check that archive file was created
+        const files = require('fs').readdirSync(learningDir);
+        const archiveFiles = files.filter((f) => f.includes('.old.jsonl'));
+        expect(archiveFiles.length).toBeGreaterThan(0);
+        // Check that new file has only 1 entry
+        const newLog = readFeedbackLog();
+        expect(newLog.length).toBe(1);
+    });
+    it('does not rotate when below threshold', () => {
+        const testEntry = {
+            id: 'test-1',
+            timestamp: new Date().toISOString(),
+            session_id: 'session-1',
+            project_path: '/test',
+            event_type: 'revision',
+            user_message: 'Test message',
+            feedback_category: 'correction',
+            confidence: 0.9,
+        };
+        // Add a few entries (below threshold)
+        for (let i = 0; i < 5; i++) {
+            appendFeedback({ ...testEntry, id: `test-${i}` });
+        }
+        const learningDir = join(TEST_DIR, '.claude', 'olympus', 'learning');
+        const files = require('fs').readdirSync(learningDir);
+        const archiveFiles = files.filter((f) => f.includes('.old.jsonl'));
+        expect(archiveFiles.length).toBe(0);
+        const log = readFeedbackLog();
+        expect(log.length).toBe(5);
+    });
+});
+//# sourceMappingURL=storage.test.js.map

package/dist/__tests__/learning/storage.test.js.map

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