forge-server 0.1.0

package/dist/memory/memory-compat.d.ts.map

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

package/dist/memory/memory-compat.js

@@ -0,0 +1,146 @@
+/**
+ * Claude-flow / Ruflo memory compatibility layer.
+ * Translates between the two memory schemas and the unified ObservationPayload format.
+ * Ensures memory_store, memory_retrieve, memory_search work with both parameter shapes.
+ *
+ * Claude-flow schema: { content, type, category, tags, metadata, importance, ttl }
+ * Ruflo schema:       { key, value, namespace, tags, ttl }
+ */
+/**
+ * Detect whether input follows ruflo-style (key+value) or claude-flow-style (content).
+ */
+export function detectMemorySource(input) {
+    if (input.key !== undefined && input.value !== undefined) {
+        return 'ruflo';
+    }
+    if (input.content !== undefined || input.type !== undefined || input.category !== undefined) {
+        return 'claude-flow';
+    }
+    // Ambiguous - use key presence as tiebreaker
+    if (input.key !== undefined) {
+        return 'ruflo';
+    }
+    return 'claude-flow';
+}
+/**
+ * Normalize a memory_store input into unified format regardless of schema origin.
+ */
+export function normalizeMemoryInput(input) {
+    const source = detectMemorySource(input);
+    let content;
+    let key;
+    let originalValue;
+    if (source === 'ruflo') {
+        key = input.key ?? `mem-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
+        originalValue = input.value;
+        content = typeof input.value === 'string'
+            ? input.value
+            : JSON.stringify(input.value ?? '');
+    }
+    else {
+        // claude-flow style
+        key = input.key ?? null;
+        content = input.content ?? '';
+        originalValue = undefined;
+    }
+    // category is an alias for namespace in claude-flow
+    const namespace = input.namespace ?? input.category ?? 'default';
+    return {
+        content,
+        key,
+        namespace,
+        type: input.type ?? 'episodic',
+        tags: input.tags ?? [],
+        importance: input.importance ?? 0.5,
+        ttl: input.ttl,
+        metadata: input.metadata ?? {},
+        source,
+        originalValue,
+    };
+}
+/**
+ * Format an ObservationPayload for ruflo-style retrieve response.
+ * Parses content back to original value if it was JSON.
+ */
+export function formatRufloRetrieve(payload) {
+    let value = payload.content;
+    // Try to parse back to original type
+    try {
+        value = JSON.parse(payload.content);
+    }
+    catch {
+        value = payload.content;
+    }
+    return {
+        key: payload.key ?? '',
+        value,
+        content: payload.content,
+        namespace: payload.namespace,
+        type: payload.type,
+        tags: payload.tags,
+        importance: payload.importance,
+        created_at: new Date(payload.created_at).toISOString(),
+        accessed_at: new Date(payload.accessed_at).toISOString(),
+        found: true,
+    };
+}
+/**
+ * Format an ObservationPayload for memory_search response (compatible with both schemas).
+ */
+export function formatMemorySearchResult(payload, relevanceScore) {
+    let value = payload.content;
+    // Try to parse back to original type for ruflo compat
+    try {
+        value = JSON.parse(payload.content);
+    }
+    catch {
+        value = payload.content;
+    }
+    return {
+        id: payload.id,
+        key: payload.key,
+        content: payload.content,
+        value,
+        type: payload.type,
+        namespace: payload.namespace,
+        tags: payload.tags,
+        importance: payload.importance,
+        relevance: relevanceScore,
+        created_at: new Date(payload.created_at).toISOString(),
+        accessed_at: new Date(payload.accessed_at).toISOString(),
+        metadata: Object.keys(payload.metadata).length > 0 ? payload.metadata : undefined,
+        source: payload.source,
+    };
+}
+/**
+ * Build a Qdrant filter for memory_search based on the input parameters.
+ */
+export function buildMemorySearchFilter(params) {
+    const must = [];
+    // Namespace / category filter
+    const ns = params.namespace ?? params.category;
+    if (ns && ns !== 'default') {
+        must.push({ key: 'namespace', match: { value: ns } });
+    }
+    // Type filter
+    if (params.type && params.type !== 'all') {
+        must.push({ key: 'type', match: { value: params.type } });
+    }
+    // Source filter
+    if (params.source) {
+        must.push({ key: 'source', match: { value: params.source } });
+    }
+    // Tags filter - must match ALL tags (AND logic per architecture spec)
+    // Qdrant doesn't support AND on array elements natively, so we filter post-search
+    // The tags param is handled in post-processing.
+    return must.length > 0 ? { must } : undefined;
+}
+/**
+ * Post-filter results by tags (AND logic: result must have ALL requested tags).
+ */
+export function filterByTags(results, tags) {
+    if (!tags || tags.length === 0)
+        return results;
+    return results.filter(r => tags.every(tag => r.tags.includes(tag)));
+}
+//# sourceMappingURL=memory-compat.js.map

package/dist/memory/memory-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-compat.js","sourceRoot":"","sources":["../../src/memory/memory-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwBH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAOlC;IACC,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5F,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,6CAA6C;IAC7C,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAcpC;IACC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,OAAe,CAAC;IACpB,IAAI,GAAkB,CAAC;IACvB,IAAI,aAAsB,CAAC;IAE3B,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACjF,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC;QAC5B,OAAO,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YACvC,CAAC,CAAC,KAAK,CAAC,KAAK;YACb,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,oBAAoB;QACpB,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QACxB,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QAC9B,aAAa,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,oDAAoD;IACpD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC;IAEjE,OAAO;QACL,OAAO;QACP,GAAG;QACH,SAAS;QACT,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,GAAG;QACnC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,MAAM;QACN,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA2B;IAY7D,IAAI,KAAK,GAAY,OAAO,CAAC,OAAO,CAAC;IACrC,qCAAqC;IACrC,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;QACtB,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE;QACtD,WAAW,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE;QACxD,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAA2B,EAAE,cAAsB;IAe1F,IAAI,KAAK,GAAY,OAAO,CAAC,OAAO,CAAC;IACrC,sDAAsD;IACtD,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE;QACtD,WAAW,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE;QACxD,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACjF,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAOvC;IACC,MAAM,IAAI,GAAsD,EAAE,CAAC;IAEnE,8BAA8B;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC;IAC/C,IAAI,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,cAAc;IACd,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,gBAAgB;IAChB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,sEAAsE;IACtE,kFAAkF;IAClF,gDAAgD;IAEhD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAA+B,OAAY,EAAE,IAAc;IACrF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/memory/observation-store.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Observation store - CRUD for observations with symbol linking.
+ * Observations are stored in Qdrant (vector search) and FalkorDB (graph links).
+ * Implements the save_observation and related memory tool semantics from architecture.md.
+ *
+ * Note: ObservationRoute is defined inline here rather than imported from
+ * knowledge/routing-engine.ts (that module is not merged from forge-graph-rag;
+ * the pipeline server has its own knowledge/ modules).
+ */
+import type { VectorStore, GraphStore } from '../storage/interfaces.js';
+import type { ObservationPayload } from '../util/types.js';
+export interface ObservationRoute {
+    writeVector: boolean;
+    writeGraphNode: boolean;
+    defaultNamespace: string;
+}
+export interface SaveObservationOptions {
+    content: string;
+    symbols?: string[];
+    repoId?: string;
+    importance?: number;
+    tags?: string[];
+    category?: string;
+    sessionId: string;
+    type?: ObservationPayload['type'];
+    source?: ObservationPayload['source'];
+    key?: string;
+    namespace?: string;
+    value?: unknown;
+    metadata?: Record<string, unknown>;
+    ttl?: number;
+}
+export interface SaveObservationResult {
+    id: string;
+    stored: boolean;
+    linkedSymbols: string[];
+    unresolvedSymbols: string[];
+}
+/**
+ * Save an observation to Qdrant (vector) and optionally FalkorDB (graph node + symbol links).
+ * The optional `route` parameter controls whether graph operations are executed.
+ * When `route.writeGraphNode` is false (external repo), only Qdrant is written.
+ */
+export declare function saveObservation(opts: SaveObservationOptions, vectorStore: VectorStore, graphStore: GraphStore, route?: ObservationRoute): Promise<SaveObservationResult>;
+/**
+ * Retrieve an observation by ID.
+ */
+export declare function getObservation(id: string, vectorStore: VectorStore): Promise<ObservationPayload | null>;
+/**
+ * Update access tracking for an observation (access_count, accessed_at).
+ */
+export declare function touchObservation(id: string, vectorStore: VectorStore): Promise<void>;
+/**
+ * Check if an observation has expired (TTL expired).
+ */
+export declare function isExpired(payload: ObservationPayload): boolean;
+//# sourceMappingURL=observation-store.d.ts.map

package/dist/memory/observation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-store.d.ts","sourceRoot":"","sources":["../../src/memory/observation-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAO3D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAEtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,sBAAsB,EAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,EACtB,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAAC,qBAAqB,CAAC,CA0HhC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAM9D"}

package/dist/memory/observation-store.js

@@ -0,0 +1,154 @@
+/**
+ * Observation store - CRUD for observations with symbol linking.
+ * Observations are stored in Qdrant (vector search) and FalkorDB (graph links).
+ * Implements the save_observation and related memory tool semantics from architecture.md.
+ *
+ * Note: ObservationRoute is defined inline here rather than imported from
+ * knowledge/routing-engine.ts (that module is not merged from forge-graph-rag;
+ * the pipeline server has its own knowledge/ modules).
+ */
+import { randomUUID } from 'crypto';
+import { embedText } from '../ingestion/embedder.js';
+import { LINK_OBSERVATION_TO_SYMBOL, UPSERT_OBSERVATION } from '../query/graph-queries.js';
+import { incrementObservationCount } from './session-tracker.js';
+import { logger } from '../util/logger.js';
+/**
+ * Save an observation to Qdrant (vector) and optionally FalkorDB (graph node + symbol links).
+ * The optional `route` parameter controls whether graph operations are executed.
+ * When `route.writeGraphNode` is false (external repo), only Qdrant is written.
+ */
+export async function saveObservation(opts, vectorStore, graphStore, route) {
+    // Default route: write everywhere (backward-compatible when caller doesn't supply route)
+    const effectiveRoute = route ?? {
+        writeVector: true,
+        writeGraphNode: true,
+        defaultNamespace: 'default',
+    };
+    const { content, symbols = [], repoId = null, importance = 0.5, tags = [], category = null, sessionId, type = 'episodic', source = 'forge', key = null, namespace = 'default', value, metadata = {}, ttl, } = opts;
+    const id = randomUUID();
+    const now = Date.now();
+    // Build the content string - for ruflo-style key/value, serialize value
+    let finalContent = content;
+    if (!finalContent && value !== undefined) {
+        finalContent = typeof value === 'string' ? value : JSON.stringify(value);
+    }
+    if (!finalContent) {
+        finalContent = key ? `[key: ${key}]` : '[empty observation]';
+    }
+    // Build the observation payload (stored in Qdrant)
+    const payload = {
+        id,
+        repo_id: repoId ?? null,
+        session_id: sessionId,
+        content: finalContent,
+        type,
+        category,
+        tags,
+        importance,
+        created_at: now,
+        accessed_at: now,
+        access_count: 0,
+        is_stale: false,
+        linked_symbols: [],
+        source,
+        metadata: ttl ? { ...metadata, ttl, expires_at: now + ttl * 1000 } : metadata,
+        key,
+        namespace,
+    };
+    // Embed the content
+    let vector;
+    try {
+        vector = await embedText(finalContent);
+    }
+    catch (err) {
+        logger.warn('Failed to embed observation content', { error: String(err) });
+        // Fallback: zero vector (won't match anything but stores the payload)
+        vector = new Array(384).fill(0);
+    }
+    // Store in Qdrant
+    try {
+        await vectorStore.upsertObservation(id, vector, payload);
+    }
+    catch (err) {
+        logger.error('Failed to store observation in Qdrant', { id, error: String(err) });
+        return { id, stored: false, linkedSymbols: [], unresolvedSymbols: symbols };
+    }
+    // Store Observation node in FalkorDB and link to symbols (owned repos only)
+    const linkedSymbols = [];
+    const unresolvedSymbols = [];
+    if (effectiveRoute.writeGraphNode) {
+        try {
+            await graphStore.query(UPSERT_OBSERVATION(id, finalContent, sessionId, importance));
+            // Attempt to link each symbol
+            for (const symbolName of symbols) {
+                try {
+                    const effectiveRepoId = repoId ?? '';
+                    await graphStore.query(LINK_OBSERVATION_TO_SYMBOL(id, symbolName, effectiveRepoId));
+                    linkedSymbols.push(symbolName);
+                    logger.debug('Linked observation to symbol', { observationId: id, symbol: symbolName });
+                }
+                catch {
+                    unresolvedSymbols.push(symbolName);
+                    logger.debug('Symbol not found in graph for observation link', { symbol: symbolName });
+                }
+            }
+            // Update payload with resolved symbols
+            if (linkedSymbols.length > 0) {
+                await vectorStore.updateObservation(id, { linked_symbols: linkedSymbols });
+            }
+        }
+        catch (err) {
+            // Graph operations failing is non-fatal - Qdrant is the source of truth
+            logger.warn('FalkorDB observation node creation failed (non-fatal)', { id, error: String(err) });
+            unresolvedSymbols.push(...symbols);
+        }
+    }
+    else {
+        // External repo: all symbols are unresolved (no graph to link against)
+        unresolvedSymbols.push(...symbols);
+        logger.debug('External repo observation — skipping graph node creation', { id, repoId });
+    }
+    // Increment the in-memory session observation count
+    incrementObservationCount();
+    logger.info('Observation saved', {
+        id,
+        contentLength: finalContent.length,
+        linkedSymbols: linkedSymbols.length,
+        unresolvedSymbols: unresolvedSymbols.length,
+    });
+    return { id, stored: true, linkedSymbols, unresolvedSymbols };
+}
+/**
+ * Retrieve an observation by ID.
+ */
+export async function getObservation(id, vectorStore) {
+    return vectorStore.getObservation(id);
+}
+/**
+ * Update access tracking for an observation (access_count, accessed_at).
+ */
+export async function touchObservation(id, vectorStore) {
+    try {
+        const obs = await vectorStore.getObservation(id);
+        if (obs) {
+            await vectorStore.updateObservation(id, {
+                accessed_at: Date.now(),
+                access_count: (obs.access_count ?? 0) + 1,
+            });
+        }
+    }
+    catch (err) {
+        logger.debug('Failed to update observation access tracking', { id, error: String(err) });
+    }
+}
+/**
+ * Check if an observation has expired (TTL expired).
+ */
+export function isExpired(payload) {
+    const expiresAt = payload.metadata?.expires_at;
+    if (typeof expiresAt === 'number') {
+        return Date.now() > expiresAt;
+    }
+    return false;
+}
+//# sourceMappingURL=observation-store.js.map

package/dist/memory/observation-store.js.map

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

package/dist/memory/session-tracker.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Session lifecycle and context tracking.
+ * Tracks current session ID, start time, and provides session-scoped observation queries.
+ * Sessions are identified by a timestamp-based ID generated at server startup.
+ *
+ * Phase 3: Sessions persist as Observation nodes in Qdrant with type: 'session_marker'.
+ * Cross-session retrieval queries those nodes to build a session registry.
+ */
+import type { VectorStore } from '../storage/interfaces.js';
+/**
+ * Get the current session ID.
+ * Format: session-{timestamp}. Consistent for the lifetime of the MCP server process.
+ */
+export declare function getCurrentSessionId(): string;
+/**
+ * Get the session start timestamp (Unix ms).
+ */
+export declare function getSessionStart(): number;
+/**
+ * Get session uptime in seconds.
+ */
+export declare function getUptimeSeconds(): number;
+/**
+ * Increment the in-memory observation count for this session.
+ * Called by observation-store after a successful save.
+ */
+export declare function incrementObservationCount(): void;
+/**
+ * Get the current session observation count.
+ */
+export declare function getObservationCount(): number;
+export interface SessionObservationGroup {
+    sessionId: string;
+    startedAt: number;
+    observations: Array<{
+        id: string;
+        content: string;
+        relevance_score: number;
+        is_stale: boolean;
+    }>;
+}
+/**
+ * Persist the current session as a session_marker observation in Qdrant.
+ * This enables cross-session discovery — other processes can find recent sessions
+ * by searching for type: 'session_marker' observations.
+ *
+ * Idempotent — only writes once per process lifecycle.
+ */
+export declare function persistSessionMarker(vectorStore: VectorStore): Promise<void>;
+/**
+ * Retrieve recent session IDs and their start times from Qdrant.
+ * Queries for session_marker observations ordered by created_at descending.
+ */
+export declare function getRecentSessions(vectorStore: VectorStore, count?: number): Promise<Array<{
+    sessionId: string;
+    startedAt: number;
+}>>;
+/**
+ * Get observations from recent sessions.
+ * Phase 3: Queries the persistent session registry to find sessions,
+ * then retrieves observations for each one.
+ *
+ * If a query is provided, observations are ranked by semantic relevance.
+ * Otherwise they are returned in reverse chronological order.
+ */
+export declare function getRecentSessionObservations(vectorStore: VectorStore, opts: {
+    query?: string;
+    queryVector?: number[];
+    sessionCount?: number;
+    limit?: number;
+}): Promise<SessionObservationGroup[]>;
+/**
+ * Get the current session info summary.
+ */
+export declare function getSessionInfo(): {
+    sessionId: string;
+    startedAt: number;
+    uptimeSeconds: number;
+    observationCount: number;
+};
+//# sourceMappingURL=session-tracker.d.ts.map

package/dist/memory/session-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.d.ts","sourceRoot":"","sources":["../../src/memory/session-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAiB5D;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ClF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,WAAW,EACxB,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA8B1D;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE;IACJ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAyDpC;AA2ED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAOA"}