@rbalchii/anchor-engine 4.7.0

package/engine/dist/routes/v1/system.js

@@ -0,0 +1,326 @@
+import { db } from '../../core/db.js';
+import { getState, clearState } from '../../services/scribe/scribe.js';
+export function setupSystemRoutes(app) {
+    // GET /v1/stats - System statistics (anchor_stats tool)
+    app.get('/v1/stats', async (_req, res) => {
+        try {
+            const startTime = Date.now();
+            // Get counts in parallel
+            const [atomsResult, sourcesResult, tagsResult, moleculesResult] = await Promise.all([
+                db.run('SELECT COUNT(*) as count FROM atoms'),
+                db.run('SELECT COUNT(*) as count FROM sources'),
+                db.run('SELECT COUNT(DISTINCT tag) as count FROM tags WHERE tag IS NOT NULL'),
+                db.run('SELECT COUNT(*) as count FROM molecules')
+            ]);
+            const stats = {
+                atoms: parseInt(atomsResult.rows?.[0]?.count || '0'),
+                sources: parseInt(sourcesResult.rows?.[0]?.count || '0'),
+                tags: parseInt(tagsResult.rows?.[0]?.count || '0'),
+                molecules: parseInt(moleculesResult.rows?.[0]?.count || '0'),
+                query_time_ms: Date.now() - startTime
+            };
+            res.status(200).json(stats);
+        }
+        catch (error) {
+            console.error('Stats retrieval error:', error);
+            res.status(500).json({ error: 'Failed to retrieve stats' });
+        }
+    });
+    // Scribe State Endpoints
+    app.get('/v1/scribe/state', async (_req, res) => {
+        try {
+            const state = await getState();
+            res.status(200).json({ state });
+        }
+        catch (e) {
+            res.status(500).json({ error: e.message });
+        }
+    });
+    app.delete('/v1/scribe/state', async (_req, res) => {
+        try {
+            const result = await clearState();
+            res.status(200).json(result);
+        }
+        catch (e) {
+            res.status(500).json({ error: e.message });
+        }
+    });
+    // System config endpoint
+    app.get('/v1/system/config', (_req, res) => {
+        res.status(200).json({
+            status: 'success',
+            config: {
+                version: '1.0.0',
+                engine: 'Sovereign Context Engine',
+                timestamp: new Date().toISOString()
+            }
+        });
+    });
+    // Memory status endpoint
+    app.get('/v1/system/memory', async (_req, res) => {
+        try {
+            const { resourceManager } = await import('../../utils/resource-manager.js');
+            const { idleManager } = await import('../../services/idle-manager.js');
+            const { NlpService } = await import('../../services/nlp/nlp-service.js');
+            const { isModelLoadedStatus: isNerModelLoaded } = await import('../../services/tags/gliner.js');
+            const memoryStats = resourceManager.getMemoryStats();
+            const idleStatus = idleManager.getStatus();
+            res.status(200).json({
+                status: 'success',
+                memory: {
+                    rss: Math.round(memoryStats.rss / 1024 / 1024),
+                    heapUsed: Math.round(memoryStats.heapUsed / 1024 / 1024),
+                    heapTotal: Math.round(memoryStats.heapTotal / 1024 / 1024),
+                    percentageUsed: Math.round(memoryStats.percentageUsed * 100) / 100
+                },
+                idle: idleStatus,
+                models: {
+                    nlpLoaded: NlpService.isModelLoadedStatus(),
+                    nerLoaded: isNerModelLoaded()
+                },
+                timestamp: new Date().toISOString()
+            });
+        }
+        catch (e) {
+            res.status(500).json({ error: e.message });
+        }
+    });
+    // Watcher Path Endpoints
+    // GET /v1/system/paths - List currently watched paths
+    app.get('/v1/system/paths', async (_req, res) => {
+        try {
+            const { getWatchedPaths } = await import('../../services/ingest/watchdog.js');
+            const paths = getWatchedPaths();
+            res.status(200).json({ paths });
+        }
+        catch (e) {
+            res.status(500).json({ error: e.message });
+        }
+    });
+    // POST /v1/system/paths - Add a new path to watch
+    app.post('/v1/system/paths', async (req, res) => {
+        try {
+            const { path } = req.body;
+            if (!path) {
+                res.status(400).json({ error: 'Path is required' });
+                return;
+            }
+            const { addWatchPath } = await import('../../services/ingest/watchdog.js');
+            const success = await addWatchPath(path);
+            res.status(200).json({
+                status: success ? 'success' : 'failed',
+                message: success ? `Now watching: ${path}` : 'Failed to add path',
+                path
+            });
+        }
+        catch (e) {
+            console.error('[API] Failed to add watch path:', e);
+            res.status(500).json({ error: e.message });
+        }
+    });
+    // DELETE /v1/system/paths - Remove a watched path
+    app.delete('/v1/system/paths', async (req, res) => {
+        try {
+            const { path } = req.body;
+            if (!path) {
+                res.status(400).json({ error: 'Path is required' });
+                return;
+            }
+            const { removeWatchPath } = await import('../../services/ingest/watchdog.js');
+            const success = await removeWatchPath(path);
+            res.status(200).json({
+                status: success ? 'success' : 'failed',
+                message: success ? `Stopped watching: ${path}` : 'Failed to remove path',
+                path
+            });
+        }
+        catch (e) {
+            console.error('[API] Failed to remove watch path:', e);
+            res.status(500).json({ error: e.message });
+        }
+    });
+    // POST /v1/system/explorer - Open file explorer at specified path
+    app.post('/v1/system/explorer', async (req, res) => {
+        try {
+            const { path } = req.body;
+            if (!path) {
+                res.status(400).json({ error: 'Path is required' });
+                return;
+            }
+            const { execFile } = await import('child_process');
+            const util = await import('util');
+            const pathModule = await import('path');
+            const { PROJECT_ROOT } = await import('../../config/paths.js');
+            const execFilePromise = util.promisify(execFile);
+            const platform = process.platform;
+            // Security: Resolve requested directory to absolute path and verify it's within PROJECT_ROOT
+            const absoluteRequestedDir = pathModule.resolve(path);
+            const relativePath = pathModule.relative(PROJECT_ROOT, absoluteRequestedDir);
+            // Check if it's an outside directory (e.g. starts with ..) or an absolute path (on Windows)
+            const isOutside = relativePath.startsWith('..') || pathModule.isAbsolute(relativePath);
+            if (isOutside && absoluteRequestedDir !== PROJECT_ROOT) {
+                console.warn(`[System] Rejected unauthorized explorer access: ${path} (resolved: ${absoluteRequestedDir})`);
+                return res.status(403).json({ error: 'Directory not authorized for explorer access' });
+            }
+            // Open file explorer based on platform safely using execFile
+            if (platform === 'win32') {
+                await execFilePromise('explorer.exe', [absoluteRequestedDir]);
+            }
+            else if (platform === 'darwin') {
+                await execFilePromise('open', [absoluteRequestedDir]);
+            }
+            else {
+                await execFilePromise('xdg-open', [absoluteRequestedDir]);
+            }
+            res.status(200).json({
+                status: 'success',
+                message: `Opened file explorer at: ${absoluteRequestedDir}`
+            });
+        }
+        catch (e) {
+            console.error('[API] Failed to open file explorer:', e);
+            res.status(500).json({ error: e.message });
+        }
+    });
+    // Configuration endpoint to provide runtime configuration to clients
+    app.get('/v1/config', async (_req, res) => {
+        try {
+            // Import config here to avoid circular dependencies
+            const { config } = await import('../../config/index.js');
+            const serverConfig = {
+                port: config.PORT,
+                host: config.HOST,
+                server_url: `http://${config.HOST}:${config.PORT}`,
+                llm_provider: config.LLM_PROVIDER,
+                search_strategy: config.SEARCH.strategy,
+                features: config.FEATURES
+            };
+            res.status(200).json(serverConfig);
+        }
+        catch (error) {
+            console.error('Config endpoint error:', error);
+            res.status(500).json({
+                error: error.message,
+                fallback_config: {
+                    port: 3160,
+                    host: '127.0.0.1',
+                    server_url: 'http://127.0.0.1:3160'
+                }
+            });
+        }
+    });
+    // Watchdog control endpoints
+    app.get('/v1/watchdog/status', async (_req, res) => {
+        try {
+            const { getWatcherStatus } = await import('../../services/ingest/watchdog.js');
+            const status = getWatcherStatus();
+            res.status(200).json({ status: 'success', ...status });
+        }
+        catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+    app.post('/v1/watchdog/start', async (_req, res) => {
+        try {
+            const { startWatchdog } = await import('../../services/ingest/watchdog.js');
+            await startWatchdog();
+            res.status(200).json({ status: 'success', message: 'Watchdog started' });
+        }
+        catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+    app.post('/v1/watchdog/stop', async (_req, res) => {
+        try {
+            const { stopWatchdog } = await import('../../services/ingest/watchdog.js');
+            await stopWatchdog();
+            res.status(200).json({ status: 'success', message: 'Watchdog stopped' });
+        }
+        catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+    app.post('/v1/watchdog/ingest', async (_req, res) => {
+        try {
+            const { triggerManualIngest } = await import('../../services/ingest/watchdog.js');
+            const result = await triggerManualIngest();
+            res.status(200).json(result);
+        }
+        catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+    // System status endpoint
+    app.get('/v1/system/status', async (_req, res) => {
+        try {
+            const { systemStatus } = await import('../../services/system-status.js');
+            const status = systemStatus.getStatus();
+            res.json({
+                status: 'success',
+                ...status
+            });
+        }
+        catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+    // File read endpoint for distilled content
+    app.get('/v1/files/read', async (req, res) => {
+        try {
+            const filePath = req.query.path;
+            if (!filePath) {
+                res.status(400).json({ error: 'Path parameter required' });
+                return;
+            }
+            const fs = await import('fs');
+            const path = await import('path');
+            // Security: Canonicalize paths to prevent symlink traversal attacks
+            // Get realpath of base directory (inbox/distilled)
+            const baseDir = path.resolve(process.cwd(), 'inbox', 'distilled');
+            let realBaseDir;
+            try {
+                realBaseDir = await fs.promises.realpath(baseDir);
+            }
+            catch {
+                res.status(500).json({ error: 'Base directory not accessible' });
+                return;
+            }
+            // Resolve and canonicalize requested path
+            const resolvedPath = path.resolve(filePath);
+            let realFilePath;
+            try {
+                realFilePath = await fs.promises.realpath(resolvedPath);
+            }
+            catch {
+                res.status(404).json({ error: 'File not found' });
+                return;
+            }
+            // Verify file is within allowed directory using path.relative
+            const relativePath = path.relative(realBaseDir, realFilePath);
+            if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
+                res.status(403).json({ error: 'Access denied: file outside allowed directory' });
+                return;
+            }
+            // Additional checks: must end with .yaml and be a file
+            if (!realFilePath.endsWith('.yaml')) {
+                res.status(403).json({ error: 'Access denied: only .yaml files allowed' });
+                return;
+            }
+            const stats = await fs.promises.stat(realFilePath);
+            if (!stats.isFile()) {
+                res.status(403).json({ error: 'Access denied: not a regular file' });
+                return;
+            }
+            const content = await fs.promises.readFile(realFilePath, 'utf-8');
+            res.json({
+                status: 'success',
+                path: filePath,
+                content: content
+            });
+        }
+        catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+}
+//# sourceMappingURL=system.js.map

package/engine/dist/routes/v1/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/routes/v1/system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,UAAU,iBAAiB,CAAC,GAAgB;IAChD,wDAAwD;IACxD,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAC1D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,yBAAyB;YACzB,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAClF,EAAE,CAAC,GAAG,CAAC,qCAAqC,CAAC;gBAC7C,EAAE,CAAC,GAAG,CAAC,uCAAuC,CAAC;gBAC/C,EAAE,CAAC,GAAG,CAAC,qEAAqE,CAAC;gBAC7E,EAAE,CAAC,GAAG,CAAC,yCAAyC,CAAC;aAClD,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG;gBACZ,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC;gBACpD,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC;gBACxD,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC;gBAClD,SAAS,EAAE,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC;gBAC5D,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACtC,CAAC;YAEF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YAC/C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACjE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC/B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;YAClC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QAC5D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE;gBACN,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,0BAA0B;gBAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAClE,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;YAC5E,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YACvE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YACzE,MAAM,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;YAEhG,MAAM,WAAW,GAAG,eAAe,CAAC,cAAc,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;YAE3C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE;oBACN,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;oBAC9C,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;oBACxD,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;oBAC1D,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,GAAG;iBACnE;gBACD,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE;oBACN,SAAS,EAAE,UAAU,CAAC,mBAAmB,EAAE;oBAC3C,SAAS,EAAE,gBAAgB,EAAE;iBAC9B;gBACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,sDAAsD;IACtD,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACjE,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAC9E,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;YAChC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,kDAAkD;IAClD,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACjE,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;YAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAC3E,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YAEzC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;gBACtC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,oBAAoB;gBACjE,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;YACpD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,kDAAkD;IAClD,GAAG,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;YAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;YAE5C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;gBACtC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC,uBAAuB;gBACxE,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,CAAC,CAAC,CAAC;YACvD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,kEAAkE;IAClE,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACpE,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;YAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YAElC,6FAA6F;YAC7F,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;YAE7E,4FAA4F;YAC5F,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YAEvF,IAAI,SAAS,IAAI,oBAAoB,KAAK,YAAY,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,mDAAmD,IAAI,eAAe,oBAAoB,GAAG,CAAC,CAAC;gBAC5G,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC,CAAC;YACzF,CAAC;YAED,6DAA6D;YAC7D,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,MAAM,eAAe,CAAC,cAAc,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAChE,CAAC;iBAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC5D,CAAC;YAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,4BAA4B,oBAAoB,EAAE;aAC5D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;YACxD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,qEAAqE;IACrE,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAC3D,IAAI,CAAC;YACH,oDAAoD;YACpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAEzD,MAAM,YAAY,GAAG;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,UAAU,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE;gBAClD,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;gBACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC;YAEF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YAC/C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,eAAe,EAAE;oBACf,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,WAAW;oBACjB,UAAU,EAAE,uBAAuB;iBACpC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACpE,IAAI,CAAC;YACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;YAClC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACpE,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAC5E,MAAM,aAAa,EAAE,CAAC;YACtB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAC3E,MAAM,YAAY,EAAE,CAAC;YACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACrE,IAAI,CAAC;YACH,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAClF,MAAM,MAAM,GAAG,MAAM,mBAAmB,EAAE,CAAC;YAC3C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAClE,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC;YACxC,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,SAAS;gBACjB,GAAG,MAAM;aACV,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC9D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAc,CAAC;YAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,CAAC;gBAC3D,OAAO;YACT,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;YAElC,oEAAoE;YACpE,mDAAmD;YACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAClE,IAAI,WAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;gBACjE,OAAO;YACT,CAAC;YAED,0CAA0C;YAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,YAAoB,CAAC;YACzB,IAAI,CAAC;gBACH,YAAY,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YAED,8DAA8D;YAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAC9D,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC,CAAC;gBACjF,OAAO;YACT,CAAC;YAED,uDAAuD;YACvD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC,CAAC;gBAC3E,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC;gBACrE,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAClE,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/engine/dist/routes/v1/tags.d.ts

@@ -0,0 +1,3 @@
+import { Application } from 'express';
+export declare function setupTagsRoutes(app: Application): void;
+//# sourceMappingURL=tags.d.ts.map

package/engine/dist/routes/v1/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../../src/routes/v1/tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAqB,MAAM,SAAS,CAAC;AAGzD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,QA2H/C"}

package/engine/dist/routes/v1/tags.js

@@ -0,0 +1,102 @@
+import { db } from '../../core/db.js';
+export function setupTagsRoutes(app) {
+    // Get all buckets
+    app.get('/v1/buckets', async (_req, res) => {
+        try {
+            // Improved Bucket Retrieval: Use the tags table which is much lighter (Atomic Architecture)
+            const result = await db.run('SELECT DISTINCT bucket FROM tags WHERE bucket IS NOT NULL ORDER BY bucket');
+            const allBuckets = new Set();
+            if (result.rows) {
+                for (const row of result.rows) {
+                    const b = row.bucket;
+                    if (b && typeof b === 'string')
+                        allBuckets.add(b);
+                }
+            }
+            res.status(200).json([...allBuckets].sort());
+        }
+        catch (error) {
+            console.error('Bucket retrieval error:', error);
+            res.status(500).json({ error: 'Failed to retrieve buckets' });
+        }
+    });
+    // POST /v1/buckets - Create a new bucket
+    app.post('/v1/buckets', async (req, res) => {
+        try {
+            const { name, location } = req.body;
+            if (!name || !name.trim()) {
+                return res.status(400).json({ error: 'Bucket name is required' });
+            }
+            const bucketName = name.trim();
+            // Validate location if provided
+            const validLocations = ['inbox', 'external-inbox'];
+            if (location && !validLocations.includes(location)) {
+                return res.status(400).json({
+                    error: `Invalid location. Must be one of: ${validLocations.join(', ')}`
+                });
+            }
+            // Check if bucket already exists
+            const existingResult = await db.run('SELECT DISTINCT bucket FROM tags WHERE bucket = $1', [bucketName]);
+            if (existingResult.rows && existingResult.rows.length > 0) {
+                return res.status(409).json({
+                    error: 'Bucket already exists',
+                    exists: true,
+                    bucket: bucketName
+                });
+            }
+            // Create a placeholder tag entry to register the bucket
+            // This makes the bucket visible in the list
+            const placeholderTag = `_bucket_${bucketName}`;
+            await db.run(`INSERT INTO tags (atom_id, tag, bucket) VALUES ($1, $2, $3)
+         ON CONFLICT (atom_id, tag, bucket) DO NOTHING`, ['__system__', placeholderTag, bucketName]);
+            // Store bucket metadata in engrams
+            const bucketMetadata = {
+                name: bucketName,
+                location: location || 'inbox',
+                created_at: new Date().toISOString(),
+                source: 'manual'
+            };
+            await db.run(`INSERT INTO engrams (key, value) VALUES ($1, $2)
+         ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value`, [`bucket_meta_${bucketName}`, JSON.stringify(bucketMetadata)]);
+            console.log(`[API] Created bucket: ${bucketName} at location: ${location || 'inbox'}`);
+            res.status(201).json({
+                success: true,
+                bucket: bucketName,
+                location: location || 'inbox'
+            });
+        }
+        catch (error) {
+            console.error('[API] Bucket creation error:', error);
+            res.status(500).json({ error: `Failed to create bucket: ${error.message}` });
+        }
+    });
+    // Get all tags (Faceted by Bucket)
+    app.get('/v1/tags', async (req, res) => {
+        try {
+            const bucketsParam = req.query['buckets'];
+            const buckets = bucketsParam ? bucketsParam.split(',') : [];
+            // Optimized for PGlite: Use tags table directly
+            let query = 'SELECT DISTINCT tag FROM tags WHERE tag IS NOT NULL';
+            const params = [];
+            if (buckets.length > 0) {
+                query += ` AND bucket = ANY($1)`;
+                params.push(buckets);
+            }
+            query += ' ORDER BY tag LIMIT 5000';
+            const result = await db.run(query, params);
+            const allTags = new Set();
+            if (result.rows) {
+                for (const row of result.rows) {
+                    if (row.tag)
+                        allTags.add(row.tag);
+                }
+            }
+            res.status(200).json([...allTags].sort());
+        }
+        catch (error) {
+            console.error('Tag retrieval error:', error);
+            res.status(500).json({ error: 'Failed to retrieve tags' });
+        }
+    });
+}
+//# sourceMappingURL=tags.js.map

package/engine/dist/routes/v1/tags.js.map

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

package/engine/dist/server-8080.d.ts

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

package/engine/dist/server-8080.d.ts.map

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

package/engine/dist/server-8080.js

@@ -0,0 +1,74 @@
+import express from 'express';
+import cors from 'cors';
+import bodyParser from 'body-parser';
+import { setupRoutes } from './routes/api.js';
+import { db } from './core/db.js';
+import { PathManager } from './utils/path-manager.js';
+// Initialize path manager
+const pathManager = PathManager.getInstance();
+// Initialize database
+console.log('Initializing database...');
+db.init().then(() => {
+    console.log('Database initialized successfully');
+    // Create Express app
+    const app = express();
+    // Middleware
+    app.use(cors());
+    app.use(bodyParser.json({ limit: '50mb' }));
+    app.use(bodyParser.urlencoded({ extended: true }));
+    // Health check endpoint
+    app.get('/health', (req, res) => {
+        res.status(200).json({
+            status: 'healthy',
+            timestamp: new Date().toISOString(),
+            service: 'Anchor Engine Chat Server (Port 8080)'
+        });
+    });
+    // Setup API routes
+    setupRoutes(app);
+    // Error handling middleware
+    app.use((err, req, res, next) => {
+        console.error('Server Error:', err);
+        res.status(500).json({ error: 'Internal Server Error' });
+    });
+    // Start server
+    const PORT = 8080;
+    app.listen(PORT, () => {
+        console.log(`\x1b[36mAnchor Engine Chat Server running on port ${PORT}\x1b[0m`);
+        console.log(`Health check available at http://localhost:${PORT}/health`);
+        console.log('Ready to serve chat completions for Qwen Code CLI...');
+    });
+}).catch((error) => {
+    console.error('Failed to initialize database:', error);
+    // If database initialization fails, try to continue without it for basic API functionality
+    console.warn('Continuing without database access - some features may not work');
+    // Create Express app anyway
+    const app = express();
+    // Middleware
+    app.use(cors());
+    app.use(bodyParser.json({ limit: '50mb' }));
+    app.use(bodyParser.urlencoded({ extended: true }));
+    // Health check endpoint
+    app.get('/health', (req, res) => {
+        res.status(200).json({
+            status: 'healthy',
+            timestamp: new Date().toISOString(),
+            service: 'ECE Chat Server (Port 8080) - DB unavailable'
+        });
+    });
+    // Setup API routes
+    setupRoutes(app);
+    // Error handling middleware
+    app.use((err, req, res, next) => {
+        console.error('Server Error:', err);
+        res.status(500).json({ error: 'Internal Server Error' });
+    });
+    // Start server
+    const PORT = 8080;
+    app.listen(PORT, () => {
+        console.log(`\x1b[36mECE Chat Server running on port ${PORT}\x1b[0m`);
+        console.log(`Health check available at http://localhost:${PORT}/health`);
+        console.log('Ready to serve chat completions for Qwen Code CLI...');
+    });
+});
+//# sourceMappingURL=server-8080.js.map

package/engine/dist/server-8080.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-8080.js","sourceRoot":"","sources":["../src/server-8080.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,0BAA0B;AAC1B,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;AAE9C,sBAAsB;AACtB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACxC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IAClB,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IAEjD,qBAAqB;IACrB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,aAAa;IACb,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5C,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEnD,wBAAwB;IACxB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,uCAAuC;SACjD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjB,4BAA4B;IAC5B,GAAG,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,GAAoB,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;QAC5F,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,MAAM,IAAI,GAAG,IAAI,CAAC;IAClB,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,qDAAqD,IAAI,SAAS,CAAC,CAAC;QAChF,OAAO,CAAC,GAAG,CAAC,8CAA8C,IAAI,SAAS,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;IACvD,2FAA2F;IAC3F,OAAO,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAEhF,4BAA4B;IAC5B,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,aAAa;IACb,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5C,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEnD,wBAAwB;IACxB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,8CAA8C;SACxD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjB,4BAA4B;IAC5B,GAAG,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,GAAoB,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;QAC5F,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,MAAM,IAAI,GAAG,IAAI,CAAC;IAClB,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,2CAA2C,IAAI,SAAS,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,8CAA8C,IAAI,SAAS,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/engine/dist/services/backup/backup-restore.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Backup Restore Service - "Phoenix Protocol"
+ *
+ * Restores database AND rebuilds inbox/external-inbox folder structure from backup.
+ * This ensures the source of truth (filesystem) matches the backup state.
+ */
+export interface RestoreStats {
+    memory_count: number;
+    source_count: number;
+    engram_count: number;
+    files_restored: number;
+    inbox_restored: number;
+    external_inbox_restored: number;
+    timestamp: string;
+}
+/**
+ * Phoenix Protocol: Full system restore from backup
+ * - Restores database tables (atoms, sources, engrams)
+ * - Rebuilds inbox/external-inbox folder structure from source_path
+ * - Preserves original file content from atom content aggregation
+ */
+export declare function restoreFromBackup(filename: string): Promise<RestoreStats>;
+/**
+ * Get the latest backup file
+ */
+export declare function getLatestBackup(): Promise<string | null>;
+/**
+ * Check if a backup exists and is valid (optimized for massive files up to 100GB+)
+ */
+export declare function validateBackup(filename: string): Promise<{
+    valid: boolean;
+    error?: string;
+    size?: number;
+    sizeFormatted?: string;
+    note?: string;
+}>;
+//# sourceMappingURL=backup-restore.d.ts.map

package/engine/dist/services/backup/backup-restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-restore.d.ts","sourceRoot":"","sources":["../../../src/services/backup/backup-restore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACrB;AA0BD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA+H/E;AAuOD;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS9D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5D,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAmDD"}