@astragenie/astramemory-local 0.7.2

package/dist/search/search.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Search orchestrator — hybrid FTS5 + vector + score fusion.
+ *
+ * Flow:
+ *  1. FTS5 BM25 query on memories_fts
+ *  2. embed(query) via EmbedProvider → vec.search() (mock or real)
+ *  3. fuseHits — merge FTS + cosine scores
+ *  4. apply SQL filters (type, repo, project, since) on the fused id set
+ *  5. join full Memory records, return top-k hits
+ *
+ * VecFilter is intentionally empty on vector search calls because sqlite-vec
+ * does not support pre-filtering. All filters are applied post-fusion.
+ */
+import type { DB } from '../storage/db.js';
+import type { EmbedProvider } from '../contracts/index.js';
+import type { MemoryType } from '../contracts/index.js';
+export interface SearchFilters {
+    type?: string[];
+    repo?: string;
+    /**
+     * Project filter (FEAT-423). Exact match on `memories.project`. A single
+     * string → `project = ?`; a string[] → `project IN (...)` (OR-semantics,
+     * mirrors `type[]`). Empty array = no constraint. Absent → all projects.
+     */
+    project?: string | string[];
+    /**
+     * Agent filter (FEAT-423 nice-to-have). Exact match on `memories.agent`
+     * (the provenance `agent`/`agent_type` populated at ingest). Applied
+     * post-fusion exactly like `repo`/`project`; single string or string[]
+     * (IN). Absent → all agents. This is a HARD filter; role-scoped soft-boost
+     * recall (FEAT-219) is a separate, later ranking concern and does not go here.
+     */
+    agent?: string | string[];
+    since?: number;
+    /**
+     * Bitemporal time-travel (FEAT-401, ADR-001/ADR-005): return memories as
+     * they stood at this instant (epoch ms) rather than the current snapshot.
+     * Absent = current behavior (only currently-valid rows).
+     */
+    as_of?: number;
+    /**
+     * Entity filter (FEAT-402 slice 2 AC-4). Resolved through
+     * EntityRepo.resolveIds (AC-9 normalize seam: exact match, then LIKE
+     * substring fallback) to one or more entities.id, then intersected with
+     * the FTS+vec candidate set BEFORE fusion — the result is all-and-only
+     * entity-linked members of that candidate set, not a post-fusion filter.
+     * An unresolvable entity name yields zero results (not an unfiltered
+     * search).
+     */
+    entity?: string;
+}
+export interface SearchHit {
+    id: string;
+    type: MemoryType;
+    text: string;
+    score: number;
+    source: 'fts' | 'vec' | 'both';
+}
+export interface SearchOpts {
+    db: DB;
+    embed: EmbedProvider;
+    weights: {
+        alpha: number;
+        beta: number;
+        gamma: number;
+        delta: number;
+        epsilon?: number;
+        zeta?: number;
+    };
+    /** Multiplier used by vector search (cap to limit vector scan) */
+    vecK?: number;
+    /**
+     * SLICE-410-3: when true, search() returns SearchDebugHit[] — the
+     * per-candidate fusion intermediates (raw+normalized bm25/cosine,
+     * importance, freshness, usefulness, entityBonus, effective weights, and
+     * the final fused score) instead of collapsing to SearchHit[]. Every
+     * other step (candidate gathering, entity filter, post-fusion SQL
+     * filters, validity/as_of, limit, ranking order) is unchanged — debug is
+     * purely an alternate projection of the same fused list, so debug:false
+     * or omitted is byte-identical to pre-change behavior (AC-2).
+     */
+    debug?: boolean;
+}
+/**
+ * Per-candidate fusion breakdown (SLICE-410-3 AC-1) — the upstream contract
+ * for SLICE-410-6's search-debug dashboard page. Mirrors the components
+ * `fuseHits`/`fuseScores` (fuse.ts) compute internally and normally discard.
+ *
+ * Sentinel (AC-4): when a leg has no hit for this candidate (e.g. embed
+ * provider down → no vector leg at all), that leg's `raw` is `null` and
+ * `normalized` is `0` — identical to the no-signal default `fuseHits`
+ * already uses internally, so `score` stays reproducible from these fields
+ * even in a degraded (FTS-only or vec-only) run.
+ *
+ * `usefulness`/`entityBonus`/`weights` are always the *effective* values
+ * actually fed into `fuseScores` (defaults resolved, e.g. usefulness 0.5 /
+ * entityBonus 0 / zeta 0) so `score` can be reconstructed exactly as:
+ *   weights.alpha * bm25.normalized + weights.beta * cosine.normalized
+ *   + weights.gamma * importance + weights.delta * freshness
+ *   + weights.epsilon * usefulness + weights.zeta * entityBonus
+ */
+export interface SearchDebugHit {
+    id: string;
+    source: 'fts' | 'vec' | 'both';
+    bm25: {
+        raw: number | null;
+        normalized: number;
+    };
+    cosine: {
+        raw: number | null;
+        normalized: number;
+    };
+    importance: number;
+    freshness: number;
+    usefulness: number;
+    entityBonus: number;
+    weights: {
+        alpha: number;
+        beta: number;
+        gamma: number;
+        delta: number;
+        epsilon: number;
+        zeta: number;
+    };
+    score: number;
+}
+/**
+ * Bitemporal validity SQL clause (FEAT-401) — the ONE shared filter used by
+ * every caller of search() (GET /search, POST /recall, the eval harness).
+ * There is deliberately no second implementation anywhere else: the CLI
+ * `--as-of` flag and the API `as_of` filter both terminate here because the
+ * CLI is a thin HTTP client of the same routes that call search().
+ *
+ *  - No as_of (undefined): current snapshot — only rows with valid_to IS
+ *    NULL surface, byte-identical to pre-FEAT-401 behavior (AC-2).
+ *  - as_of = T: the row valid AT INSTANT T — valid_from <= T AND (valid_to
+ *    IS NULL OR valid_to > T). Half-open interval [valid_from, valid_to):
+ *    at the exact instant a supersede/invalidate event lands, the new
+ *    generation is already the one considered valid (AC-5).
+ */
+export declare function validityFilterClause(asOf?: number): {
+    clause: string;
+    params: number[];
+};
+/**
+ * Parse an `as_of` wire value (ISO-8601 date-time string) into epoch ms.
+ * Shared by every route that accepts the filter (GET /search query param,
+ * POST /recall body) so a malformed value is rejected identically everywhere
+ * — one parsing path, not a per-route reimplementation. Returns undefined
+ * for an absent/empty value; throws for a present-but-unparseable value so
+ * callers can turn it into a 400.
+ */
+export declare function parseAsOf(value: string | undefined): number | undefined;
+/**
+ * Deterministic fake vector for testing — seeded by text hash, dim
+ * defaults to DEFAULT_EMBED_DIM (1024). Exported so tests can call it
+ * directly without importing the EmbedProvider. Pass `dim` to generate a
+ * fixture vector matching a non-default schema (FEAT-409 AC-2).
+ */
+export declare function makeFakeVec(text: string, dim?: number): Float32Array;
+export declare function search(query: string, filters: SearchFilters, limit: number, opts: SearchOpts & {
+    debug: true;
+}): Promise<SearchDebugHit[]>;
+export declare function search(query: string, filters: SearchFilters, limit: number, opts: SearchOpts): Promise<SearchHit[]>;

package/dist/search/search.js

@@ -0,0 +1,310 @@
+/**
+ * Search orchestrator — hybrid FTS5 + vector + score fusion.
+ *
+ * Flow:
+ *  1. FTS5 BM25 query on memories_fts
+ *  2. embed(query) via EmbedProvider → vec.search() (mock or real)
+ *  3. fuseHits — merge FTS + cosine scores
+ *  4. apply SQL filters (type, repo, project, since) on the fused id set
+ *  5. join full Memory records, return top-k hits
+ *
+ * VecFilter is intentionally empty on vector search calls because sqlite-vec
+ * does not support pre-filtering. All filters are applied post-fusion.
+ */
+import { DEFAULT_EMBED_DIM } from '../contracts/embed.js';
+import { fuseHits, normalizeScores } from './fuse.js';
+import { SqliteVecStore } from '../vector/sqlite-vec.js';
+import { usefulnessScores } from '../storage/usefulness.js';
+import { EntityRepo } from '../storage/entities.js';
+/**
+ * Sanitize a free-form query string for safe use with the FTS5 `MATCH` operator.
+ *
+ * FTS5 treats several characters as operators (`-` negation, `*` wildcard,
+ * `"` phrase, `^` column, `AND`/`OR`/`NOT` connectives). Without sanitization,
+ * a query like `sqlite-vec` triggers `fts5: syntax error near "-"` because `-`
+ * is parsed as a negation prefix.
+ *
+ * Strategy: split on whitespace, wrap each token in double quotes (treating
+ * each as a literal phrase), and escape embedded `"` by doubling it per the
+ * FTS5 phrase-literal rule. Multi-token queries become implicit AND.
+ *
+ * Trade-off: explicit FTS5 operators (e.g., `cat OR dog`, `"exact phrase"`,
+ * `prefix*`) are NOT honored in v1 — every input is treated as a bag of
+ * literal phrases. This is the right default for an agent-driven search
+ * surface; an `advanced` flag can be added later if needed.
+ */
+function escapeFtsQuery(q) {
+    return q.trim().split(/\s+/).map(t => `"${t.replace(/"/g, '""')}"`).join(' ');
+}
+/**
+ * Bitemporal validity SQL clause (FEAT-401) — the ONE shared filter used by
+ * every caller of search() (GET /search, POST /recall, the eval harness).
+ * There is deliberately no second implementation anywhere else: the CLI
+ * `--as-of` flag and the API `as_of` filter both terminate here because the
+ * CLI is a thin HTTP client of the same routes that call search().
+ *
+ *  - No as_of (undefined): current snapshot — only rows with valid_to IS
+ *    NULL surface, byte-identical to pre-FEAT-401 behavior (AC-2).
+ *  - as_of = T: the row valid AT INSTANT T — valid_from <= T AND (valid_to
+ *    IS NULL OR valid_to > T). Half-open interval [valid_from, valid_to):
+ *    at the exact instant a supersede/invalidate event lands, the new
+ *    generation is already the one considered valid (AC-5).
+ */
+export function validityFilterClause(asOf) {
+    if (asOf === undefined) {
+        return { clause: 'valid_to IS NULL', params: [] };
+    }
+    return { clause: 'valid_from <= ? AND (valid_to IS NULL OR valid_to > ?)', params: [asOf, asOf] };
+}
+/**
+ * Parse an `as_of` wire value (ISO-8601 date-time string) into epoch ms.
+ * Shared by every route that accepts the filter (GET /search query param,
+ * POST /recall body) so a malformed value is rejected identically everywhere
+ * — one parsing path, not a per-route reimplementation. Returns undefined
+ * for an absent/empty value; throws for a present-but-unparseable value so
+ * callers can turn it into a 400.
+ */
+export function parseAsOf(value) {
+    if (value === undefined || value === '')
+        return undefined;
+    const ms = Date.parse(value);
+    if (Number.isNaN(ms)) {
+        throw new Error(`invalid as_of value: ${value} (expected ISO-8601 date-time)`);
+    }
+    return ms;
+}
+/**
+ * Deterministic fake vector for testing — seeded by text hash, dim
+ * defaults to DEFAULT_EMBED_DIM (1024). Exported so tests can call it
+ * directly without importing the EmbedProvider. Pass `dim` to generate a
+ * fixture vector matching a non-default schema (FEAT-409 AC-2).
+ */
+export function makeFakeVec(text, dim = DEFAULT_EMBED_DIM) {
+    const v = new Float32Array(dim);
+    let hash = 0;
+    for (let i = 0; i < text.length; i++) {
+        hash = (hash * 31 + text.charCodeAt(i)) & 0xffffffff;
+    }
+    for (let i = 0; i < dim; i++) {
+        v[i] = Math.sin(hash * 0.001 + i * 0.01);
+    }
+    return v;
+}
+/**
+ * Compute the ζ entity-relevance bonus map (FEAT-402 slice 2 AC-6): for
+ * every known entity whose normalized name appears as a substring of the
+ * (lowercased) query text, any candidate id linked to that entity gets a
+ * bonus of 1. Only called when `search.zeta > 0` — with the default
+ * zeta=0 this function never runs, which is what makes the AC-6 snapshot
+ * guarantee (identical ranking at zeta=0) hold structurally, not just
+ * numerically.
+ */
+function entityBonusForQuery(db, query, candidateIds) {
+    const q = query.trim().toLowerCase();
+    if (!q || candidateIds.size === 0)
+        return new Map();
+    const entityRows = db.prepare('SELECT id, name FROM entities').all();
+    const matchedEntityIds = entityRows.filter(r => r.name && q.includes(r.name)).map(r => r.id);
+    if (matchedEntityIds.length === 0)
+        return new Map();
+    const idPh = Array.from(candidateIds).map(() => '?').join(',');
+    const entPh = matchedEntityIds.map(() => '?').join(',');
+    const rows = db.prepare(`SELECT DISTINCT memory_id FROM memory_entities WHERE memory_id IN (${idPh}) AND entity_id IN (${entPh})`).all(...candidateIds, ...matchedEntityIds);
+    const bonus = new Map();
+    for (const row of rows)
+        bonus.set(row.memory_id, 1);
+    return bonus;
+}
+export async function search(query, filters, limit, opts) {
+    const { db, embed, weights } = opts;
+    const vecK = opts.vecK ?? Math.max(limit * 4, 50);
+    // 1. FTS5 BM25 — run only if query is non-empty
+    const ftsHits = [];
+    if (query.trim()) {
+        const ftsQuery = escapeFtsQuery(query);
+        try {
+            const rows = db.prepare(`
+        SELECT m.id, bm25(memories_fts) AS bm25
+        FROM memories_fts
+        JOIN memories m ON m.rowid = memories_fts.rowid
+        WHERE memories_fts MATCH ?
+        ORDER BY bm25
+        LIMIT ?
+      `).all(ftsQuery, vecK);
+            ftsHits.push(...rows);
+        }
+        catch {
+            // FTS5 rejected the query (rare with escapeFtsQuery sanitization).
+            // Fall through to vector-only path.
+        }
+    }
+    // 2. Vector search — always attempt; if embed fails, fall back to FTS-only
+    const vecHits = [];
+    try {
+        const vecs = await embed.embed([query]);
+        const queryVec = vecs[0];
+        if (!queryVec)
+            throw new Error('embed provider returned empty result');
+        const vecStore = new SqliteVecStore(db, embed.dim);
+        // Pass empty filter to vec adapter — post-fusion filters applied below
+        const raw = await vecStore.search(queryVec, vecK);
+        vecHits.push(...raw.map(h => ({ id: h.id, cosine: h.score })));
+    }
+    catch {
+        // Vector search unavailable (no rows, no provider) — FTS-only mode
+    }
+    // 2b. Entity filter (FEAT-402 slice 2 AC-4) — resolve `entity` to entity
+    // ids (AC-9 normalize seam) and intersect the FTS+vec candidate set BEFORE
+    // fusion, so the result is all-and-only entity-linked members of that
+    // candidate set. An entity name that resolves to zero entities filters the
+    // candidate set to empty (not "unfiltered") — search() returns [] below.
+    let filteredFtsHits = ftsHits;
+    let filteredVecHits = vecHits;
+    if (filters.entity !== undefined) {
+        const entityRepo = new EntityRepo(db);
+        const entityIds = entityRepo.resolveIds(filters.entity);
+        const linkedIds = entityRepo.memoryIdsForEntities(entityIds);
+        filteredFtsHits = ftsHits.filter(h => linkedIds.has(h.id));
+        filteredVecHits = vecHits.filter(h => linkedIds.has(h.id));
+    }
+    // 3. Load meta for all candidate ids (importance + created_at for freshness)
+    const allIds = new Set([...filteredFtsHits.map(h => h.id), ...filteredVecHits.map(h => h.id)]);
+    if (allIds.size === 0)
+        return [];
+    const placeholders = Array.from(allIds).map(() => '?').join(',');
+    const metaRows = db.prepare(`SELECT id, importance, created_at FROM memories WHERE id IN (${placeholders})`).all(...allIds);
+    const metaMap = new Map(metaRows.map(r => [r.id, { importance: r.importance, created_at: r.created_at }]));
+    // 4. Fuse — usefulness (ADR-010 v1.x) joins as the ε component. ζ
+    // (FEAT-402 AC-6) joins as an entity-relevance bonus: DEFAULT 0 (config
+    // search.zeta) means the term is skipped entirely — no query, no DB scan,
+    // no change to ranking order versus pre-AC-6 behavior.
+    const usefulness = usefulnessScores(db, Array.from(allIds));
+    const zeta = weights.zeta ?? 0;
+    const entityBonus = zeta > 0 ? entityBonusForQuery(db, query, allIds) : undefined;
+    const nowMs = Date.now();
+    const fused = fuseHits(filteredFtsHits, filteredVecHits, metaMap, weights, nowMs, undefined, usefulness, entityBonus);
+    // 5. Apply post-fusion SQL filters then join full memory records
+    //    Build filter clauses dynamically
+    const filterClauses = [];
+    const filterParams = [];
+    if (filters.type && filters.type.length > 0) {
+        const ph = filters.type.map(() => '?').join(',');
+        filterClauses.push(`type IN (${ph})`);
+        filterParams.push(...filters.type);
+    }
+    if (filters.repo !== undefined) {
+        filterClauses.push('repo = ?');
+        filterParams.push(filters.repo);
+    }
+    // FEAT-423: project/agent accept a single value (`col = ?`) or a list
+    // (`col IN (...)`, OR-semantics like `type[]`). An empty list is treated as
+    // no constraint, never as "match nothing".
+    const addEqOrIn = (col, val) => {
+        if (Array.isArray(val)) {
+            if (val.length === 0)
+                return;
+            filterClauses.push(`${col} IN (${val.map(() => '?').join(',')})`);
+            filterParams.push(...val);
+        }
+        else {
+            filterClauses.push(`${col} = ?`);
+            filterParams.push(val);
+        }
+    };
+    if (filters.project !== undefined)
+        addEqOrIn('project', filters.project);
+    if (filters.agent !== undefined)
+        addEqOrIn('agent', filters.agent);
+    if (filters.since !== undefined) {
+        filterClauses.push('created_at >= ?');
+        filterParams.push(filters.since);
+    }
+    // Fetch full memory records in one query using IN clause
+    const fusedIds = fused.map(h => h.id);
+    const idPlaceholders = fusedIds.map(() => '?').join(',');
+    // Atom v3 (ADR-001): invalidated memories (valid_to set) must never surface
+    // in a current-snapshot recall — why_memory can still fetch them by id
+    // directly. FEAT-401: when as_of is set, the snapshot rule is replaced by
+    // the bitemporal validity window so a past-valid (now superseded) memory
+    // can surface again for a point-in-time query.
+    const { clause: validityClause, params: validityParams } = validityFilterClause(filters.as_of);
+    const whereFilter = filterClauses.length > 0 ? ` AND ${filterClauses.join(' AND ')}` : '';
+    const sql = `SELECT id, type, text FROM memories WHERE id IN (${idPlaceholders}) AND ${validityClause}${whereFilter}`;
+    const memRows = db.prepare(sql).all(...fusedIds, ...validityParams, ...filterParams);
+    const memMap = new Map(memRows.map(r => [r.id, r]));
+    // 6a. Debug projection (SLICE-410-3 AC-1) — recompute the same
+    // normalization fuseHits() applies internally (normalizeScores is
+    // exported from fuse.ts for exactly this reuse) so components are
+    // guaranteed consistent with `fused[].score`, without touching fuse.ts.
+    if (opts.debug) {
+        const bm25RawMap = new Map(filteredFtsHits.map(h => [h.id, h.bm25]));
+        const normBm25Arr = normalizeScores(filteredFtsHits.map(h => -h.bm25));
+        const normBm25Map = new Map(filteredFtsHits.map((h, i) => [h.id, normBm25Arr[i] ?? 0]));
+        const cosineRawMap = new Map(filteredVecHits.map(h => [h.id, h.cosine]));
+        const normCosineArr = normalizeScores(filteredVecHits.map(h => h.cosine));
+        const normCosineMap = new Map(filteredVecHits.map((h, i) => [h.id, normCosineArr[i] ?? 0]));
+        // Freshness half-life: fuse.ts fuseHits() default freshnessDecayDays=30,
+        // which search() always uses (passes `undefined` through to that
+        // default). Kept identical here so freshness — and thus `score` — stays
+        // reproducible from the documented weights (AC-3).
+        const freshnessDecayDays = 30;
+        // fuseScores() divides the raw weighted sum by the sum of active weights
+        // to keep scores in [0,1] (wire contract). Report weightSum-normalized
+        // weights here so `score` stays exactly reproducible as
+        // Σ weights.* × component from this object alone.
+        const rawWeightSum = weights.alpha + weights.beta + weights.gamma + weights.delta +
+            (weights.epsilon ?? 0) + zeta;
+        const weightSum = rawWeightSum === 0 ? 1 : rawWeightSum;
+        const effectiveWeights = {
+            alpha: weights.alpha / weightSum,
+            beta: weights.beta / weightSum,
+            gamma: weights.gamma / weightSum,
+            delta: weights.delta / weightSum,
+            epsilon: (weights.epsilon ?? 0) / weightSum,
+            zeta: zeta / weightSum,
+        };
+        const debugResults = [];
+        for (const hit of fused) {
+            if (!memMap.has(hit.id))
+                continue; // filtered out, same as SearchHit path
+            const meta = metaMap.get(hit.id);
+            const importance = meta?.importance ?? 0.5;
+            const createdAt = meta?.created_at ?? nowMs;
+            const ageDays = (nowMs - createdAt) / (24 * 60 * 60 * 1000);
+            const freshness = Math.exp(-ageDays / freshnessDecayDays);
+            debugResults.push({
+                id: hit.id,
+                source: hit.source,
+                bm25: { raw: bm25RawMap.get(hit.id) ?? null, normalized: normBm25Map.get(hit.id) ?? 0 },
+                cosine: { raw: cosineRawMap.get(hit.id) ?? null, normalized: normCosineMap.get(hit.id) ?? 0 },
+                importance,
+                freshness,
+                usefulness: usefulness.get(hit.id) ?? 0.5,
+                entityBonus: entityBonus?.get(hit.id) ?? 0,
+                weights: effectiveWeights,
+                score: hit.score,
+            });
+            if (debugResults.length >= limit)
+                break;
+        }
+        return debugResults;
+    }
+    // 6. Build result — preserve fused ranking order, skip filtered-out ids
+    const results = [];
+    for (const hit of fused) {
+        const mem = memMap.get(hit.id);
+        if (!mem)
+            continue; // filtered out
+        results.push({
+            id: hit.id,
+            type: mem.type,
+            text: mem.text,
+            score: hit.score,
+            source: hit.source
+        });
+        if (results.length >= limit)
+            break;
+    }
+    return results;
+}
+//# sourceMappingURL=search.js.map

package/dist/search/search.js.map

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

package/dist/server/app.d.ts

@@ -0,0 +1,17 @@
+import type { FastifyInstance } from 'fastify';
+import type { DB } from '../storage/db.js';
+import type { EmbedProvider } from '../contracts/index.js';
+import { type Config } from '../config/config.js';
+import type { HealthState } from './health-state.js';
+export interface AppOpts {
+    db: DB;
+    token: string;
+    /** Embed provider injected for search + remember routes. Defaults to fake/noop. */
+    embed?: EmbedProvider;
+    /** Server config — used by dashboard route for budget cap display. Defaults to defaultConfig(). */
+    config?: Config;
+    /** Live daemon health snapshot (degraded-start, D3). Optional — /health
+     *  omits the status/embed fields when absent (e.g. bare test apps). */
+    healthState?: HealthState;
+}
+export declare function buildApp(opts: AppOpts): Promise<FastifyInstance>;

package/dist/server/app.js

@@ -0,0 +1,133 @@
+import Fastify from 'fastify';
+import { healthRoute } from './routes/health.js';
+import { versionRoute } from './routes/version.js';
+import { ingestRoute } from './routes/ingest.js';
+import { searchRoute } from './routes/search.js';
+import { memoryRoute } from './routes/memory.js';
+import { lifecycleRoutes } from './routes/lifecycle.js';
+import { whyRoute } from './routes/why.js';
+import { digestRoute } from './routes/digest.js';
+import { recallRoute } from './routes/recall.js';
+import { mcpRoute } from './routes/mcp.js';
+import { dashboardRoute } from './routes/dashboard.js';
+import { dashboardConsolidationRoute } from './routes/dashboard-consolidation-html.js';
+import { dashboardJobsRoute } from './routes/dashboard-jobs-html.js';
+import { dashboardSearchRoute } from './routes/dashboard-search-html.js';
+import { dashboardApiRoute } from './routes/dashboard-api-html.js';
+import { memoryToolRoute } from './routes/memory-tool.js';
+import { consolidationRoutes } from './routes/consolidation.js';
+import { entitiesRoute } from './routes/entities.js';
+import { makeFakeVec } from '../search/search.js';
+import { childLogger } from '../log/logger.js';
+import { newRequestId, runWithRequestId } from '../log/correlation.js';
+import { defaultConfig } from '../config/config.js';
+import { isLoopbackHost } from './lib/network.js';
+/** Default no-op embed provider used when no real provider is injected.
+ * FEAT-409: dim derived from config.embedding.dim (defaults to
+ * DEFAULT_EMBED_DIM via defaultConfig()) rather than a literal, so the
+ * noop provider's fake vectors always match whatever schema dim is live. */
+function makeNoopEmbed(dim) {
+    return {
+        name: 'ollama',
+        model: 'noop',
+        dim,
+        embed: async (texts) => texts.map(t => makeFakeVec(t, dim)),
+        health: async () => ({ ok: false, model: 'noop', dim, error: 'no provider configured' })
+    };
+}
+export async function buildApp(opts) {
+    // Fastify's internal logger is disabled. We emit request lifecycle logs
+    // manually via the onResponse hook below, using our pino instance + the
+    // request_id we generate in onRequest. This sidesteps a type incompatibility
+    // between FastifyBaseLogger and FastifyInstance<never logger>.
+    const app = Fastify({
+        logger: false,
+        // Long Codex/Claude sessions routinely exceed Fastify's 1MiB default —
+        // an oversized transcript should not 413 (wire: POST /ingest/transcript).
+        bodyLimit: 10 * 1024 * 1024,
+        // A stuck handler must not hold a connection forever (recall with a cold
+        // embed can be slow, but 60s is the ceiling — matches the LLM timeout).
+        requestTimeout: 60_000,
+    });
+    const config = opts.config ?? defaultConfig();
+    const embed = opts.embed ?? makeNoopEmbed(config.embedding.dim);
+    // Assign a request_id to every incoming request and expose it on the reply header.
+    app.addHook('onRequest', async (req, reply) => {
+        const requestId = newRequestId();
+        // Store on req so downstream hooks / routes can read it
+        req['requestId'] = requestId;
+        // Bind to async local storage for propagation into jobs queued from this request
+        runWithRequestId(requestId, () => {
+            // noop — storage set; pino child created in route handlers
+        });
+        void reply.header('x-request-id', requestId);
+    });
+    // Log HTTP request start + completion with required fields.
+    app.addHook('onResponse', (req, reply, done) => {
+        const requestId = req['requestId'];
+        const log = childLogger({ request_id: requestId ?? 'unknown' });
+        log.info({
+            method: req.method,
+            path: req.url,
+            status: reply.statusCode,
+        }, 'request complete');
+        done();
+    });
+    // Auth check — scrub the Authorization header value from any error logs.
+    // /dashboard and its sub-pages (/dashboard/consolidation, /dashboard/jobs,
+    // /dashboard/search — FEAT-410) validate their own token via ?token= query
+    // param or cookie — always exempt on prefix, not just the exact path.
+    // /health and /version are public ONLY while the daemon is bound to loopback
+    // (default). FEAT-406: opting into a non-local bind (config.network.host set
+    // to anything but 127.0.0.1/localhost/::1) requires Bearer auth on BOTH
+    // routes together — isLoopbackHost is the one predicate that decides this,
+    // so the bind and the auth boundary can never drift apart.
+    const isLocalBind = isLoopbackHost(config.network.host);
+    app.addHook('preHandler', async (req, reply) => {
+        const path = req.url.split('?')[0];
+        if (path === '/dashboard' || path?.startsWith('/dashboard/'))
+            return;
+        if (isLocalBind && (path === '/health' || path === '/version'))
+            return;
+        const auth = req.headers.authorization;
+        if (auth !== `Bearer ${opts.token}`) {
+            const requestId = req['requestId'];
+            childLogger({ request_id: requestId ?? 'unknown' }).warn({ method: req.method, path: req.url }, 'unauthorized request');
+            return reply.code(401).send({ error: 'unauthorized' });
+        }
+    });
+    // Unhandled route errors: log the full error server-side, return a
+    // sanitized body (no stack, no internals) with the original status when a
+    // route set one (e.g. Fastify's own 413/400), else 500. Existing 4xx
+    // paths return their own bodies and never reach this handler.
+    app.setErrorHandler((rawErr, req, reply) => {
+        const err = rawErr;
+        const requestId = req['requestId'];
+        const status = typeof err.statusCode === 'number' && err.statusCode >= 400 ? err.statusCode : 500;
+        childLogger({ request_id: requestId ?? 'unknown' }).error({ method: req.method, path: req.url, status, error_message: err.message, error_kind: err.name }, 'request failed');
+        void reply.code(status).send({
+            ok: false,
+            error: { code: status === 500 ? 'internal' : String(err.code ?? status), message: status === 500 ? 'internal error' : err.message },
+        });
+    });
+    await app.register(healthRoute(config, opts.db, opts.healthState));
+    await app.register(versionRoute);
+    await app.register(ingestRoute(opts.db, config));
+    await app.register(searchRoute(opts.db, embed, config));
+    await app.register(memoryRoute(opts.db));
+    await app.register(lifecycleRoutes(opts.db));
+    await app.register(whyRoute(opts.db));
+    await app.register(digestRoute(opts.db));
+    await app.register(recallRoute(opts.db, config));
+    await app.register(mcpRoute(opts.db, embed, config));
+    await app.register(dashboardRoute(opts.db, config, opts.token, opts.healthState));
+    await app.register(dashboardConsolidationRoute(opts.db, opts.token));
+    await app.register(dashboardJobsRoute(opts.db, opts.token));
+    await app.register(dashboardSearchRoute(opts.db, embed, opts.token));
+    await app.register(dashboardApiRoute(opts.token));
+    await app.register(memoryToolRoute(opts.db, config));
+    await app.register(consolidationRoutes(opts.db));
+    await app.register(entitiesRoute(opts.db));
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/server/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAI9B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAe,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;4EAG4E;AAC5E,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO;QACL,IAAI,EAAE,QAAiB;QACvB,KAAK,EAAE,MAAM;QACb,GAAG;QACH,KAAK,EAAE,KAAK,EAAE,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC;AAcD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAa;IAC1C,wEAAwE;IACxE,wEAAwE;IACxE,6EAA6E;IAC7E,+DAA+D;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC;QAClB,MAAM,EAAE,KAAK;QACb,uEAAuE;QACvE,0EAA0E;QAC1E,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;QAC3B,yEAAyE;QACzE,wEAAwE;QACxE,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEhE,mFAAmF;IACnF,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,wDAAwD;QACvD,GAA0C,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;QACrE,iFAAiF;QACjF,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE;YAC/B,2DAA2D;QAC7D,CAAC,CAAC,CAAC;QACH,KAAK,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,4DAA4D;IAC5D,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,SAAS,GAAI,GAA0C,CAAC,WAAW,CAAuB,CAAC;QACjG,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,UAAU,EAAE,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,GAAG;YACb,MAAM,EAAE,KAAK,CAAC,UAAU;SACzB,EAAE,kBAAkB,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,2EAA2E;IAC3E,2EAA2E;IAC3E,sEAAsE;IACtE,6EAA6E;IAC7E,6EAA6E;IAC7E,wEAAwE;IACxE,2EAA2E;IAC3E,2DAA2D;IAC3D,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO;QACrE,IAAI,WAAW,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,CAAC;YAAE,OAAO;QACvE,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;QACvC,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACpC,MAAM,SAAS,GAAI,GAA0C,CAAC,WAAW,CAAuB,CAAC;YACjG,WAAW,CAAC,EAAE,UAAU,EAAE,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC,IAAI,CACtD,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,EACrC,sBAAsB,CACvB,CAAC;YACF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mEAAmE;IACnE,0EAA0E;IAC1E,qEAAqE;IACrE,8DAA8D;IAC9D,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,GAAG,GAAG,MAAwD,CAAC;QACrE,MAAM,SAAS,GAAI,GAA0C,CAAC,WAAW,CAAuB,CAAC;QACjG,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;QAClG,WAAW,CAAC,EAAE,UAAU,EAAE,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC,KAAK,CACvD,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,EAC/F,gBAAgB,CACjB,CAAC;QACF,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE;SACpI,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,MAAM,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjC,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,MAAM,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAClF,MAAM,GAAG,CAAC,QAAQ,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,MAAM,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,MAAM,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,MAAM,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,MAAM,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3C,OAAO,GAAG,CAAC;AACb,CAAC"}