@ace-sdk/core 1.0.0

package/dist/client/ace-client.js

@@ -0,0 +1,454 @@
+/**
+ * ACE Server Client - HTTP REST API client with 3-tier cache
+ *
+ * Architecture:
+ * 1. RAM cache (fastest, lost on restart)
+ * 2. SQLite cache (fast, survives restart)
+ * 3. Remote server (slow, source of truth)
+ *
+ * @package @ace-sdk/core
+ */
+import { LocalCacheService } from '../cache/local-cache.js';
+export class AceClient {
+    config;
+    localCache;
+    memoryCache; // RAM cache
+    logger;
+    // Config cache (v3.6.0+) - 1-hour TTL (configurable)
+    configCache = { data: null, timestamp: 0 };
+    CONFIG_CACHE_TTL = 60 * 60 * 1000; // 60 minutes (1 hour)
+    constructor(config, options) {
+        this.config = config;
+        this.logger = options?.logger;
+        // Support both AceConfig (legacy) and AceContext (new)
+        const serverUrl = config.serverUrl;
+        const apiToken = config.apiToken;
+        const projectId = config.projectId;
+        const orgId = 'orgId' in config ? config.orgId : this.extractOrgId(apiToken);
+        const cacheTtlMinutes = config.cacheTtlMinutes;
+        // Initialize local SQLite cache (optional - graceful fallback for Node 25+)
+        try {
+            const cacheConfig = {
+                orgId: orgId || 'default',
+                projectId,
+                ttlMinutes: cacheTtlMinutes
+            };
+            this.localCache = new LocalCacheService(cacheConfig, this.logger);
+            this.logger?.debug(`SQLite cache enabled (TTL: ${cacheTtlMinutes} minutes)`);
+        }
+        catch (error) {
+            // Graceful fallback for Node.js 25+ (better-sqlite3 not yet supported)
+            this.localCache = null;
+            this.logger?.debug(`SQLite cache disabled (${error.message})`);
+            this.logger?.debug('Using RAM-only cache (degraded performance)');
+            if (process.version.startsWith('v25')) {
+                this.logger?.debug('Node.js 25 detected - SQLite support coming soon');
+            }
+        }
+        this.logger?.debug(`ACE Server: ${serverUrl}`);
+        this.logger?.debug(`API Token: ${apiToken.substring(0, 15)}...`);
+        this.logger?.debug(`Project: ${projectId}`);
+        if (orgId && orgId !== 'default') {
+            this.logger?.debug(`Organization: ${orgId}`);
+        }
+    }
+    /**
+     * Extract org_id from API token
+     * Format: ace_{base64_with_org_id}
+     */
+    extractOrgId(apiToken) {
+        // Simple extraction - token format varies
+        // Fallback to hash if can't extract
+        if (!apiToken.startsWith('ace_')) {
+            return 'default';
+        }
+        // For now, use first 8 chars after ace_ as org identifier
+        return apiToken.substring(4, 12);
+    }
+    async request(endpoint, method, body) {
+        const url = `${this.config.serverUrl}${endpoint}`;
+        // Trace logging: outgoing request
+        if (this.logger?.isTrace()) {
+            this.logger.trace(`→ ${method} ${endpoint}`);
+            if (body) {
+                // Truncate large bodies in trace output
+                const bodyStr = JSON.stringify(body);
+                const truncated = bodyStr.length > 500 ? bodyStr.substring(0, 500) + '...' : bodyStr;
+                this.logger.trace(`Request body: ${truncated}`);
+            }
+        }
+        const startTime = Date.now();
+        const response = await fetch(url, {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.config.apiToken}`,
+                'X-ACE-Project': this.config.projectId
+            },
+            body: body ? JSON.stringify(body) : undefined
+        });
+        const duration = Date.now() - startTime;
+        // Trace logging: response status
+        if (this.logger?.isTrace()) {
+            this.logger.trace(`← ${response.status} ${response.statusText} (${duration}ms)`);
+        }
+        if (!response.ok) {
+            const error = await response.text();
+            if (this.logger?.isTrace()) {
+                this.logger.trace(`Error response: ${error}`);
+            }
+            throw new Error(`Server error (${response.status}): ${error}`);
+        }
+        const result = await response.json();
+        // Trace logging: response body
+        if (this.logger?.isTrace()) {
+            const resultStr = JSON.stringify(result);
+            const truncated = resultStr.length > 500 ? resultStr.substring(0, 500) + '...' : resultStr;
+            this.logger.trace(`Response body: ${truncated}`);
+        }
+        return result;
+    }
+    /**
+     * Save structured playbook to server
+     * Server endpoint: POST /patterns (saves individual bullets)
+     */
+    async savePlaybook(playbook) {
+        // Flatten playbook into array of bullets
+        const allBullets = [
+            ...playbook.strategies_and_hard_rules,
+            ...playbook.useful_code_snippets,
+            ...playbook.troubleshooting_and_pitfalls,
+            ...playbook.apis_to_use
+        ];
+        // Server expects: POST /patterns with array of bullets
+        await this.request('/patterns', 'POST', { patterns: allBullets });
+    }
+    /**
+     * Get structured playbook (3-tier cache: RAM → SQLite → Server)
+     * Endpoint: GET /playbook
+     */
+    async getPlaybook(params) {
+        const forceRefresh = params?.forceRefresh ?? false;
+        const include_metadata = params?.include_metadata ?? true;
+        // 1. Check RAM cache (fastest)
+        if (!forceRefresh && this.memoryCache) {
+            this.logger?.info('Cache hit (RAM)');
+            return {
+                playbook: this.memoryCache,
+                total_bullets: this.countBullets(this.memoryCache),
+                metadata: undefined
+            };
+        }
+        // 2. Check SQLite cache (if available and fresh)
+        if (!forceRefresh && this.localCache && !this.localCache.needsSync()) {
+            const cached = this.localCache.getPlaybook();
+            if (cached) {
+                this.memoryCache = cached;
+                this.logger?.info('Cache hit (SQLite)');
+                return {
+                    playbook: cached,
+                    total_bullets: this.countBullets(cached),
+                    metadata: undefined
+                };
+            }
+        }
+        // 3. Fetch from server
+        this.logger?.info('Fetching playbook from server...');
+        const result = await this.request(`/playbook?include_metadata=${include_metadata}`, 'GET');
+        const playbook = result.playbook || {
+            strategies_and_hard_rules: [],
+            useful_code_snippets: [],
+            troubleshooting_and_pitfalls: [],
+            apis_to_use: []
+        };
+        // Update caches
+        this.memoryCache = playbook;
+        if (this.localCache) {
+            this.localCache.savePlaybook(playbook);
+        }
+        return {
+            playbook,
+            total_bullets: result.total_bullets || this.countBullets(playbook),
+            metadata: result.metadata
+        };
+    }
+    /**
+     * Count total bullets across all playbook sections
+     */
+    countBullets(playbook) {
+        return (playbook.strategies_and_hard_rules.length +
+            playbook.useful_code_snippets.length +
+            playbook.troubleshooting_and_pitfalls.length +
+            playbook.apis_to_use.length);
+    }
+    /**
+     * Compute embeddings for texts (with SQLite cache if available)
+     * Endpoint: POST /embeddings
+     */
+    async computeEmbeddings(texts) {
+        if (texts.length === 0)
+            return [];
+        const embeddings = [];
+        const uncachedTexts = [];
+        const uncachedIndices = [];
+        // Check cache for each text
+        if (this.localCache) {
+            for (let i = 0; i < texts.length; i++) {
+                const cached = this.localCache.getEmbedding(texts[i]);
+                if (cached) {
+                    embeddings[i] = cached;
+                }
+                else {
+                    uncachedTexts.push(texts[i]);
+                    uncachedIndices.push(i);
+                }
+            }
+        }
+        else {
+            uncachedTexts.push(...texts);
+            uncachedIndices.push(...texts.map((_, i) => i));
+        }
+        // Compute uncached embeddings from server
+        if (uncachedTexts.length > 0) {
+            this.logger?.info(`Computing ${uncachedTexts.length} embeddings...`);
+            const result = await this.request('/embeddings', 'POST', { texts: uncachedTexts });
+            // Fill in results and cache them
+            for (let i = 0; i < result.embeddings.length; i++) {
+                const embedding = result.embeddings[i];
+                const originalIndex = uncachedIndices[i];
+                embeddings[originalIndex] = embedding;
+                if (this.localCache) {
+                    this.localCache.cacheEmbedding(uncachedTexts[i], embedding);
+                }
+            }
+        }
+        return embeddings;
+    }
+    /**
+     * Semantic search for relevant patterns
+     * Endpoint: POST /patterns/search
+     */
+    async searchPatterns(params) {
+        const { query, section, threshold, top_k, include_metadata = true } = params;
+        if (threshold === undefined) {
+            throw new Error('searchPatterns called without threshold');
+        }
+        const now = new Date().toISOString();
+        const tempId = `temp_search_${Date.now()}`;
+        const url = `/patterns/search?include_metadata=${include_metadata}`;
+        const body = {
+            pattern: {
+                id: tempId,
+                content: query,
+                confidence: 0.8,
+                created_at: now,
+                section: section || 'general'
+            },
+            threshold
+        };
+        if (top_k !== undefined) {
+            body.top_k = top_k;
+        }
+        const result = await this.request(url, 'POST', body);
+        return {
+            similar_patterns: result.similar_patterns || [],
+            count: result.count ?? (result.similar_patterns?.length || 0),
+            threshold: result.threshold ?? threshold,
+            top_k: result.top_k,
+            domains_summary: result.domains_summary,
+            metadata: result.metadata
+        };
+    }
+    /**
+     * Get top patterns by helpful score
+     * Endpoint: GET /patterns/top
+     */
+    async getTopPatterns(params) {
+        const { section, limit = 10, min_helpful = 0 } = params;
+        const queryParams = new URLSearchParams();
+        if (section)
+            queryParams.append('section', section);
+        queryParams.append('limit', String(limit));
+        queryParams.append('min_helpful', String(min_helpful));
+        const result = await this.request(`/patterns/top?${queryParams.toString()}`, 'GET');
+        return result.top_patterns || [];
+    }
+    /**
+     * Get playbook analytics
+     * Endpoint: GET /analytics
+     */
+    async getAnalytics() {
+        return this.request('/analytics', 'GET');
+    }
+    /**
+     * Clear entire playbook
+     * Server endpoint: DELETE /patterns
+     */
+    async clearPlaybook() {
+        await this.request('/patterns?confirm=true', 'DELETE');
+        this.invalidateCache();
+    }
+    /**
+     * Apply delta operation (ADD/UPDATE/DELETE)
+     * Server endpoint: POST /delta
+     */
+    async applyDelta(operation) {
+        await this.request('/delta', 'POST', operation);
+        this.invalidateCache();
+    }
+    /**
+     * Apply multiple delta operations in batch
+     */
+    async applyDeltas(operations) {
+        for (const operation of operations) {
+            await this.applyDelta(operation);
+        }
+    }
+    /**
+     * Store execution trace for server-side analysis
+     * Server endpoint: POST /traces
+     */
+    async storeExecutionTrace(trace) {
+        return this.request('/traces', 'POST', trace);
+    }
+    /**
+     * Bootstrap playbook from extracted code blocks
+     * Server endpoint: POST /bootstrap
+     */
+    async bootstrap(params) {
+        return this.request('/bootstrap', 'POST', params);
+    }
+    /**
+     * Initialize playbook from git repository (server-side)
+     * Server endpoint: POST /init
+     */
+    async initializeFromRepo(params) {
+        return this.request('/init', 'POST', params);
+    }
+    /**
+     * Get playbook status/statistics
+     * Server endpoint: GET /analytics
+     */
+    async getStatus() {
+        return this.getAnalytics();
+    }
+    /**
+     * Invalidate caches (force refresh on next call)
+     */
+    invalidateCache() {
+        this.memoryCache = undefined;
+        this.logger?.debug('Cache invalidated');
+    }
+    /**
+     * Get server configuration with caching (v3.6.0+)
+     * Server endpoint: GET /api/v1/config
+     */
+    async getConfig(useCache = true) {
+        if (useCache) {
+            const now = Date.now();
+            const isValid = this.configCache.data &&
+                (now - this.configCache.timestamp) < this.CONFIG_CACHE_TTL;
+            if (isValid) {
+                this.logger?.debug('Config cache hit (RAM)');
+                return this.configCache.data;
+            }
+        }
+        this.logger?.info('Fetching config from server...');
+        const config = await this.request('/api/v1/config', 'GET');
+        this.configCache = {
+            data: config,
+            timestamp: Date.now()
+        };
+        return config;
+    }
+    /**
+     * Verify API token and fetch organization info
+     * Server endpoint: GET /api/v1/config/verify
+     */
+    async verifyToken() {
+        return this.request('/api/v1/config/verify', 'GET');
+    }
+    /**
+     * Batch retrieve patterns by ID (v3.6.0+)
+     * Server endpoint: POST /patterns/batch
+     */
+    async batchGetPatterns(patternIds) {
+        if (patternIds.length === 0) {
+            return { patterns: [], found_count: 0, not_found: [] };
+        }
+        const MAX_BATCH = 50;
+        const chunks = [];
+        for (let i = 0; i < patternIds.length; i += MAX_BATCH) {
+            chunks.push(patternIds.slice(i, i + MAX_BATCH));
+        }
+        this.logger?.info(`Batch fetching ${patternIds.length} patterns in ${chunks.length} chunk(s)...`);
+        const results = await Promise.all(chunks.map(chunk => this.request('/patterns/batch', 'POST', { pattern_ids: chunk })));
+        const allPatterns = results.flatMap(r => r.patterns || []);
+        const totalFound = results.reduce((sum, r) => sum + (r.found_count || 0), 0);
+        const allNotFound = results.flatMap(r => r.not_found || []);
+        return {
+            patterns: allPatterns,
+            found_count: totalFound,
+            not_found: allNotFound
+        };
+    }
+    /**
+     * Summarize a recorded session
+     * Server endpoint: POST /api/v1/summarize
+     */
+    async summarizeSession(sessionData) {
+        return this.request('/api/v1/summarize', 'POST', { session: sessionData });
+    }
+    /**
+     * Clear config cache
+     */
+    clearConfigCache() {
+        this.configCache = { data: null, timestamp: 0 };
+        this.logger?.debug('Config cache cleared');
+    }
+    /**
+     * Get local cache instance
+     */
+    getLocalCache() {
+        return this.localCache;
+    }
+    /**
+     * Update server configuration (v3.6.0+)
+     * Server endpoint: PUT /api/v1/config?scope=project
+     */
+    async updateConfig(settings, scope = 'project') {
+        try {
+            this.logger?.debug(`Updating config (scope=${scope})`);
+            const config = await this.request(`/api/v1/config?scope=${scope}`, 'PUT', settings);
+            this.configCache = { data: null, timestamp: 0 };
+            this.logger?.debug('Config updated successfully');
+            return config;
+        }
+        catch (error) {
+            if (error.message?.includes('404') || error.message?.includes('501')) {
+                throw new Error('This ACE Server does not support configuration updates. Please upgrade to ACE Server v3.6.0+');
+            }
+            throw error;
+        }
+    }
+    /**
+     * Reset server configuration to defaults (v3.9.0+)
+     * Server endpoint: POST /api/v1/config/reset?scope=project
+     */
+    async resetConfig(scope = 'project') {
+        try {
+            this.logger?.debug(`Resetting config (scope=${scope})`);
+            const result = await this.request(`/api/v1/config/reset?scope=${scope}`, 'POST');
+            this.configCache = { data: null, timestamp: 0 };
+            this.logger?.debug('Config reset successfully');
+            return result;
+        }
+        catch (error) {
+            if (error.message?.includes('404') || error.message?.includes('501')) {
+                throw new Error('This ACE Server does not support configuration reset. Please upgrade to ACE Server v3.9.0+');
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=ace-client.js.map

package/dist/client/ace-client.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Client exports for @ace-sdk/core
+ */
+export { AceClient } from './ace-client.js';
+export type { AceClientOptions } from './ace-client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,5 @@
+/**
+ * Client exports for @ace-sdk/core
+ */
+export { AceClient } from './ace-client.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/config/context.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Context Creation and Resolution
+ * @package @ace-sdk/core
+ */
+import type { AceContext, ServerConfig, ResolvedContext, ResolveContextOptions } from '../types/config.js';
+import { ConfigOverrides } from './loader.js';
+import { ILogger } from '../logger/index.js';
+/**
+ * Resolves org and project context using 3-tier precedence:
+ *
+ * 1. CLI flags (--org, --project) - HIGHEST PRIORITY
+ * 2. Environment variables (ACE_ORG_ID, ACE_PROJECT_ID)
+ * 3. Error - NO CONTEXT FOUND
+ *
+ * Note: .claude/settings.json is NOT read by this function. That's Claude Code's job.
+ * Claude Code reads .claude/settings.json and sets ACE_ORG_ID/ACE_PROJECT_ID as ENV vars.
+ *
+ * @param options - CLI flags and working directory
+ * @returns Resolved org and project IDs with source
+ * @throws Error if no context can be resolved
+ */
+export declare function resolveContext(options?: ResolveContextOptions): ResolvedContext;
+/**
+ * Validates that an org ID matches the expected format
+ */
+export declare function isValidOrgId(orgId: string): boolean;
+/**
+ * Validates that a project ID matches the expected format
+ */
+export declare function isValidProjectId(projectId: string): boolean;
+/**
+ * Create AceContext from CLI flags, environment, and config files
+ *
+ * This function implements the complete context resolution flow:
+ * 1. Resolve org/project using 4-tier precedence (flags > env > .claude/settings.json > error)
+ * 2. Load global config to get server URL and tokens
+ * 3. Get the correct token for the resolved organization
+ * 4. Merge with server-derived runtime settings
+ *
+ * @param options - CLI flags for org/project override
+ * @param serverConfig - Optional server configuration (fetched via ACEServerClient.getConfig())
+ * @param configOverrides - Optional config overrides
+ * @param logger - Optional logger
+ * @returns Complete runtime context with merged settings
+ * @throws Error if context cannot be resolved
+ */
+export declare function createContext(options?: ResolveContextOptions, serverConfig?: ServerConfig, configOverrides?: ConfigOverrides, logger?: ILogger): Promise<AceContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/config/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/config/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,UAAU,EAEV,YAAY,EACZ,eAAe,EACf,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAc,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAS7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,eAAe,CA8DnF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,qBAA0B,EACnC,YAAY,CAAC,EAAE,YAAY,EAC3B,eAAe,CAAC,EAAE,eAAe,EACjC,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,UAAU,CAAC,CAkCrB"}