suemo 0.0.2 → 0.0.3

package/README.md

@@ -125,7 +125,8 @@ Commands:
   doctor embed          Diagnose fn::embed setup and print fix steps
   health                Memory health report
   health vitals         Last 10 consolidation runs + node counts
-  sync                  Push memories to a remote SurrealDB instance
+  health stats          Lightweight usage counters and timestamps
+	sync                  Sync memories with a remote SurrealDB instance
   export                Stream memories to JSONL on stdout
   import <file>         Import memories from a JSONL file
 ```
@@ -176,9 +177,56 @@ export default defineConfig({
 		weights: { vector: 0.5, bm25: 0.25, graph: 0.15, temporal: 0.1 },
 	},
 	mcp: { port: 4242, host: '127.0.0.1' },
+	sync: {
+		remotes: {
+			vps: {
+				url: process.env.SUEMO_SYNC_URL!,
+				namespace: process.env.SUEMO_SYNC_NS!,
+				database: process.env.SUEMO_SYNC_DB!,
+				auth: {
+					user: process.env.SUEMO_SYNC_USER!,
+					pass: process.env.SUEMO_SYNC_PASS!,
+				},
+			},
+		},
+		defaultRemote: 'vps',
+		auto: {
+			enabled: false,
+			intervalSeconds: 300,
+			direction: 'push',
+			remote: 'vps',
+			onWrite: false,
+			minWriteIntervalSeconds: 30,
+		},
+	},
 })
 ```
 
+### Sync config notes
+
+- `sync.remotes` supports multiple named remote instances.
+- `sync.defaultRemote` is used by `suemo sync` unless `--remote` is provided.
+- Legacy `sync.remote` (single target) is still supported for migration compatibility.
+- `sync.auto` powers background sync in `suemo serve` (HTTP and stdio):
+  - `enabled`: master switch
+  - `intervalSeconds`: timer cadence
+  - `direction`: `push | pull | both`
+  - `remote`: named target from `sync.remotes`
+  - `onWrite`: trigger sync after mutating MCP tools
+  - `minWriteIntervalSeconds`: throttle for write-triggered sync
+
+Manual sync examples:
+
+```sh
+suemo sync --direction both
+suemo sync --remote vps --direction pull
+suemo sync --remote vps --direction push --dry-run
+```
+
+Minimal local↔VPS smoke test guide:
+
+- `data/scenarios/sync-local-vps.md`
+
 Multiple agents on the same machine use separate config files that extend a shared base:
 
 ```ts
@@ -212,22 +260,28 @@ This prints your active target (`url`, `namespace`, `database`) and step-by-step
 
 ## MCP Tools
 
-| Tool            | Description                                                         |
-| --------------- | ------------------------------------------------------------------- |
-| `observe`       | Store an observation, belief, question, or hypothesis               |
-| `believe`       | Store a belief — auto-detects and invalidates contradicting beliefs |
-| `invalidate`    | Soft-delete a node by ID (sets `valid_until`)                       |
-| `query`         | Hybrid semantic search (vector + BM25 + graph)                      |
-| `recall`        | Fetch a node and its 1-hop neighbourhood; ticks FSRS                |
-| `wander`        | Spreading-activation walk through the graph                         |
-| `timeline`      | Chronological memory slice with optional date range                 |
-| `episode_start` | Begin a bounded session window                                      |
-| `episode_end`   | Close a session, optionally with a summary                          |
-| `goal_set`      | Create a goal node                                                  |
-| `goal_resolve`  | Mark a goal achieved                                                |
-| `goal_list`     | List active (or all) goals                                          |
-| `consolidate`   | Manually trigger NREM + REM consolidation                           |
-| `health`        | Graph health report                                                 |
+| Tool                  | Description                                                         |
+| --------------------- | ------------------------------------------------------------------- |
+| `observe`             | Store an observation, belief, question, or hypothesis               |
+| `believe`             | Store a belief — auto-detects and invalidates contradicting beliefs |
+| `invalidate`          | Soft-delete a node by ID (sets `valid_until`)                       |
+| `query`               | Hybrid semantic search (vector + BM25 + graph)                      |
+| `recall`              | Fetch a node and its 1-hop neighbourhood; ticks FSRS                |
+| `wander`              | Spreading-activation walk through the graph                         |
+| `timeline`            | Chronological memory slice with optional date range                 |
+| `episode_start`       | Begin a bounded session window                                      |
+| `episode_end`         | Close a session, optionally with a summary                          |
+| `goal_set`            | Create a goal node                                                  |
+| `goal_resolve`        | Mark a goal achieved                                                |
+| `goal_list`           | List active (or all) goals                                          |
+| `upsert_by_key`       | Upsert a memory node by stable topic key                            |
+| `capture_prompt`      | Capture raw prompt and link derived observations                    |
+| `session_context_get` | Fetch open episode summary/context by session ID                    |
+| `session_context_set` | Update open episode summary/context by session ID                   |
+| `consolidate`         | Manually trigger NREM + REM consolidation                           |
+| `health`              | Graph health report                                                 |
+| `vitals`              | Last 10 consolidation runs + grouped node counts                    |
+| `stats`               | Lightweight usage stats and write/query counters                    |
 
 Agents never supply temporal fields (`valid_from`, `valid_until`). These are system-managed.
 
@@ -258,6 +312,25 @@ The CLI and MCP server are both thin shells. All logic lives in the domain layer
 
 ---
 
+## Giant end-to-end scenario (all tools / fields)
+
+For full-system stress testing (CLI + MCP + consolidation + relation kinds), use:
+
+- `data/scenarios/giant-scenario.md` — walkthrough + validation queries
+- `data/scenarios/run-giant-cli.sh` — comprehensive CLI flow
+- `data/scenarios/run-giant-mcp.mjs` — comprehensive stdio MCP flow
+
+Example:
+
+```sh
+./data/scenarios/run-giant-cli.sh ~/.suemo/suemo.ts giant-cli-main
+bun data/scenarios/run-giant-mcp.mjs --config ~/.suemo/suemo.ts --scope giant-mcp-main
+```
+
+These scenarios intentionally exercise all memory kinds and all relation kinds, and produce enough incident-like data to observe NREM/REM behavior.
+
+---
+
 ## Stack
 
 - **Runtime** — [Bun](https://bun.sh)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "suemo",
-	"version": "0.0.2",
+	"version": "0.0.3",
 	"description": "Persistent semantic memory for AI agents — backed by SurrealDB.",
 	"author": {
 		"name": "Umar Alfarouk",

package/src/cli/commands/export-import.ts

@@ -84,7 +84,32 @@ export const importCmd = app.sub('import')
 						await db.query('INSERT IGNORE INTO memory $row', { row })
 						imported++
 					} else if (type === 'relation') {
-						await db.query('INSERT IGNORE INTO relates_to $row', { row })
+						const inId = typeof row['in'] === 'string' ? row['in'] : undefined
+						const outId = typeof row['out'] === 'string' ? row['out'] : undefined
+						const kind = typeof row['kind'] === 'string' ? row['kind'] : undefined
+						const strength = typeof row['strength'] === 'number' ? row['strength'] : undefined
+
+						if (!inId || !outId || !kind || strength === undefined) {
+							skipped++
+							continue
+						}
+
+						await db.query(
+							`
+							LET $inRec = type::record($in);
+							LET $outRec = type::record($out);
+							RELATE $inRec->relates_to->$outRec CONTENT {
+							  kind: $kind,
+							  strength: $strength
+							};
+						`,
+							{
+								in: inId,
+								out: outId,
+								kind,
+								strength,
+							},
+						)
 						imported++
 					} else {
 						skipped++

package/src/cli/commands/health.ts

@@ -1,5 +1,5 @@
 import type { Surreal } from 'surrealdb'
-import { healthReport, vitals } from '../../cognitive/health.ts'
+import { healthReport, suemoStats, vitals } from '../../cognitive/health.ts'
 import { loadConfig } from '../../config.ts'
 import { connect, disconnect } from '../../db/client.ts'
 import { getLogger } from '../../logger.ts'
@@ -42,9 +42,26 @@ const vitalsCmd = health.sub('vitals')
 		}
 	})
 
+const statsCmd = health.sub('stats')
+	.meta({ description: 'Lightweight usage stats' })
+	.run(async ({ flags }) => {
+		await initCliCommand('health stats', { debug: flags.debug, config: flags.config })
+		log.debug('Running health stats command')
+		const config = await loadConfig(process.cwd(), flags.config)
+		let db: Surreal | undefined
+		try {
+			db = await connect(config.surreal)
+			const s = await suemoStats(db)
+			console.log(JSON.stringify(s, null, 2))
+		} finally {
+			if (db) await disconnect()
+		}
+	})
+
 export const healthCmd = health
 	.command(reportCmd)
 	.command(vitalsCmd)
+	.command(statsCmd)
 	// Default: run the report when just `suemo health` is called
 	.run(async ({ flags }) => {
 		await initCliCommand('health', { debug: flags.debug, config: flags.config })

package/src/cli/commands/observe.ts

@@ -44,6 +44,7 @@ export const observeCmd = app.sub('observe')
 				scope: flags.scope,
 				confidence: flags.confidence,
 				source: flags.source,
+				sessionId: flags.session,
 			}, config)
 			console.log(JSON.stringify({ id: node.id, kind: node.kind, valid_from: node.valid_from }, null, 2))
 		} finally {

package/src/cli/commands/serve.ts

@@ -1,4 +1,4 @@
-import { loadConfig } from '../../config.ts'
+import { loadConfig, resolveSyncConfig } from '../../config.ts'
 import { getLogger } from '../../logger.ts'
 import { startMcpServer, startMcpStdioServer } from '../../mcp/server.ts'
 import { app, initCliCommand } from '../shared.ts'
@@ -15,6 +15,16 @@ export const serveCmd = app.sub('serve')
 	.run(async ({ flags }) => {
 		await initCliCommand('serve', { debug: flags.debug, config: flags.config })
 		const config = await loadConfig(process.cwd(), flags.config)
+		const sync = resolveSyncConfig(config)
+		if (sync?.auto.enabled) {
+			log.info('Auto-sync enabled', {
+				remote: sync.auto.remote,
+				direction: sync.auto.direction,
+				intervalSeconds: sync.auto.intervalSeconds,
+				onWrite: sync.auto.onWrite,
+				minWriteIntervalSeconds: sync.auto.minWriteIntervalSeconds,
+			})
+		}
 		if (flags.stdio) {
 			log.debug('Starting MCP stdio transport')
 			await startMcpStdioServer(config)

package/src/cli/commands/sync.ts

@@ -1,4 +1,4 @@
-import { loadConfig } from '../../config.ts'
+import { loadConfig, resolveSyncConfig, type SurrealTarget } from '../../config.ts'
 import { connect, disconnect } from '../../db/client.ts'
 import { getLogger } from '../../logger.ts'
 import { syncTo } from '../../sync.ts'
@@ -7,24 +7,49 @@ import { app, initCliCommand } from '../shared.ts'
 const log = getLogger(['suemo', 'cli', 'sync'])
 
 export const syncCmd = app.sub('sync')
-	.meta({ description: 'Push memories to remote SurrealDB (append-only)' })
+	.meta({ description: 'Sync memories with remote SurrealDB (push/pull/both)' })
 	.flags({
 		'dry-run': { type: 'boolean', description: 'Show what would be pushed without writing', default: false },
+		direction: { type: 'string', description: 'Sync direction: push | pull | both', default: 'push' },
+		remote: { type: 'string', description: 'Named remote from sync.remotes (defaults to sync.defaultRemote)' },
 	})
 	.run(async ({ flags }) => {
 		await initCliCommand('sync', { debug: flags.debug, config: flags.config })
 		const config = await loadConfig(process.cwd(), flags.config)
-		if (!config.sync) {
-			console.error('No sync.remote configured in suemo config.')
+		const sync = resolveSyncConfig(config)
+		if (!sync) {
+			console.error('No sync remotes configured. Set sync.remotes (or legacy sync.remote) in suemo config.')
 			process.exit(1)
 		}
+
+		const selectedRemoteName = flags.remote ?? sync.defaultRemote
+		const remote: SurrealTarget | undefined = sync.remotes[selectedRemoteName]
+		if (!remote) {
+			console.error(
+				`Unknown sync remote "${selectedRemoteName}". Available: ${Object.keys(sync.remotes).join(', ')}`,
+			)
+			process.exit(1)
+		}
+
 		log.debug('Running sync command', {
 			dryRun: flags['dry-run'],
-			target: `${config.sync.remote.url}/${config.sync.remote.namespace}/${config.sync.remote.database}`,
+			direction: flags.direction,
+			remote: selectedRemoteName,
+			target: `${remote.url}/${remote.namespace}/${remote.database}`,
 		})
+
+		const direction = flags.direction as 'push' | 'pull' | 'both'
+		if (!['push', 'pull', 'both'].includes(direction)) {
+			console.error(`Invalid direction "${flags.direction}". Use: push, pull, or both`)
+			process.exit(1)
+		}
+
 		const db = await connect(config.surreal)
 		try {
-			const result = await syncTo(db, config.sync.remote, { dryRun: flags['dry-run'] })
+			const result = await syncTo(db, remote, {
+				dryRun: flags['dry-run'],
+				direction,
+			})
 			console.log(JSON.stringify(result, null, 2))
 		} finally {
 			await disconnect()

package/src/cognitive/health.ts

@@ -1,7 +1,7 @@
 import type { Surreal } from 'surrealdb'
 import { checkCompatibility } from '../db/preflight.ts'
 import { getLogger } from '../logger.ts'
-import type { ConsolidationRun, HealthReport } from '../types.ts'
+import type { ConsolidationRun, HealthReport, SuemoStats } from '../types.ts'
 
 const log = getLogger(['suemo', 'cognitive', 'health'])
 
@@ -121,3 +121,63 @@ export async function vitals(db: Surreal): Promise<{
 		nodesByScope,
 	}
 }
+
+export async function suemoStats(db: Surreal): Promise<SuemoStats> {
+	log.info('suemoStats()')
+
+	const [totalR, activeR, kindR, relR, runR, statsR] = await Promise.all([
+		db.query<[{ count: number }[]]>('SELECT count() AS count FROM memory GROUP ALL'),
+		db.query<[{ count: number }[]]>(
+			'SELECT count() AS count FROM memory WHERE valid_until = NONE OR valid_until > time::now() GROUP ALL',
+		),
+		db.query<[{ kind: string; count: number }[]]>('SELECT kind, count() AS count FROM memory GROUP BY kind'),
+		db.query<[{ count: number }[]]>('SELECT count() AS count FROM relates_to GROUP ALL'),
+		db.query<[{ count: number }[]]>('SELECT count() AS count FROM consolidation_run GROUP ALL'),
+		db.query<[
+			{ total_writes: number; total_queries: number; last_write: string | null; last_query: string | null }[],
+		]>(
+			'SELECT total_writes, total_queries, last_write, last_query FROM suemo_stats:default LIMIT 1',
+		),
+	])
+
+	const byKind: Record<string, number> = {}
+	for (const r of kindR[0] ?? []) byKind[r.kind] = r.count
+
+	const s = statsR[0]?.[0]
+
+	return {
+		totalNodes: totalR[0]?.[0]?.count ?? 0,
+		activeNodes: activeR[0]?.[0]?.count ?? 0,
+		nodesByKind: byKind,
+		relations: relR[0]?.[0]?.count ?? 0,
+		consolidationRuns: runR[0]?.[0]?.count ?? 0,
+		lastWrite: s?.last_write ?? null,
+		lastQuery: s?.last_query ?? null,
+		totalWrites: s?.total_writes ?? 0,
+		totalQueries: s?.total_queries ?? 0,
+	}
+}
+
+export async function incrementWriteStats(db: Surreal): Promise<void> {
+	await db.query(
+		`
+    UPSERT suemo_stats:default SET
+      ns_db        = $nsDb,
+      total_writes = total_writes + 1,
+      last_write   = time::now()
+  `,
+		{ nsDb: 'default' },
+	)
+}
+
+export async function incrementQueryStats(db: Surreal): Promise<void> {
+	await db.query(
+		`
+    UPSERT suemo_stats:default SET
+      ns_db         = $nsDb,
+      total_queries = total_queries + 1,
+      last_query    = time::now()
+  `,
+		{ nsDb: 'default' },
+	)
+}

package/src/config.template.ts

@@ -33,4 +33,26 @@ export default defineConfig({
 		port: Number(process.env.SUEMO_PORT) || 4242,
 		host: '127.0.0.1',
 	},
+	sync: {
+		remotes: {
+			vps: {
+				url: process.env.SUEMO_SYNC_URL ?? process.env.SUEMO_URL ?? 'ws://localhost:8000',
+				namespace: process.env.SUEMO_SYNC_NS ?? process.env.SUEMO_NS ?? 'suemo',
+				database: process.env.SUEMO_SYNC_DB ?? process.env.SUEMO_DB ?? 'suemo',
+				auth: {
+					user: process.env.SUEMO_SYNC_USER ?? process.env.SUEMO_USER ?? 'root',
+					pass: process.env.SUEMO_SYNC_PASS ?? process.env.SUEMO_PASS ?? 'pass',
+				},
+			},
+		},
+		defaultRemote: 'vps',
+		auto: {
+			enabled: false,
+			intervalSeconds: 300,
+			direction: 'push',
+			remote: 'vps',
+			onWrite: false,
+			minWriteIntervalSeconds: 30,
+		},
+	},
 })

package/src/config.ts

@@ -51,9 +51,41 @@ export interface McpConfig {
 	host: string
 }
 
+export type SyncDirectionConfig = 'push' | 'pull' | 'both'
+
+export interface SyncAutoConfig {
+	enabled?: boolean
+	intervalSeconds?: number
+	direction?: SyncDirectionConfig
+	remote?: string
+	onWrite?: boolean
+	minWriteIntervalSeconds?: number
+}
+
 export interface SyncConfig {
-	remote: SurrealTarget
-	cursor?: string // ISO datetime; absence means full sync on first run
+	/** Legacy single-remote config (still supported for migration safety). */
+	remote?: SurrealTarget
+	/** Named remotes for selectable sync targets. */
+	remotes?: Record<string, SurrealTarget>
+	/** Default key from `remotes` when no explicit remote is selected. */
+	defaultRemote?: string
+	/** Optional auto-sync behavior for long-running MCP servers. */
+	auto?: SyncAutoConfig
+}
+
+export interface ResolvedSyncAutoConfig {
+	enabled: boolean
+	intervalSeconds: number
+	direction: SyncDirectionConfig
+	remote: string
+	onWrite: boolean
+	minWriteIntervalSeconds: number
+}
+
+export interface ResolvedSyncConfig {
+	remotes: Record<string, SurrealTarget>
+	defaultRemote: string
+	auto: ResolvedSyncAutoConfig
 }
 
 export interface SuemoConfig {
@@ -71,6 +103,55 @@ export function defineConfig(config: SuemoConfig): SuemoConfig {
 	return config
 }
 
+export function resolveSyncConfig(config: SuemoConfig): ResolvedSyncConfig | null {
+	if (!config.sync) return null
+
+	const remotes: Record<string, SurrealTarget> = config.sync.remotes
+		? { ...config.sync.remotes }
+		: (config.sync.remote ? { default: config.sync.remote } : {})
+
+	const remoteNames = Object.keys(remotes)
+	if (remoteNames.length === 0) return null
+
+	const defaultRemote = config.sync.defaultRemote ?? remoteNames[0]!
+	if (!remotes[defaultRemote]) {
+		throw new Error(
+			`sync.defaultRemote \"${defaultRemote}\" does not exist in sync.remotes. Available: ${remoteNames.join(', ')}`,
+		)
+	}
+
+	const auto = config.sync.auto ?? {}
+	const intervalSeconds = auto.intervalSeconds ?? 300
+	const minWriteIntervalSeconds = auto.minWriteIntervalSeconds ?? 30
+
+	if (!Number.isFinite(intervalSeconds) || intervalSeconds <= 0) {
+		throw new Error('sync.auto.intervalSeconds must be a positive number')
+	}
+	if (!Number.isFinite(minWriteIntervalSeconds) || minWriteIntervalSeconds < 0) {
+		throw new Error('sync.auto.minWriteIntervalSeconds must be >= 0')
+	}
+
+	const autoRemote = auto.remote ?? defaultRemote
+	if (!remotes[autoRemote]) {
+		throw new Error(
+			`sync.auto.remote \"${autoRemote}\" does not exist in sync.remotes. Available: ${remoteNames.join(', ')}`,
+		)
+	}
+
+	return {
+		remotes,
+		defaultRemote,
+		auto: {
+			enabled: auto.enabled ?? false,
+			intervalSeconds,
+			direction: auto.direction ?? 'push',
+			remote: autoRemote,
+			onWrite: auto.onWrite ?? false,
+			minWriteIntervalSeconds,
+		},
+	}
+}
+
 // ── loadConfig — resolution chain ────────────────────────────────────────────
 
 const CONFIG_CANDIDATES = [

package/src/db/schema.surql

@@ -13,6 +13,7 @@ DEFINE FIELD OVERWRITE content      ON memory TYPE string;
 DEFINE FIELD OVERWRITE summary      ON memory TYPE option<string>;
 DEFINE FIELD OVERWRITE tags         ON memory TYPE set<string>    DEFAULT {};
 DEFINE FIELD OVERWRITE scope        ON memory TYPE option<string>;
+DEFINE FIELD OVERWRITE topic_key    ON memory TYPE option<string> DEFAULT NONE;
 DEFINE FIELD OVERWRITE embedding    ON memory TYPE array<float>   DEFAULT [];
 DEFINE FIELD OVERWRITE confidence   ON memory TYPE float          DEFAULT 1.0;
 DEFINE FIELD OVERWRITE salience     ON memory TYPE float          DEFAULT 0.5;
@@ -24,6 +25,7 @@ DEFINE FIELD OVERWRITE valid_from   ON memory TYPE datetime       DEFAULT time::
 DEFINE FIELD OVERWRITE valid_until  ON memory TYPE option<datetime> DEFAULT NONE;
 
 DEFINE FIELD OVERWRITE source       ON memory TYPE option<string>;
+DEFINE FIELD OVERWRITE prompt_source ON memory TYPE option<record<memory>> DEFAULT NONE;
 DEFINE FIELD OVERWRITE created_at   ON memory TYPE datetime       DEFAULT time::now();
 DEFINE FIELD OVERWRITE updated_at   ON memory TYPE datetime       DEFAULT time::now();
 DEFINE FIELD OVERWRITE consolidated ON memory TYPE bool           DEFAULT false;
@@ -65,6 +67,9 @@ DEFINE INDEX OVERWRITE idx_memory_kind_valid
 DEFINE INDEX OVERWRITE idx_memory_salience
   ON memory FIELDS salience;
 
+DEFINE INDEX OVERWRITE idx_memory_topic_key
+  ON memory FIELDS topic_key;
+
 -- ── relates_to ───────────────────────────────────────────────────────────────
 DEFINE TABLE OVERWRITE relates_to SCHEMAFULL
   TYPE RELATION IN memory OUT memory;
@@ -76,6 +81,7 @@ DEFINE FIELD OVERWRITE strength   ON relates_to TYPE float   DEFAULT 0.5;
 DEFINE FIELD OVERWRITE valid_from  ON relates_to TYPE datetime DEFAULT time::now();
 DEFINE FIELD OVERWRITE valid_until ON relates_to TYPE option<datetime> DEFAULT NONE;
 DEFINE FIELD OVERWRITE created_at ON relates_to TYPE datetime DEFAULT time::now();
+DEFINE FIELD OVERWRITE updated_at ON relates_to TYPE datetime DEFAULT time::now();
 
 -- ── episode ───────────────────────────────────────────────────────────────────
 DEFINE TABLE OVERWRITE episode SCHEMAFULL;
@@ -84,6 +90,7 @@ DEFINE FIELD OVERWRITE session_id  ON episode TYPE string;
 DEFINE FIELD OVERWRITE started_at  ON episode TYPE datetime DEFAULT time::now();
 DEFINE FIELD OVERWRITE ended_at    ON episode TYPE option<datetime> DEFAULT NONE;
 DEFINE FIELD OVERWRITE summary     ON episode TYPE option<string>;
+DEFINE FIELD OVERWRITE context     ON episode TYPE option<object> DEFAULT NONE;
 
 -- REFERENCES: bidirectional array of memory links
 DEFINE FIELD OVERWRITE memory_ids  ON episode
@@ -105,8 +112,19 @@ DEFINE FIELD OVERWRITE error        ON consolidation_run TYPE option<string> DEF
 
 -- ── sync_cursor ───────────────────────────────────────────────────────────────
 -- One record per (remote.url, remote.ns, remote.db) triple.
--- Stores the last successfully synced created_at timestamp.
+-- Stores per-remote cursors for push/pull sync based on updated_at.
 DEFINE TABLE OVERWRITE sync_cursor SCHEMAFULL;
 DEFINE FIELD OVERWRITE remote_key  ON sync_cursor TYPE string;  -- sha1(url+ns+db)
 DEFINE FIELD OVERWRITE cursor      ON sync_cursor TYPE datetime;
+DEFINE FIELD OVERWRITE push_cursor ON sync_cursor TYPE datetime DEFAULT d'1970-01-01T00:00:00Z';
+DEFINE FIELD OVERWRITE pull_cursor ON sync_cursor TYPE datetime DEFAULT d'1970-01-01T00:00:00Z';
 DEFINE FIELD OVERWRITE last_synced ON sync_cursor TYPE datetime DEFAULT time::now();
+
+-- ── suemo_stats ──────────────────────────────────────────────────────────────
+DEFINE TABLE OVERWRITE suemo_stats SCHEMAFULL;
+DEFINE FIELD OVERWRITE ns_db         ON suemo_stats TYPE string;
+DEFINE FIELD OVERWRITE total_writes  ON suemo_stats TYPE int DEFAULT 0;
+DEFINE FIELD OVERWRITE total_queries ON suemo_stats TYPE int DEFAULT 0;
+DEFINE FIELD OVERWRITE last_write    ON suemo_stats TYPE option<datetime> DEFAULT NONE;
+DEFINE FIELD OVERWRITE last_query    ON suemo_stats TYPE option<datetime> DEFAULT NONE;
+DEFINE INDEX OVERWRITE idx_stats_ns  ON suemo_stats FIELDS ns_db;

package/src/index.ts

@@ -1,13 +1,17 @@
 // src/index.ts — public API surface
-export { defineConfig, loadConfig } from './config.ts'
+export { defineConfig, loadConfig, resolveSyncConfig } from './config.ts'
 export type {
 	AuthConfig,
 	ConsolidationConfig,
 	EmbeddingProvider,
 	LLMConfig,
 	McpConfig,
+	ResolvedSyncAutoConfig,
+	ResolvedSyncConfig,
 	RetrievalConfig,
 	SuemoConfig,
 	SurrealTarget,
+	SyncAutoConfig,
 	SyncConfig,
+	SyncDirectionConfig,
 } from './config.ts'