renor-engine 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/README.md +27 -2
  2. package/THIRD-PARTY-NOTICES +2661 -0
  3. package/dist/BUILD.json +3 -3
  4. package/dist/cli.js +1656 -490
  5. package/package.json +16 -80
  6. package/dist/.tsbuildinfo +0 -1
  7. package/dist/api/apiAuth.js +0 -43
  8. package/dist/api/server.js +0 -174
  9. package/dist/buildIdentity.js +0 -149
  10. package/dist/callPhases.js +0 -82
  11. package/dist/cli-extractors.js +0 -46
  12. package/dist/config.js +0 -65
  13. package/dist/context/composer.js +0 -320
  14. package/dist/context/readHonesty.js +0 -478
  15. package/dist/context/rowStore.js +0 -238
  16. package/dist/conversation/formatter.js +0 -81
  17. package/dist/conversation/parser.js +0 -193
  18. package/dist/conversation/types.js +0 -2
  19. package/dist/conversation/writer.js +0 -42
  20. package/dist/db/client.js +0 -149
  21. package/dist/db/handoffTable.js +0 -31
  22. package/dist/db/indexSalvage.js +0 -101
  23. package/dist/db/migrations.js +0 -670
  24. package/dist/db/readCache.js +0 -109
  25. package/dist/db/schema.js +0 -5
  26. package/dist/db/sqlite.js +0 -396
  27. package/dist/db/statements.js +0 -89
  28. package/dist/digests/digestCache.js +0 -146
  29. package/dist/digests/digests.js +0 -597
  30. package/dist/digests/worker.js +0 -350
  31. package/dist/embeddings/caching.js +0 -337
  32. package/dist/embeddings/coalescing.js +0 -177
  33. package/dist/embeddings/interactive.js +0 -103
  34. package/dist/embeddings/local.js +0 -70
  35. package/dist/embeddings/openai.js +0 -106
  36. package/dist/embeddings/rebuild.js +0 -166
  37. package/dist/embeddings/simdScan.js +0 -260
  38. package/dist/embeddings/space.js +0 -21
  39. package/dist/embeddings/types.js +0 -14
  40. package/dist/embeddings/vectorIndex.js +0 -674
  41. package/dist/embeddings/vertex.js +0 -334
  42. package/dist/eval/artifacts.js +0 -42
  43. package/dist/eval/cacheReport.js +0 -146
  44. package/dist/eval/comparison.js +0 -182
  45. package/dist/eval/context700-candidate.js +0 -145
  46. package/dist/eval/evalCache.js +0 -568
  47. package/dist/eval/hashEmbedding.js +0 -35
  48. package/dist/eval/indexSnapshots.js +0 -548
  49. package/dist/eval/longmemeval.js +0 -56
  50. package/dist/eval/metrics.js +0 -181
  51. package/dist/eval/pageDump.js +0 -67
  52. package/dist/eval/renorbenchBaseline.js +0 -486
  53. package/dist/eval/renorbenchDocuments.js +0 -134
  54. package/dist/eval/renorbenchProduct.js +0 -182
  55. package/dist/eval/runLedger.js +0 -279
  56. package/dist/eval/runManifest.js +0 -485
  57. package/dist/eval/scoring.js +0 -197
  58. package/dist/eval/textTokens.js +0 -17
  59. package/dist/evidence/attach.js +0 -264
  60. package/dist/evidence/background.js +0 -147
  61. package/dist/evidence/evidenceCache.js +0 -182
  62. package/dist/evidence/gate.js +0 -37
  63. package/dist/evidence/keyPool.js +0 -85
  64. package/dist/evidence/ollamaChat.js +0 -84
  65. package/dist/evidence/optin.js +0 -165
  66. package/dist/evidence/options.js +0 -151
  67. package/dist/evidence/secondPass.js +0 -294
  68. package/dist/extraction/classifyCapture.js +0 -34
  69. package/dist/extraction/decision-model.js +0 -174
  70. package/dist/extraction/eventExtractor.js +0 -113
  71. package/dist/extraction/extractionClient.js +0 -122
  72. package/dist/extraction/factExtractor.js +0 -46
  73. package/dist/extraction/factsWritePath.js +0 -179
  74. package/dist/extraction/preferenceExtractor.js +0 -150
  75. package/dist/extraction/secretGuard.js +0 -176
  76. package/dist/extraction/secretScanner.js +0 -665
  77. package/dist/extraction/typedFacts.js +0 -224
  78. package/dist/extraction/writePathAdjudication.js +0 -110
  79. package/dist/importing/apply.js +0 -672
  80. package/dist/importing/bundle-write.js +0 -80
  81. package/dist/importing/cli.js +0 -408
  82. package/dist/importing/existing.js +0 -51
  83. package/dist/importing/facts.js +0 -121
  84. package/dist/importing/forgetImported.js +0 -79
  85. package/dist/importing/hosted.js +0 -467
  86. package/dist/importing/journalLog.js +0 -96
  87. package/dist/importing/markdown.js +0 -98
  88. package/dist/importing/plan.js +0 -201
  89. package/dist/importing/secretScreen.js +0 -113
  90. package/dist/importing/serialize.js +0 -188
  91. package/dist/importing/source.js +0 -463
  92. package/dist/importing/types.js +0 -6
  93. package/dist/indexer/chunker.js +0 -319
  94. package/dist/indexer/dailyEntries.js +0 -63
  95. package/dist/indexer/hasher.js +0 -10
  96. package/dist/indexer/laneRuns.js +0 -48
  97. package/dist/indexer/o200k.js +0 -481
  98. package/dist/indexer/outsideRoot.js +0 -77
  99. package/dist/indexer/parser.js +0 -170
  100. package/dist/indexer/pipeline.js +0 -988
  101. package/dist/indexer/staleness.js +0 -201
  102. package/dist/indexer/tokenizer.js +0 -77
  103. package/dist/indexer/walker.js +0 -170
  104. package/dist/mcp/hive.js +0 -88
  105. package/dist/mcp/requestErrors.js +0 -47
  106. package/dist/mcp/server.js +0 -426
  107. package/dist/memory/agentLease.js +0 -43
  108. package/dist/memory/confinedWrite.js +0 -315
  109. package/dist/memory/controls.js +0 -73
  110. package/dist/memory/dailyNote.js +0 -265
  111. package/dist/memory/durableAppend.js +0 -57
  112. package/dist/memory/factConflicts.js +0 -203
  113. package/dist/memory/factTerms.js +0 -321
  114. package/dist/memory/handoff.js +0 -363
  115. package/dist/memory/hiveNameHeader.cjs +0 -10
  116. package/dist/memory/inventory.js +0 -55
  117. package/dist/memory/invisibleText.js +0 -20
  118. package/dist/memory/lifecycle.js +0 -1991
  119. package/dist/memory/limits.js +0 -13
  120. package/dist/memory/requests.js +0 -183
  121. package/dist/memory/sourceName.js +0 -276
  122. package/dist/memory/statusFacts.js +0 -61
  123. package/dist/memory/whatsNew.js +0 -158
  124. package/dist/memory/writer.js +0 -175
  125. package/dist/memory/writerConflicts.js +0 -85
  126. package/dist/memorymap/memoryMap.js +0 -1594
  127. package/dist/memorymap/replacedJournal.js +0 -58
  128. package/dist/memorymap/replacements.js +0 -410
  129. package/dist/mvp/activity.js +0 -86
  130. package/dist/mvp/agentMemory.js +0 -1800
  131. package/dist/mvp/answerCheck.js +0 -211
  132. package/dist/mvp/auth.js +0 -531
  133. package/dist/mvp/cli.js +0 -75
  134. package/dist/mvp/client-store.js +0 -462
  135. package/dist/mvp/compileCache.js +0 -242
  136. package/dist/mvp/compileSeed.js +0 -33
  137. package/dist/mvp/config.js +0 -288
  138. package/dist/mvp/connectionStatus.js +0 -80
  139. package/dist/mvp/contextDistinct.js +0 -53
  140. package/dist/mvp/contextProfile.js +0 -87
  141. package/dist/mvp/contextRelevance.js +0 -413
  142. package/dist/mvp/directorySurface.js +0 -68
  143. package/dist/mvp/engine.js +0 -1078
  144. package/dist/mvp/exportAll.js +0 -374
  145. package/dist/mvp/factLanePack.js +0 -77
  146. package/dist/mvp/factMarkers.js +0 -65
  147. package/dist/mvp/factsLane.js +0 -203
  148. package/dist/mvp/hiddenSpans.js +0 -585
  149. package/dist/mvp/history.js +0 -414
  150. package/dist/mvp/hitDates.js +0 -31
  151. package/dist/mvp/hitFloor.js +0 -36
  152. package/dist/mvp/identity.js +0 -18
  153. package/dist/mvp/idle.js +0 -113
  154. package/dist/mvp/log.js +0 -118
  155. package/dist/mvp/memoryDir.js +0 -98
  156. package/dist/mvp/posthogMcp.js +0 -210
  157. package/dist/mvp/readScope.js +0 -104
  158. package/dist/mvp/readUsefulness.js +0 -222
  159. package/dist/mvp/sanitize.js +0 -48
  160. package/dist/mvp/schemaRejections.js +0 -91
  161. package/dist/mvp/scope.js +0 -127
  162. package/dist/mvp/server.js +0 -2604
  163. package/dist/mvp/serverCard.js +0 -38
  164. package/dist/mvp/storedSize.js +0 -139
  165. package/dist/mvp/telemetry.js +0 -474
  166. package/dist/net/poolFetch.js +0 -174
  167. package/dist/recall/actionRecall.js +0 -282
  168. package/dist/recall/autoRecall.js +0 -447
  169. package/dist/recall/searchRecall.js +0 -189
  170. package/dist/retrieval/adviceLines.js +0 -195
  171. package/dist/retrieval/adviceQuestion.js +0 -44
  172. package/dist/retrieval/conversationShape.js +0 -44
  173. package/dist/retrieval/dailyEntryTime.js +0 -55
  174. package/dist/retrieval/entityLookup.js +0 -162
  175. package/dist/retrieval/factsFirst.js +0 -188
  176. package/dist/retrieval/keyword.js +0 -84
  177. package/dist/retrieval/ledgerEventTime.js +0 -51
  178. package/dist/retrieval/ledgerLiveness.js +0 -83
  179. package/dist/retrieval/ledgerPresentation.js +0 -161
  180. package/dist/retrieval/noteIdentity.js +0 -57
  181. package/dist/retrieval/orchestrator.js +0 -1171
  182. package/dist/retrieval/plainWording.js +0 -236
  183. package/dist/retrieval/queryHelpers.js +0 -142
  184. package/dist/retrieval/questionSpan.js +0 -475
  185. package/dist/retrieval/readerEvents.js +0 -690
  186. package/dist/retrieval/readerLayout.js +0 -422
  187. package/dist/retrieval/relativeTimeHints.js +0 -113
  188. package/dist/retrieval/semantic.js +0 -67
  189. package/dist/router/routerCache.js +0 -106
  190. package/dist/router/sessionRouter.js +0 -726
  191. package/dist/toolRefusal.js +0 -120
  192. package/dist/watcher/watcher.js +0 -77
  193. /package/dist/{indexer/o200k.json → o200k.json} +0 -0
@@ -1,463 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.toRelative = toRelative;
7
- exports.isSelected = isSelected;
8
- exports.readRenorIndexSource = readRenorIndexSource;
9
- exports.readBundleSource = readBundleSource;
10
- exports.readSource = readSource;
11
- const fs_1 = __importDefault(require("fs"));
12
- const path_1 = __importDefault(require("path"));
13
- const client_1 = require("../db/client");
14
- const types_1 = require("./types");
15
- /** Relative path with forward slashes, or the input unchanged when it is not under the root. */
16
- function toRelative(sourceRoot, absolutePath) {
17
- const root = path_1.default.resolve(sourceRoot);
18
- const abs = path_1.default.resolve(absolutePath);
19
- const rel = path_1.default.relative(root, abs);
20
- if (rel === '' || rel.startsWith('..') || path_1.default.isAbsolute(rel))
21
- return absolutePath;
22
- return rel.split(path_1.default.sep).join('/');
23
- }
24
- function matchesPrefix(relPath, prefixes) {
25
- return prefixes.some(prefix => {
26
- const clean = prefix.replace(/^(\.?\/)+/, '').replace(/\/+$/, '');
27
- return relPath === clean || relPath.startsWith(clean + '/');
28
- });
29
- }
30
- /** Selection is explicit: a path must pass `include` (when given) and survive `exclude`. */
31
- function isSelected(relPath, filter) {
32
- if (filter.include.length > 0 && !matchesPrefix(relPath, filter.include))
33
- return false;
34
- if (filter.exclude.length > 0 && matchesPrefix(relPath, filter.exclude))
35
- return false;
36
- return true;
37
- }
38
- /**
39
- * Read a Renor-shaped index (any store that uses the engine's `notes`/`chunks`/`facts`
40
- * tables, including another Renor workspace or the personal brain) as an import bundle.
41
- *
42
- * The database is opened `readonly` so a source can never be written by an import —
43
- * including the WAL side files a write-capable open would touch.
44
- */
45
- function readRenorIndexSource(options) {
46
- // Through the sanctioned opener (`src/db/client.ts`), which enforces read-only at the
47
- // SQLite level so an import can never write to the store it is reading.
48
- const db = (0, client_1.openReadOnlyDb)(options.dbPath);
49
- try {
50
- const filter = {
51
- include: options.include ?? [],
52
- exclude: options.exclude ?? [],
53
- limit: options.limit,
54
- };
55
- const allNotes = db.prepare('SELECT path, title, kind, modified_at, frontmatter_json FROM notes').all();
56
- const selected = [];
57
- let filteredOut = 0;
58
- for (const row of allNotes) {
59
- const rel = toRelative(options.sourceRoot, row.path);
60
- if (!isSelected(rel, filter)) {
61
- filteredOut += 1;
62
- continue;
63
- }
64
- // The lifecycle's synthetic `_mcp_` row is not a note document.
65
- if (rel === '_mcp_') {
66
- filteredOut += 1;
67
- continue;
68
- }
69
- selected.push({ row, rel });
70
- }
71
- selected.sort((a, b) => a.rel.localeCompare(b.rel));
72
- const limited = options.limit !== undefined && options.limit >= 0
73
- ? selected.slice(0, options.limit)
74
- : selected;
75
- const chunksByNote = new Map();
76
- const entitiesByNote = new Map();
77
- const contentsByNote = new Map();
78
- const chunkStmt = db.prepare('SELECT note_path, heading_path, text, token_count, start_line, end_line FROM chunks WHERE note_path = ? ORDER BY id');
79
- // The lifecycle sentinel owns canonical entities; carrying those would duplicate
80
- // the destination's own lifecycle entity for the same subject.
81
- const entityStmt = db.prepare(`SELECT type, canonical_name, aliases_json, confidence FROM entities
82
- WHERE source_note = ? AND source_note != '_mcp_'`);
83
- const contentRoot = path_1.default.resolve(options.contentRoot ?? options.sourceRoot);
84
- for (const { row, rel } of limited) {
85
- const rows = chunkStmt.all(row.path);
86
- chunksByNote.set(row.path, rows.map(r => ({
87
- headingPath: r.heading_path ?? '',
88
- text: r.text,
89
- tokenCount: r.token_count,
90
- // The same span rule as the bundle adapter: a coordinate that cannot be a citation
91
- // is dropped rather than inherited into the destination's `chunks` rows.
92
- ...normalizedSpan(r.start_line, r.end_line),
93
- })));
94
- const entityRows = entityStmt.all(row.path);
95
- entitiesByNote.set(row.path, entityRows.map(e => ({
96
- type: e.type,
97
- canonicalName: e.canonical_name,
98
- aliases: parseAliases(e.aliases_json),
99
- confidence: typeof e.confidence === 'number' ? e.confidence : 1,
100
- })));
101
- // Prefer the source's own bytes: they are the source of truth, they keep the
102
- // stored chunk line ranges truthful, and copying a document is not re-parsing it.
103
- const original = readOriginalContent(contentRoot, rel);
104
- if (original !== null)
105
- contentsByNote.set(row.path, original);
106
- }
107
- const notes = limited.map(({ row, rel }) => ({
108
- sourcePath: row.path,
109
- relPath: rel,
110
- title: row.title,
111
- kind: row.kind ?? null,
112
- modifiedAt: row.modified_at,
113
- frontmatter: parseFrontmatter(row.frontmatter_json),
114
- chunks: chunksByNote.get(row.path) ?? [],
115
- entities: entitiesByNote.get(row.path) ?? [],
116
- originalContent: contentsByNote.get(row.path),
117
- }));
118
- // Only CURRENT facts are carried: a superseded value is history the destination
119
- // would have to replay in order, and the source's own ledger is the authority for
120
- // its lifecycle. Carrying closed rows would duplicate history under new ids.
121
- const factsAvailable = db.prepare('SELECT count(*) AS c FROM facts WHERE valid_to IS NULL').get().c;
122
- const factRows = db.prepare(`SELECT e.canonical_name AS subject, f.predicate AS predicate, f.object_text AS object_text,
123
- f.scope AS scope, f.valid_from AS valid_from, f.valid_to AS valid_to,
124
- f.source_path AS source_path
125
- FROM facts f
126
- JOIN entities e ON e.id = f.subject_entity_id
127
- WHERE f.valid_to IS NULL AND f.object_text IS NOT NULL AND e.canonical_name IS NOT NULL
128
- ORDER BY f.valid_from DESC, f.id DESC`).all();
129
- const selectedNotePaths = new Set(limited.map(({ row }) => row.path));
130
- const facts = [];
131
- for (const row of factRows) {
132
- const isLedgerFact = row.source_path === '_mcp_';
133
- // Ledger-derived facts are the owner's explicitly stated memory: a small, global,
134
- // high-value set. They are carried by default (the point of an import is to see
135
- // what Renor already holds) and skipped only when the caller excludes them.
136
- if (isLedgerFact) {
137
- if (matchesPrefix('_mcp_', filter.exclude) || matchesPrefix('ledger', filter.exclude))
138
- continue;
139
- }
140
- else if (!selectedNotePaths.has(row.source_path)) {
141
- continue;
142
- }
143
- facts.push({
144
- subject: String(row.subject),
145
- predicate: String(row.predicate),
146
- object: String(row.object_text),
147
- scope: row.scope ?? 'global',
148
- validFrom: row.valid_from,
149
- sourcePath: row.source_path,
150
- origin: isLedgerFact ? 'ledger' : 'note',
151
- ledgerSource: isLedgerFact ? 'import:renor-index' : 'import:renor-index',
152
- });
153
- }
154
- return {
155
- format: types_1.BUNDLE_FORMAT,
156
- sourceLabel: options.label ?? 'renor-index',
157
- notes,
158
- facts,
159
- stats: {
160
- notesAvailable: allNotes.length,
161
- notesSelected: notes.length,
162
- notesFilteredOut: filteredOut + (selected.length - limited.length),
163
- notesWithOriginalBytes: notes.filter(n => n.originalContent !== undefined).length,
164
- chunksSelected: notes.reduce((sum, n) => sum + n.chunks.length, 0),
165
- factsAvailable,
166
- factsSelected: facts.length,
167
- },
168
- };
169
- }
170
- finally {
171
- db.close();
172
- }
173
- }
174
- /**
175
- * The source note's original bytes, when the content tree is reachable. Returns null
176
- * when the file is absent, so the caller falls back to reconstruction and reports it.
177
- */
178
- function readOriginalContent(contentRoot, relPath) {
179
- const candidate = path_1.default.resolve(contentRoot, relPath);
180
- const root = path_1.default.resolve(contentRoot);
181
- const rel = path_1.default.relative(root, candidate);
182
- if (rel === '' || rel.startsWith('..') || path_1.default.isAbsolute(rel))
183
- return null;
184
- try {
185
- return fs_1.default.readFileSync(candidate, 'utf8');
186
- }
187
- catch {
188
- return null;
189
- }
190
- }
191
- function parseAliases(raw) {
192
- try {
193
- const parsed = JSON.parse(raw);
194
- return Array.isArray(parsed) ? parsed.filter((v) => typeof v === 'string') : [];
195
- }
196
- catch {
197
- return [];
198
- }
199
- }
200
- function parseFrontmatter(raw) {
201
- try {
202
- const parsed = JSON.parse(raw);
203
- return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
204
- ? parsed
205
- : {};
206
- }
207
- catch {
208
- return {};
209
- }
210
- }
211
- /**
212
- * Read a `renor-memory-export/v1` JSONL bundle written by any provider.
213
- * One JSON record per line: `{"type":"note",…}` / `{"type":"fact",…}` / `{"type":"meta",…}`.
214
- *
215
- * `filter` is applied HERE, in the adapter, exactly as the index adapter applies it —
216
- * `include`/`exclude` select note records by `relPath`, `limit` caps the selection, and
217
- * `_mcp_`/`ledger` in `exclude` drops the owner's ledger-derived facts. An adapter that
218
- * returned everything would make the CLI's selection flags a silent no-op, and
219
- * `--exclude Private` would import the private notes anyway. `filter` is optional so the
220
- * adapter can still be used as a plain bundle reader.
221
- */
222
- function readBundleSource(filePath, filter = { include: [], exclude: [] }) {
223
- const include = filter.include ?? [];
224
- const exclude = filter.exclude ?? [];
225
- const raw = fs_1.default.readFileSync(filePath, 'utf8');
226
- const parsedNotes = [];
227
- const parsedFacts = [];
228
- let sourceLabel = path_1.default.basename(filePath, path_1.default.extname(filePath));
229
- let format = types_1.BUNDLE_FORMAT;
230
- const lines = raw.split('\n');
231
- for (let i = 0; i < lines.length; i++) {
232
- const line = lines[i].trim();
233
- if (!line)
234
- continue;
235
- let record;
236
- try {
237
- record = JSON.parse(line);
238
- }
239
- catch {
240
- throw new Error(`bundle line ${i + 1} is not valid JSON`);
241
- }
242
- if (record?.type === 'meta') {
243
- if (typeof record.format === 'string')
244
- format = record.format;
245
- if (typeof record.source === 'string')
246
- sourceLabel = record.source;
247
- continue;
248
- }
249
- if (record?.type === 'note') {
250
- // Every field that reaches canonical bytes is validated where it is read: `String(x)`
251
- // accepted anything, so a malformed record became the literal text `[object Object]`,
252
- // which is then written into Markdown, indexed, and (for a fact) recorded in the
253
- // ledger as though it were memory.
254
- const note = `note ${bundleLabel(record.relPath ?? record.path)}`;
255
- const at = bundleWhere(note, i);
256
- const relPathFromRecord = record.relPath ?? record.path;
257
- parsedNotes.push({
258
- sourcePath: bundleString(record.path, '', 'path', at),
259
- relPath: bundleString(relPathFromRecord, '', 'relPath', at),
260
- title: bundleString(record.title, '', 'title', at),
261
- kind: typeof record.kind === 'string' ? record.kind : null,
262
- modifiedAt: bundleString(record.modifiedAt, '', 'modifiedAt', at),
263
- frontmatter: record.frontmatter && typeof record.frontmatter === 'object' ? record.frontmatter : {},
264
- chunks: Array.isArray(record.chunks)
265
- ? record.chunks.map((c, index) => {
266
- const chunk = bundleWhere(note, i, `chunk ${index}`);
267
- return {
268
- headingPath: bundleString(c?.headingPath, '', 'headingPath', chunk),
269
- text: bundleString(c?.text, '', 'text', chunk),
270
- tokenCount: bundleNumber(c?.tokenCount, 0, 'tokenCount', chunk),
271
- // Spans must survive the round trip: they are the only fallback for a chunk
272
- // whose text cannot be located, so dropping them would silently make a
273
- // bundle-sourced import behave differently from a direct index read. A span
274
- // that cannot be a citation — negative, fractional, or reversed — is dropped
275
- // here instead of being inherited as a coordinate.
276
- ...normalizedSpan(c?.startLine, c?.endLine),
277
- };
278
- })
279
- : [],
280
- entities: Array.isArray(record.entities)
281
- ? record.entities.map((e, index) => {
282
- const entity = bundleWhere(note, i, `entity ${index}`);
283
- return {
284
- type: bundleString(e?.type, 'note', 'type', entity),
285
- canonicalName: bundleString(e?.canonicalName, '', 'canonicalName', entity),
286
- aliases: Array.isArray(e?.aliases)
287
- ? e.aliases.map((a, aliasIndex) => (bundleString(a, '', `alias ${aliasIndex}`, entity)))
288
- : [],
289
- confidence: bundleNumber(e?.confidence, 1, 'confidence', entity),
290
- };
291
- })
292
- : [],
293
- originalContent: typeof record.originalContent === 'string' ? record.originalContent : undefined,
294
- });
295
- continue;
296
- }
297
- if (record?.type === 'fact') {
298
- // `String(x)` on a fact field fabricated `[object Object]` as a canonical ledger value.
299
- const at = bundleWhere('fact', i);
300
- parsedFacts.push({
301
- subject: bundleString(record.subject, '', 'subject', at),
302
- predicate: bundleString(record.predicate, '', 'predicate', at),
303
- object: bundleString(record.object, '', 'object', at),
304
- scope: String(record.scope ?? 'global'),
305
- validFrom: String(record.validFrom ?? ''),
306
- sourcePath: String(record.sourcePath ?? ''),
307
- origin: record.origin === 'ledger' ? 'ledger' : 'note',
308
- eventId: typeof record.eventId === 'string' ? record.eventId : undefined,
309
- closedEvent: (record.closedEvent ?? null), // carried unvalidated, as before
310
- ledgerSource: typeof record.ledgerSource === 'string' ? record.ledgerSource : undefined,
311
- });
312
- continue;
313
- }
314
- throw new Error(`bundle line ${i + 1} has unknown record type ${JSON.stringify(record?.type)}`);
315
- }
316
- if (format !== types_1.BUNDLE_FORMAT) {
317
- throw new Error(`unsupported bundle format ${JSON.stringify(format)}; expected ${types_1.BUNDLE_FORMAT}`);
318
- }
319
- // Selection, in the same order and with the same rule the index adapter uses: the index
320
- // adapter sorts by relative path BEFORE applying `limit`, so a bundle is sorted here too
321
- // and `--limit N` selects the same records whichever order the provider wrote them in.
322
- const selection = { include, exclude };
323
- const selected = [];
324
- let notesFilteredOut = 0;
325
- for (const note of parsedNotes) {
326
- if (!isSelected(note.relPath, selection)) {
327
- notesFilteredOut += 1;
328
- continue;
329
- }
330
- selected.push(note);
331
- }
332
- selected.sort((a, b) => a.relPath.localeCompare(b.relPath));
333
- const notes = filter.limit !== undefined && filter.limit >= 0
334
- ? selected.slice(0, filter.limit)
335
- : selected;
336
- notesFilteredOut += selected.length - notes.length;
337
- // Facts follow the notes: a note-derived fact for a note that was not selected is not
338
- // carried, and the owner's ledger-derived facts (`_mcp_`) are carried by default and
339
- // dropped only when explicitly excluded — the same rule the index adapter applies.
340
- // Both a note's source path and its relative path count as naming it, because a
341
- // provider may write either.
342
- const selectedPaths = new Set();
343
- for (const note of notes) {
344
- selectedPaths.add(note.sourcePath);
345
- selectedPaths.add(note.relPath);
346
- }
347
- const facts = [];
348
- for (const fact of parsedFacts) {
349
- if (fact.sourcePath === '_mcp_') {
350
- if (matchesPrefix('_mcp_', exclude) || matchesPrefix('ledger', exclude))
351
- continue;
352
- facts.push(fact);
353
- continue;
354
- }
355
- // A fact that names no path at all carries no note association that selection could
356
- // be applied to; one that names a path must belong to a selected note.
357
- if (fact.sourcePath !== '' && !selectedPaths.has(fact.sourcePath))
358
- continue;
359
- facts.push(fact);
360
- }
361
- return {
362
- format,
363
- sourceLabel,
364
- notes,
365
- facts,
366
- stats: {
367
- notesAvailable: parsedNotes.length,
368
- notesSelected: notes.length,
369
- notesFilteredOut,
370
- notesWithOriginalBytes: notes.filter(n => n.originalContent !== undefined).length,
371
- chunksSelected: notes.reduce((sum, n) => sum + n.chunks.length, 0),
372
- factsAvailable: parsedFacts.length,
373
- factsSelected: facts.length,
374
- },
375
- };
376
- }
377
- /** A label for a record whose own identity may be malformed, safe to print in an error. */
378
- function bundleLabel(raw) {
379
- return typeof raw === 'string' ? JSON.stringify(raw) : JSON.stringify(raw ?? '');
380
- }
381
- /**
382
- * A string field of a bundle record, validated where the record is read.
383
- *
384
- * An absent/null field keeps its default, so existing bundles stay readable; a
385
- * present-but-non-string field is refused, naming the line, the record and the field.
386
- */
387
- function bundleString(raw, fallback, field, where) {
388
- if (raw === undefined || raw === null)
389
- return fallback;
390
- if (typeof raw !== 'string') {
391
- throw new Error(`${where} has an invalid ${field} ${JSON.stringify(raw)}: expected a string`);
392
- }
393
- return raw;
394
- }
395
- /** Where a bundle record's field lives, so a malformed value is named precisely. */
396
- function bundleWhere(origin, lineIndex, part) {
397
- return `bundle line ${lineIndex + 1}: ${origin}${part ? ` ${part}` : ''}`;
398
- }
399
- /**
400
- * A line span, or nothing when it cannot be a citation.
401
- *
402
- * A negative or fractional span was copied verbatim and could be inherited into
403
- * `chunks.start_line`/`end_line` and handed back as a citation range, so a span that is not
404
- * a non-negative, ordered integer pair is treated exactly like "text not located": unknown.
405
- */
406
- function normalizedSpan(startLine, endLine) {
407
- if (typeof startLine !== 'number' || typeof endLine !== 'number')
408
- return {};
409
- if (!Number.isInteger(startLine) || !Number.isInteger(endLine))
410
- return {};
411
- if (startLine < 0 || endLine < startLine)
412
- return {};
413
- return { startLine, endLine };
414
- }
415
- /**
416
- * A numeric field of a bundle record, validated where the record is read.
417
- *
418
- * `Number(record.field ?? default)` accepted anything: a malformed `tokenCount` became
419
- * `NaN`, travelled through the plan, and only failed at the write layer as
420
- * `NOT NULL constraint failed: chunks.token_count` — after canonical note bytes had been
421
- * written, and reported as a *ledger replay* rejection. Invalid input is a property of the
422
- * bundle, so it is rejected here, before any write, naming the line, the note and the
423
- * field. An absent/null field keeps its default, so existing bundles stay readable.
424
- */
425
- function bundleNumber(raw, fallback, field, where) {
426
- if (raw === undefined || raw === null)
427
- return fallback;
428
- const value = typeof raw === 'number'
429
- ? raw
430
- : typeof raw === 'string' && raw.trim() !== '' ? Number(raw) : Number.NaN;
431
- if (!Number.isFinite(value) || value < 0) {
432
- throw new Error(`${where} has an invalid ${field} ${JSON.stringify(raw)}: expected a non-negative finite number`);
433
- }
434
- return value;
435
- }
436
- /** Open a source from a `kind:path` spec. */
437
- function readSource(spec, filter) {
438
- const separator = spec.indexOf(':');
439
- if (separator < 0) {
440
- throw new Error('source must be given as kind:path (for example renor-index:/path/index.db)');
441
- }
442
- const kind = spec.slice(0, separator);
443
- const target = spec.slice(separator + 1);
444
- if (kind === 'renor-index') {
445
- return readRenorIndexSource({
446
- dbPath: target,
447
- sourceRoot: filter.sourceRoot ?? path_1.default.dirname(path_1.default.dirname(target)),
448
- contentRoot: filter.contentRoot,
449
- include: filter.include,
450
- exclude: filter.exclude,
451
- limit: filter.limit,
452
- label: filter.label,
453
- });
454
- }
455
- if (kind === 'bundle') {
456
- return readBundleSource(target, {
457
- include: filter.include,
458
- exclude: filter.exclude,
459
- limit: filter.limit,
460
- });
461
- }
462
- throw new Error(`unknown source kind ${JSON.stringify(kind)}; expected renor-index or bundle`);
463
- }
@@ -1,6 +0,0 @@
1
- "use strict";
2
- /** Portable memory bundle: the interface every import source must produce. */
3
- Object.defineProperty(exports, "__esModule", { value: true });
4
- exports.BUNDLE_FORMAT = void 0;
5
- /** The bundle format this module reads and writes. */
6
- exports.BUNDLE_FORMAT = 'renor-memory-export/v1';