@ace-sdk/core 1.0.0

package/README.md

@@ -0,0 +1,54 @@
+# @ace-sdk/core
+
+Core ACE client library for pattern learning.
+
+[![npm version](https://img.shields.io/npm/v/@ace-sdk/core.svg)](https://www.npmjs.com/package/@ace-sdk/core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+npm install @ace-sdk/core
+```
+
+## Features
+
+- **ACE Client**: HTTP client for ACE Server API
+- **3-Tier Caching**: RAM → SQLite → Server for optimal performance
+- **Configuration**: Flexible config resolution (CLI args → env vars → files)
+- **TypeScript Types**: Full type definitions for patterns, playbooks, API responses
+
+## Quick Start
+
+```typescript
+import { ACEClient, createContext } from '@ace-sdk/core';
+
+// Create context from environment
+const context = await createContext({
+  org: process.env.ACE_ORG_ID,
+  project: process.env.ACE_PROJECT_ID
+});
+
+// Initialize client
+const client = new ACEClient(context);
+
+// Fetch playbook
+const playbook = await client.getPlaybook();
+console.log(`Loaded ${playbook.patterns.length} patterns`);
+
+// Search for relevant patterns
+const results = await client.search('authentication patterns');
+```
+
+## Used By
+
+- **@ace-sdk/cli** - Command-line tool
+- **@ace-sdk/mcp** - MCP Server for any MCP-compatible client
+
+## Documentation
+
+Full documentation: [packages/core/docs](./docs)
+
+## License
+
+MIT © [CE.NET Team](mailto:ace@code-engine.net)

package/dist/cache/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Cache exports for @ace-sdk/core
+ */
+export { LocalCacheService } from './local-cache.js';
+export type { CacheConfig } from './local-cache.js';
+export { SessionStorage } from './session-storage.js';
+export type { SessionStorageConfig, SessionPin, SessionPinResult } from './session-storage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EACjB,MAAM,sBAAsB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,6 @@
+/**
+ * Cache exports for @ace-sdk/core
+ */
+export { LocalCacheService } from './local-cache.js';
+export { SessionStorage } from './session-storage.js';
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/cache/local-cache.d.ts

@@ -0,0 +1,72 @@
+/**
+ * LocalCacheService - Client-side SQLite cache
+ *
+ * Architecture:
+ * - Location: ./.ace-cache/{org_id}_{project_id}.db (project directory)
+ *             OR ~/.ace-cache/ (home directory, for production)
+ * - Purpose: Fast local cache, survives restarts
+ * - TTL: 5 minutes (configurable)
+ * - Source of truth: Remote server (ChromaDB)
+ *
+ * @package @ace-sdk/core
+ */
+import { StructuredPlaybook } from '../types/pattern.js';
+import { ILogger } from '../logger/index.js';
+export interface CacheConfig {
+    orgId: string;
+    projectId: string;
+    ttlMinutes?: number;
+    cacheDir?: string;
+}
+export declare class LocalCacheService {
+    private db;
+    private ttlMs;
+    private cacheDir;
+    private logger;
+    constructor(config: CacheConfig, logger?: ILogger);
+    /**
+     * Initialize SQLite schema
+     */
+    private initializeSchema;
+    /**
+     * Get cached playbook (if fresh)
+     */
+    getPlaybook(): StructuredPlaybook | null;
+    /**
+     * Save playbook to cache
+     */
+    savePlaybook(playbook: StructuredPlaybook): void;
+    /**
+     * Check if cache needs sync (>TTL)
+     */
+    needsSync(): boolean;
+    /**
+     * Get cached embedding (if exists)
+     */
+    getEmbedding(content: string): number[] | null;
+    /**
+     * Cache embedding
+     */
+    cacheEmbedding(content: string, embedding: number[]): void;
+    /**
+     * Get sync state value
+     */
+    getSyncState(key: string): string | null;
+    /**
+     * Set sync state value
+     */
+    setSyncState(key: string, value: string): void;
+    /**
+     * Clear entire cache
+     */
+    clear(): void;
+    /**
+     * Hash content for embedding cache key
+     */
+    private hashContent;
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=local-cache.d.ts.map

package/dist/cache/local-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-cache.d.ts","sourceRoot":"","sources":["../../src/cache/local-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,kBAAkB,EAAkB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO;IAoBjD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4CxB;;OAEG;IACH,WAAW,IAAI,kBAAkB,GAAG,IAAI;IA0CxC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IA2ChD;;OAEG;IACH,SAAS,IAAI,OAAO;IAYpB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAqB9C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAa1D;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/cache/local-cache.js

@@ -0,0 +1,227 @@
+/**
+ * LocalCacheService - Client-side SQLite cache
+ *
+ * Architecture:
+ * - Location: ./.ace-cache/{org_id}_{project_id}.db (project directory)
+ *             OR ~/.ace-cache/ (home directory, for production)
+ * - Purpose: Fast local cache, survives restarts
+ * - TTL: 5 minutes (configurable)
+ * - Source of truth: Remote server (ChromaDB)
+ *
+ * @package @ace-sdk/core
+ */
+import Database from 'better-sqlite3';
+import { join } from 'path';
+import { mkdirSync, existsSync } from 'fs';
+import { createHash } from 'crypto';
+export class LocalCacheService {
+    db;
+    ttlMs;
+    cacheDir;
+    logger;
+    constructor(config, logger) {
+        const { orgId, projectId, ttlMinutes = 5, cacheDir } = config;
+        this.logger = logger;
+        // Cache directory: Use provided cacheDir, or default to ./.ace-cache (project directory)
+        // For production, pass cacheDir: join(homedir(), '.ace-cache')
+        this.cacheDir = cacheDir || join(process.cwd(), '.ace-cache');
+        if (!existsSync(this.cacheDir)) {
+            mkdirSync(this.cacheDir, { recursive: true });
+        }
+        // Database file: {org_id}_{project_id}.db
+        const dbPath = join(this.cacheDir, `${orgId}_${projectId}.db`);
+        this.db = new Database(dbPath);
+        this.ttlMs = ttlMinutes * 60 * 1000;
+        this.initializeSchema();
+    }
+    /**
+     * Initialize SQLite schema
+     */
+    initializeSchema() {
+        // Table: playbook_bullets (cached from server)
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS playbook_bullets (
+        id TEXT PRIMARY KEY,
+        section TEXT NOT NULL,
+        content TEXT NOT NULL,
+        helpful INTEGER DEFAULT 0,
+        harmful INTEGER DEFAULT 0,
+        confidence REAL DEFAULT 0.5,
+        observations INTEGER DEFAULT 0,
+        evidence TEXT,
+        created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+        last_used TEXT DEFAULT CURRENT_TIMESTAMP,
+        synced_at TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_section ON playbook_bullets(section);
+      CREATE INDEX IF NOT EXISTS idx_confidence ON playbook_bullets(confidence);
+      CREATE INDEX IF NOT EXISTS idx_helpful ON playbook_bullets(helpful DESC);
+    `);
+        // Table: embedding_cache (avoid re-computing)
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS embedding_cache (
+        content_hash TEXT PRIMARY KEY,
+        embedding BLOB NOT NULL,
+        created_at TEXT NOT NULL
+      );
+    `);
+        // Table: sync_state (metadata)
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS sync_state (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+    `);
+        // Enable WAL mode for better concurrent access performance
+        this.db.pragma('journal_mode = WAL');
+    }
+    /**
+     * Get cached playbook (if fresh)
+     */
+    getPlaybook() {
+        if (this.needsSync()) {
+            return null; // Cache stale
+        }
+        const bullets = this.db.prepare(`
+      SELECT * FROM playbook_bullets
+    `).all();
+        if (bullets.length === 0) {
+            return null; // No cache
+        }
+        // Group by section
+        const playbook = {
+            strategies_and_hard_rules: [],
+            useful_code_snippets: [],
+            troubleshooting_and_pitfalls: [],
+            apis_to_use: []
+        };
+        for (const row of bullets) {
+            const bullet = {
+                id: row.id,
+                section: row.section,
+                content: row.content,
+                helpful: row.helpful,
+                harmful: row.harmful,
+                confidence: row.confidence,
+                observations: row.observations,
+                evidence: row.evidence ? JSON.parse(row.evidence) : [],
+                created_at: row.created_at,
+                last_used: row.last_used
+            };
+            playbook[bullet.section].push(bullet);
+        }
+        this.logger?.debug('Cache hit (SQLite)');
+        return playbook;
+    }
+    /**
+     * Save playbook to cache
+     */
+    savePlaybook(playbook) {
+        const now = new Date().toISOString();
+        // Clear old data
+        this.db.prepare('DELETE FROM playbook_bullets').run();
+        // Insert all bullets
+        const insert = this.db.prepare(`
+      INSERT INTO playbook_bullets (
+        id, section, content, helpful, harmful, confidence,
+        observations, evidence, created_at, last_used, synced_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const insertMany = this.db.transaction((bullets, section) => {
+            for (const bullet of bullets) {
+                insert.run(bullet.id, section, bullet.content, bullet.helpful, bullet.harmful, bullet.confidence, bullet.observations, JSON.stringify(bullet.evidence), bullet.created_at || now, bullet.last_used || now, now);
+            }
+        });
+        insertMany(playbook.strategies_and_hard_rules, 'strategies_and_hard_rules');
+        insertMany(playbook.useful_code_snippets, 'useful_code_snippets');
+        insertMany(playbook.troubleshooting_and_pitfalls, 'troubleshooting_and_pitfalls');
+        insertMany(playbook.apis_to_use, 'apis_to_use');
+        // Update sync state
+        this.setSyncState('last_sync', now);
+        this.logger?.debug('Playbook cached to SQLite');
+    }
+    /**
+     * Check if cache needs sync (>TTL)
+     */
+    needsSync() {
+        const lastSync = this.getSyncState('last_sync');
+        if (!lastSync) {
+            return true; // No sync yet
+        }
+        const lastSyncTime = new Date(lastSync).getTime();
+        const now = Date.now();
+        return (now - lastSyncTime) > this.ttlMs;
+    }
+    /**
+     * Get cached embedding (if exists)
+     */
+    getEmbedding(content) {
+        const hash = this.hashContent(content);
+        const row = this.db.prepare(`
+      SELECT embedding FROM embedding_cache WHERE content_hash = ?
+    `).get(hash);
+        if (!row) {
+            return null;
+        }
+        // Deserialize Float32Array from buffer
+        const float32 = new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4);
+        return Array.from(float32);
+    }
+    /**
+     * Cache embedding
+     */
+    cacheEmbedding(content, embedding) {
+        const hash = this.hashContent(content);
+        // Serialize Float32Array to buffer
+        const float32 = new Float32Array(embedding);
+        const buffer = Buffer.from(float32.buffer);
+        this.db.prepare(`
+      INSERT OR REPLACE INTO embedding_cache (content_hash, embedding, created_at)
+      VALUES (?, ?, ?)
+    `).run(hash, buffer, new Date().toISOString());
+    }
+    /**
+     * Get sync state value
+     */
+    getSyncState(key) {
+        const row = this.db.prepare(`
+      SELECT value FROM sync_state WHERE key = ?
+    `).get(key);
+        return row?.value || null;
+    }
+    /**
+     * Set sync state value
+     */
+    setSyncState(key, value) {
+        this.db.prepare(`
+      INSERT OR REPLACE INTO sync_state (key, value, updated_at)
+      VALUES (?, ?, ?)
+    `).run(key, value, new Date().toISOString());
+    }
+    /**
+     * Clear entire cache
+     */
+    clear() {
+        this.db.exec(`
+      DELETE FROM playbook_bullets;
+      DELETE FROM embedding_cache;
+      DELETE FROM sync_state;
+    `);
+        this.logger?.debug('Cache cleared');
+    }
+    /**
+     * Hash content for embedding cache key
+     */
+    hashContent(content) {
+        return createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=local-cache.js.map

package/dist/cache/local-cache.js.map

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

package/dist/cache/session-storage.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Session Storage - Persistent pattern pinning for context compaction
+ *
+ * Allows patterns retrieved during UserPromptSubmit hook to be "pinned" to a session
+ * and later recalled during PreCompact hook without redundant server calls.
+ *
+ * Storage: ~/.ace-cache/sessions.db (SQLite)
+ * TTL: 24 hours (survives cache expiry)
+ *
+ * @package @ace-sdk/core
+ */
+import { PlaybookBullet } from '../types/pattern.js';
+import { ILogger } from '../logger/index.js';
+export interface SessionPin {
+    sessionId: string;
+    query: string;
+    threshold: number;
+    topK: number;
+    patterns: PlaybookBullet[];
+    createdAt: number;
+    expiresAt: number;
+}
+export interface SessionPinResult {
+    similar_patterns: PlaybookBullet[];
+    count: number;
+    threshold: number;
+    top_k: number;
+    session_id: string;
+    pinned_at: number;
+    expires_at: number;
+}
+export interface SessionStorageConfig {
+    cacheDir?: string;
+}
+export declare class SessionStorage {
+    private db;
+    private dbPath;
+    private logger;
+    private static readonly SESSION_TTL_MS;
+    constructor(config?: SessionStorageConfig, logger?: ILogger);
+    /**
+     * Initialize session storage database
+     */
+    initialize(): Promise<void>;
+    /**
+     * Pin patterns to a session
+     */
+    pinSession(sessionId: string, query: string, patterns: PlaybookBullet[], threshold: number, topK: number): Promise<void>;
+    /**
+     * Recall patterns for a session
+     */
+    recallSession(sessionId: string): Promise<SessionPinResult | null>;
+    /**
+     * Delete a specific session
+     */
+    deleteSession(sessionId: string): Promise<boolean>;
+    /**
+     * Cleanup expired sessions (called on initialization and periodically)
+     */
+    cleanupExpiredSessions(): Promise<number>;
+    /**
+     * List all active sessions
+     */
+    listSessions(): Promise<Array<{
+        sessionId: string;
+        query: string;
+        patternCount: number;
+        createdAt: number;
+        expiresAt: number;
+    }>>;
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=session-storage.d.ts.map

package/dist/cache/session-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-storage.d.ts","sourceRoot":"","sources":["../../src/cache/session-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAuB;gBAEjD,MAAM,CAAC,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,OAAO;IAY3D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CjC;;OAEG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,EAAE,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAyChB;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAoDxE;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBxD;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC;IAqB/C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAmCH;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd"}