suemo 0.0.3 → 0.0.5

package/README.md

@@ -96,6 +96,14 @@ suemo serve
 # Listening on http://127.0.0.1:4242
 ```
 
+For development with automatic restart on file changes:
+
+```sh
+suemo serve --dev
+```
+
+`--dev` re-runs `suemo serve` under Bun watch mode and restarts MCP when source files change.
+
 ---
 
 ## CLI Reference
@@ -161,8 +169,8 @@ export default defineConfig({
 		},
 	},
 	embedding: {
-		provider: 'surreal', // fn::embed() — configured in SurrealDB
-		dimension: 1536,
+		provider: 'surrealml', // fn::embed() — configured in SurrealDB
+		dimension: 384,
 	},
 	consolidation: {
 		trigger: 'timer',

package/package.json

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

package/src/cli/commands/believe.ts

@@ -2,7 +2,7 @@ import { loadConfig } from '../../config.ts'
 import { connect, disconnect } from '../../db/client.ts'
 import { getLogger } from '../../logger.ts'
 import { believe } from '../../memory/write.ts'
-import { app, initCliCommand } from '../shared.ts'
+import { app, initCliCommand, printCliJson, resolveOutputModeOrExit } from '../shared.ts'
 
 const log = getLogger(['suemo', 'cli', 'believe'])
 
@@ -12,9 +12,17 @@ export const believeCmd = app.sub('believe')
 	.flags({
 		scope: { type: 'string', short: 's', description: 'Scope label' },
 		confidence: { type: 'number', description: 'Confidence 0.0–1.0', default: 1.0 },
+		json: { type: 'boolean', description: 'Output JSON result' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
 	})
 	.run(async ({ args, flags }) => {
-		await initCliCommand('believe', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('believe', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		const config = await loadConfig(process.cwd(), flags.config)
 		const db = await connect(config.surreal)
 		try {
@@ -28,9 +36,15 @@ export const believeCmd = app.sub('believe')
 				scope: flags.scope,
 				confidence: flags.confidence,
 			}, config)
-			const out: Record<string, unknown> = { id: node.id, valid_from: node.valid_from }
-			if (contradicted) out.contradicted = contradicted.id
-			console.log(JSON.stringify(out, null, 2))
+			if (outputMode === 'json') {
+				const out: Record<string, unknown> = { id: node.id, valid_from: node.valid_from }
+				if (contradicted) out.contradicted = contradicted.id
+				printCliJson(out, flags)
+			} else {
+				console.log(`Stored belief memory: ${node.id}`)
+				console.log(`  valid_from: ${node.valid_from}`)
+				if (contradicted) console.log(`  contradicted: ${contradicted.id}`)
+			}
 		} finally {
 			await disconnect()
 		}

package/src/cli/commands/consolidate.ts

@@ -2,7 +2,7 @@ import { consolidate } from '../../cognitive/consolidate.ts'
 import { loadConfig } from '../../config.ts'
 import { connect, disconnect } from '../../db/client.ts'
 import { getLogger } from '../../logger.ts'
-import { app, initCliCommand } from '../shared.ts'
+import { app, initCliCommand, printCliJson, resolveOutputModeOrExit } from '../shared.ts'
 
 const log = getLogger(['suemo', 'cli', 'consolidate'])
 
@@ -10,9 +10,17 @@ export const consolidateCmd = app.sub('consolidate')
 	.meta({ description: 'Manually trigger memory consolidation (NREM + REM)' })
 	.flags({
 		'nrem-only': { type: 'boolean', description: 'Run only NREM (compression) phase', default: false },
+		json: { type: 'boolean', description: 'Output full JSON' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
 	})
 	.run(async ({ flags }) => {
-		await initCliCommand('consolidate', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('consolidate', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running consolidate command', { nremOnly: flags['nrem-only'] })
 		const config = await loadConfig(process.cwd(), flags.config)
 		const db = await connect(config.surreal)
@@ -24,7 +32,14 @@ export const consolidateCmd = app.sub('consolidate')
 				llm: config.consolidation.llm,
 				embedding: config.embedding,
 			})
-			console.log(JSON.stringify(run, null, 2))
+			if (outputMode === 'json') {
+				printCliJson(run, flags)
+			} else {
+				console.log(
+					`Consolidation ${run.status}: phase=${run.phase} nodes_in=${run.nodes_in} nodes_out=${run.nodes_out}`,
+				)
+				if (run.error) console.log(`  error: ${run.error}`)
+			}
 		} finally {
 			await disconnect()
 		}

package/src/cli/commands/doctor.ts

@@ -3,7 +3,7 @@ import { loadConfig } from '../../config.ts'
 import { connect, disconnect } from '../../db/client.ts'
 import { checkCompatibility } from '../../db/preflight.ts'
 import { getLogger } from '../../logger.ts'
-import { app, initCliCommand } from '../shared.ts'
+import { app, initCliCommand, resolveOutputModeOrExit } from '../shared.ts'
 
 const log = getLogger(['suemo', 'cli', 'doctor'])
 
@@ -50,8 +50,19 @@ async function detectModelNames(db: Surreal): Promise<string[]> {
 
 const doctorEmbedCmd = doctor.sub('embed')
 	.meta({ description: 'Diagnose fn::embed() and show setup steps' })
+	.flags({
+		json: { type: 'boolean', description: 'Machine-readable output mode' },
+		'verbose-json': { type: 'boolean', description: 'Include embeddings in JSON output (implies --json)' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ flags }) => {
-		await initCliCommand('doctor embed', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('doctor embed', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 
 		const config = await loadConfig(process.cwd(), flags.config)
 		const endpoint = toCliEndpoint(config.surreal.url)
@@ -115,8 +126,19 @@ const doctorEmbedCmd = doctor.sub('embed')
 
 export const doctorCmd = doctor
 	.command(doctorEmbedCmd)
+	.flags({
+		json: { type: 'boolean', description: 'Machine-readable output mode' },
+		'verbose-json': { type: 'boolean', description: 'Include embeddings in JSON output (implies --json)' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ flags }) => {
-		await initCliCommand('doctor', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('doctor', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		console.log('Use one of:')
 		console.log('  suemo doctor embed')
 		console.log('\nRun `suemo doctor --help` for full details.')

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

@@ -4,7 +4,7 @@ import { loadConfig } from '../../config.ts'
 import { connect, disconnect } from '../../db/client.ts'
 import { getLogger } from '../../logger.ts'
 import type { MemoryNode, Relation } from '../../types.ts'
-import { app, initCliCommand } from '../shared.ts'
+import { app, initCliCommand, printCliJson, resolveOutputModeOrExit } from '../shared.ts'
 
 const log = getLogger(['suemo', 'cli', 'export-import'])
 
@@ -14,9 +14,17 @@ export const exportCmd = app.sub('export')
 	.flags({
 		scope: { type: 'string', short: 's', description: 'Filter by scope' },
 		all: { type: 'boolean', description: 'Include invalidated nodes' },
+		json: { type: 'boolean', description: 'Force JSONL-safe mode (stderr logs only)' },
+		pretty: { type: 'boolean', description: 'Human-readable output mode (default)' },
 	})
 	.run(async ({ flags }) => {
-		await initCliCommand('export', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('export', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running export command', {
 			hasScope: Boolean(flags.scope),
 			includeInvalidated: Boolean(flags.all),
@@ -52,8 +60,18 @@ export const exportCmd = app.sub('export')
 export const importCmd = app.sub('import')
 	.meta({ description: 'Import memories from a JSONL file' })
 	.args([{ name: 'file', type: 'string', required: true }])
+	.flags({
+		json: { type: 'boolean', description: 'Output JSON summary' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ args, flags }) => {
-		await initCliCommand('import', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('import', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running import command', { file: args.file })
 		const config = await loadConfig(process.cwd(), flags.config)
 		const db = await connect(config.surreal)
@@ -123,5 +141,9 @@ export const importCmd = app.sub('import')
 			rl.close()
 			await disconnect()
 		}
-		console.log(JSON.stringify({ imported, skipped, errors, lines: lineNum }, null, 2))
+		if (outputMode === 'json') {
+			printCliJson({ imported, skipped, errors, lines: lineNum }, flags)
+		} else {
+			console.log(`import done: imported=${imported} skipped=${skipped} errors=${errors} lines=${lineNum}`)
+		}
 	})

package/src/cli/commands/goal.ts

@@ -3,7 +3,7 @@ import { loadConfig } from '../../config.ts'
 import { connect, disconnect } from '../../db/client.ts'
 import { goalList, goalResolve, goalSet } from '../../goal.ts'
 import { getLogger } from '../../logger.ts'
-import { app, initCliCommand } from '../shared.ts'
+import { app, initCliCommand, printCliJson, resolveOutputModeOrExit } from '../shared.ts'
 
 const log = getLogger(['suemo', 'cli', 'goal'])
 
@@ -17,9 +17,17 @@ const setCmd = goal.sub('set')
 	.flags({
 		scope: { type: 'string', short: 's', description: 'Scope label' },
 		tags: { type: 'string', short: 't', description: 'Comma-separated tags' },
+		json: { type: 'boolean', description: 'Output JSON result' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
 	})
 	.run(async ({ args, flags }) => {
-		await initCliCommand('goal set', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('goal set', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running goal set command', {
 			hasScope: Boolean(flags.scope),
 			tagCount: flags.tags ? flags.tags.split(',').filter(Boolean).length : 0,
@@ -33,7 +41,12 @@ const setCmd = goal.sub('set')
 				...(flags.scope ? { scope: flags.scope } : {}),
 				tags: flags.tags ? flags.tags.split(',').map((t) => t.trim()) : [],
 			})
-			console.log(JSON.stringify({ id: node.id, content: node.content }, null, 2))
+			if (outputMode === 'json') {
+				printCliJson({ id: node.id, content: node.content }, flags)
+			} else {
+				console.log(`Created goal: ${node.id}`)
+				console.log(`  ${node.content}`)
+			}
 		} finally {
 			if (db) await disconnect()
 		}
@@ -45,9 +58,17 @@ const listCmd = goal.sub('list')
 	.flags({
 		scope: { type: 'string', short: 's', description: 'Filter by scope' },
 		resolved: { type: 'boolean', description: 'Include resolved goals', default: false },
+		json: { type: 'boolean', description: 'Output JSON result' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
 	})
 	.run(async ({ flags }) => {
-		await initCliCommand('goal list', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('goal list', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running goal list command', {
 			hasScope: Boolean(flags.scope),
 			includeResolved: Boolean(flags.resolved),
@@ -60,11 +81,19 @@ const listCmd = goal.sub('list')
 				...(flags.scope ? { scope: flags.scope } : {}),
 				includeResolved: flags.resolved,
 			})
-			for (const g of goals) {
-				const status = g.valid_until ? `resolved ${g.valid_until}` : 'active'
-				console.log(`[${status}] ${g.id}`)
-				console.log(`  ${g.content}`)
-				console.log()
+			if (outputMode === 'json') {
+				printCliJson(goals, flags)
+			} else {
+				if (goals.length === 0) {
+					console.log('No goals found.')
+					return
+				}
+				for (const g of goals) {
+					const status = g.valid_until ? `resolved ${g.valid_until}` : 'active'
+					console.log(`[${status}] ${g.id}`)
+					console.log(`  ${g.content}`)
+					console.log()
+				}
 			}
 		} finally {
 			if (db) await disconnect()
@@ -75,15 +104,29 @@ const listCmd = goal.sub('list')
 const resolveCmd = goal.sub('resolve')
 	.meta({ description: 'Mark a goal as resolved' })
 	.args([{ name: 'goalId', type: 'string', required: true }])
+	.flags({
+		json: { type: 'boolean', description: 'Output JSON result' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ args, flags }) => {
-		await initCliCommand('goal resolve', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('goal resolve', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running goal resolve command', { goalId: args.goalId })
 		const config = await loadConfig(process.cwd(), flags.config)
 		let db: Surreal | undefined
 		try {
 			db = await connect(config.surreal)
 			await goalResolve(db, args.goalId)
-			console.log(`✓ Goal ${args.goalId} resolved`)
+			if (outputMode === 'json') {
+				printCliJson({ ok: true, goalId: args.goalId }, flags)
+			} else {
+				console.log(`✓ Goal ${args.goalId} resolved`)
+			}
 		} finally {
 			if (db) await disconnect()
 		}

package/src/cli/commands/health.ts

@@ -3,7 +3,7 @@ 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'
-import { app, initCliCommand } from '../shared.ts'
+import { app, initCliCommand, printCliJson, resolveOutputModeOrExit } from '../shared.ts'
 
 const log = getLogger(['suemo', 'cli', 'health'])
 
@@ -12,15 +12,34 @@ const health = app.sub('health')
 
 const reportCmd = health.sub('report')
 	.meta({ description: 'Full health report (default)' })
+	.flags({
+		json: { type: 'boolean', description: 'Output full JSON' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ flags }) => {
-		await initCliCommand('health report', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('health report', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running health report command')
 		const config = await loadConfig(process.cwd(), flags.config)
 		let db: Surreal | undefined
 		try {
 			db = await connect(config.surreal)
 			const report = await healthReport(db)
-			console.log(JSON.stringify(report, null, 2))
+			if (outputMode === 'json') {
+				printCliJson(report, flags)
+			} else {
+				console.log(
+					`nodes: total=${report.nodes.total} active=${report.nodes.active} consolidated=${report.nodes.consolidated}`,
+				)
+				console.log(`relations: ${report.relations}`)
+				console.log(`goals_active: ${report.goals_active}  fsrs_due: ${report.fsrs_due}`)
+				console.log(`surreal: ${report.version_check.surreal_version}  surrealkv=${report.version_check.surrealkv}`)
+			}
 		} finally {
 			if (db) await disconnect()
 		}
@@ -28,15 +47,30 @@ const reportCmd = health.sub('report')
 
 const vitalsCmd = health.sub('vitals')
 	.meta({ description: 'Last 10 consolidation runs + node counts' })
+	.flags({
+		json: { type: 'boolean', description: 'Output full JSON' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ flags }) => {
-		await initCliCommand('health vitals', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('health vitals', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running health vitals command')
 		const config = await loadConfig(process.cwd(), flags.config)
 		let db: Surreal | undefined
 		try {
 			db = await connect(config.surreal)
 			const v = await vitals(db)
-			console.log(JSON.stringify(v, null, 2))
+			if (outputMode === 'json') {
+				printCliJson(v, flags)
+			} else {
+				console.log(`last10Runs: ${v.last10Runs.length}`)
+				console.log(`kinds: ${Object.keys(v.nodesByKind).length}  scopes: ${Object.keys(v.nodesByScope).length}`)
+			}
 		} finally {
 			if (db) await disconnect()
 		}
@@ -44,15 +78,30 @@ const vitalsCmd = health.sub('vitals')
 
 const statsCmd = health.sub('stats')
 	.meta({ description: 'Lightweight usage stats' })
+	.flags({
+		json: { type: 'boolean', description: 'Output full JSON' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ flags }) => {
-		await initCliCommand('health stats', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('health stats', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		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))
+			if (outputMode === 'json') {
+				printCliJson(s, flags)
+			} else {
+				console.log(`nodes: total=${s.totalNodes} active=${s.activeNodes} relations=${s.relations}`)
+				console.log(`writes=${s.totalWrites} queries=${s.totalQueries}`)
+			}
 		} finally {
 			if (db) await disconnect()
 		}
@@ -63,15 +112,34 @@ export const healthCmd = health
 	.command(vitalsCmd)
 	.command(statsCmd)
 	// Default: run the report when just `suemo health` is called
+	.flags({
+		json: { type: 'boolean', description: 'Output full JSON' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ flags }) => {
-		await initCliCommand('health', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('health', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		log.debug('Running default health command')
 		const config = await loadConfig(process.cwd(), flags.config)
 		let db: Surreal | undefined
 		try {
 			db = await connect(config.surreal)
 			const report = await healthReport(db)
-			console.log(JSON.stringify(report, null, 2))
+			if (outputMode === 'json') {
+				printCliJson(report, flags)
+			} else {
+				console.log(
+					`nodes: total=${report.nodes.total} active=${report.nodes.active} consolidated=${report.nodes.consolidated}`,
+				)
+				console.log(`relations: ${report.relations}`)
+				console.log(`goals_active: ${report.goals_active}  fsrs_due: ${report.fsrs_due}`)
+				console.log(`surreal: ${report.version_check.surreal_version}  surrealkv=${report.version_check.surrealkv}`)
+			}
 		} finally {
 			if (db) await disconnect()
 		}

package/src/cli/commands/init.ts

@@ -6,7 +6,7 @@ import { connect, disconnect } from '../../db/client.ts'
 import { checkCompatibility } from '../../db/preflight.ts'
 import { runSchema } from '../../db/schema.ts'
 import { getLogger } from '../../logger.ts'
-import { app, initCliCommand } from '../shared.ts'
+import { app, initCliCommand, resolveOutputModeOrExit } from '../shared.ts'
 
 import template from '../../config.template.ts' with { type: 'text' }
 
@@ -15,6 +15,8 @@ interface InitFlags {
 	config?: string | undefined
 	force?: boolean | undefined
 	yes?: boolean | undefined
+	json?: boolean | undefined
+	quiet?: boolean | undefined
 }
 
 const log = getLogger(['suemo', 'cli', 'init'])
@@ -118,9 +120,18 @@ const initConfigCmd = init.sub('config')
 	.meta({ description: 'Create/update ~/.suemo/suemo.ts config template' })
 	.flags({
 		force: { type: 'boolean', description: 'Overwrite existing config file' },
+		json: { type: 'boolean', description: 'Machine-readable output mode' },
+		'verbose-json': { type: 'boolean', description: 'Include embeddings in JSON output (implies --json)' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
 	})
 	.run(async ({ flags }) => {
-		await initCliCommand('init config', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('init config', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		writeConfig(Boolean(flags.force), configOutputPath(flags))
 	})
 
@@ -128,9 +139,18 @@ const initSchemaCmd = init.sub('schema')
 	.meta({ description: 'Apply database schema using current config' })
 	.flags({
 		yes: { type: 'boolean', short: 'y', description: 'Skip schema confirmation prompt' },
+		json: { type: 'boolean', description: 'Machine-readable output mode' },
+		'verbose-json': { type: 'boolean', description: 'Include embeddings in JSON output (implies --json)' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
 	})
 	.run(async ({ flags }) => {
-		await initCliCommand('init schema', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('init schema', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 
 		const confirmOptions: {
 			message: string
@@ -161,8 +181,19 @@ const initSchemaCmd = init.sub('schema')
 export const initCmd = init
 	.command(initConfigCmd)
 	.command(initSchemaCmd)
+	.flags({
+		json: { type: 'boolean', description: 'Machine-readable output mode' },
+		'verbose-json': { type: 'boolean', description: 'Include embeddings in JSON output (implies --json)' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
+	})
 	.run(async ({ flags }) => {
-		await initCliCommand('init', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('init', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 		console.log('Use one of:')
 		console.log('  suemo init config [--force]')
 		console.log('  suemo init schema [--yes]')

package/src/cli/commands/observe.ts

@@ -3,7 +3,7 @@ import { connect, disconnect } from '../../db/client.ts'
 import { getLogger } from '../../logger.ts'
 import { observe } from '../../memory/write.ts'
 import { MemoryKindSchema } from '../../types.ts'
-import { app, initCliCommand } from '../shared.ts'
+import { app, initCliCommand, printCliJson, resolveOutputModeOrExit } from '../shared.ts'
 
 const log = getLogger(['suemo', 'cli', 'observe'])
 
@@ -17,9 +17,17 @@ export const observeCmd = app.sub('observe')
 		confidence: { type: 'number', description: 'Confidence 0.0–1.0', default: 1.0 },
 		source: { type: 'string', description: 'Source label' },
 		session: { type: 'string', description: 'Session ID (attach to open episode)' },
+		json: { type: 'boolean', description: 'Output JSON result' },
+		pretty: { type: 'boolean', description: 'Human-readable output (default)' },
 	})
 	.run(async ({ args, flags }) => {
-		await initCliCommand('observe', { debug: flags.debug, config: flags.config })
+		const outputMode = resolveOutputModeOrExit(flags)
+		await initCliCommand('observe', {
+			debug: flags.debug,
+			config: flags.config,
+			json: outputMode === 'json',
+			quiet: flags.quiet,
+		})
 
 		const kindParse = MemoryKindSchema.safeParse(flags.kind)
 		if (!kindParse.success) {
@@ -46,7 +54,12 @@ export const observeCmd = app.sub('observe')
 				source: flags.source,
 				sessionId: flags.session,
 			}, config)
-			console.log(JSON.stringify({ id: node.id, kind: node.kind, valid_from: node.valid_from }, null, 2))
+			if (outputMode === 'json') {
+				printCliJson({ id: node.id, kind: node.kind, valid_from: node.valid_from }, flags)
+			} else {
+				console.log(`Stored ${node.kind} memory: ${node.id}`)
+				console.log(`  valid_from: ${node.valid_from}`)
+			}
 		} finally {
 			await disconnect()
 		}