stellar-memory 0.5.0

package/dist/api/routes/system.js

@@ -0,0 +1,70 @@
+import { Hono } from 'hono';
+import { statSync } from 'node:fs';
+import { getMemoriesByProject } from '../../storage/queries.js';
+import { recalculateOrbits } from '../../engine/orbit.js';
+import { getConfig } from '../../utils/config.js';
+import { ORBIT_ZONES } from '../../engine/types.js';
+import { emitOrbitRecalculated } from '../websocket.js';
+const app = new Hono();
+// GET /api/system/status — overall system status
+app.get('/status', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const config = getConfig();
+    const memories = getMemoriesByProject(project);
+    let dbSizeBytes = 0;
+    try {
+        dbSizeBytes = statSync(config.dbPath).size;
+    }
+    catch {
+        // DB file may not be accessible in some environments
+    }
+    const zoneBreakdown = {};
+    for (const zone of Object.keys(ORBIT_ZONES)) {
+        const { min, max } = ORBIT_ZONES[zone];
+        zoneBreakdown[zone] = memories.filter((m) => m.distance >= min && m.distance < max).length;
+    }
+    return c.json({
+        ok: true,
+        data: {
+            project,
+            memory_count: memories.length,
+            db_size_bytes: dbSizeBytes,
+            db_path: config.dbPath,
+            zone_breakdown: zoneBreakdown,
+        },
+    });
+});
+// POST /api/system/orbit — trigger orbit recalculation
+app.post('/orbit', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const config = getConfig();
+    const changes = recalculateOrbits(project, config);
+    emitOrbitRecalculated(project, { changes_count: changes.length });
+    return c.json({
+        ok: true,
+        changes_count: changes.length,
+        data: changes,
+    });
+});
+// GET /api/system/zones — per-zone statistics
+app.get('/zones', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const memories = getMemoriesByProject(project);
+    const zones = Object.keys(ORBIT_ZONES).map((zone) => {
+        const { min, max, label } = ORBIT_ZONES[zone];
+        const zoneMemories = memories.filter((m) => m.distance >= min && m.distance < max);
+        return {
+            zone,
+            label,
+            min_au: min,
+            max_au: max,
+            count: zoneMemories.length,
+            avg_importance: zoneMemories.length > 0
+                ? zoneMemories.reduce((s, m) => s + m.importance, 0) / zoneMemories.length
+                : 0,
+        };
+    });
+    return c.json({ ok: true, data: zones, project });
+});
+export default app;
+//# sourceMappingURL=system.js.map

package/dist/api/routes/system.js.map

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

package/dist/api/routes/temporal.d.ts

@@ -0,0 +1,13 @@
+/**
+ * routes/temporal.ts — Temporal Awareness API routes
+ *
+ * GET  /api/temporal/at        — getContextAtTime (query: timestamp, project)
+ * GET  /api/temporal/chain/:id — getEvolutionChain
+ * GET  /api/temporal/summary   — getTemporalSummary
+ * POST /api/temporal/bounds/:id — setTemporalBounds
+ * POST /api/temporal/supersede  — supersedeMemory (body: oldId, newId)
+ */
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default app;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/api/routes/temporal.js

@@ -0,0 +1,82 @@
+/**
+ * routes/temporal.ts — Temporal Awareness API routes
+ *
+ * GET  /api/temporal/at        — getContextAtTime (query: timestamp, project)
+ * GET  /api/temporal/chain/:id — getEvolutionChain
+ * GET  /api/temporal/summary   — getTemporalSummary
+ * POST /api/temporal/bounds/:id — setTemporalBounds
+ * POST /api/temporal/supersede  — supersedeMemory (body: oldId, newId)
+ */
+import { Hono } from 'hono';
+import { getContextAtTime, getEvolutionChain, getTemporalSummary, setTemporalBounds, supersedeMemory, } from '../../engine/temporal.js';
+const app = new Hono();
+// GET /api/temporal/at?timestamp=ISO&project=default
+app.get('/at', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const timestamp = c.req.query('timestamp');
+    if (!timestamp) {
+        return c.json({ ok: false, error: 'timestamp query parameter is required' }, 400);
+    }
+    try {
+        const data = getContextAtTime(project, timestamp);
+        return c.json({ ok: true, data, project, timestamp });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Temporal query failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// GET /api/temporal/chain/:id
+app.get('/chain/:id', (c) => {
+    const id = c.req.param('id');
+    try {
+        const data = getEvolutionChain(id);
+        return c.json({ ok: true, data, memoryId: id });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Evolution chain failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// GET /api/temporal/summary?project=default
+app.get('/summary', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    try {
+        const text = getTemporalSummary(project);
+        return c.json({ ok: true, data: text, project });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Temporal summary failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// POST /api/temporal/bounds/:id — body: { valid_from?, valid_until? }
+app.post('/bounds/:id', async (c) => {
+    const id = c.req.param('id');
+    try {
+        const body = await c.req.json();
+        setTemporalBounds(id, body.valid_from, body.valid_until);
+        return c.json({ ok: true, id, valid_from: body.valid_from, valid_until: body.valid_until });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Set bounds failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// POST /api/temporal/supersede — body: { oldId, newId }
+app.post('/supersede', async (c) => {
+    try {
+        const body = await c.req.json();
+        if (!body.oldId || !body.newId) {
+            return c.json({ ok: false, error: 'oldId and newId are required' }, 400);
+        }
+        supersedeMemory(body.oldId, body.newId);
+        return c.json({ ok: true, oldId: body.oldId, newId: body.newId });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Supersede failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+export default app;
+//# sourceMappingURL=temporal.js.map

package/dist/api/routes/temporal.js.map

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

package/dist/api/server.d.ts

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

package/dist/api/server.js

@@ -0,0 +1,99 @@
+import { serve } from '@hono/node-server';
+import { serveStatic } from '@hono/node-server/serve-static';
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { existsSync, readFileSync } from 'node:fs';
+import { initDatabase } from '../storage/database.js';
+import { getConfig } from '../utils/config.js';
+import { createWebSocketServer, handleUpgrade } from './websocket.js';
+import memoriesRouter from './routes/memories.js';
+import sunRouter from './routes/sun.js';
+import systemRouter from './routes/system.js';
+import { scanRouter, sourcesRouter } from './routes/scan.js';
+import orbitRouter from './routes/orbit.js';
+import constellationRouter from './routes/constellation.js';
+import projectsRouter from './routes/projects.js';
+import analyticsRouter from './routes/analytics.js';
+import temporalRouter from './routes/temporal.js';
+import conflictsRouter from './routes/conflicts.js';
+import observationsRouter from './routes/observations.js';
+import consolidationRouter from './routes/consolidation.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const WEB_DIST = resolve(__dirname, '..', '..', 'web', 'dist');
+// ---------------------------------------------------------------------------
+// Bootstrap
+// ---------------------------------------------------------------------------
+const config = getConfig();
+initDatabase(config.dbPath);
+// ---------------------------------------------------------------------------
+// Application
+// ---------------------------------------------------------------------------
+const app = new Hono();
+// CORS — allow any localhost origin (Vite dev, Electron, any port)
+app.use('/*', cors({
+    origin: (origin) => {
+        if (/^https?:\/\/(localhost|127\.0\.0\.1)(:\d+)?$/.test(origin)) {
+            return origin;
+        }
+        return undefined;
+    },
+    allowMethods: ['GET', 'POST', 'PATCH', 'DELETE', 'OPTIONS'],
+}));
+// Health check
+app.get('/api/health', (c) => c.json({
+    name: 'stellar-memory-api',
+    version: '0.5.0',
+    status: 'ok',
+    uptime: process.uptime(),
+}));
+// Routers
+app.route('/api/memories', memoriesRouter);
+app.route('/api/sun', sunRouter);
+app.route('/api/system', systemRouter);
+app.route('/api/scan', scanRouter);
+app.route('/api/sources', sourcesRouter);
+app.route('/api/orbit', orbitRouter);
+app.route('/api/constellation', constellationRouter);
+app.route('/api/projects', projectsRouter);
+app.route('/api/analytics', analyticsRouter);
+app.route('/api/temporal', temporalRouter);
+app.route('/api/conflicts', conflictsRouter);
+app.route('/api/observations', observationsRouter);
+app.route('/api/consolidation', consolidationRouter);
+// ---------------------------------------------------------------------------
+// Static web dashboard (serve web/dist/ if it exists)
+// ---------------------------------------------------------------------------
+const hasWebDist = existsSync(join(WEB_DIST, 'index.html'));
+if (hasWebDist) {
+    // Serve static assets (JS, CSS, images)
+    app.use('/*', serveStatic({ root: WEB_DIST }));
+    // SPA fallback — non-API, non-asset routes return index.html
+    app.get('*', (c) => {
+        if (c.req.path.startsWith('/api/'))
+            return c.notFound();
+        const indexPath = join(WEB_DIST, 'index.html');
+        const html = readFileSync(indexPath, 'utf-8');
+        return c.html(html);
+    });
+}
+// Global error handler
+app.onError((err, c) => {
+    console.error('[stellar-api] error:', err);
+    return c.json({ ok: false, error: err.message ?? 'Internal server error' }, 500);
+});
+// 404
+app.notFound((c) => c.json({ ok: false, error: 'Not found' }, 404));
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+const port = parseInt(process.env.STELLAR_API_PORT ?? '21547', 10);
+const server = serve({ fetch: app.fetch, port }, (info) => {
+    console.log(`[stellar-api] listening on http://localhost:${info.port}`);
+    console.log(`[stellar-api] WebSocket available at ws://localhost:${info.port}/ws`);
+});
+// Initialize WebSocket server and attach upgrade handler
+createWebSocketServer();
+server.on('upgrade', handleUpgrade);
+//# sourceMappingURL=server.js.map

package/dist/api/server.js.map

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

package/dist/api/websocket.d.ts

@@ -0,0 +1,53 @@
+/**
+ * WebSocket event bus for real-time dashboard updates.
+ *
+ * Uses Node.js built-in EventEmitter as the internal event bus.
+ * Broadcasts JSON events to all connected WebSocket clients.
+ */
+import { EventEmitter } from 'node:events';
+import { WebSocketServer } from 'ws';
+import type { IncomingMessage } from 'node:http';
+import type { Duplex } from 'node:stream';
+export type WsEventType = 'memory:created' | 'memory:updated' | 'memory:deleted' | 'orbit:recalculated' | 'sun:updated' | 'system:status';
+export interface WsEvent {
+    type: WsEventType;
+    project?: string;
+    data?: unknown;
+    timestamp: number;
+}
+declare class StellarEventBus extends EventEmitter {
+    emit(event: WsEventType, payload: Omit<WsEvent, 'type' | 'timestamp'>): boolean;
+}
+export declare const eventBus: StellarEventBus;
+/**
+ * Create the WebSocketServer and wire it to the event bus.
+ * Call this once after the HTTP server is started.
+ */
+export declare function createWebSocketServer(): WebSocketServer;
+/**
+ * Handle HTTP upgrade request for the /ws path.
+ * Call this from the HTTP server's 'upgrade' event handler.
+ */
+export declare function handleUpgrade(req: IncomingMessage, socket: Duplex, head: Buffer): void;
+/**
+ * Emit a memory:created event.
+ */
+export declare function emitMemoryCreated(project: string, data: unknown): void;
+/**
+ * Emit a memory:updated event.
+ */
+export declare function emitMemoryUpdated(project: string, data: unknown): void;
+/**
+ * Emit a memory:deleted event.
+ */
+export declare function emitMemoryDeleted(project: string, data: unknown): void;
+/**
+ * Emit an orbit:recalculated event.
+ */
+export declare function emitOrbitRecalculated(project: string, data: unknown): void;
+/**
+ * Emit a sun:updated event.
+ */
+export declare function emitSunUpdated(project: string, data: unknown): void;
+export {};
+//# sourceMappingURL=websocket.d.ts.map

package/dist/api/websocket.js

@@ -0,0 +1,168 @@
+/**
+ * WebSocket event bus for real-time dashboard updates.
+ *
+ * Uses Node.js built-in EventEmitter as the internal event bus.
+ * Broadcasts JSON events to all connected WebSocket clients.
+ */
+import { EventEmitter } from 'node:events';
+import { WebSocketServer, WebSocket } from 'ws';
+// ---------------------------------------------------------------------------
+// Internal event bus (singleton)
+// ---------------------------------------------------------------------------
+class StellarEventBus extends EventEmitter {
+    emit(event, payload) {
+        return super.emit(event, { type: event, timestamp: Date.now(), ...payload });
+    }
+}
+export const eventBus = new StellarEventBus();
+// ---------------------------------------------------------------------------
+// WebSocket server
+// ---------------------------------------------------------------------------
+const HEARTBEAT_INTERVAL_MS = 30_000;
+const CLIENT_TIMEOUT_MS = 60_000;
+let wss = null;
+/**
+ * Create the WebSocketServer and wire it to the event bus.
+ * Call this once after the HTTP server is started.
+ */
+export function createWebSocketServer() {
+    wss = new WebSocketServer({ noServer: true });
+    // Forward all bus events to connected clients
+    const EVENTS = [
+        'memory:created',
+        'memory:updated',
+        'memory:deleted',
+        'orbit:recalculated',
+        'sun:updated',
+        'system:status',
+    ];
+    for (const eventType of EVENTS) {
+        eventBus.on(eventType, (payload) => {
+            broadcast(payload);
+        });
+    }
+    wss.on('connection', (ws) => {
+        const client = ws;
+        client.isAlive = true;
+        client.lastPong = Date.now();
+        // Send welcome message
+        safeSend(client, {
+            type: 'system:status',
+            data: { connected: true, message: 'Connected to Stellar Memory WebSocket' },
+            timestamp: Date.now(),
+        });
+        client.on('pong', () => {
+            client.isAlive = true;
+            client.lastPong = Date.now();
+        });
+        client.on('message', (data) => {
+            // Handle ping from client
+            try {
+                const msg = JSON.parse(data.toString());
+                if (msg.type === 'ping') {
+                    safeSend(client, { type: 'system:status', data: { pong: true }, timestamp: Date.now() });
+                }
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        });
+        client.on('error', () => {
+            // Swallow errors — client will be cleaned up on next heartbeat
+        });
+    });
+    // Heartbeat: detect dead connections
+    const heartbeat = setInterval(() => {
+        if (!wss)
+            return;
+        const now = Date.now();
+        wss.clients.forEach((ws) => {
+            const client = ws;
+            if (!client.isAlive || now - client.lastPong > CLIENT_TIMEOUT_MS) {
+                client.terminate();
+                return;
+            }
+            client.isAlive = false;
+            client.ping();
+        });
+    }, HEARTBEAT_INTERVAL_MS);
+    wss.on('close', () => {
+        clearInterval(heartbeat);
+    });
+    return wss;
+}
+/**
+ * Handle HTTP upgrade request for the /ws path.
+ * Call this from the HTTP server's 'upgrade' event handler.
+ */
+export function handleUpgrade(req, socket, head) {
+    if (!wss)
+        return;
+    const url = req.url ?? '';
+    if (url === '/ws' || url.startsWith('/ws?')) {
+        wss.handleUpgrade(req, socket, head, (ws) => {
+            wss.emit('connection', ws, req);
+        });
+    }
+    else {
+        socket.destroy();
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function broadcast(payload) {
+    if (!wss)
+        return;
+    const msg = JSON.stringify(payload);
+    wss.clients.forEach((ws) => {
+        if (ws.readyState === WebSocket.OPEN) {
+            ws.send(msg, (err) => {
+                if (err) {
+                    // Ignore send errors — client will be cleaned up by heartbeat
+                }
+            });
+        }
+    });
+}
+function safeSend(ws, payload) {
+    if (ws.readyState === WebSocket.OPEN) {
+        try {
+            ws.send(JSON.stringify(payload));
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+/**
+ * Emit a memory:created event.
+ */
+export function emitMemoryCreated(project, data) {
+    eventBus.emit('memory:created', { project, data });
+}
+/**
+ * Emit a memory:updated event.
+ */
+export function emitMemoryUpdated(project, data) {
+    eventBus.emit('memory:updated', { project, data });
+}
+/**
+ * Emit a memory:deleted event.
+ */
+export function emitMemoryDeleted(project, data) {
+    eventBus.emit('memory:deleted', { project, data });
+}
+/**
+ * Emit an orbit:recalculated event.
+ */
+export function emitOrbitRecalculated(project, data) {
+    eventBus.emit('orbit:recalculated', { project, data });
+}
+/**
+ * Emit a sun:updated event.
+ */
+export function emitSunUpdated(project, data) {
+    eventBus.emit('sun:updated', { project, data });
+}
+//# sourceMappingURL=websocket.js.map

package/dist/api/websocket.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Stellar Memory CLI entry point.
+ *
+ * Routes between:
+ *   - `stellar-memory`         → MCP server (stdio transport, default)
+ *   - `stellar-memory init`    → Setup wizard
+ *   - `stellar-memory setup`   → Download embedding model only
+ *   - `stellar-memory api`     → Start REST API server
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Stellar Memory CLI entry point.
+ *
+ * Routes between:
+ *   - `stellar-memory`         → MCP server (stdio transport, default)
+ *   - `stellar-memory init`    → Setup wizard
+ *   - `stellar-memory setup`   → Download embedding model only
+ *   - `stellar-memory api`     → Start REST API server
+ */
+const command = process.argv[2];
+switch (command) {
+    case 'init':
+        await import('./init.js');
+        break;
+    case 'setup': {
+        // Re-use the setup script
+        const { resolve, dirname } = await import('node:path');
+        const { fileURLToPath } = await import('node:url');
+        const { spawnSync } = await import('node:child_process');
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const setupPath = resolve(__dirname, '..', 'scripts', 'setup.mjs');
+        const result = spawnSync('node', [setupPath], { stdio: 'inherit', shell: true });
+        process.exit(result.status ?? 1);
+    }
+    case 'api':
+        await import('../api/server.js');
+        break;
+    default:
+        // No subcommand or unknown → start MCP server (stdio)
+        await import('../index.js');
+        break;
+}
+export {};
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhC,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,MAAM;QACT,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1B,MAAM;IAER,KAAK,OAAO,CAAC,CAAC,CAAC;QACb,0BAA0B;QAC1B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,KAAK;QACR,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACjC,MAAM;IAER;QACE,sDAAsD;QACtD,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC5B,MAAM;AACV,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * stellar-memory init — One-command setup for Stellar Memory MCP server.
+ *
+ * Usage:
+ *   npx stellar-memory init          # Configure Claude Code + download model
+ *   npx stellar-memory init --skip-model  # Skip embedding model download
+ */
+export {};
+//# sourceMappingURL=init.d.ts.map