@sashabogi/foundation 2.2.0 → 3.0.1

package/dist/tools/demerzel/snapshot.js

@@ -6,8 +6,9 @@
  *
  * Ported from Argus to Foundation.
  */
-import { existsSync, readFileSync, readdirSync, statSync, writeFileSync, mkdirSync } from 'fs';
+import { existsSync, readFileSync, readdirSync, statSync, mkdirSync } from 'fs';
 import { join, relative, extname, dirname } from 'path';
+import { writeCompressed, compressedPath } from './zstd-io.js';
 export const DEFAULT_EXTENSIONS = [
     'ts', 'tsx', 'js', 'jsx', 'rs', 'py', 'go', 'java', 'rb', 'php',
     'swift', 'kt', 'scala', 'c', 'cpp', 'h', 'hpp', 'cs', 'md', 'json'
@@ -34,6 +35,7 @@ const DEFAULT_OPTIONS = {
     excludePatterns: DEFAULT_EXCLUDE_PATTERNS,
     maxFileSize: 1024 * 1024, // 1MB
     includeHidden: false,
+    mode: 'full',
 };
 function shouldExclude(filePath, patterns) {
     const normalizedPath = filePath.replace(/\\/g, '/');
@@ -96,11 +98,39 @@ function collectFiles(dir, options, baseDir = dir) {
     }
     return files.sort();
 }
-export function createSnapshot(projectPath, outputPath, options = {}) {
+/**
+ * Build the standard snapshot header lines, shared across all modes.
+ */
+export function buildSnapshotHeader(projectPath, fileCount, extensions, mode) {
+    return [
+        '================================================================================',
+        'CODEBASE SNAPSHOT',
+        `Project: ${projectPath}`,
+        `Generated: ${new Date().toISOString()}`,
+        `Extensions: ${extensions.join(', ')}`,
+        `Files: ${fileCount}`,
+        `Mode: ${mode}`,
+        '================================================================================',
+        '',
+    ];
+}
+/**
+ * Create a basic codebase snapshot.
+ *
+ * Writes a compressed `.zst` file to disk. The `outputPath` parameter is the
+ * canonical (uncompressed) path; the actual on-disk file is `outputPath + ".zst"`.
+ *
+ * Mode behaviour:
+ * - `"full"` — includes all file bodies (default, preserves existing behaviour)
+ * - `"graph"` / `"index"` — writes header + file tree only; `createEnhancedSnapshot`
+ *   appends the relevant structural metadata on top of this base
+ */
+export async function createSnapshot(projectPath, outputPath, options = {}) {
     const mergedOptions = {
         ...DEFAULT_OPTIONS,
         ...options,
     };
+    const mode = mergedOptions.mode;
     if (!existsSync(projectPath)) {
         throw new Error(`Project path does not exist: ${projectPath}`);
     }
@@ -108,7 +138,7 @@ export function createSnapshot(projectPath, outputPath, options = {}) {
     if (!stats.isDirectory()) {
         throw new Error(`Project path is not a directory: ${projectPath}`);
     }
-    // Ensure output directory exists
+    // Ensure output directory exists (for the .zst file)
     const outputDir = dirname(outputPath);
     if (!existsSync(outputDir)) {
         mkdirSync(outputDir, { recursive: true });
@@ -116,54 +146,60 @@ export function createSnapshot(projectPath, outputPath, options = {}) {
     // Collect all files
     const files = collectFiles(projectPath, mergedOptions);
     // Build snapshot content
-    const lines = [];
-    // Header
-    lines.push('================================================================================');
-    lines.push('CODEBASE SNAPSHOT');
-    lines.push(`Project: ${projectPath}`);
-    lines.push(`Generated: ${new Date().toISOString()}`);
-    lines.push(`Extensions: ${mergedOptions.extensions.join(', ')}`);
-    lines.push(`Files: ${files.length}`);
-    lines.push('================================================================================');
-    lines.push('');
-    // Process each file
-    for (const filePath of files) {
-        const relativePath = relative(projectPath, filePath);
-        lines.push('');
+    const lines = buildSnapshotHeader(projectPath, files.length, mergedOptions.extensions, mode);
+    if (mode === 'full') {
+        // Full mode: include every file body
+        for (const filePath of files) {
+            const relativePath = relative(projectPath, filePath);
+            lines.push('');
+            lines.push('================================================================================');
+            lines.push(`FILE: ./${relativePath}`);
+            lines.push('================================================================================');
+            try {
+                const content = readFileSync(filePath, 'utf-8');
+                lines.push(content);
+            }
+            catch {
+                lines.push('[Unable to read file]');
+            }
+        }
+    }
+    else {
+        // graph / index modes: emit file tree only (no bodies).
+        // createEnhancedSnapshot will append the relevant structural sections.
         lines.push('================================================================================');
-        lines.push(`FILE: ./${relativePath}`);
+        lines.push('FILE TREE');
         lines.push('================================================================================');
-        try {
-            const content = readFileSync(filePath, 'utf-8');
-            lines.push(content);
-        }
-        catch {
-            lines.push('[Unable to read file]');
+        for (const filePath of files) {
+            lines.push(`./${relative(projectPath, filePath)}`);
         }
     }
-    // Write snapshot
     const content = lines.join('\n');
-    writeFileSync(outputPath, content);
+    const diskPath = await writeCompressed(outputPath, content);
     const totalLines = content.split('\n').length;
     const totalSize = Buffer.byteLength(content, 'utf-8');
     return {
         outputPath,
+        diskPath,
         fileCount: files.length,
         totalLines,
         totalSize,
         files: files.map(f => relative(projectPath, f)),
+        mode,
     };
 }
+/**
+ * Return disk-level stats for an existing snapshot.
+ * Accepts the canonical (uncompressed) path; transparently resolves to `.zst`.
+ */
 export function getSnapshotStats(snapshotPath) {
-    if (!existsSync(snapshotPath)) {
+    const zstPath = compressedPath(snapshotPath);
+    const actualPath = existsSync(zstPath) ? zstPath : snapshotPath;
+    if (!existsSync(actualPath)) {
         throw new Error(`Snapshot file does not exist: ${snapshotPath}`);
     }
-    const content = readFileSync(snapshotPath, 'utf-8');
-    const totalLines = content.split('\n').length;
-    const totalSize = Buffer.byteLength(content, 'utf-8');
-    // Count FILE: markers
-    const fileMatches = content.match(/^FILE: /gm);
-    const fileCount = fileMatches ? fileMatches.length : 0;
-    return { fileCount, totalLines, totalSize };
+    // Return disk size; for full line/file counts callers should decompress
+    const diskSize = statSync(actualPath).size;
+    return { fileCount: 0, totalLines: 0, totalSize: diskSize };
 }
 //# sourceMappingURL=snapshot.js.map

package/dist/tools/demerzel/snapshot.js.map

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

package/dist/tools/demerzel/zstd-io.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Demerzel zstd I/O helpers
+ *
+ * Wraps @mongodb-js/zstd for snapshot read/write.
+ * Write path: always produces <outputPath>.zst
+ * Read path: tries <path>.zst first; falls back to legacy <path> (plain text)
+ */
+/** The `.zst` extension suffix appended to snapshot paths on disk. */
+export declare const ZST_SUFFIX = ".zst";
+/**
+ * Given a canonical snapshot path (e.g. `.foundation/snapshot.txt`), returns
+ * the on-disk compressed path (`.foundation/snapshot.txt.zst`).
+ */
+export declare function compressedPath(snapshotPath: string): string;
+/**
+ * Write `content` to `<snapshotPath>.zst`.
+ * The uncompressed `.txt` file is NOT written — only the compressed form.
+ *
+ * @returns The actual path written to disk (i.e. `snapshotPath + ".zst"`).
+ */
+export declare function writeCompressed(snapshotPath: string, content: string): Promise<string>;
+/**
+ * Read a snapshot, transparently handling both compressed and legacy formats.
+ *
+ * Resolution order:
+ * 1. `<snapshotPath>.zst` — decompress and return UTF-8 string
+ * 2. `<snapshotPath>` (legacy plain text) — read directly
+ * 3. Throws if neither exists
+ */
+export declare function readSnapshotContent(snapshotPath: string): Promise<string>;
+/**
+ * Check whether a snapshot exists on disk (either compressed or legacy).
+ */
+export declare function snapshotExists(snapshotPath: string): boolean;
+/**
+ * Return the actual on-disk path for a snapshot (compressed if present,
+ * otherwise legacy), or `null` if neither exists.
+ */
+export declare function resolveSnapshotPath(snapshotPath: string): string | null;
+//# sourceMappingURL=zstd-io.d.ts.map

package/dist/tools/demerzel/zstd-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zstd-io.d.ts","sourceRoot":"","sources":["../../../src/tools/demerzel/zstd-io.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,sEAAsE;AACtE,eAAO,MAAM,UAAU,SAAS,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5F;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvE"}

package/dist/tools/demerzel/zstd-io.js

@@ -0,0 +1,69 @@
+/**
+ * Demerzel zstd I/O helpers
+ *
+ * Wraps @mongodb-js/zstd for snapshot read/write.
+ * Write path: always produces <outputPath>.zst
+ * Read path: tries <path>.zst first; falls back to legacy <path> (plain text)
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { compress, decompress } from '@mongodb-js/zstd';
+/** The `.zst` extension suffix appended to snapshot paths on disk. */
+export const ZST_SUFFIX = '.zst';
+/**
+ * Given a canonical snapshot path (e.g. `.foundation/snapshot.txt`), returns
+ * the on-disk compressed path (`.foundation/snapshot.txt.zst`).
+ */
+export function compressedPath(snapshotPath) {
+    return snapshotPath + ZST_SUFFIX;
+}
+/**
+ * Write `content` to `<snapshotPath>.zst`.
+ * The uncompressed `.txt` file is NOT written — only the compressed form.
+ *
+ * @returns The actual path written to disk (i.e. `snapshotPath + ".zst"`).
+ */
+export async function writeCompressed(snapshotPath, content) {
+    const zstPath = compressedPath(snapshotPath);
+    const compressed = await compress(Buffer.from(content, 'utf-8'));
+    writeFileSync(zstPath, compressed);
+    return zstPath;
+}
+/**
+ * Read a snapshot, transparently handling both compressed and legacy formats.
+ *
+ * Resolution order:
+ * 1. `<snapshotPath>.zst` — decompress and return UTF-8 string
+ * 2. `<snapshotPath>` (legacy plain text) — read directly
+ * 3. Throws if neither exists
+ */
+export async function readSnapshotContent(snapshotPath) {
+    const zstPath = compressedPath(snapshotPath);
+    if (existsSync(zstPath)) {
+        const compressed = readFileSync(zstPath);
+        const decompressed = await decompress(compressed);
+        return decompressed.toString('utf-8');
+    }
+    if (existsSync(snapshotPath)) {
+        return readFileSync(snapshotPath, 'utf-8');
+    }
+    throw new Error(`Snapshot not found: tried ${zstPath} and ${snapshotPath}`);
+}
+/**
+ * Check whether a snapshot exists on disk (either compressed or legacy).
+ */
+export function snapshotExists(snapshotPath) {
+    return existsSync(compressedPath(snapshotPath)) || existsSync(snapshotPath);
+}
+/**
+ * Return the actual on-disk path for a snapshot (compressed if present,
+ * otherwise legacy), or `null` if neither exists.
+ */
+export function resolveSnapshotPath(snapshotPath) {
+    const zstPath = compressedPath(snapshotPath);
+    if (existsSync(zstPath))
+        return zstPath;
+    if (existsSync(snapshotPath))
+        return snapshotPath;
+    return null;
+}
+//# sourceMappingURL=zstd-io.js.map

package/dist/tools/demerzel/zstd-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zstd-io.js","sourceRoot":"","sources":["../../../src/tools/demerzel/zstd-io.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAExD,sEAAsE;AACtE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,OAAO,YAAY,GAAG,UAAU,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,YAAoB,EAAE,OAAe;IACzE,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,YAAoB;IAC5D,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAE7C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAClD,OAAO,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,QAAQ,YAAY,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,OAAO,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,IAAI,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/gaia/index.d.ts

@@ -6,7 +6,7 @@
  *
  * v2: SQLite + FTS5 memory system with 5-tier hierarchy and BM25 ranking.
  *
- * Tools (16 total):
+ * Tools (17 total):
  * Checkpoint/Session Tools (9):
  * - gaia_checkpoint: Save full structured state to disk
  * - gaia_status: Return lightweight index card (~150 tokens)
@@ -25,9 +25,10 @@
  * - gaia_delete: Delete memory + cascade links
  * - gaia_stats: Get memory statistics
  *
- * Linking Tools (2):
- * - gaia_link: Create typed link between memories
- * - gaia_graph: Get link graph for a memory
+ * Linking Tools (3):
+ * - gaia_link: Create typed link between memories (with optional valid_from backfill)
+ * - gaia_invalidate: Soft-delete a link by setting invalidated_at
+ * - gaia_graph: Get link graph for a memory (with optional as_of temporal filter)
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare function registerGaiaTools(server: McpServer): void;

package/dist/tools/gaia/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/gaia/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6GzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA42CzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/gaia/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8GzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAihDzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}

package/dist/tools/gaia/index.js

@@ -6,7 +6,7 @@
  *
  * v2: SQLite + FTS5 memory system with 5-tier hierarchy and BM25 ranking.
  *
- * Tools (16 total):
+ * Tools (17 total):
  * Checkpoint/Session Tools (9):
  * - gaia_checkpoint: Save full structured state to disk
  * - gaia_status: Return lightweight index card (~150 tokens)
@@ -25,9 +25,10 @@
  * - gaia_delete: Delete memory + cascade links
  * - gaia_stats: Get memory statistics
  *
- * Linking Tools (2):
- * - gaia_link: Create typed link between memories
- * - gaia_graph: Get link graph for a memory
+ * Linking Tools (3):
+ * - gaia_link: Create typed link between memories (with optional valid_from backfill)
+ * - gaia_invalidate: Soft-delete a link by setting invalidated_at
+ * - gaia_graph: Get link graph for a memory (with optional as_of temporal filter)
  */
 import { z } from 'zod';
 import { nanoid } from 'nanoid';
@@ -37,6 +38,7 @@ import { homedir } from 'os';
 import { StorageService } from '../../services/storage.service.js';
 import { GitService } from '../../services/git.service.js';
 import { MemoriaStorage } from './storage.js';
+import { createIngester } from './transcript-ingester.js';
 // =============================================================================
 // Memory Storage (v2.0)
 // =============================================================================
@@ -1155,7 +1157,9 @@ export function registerGaiaTools(server) {
         to_memory_id: z.string().describe('Target memory ID'),
         link_type: z.enum(['depends_on', 'extends', 'reverts', 'related', 'contradicts'])
             .describe('Link type: depends_on (requires), extends (builds on), reverts (undoes), related (associated), contradicts (conflicts)'),
-    }, async ({ from_memory_id, to_memory_id, link_type }) => {
+        valid_from: z.string().optional()
+            .describe('ISO 8601 timestamp for when this link became true. Defaults to now. Useful for backfilling historical links.'),
+    }, async ({ from_memory_id, to_memory_id, link_type, valid_from }) => {
         try {
             const storage = getMemoryStorage();
             // Verify both memories exist
@@ -1183,10 +1187,12 @@ export function registerGaiaTools(server) {
                         }],
                 };
             }
+            const validFromMs = valid_from ? new Date(valid_from).getTime() : undefined;
             const link = storage.createLink({
                 from_memory_id,
                 to_memory_id,
                 link_type,
+                validFrom: validFromMs,
             });
             return {
                 content: [{
@@ -1194,10 +1200,13 @@ export function registerGaiaTools(server) {
                         text: JSON.stringify({
                             success: true,
                             link: {
+                                link_id: link.link_id,
                                 from_memory_id: link.from_memory_id,
                                 to_memory_id: link.to_memory_id,
                                 link_type: link.link_type,
                                 created_at: link.created_at,
+                                valid_from: link.valid_from,
+                                invalidated_at: link.invalidated_at,
                             },
                             from_memory_content: fromMemory.content.substring(0, 100),
                             to_memory_content: toMemory.content.substring(0, 100),
@@ -1215,10 +1224,65 @@ export function registerGaiaTools(server) {
             };
         }
     });
+    // gaia_invalidate
+    server.tool('gaia_invalidate', 'Invalidate a memory link by setting its invalidated_at timestamp. After invalidation, the link is excluded from gaia_graph queries unless a historical as_of timestamp is used. Idempotent: if the link is already invalidated, the existing state is returned without modification.', {
+        link_id: z.string().describe('The link_id of the link to invalidate (returned by gaia_link)'),
+        at: z.string().optional()
+            .describe('ISO 8601 timestamp for when the link was invalidated. Defaults to now.'),
+    }, async ({ link_id, at }) => {
+        try {
+            const storage = getMemoryStorage();
+            const atMs = at ? new Date(at).getTime() : undefined;
+            const result = storage.invalidateLink(link_id, atMs);
+            if (!result.success && result.link.from_memory_id === '') {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: `Link not found: ${link_id}`,
+                            }, null, 2),
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: result.success,
+                            ...(result.warning ? { warning: result.warning } : {}),
+                            link: {
+                                link_id: result.link.link_id,
+                                from_memory_id: result.link.from_memory_id,
+                                to_memory_id: result.link.to_memory_id,
+                                link_type: result.link.link_type,
+                                created_at: result.link.created_at,
+                                valid_from: result.link.valid_from,
+                                invalidated_at: result.link.invalidated_at,
+                                invalidated_at_iso: result.link.invalidated_at
+                                    ? new Date(result.link.invalidated_at).toISOString()
+                                    : null,
+                            },
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error invalidating link: ${error instanceof Error ? error.message : String(error)}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
     // gaia_graph
-    server.tool('gaia_graph', 'Get the link graph for a memory. Returns all linked memories grouped by link type.', {
+    server.tool('gaia_graph', 'Get the link graph for a memory. Returns all linked memories grouped by link type. Supports temporal filtering via as_of to answer "what was true at time X?"', {
         memory_id: z.string().describe('Memory ID to get links for'),
-    }, async ({ memory_id }) => {
+        as_of: z.string().optional()
+            .describe('ISO 8601 timestamp — only return links that were valid at this point in time (valid_from <= as_of AND (invalidated_at IS NULL OR invalidated_at > as_of)). Defaults to now, which returns all currently-valid links.'),
+    }, async ({ memory_id, as_of }) => {
         try {
             const storage = getMemoryStorage();
             // Verify memory exists
@@ -1234,7 +1298,8 @@ export function registerGaiaTools(server) {
                         }],
                 };
             }
-            const links = storage.getLinks(memory_id);
+            const asOfMs = as_of ? new Date(as_of).getTime() : undefined;
+            const links = storage.getLinks(memory_id, asOfMs);
             // Count total links
             const totalLinks = Object.values(links).reduce((sum, arr) => sum + arr.length, 0);
             return {
@@ -1245,6 +1310,7 @@ export function registerGaiaTools(server) {
                             memory_id,
                             memory_content: memory.content.substring(0, 100),
                             total_links: totalLinks,
+                            as_of: as_of ?? new Date().toISOString(),
                             links: {
                                 depends_on: links.depends_on.map(m => ({
                                     id: m.id,
@@ -1286,6 +1352,87 @@ export function registerGaiaTools(server) {
             };
         }
     });
+    // ===========================================================================
+    // Transcript Ingestion Tool
+    // ===========================================================================
+    // gaia_ingest_transcripts
+    server.tool('gaia_ingest_transcripts', 'Walk ~/.claude/projects/**/*.jsonl, parse Claude Code conversation transcripts, and index human + assistant prose into Gaia\'s FTS5 memory store. Supports incremental re-runs (byte-offset tracking), deduplication, project filtering, and a dryRun preview mode.', {
+        rootDir: z.string().optional()
+            .describe('Root directory to walk for JSONL files. Defaults to ~/.claude/projects'),
+        projectFilter: z.string().optional()
+            .describe('Substring to match against project slugs (e.g. "foundation" to only ingest Foundation-related transcripts)'),
+        since: z.string().optional()
+            .describe('ISO 8601 timestamp — only ingest messages newer than this (e.g. "2026-01-01T00:00:00Z")'),
+        dryRun: z.boolean().optional()
+            .describe('Walk and report what WOULD be ingested without writing to Gaia. Default: false'),
+    }, async ({ rootDir, projectFilter, since, dryRun = false }) => {
+        try {
+            const memStorage = getMemoryStorage();
+            const db = memStorage.getInternalDb();
+            const ingester = createIngester(db, memStorage);
+            const stats = await ingester.ingest({
+                rootDir,
+                projectFilter,
+                since,
+                dryRun,
+            });
+            const lines = [];
+            lines.push(`## gaia_ingest_transcripts${dryRun ? ' (DRY RUN)' : ''}`);
+            lines.push('');
+            lines.push(`Files found: ${stats.filesFound}`);
+            lines.push(`Files skipped (no new content): ${stats.filesSkipped}`);
+            lines.push(`Messages ingested: ${stats.messagesIngested}`);
+            lines.push(`Messages skipped (dedupe): ${stats.messagesSkipped}`);
+            lines.push(`Bytes processed: ${(stats.bytesProcessed / 1024).toFixed(1)} KB`);
+            lines.push(`Parse errors: ${stats.parseErrors}`);
+            lines.push('');
+            if (stats.projectSlugs.length > 0) {
+                lines.push(`Projects (${stats.projectSlugs.length}):`);
+                for (const slug of stats.projectSlugs.slice(0, 20)) {
+                    lines.push(`  - ${slug}`);
+                }
+                if (stats.projectSlugs.length > 20) {
+                    lines.push(`  ... and ${stats.projectSlugs.length - 20} more`);
+                }
+                lines.push('');
+            }
+            if (stats.dateRange.earliest || stats.dateRange.latest) {
+                lines.push(`Date range:`);
+                lines.push(`  Earliest: ${stats.dateRange.earliest ?? 'unknown'}`);
+                lines.push(`  Latest:   ${stats.dateRange.latest ?? 'unknown'}`);
+                lines.push('');
+            }
+            if (stats.parseErrorSamples.length > 0) {
+                lines.push(`Sample parse errors:`);
+                for (const sample of stats.parseErrorSamples) {
+                    lines.push(`  - ${sample}`);
+                }
+                lines.push('');
+            }
+            if (dryRun) {
+                lines.push('DRY RUN: No data was written to Gaia.');
+                lines.push('Set dryRun: false to perform actual ingestion.');
+            }
+            else if (stats.messagesIngested > 0) {
+                lines.push(`Memories are now searchable via gaia_search with tags: ["transcript"]`);
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: lines.join('\n'),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error ingesting transcripts: ${error instanceof Error ? error.message : String(error)}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
 }
 /**
  * Cleanup function to close database connection