@pcircle/memesh 4.6.2 → 4.7.2

package/dist/storage/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/storage/schema.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,UAAU,gwJAkGtB,CAAC;AAGF,eAAO,MAAM,OAAO,ieAUnB,CAAC;AAYF,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAO/D;AASD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAsC9D;AAYD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CA6B9D;AAeD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAgC5D;AAQD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOxD;AAGD,eAAO,MAAM,0BAA0B,QAAsB,CAAC;AA+B9D,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D,GACA,OAAO,CAoET;AAWD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAG1C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAuBzC,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAsDxD;AAkBD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAO9D"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/storage/schema.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,UAAU,gwJAkGtB,CAAC;AAGF,eAAO,MAAM,OAAO,ieAUnB,CAAC;AAYF,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAO/D;AASD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAwD9D;AAYD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CA6B9D;AAeD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAgC5D;AAQD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOxD;AAGD,eAAO,MAAM,0BAA0B,QAAsB,CAAC;AA+B9D,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D,GACA,OAAO,CAoET;AAWD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAG1C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAuBzC,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAsDxD;AAkBD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAO9D"}

package/dist/storage/schema.js

@@ -122,28 +122,24 @@ export function safeAlter(db, sql) {
 }
 export function migrateEntitiesSchema(db) {
     const entityColumns = new Set(db.prepare("PRAGMA table_info(entities)").all().map((c) => c.name));
-    if (!entityColumns.has('status')) {
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN status TEXT NOT NULL DEFAULT 'active'");
-        db.exec("CREATE INDEX IF NOT EXISTS idx_entities_status ON entities(status)");
-    }
-    if (!entityColumns.has('access_count')) {
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN access_count INTEGER DEFAULT 0");
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN last_accessed_at TIMESTAMP");
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN confidence REAL DEFAULT 1.0");
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN valid_from TIMESTAMP");
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN valid_until TIMESTAMP");
-    }
-    if (!entityColumns.has('namespace')) {
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN namespace TEXT DEFAULT 'personal'");
-        db.exec("CREATE INDEX IF NOT EXISTS idx_entities_namespace ON entities(namespace)");
-    }
-    if (!entityColumns.has('recall_hits')) {
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN recall_hits INTEGER DEFAULT 0");
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN recall_misses INTEGER DEFAULT 0");
-    }
-    if (!entityColumns.has('title')) {
-        safeAlter(db, "ALTER TABLE entities ADD COLUMN title TEXT");
-    }
+    const addColumn = (column, sql) => {
+        if (entityColumns.has(column))
+            return;
+        safeAlter(db, sql);
+        entityColumns.add(column);
+    };
+    addColumn('status', "ALTER TABLE entities ADD COLUMN status TEXT NOT NULL DEFAULT 'active'");
+    addColumn('access_count', "ALTER TABLE entities ADD COLUMN access_count INTEGER DEFAULT 0");
+    addColumn('last_accessed_at', "ALTER TABLE entities ADD COLUMN last_accessed_at TIMESTAMP");
+    addColumn('confidence', "ALTER TABLE entities ADD COLUMN confidence REAL DEFAULT 1.0");
+    addColumn('valid_from', "ALTER TABLE entities ADD COLUMN valid_from TIMESTAMP");
+    addColumn('valid_until', "ALTER TABLE entities ADD COLUMN valid_until TIMESTAMP");
+    addColumn('namespace', "ALTER TABLE entities ADD COLUMN namespace TEXT DEFAULT 'personal'");
+    addColumn('recall_hits', "ALTER TABLE entities ADD COLUMN recall_hits INTEGER DEFAULT 0");
+    addColumn('recall_misses', "ALTER TABLE entities ADD COLUMN recall_misses INTEGER DEFAULT 0");
+    addColumn('title', "ALTER TABLE entities ADD COLUMN title TEXT");
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_entities_status ON entities(status);
+     CREATE INDEX IF NOT EXISTS idx_entities_namespace ON entities(namespace);`);
 }
 export function ensureTagsUniqueIndex(db) {
     try {

package/dist/storage/schema.js.map

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

package/dist/storage/vector-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../../src/storage/vector-index.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAK1D"}
+{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../../src/storage/vector-index.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAyBlD,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAS1D"}

package/dist/storage/vector-index.js

@@ -1,7 +1,13 @@
 export function hasVectorIndex(db) {
-    const row = db
-        .prepare("SELECT 1 AS present FROM sqlite_master WHERE name = 'entities_vec'")
-        .get();
-    return row !== undefined;
+    try {
+        db.prepare('SELECT 1 FROM entities_vec LIMIT 1').get();
+        return true;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (/no such module: vec0|no such table/i.test(message))
+            return false;
+        throw err;
+    }
 }
 //# sourceMappingURL=vector-index.js.map

package/dist/storage/vector-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"vector-index.js","sourceRoot":"","sources":["../../src/storage/vector-index.ts"],"names":[],"mappings":"AAoCA,MAAM,UAAU,cAAc,CAAC,EAAkB;IAC/C,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,oEAAoE,CAAC;SAC7E,GAAG,EAAE,CAAC;IACT,OAAO,GAAG,KAAK,SAAS,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"vector-index.js","sourceRoot":"","sources":["../../src/storage/vector-index.ts"],"names":[],"mappings":"AAqDA,MAAM,UAAU,cAAc,CAAC,EAAkB;IAC/C,IAAI,CAAC;QACH,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACtE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/transports/cli/cli.js

@@ -17,14 +17,56 @@ import { installHooks } from '../../core/install-hooks.js';
 import { getTaskState, setTaskState } from '../../core/task-state-store.js';
 import { TASK_STATE_FIELDS, taskStateLines } from '../../core/task-state.js';
 async function withDatabase(fn) {
-    openDatabase();
+    try {
+        openDatabase();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: memesh cannot open its database.`);
+        console.error(`       ${message}`);
+        console.error(`       Run \`memesh doctor\` — it names the file, the likely cause and the way back.`);
+        process.exit(1);
+    }
     try {
         return await fn();
     }
     finally {
+        await flushPendingEmbeddings();
         closeDatabase();
     }
 }
+function unitFraction(flag) {
+    return (value) => {
+        const parsed = Number(value);
+        if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+            console.error(`Error: ${flag} needs a number between 0 and 1, not "${value}".`);
+            process.exit(1);
+        }
+        return parsed;
+    };
+}
+function nonEmpty(flag) {
+    return (value) => {
+        if (value.trim() === '') {
+            console.error(`Error: ${flag} needs some text. An empty value is not a selector.`);
+            process.exit(1);
+        }
+        return value;
+    };
+}
+function proposalId(raw) {
+    return wholeNumber('<id>')(raw);
+}
+function wholeNumber(flag, min = 1) {
+    return (value) => {
+        const parsed = Number(value);
+        if (!Number.isInteger(parsed) || parsed < min) {
+            console.error(`Error: ${flag} needs a whole number of ${min} or more, not "${value}".`);
+            process.exit(1);
+        }
+        return parsed;
+    };
+}
 function requireOneOf(value, allowed, flag) {
     if (value === undefined || allowed.includes(value))
         return;
@@ -106,6 +148,10 @@ program
             '  memesh remember "Use OAuth 2.0 with PKCE"');
         process.exit(1);
     }
+    if (opts.obs?.some((o) => o.trim() === '')) {
+        console.error('Error: --obs needs some text. An empty or whitespace-only observation is not a memory.');
+        process.exit(1);
+    }
     const relations = [
         ...(opts.supersedes ?? []).map(to => ({ to, type: 'supersedes' })),
         ...(opts.contradicts ?? []).map(to => ({ to, type: 'contradicts' })),
@@ -143,7 +189,6 @@ program
         }
         if (result.relationErrors?.length)
             process.exitCode = 1;
-        await flushPendingEmbeddings();
     });
 });
 program
@@ -151,7 +196,7 @@ program
     .description('Search stored knowledge')
     .argument('[query]', 'Search query')
     .option('--tag <tag>', 'Filter by tag')
-    .option('--limit <n>', 'Max results', '20')
+    .option('--limit <n>', 'Max results', wholeNumber('--limit'), 20)
     .option('--include-archived', 'Include archived entities')
     .option('--namespace <namespace>', 'Filter by namespace: personal, team, or global')
     .option('--cross-project', 'Search across all project tags (ignores --tag filter)')
@@ -162,7 +207,7 @@ program
         const { entities, conflicts, retrieval } = await recallWithConflicts({
             query: query || undefined,
             tag: opts.tag,
-            limit: parseInt(opts.limit),
+            limit: opts.limit,
             include_archived: opts.includeArchived,
             namespace: opts.namespace,
             cross_project: opts.crossProject,
@@ -171,7 +216,15 @@ program
             console.log(JSON.stringify(conflicts.length > 0 ? { entities, retrieval, conflicts } : { entities, retrieval }));
         }
         else if (entities.length === 0) {
-            console.log('No results found.');
+            if (query && retrieval.degraded) {
+                console.log('No results found. Semantic search is configured but could not run for this query (provider or index issue) — this was keyword-only. Run `memesh doctor` to check.');
+            }
+            else if (query && retrieval.mode === 'fts') {
+                console.log('No results found. This was a keyword-only search — no semantic search is configured. See `memesh doctor` for Smart Mode.');
+            }
+            else {
+                console.log('No results found.');
+            }
         }
         else {
             const allSemantic = query && entities.every((e) => e.match?.source === 'semantic');
@@ -216,7 +269,7 @@ program
     .command('forget')
     .description('Archive an entity or remove an observation (soft-delete, recoverable)')
     .requiredOption('--name <name>', 'Entity name')
-    .option('--observation <text>', 'Remove specific observation only')
+    .option('--observation <text>', 'Remove specific observation only', nonEmpty('--observation'))
     .option('--json', 'Output as JSON')
     .option('--confirm', '[deprecated, no-op] forget is a soft archive — no confirmation needed')
     .action(async (opts) => {
@@ -234,7 +287,7 @@ program
         else if (result.observation_removed) {
             console.log(`✂️  Removed observation (${result.remaining_observations} remaining)`);
         }
-        else if (opts.observation && result.entity_found) {
+        else if (opts.observation !== undefined && result.entity_found) {
             console.log(`Entity "${opts.name}" has no observation matching that text (${result.remaining_observations} observation(s) present).`);
             console.log(`See them with: memesh recall "${opts.name}" --json`);
             process.exitCode = 1;
@@ -316,7 +369,7 @@ program
     .description('Export memories as JSON. Defaults to stdout (pipe-friendly); use `-o <file>` to write directly.')
     .option('--tag <tag>', 'Export only entities with this tag')
     .option('--namespace <ns>', 'Export only from this namespace (personal, team, global)')
-    .option('--limit <n>', 'Max entities to export', '1000')
+    .option('--limit <n>', 'Max entities to export', wholeNumber('--limit'), 1000)
     .option('-o, --out <file>', 'Write JSON to <file> instead of stdout. Parent directory must exist.')
     .action(async (opts) => {
     requireOneOf(opts.namespace, NAMESPACES, '--namespace');
@@ -324,7 +377,7 @@ program
         const result = exportMemories({
             tag: opts.tag,
             namespace: opts.namespace,
-            limit: parseInt(opts.limit),
+            limit: opts.limit,
         });
         const json = JSON.stringify(result, null, 2);
         if (opts.out) {
@@ -340,6 +393,10 @@ program
         else {
             console.log(json);
         }
+        if (result.truncated) {
+            process.stderr.write(`⚠️  This is NOT the whole graph — ${result.entity_count} entities is the --limit, and there are more.\n`
+                + `   For a full backup, raise it: memesh export --limit 100000${opts.out ? ` -o ${opts.out}` : ''}\n`);
+        }
     });
 });
 program
@@ -394,7 +451,13 @@ program
             console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
             process.exit(1);
         }
-        console.log(`Imported: ${result.imported}, Skipped: ${result.skipped}, Appended: ${result.appended}`);
+        const overwriteNote = result.overwritten > 0 ? ` (${result.overwritten} overwritten)` : '';
+        console.log(`Imported: ${result.imported}${overwriteNote}, Skipped: ${result.skipped}, Appended: ${result.appended}`);
+        if (result.skipped_relations.length > 0) {
+            console.error(`Note: ${result.skipped_relations.length} relation(s) not restored — the target is not in this bundle:\n  `
+                + `${result.skipped_relations.join('\n  ')}`);
+            console.error(`       Export those entities too (widen --limit, or drop --tag/--namespace) to keep the links.`);
+        }
         if (result.errors.length > 0) {
             console.error(`Errors:\n  ${result.errors.join('\n  ')}`);
             process.exitCode = 1;
@@ -452,6 +515,7 @@ program
 const WHY_ABSTENTION_TEXT = {
     git_unavailable: 'git is not installed or not on PATH — commit attribution unavailable.',
     not_a_git_repo: 'Not inside a git repository — commit attribution unavailable.',
+    file_not_found: 'No such file.',
     file_not_tracked: 'File is not tracked by git — commit attribution unavailable.',
     history_unreadable: "git could not read this file's history (too much output, too slow, or the repository has no commits yet) — nothing is listed because the question went unanswered, not because no commit touched the file.",
     no_commits_supplied: 'No commit hashes were supplied — only the file-tag half of this answer ran.',
@@ -464,21 +528,15 @@ program
     .command('why')
     .description('Explain a file: commits memesh remembers touching it, their sessions, and related memories')
     .argument('<file>', 'File path (relative to the current directory or absolute)')
-    .option('--line <n>', 'Attribute one line via git blame instead of file history')
-    .option('--limit <n>', 'Max commits to inspect', '10')
+    .option('--line <n>', 'Attribute one line via git blame instead of file history', wholeNumber('--line'))
+    .option('--limit <n>', 'Max commits to inspect', wholeNumber('--limit'), 10)
     .option('--json', 'Output as JSON')
     .action(async (file, opts) => {
     await withDatabase(async () => {
         const { resolveFileCommits, explainCommits } = await import('../../core/why.js');
         const cwd = process.cwd();
-        const limit = parseInt(opts.limit, 10);
-        const line = opts.line !== undefined ? parseInt(opts.line, 10) : undefined;
-        for (const [flag, value] of [['--limit', limit], ['--line', line]]) {
-            if (value !== undefined && (!Number.isInteger(value) || value < 1)) {
-                console.error(`Error: ${flag} needs a whole number of 1 or more.`);
-                process.exit(1);
-            }
-        }
+        const limit = opts.limit;
+        const line = opts.line;
         const resolved = resolveFileCommits(cwd, file, { line, limit });
         const result = explainCommits(getDatabase(), {
             file,
@@ -487,6 +545,8 @@ program
             limit,
             abstentions: resolved.abstention ? [resolved.abstention] : [],
         });
+        if (result.abstentions.includes('file_not_found'))
+            process.exitCode = 1;
         if (opts.json) {
             console.log(JSON.stringify(result, null, 2));
             return;
@@ -631,7 +691,7 @@ program
     .option('--done <text>', 'What was just finished')
     .option('--json', 'Output as JSON')
     .action(async (opts) => {
-    await withDatabase(() => {
+    await withDatabase(async () => {
         const patch = {};
         for (const field of TASK_STATE_FIELDS) {
             if (opts[field] !== undefined)
@@ -709,6 +769,8 @@ const KEY_VALIDATORS = {
     },
     'embedder.provider': (v) => ['openai', 'ollama'].includes(v) ? null : `must be one of: openai, ollama`,
     'autoUpdate': (v) => ['off', 'patch', 'minor', 'major'].includes(v) ? null : `must be one of: off, patch, minor, major`,
+    'autoCapture': (v) => ['true', 'false', '1', '0'].includes(v) ? null : `must be one of: true, false, 1, 0`,
+    'transcriptMining': (v) => ['true', 'false', '1', '0'].includes(v) ? null : `must be one of: true, false, 1, 0`,
     'llmFallbacks': (v) => {
         let parsed;
         try {
@@ -813,8 +875,9 @@ configCmd
         }
     }
     let coerced = value;
-    if (canonical === 'sessionLimit')
-        coerced = parseInt(value, 10);
+    if (canonical === 'sessionLimit') {
+        coerced = wholeNumber('sessionLimit')(value);
+    }
     if (canonical === 'llmFallbacks')
         coerced = JSON.parse(value);
     if (canonical === 'autoCapture') {
@@ -898,13 +961,13 @@ program
 program
     .command('serve')
     .description('Start the HTTP API server and web dashboard')
-    .option('--port <port>', 'Port number', '3737')
+    .option('--port <port>', 'Port number', wholeNumber('--port', 0), 3737)
     .option('--host <host>', 'Host to bind', '127.0.0.1')
     .option('--allow-remote', 'Permit binding to a non-loopback host. Pair it with --host; on a non-loopback bind a bearer token is generated and REQUIRED for every /v1 request, and the startup output says where it lives. On the default loopback host this flag changes nothing.')
     .action(async (opts) => {
     const { startServer } = await import('../http/server.js');
     try {
-        startServer(opts.host, parseInt(opts.port, 10), { allowRemote: opts.allowRemote, autoUpdateCheck: true });
+        startServer(opts.host, opts.port, { allowRemote: opts.allowRemote, autoUpdateCheck: true });
     }
     catch (err) {
         console.error(`MeMesh: ${err instanceof Error ? err.message : String(err)}`);
@@ -917,7 +980,7 @@ program
     .action(async () => {
     const { getCurrentInstallChannel, getInstallChannelSupport } = await import('../../core/install-channel.js');
     const install = getCurrentInstallChannel({ packageRoot });
-    const installSupport = getInstallChannelSupport(install);
+    const installSupport = getInstallChannelSupport(install, packageRoot);
     if (!installSupport.canSelfUpdate) {
         console.error(`❌ memesh update does not support this install method (${installSupport.label}).`);
         console.error(`   ${installSupport.guidance}`);
@@ -998,16 +1061,10 @@ program
 program
     .command('telemetry')
     .description('Show LLM call telemetry (per-flow scorecard for the last N days)')
-    .option('--window <days>', 'Look-back window in days (default 30)', (v) => parseInt(v, 10), 30)
-    .option('--prune <days>', 'Delete rows older than N days BEFORE rendering (closes v4.2.0 retention gap)', (v) => parseInt(v, 10))
+    .option('--window <days>', 'Look-back window in days (default 30)', wholeNumber('--window'), 30)
+    .option('--prune <days>', 'Delete rows older than N days BEFORE rendering (closes v4.2.0 retention gap)', wholeNumber('--prune', 0))
     .option('--json', 'Output as JSON')
     .action(async (opts) => {
-    for (const [flag, value] of [['--window', opts.window], ['--prune', opts.prune]]) {
-        if (value !== undefined && !Number.isFinite(value)) {
-            console.error(`Error: ${flag} needs a number of days.`);
-            process.exit(1);
-        }
-    }
     await withDatabase(async () => {
         const { summariseTelemetry, pruneTelemetry } = await import('../../core/llm-telemetry.js');
         let pruneResult = null;
@@ -1074,12 +1131,12 @@ kgCmd
     .description('Propose / apply heuristic relations to connect orphan entities (no LLM)')
     .option('--project <name>', 'Restrict to one project')
     .option('--dry-run', 'Show proposals without writing (default off — use to preview)')
-    .option('--max-per-source <n>', 'Max edges per orphan (default 3)', (v) => parseInt(v, 10), 3)
-    .option('--min-shared-tags <n>', 'Min shared topical tags to gate co-occurrence rule (default 2)', (v) => parseInt(v, 10), 2)
+    .option('--max-per-source <n>', 'Max edges per orphan (default 3)', wholeNumber('--max-per-source'), 3)
+    .option('--min-shared-tags <n>', 'Min shared topical tags to gate co-occurrence rule (default 2)', wholeNumber('--min-shared-tags'), 2)
     .option('--include-archived', 'Also process archived entities')
     .option('--session-cooccurrence', 'Rule 3: link high-signal orphans co-created in the same session')
     .option('--name-tokens', 'Rule 4: link orphans sharing ≥3 name content tokens (or Jaccard ≥ 0.50)')
-    .option('--min-jaccard <n>', 'Jaccard threshold for name similarity (default 0.50)', parseFloat)
+    .option('--min-jaccard <n>', 'Jaccard threshold for name similarity (default 0.50)', unitFraction('--min-jaccard'))
     .option('--all-rules', 'Enable all heuristic rules (Rules 1–5)')
     .option('--no-evidence-links', 'Disable Rule 5: evidence → work-item links via shared session id (on by default — these edges feed the graph\'s evidence badges)')
     .option('--reset-idempotency', 'Clear the persistent "already-attempted" orphan cache before running (use after schema changes or to reconsider every orphan)')
@@ -1324,12 +1381,12 @@ dreamCmd
     .description('Run a dream pass — propose digests for clusters of compactable entities')
     .option('--project <name>', 'Restrict to one project')
     .option('--dry-run', 'Compute proposals without writing to dream_proposals')
-    .option('--max-llm-calls <n>', 'Hard cap on LLM calls (default 100)', (v) => parseInt(v, 10))
-    .option('--window-days <n>', 'Look-back window in days (default 56 = 8 weeks)', (v) => parseInt(v, 10))
+    .option('--max-llm-calls <n>', 'Hard cap on LLM calls (default 100)', wholeNumber('--max-llm-calls'))
+    .option('--window-days <n>', 'Look-back window in days (default 56 = 8 weeks)', wholeNumber('--window-days'))
     .option('--validate', 'Run a second LLM pass to cross-check each digest against its sources (doubles LLM calls per proposal; surfaces under flow=digest_validator in `memesh telemetry`)')
     .option('--from-transcripts', 'EXPERIMENTAL: mine Claude Code session transcripts for this project (decisions/lessons/facts hidden in the conversation) and STAGE them as proposals for `dream accept`, instead of clustering existing entities. Scoped to the current project only — --project does not apply here. With --dry-run, lists sessions and conversation-turn counts without calling an LLM.')
     .option('--if-due', 'For a scheduler (cron/launchd): only mine if `transcriptMining` is enabled in config AND at least --min-interval-hours have passed since this project was last mined; otherwise exit 0 doing nothing. Lets one frequently-firing entry self-throttle. Only meaningful with --from-transcripts.')
-    .option('--min-interval-hours <n>', 'With --if-due: minimum hours between mined runs for this project (default 24).', (v) => parseInt(v, 10))
+    .option('--min-interval-hours <n>', 'With --if-due: minimum hours between mined runs for this project (default 24).', wholeNumber('--min-interval-hours'))
     .action(async (opts) => {
     if (opts.fromTranscripts) {
         const windowDays = typeof opts.windowDays === 'number' && !Number.isNaN(opts.windowDays) ? opts.windowDays : 3;
@@ -1406,6 +1463,10 @@ dreamCmd
                 console.log(`  LLM call failures:   ${result.llmFailures} (sessions not mined — retry when the provider is reachable)`);
             if (result.parseFailures > 0)
                 console.log(`  unparsable replies:  ${result.parseFailures} (chunk reply not valid JSON — likely truncated; those candidates were lost, retry)`);
+            if (result.cappedTurns > 0) {
+                console.log(`  per-turn cap: ${result.cappedTurns} turn(s) were analysed only in part `
+                    + `(the first 4,000 characters); the rest of each was not sent`);
+            }
             if (result.truncatedTurns > 0) {
                 console.log(`  size-cap truncation: ${result.truncatedTurns} conversation turn(s) beyond the cap were NOT analysed`);
                 for (const t of result.truncatedSessions) {
@@ -1477,9 +1538,9 @@ dreamCmd
     .description('Run pattern detector — surface emerging patterns/conventions/repeated mistakes per project (Phase 3)')
     .option('--project <name>', 'Restrict to one project (default: all projects)')
     .option('--dry-run', 'Compute proposals without writing to dream_proposals')
-    .option('--max-llm-calls <n>', 'Hard cap on LLM calls (default 10)', (v) => parseInt(v, 10))
-    .option('--window-days <n>', 'Look-back window in days (default 30)', (v) => parseInt(v, 10))
-    .option('--min-signal <n>', 'Minimum signal_score to include in scan (default 0.3)', (v) => parseFloat(v))
+    .option('--max-llm-calls <n>', 'Hard cap on LLM calls (default 10)', wholeNumber('--max-llm-calls'))
+    .option('--window-days <n>', 'Look-back window in days (default 30)', wholeNumber('--window-days'))
+    .option('--min-signal <n>', 'Minimum signal_score to include in scan (default 0.3)', unitFraction('--min-signal'))
     .action(async (opts) => {
     await withDatabase(async () => {
         const { runPatternDetector } = await import('../../core/dreamer.js');
@@ -1551,7 +1612,7 @@ dreamCmd
 dreamCmd
     .command('conflicts')
     .description('Judge semantically-close memory pairs for contradiction / supersession / duplication (LLM) and stage relation proposals for review')
-    .option('--max-pairs <n>', 'Judge at most N of the tightest candidate pairs this run (default 20)', (v) => parseInt(v, 10))
+    .option('--max-pairs <n>', 'Judge at most N of the tightest candidate pairs this run (default 20)', wholeNumber('--max-pairs'))
     .option('--dry-run', 'Show how many candidates are queued without calling an LLM or writing anything')
     .action(async (opts) => {
     await withDatabase(async () => {
@@ -1599,7 +1660,7 @@ dreamCmd
     await withDatabase(async () => {
         const { getProposalDetail } = await import('../../core/dreamer.js');
         const { getDatabase } = await import('../../db.js');
-        const detail = getProposalDetail(getDatabase(), parseInt(id, 10));
+        const detail = getProposalDetail(getDatabase(), proposalId(id));
         if (!detail) {
             console.error(`proposal #${id} not found`);
             console.error('See ids with: memesh dream list');
@@ -1660,14 +1721,13 @@ dreamCmd
         const kg = new KnowledgeGraph(getDatabase());
         let result;
         try {
-            result = applyProposal(getDatabase(), parseInt(id, 10), kg);
+            result = applyProposal(getDatabase(), proposalId(id), kg);
         }
         catch (err) {
             console.error(err instanceof Error ? err.message : String(err));
             console.error('See pending ids with: memesh dream list');
             process.exit(1);
         }
-        await flushPendingEmbeddings();
         console.log(`Applied proposal #${result.proposalId}`);
         console.log(`  digest entity: ${result.digestEntityName}`);
         console.log(`  sources archived: ${result.sourcesArchived}`);
@@ -1682,7 +1742,7 @@ dreamCmd
         const { rejectProposal } = await import('../../core/dreamer.js');
         const { getDatabase } = await import('../../db.js');
         try {
-            rejectProposal(getDatabase(), parseInt(id, 10), opts.reason);
+            rejectProposal(getDatabase(), proposalId(id), opts.reason);
         }
         catch (err) {
             console.error(err instanceof Error ? err.message : String(err));
@@ -1716,6 +1776,15 @@ program
             console.log('Hooks are active. Verify with: memesh doctor');
             console.log('');
             console.log('If you really want a second copy in ~/.claude/settings.json on top of the plugin, re-run with --force-over-plugin. (Not recommended — every session-start / Stop / PreToolUse event will fire memesh\'s hooks twice.)');
+            if (result.citationRule.action === 'foreign-file') {
+                console.log('');
+                console.log(`WARNING: the citation contract was NOT installed — a file memesh did not write already exists at ${result.citationRule.path}.`);
+                console.log('  memesh will not overwrite it. Move or rename that file and re-run, or add the contract to it by hand.');
+                console.log('  Until then, memesh cannot tell whether the memories it injects are ever used.');
+            }
+            else if (result.citationRule.action !== 'unchanged') {
+                console.log(`Citation contract ${result.citationRule.action}: ${result.citationRule.path}`);
+            }
             return;
         }
         console.log(`${opts.dryRun ? '[dry-run] ' : ''}Settings: ${result.settingsPath}`);
@@ -1725,6 +1794,18 @@ program
         }
         if (result.backupPath)
             console.log(`Backup: ${result.backupPath}`);
+        if (!opts.dryRun && (result.added > 0 || result.skipped > 0)) {
+            console.log(`Marker: ${result.markerPath}`);
+        }
+        if (result.citationRule.action === 'foreign-file') {
+            console.log('');
+            console.log(`WARNING: the citation contract was NOT installed — a file memesh did not write already exists at ${result.citationRule.path}.`);
+            console.log('  memesh will not overwrite it. Move or rename that file and re-run, or add the contract to it by hand.');
+            console.log('  Until then, memesh cannot tell whether the memories it injects are ever used.');
+        }
+        else if (result.citationRule.action !== 'unchanged') {
+            console.log(`Citation contract ${result.citationRule.action}: ${result.citationRule.path}`);
+        }
         if (result.conflicts.length > 0) {
             console.log('');
             console.log('Note: memesh hooks now coexist with the following pre-existing entries:');
@@ -1990,10 +2071,11 @@ program
     .description('Show MeMesh status and capabilities')
     .option('--cached', 'Use cached update info only (skip fresh npm lookup)')
     .action(async (opts) => {
+    await withDatabase(() => { });
     const caps = detectCapabilities();
     const { getCurrentInstallChannel, getInstallChannelSupport } = await import('../../core/install-channel.js');
     const install = getCurrentInstallChannel({ packageRoot });
-    const installSupport = getInstallChannelSupport(install);
+    const installSupport = getInstallChannelSupport(install, packageRoot);
     const { getUpdateCheck, formatUpdateCheckStatus } = await import('../../core/version-check.js');
     const update = await getUpdateCheck(pkg.version, { preferFresh: !opts.cached });
     console.log(`MeMesh v${pkg.version}`);