neotoma 0.4.0 → 0.4.1

package/README.md

@@ -256,7 +256,7 @@ Full documentation is organized at [neotoma.io/docs](https://neotoma.io/docs) an
 
 **Foundational:** [Core identity](docs/foundation/core_identity.md), [Philosophy](docs/foundation/philosophy.md), [Problem statement](docs/foundation/problem_statement.md)
 
-**Operations:** [Runbook](docs/operations/runbook.md), [Health check](docs/operations/health_check.md) (`npm run doctor`), [Troubleshooting](https://neotoma.io/troubleshooting)
+**Operations:** [Runbook](docs/operations/runbook.md), [Health check](docs/operations/health_check.md) (`npm run doctor`), SQLite salvage (`neotoma storage recover-db`, `npm run recover:db`, `npm run recover:db:prod`), [Troubleshooting](https://neotoma.io/troubleshooting)
 
 ## Contributing
 

package/dist/actions.d.ts

@@ -2,8 +2,5 @@ import express from "express";
 export declare const app: any;
 /** True when request is to localhost/127.0.0.1 (local access). Tunnel requests have a non-local Host. */
 export declare function isLocalRequest(req: express.Request): boolean;
-export declare function startHTTPServer(): Promise<{
-    server: any;
-    port: number;
-} | undefined>;
+export declare function startHTTPServer(): unknown;
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AA8E9B,eAAO,MAAM,GAAG,KAAY,CAAC;AAwL7B,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAK5D;AAk5ID,wBAAsB,eAAe;;;eAgCpC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AA8E9B,eAAO,MAAM,GAAG,KAAY,CAAC;AAwL7B,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAK5D;AAw7ID,wBAAsB,eAAe,YAgCpC"}

package/dist/actions.js

@@ -1599,7 +1599,8 @@ app.get("/entities/:id", async (req, res) => {
         if (!entityWithProvenance) {
             return sendError(res, 404, "RESOURCE_NOT_FOUND", "Entity not found");
         }
-        return res.json({ entity: entityWithProvenance });
+        // OpenAPI + clients expect `EntitySnapshot` at the root (not `{ entity: ... }`).
+        return res.json(entityWithProvenance);
     }
     catch (error) {
         if (error instanceof Error && error.message.includes("Not authenticated")) {
@@ -2032,6 +2033,10 @@ app.get("/timeline", async (req, res) => {
         const entityId = req.query.entity_id;
         const limit = parseInt(req.query.limit) || 100;
         const offset = parseInt(req.query.offset) || 0;
+        const rawOrderBy = String(req.query.order_by ?? "event_timestamp")
+            .trim()
+            .toLowerCase();
+        const orderByColumn = rawOrderBy === "created_at" ? "created_at" : "event_timestamp";
         // Get source IDs for this user first (timeline_events doesn't have user_id)
         const { data: userSources, error: sourcesError } = await db
             .from("sources")
@@ -2070,8 +2075,8 @@ app.get("/timeline", async (req, res) => {
         if (entityId) {
             query = query.eq("entity_id", entityId);
         }
-        // Sort by event timestamp (chronological)
-        query = query.order("event_timestamp", { ascending: false });
+        // Default: sort by event_timestamp (document dates). Use order_by=created_at for "what changed recently".
+        query = query.order(orderByColumn, { ascending: false });
         // Pagination
         query = query.range(offset, offset + limit - 1);
         const { data, error, count } = await query;
@@ -2096,8 +2101,36 @@ app.get("/timeline", async (req, res) => {
                 hint: errorHint,
             });
         }
+        // Enrich events with entity canonical names and types
+        const events = data || [];
+        const entityIds = [
+            ...new Set(events.map((e) => e.entity_id).filter(Boolean)),
+        ];
+        const entityLookup = new Map();
+        if (entityIds.length > 0) {
+            const { data: entities } = await db
+                .from("entities")
+                .select("id, canonical_name, entity_type")
+                .in("id", entityIds);
+            if (entities) {
+                for (const ent of entities) {
+                    entityLookup.set(ent.id, {
+                        canonical_name: ent.canonical_name,
+                        entity_type: ent.entity_type,
+                    });
+                }
+            }
+        }
+        const enrichedEvents = events.map((ev) => {
+            const entity = ev.entity_id ? entityLookup.get(ev.entity_id) : undefined;
+            return {
+                ...ev,
+                entity_name: entity?.canonical_name || undefined,
+                entity_type: entity?.entity_type || undefined,
+            };
+        });
         return res.json({
-            events: data || [],
+            events: enrichedEvents,
             total: count || 0,
             limit,
             offset,