stellar-memory 0.5.0

package/dist/api/routes/consolidation.js

@@ -0,0 +1,63 @@
+/**
+ * routes/consolidation.ts — Memory Consolidation API routes
+ *
+ * GET  /api/consolidation/candidates      — findConsolidationCandidates
+ * POST /api/consolidation/run             — runConsolidation
+ * GET  /api/consolidation/history/:id     — getConsolidationSources
+ */
+import { Hono } from 'hono';
+import { findConsolidationCandidates, runConsolidation, getConsolidationSources, } from '../../engine/consolidation.js';
+const app = new Hono();
+// GET /api/consolidation/candidates?project=default
+app.get('/candidates', async (c) => {
+    const project = c.req.query('project') ?? 'default';
+    try {
+        const candidates = await findConsolidationCandidates(project);
+        return c.json({
+            ok: true,
+            data: candidates.map(({ memories, similarity }) => ({
+                similarity,
+                memoryCount: memories.length,
+                memories: memories.map(m => ({
+                    id: m.id,
+                    type: m.type,
+                    summary: m.summary,
+                    distance: m.distance,
+                })),
+            })),
+            project,
+            total: candidates.length,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Find candidates failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// POST /api/consolidation/run — body: { project? }
+app.post('/run', async (c) => {
+    try {
+        const body = await c.req.json().catch(() => ({}));
+        const project = body.project ?? 'default';
+        const stats = await runConsolidation(project);
+        return c.json({ ok: true, data: stats, project });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Consolidation run failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// GET /api/consolidation/history/:id — get source memories for a consolidated memory
+app.get('/history/:id', (c) => {
+    const id = c.req.param('id');
+    try {
+        const sources = getConsolidationSources(id);
+        return c.json({ ok: true, data: sources, consolidatedId: id, total: sources.length });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Consolidation history failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+export default app;
+//# sourceMappingURL=consolidation.js.map

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

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

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

@@ -0,0 +1,4 @@
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default app;
+//# sourceMappingURL=constellation.d.ts.map

package/dist/api/routes/constellation.js

@@ -0,0 +1,84 @@
+import { Hono } from 'hono';
+import { getMemoryById } from '../../storage/queries.js';
+import { getConstellationGraph, findRelatedMemories, extractRelationships, suggestRelationships, cleanupEdges, } from '../../engine/constellation.js';
+const app = new Hono();
+// GET /api/constellation/:id — fetch constellation graph for a memory
+//
+// Query params:
+//   depth    (integer, 1–3, default 1)
+//   project  (default: "default")
+app.get('/:id', (c) => {
+    const id = c.req.param('id');
+    const project = c.req.query('project') ?? 'default';
+    const depthRaw = c.req.query('depth');
+    const depth = depthRaw ? Math.min(3, Math.max(1, parseInt(depthRaw, 10))) : 1;
+    const memory = getMemoryById(id);
+    if (!memory) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    const graph = getConstellationGraph(id, project, depth);
+    return c.json({ ok: true, data: graph });
+});
+// GET /api/constellation/:id/related — get related memories sorted by edge weight
+//
+// Query params:
+//   limit   (integer, default 10)
+//   project (default: "default")
+app.get('/:id/related', (c) => {
+    const id = c.req.param('id');
+    const project = c.req.query('project') ?? 'default';
+    const limitRaw = c.req.query('limit');
+    const limit = limitRaw ? parseInt(limitRaw, 10) : 10;
+    const memory = getMemoryById(id);
+    if (!memory) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    const related = findRelatedMemories(id, project, limit);
+    return c.json({ ok: true, data: related, total: related.length });
+});
+// GET /api/constellation/:id/suggest — suggest potential new relationships
+//
+// Query params:
+//   project (default: "default")
+app.get('/:id/suggest', (c) => {
+    const id = c.req.param('id');
+    const project = c.req.query('project') ?? 'default';
+    const memory = getMemoryById(id);
+    if (!memory) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    const suggestions = suggestRelationships(id, project);
+    return c.json({ ok: true, data: suggestions, total: suggestions.length });
+});
+// POST /api/constellation/:id/extract — trigger relationship extraction for a memory
+//
+// Useful for reprocessing existing memories that were created before the
+// constellation system was active.
+app.post('/:id/extract', async (c) => {
+    const id = c.req.param('id');
+    const project = c.req.query('project') ?? 'default';
+    const memory = getMemoryById(id);
+    if (!memory) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    try {
+        const edges = await extractRelationships(memory, project);
+        return c.json({ ok: true, data: edges, total: edges.length });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Extraction failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// DELETE /api/constellation/:id — remove all edges for a memory
+app.delete('/:id', (c) => {
+    const id = c.req.param('id');
+    const memory = getMemoryById(id);
+    if (!memory) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    cleanupEdges(id);
+    return c.json({ ok: true, id });
+});
+export default app;
+//# sourceMappingURL=constellation.js.map

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

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

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

@@ -0,0 +1,4 @@
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default app;
+//# sourceMappingURL=memories.d.ts.map

package/dist/api/routes/memories.js

@@ -0,0 +1,219 @@
+import { Hono } from 'hono';
+import { getMemoriesByProject, getMemoryById, softDeleteMemory, } from '../../storage/queries.js';
+import { ORBIT_ZONES } from '../../engine/types.js';
+import { distanceToImportance } from '../../engine/orbit.js';
+import { updateMemoryOrbit, insertOrbitLog } from '../../storage/queries.js';
+import { createMemory, recallMemoriesAsync, forgetMemory } from '../../engine/planet.js';
+import { emitMemoryCreated, emitMemoryDeleted, emitMemoryUpdated } from '../websocket.js';
+const app = new Hono();
+// GET /api/memories — list memories with optional filters
+//
+// Query params:
+//   project (default: "default")
+//   zone    (core | near | active | archive | fading | forgotten)
+//   limit   (integer)
+app.get('/', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const zone = c.req.query('zone');
+    const limitParam = c.req.query('limit');
+    const limit = limitParam ? parseInt(limitParam, 10) : undefined;
+    const summaryOnly = c.req.query('summary_only') === 'true';
+    let memories = getMemoriesByProject(project);
+    if (zone && zone in ORBIT_ZONES) {
+        const { min, max } = ORBIT_ZONES[zone];
+        memories = memories.filter((m) => m.distance >= min && m.distance < max);
+    }
+    if (limit && limit > 0) {
+        memories = memories.slice(0, limit);
+    }
+    if (summaryOnly) {
+        const slim = memories.map((m) => ({
+            id: m.id,
+            summary: m.summary,
+            type: m.type,
+            distance: m.distance,
+            importance: m.importance,
+        }));
+        return c.json({ ok: true, data: slim, total: slim.length });
+    }
+    return c.json({ ok: true, data: memories, total: memories.length });
+});
+// GET /api/memories/search — hybrid search (FTS5 + vector KNN via RRF)
+//
+// Query params:
+//   q       (required) search query string
+//   project (default: "default")
+//   type    (decision | observation | task | context | error | milestone)
+//   max_au  (float) exclude memories beyond this orbital distance
+//   limit   (default: 10)
+app.get('/search', async (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const q = c.req.query('q') ?? '';
+    const type = c.req.query('type');
+    const zone = c.req.query('zone');
+    const maxAuRaw = c.req.query('max_au');
+    const limitRaw = c.req.query('limit');
+    // Zone → distance range mapping
+    const ZONE_RANGE = {
+        core: { min: 0.1, max: 1.0 }, near: { min: 1.0, max: 5.0 },
+        active: { min: 5.0, max: 15.0 }, archive: { min: 15.0, max: 40.0 },
+        fading: { min: 40.0, max: 70.0 }, forgotten: { min: 70.0, max: 100.0 },
+    };
+    const zoneRange = zone && ZONE_RANGE[zone] ? ZONE_RANGE[zone] : undefined;
+    const minDistance = zoneRange ? zoneRange.min : undefined;
+    const maxDistance = maxAuRaw ? parseFloat(maxAuRaw)
+        : zoneRange ? zoneRange.max : undefined;
+    const limit = limitRaw ? parseInt(limitRaw, 10) : 10;
+    // When q is empty but type/zone filters are set, filter without full-text search
+    if (!q.trim()) {
+        let memories = getMemoriesByProject(project);
+        if (type && type !== 'all') {
+            memories = memories.filter((m) => m.type === type);
+        }
+        if (minDistance !== undefined) {
+            memories = memories.filter((m) => m.distance >= minDistance);
+        }
+        if (maxDistance !== undefined) {
+            memories = memories.filter((m) => m.distance < maxDistance);
+        }
+        if (limit > 0) {
+            memories = memories.slice(0, limit);
+        }
+        return c.json({ ok: true, data: memories, total: memories.length, query: q });
+    }
+    try {
+        const memories = await recallMemoriesAsync(project, q.trim(), {
+            type: type ?? 'all',
+            minDistance: minDistance,
+            maxDistance: maxDistance,
+            limit: limit > 0 ? limit : 10,
+        });
+        return c.json({ ok: true, data: memories, total: memories.length, query: q });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Search failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// GET /api/memories/:id — single memory by ID
+app.get('/:id', (c) => {
+    const id = c.req.param('id');
+    const memory = getMemoryById(id);
+    if (!memory) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    return c.json({ ok: true, data: memory });
+});
+// POST /api/memories — create a new memory
+app.post('/', async (c) => {
+    let body;
+    try {
+        body = await c.req.json();
+    }
+    catch {
+        return c.json({ ok: false, error: 'Invalid JSON body' }, 400);
+    }
+    const content = body.content;
+    const summary = body.summary;
+    const type = body.type;
+    const project = body.project ?? 'default';
+    const tags = body.tags;
+    const impact = body.impact;
+    if (!content || !content.trim()) {
+        return c.json({ ok: false, error: 'content is required' }, 400);
+    }
+    const memory = createMemory({ project, content, summary, type, impact, tags });
+    emitMemoryCreated(project, memory);
+    return c.json({ ok: true, data: memory }, 201);
+});
+// POST /api/memories/:id/forget — forget a memory (push to Forgotten or soft-delete)
+//
+// Body:
+//   { mode: 'push' | 'delete' }
+//   'push'  — moves memory to the Forgotten zone (distance ≈ 95 AU), stays searchable
+//   'delete' — soft-deletes the memory (excluded from all queries)
+app.post('/:id/forget', async (c) => {
+    const id = c.req.param('id');
+    const existing = getMemoryById(id);
+    if (!existing) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    let body = {};
+    try {
+        body = await c.req.json();
+    }
+    catch {
+        // Body is optional — default to 'push' mode
+    }
+    const mode = body.mode ?? 'push';
+    if (mode !== 'push' && mode !== 'delete') {
+        return c.json({ ok: false, error: 'mode must be "push" or "delete"' }, 400);
+    }
+    try {
+        forgetMemory(id, mode);
+        emitMemoryDeleted(existing.project, { id, mode });
+        return c.json({ ok: true, id, mode });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Forget failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// PATCH /api/memories/:id/orbit — manually set orbit distance (drag & drop)
+//
+// Body:
+//   { distance: number }  — new orbital distance in AU (0.1–100)
+app.patch('/:id/orbit', async (c) => {
+    const id = c.req.param('id');
+    const memory = getMemoryById(id);
+    if (!memory) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    let body;
+    try {
+        body = await c.req.json();
+    }
+    catch {
+        return c.json({ ok: false, error: 'Invalid JSON body' }, 400);
+    }
+    const newDistance = body.distance;
+    if (typeof newDistance !== 'number' || newDistance < 0.1 || newDistance > 100) {
+        return c.json({ ok: false, error: 'distance must be a number between 0.1 and 100' }, 400);
+    }
+    const newImportance = distanceToImportance(newDistance);
+    const velocity = newDistance - memory.distance;
+    updateMemoryOrbit(id, newDistance, newImportance, velocity);
+    const change = {
+        memory_id: id,
+        project: memory.project,
+        old_distance: memory.distance,
+        new_distance: newDistance,
+        old_importance: memory.importance,
+        new_importance: newImportance,
+        trigger: 'manual',
+    };
+    insertOrbitLog(change);
+    emitMemoryUpdated(memory.project, { id, new_distance: newDistance, new_importance: newImportance });
+    return c.json({
+        ok: true,
+        data: {
+            id,
+            old_distance: memory.distance,
+            new_distance: newDistance,
+            old_importance: memory.importance,
+            new_importance: newImportance,
+        },
+    });
+});
+// DELETE /api/memories/:id — soft delete (legacy endpoint, kept for compatibility)
+app.delete('/:id', (c) => {
+    const id = c.req.param('id');
+    const memory = getMemoryById(id);
+    if (!memory) {
+        return c.json({ ok: false, error: 'Memory not found' }, 404);
+    }
+    softDeleteMemory(id);
+    return c.json({ ok: true, id });
+});
+export default app;
+//# sourceMappingURL=memories.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * routes/observations.ts — Observational Memory API routes
+ *
+ * POST /api/observations/process — processConversation
+ * GET  /api/observations          — getObservations (query: project, limit)
+ */
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default app;
+//# sourceMappingURL=observations.d.ts.map

package/dist/api/routes/observations.js

@@ -0,0 +1,42 @@
+/**
+ * routes/observations.ts — Observational Memory API routes
+ *
+ * POST /api/observations/process — processConversation
+ * GET  /api/observations          — getObservations (query: project, limit)
+ */
+import { Hono } from 'hono';
+import { processConversation } from '../../engine/observation.js';
+import { getObservations } from '../../storage/queries.js';
+const app = new Hono();
+// POST /api/observations/process — body: { conversation, project? }
+app.post('/process', async (c) => {
+    try {
+        const body = await c.req.json();
+        if (!body.conversation || typeof body.conversation !== 'string') {
+            return c.json({ ok: false, error: 'conversation (string) is required in request body' }, 400);
+        }
+        const project = body.project ?? 'default';
+        const stats = await processConversation(body.conversation, project);
+        return c.json({ ok: true, data: stats, project });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Observation processing failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// GET /api/observations?project=default&limit=20
+app.get('/', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const limitParam = c.req.query('limit');
+    const limit = limitParam ? parseInt(limitParam, 10) : 20;
+    try {
+        const data = getObservations(project, limit > 0 ? limit : 20);
+        return c.json({ ok: true, data, project, total: data.length });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Get observations failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+export default app;
+//# sourceMappingURL=observations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observations.js","sourceRoot":"","sources":["../../../src/api/routes/observations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;AAEvB,oEAAoE;AACpE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAgD,CAAC;QAE9E,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YAChE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mDAAmD,EAAE,EAAE,GAAG,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC;QAC1C,MAAM,KAAK,GAAK,MAAM,mBAAmB,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEtE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC;QACrF,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,iDAAiD;AACjD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;IACjB,MAAM,OAAO,GAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;IACvD,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,KAAK,GAAQ,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC;QAC/E,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,eAAe,GAAG,CAAC"}

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

@@ -0,0 +1,4 @@
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default app;
+//# sourceMappingURL=orbit.d.ts.map

package/dist/api/routes/orbit.js

@@ -0,0 +1,71 @@
+import { Hono } from 'hono';
+import { recalculateOrbits } from '../../engine/orbit.js';
+import { getDatabase } from '../../storage/database.js';
+import { getConfig } from '../../utils/config.js';
+const app = new Hono();
+// POST /api/orbit — trigger a full orbit recalculation for a project
+//
+// Query params:
+//   project (default: "default")
+app.post('/', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const config = getConfig();
+    try {
+        const changes = recalculateOrbits(project, config);
+        return c.json({ ok: true, data: changes, changes_count: changes.length });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Orbit recalculation failed';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+// GET /api/orbit/history — recent orbit log entries for a project
+//
+// Query params:
+//   project (default: "default")
+//   limit   (default: 50, max: 200)
+//   trigger ("decay" | "access" | "forget" — optional filter)
+app.get('/history', (c) => {
+    const project = c.req.query('project') ?? 'default';
+    const limitParam = c.req.query('limit');
+    const trigger = c.req.query('trigger');
+    const limit = Math.min(200, Math.max(1, limitParam ? parseInt(limitParam, 10) : 50));
+    try {
+        const db = getDatabase();
+        let rows;
+        if (trigger) {
+            rows = db.prepare(`
+        SELECT * FROM orbit_log
+        WHERE project = ? AND trigger = ?
+        ORDER BY created_at DESC
+        LIMIT ?
+      `).all(project, trigger, limit);
+        }
+        else {
+            rows = db.prepare(`
+        SELECT * FROM orbit_log
+        WHERE project = ?
+        ORDER BY created_at DESC
+        LIMIT ?
+      `).all(project, limit);
+        }
+        const entries = rows.map((r) => ({
+            id: r.id,
+            memory_id: r.memory_id,
+            project: r.project,
+            old_distance: r.old_distance,
+            new_distance: r.new_distance,
+            old_importance: r.old_importance,
+            new_importance: r.new_importance,
+            trigger: r.trigger,
+            created_at: r.created_at,
+        }));
+        return c.json({ ok: true, data: entries, total: entries.length });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Failed to fetch orbit history';
+        return c.json({ ok: false, error: message }, 500);
+    }
+});
+export default app;
+//# sourceMappingURL=orbit.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * routes/projects.ts — Multi-Project Galaxy API routes
+ *
+ * GET  /api/projects             — list all projects
+ * POST /api/projects             — create a project
+ * GET  /api/projects/:name/stats — detailed stats for a project
+ * POST /api/projects/switch      — switch active project
+ * GET  /api/projects/universal   — list universal memories
+ * POST /api/projects/universal/:id — mark/unmark a memory as universal
+ * GET  /api/projects/:name/candidates — detect universal candidates
+ */
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default app;
+//# sourceMappingURL=projects.d.ts.map