@bradwagoner/mcpdia 0.0.0-stage → 0.1.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 (98) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +176 -2
  3. package/dist/cli.js +79 -0
  4. package/dist/cli.js.map +1 -0
  5. package/dist/context.js +51 -0
  6. package/dist/context.js.map +1 -0
  7. package/dist/core/annotate.js +53 -0
  8. package/dist/core/annotate.js.map +1 -0
  9. package/dist/core/errors.js +9 -0
  10. package/dist/core/errors.js.map +1 -0
  11. package/dist/core/export.js +42 -0
  12. package/dist/core/export.js.map +1 -0
  13. package/dist/core/get.js +40 -0
  14. package/dist/core/get.js.map +1 -0
  15. package/dist/core/keys.js +89 -0
  16. package/dist/core/keys.js.map +1 -0
  17. package/dist/core/lifecycle.js +120 -0
  18. package/dist/core/lifecycle.js.map +1 -0
  19. package/dist/core/link.js +89 -0
  20. package/dist/core/link.js.map +1 -0
  21. package/dist/core/nodes.js +53 -0
  22. package/dist/core/nodes.js.map +1 -0
  23. package/dist/core/orient.js +51 -0
  24. package/dist/core/orient.js.map +1 -0
  25. package/dist/core/recent.js +27 -0
  26. package/dist/core/recent.js.map +1 -0
  27. package/dist/core/render.js +176 -0
  28. package/dist/core/render.js.map +1 -0
  29. package/dist/core/search.js +82 -0
  30. package/dist/core/search.js.map +1 -0
  31. package/dist/core/settings.js +31 -0
  32. package/dist/core/settings.js.map +1 -0
  33. package/dist/core/starters.js +308 -0
  34. package/dist/core/starters.js.map +1 -0
  35. package/dist/core/types.js +24 -0
  36. package/dist/core/types.js.map +1 -0
  37. package/dist/core/upsert.js +131 -0
  38. package/dist/core/upsert.js.map +1 -0
  39. package/dist/core/vocabulary.js +36 -0
  40. package/dist/core/vocabulary.js.map +1 -0
  41. package/dist/http.js +82 -0
  42. package/dist/http.js.map +1 -0
  43. package/dist/index.js +176 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/metrics.js +30 -0
  46. package/dist/metrics.js.map +1 -0
  47. package/dist/server.js +73 -0
  48. package/dist/server.js.map +1 -0
  49. package/dist/starters.js +82 -0
  50. package/dist/starters.js.map +1 -0
  51. package/dist/store/GraphStore.js +15 -0
  52. package/dist/store/GraphStore.js.map +1 -0
  53. package/dist/store/postgres/PostgresStore.js +388 -0
  54. package/dist/store/postgres/PostgresStore.js.map +1 -0
  55. package/dist/store/postgres/db.js +34 -0
  56. package/dist/store/postgres/db.js.map +1 -0
  57. package/dist/store/postgres/migrate.js +43 -0
  58. package/dist/store/postgres/migrate.js.map +1 -0
  59. package/dist/store/postgres/migrations/001_init.sql +130 -0
  60. package/dist/store/sqlite/SqliteStore.js +400 -0
  61. package/dist/store/sqlite/SqliteStore.js.map +1 -0
  62. package/dist/store/sqlite/migrate.js +38 -0
  63. package/dist/store/sqlite/migrate.js.map +1 -0
  64. package/dist/store/sqlite/migrations/001_init.sql +156 -0
  65. package/dist/store/sqlite/migrations/002_last_wrong_at.sql +3 -0
  66. package/dist/tools/annotate.js +17 -0
  67. package/dist/tools/annotate.js.map +1 -0
  68. package/dist/tools/delete.js +22 -0
  69. package/dist/tools/delete.js.map +1 -0
  70. package/dist/tools/deps.js +2 -0
  71. package/dist/tools/deps.js.map +1 -0
  72. package/dist/tools/feedback.js +14 -0
  73. package/dist/tools/feedback.js.map +1 -0
  74. package/dist/tools/get.js +65 -0
  75. package/dist/tools/get.js.map +1 -0
  76. package/dist/tools/link.js +28 -0
  77. package/dist/tools/link.js.map +1 -0
  78. package/dist/tools/listTypes.js +24 -0
  79. package/dist/tools/listTypes.js.map +1 -0
  80. package/dist/tools/orient.js +42 -0
  81. package/dist/tools/orient.js.map +1 -0
  82. package/dist/tools/recent.js +23 -0
  83. package/dist/tools/recent.js.map +1 -0
  84. package/dist/tools/resolveConflicts.js +12 -0
  85. package/dist/tools/resolveConflicts.js.map +1 -0
  86. package/dist/tools/respond.js +36 -0
  87. package/dist/tools/respond.js.map +1 -0
  88. package/dist/tools/search.js +48 -0
  89. package/dist/tools/search.js.map +1 -0
  90. package/dist/tools/supersede.js +31 -0
  91. package/dist/tools/supersede.js.map +1 -0
  92. package/dist/tools/upsert.js +45 -0
  93. package/dist/tools/upsert.js.map +1 -0
  94. package/dist/tools/verify.js +10 -0
  95. package/dist/tools/verify.js.map +1 -0
  96. package/dist/ulid.js +22 -0
  97. package/dist/ulid.js.map +1 -0
  98. package/package.json +66 -4
@@ -0,0 +1,120 @@
1
+ import { UserError } from './errors.js';
2
+ import { cleanKey, displayKey, parseRef, suggestKey, uniqueKey } from './keys.js';
3
+ import { COMMENTS_ON } from './annotate.js';
4
+ import { findNode, requireActive, supersededByKey } from './nodes.js';
5
+ import { writeNode } from './upsert.js';
6
+ import { normalizeNodeType } from './vocabulary.js';
7
+ /** Calls that touch several nodes take a short list, like `get`. */
8
+ export const MAX_BATCH = 50;
9
+ export const SUPERSEDES = 'supersedes';
10
+ /**
11
+ * "This replaces that" (ADR 0008): creates or updates the replacement, marks
12
+ * the old node superseded with a pointer, moves its edges to the replacement,
13
+ * and links replacement → supersedes → old so the history stays visible.
14
+ */
15
+ export async function supersede(ctx, store, input) {
16
+ const old = await requireActive(ctx, store, input.old);
17
+ const hasContent = [input.type, input.title, input.summary, input.body, input.tags, input.aliases].some((v) => v !== undefined);
18
+ let result;
19
+ const existing = input.new ? await findNode(ctx, store, parseRef(ctx, cleanKey(input.new))) : null;
20
+ if (existing?.id === old.id)
21
+ throw new UserError('A node cannot supersede itself.');
22
+ if (existing && !hasContent) {
23
+ if (existing.status !== 'active')
24
+ throw new UserError(`${input.new} is not active.`);
25
+ result = { node: existing, created: false };
26
+ }
27
+ else {
28
+ const type = normalizeNodeType(input.type ?? existing?.type ?? old.type);
29
+ const title = input.title ?? existing?.title ?? old.title;
30
+ // Without a key, the replacement often has the old title, so take a suffixed key rather than clash.
31
+ const key = input.new ??
32
+ (await uniqueKey(suggestKey(type, title), async (k) => (await store.getNode(ctx.writeNamespace, k)) !== null));
33
+ const { summary, body, tags, aliases } = input;
34
+ result = await writeNode(ctx, store, { key, type, title, summary, body, tags, aliases });
35
+ }
36
+ const replacement = result.node;
37
+ const movedEdges = await store.repointEdges(old.id, replacement);
38
+ await store.setStatus(old.id, 'superseded', ctx.caller, replacement.id);
39
+ await store.upsertEdge({
40
+ fromNamespace: replacement.namespace,
41
+ fromKey: replacement.key,
42
+ toNamespace: old.namespace,
43
+ toKey: old.key,
44
+ type: SUPERSEDES,
45
+ note: null,
46
+ source: 'local',
47
+ author: ctx.caller,
48
+ });
49
+ return {
50
+ oldKey: displayKey(ctx, old.namespace, old.key),
51
+ newKey: displayKey(ctx, replacement.namespace, replacement.key),
52
+ replacement,
53
+ created: result.created,
54
+ movedEdges,
55
+ typeHint: result.typeHint,
56
+ };
57
+ }
58
+ /** "I checked and it is still right": bumps last_verified_at. */
59
+ export async function verify(ctx, store, keys) {
60
+ const { nodes, out } = await resolveBatch(ctx, store, keys);
61
+ await store.markVerified(nodes.map((n) => n.id), new Date().toISOString());
62
+ return out;
63
+ }
64
+ /** Soft delete only: the node and its history stay in the store. */
65
+ export async function softDelete(ctx, store, keys) {
66
+ const { nodes, out } = await resolveBatch(ctx, store, keys);
67
+ const dangling = [];
68
+ const gone = new Set(nodes.map((n) => n.id));
69
+ for (const node of nodes) {
70
+ await store.setStatus(node.id, 'deleted', ctx.caller);
71
+ const from = (await store.neighbors(node.id))
72
+ // Notes go with the node they comment on, so they don't count as dangling.
73
+ .filter((n) => n.direction === 'in' && n.edge.type !== COMMENTS_ON && n.other && !gone.has(n.other.id))
74
+ .filter((n) => ctx.namespaces.includes(n.otherNamespace))
75
+ .map((n) => `${displayKey(ctx, n.otherNamespace, n.otherKey)} (${n.edge.type})`);
76
+ if (from.length)
77
+ dangling.push({ key: displayKey(ctx, node.namespace, node.key), from });
78
+ }
79
+ return { ...out, dangling };
80
+ }
81
+ export async function feedback(ctx, store, keys, verdict) {
82
+ // Superseded nodes still show up in get, so they can still be marked outdated.
83
+ const { nodes, out } = await resolveBatch(ctx, store, keys, true);
84
+ await store.recordFeedback(nodes.map((n) => n.id), verdict, new Date().toISOString());
85
+ return out;
86
+ }
87
+ /**
88
+ * Active nodes (plus superseded ones when allowed) for a list of keys. Unknown
89
+ * keys are reported, not fatal; a superseded key names its replacement.
90
+ */
91
+ async function resolveBatch(ctx, store, keys, allowSuperseded = false) {
92
+ if (keys.length === 0)
93
+ throw new UserError('Pass at least one key.');
94
+ if (keys.length > MAX_BATCH)
95
+ throw new UserError(`Too many keys: ${keys.length}. Up to ${MAX_BATCH} per call.`);
96
+ const nodes = [];
97
+ const out = { done: [], notFound: [], superseded: [], deleted: [] };
98
+ for (const key of keys) {
99
+ const node = await findNode(ctx, store, parseRef(ctx, key));
100
+ const usable = node?.status === 'active' || (allowSuperseded && node?.status === 'superseded');
101
+ if (node && usable) {
102
+ if (nodes.some((n) => n.id === node.id))
103
+ continue;
104
+ nodes.push(node);
105
+ out.done.push(displayKey(ctx, node.namespace, node.key));
106
+ }
107
+ else if (node?.status === 'superseded') {
108
+ const by = await supersededByKey(ctx, store, node);
109
+ out.superseded.push(by ? `${key} (now ${by})` : key);
110
+ }
111
+ else if (node?.status === 'deleted') {
112
+ out.deleted.push(key);
113
+ }
114
+ else {
115
+ out.notFound.push(key);
116
+ }
117
+ }
118
+ return { nodes, out };
119
+ }
120
+ //# sourceMappingURL=lifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ import { UserError } from './errors.js';
2
+ import { displayKey, parseRef } from './keys.js';
3
+ import { findNode, supersededByKey, writableNamespace } from './nodes.js';
4
+ import { normalizeEdgeType, PARENT_EDGE_TYPES, STARTER_EDGE_TYPES } from './vocabulary.js';
5
+ /** How far up the parents a loop check walks. */
6
+ const LOOP_SCAN = 100;
7
+ /** Where a link points. The target may not exist yet: edges are late-bound, so store its namespace and key. */
8
+ export async function linkTarget(ctx, store, ref) {
9
+ const toRef = parseRef(ctx, ref);
10
+ const toNode = await findNode(ctx, store, toRef);
11
+ let to;
12
+ if (toNode)
13
+ to = { namespace: toNode.namespace, key: toNode.key };
14
+ else if (toRef.kind === 'key')
15
+ to = { namespace: writableNamespace(ctx, toRef), key: toRef.key };
16
+ else
17
+ throw new UserError(`Not found: ${toRef.id}.`, 'Link to a key instead; it can be created later.');
18
+ return { to, toNode };
19
+ }
20
+ export async function link(ctx, store, input) {
21
+ const type = normalizeEdgeType(input.type);
22
+ if (!type)
23
+ throw new UserError('type is empty.');
24
+ const from = await findNode(ctx, store, parseRef(ctx, input.from));
25
+ if (from?.status === 'deleted')
26
+ throw new UserError(`${input.from} was deleted.`, 'Link from a current node.');
27
+ if (!from)
28
+ throw new UserError(`Not found: ${input.from}.`, 'Create it with upsert first, or search for its key.');
29
+ const { to, toNode } = await linkTarget(ctx, store, input.to);
30
+ const used = (await store.stats(ctx.namespaces)).edgeTypes.map((t) => t.name);
31
+ const isNew = !used.includes(type) && !STARTER_EDGE_TYPES.includes(type);
32
+ const { edge, created } = await store.upsertEdge({
33
+ fromNamespace: from.namespace,
34
+ fromKey: from.key,
35
+ toNamespace: to.namespace,
36
+ toKey: to.key,
37
+ type,
38
+ note: input.note?.trim() || null,
39
+ source: 'local',
40
+ author: ctx.caller,
41
+ });
42
+ return {
43
+ edge,
44
+ created,
45
+ fromKey: displayKey(ctx, from.namespace, from.key),
46
+ toKey: displayKey(ctx, to.namespace, to.key),
47
+ toMissing: !toNode,
48
+ typeHint: isNew ? `Edge type "${type}" is new here. list_types shows the types in use.` : undefined,
49
+ targetHint: await targetHint(ctx, store, from, toNode, type),
50
+ };
51
+ }
52
+ async function targetHint(ctx, store, from, to, type) {
53
+ if (!to)
54
+ return undefined;
55
+ const toKey = displayKey(ctx, to.namespace, to.key);
56
+ if (to.status === 'deleted')
57
+ return `${toKey} was deleted, so this link leads nowhere. Link to a current node instead.`;
58
+ const next = await supersededByKey(ctx, store, to);
59
+ if (next)
60
+ return `${toKey} is superseded by ${next}. Link to ${next} if you meant the current one.`;
61
+ if (!PARENT_EDGE_TYPES.includes(type))
62
+ return undefined;
63
+ if (from.id === to.id)
64
+ return `This makes a loop: ${toKey} would sit under itself.`;
65
+ if (await isAbove(store, from.id, to.id)) {
66
+ return `This makes a loop: ${toKey} already sits under ${displayKey(ctx, from.namespace, from.key)}.`;
67
+ }
68
+ return undefined;
69
+ }
70
+ /** Whether `ancestor` is reachable from `id` by following parent edges up. */
71
+ async function isAbove(store, ancestor, id) {
72
+ const seen = new Set();
73
+ const queue = [id];
74
+ while (queue.length && seen.size < LOOP_SCAN) {
75
+ const current = queue.shift();
76
+ if (seen.has(current))
77
+ continue;
78
+ seen.add(current);
79
+ for (const n of await store.neighbors(current)) {
80
+ if (n.direction !== 'out' || !PARENT_EDGE_TYPES.includes(n.edge.type) || !n.other)
81
+ continue;
82
+ if (n.other.id === ancestor)
83
+ return true;
84
+ queue.push(n.other.id);
85
+ }
86
+ }
87
+ return false;
88
+ }
89
+ //# sourceMappingURL=link.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/core/link.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import { UserError } from './errors.js';
2
+ import { displayKey, parseRef } from './keys.js';
3
+ import { CONFLICTS_WITH } from './starters.js';
4
+ /** Looks a ref up and hides nodes outside the caller's namespaces. Any status. */
5
+ export async function findNode(ctx, store, ref) {
6
+ const node = ref.kind === 'id' ? await store.getNodeById(ref.id) : await store.getNode(ref.namespace, ref.key);
7
+ return node && ctx.namespaces.includes(node.namespace) ? node : null;
8
+ }
9
+ /** The active node a caller named, or a "not found" UserError. */
10
+ export async function requireActive(ctx, store, input) {
11
+ const node = await findNode(ctx, store, parseRef(ctx, input));
12
+ if (node?.status === 'active')
13
+ return node;
14
+ if (node?.status === 'superseded') {
15
+ const next = await supersededByKey(ctx, store, node);
16
+ throw new UserError(`${input} is superseded${next ? ` by ${next}` : ''}.`, next ? `Use ${next} instead.` : undefined);
17
+ }
18
+ if (node?.status === 'deleted')
19
+ throw new UserError(`${input} was deleted.`, 'Upsert its key to restore it, or search for a current node.');
20
+ throw new UserError(`Not found: ${input}.`, 'search for its key.');
21
+ }
22
+ /** The namespace a write to `ref` lands in; must be one the caller can see. */
23
+ export function writableNamespace(ctx, ref) {
24
+ if (!ctx.namespaces.includes(ref.namespace)) {
25
+ throw new UserError(`Namespace ${ref.namespace} is not loaded.`, `Loaded: ${ctx.namespaces.join(', ')}.`);
26
+ }
27
+ return ref.namespace;
28
+ }
29
+ /**
30
+ * Open starter-set conflicts on these nodes (ADR 0026): node id → display key of
31
+ * the conflict node. Conflicts live in starter namespaces, so a caller reading
32
+ * only its own namespace skips the query.
33
+ */
34
+ export async function openConflicts(ctx, store, nodes) {
35
+ if (ctx.namespaces.length === 1 || nodes.length === 0)
36
+ return new Map();
37
+ const into = await store.linksInto(nodes.map((n) => n.id), CONFLICTS_WITH);
38
+ const out = new Map();
39
+ for (const [id, from] of into) {
40
+ const visible = from.find((f) => ctx.namespaces.includes(f.namespace));
41
+ if (visible)
42
+ out.set(id, displayKey(ctx, visible.namespace, visible.key));
43
+ }
44
+ return out;
45
+ }
46
+ /** Display key of whatever replaced a superseded node. */
47
+ export async function supersededByKey(ctx, store, node) {
48
+ if (node.status !== 'superseded' || !node.supersededBy)
49
+ return undefined;
50
+ const next = await store.getNodeById(node.supersededBy);
51
+ return next ? displayKey(ctx, next.namespace, next.key) : undefined;
52
+ }
53
+ //# sourceMappingURL=nodes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/core/nodes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,51 @@
1
+ import { parseRef } from './keys.js';
2
+ import { findNode } from './nodes.js';
3
+ import { search } from './search.js';
4
+ import { getSetting } from './settings.js';
5
+ export const DEFAULT_INTRO = [
6
+ 'MCPdia: a knowledge graph of linked notes. Loop: search → read stubs → get the few that matter → write back (upsert, annotate, link) → feedback on what helped.',
7
+ "Notes and observations go in linked notes (annotate); edit a node's body only to correct shared facts.",
8
+ ].join('\n');
9
+ const FOCUS_LIMIT = 5;
10
+ const PRESETS = {
11
+ minimal: { stats: false, topTypes: 0, edgeTypes: false, focus: false },
12
+ standard: { stats: true, topTypes: 5, edgeTypes: false, focus: true },
13
+ verbose: { stats: true, topTypes: 10, edgeTypes: true, focus: true },
14
+ };
15
+ export async function orient(ctx, store, input) {
16
+ const settings = await getSetting(store, ctx, 'orient');
17
+ const shape = PRESETS[settings.preset] ?? PRESETS.standard;
18
+ const topTypes = settings.topTypes ?? shape.topTypes;
19
+ const focusOn = settings.focus ?? shape.focus;
20
+ const stats = await store.stats(ctx.namespaces);
21
+ const out = {
22
+ intro: settings.intro ?? DEFAULT_INTRO,
23
+ houseRules: await getSetting(store, ctx, 'house_rules'),
24
+ empty: stats.nodes === 0,
25
+ pinned: [],
26
+ more: 'More: list_types (vocabulary), recent (latest changes), search.',
27
+ };
28
+ if (out.empty)
29
+ return out;
30
+ if (shape.stats) {
31
+ out.stats = {
32
+ nodes: stats.nodes,
33
+ nodeTypes: stats.nodeTypes.length,
34
+ edgeTypes: stats.edgeTypes.length,
35
+ topTypes: stats.nodeTypes.slice(0, topTypes).map((t) => t.name),
36
+ topEdgeTypes: shape.edgeTypes ? stats.edgeTypes.slice(0, topTypes).map((t) => t.name) : [],
37
+ };
38
+ }
39
+ for (const key of await getSetting(store, ctx, 'pinned')) {
40
+ const node = await findNode(ctx, store, parseRef(ctx, key));
41
+ if (node?.status === 'active')
42
+ out.pinned.push(node);
43
+ }
44
+ if (focusOn && input.focus?.trim()) {
45
+ const result = await search(ctx, store, { query: input.focus, level: 'title', limit: FOCUS_LIMIT }).catch(() => null);
46
+ if (result)
47
+ out.focus = { words: input.focus.trim(), nodes: result.hits.map((h) => h.node) };
48
+ }
49
+ return out;
50
+ }
51
+ //# sourceMappingURL=orient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/core/orient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import { UserError } from './errors.js';
2
+ /**
3
+ * Latest writes and useful-marked nodes, newest first (ADR 0005).
4
+ * Reads are deliberately not tracked.
5
+ */
6
+ export async function recent(ctx, store, input) {
7
+ return store.recent({
8
+ namespaces: ctx.namespaces,
9
+ since: input.since ? parseSince(input.since) : undefined,
10
+ updatedBy: input.mine ? ctx.caller : undefined,
11
+ limit: input.limit,
12
+ });
13
+ }
14
+ const SPAN_MS = { h: 3_600_000, d: 86_400_000, w: 604_800_000 };
15
+ export function parseSince(value, now = Date.now()) {
16
+ const span = /^(\d+)\s*([hdw])$/i.exec(value.trim());
17
+ if (span) {
18
+ const unit = span[2].toLowerCase();
19
+ return new Date(now - Number(span[1]) * SPAN_MS[unit]).toISOString();
20
+ }
21
+ const date = new Date(value);
22
+ if (Number.isNaN(date.getTime())) {
23
+ throw new UserError(`Can't read since: ${value}.`, 'Use a date like 2026-10-01 or a span like 3d.');
24
+ }
25
+ return date.toISOString();
26
+ }
27
+ //# sourceMappingURL=recent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recent.js","sourceRoot":"","sources":["../../src/core/recent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAY,EAAE,KAAiB,EAAE,KAAkB;IAC9E,OAAO,KAAK,CAAC,MAAM,CAAC;QAClB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QACxD,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QAC9C,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAW,CAAC;AAEzE,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,GAAG,GAAW,IAAI,CAAC,GAAG,EAAE;IAChE,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,WAAW,EAA0B,CAAC;QAC5D,OAAO,IAAI,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,qBAAqB,KAAK,GAAG,EAAE,+CAA+C,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC"}
@@ -0,0 +1,176 @@
1
+ import { displayKey } from './keys.js';
2
+ /**
3
+ * Render levels (ADR 0004) as compact text (ADR 0011): one line per result,
4
+ * no field names or quotes, empty fields left out. Each level adds to the one before.
5
+ */
6
+ export const RENDER_LEVELS = ['title', 'summary', 'snippet', 'full'];
7
+ export const SNIPPET_LENGTH = 300;
8
+ /** A searched word past the cut gets this much intro, then the rest of the length around the word (ADR 0020). */
9
+ export const SNIPPET_INTRO = 100;
10
+ /** The window around the word starts about this far before it, so the lead-in shows too. */
11
+ const SNIPPET_LEAD = 80;
12
+ /**
13
+ * Someone marked the node outdated or wrong, and nobody has edited or verified it since.
14
+ * An edit or a verify clears the warning; the count stays on record.
15
+ */
16
+ export function flaggedWrong(node) {
17
+ return node.lastWrongAt !== null;
18
+ }
19
+ /** `concept/permissions [concept] Permission system` */
20
+ export function titleLine(ctx, node) {
21
+ return `${displayKey(ctx, node.namespace, node.key)} [${node.type}] ${node.title}`;
22
+ }
23
+ /**
24
+ * A node as one list entry: the title line, plus indented detail lines
25
+ * for `summary` and `snippet`. `full` falls through to renderFull.
26
+ */
27
+ export function renderStub(ctx, node, level, extras = {}) {
28
+ if (level === 'full')
29
+ return renderFull(ctx, node, extras);
30
+ const markers = [];
31
+ if (node.status === 'deleted')
32
+ markers.push('deleted');
33
+ if (extras.supersededByKey)
34
+ markers.push(`superseded by ${extras.supersededByKey}`);
35
+ if (flaggedWrong(node))
36
+ markers.push('flagged outdated or wrong');
37
+ if (extras.conflictKey)
38
+ markers.push(`newer version in ${extras.conflictKey}`);
39
+ if (extras.matched?.length)
40
+ markers.push(`matched: ${extras.matched.join(', ')}`);
41
+ const lines = [titleLine(ctx, node) + (markers.length ? ` (${markers.join('; ')})` : '')];
42
+ if (level === 'summary' || level === 'snippet')
43
+ lines.push(` ${summaryLine(node, extras)}`);
44
+ if (level === 'snippet' && node.body) {
45
+ lines.push(` ${snippet(node.body, extras.terms, `${node.title} ${node.summary ?? ''}`)}`);
46
+ }
47
+ return lines.join('\n');
48
+ }
49
+ /** `Roles grant actions; groups hold roles. · 4 links · verified 2026-09-30` */
50
+ export function summaryLine(node, extras) {
51
+ const parts = [];
52
+ if (node.summary)
53
+ parts.push(node.summary);
54
+ if (extras.edgeCount !== undefined)
55
+ parts.push(plural(extras.edgeCount, 'link'));
56
+ if (node.lastVerifiedAt)
57
+ parts.push(`verified ${day(node.lastVerifiedAt)}`);
58
+ return parts.join(' · ');
59
+ }
60
+ export function renderFull(ctx, node, extras = {}) {
61
+ const meta = [`v${node.version}`, `updated ${day(node.updatedAt)}`];
62
+ if (node.lastVerifiedAt)
63
+ meta.push(`verified ${day(node.lastVerifiedAt)}`);
64
+ const lines = [`${titleLine(ctx, node)} ${meta.join(' · ')}`];
65
+ if (node.status === 'deleted')
66
+ lines.push(`Deleted on ${day(node.updatedAt)}. Upsert this key to restore it.`);
67
+ if (extras.supersededByKey)
68
+ lines.push(`Superseded by ${extras.supersededByKey}`);
69
+ if (extras.conflictKey) {
70
+ lines.push(`The starter set changed this node after it was edited here; its version is in ${extras.conflictKey}. Compare, keep what's right, then delete ${extras.conflictKey} (or run the resolve-conflicts prompt).`);
71
+ }
72
+ if (flaggedWrong(node)) {
73
+ lines.push(`Flagged outdated or wrong on ${day(node.lastWrongAt)}. Check it before relying on it; fix it with upsert, or verify it if it is still right.`);
74
+ }
75
+ if (extras.matched?.length)
76
+ lines.push(`Matched: ${extras.matched.join(', ')}`);
77
+ if (node.summary)
78
+ lines.push(node.summary);
79
+ const labels = [];
80
+ if (node.tags.length)
81
+ labels.push(`Tags: ${node.tags.join(', ')}`);
82
+ if (node.aliases.length)
83
+ labels.push(`Aliases: ${node.aliases.join(', ')}`);
84
+ if (labels.length)
85
+ lines.push(labels.join(' '));
86
+ if (Object.keys(node.properties).length)
87
+ lines.push(`Properties: ${JSON.stringify(sortKeys(node.properties))}`);
88
+ if (node.body)
89
+ lines.push('', node.body);
90
+ return lines.join('\n');
91
+ }
92
+ export function plural(n, word) {
93
+ return `${n} ${word}${n === 1 ? '' : 's'}`;
94
+ }
95
+ /**
96
+ * The first SNIPPET_LENGTH characters of the body. If a search word shows up only past that
97
+ * (not in the title, summary or the first part), the snippet is a short intro plus the text
98
+ * around that word instead, cut at whole words, with a count of what was left out.
99
+ */
100
+ export function snippet(body, terms = [], shown = '') {
101
+ const flat = body.replace(/\s+/g, ' ').trim();
102
+ if (flat.length <= SNIPPET_LENGTH)
103
+ return flat;
104
+ const head = flat.slice(0, SNIPPET_LENGTH);
105
+ const hidden = terms
106
+ .filter((t) => findWord(`${shown} ${head}`, t) < 0)
107
+ .map((t) => findWord(flat, t))
108
+ .filter((i) => i >= 0);
109
+ if (hidden.length === 0)
110
+ return `${head}…`;
111
+ const at = Math.min(...hidden);
112
+ const introEnd = wordEndBefore(flat, SNIPPET_INTRO);
113
+ const from = Math.max(introEnd, at - SNIPPET_LEAD);
114
+ const room = SNIPPET_LENGTH - SNIPPET_INTRO;
115
+ // Inside a long word or URL, the nearest word boundary can lie past the match; cut mid-word instead.
116
+ let start = wordStartAfter(flat, from);
117
+ if (start > at)
118
+ start = from;
119
+ let end = wordEndBefore(flat, start + room);
120
+ if (end <= at)
121
+ end = Math.min(flat.length, start + room);
122
+ const left = flat.length - introEnd - (end - start);
123
+ return `${flat.slice(0, introEnd)} … ${flat.slice(start, end)}${end < flat.length ? ' …' : ''} (+${left} chars)`;
124
+ }
125
+ /**
126
+ * Where `term` shows up as a word start. The search index also matches stemmed forms
127
+ * ("permissions" finds "permission"), so if the term itself is missing, a few common
128
+ * endings are stripped and tried too. A light match, not the index's own stemmer.
129
+ */
130
+ function findWord(text, term) {
131
+ const at = wordIndex(text, term);
132
+ if (at >= 0)
133
+ return at;
134
+ for (const ending of ['ing', 'ed', 'es', 's']) {
135
+ const stem = term.slice(0, -ending.length);
136
+ if (term.toLowerCase().endsWith(ending) && stem.length >= 3) {
137
+ const i = wordIndex(text, stem);
138
+ if (i >= 0)
139
+ return i;
140
+ }
141
+ }
142
+ return -1;
143
+ }
144
+ /** Where a word starting with `term` begins: any case, `_` and punctuation break words. */
145
+ function wordIndex(text, term) {
146
+ const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
147
+ return text.search(new RegExp(`(?<![\\p{L}\\p{N}])${escaped}`, 'iu'));
148
+ }
149
+ /** `at`, moved back to the end of the word it falls in. */
150
+ function wordEndBefore(text, at) {
151
+ if (at >= text.length)
152
+ return text.length;
153
+ const space = text.lastIndexOf(' ', at);
154
+ return space > 0 ? space : at;
155
+ }
156
+ /** `at`, moved forward to the start of the next word unless it already starts one. */
157
+ function wordStartAfter(text, at) {
158
+ if (at <= 0 || text[at - 1] === ' ')
159
+ return at;
160
+ const space = text.indexOf(' ', at);
161
+ return space < 0 ? at : space + 1;
162
+ }
163
+ function day(iso) {
164
+ return iso.slice(0, 10);
165
+ }
166
+ /** Object keys sorted at every depth, arrays kept in order, so every store renders the same text. */
167
+ export function sortKeys(value) {
168
+ if (Array.isArray(value))
169
+ return value.map(sortKeys);
170
+ if (value === null || typeof value !== 'object')
171
+ return value;
172
+ return Object.fromEntries(Object.keys(value)
173
+ .sort()
174
+ .map((k) => [k, sortKeys(value[k])]));
175
+ }
176
+ //# sourceMappingURL=render.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/core/render.ts"],"names":[],"mappings":"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"}