dino-spec 17.4.2 → 17.5.0

package/dist/core/agents/__tests__/state-persistence.test.js

@@ -0,0 +1,270 @@
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { DEFAULT_PERSISTENCE_CONFIG, StatePersistence, } from '../state-persistence.js';
+describe('StatePersistence', () => {
+    const testBaseDir = '.dino/test-agent-state';
+    let persistence;
+    beforeEach(() => {
+        // Clean up test directory
+        if (existsSync(testBaseDir)) {
+            rmSync(testBaseDir, { recursive: true });
+        }
+        persistence = new StatePersistence({ baseDir: testBaseDir });
+    });
+    afterEach(() => {
+        persistence.dispose();
+        if (existsSync(testBaseDir)) {
+            rmSync(testBaseDir, { recursive: true });
+        }
+    });
+    describe('Claims Persistence', () => {
+        it('should save and load claims', () => {
+            const claims = [
+                {
+                    resource: 'src/file1.ts',
+                    agentId: 'agent-1',
+                    claimedAt: new Date().toISOString(),
+                    expiresAt: new Date(Date.now() + 3600000).toISOString(),
+                },
+                {
+                    resource: 'src/file2.ts',
+                    agentId: 'agent-2',
+                    claimedAt: new Date().toISOString(),
+                    expiresAt: new Date(Date.now() + 3600000).toISOString(),
+                },
+            ];
+            persistence.saveClaims(claims);
+            const loaded = persistence.loadClaims();
+            expect(loaded).toHaveLength(2);
+            expect(loaded[0].resource).toBe('src/file1.ts');
+            expect(loaded[1].resource).toBe('src/file2.ts');
+        });
+        it('should filter out stale claims (> 1 hour)', () => {
+            const now = Date.now();
+            const claims = [
+                {
+                    resource: 'src/fresh.ts',
+                    agentId: 'agent-1',
+                    claimedAt: new Date(now - 1000).toISOString(), // 1 second ago
+                    expiresAt: new Date(now + 3600000).toISOString(),
+                },
+                {
+                    resource: 'src/stale.ts',
+                    agentId: 'agent-2',
+                    claimedAt: new Date(now - 3700000).toISOString(), // Over 1 hour ago
+                    expiresAt: new Date(now - 100000).toISOString(), // Already expired
+                },
+            ];
+            persistence.saveClaims(claims);
+            const loaded = persistence.loadClaims();
+            expect(loaded).toHaveLength(1);
+            expect(loaded[0].resource).toBe('src/fresh.ts');
+        });
+        it('should handle empty claims file', () => {
+            const loaded = persistence.loadClaims();
+            expect(loaded).toHaveLength(0);
+        });
+        it('should handle corrupted claims file', () => {
+            mkdirSync(testBaseDir, { recursive: true });
+            writeFileSync(join(testBaseDir, 'claims.json'), 'invalid json');
+            const loaded = persistence.loadClaims();
+            expect(loaded).toHaveLength(0);
+        });
+    });
+    describe('Message History Persistence', () => {
+        it('should save and load message history', () => {
+            const messages = [
+                {
+                    id: 'msg-1',
+                    from: 'agent-1',
+                    to: 'agent-2',
+                    type: 'query',
+                    payload: { queryType: 'file-content', resource: 'test.ts' },
+                    timestamp: new Date().toISOString(),
+                },
+                {
+                    id: 'msg-2',
+                    from: 'agent-2',
+                    to: 'agent-1',
+                    type: 'response',
+                    payload: { queryId: 'msg-1', success: true, data: 'content' },
+                    timestamp: new Date().toISOString(),
+                },
+            ];
+            persistence.saveMessageHistory(messages);
+            const loaded = persistence.loadMessageHistory();
+            expect(loaded).toHaveLength(2);
+            expect(loaded[0].id).toBe('msg-1');
+            expect(loaded[1].id).toBe('msg-2');
+        });
+        it('should append messages incrementally', () => {
+            const message1 = {
+                id: 'msg-1',
+                from: 'agent-1',
+                to: null,
+                type: 'broadcast',
+                payload: { broadcastType: 'file-read', resource: 'test.ts' },
+                timestamp: new Date().toISOString(),
+            };
+            const message2 = {
+                id: 'msg-2',
+                from: 'agent-2',
+                to: null,
+                type: 'broadcast',
+                payload: { broadcastType: 'task-complete' },
+                timestamp: new Date().toISOString(),
+            };
+            persistence.appendMessage(message1);
+            persistence.appendMessage(message2);
+            persistence.flushMessages();
+            const loaded = persistence.loadMessageHistory();
+            expect(loaded).toHaveLength(2);
+        });
+        it('should compress history when exceeding max size', () => {
+            const smallPersistence = new StatePersistence({
+                baseDir: testBaseDir,
+                maxActiveMessages: 5,
+            });
+            // Create 10 messages
+            const messages = [];
+            for (let i = 0; i < 10; i++) {
+                messages.push({
+                    id: `msg-${i}`,
+                    from: 'agent-1',
+                    to: null,
+                    type: 'broadcast',
+                    payload: { broadcastType: 'custom', data: { index: i } },
+                    timestamp: new Date().toISOString(),
+                });
+            }
+            smallPersistence.saveMessageHistory(messages);
+            const loaded = smallPersistence.loadMessageHistory();
+            // Should only have last 5 messages
+            expect(loaded).toHaveLength(5);
+            expect(loaded[0].id).toBe('msg-5');
+            expect(loaded[4].id).toBe('msg-9');
+            smallPersistence.dispose();
+        });
+        it('should handle empty messages file', () => {
+            const loaded = persistence.loadMessageHistory();
+            expect(loaded).toHaveLength(0);
+        });
+    });
+    describe('Shared State Persistence', () => {
+        it('should save and load shared state', () => {
+            const state = new Map();
+            state.set('key1', 'value1');
+            state.set('key2', { nested: 'object' });
+            state.set('key3', [1, 2, 3]);
+            persistence.saveSharedState(state);
+            const loaded = persistence.loadSharedState();
+            expect(loaded.get('key1')).toBe('value1');
+            expect(loaded.get('key2')).toEqual({ nested: 'object' });
+            expect(loaded.get('key3')).toEqual([1, 2, 3]);
+        });
+        it('should handle empty state file', () => {
+            const loaded = persistence.loadSharedState();
+            expect(loaded.size).toBe(0);
+        });
+    });
+    describe('Full State Management', () => {
+        it('should load all state at once', () => {
+            // Save some data first
+            const claims = [
+                {
+                    resource: 'test.ts',
+                    agentId: 'agent-1',
+                    claimedAt: new Date().toISOString(),
+                },
+            ];
+            const messages = [
+                {
+                    id: 'msg-1',
+                    from: 'agent-1',
+                    to: null,
+                    type: 'broadcast',
+                    payload: { broadcastType: 'custom' },
+                    timestamp: new Date().toISOString(),
+                },
+            ];
+            const state = new Map();
+            state.set('testKey', 'testValue');
+            persistence.saveClaims(claims);
+            persistence.saveMessageHistory(messages);
+            persistence.saveSharedState(state);
+            // Load all at once
+            const { claims: loadedClaims, messages: loadedMessages, sharedState } = persistence.loadAll();
+            expect(loadedClaims).toHaveLength(1);
+            expect(loadedMessages).toHaveLength(1);
+            expect(sharedState.get('testKey')).toBe('testValue');
+        });
+        it('should save all state at once', () => {
+            const claims = [
+                {
+                    resource: 'all.ts',
+                    agentId: 'agent-all',
+                    claimedAt: new Date().toISOString(),
+                },
+            ];
+            const messages = [
+                {
+                    id: 'msg-all',
+                    from: 'agent-all',
+                    to: null,
+                    type: 'broadcast',
+                    payload: { broadcastType: 'custom' },
+                    timestamp: new Date().toISOString(),
+                },
+            ];
+            const state = new Map();
+            state.set('allKey', 'allValue');
+            persistence.saveAll(claims, messages, state);
+            // Verify by loading back
+            const loaded = persistence.loadAll();
+            expect(loaded.claims).toHaveLength(1);
+            expect(loaded.claims[0].resource).toBe('all.ts');
+            expect(loaded.messages).toHaveLength(1);
+            expect(loaded.sharedState.get('allKey')).toBe('allValue');
+        });
+    });
+    describe('Cleanup', () => {
+        it('should clean up stale claims', () => {
+            const now = Date.now();
+            const claims = [
+                {
+                    resource: 'fresh.ts',
+                    agentId: 'agent-1',
+                    claimedAt: new Date(now - 1000).toISOString(),
+                },
+                {
+                    resource: 'old.ts',
+                    agentId: 'agent-2',
+                    claimedAt: new Date(now - 7200000).toISOString(), // 2 hours ago
+                },
+            ];
+            const cleaned = persistence.cleanupStaleClaims(claims);
+            expect(cleaned).toHaveLength(1);
+            expect(cleaned[0].resource).toBe('fresh.ts');
+        });
+    });
+    describe('Configuration', () => {
+        it('should use default configuration', () => {
+            expect(DEFAULT_PERSISTENCE_CONFIG.baseDir).toBe('.dino/agent-state');
+            expect(DEFAULT_PERSISTENCE_CONFIG.maxActiveMessages).toBe(1000);
+            expect(DEFAULT_PERSISTENCE_CONFIG.maxClaimAgeMs).toBe(3600000); // 1 hour
+        });
+        it('should allow custom configuration', () => {
+            const customConfig = {
+                baseDir: 'custom/path',
+                maxActiveMessages: 500,
+                maxClaimAgeMs: 1800000, // 30 minutes
+            };
+            const customPersistence = new StatePersistence(customConfig);
+            // Handle both Windows and Unix path separators
+            expect(customPersistence.claimsPath).toMatch(/custom[/\\]path/);
+            customPersistence.dispose();
+        });
+    });
+});
+//# sourceMappingURL=state-persistence.test.js.map

package/dist/core/agents/__tests__/state-persistence.test.js.map

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

package/dist/core/agents/__tests__/validation-cache.test.d.ts

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

package/dist/core/agents/__tests__/validation-cache.test.d.ts.map

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

package/dist/core/agents/__tests__/validation-cache.test.js

@@ -0,0 +1,181 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { API_RATE_LIMITS, RateLimiter, rateLimited, rateLimiter, ValidationCache, withRateLimit, } from '../validation-cache.js';
+describe('ValidationCache', () => {
+    let cache;
+    beforeEach(() => {
+        cache = new ValidationCache({ ttlMs: 1000, maxEntries: 5 });
+    });
+    describe('Basic Operations', () => {
+        it('should store and retrieve values', () => {
+            cache.set('key1', 'value1');
+            expect(cache.get('key1')).toBe('value1');
+        });
+        it('should return undefined for missing keys', () => {
+            expect(cache.get('nonexistent')).toBeUndefined();
+        });
+        it('should check if key exists', () => {
+            cache.set('key1', 'value1');
+            expect(cache.has('key1')).toBe(true);
+            expect(cache.has('nonexistent')).toBe(false);
+        });
+        it('should delete values', () => {
+            cache.set('key1', 'value1');
+            expect(cache.delete('key1')).toBe(true);
+            expect(cache.get('key1')).toBeUndefined();
+        });
+        it('should clear all values', () => {
+            cache.set('key1', 'value1');
+            cache.set('key2', 'value2');
+            cache.clear();
+            expect(cache.get('key1')).toBeUndefined();
+            expect(cache.get('key2')).toBeUndefined();
+        });
+    });
+    describe('TTL Expiration', () => {
+        it('should expire entries after TTL', async () => {
+            const shortCache = new ValidationCache({ ttlMs: 50 });
+            shortCache.set('key1', 'value1');
+            expect(shortCache.get('key1')).toBe('value1');
+            await new Promise((resolve) => setTimeout(resolve, 100));
+            expect(shortCache.get('key1')).toBeUndefined();
+        });
+        it('should allow custom TTL per entry', async () => {
+            cache.set('short', 'value', 50);
+            cache.set('long', 'value', 5000);
+            await new Promise((resolve) => setTimeout(resolve, 100));
+            expect(cache.get('short')).toBeUndefined();
+            expect(cache.get('long')).toBe('value');
+        });
+    });
+    describe('Max Entries', () => {
+        it('should evict oldest entry when at capacity', () => {
+            for (let i = 0; i < 6; i++) {
+                cache.set(`key${i}`, `value${i}`);
+            }
+            // First entry should be evicted
+            const stats = cache.getStats();
+            expect(stats.size).toBeLessThanOrEqual(5);
+        });
+    });
+    describe('Statistics', () => {
+        it('should track hits and misses', () => {
+            cache.set('key1', 'value1');
+            cache.get('key1'); // hit
+            cache.get('key1'); // hit
+            cache.get('missing'); // miss
+            const stats = cache.getStats();
+            expect(stats.hits).toBe(2);
+            expect(stats.misses).toBe(1);
+            expect(stats.hitRate).toBeCloseTo(0.667, 2);
+        });
+        it('should report size', () => {
+            cache.set('key1', 'value1');
+            cache.set('key2', 'value2');
+            const stats = cache.getStats();
+            expect(stats.size).toBe(2);
+            expect(stats.maxSize).toBe(5);
+        });
+    });
+    describe('Cleanup', () => {
+        it('should cleanup expired entries', async () => {
+            const shortCache = new ValidationCache({ ttlMs: 50 });
+            shortCache.set('key1', 'value1');
+            shortCache.set('key2', 'value2');
+            await new Promise((resolve) => setTimeout(resolve, 100));
+            const evicted = shortCache.cleanup();
+            expect(evicted).toBe(2);
+        });
+    });
+});
+describe('RateLimiter', () => {
+    let limiter;
+    beforeEach(() => {
+        limiter = new RateLimiter();
+    });
+    afterEach(() => {
+        limiter.resetAll();
+    });
+    describe('Token Acquisition', () => {
+        it('should allow immediate requests within burst limit', async () => {
+            // npm has burstLimit of 20
+            for (let i = 0; i < 5; i++) {
+                await expect(limiter.acquire('npm')).resolves.toBeUndefined();
+            }
+        });
+        it('should track available tokens', () => {
+            const stats = limiter.getStats('npm');
+            expect(stats.availableTokens).toBeGreaterThan(0);
+            expect(stats.config.requestsPerSecond).toBe(10);
+        });
+        it('should queue requests when tokens exhausted', async () => {
+            // Exhaust all tokens
+            const burstLimit = API_RATE_LIMITS.audit.burstLimit; // 3 for audit
+            for (let i = 0; i < burstLimit; i++) {
+                await limiter.acquire('audit');
+            }
+            // Next request should be queued
+            const stats = limiter.getStats('audit');
+            expect(stats.availableTokens).toBe(0);
+        });
+    });
+    describe('Rate Limit Configuration', () => {
+        it('should have default rate limits for npm', () => {
+            expect(API_RATE_LIMITS.npm).toEqual({
+                requestsPerSecond: 10,
+                burstLimit: 20,
+            });
+        });
+        it('should have default rate limits for bundlephobia', () => {
+            expect(API_RATE_LIMITS.bundlephobia).toEqual({
+                requestsPerSecond: 5,
+                burstLimit: 10,
+            });
+        });
+        it('should have default rate limits for audit', () => {
+            expect(API_RATE_LIMITS.audit).toEqual({
+                requestsPerSecond: 1,
+                burstLimit: 3,
+            });
+        });
+    });
+    describe('Reset', () => {
+        it('should reset a specific source', async () => {
+            await limiter.acquire('npm');
+            limiter.reset('npm');
+            const stats = limiter.getStats('npm');
+            expect(stats.queueLength).toBe(0);
+        });
+        it('should reset all sources', async () => {
+            await limiter.acquire('npm');
+            await limiter.acquire('audit');
+            limiter.resetAll();
+            // New stats should be fresh
+            const npmStats = limiter.getStats('npm');
+            expect(npmStats.queueLength).toBe(0);
+        });
+    });
+});
+describe('Utility Functions', () => {
+    afterEach(() => {
+        rateLimiter.resetAll();
+    });
+    describe('withRateLimit', () => {
+        it('should execute function with rate limiting', async () => {
+            let called = false;
+            const result = await withRateLimit('npm', async () => {
+                called = true;
+                return 'result';
+            });
+            expect(called).toBe(true);
+            expect(result).toBe('result');
+        });
+    });
+    describe('rateLimited', () => {
+        it('should create rate-limited function', async () => {
+            const fn = rateLimited('npm', async (x) => x * 2);
+            const result = await fn(5);
+            expect(result).toBe(10);
+        });
+    });
+});
+//# sourceMappingURL=validation-cache.test.js.map

package/dist/core/agents/__tests__/validation-cache.test.js.map

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

package/dist/core/agents/blackboard.d.ts

@@ -1,11 +1,12 @@
 /**
- * Blackboard - v12.5.0
+ * Blackboard - v12.6.0
  *
  * Shared state coordination for multi-agent systems:
  * - Resource claiming to prevent duplicate work
  * - Shared key-value state
  * - Lock mechanism to prevent races
  * - File content caching
+ * - Persistent state across sessions
  */
 import { type MessageBus } from './message-protocol.js';
 /**
@@ -65,8 +66,8 @@ export interface BlackboardStats {
  * - Lock mechanism for critical sections
  */
 export declare class Blackboard {
-    private claims;
-    private state;
+    claims: Map<string, ResourceClaim>;
+    state: Map<string, unknown>;
     private cache;
     private locks;
     private messageBus;
@@ -75,7 +76,25 @@ export declare class Blackboard {
     private cacheMisses;
     private defaultLockTimeoutMs;
     private defaultClaimExpiryMs;
+    private persistClaimChange;
+    private persistStateChange;
     constructor(defaultLockTimeoutMs?: number, defaultClaimExpiryMs?: number);
+    /**
+     * Set persistence callbacks
+     */
+    setPersistenceCallbacks(onClaimChange: (() => void) | null, onStateChange: (() => void) | null): void;
+    /**
+     * Load claims from persisted state
+     */
+    loadClaims(claims: ResourceClaim[]): void;
+    /**
+     * Load shared state from persisted state
+     */
+    loadState(state: Map<string, unknown>): void;
+    /**
+     * Get all claims as array (for persistence)
+     */
+    getAllClaims(): ResourceClaim[];
     /**
      * Connect to a message bus for distributed coordination
      */

package/dist/core/agents/blackboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blackboard.d.ts","sourceRoot":"","sources":["../../../src/core/agents/blackboard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"blackboard.d.ts","sourceRoot":"","sources":["../../../src/core/agents/blackboard.ts"],"names":[],"mappings":"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"}

package/dist/core/agents/blackboard.js

@@ -1,11 +1,12 @@
 /**
- * Blackboard - v12.5.0
+ * Blackboard - v12.6.0
  *
  * Shared state coordination for multi-agent systems:
  * - Resource claiming to prevent duplicate work
  * - Shared key-value state
  * - Lock mechanism to prevent races
  * - File content caching
+ * - Persistent state across sessions
  */
 import { createBroadcast, createClaim, isBroadcast, isClaim, } from './message-protocol.js';
 // =============================================================================
@@ -31,10 +32,44 @@ export class Blackboard {
     cacheMisses = 0;
     defaultLockTimeoutMs;
     defaultClaimExpiryMs;
+    persistClaimChange = null;
+    persistStateChange = null;
     constructor(defaultLockTimeoutMs = 5000, defaultClaimExpiryMs = 60000) {
         this.defaultLockTimeoutMs = defaultLockTimeoutMs;
         this.defaultClaimExpiryMs = defaultClaimExpiryMs;
     }
+    /**
+     * Set persistence callbacks
+     */
+    setPersistenceCallbacks(onClaimChange, onStateChange) {
+        this.persistClaimChange = onClaimChange;
+        this.persistStateChange = onStateChange;
+    }
+    /**
+     * Load claims from persisted state
+     */
+    loadClaims(claims) {
+        this.claims.clear();
+        for (const claim of claims) {
+            this.claims.set(claim.resource, claim);
+        }
+    }
+    /**
+     * Load shared state from persisted state
+     */
+    loadState(state) {
+        this.state.clear();
+        for (const [key, value] of state) {
+            this.state.set(key, value);
+        }
+    }
+    /**
+     * Get all claims as array (for persistence)
+     */
+    getAllClaims() {
+        this.cleanupExpiredClaims();
+        return Array.from(this.claims.values());
+    }
     /**
      * Connect to a message bus for distributed coordination
      */
@@ -150,6 +185,10 @@ export class Blackboard {
             metadata,
         };
         this.claims.set(resource, claim);
+        // Notify persistence
+        if (this.persistClaimChange) {
+            this.persistClaimChange();
+        }
         // Broadcast claim to other agents
         if (this.messageBus) {
             const message = createClaim(agentId, 'claim', resource, metadata);
@@ -170,6 +209,10 @@ export class Blackboard {
             return false; // Not owned by this agent
         }
         this.claims.delete(resource);
+        // Notify persistence
+        if (this.persistClaimChange) {
+            this.persistClaimChange();
+        }
         // Broadcast release to other agents
         if (this.messageBus) {
             const message = createClaim(agentId, 'release', resource);
@@ -244,12 +287,19 @@ export class Blackboard {
      */
     set(key, value) {
         this.state.set(key, value);
+        if (this.persistStateChange) {
+            this.persistStateChange();
+        }
     }
     /**
      * Delete a value from shared state
      */
     delete(key) {
-        return this.state.delete(key);
+        const result = this.state.delete(key);
+        if (result && this.persistStateChange) {
+            this.persistStateChange();
+        }
+        return result;
     }
     /**
      * Check if key exists in shared state