@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 @@
1
+ {"version":3,"file":"annotate.js","sourceRoot":"","sources":["../../src/tools/annotate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAQ;IAC3D,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,WAAW,EACT,6IAA6I;QAC/I,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;SAC7E;KACF,EACD,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,SAAS,GAAG,CAAC,OAAO,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC;IACjD,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}
@@ -0,0 +1,22 @@
1
+ import { z } from 'zod';
2
+ import { softDelete } from '../core/lifecycle.js';
3
+ import { batchText, respond } from './respond.js';
4
+ export function registerDelete({ server, store, ctx }) {
5
+ server.registerTool('delete', {
6
+ description: 'Remove nodes from reads. History is kept. If something replaces the node, use supersede instead.',
7
+ inputSchema: { keys: z.array(z.string()).min(1) },
8
+ }, ({ keys }) => respond(async () => {
9
+ const out = await softDelete(ctx, store, keys);
10
+ const lines = [batchText('Deleted', out)];
11
+ for (const d of out.dangling)
12
+ lines.push(danglingLine(d.key, d.from));
13
+ return lines.join('\n');
14
+ }));
15
+ }
16
+ const SHOWN = 5;
17
+ /** `task/a (part_of), task/b (references) still link to concept/x; ...` */
18
+ function danglingLine(key, from) {
19
+ const shown = from.slice(0, SHOWN).join(', ') + (from.length > SHOWN ? ` and ${from.length - SHOWN} more` : '');
20
+ return `${shown} still link to ${key}, so those links lead nowhere now. Relink them if they need a new target.`;
21
+ }
22
+ //# sourceMappingURL=delete.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/tools/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAQ;IACzD,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,WAAW,EAAE,kGAAkG;QAC/G,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;KAClD,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACX,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CACL,CAAC;AACJ,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,CAAC;AAEhB,2EAA2E;AAC3E,SAAS,YAAY,CAAC,GAAW,EAAE,IAAc;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,MAAM,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChH,OAAO,GAAG,KAAK,kBAAkB,GAAG,2EAA2E,CAAC;AAClH,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=deps.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/tools/deps.ts"],"names":[],"mappings":""}
@@ -0,0 +1,14 @@
1
+ import { z } from 'zod';
2
+ import { feedback } from '../core/lifecycle.js';
3
+ import { batchText, respond } from './respond.js';
4
+ const LABELS = { useful: 'useful', not_useful: 'not useful', outdated_or_wrong: 'outdated or wrong' };
5
+ export function registerFeedback({ server, store, ctx }) {
6
+ server.registerTool('feedback', {
7
+ description: 'Say which nodes helped. Call once at the end of a task with the useful ones; call right away for anything outdated or wrong.',
8
+ inputSchema: {
9
+ keys: z.array(z.string()).min(1),
10
+ verdict: z.enum(['useful', 'not_useful', 'outdated_or_wrong']),
11
+ },
12
+ }, ({ keys, verdict }) => respond(async () => batchText(`Marked ${LABELS[verdict]}:`, await feedback(ctx, store, keys, verdict))));
13
+ }
14
+ //# sourceMappingURL=feedback.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/tools/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAW,CAAC;AAE/G,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAQ;IAC3D,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,WAAW,EACT,8HAA8H;QAChI,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAChC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC;SAC/D;KACF,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CACpB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,UAAU,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAC1G,CAAC;AACJ,CAAC"}
@@ -0,0 +1,65 @@
1
+ import { z } from 'zod';
2
+ import { get } from '../core/get.js';
3
+ import { RENDER_LEVELS, renderStub } from '../core/render.js';
4
+ import { respond } from './respond.js';
5
+ export function registerGet({ server, store, ctx }) {
6
+ server.registerTool('get', {
7
+ description: 'Fetch one or more nodes by key. Optionally include directly linked nodes as titles.',
8
+ inputSchema: {
9
+ keys: z.array(z.string()).min(1).describe('Node keys, e.g. ["concept/permissions"].'),
10
+ level: z.enum(RENDER_LEVELS).default('full'),
11
+ neighbors: z.boolean().default(false).describe('Add nodes one link away.'),
12
+ neighbor_level: z.enum(RENDER_LEVELS).default('title'),
13
+ all_status: z.boolean().default(false).describe('Return deleted nodes too.'),
14
+ },
15
+ }, (input) => respond(async () => {
16
+ const items = await get(ctx, store, {
17
+ keys: input.keys,
18
+ neighbors: input.neighbors,
19
+ allStatus: input.all_status,
20
+ });
21
+ return items.map((item) => renderItem(ctx, item, input.level, input.neighbor_level)).join('\n\n---\n\n');
22
+ }));
23
+ }
24
+ function renderItem(ctx, item, level, neighborLevel) {
25
+ if (!item.node) {
26
+ return item.deleted
27
+ ? `${item.ref} was deleted; all_status: true shows it.`
28
+ : `Not found: ${item.ref}. search finds nodes by their words.`;
29
+ }
30
+ const lines = [
31
+ renderStub(ctx, item.node, level, { supersededByKey: item.supersededByKey, conflictKey: item.conflictKey }),
32
+ ];
33
+ if (item.neighbors?.length) {
34
+ lines.push('', 'Links:', ...renderNeighbors(ctx, item.neighbors, neighborLevel));
35
+ if (item.moreNeighbors)
36
+ lines.push(`+${item.moreNeighbors} more`);
37
+ }
38
+ return lines.join('\n');
39
+ }
40
+ /**
41
+ * Grouped by direction and edge type. At title level a group fits on one line:
42
+ * `→ depends_on: concept/roles Roles; concept/groups Groups`.
43
+ */
44
+ function renderNeighbors(ctx, neighbors, level) {
45
+ const groups = new Map();
46
+ for (const n of neighbors) {
47
+ const label = `${n.direction === 'out' ? '→' : '←'} ${n.type}`;
48
+ groups.set(label, [...(groups.get(label) ?? []), n]);
49
+ }
50
+ const lines = [];
51
+ for (const [label, group] of groups) {
52
+ if (level === 'title') {
53
+ const entries = group.map((n) => (n.node ? `${n.key} ${n.node.title}` : `${n.key} (missing)`));
54
+ lines.push(`${label}: ${entries.join('; ')}`);
55
+ }
56
+ else {
57
+ lines.push(`${label}:`);
58
+ for (const n of group) {
59
+ lines.push(n.node ? `- ${renderStub(ctx, n.node, level)}` : `- ${n.key} (missing)`);
60
+ }
61
+ }
62
+ }
63
+ return lines;
64
+ }
65
+ //# sourceMappingURL=get.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/tools/get.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import { z } from 'zod';
2
+ import { link } from '../core/link.js';
3
+ import { respond } from './respond.js';
4
+ export function registerLink({ server, store, ctx }) {
5
+ server.registerTool('link', {
6
+ description: 'Link two nodes with a typed edge, e.g. depends_on, part_of, references, related_to. The target may not exist yet.',
7
+ inputSchema: {
8
+ from: z.string(),
9
+ to: z.string(),
10
+ type: z.string(),
11
+ note: z.string().optional().describe('Short reason for the link.'),
12
+ },
13
+ }, (input) => respond(async () => {
14
+ return linkLines(await link(ctx, store, input)).join('\n');
15
+ }));
16
+ }
17
+ /** How a link reads in a tool result. Shared with upsert's links. */
18
+ export function linkLines(out) {
19
+ const lines = [`${out.created ? 'Linked' : 'Already linked'}: ${out.fromKey} → ${out.edge.type} → ${out.toKey}.`];
20
+ if (out.toMissing)
21
+ lines.push(`${out.toKey} does not exist yet; the link resolves when it is created.`);
22
+ if (out.typeHint)
23
+ lines.push(out.typeHint);
24
+ if (out.targetHint)
25
+ lines.push(out.targetHint);
26
+ return lines;
27
+ }
28
+ //# sourceMappingURL=link.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/tools/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAmB,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,UAAU,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAQ;IACvD,MAAM,CAAC,YAAY,CACjB,MAAM,EACN;QACE,WAAW,EACT,mHAAmH;QACrH,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SACnE;KACF,EACD,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,OAAO,SAAS,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC,CACL,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,SAAS,CAAC,GAAe;IACvC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,KAAK,GAAG,CAAC,OAAO,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;IAClH,IAAI,GAAG,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,4DAA4D,CAAC,CAAC;IACxG,IAAI,GAAG,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,GAAG,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,24 @@
1
+ import { listTypes } from '../core/types.js';
2
+ import { respond } from './respond.js';
3
+ export function registerListTypes({ server, store, ctx }) {
4
+ server.registerTool('list_types', {
5
+ description: 'Node and edge types in use, with counts. Check before inventing a new type.',
6
+ inputSchema: {},
7
+ }, () => respond(async () => {
8
+ const out = await listTypes(ctx, store);
9
+ const lines = [`Node types: ${counts(out.nodeTypes)}`, `Edge types: ${counts(out.edgeTypes)}`];
10
+ const unused = [...out.unusedNodeStarters, ...out.unusedEdgeStarters];
11
+ if (unused.length)
12
+ lines.push(`Also available: ${unused.join(', ')}`);
13
+ if (out.lookalikes.length) {
14
+ const shown = out.lookalikes.map(([a, b]) => `${a} and ${b}`).join('; ');
15
+ lines.push(`Look alike: ${shown}. Pick one and reuse it.`);
16
+ }
17
+ return lines.join('\n');
18
+ }));
19
+ }
20
+ /** `concept 12, how-to 4` */
21
+ function counts(types) {
22
+ return types.length ? types.map((t) => `${t.name} ${t.count}`).join(', ') : 'none yet';
23
+ }
24
+ //# sourceMappingURL=listTypes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"listTypes.js","sourceRoot":"","sources":["../../src/tools/listTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,UAAU,iBAAiB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAQ;IAC5D,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,WAAW,EAAE,6EAA6E;QAC1F,WAAW,EAAE,EAAE;KAChB,EACD,GAAG,EAAE,CACH,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,CAAC,eAAe,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,eAAe,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC/F,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,kBAAkB,EAAE,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACtE,IAAI,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzE,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,0BAA0B,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CACL,CAAC;AACJ,CAAC;AAED,6BAA6B;AAC7B,SAAS,MAAM,CAAC,KAAkB;IAChC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AACzF,CAAC"}
@@ -0,0 +1,42 @@
1
+ import { z } from 'zod';
2
+ import { orient } from '../core/orient.js';
3
+ import { plural, titleLine } from '../core/render.js';
4
+ import { respond } from './respond.js';
5
+ export function registerOrient({ server, store, ctx }) {
6
+ server.registerTool('orient', {
7
+ description: 'Call first. Explains this knowledge graph, its house rules and where to start. Pass a few focus words about your task to get likely-relevant entries.',
8
+ inputSchema: { focus: z.string().optional().describe('A few words about the current task.') },
9
+ }, ({ focus }) => respond(async () => {
10
+ const out = await orient(ctx, store, { focus });
11
+ const parts = [out.intro];
12
+ if (out.houseRules.length)
13
+ parts.push(['House rules:', ...out.houseRules.map((r) => `- ${r}`)].join('\n'));
14
+ if (out.empty) {
15
+ parts.push('The graph is empty. Use upsert to add the first node.');
16
+ return parts.join('\n\n');
17
+ }
18
+ if (out.stats) {
19
+ const s = out.stats;
20
+ const lines = [
21
+ `Graph: ${plural(s.nodes, 'node')} · ${plural(s.nodeTypes, 'node type')} · ${plural(s.edgeTypes, 'edge type')}`,
22
+ ];
23
+ if (s.topTypes.length)
24
+ lines.push(`Top types: ${s.topTypes.join(', ')}`);
25
+ if (s.topEdgeTypes.length)
26
+ lines.push(`Top edge types: ${s.topEdgeTypes.join(', ')}`);
27
+ parts.push(lines.join('\n'));
28
+ }
29
+ if (out.pinned.length) {
30
+ parts.push(['Start here:', ...out.pinned.map((n) => `- ${titleLine(ctx, n)}`)].join('\n'));
31
+ }
32
+ if (out.focus?.nodes.length) {
33
+ parts.push([
34
+ `Possibly relevant to "${out.focus.words}":`,
35
+ ...out.focus.nodes.map((n) => `- ${titleLine(ctx, n)}`),
36
+ ].join('\n'));
37
+ }
38
+ parts.push(out.more);
39
+ return parts.join('\n\n');
40
+ }));
41
+ }
42
+ //# sourceMappingURL=orient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/tools/orient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import { z } from 'zod';
2
+ import { recent } from '../core/recent.js';
3
+ import { titleLine } from '../core/render.js';
4
+ import { respond } from './respond.js';
5
+ const VERBS = { created: 'created', updated: 'updated', useful: 'marked useful' };
6
+ export function registerRecent({ server, store, ctx }) {
7
+ server.registerTool('recent', {
8
+ description: 'Latest changes and nodes marked useful, newest first.',
9
+ inputSchema: {
10
+ mine: z.boolean().default(false).describe('Only nodes you wrote last.'),
11
+ since: z.string().optional().describe('A date (2026-10-01) or a span (3d, 12h, 2w).'),
12
+ limit: z.number().int().min(1).max(50).default(10),
13
+ },
14
+ }, (input) => respond(async () => {
15
+ const entries = await recent(ctx, store, input);
16
+ if (entries.length === 0) {
17
+ const scope = [input.since && `since ${input.since}`, input.mine && 'yours only'].filter(Boolean);
18
+ return scope.length ? `Nothing recent (${scope.join(', ')}).` : 'Nothing recent.';
19
+ }
20
+ return entries.map((e) => `- ${titleLine(ctx, e.node)} · ${VERBS[e.kind]} ${e.at.slice(0, 10)}`).join('\n');
21
+ }));
22
+ }
23
+ //# sourceMappingURL=recent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recent.js","sourceRoot":"","sources":["../../src/tools/recent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAW,CAAC;AAE3F,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAQ;IACzD,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,WAAW,EAAE,uDAAuD;QACpE,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACrF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SACnD;KACF,EACD,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,SAAS,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;QACpF,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9G,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}
@@ -0,0 +1,12 @@
1
+ import { CONFLICT_TYPE } from '../core/starters.js';
2
+ /** Short on purpose: it lands in the conversation when the user picks it. */
3
+ const TEXT = `Resolve starter-set conflicts in MCPdia. A conflict node means a starter set changed a node after it was edited here.
4
+ 1. search "${CONFLICT_TYPE}" with type "${CONFLICT_TYPE}" (limit 50) to list them; a node with one open shows "newer version in ..." in get and search too.
5
+ 2. For each, get it with neighbors: its body holds the starter set's version, and its conflicts_with link points at the edited node. get that node too.
6
+ 3. Decide with the user, briefly: merge the two into the edited node (upsert), take the starter version (upsert it over the edited node), or keep the edited node as it is.
7
+ 4. delete the conflict node. That marks this version as handled; a later change in the starter set opens it again.`;
8
+ /** The first packaged prompt (ADR 0026): a guided pass over open starter-set conflicts. */
9
+ export function registerResolveConflicts({ server }) {
10
+ server.registerPrompt('resolve-conflicts', { description: 'Walk through starter-set conflicts and resolve each one.' }, () => ({ messages: [{ role: 'user', content: { type: 'text', text: TEXT } }] }));
11
+ }
12
+ //# sourceMappingURL=resolveConflicts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveConflicts.js","sourceRoot":"","sources":["../../src/tools/resolveConflicts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,6EAA6E;AAC7E,MAAM,IAAI,GAAG;aACA,aAAa,gBAAgB,aAAa;;;mHAG4D,CAAC;AAEpH,2FAA2F;AAC3F,MAAM,UAAU,wBAAwB,CAAC,EAAE,MAAM,EAAQ;IACvD,MAAM,CAAC,cAAc,CACnB,mBAAmB,EACnB,EAAE,WAAW,EAAE,0DAA0D,EAAE,EAC3E,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAChF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,36 @@
1
+ import { UserError } from '../core/errors.js';
2
+ export function text(body) {
3
+ return { content: [{ type: 'text', text: body }] };
4
+ }
5
+ /** `Verified concept/a, concept/b.` plus a line each for keys not found, superseded or already deleted. */
6
+ export function batchText(verb, out) {
7
+ const lines = [];
8
+ if (out.done.length)
9
+ lines.push(`${verb} ${out.done.join(', ')}.`);
10
+ if (out.notFound.length)
11
+ lines.push(`Not found: ${out.notFound.join(', ')}.`);
12
+ if (out.superseded?.length)
13
+ lines.push(`Superseded, use the replacement: ${out.superseded.join(', ')}.`);
14
+ if (out.deleted?.length)
15
+ lines.push(`Already deleted: ${out.deleted.join(', ')}.`);
16
+ return lines.join('\n');
17
+ }
18
+ /**
19
+ * Runs a tool body. A UserError becomes one line (plus its hint) with MCP's
20
+ * error flag set; anything else is a bug and is rethrown for the SDK to report.
21
+ */
22
+ export async function respond(run) {
23
+ try {
24
+ return text(await run());
25
+ }
26
+ catch (err) {
27
+ if (err instanceof UserError) {
28
+ return {
29
+ content: [{ type: 'text', text: err.hint ? `${err.message} ${err.hint}` : err.message }],
30
+ isError: true,
31
+ };
32
+ }
33
+ throw err;
34
+ }
35
+ }
36
+ //# sourceMappingURL=respond.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"respond.js","sourceRoot":"","sources":["../../src/tools/respond.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,GAAsF;IAEtF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,oCAAoC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzG,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAA0B;IACtD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACxF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}
@@ -0,0 +1,48 @@
1
+ import { z } from 'zod';
2
+ import { RENDER_LEVELS, renderStub } from '../core/render.js';
3
+ import { search } from '../core/search.js';
4
+ import { respond } from './respond.js';
5
+ export function registerSearch({ server, store, ctx }) {
6
+ server.registerTool('search', {
7
+ description: 'Keyword search over titles, summaries, bodies, aliases and tags. Returns short stubs; use get for detail.',
8
+ inputSchema: {
9
+ query: z.string().describe('Plain words.'),
10
+ type: z.string().optional().describe('Only nodes of this type.'),
11
+ tag: z.string().optional().describe('Only nodes with this tag.'),
12
+ level: z.enum(RENDER_LEVELS).default('summary'),
13
+ limit: z.number().int().min(1).max(50).default(10),
14
+ all_status: z.boolean().default(false).describe('Include superseded and deleted nodes.'),
15
+ },
16
+ }, (input) => respond(async () => {
17
+ const out = await search(ctx, store, { ...input, allStatus: input.all_status });
18
+ if (out.unknownType) {
19
+ return `No nodes have type "${out.unknownType}". list_types shows the types in use.`;
20
+ }
21
+ if (out.total === 0) {
22
+ const filters = [input.type && `type ${input.type}`, input.tag && `tag ${input.tag}`].filter(Boolean);
23
+ return filters.length
24
+ ? `No results for "${out.query}" with ${filters.join(' and ')}. Try without the filter, or other words.`
25
+ : `No results for "${out.query}". Try fewer or different words.`;
26
+ }
27
+ const count = out.total > out.hits.length ? `${out.hits.length} of ${out.total}` : `${out.total}`;
28
+ const partials = out.hits.length - out.fullMatches;
29
+ const header = out.partial
30
+ ? `No node matched all words of "${out.query}". ${count} ${out.total === 1 ? 'partial match; check it before relying on it' : 'partial matches; check them before relying on them'}:`
31
+ : partials > 0
32
+ ? `${out.fullMatches} result${out.fullMatches === 1 ? '' : 's'} for "${out.query}", then ${partials} ${partials === 1 ? 'partial match; check it before relying on it' : 'partial matches; check them before relying on them'}:`
33
+ : `${count} result${out.total === 1 ? '' : 's'} for "${out.query}":`;
34
+ const entries = out.hits.map((h) => `- ${renderStub(ctx, h.node, input.level, {
35
+ edgeCount: h.edgeCount,
36
+ matched: h.matched,
37
+ supersededByKey: h.supersededByKey,
38
+ conflictKey: h.conflictKey,
39
+ terms: out.terms,
40
+ })}`);
41
+ const lines = [header, ...entries];
42
+ if (out.total > out.hits.length) {
43
+ lines.push(`${out.total - out.hits.length} more: raise limit or add type.`);
44
+ }
45
+ return lines.join('\n');
46
+ }));
47
+ }
48
+ //# sourceMappingURL=search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import { z } from 'zod';
2
+ import { supersede } from '../core/lifecycle.js';
3
+ import { plural } from '../core/render.js';
4
+ import { respond } from './respond.js';
5
+ export function registerSupersede({ server, store, ctx }) {
6
+ server.registerTool('supersede', {
7
+ description: 'Replace an outdated node with a new one. Moves its links to the replacement and keeps the old one as history.',
8
+ inputSchema: {
9
+ old: z.string(),
10
+ new: z
11
+ .string()
12
+ .optional()
13
+ .describe('Key of the replacement, existing or new. Omit to build one from the title.'),
14
+ type: z.string().optional().describe("Defaults to the old node's type."),
15
+ title: z.string().optional().describe("Defaults to the old node's title."),
16
+ summary: z.string().optional(),
17
+ body: z.string().optional(),
18
+ tags: z.array(z.string()).optional(),
19
+ aliases: z.array(z.string()).optional(),
20
+ },
21
+ }, (input) => respond(async () => {
22
+ const out = await supersede(ctx, store, input);
23
+ const lines = [
24
+ `${out.newKey}${out.created ? ' (new)' : ''} supersedes ${out.oldKey}. Moved ${plural(out.movedEdges, 'link')}.`,
25
+ ];
26
+ if (out.typeHint)
27
+ lines.push(out.typeHint);
28
+ return lines.join('\n');
29
+ }));
30
+ }
31
+ //# sourceMappingURL=supersede.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"supersede.js","sourceRoot":"","sources":["../../src/tools/supersede.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,UAAU,iBAAiB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAQ;IAC5D,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,WAAW,EACT,+GAA+G;QACjH,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;YACzF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACxC;KACF,EACD,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG;YACZ,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,MAAM,WAAW,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG;SACjH,CAAC;QACF,IAAI,GAAG,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}
@@ -0,0 +1,45 @@
1
+ import { z } from 'zod';
2
+ import { displayKey } from '../core/keys.js';
3
+ import { upsert } from '../core/upsert.js';
4
+ import { linkLines } from './link.js';
5
+ import { respond } from './respond.js';
6
+ export function registerUpsert({ server, store, ctx }) {
7
+ server.registerTool('upsert', {
8
+ description: "Create a node, or edit a node's own facts by key. Search first to avoid duplicates. Keep one thing per node; put it under its parent with links.",
9
+ inputSchema: {
10
+ key: z.string().optional().describe('Omit to create; a key is built from type and title.'),
11
+ type: z.string().describe('e.g. concept, how-to, decision, note. Reuse existing types.'),
12
+ title: z.string(),
13
+ summary: z.string().optional().describe('One line. This is what search shows.'),
14
+ body: z.string().optional(),
15
+ tags: z.array(z.string()).optional(),
16
+ aliases: z.array(z.string()).optional().describe('Other names people use for it.'),
17
+ properties: z.record(z.string(), z.unknown()).optional(),
18
+ version: z.number().optional().describe('Apply only if the node is still at this version.'),
19
+ links: z
20
+ .array(z.object({ type: z.string(), to: z.string(), note: z.string().optional() }))
21
+ .optional()
22
+ .describe('Edges from this node, e.g. [{type: "part_of", to: "plan/x"}]. Added, never replaced.'),
23
+ },
24
+ }, (input) => respond(async () => {
25
+ const out = await upsert(ctx, store, input);
26
+ const key = displayKey(ctx, out.node.namespace, out.node.key);
27
+ const verb = out.created ? 'Created' : out.restored ? 'Restored' : 'Updated';
28
+ const lines = [`${verb} ${key} (v${out.node.version}).`];
29
+ if (out.restored)
30
+ lines.push('It was deleted; fields you did not pass kept their old values.');
31
+ if (out.typeHint)
32
+ lines.push(out.typeHint);
33
+ if (out.removedProperties) {
34
+ lines.push(`Properties replaced; dropped ${out.removedProperties.join(', ')}. Pass every property you want to keep.`);
35
+ }
36
+ for (const l of out.links)
37
+ lines.push(...linkLines(l));
38
+ if (out.parentHint)
39
+ lines.push(out.parentHint);
40
+ if (out.summaryHint)
41
+ lines.push(out.summaryHint);
42
+ return lines.join('\n');
43
+ }));
44
+ }
45
+ //# sourceMappingURL=upsert.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upsert.js","sourceRoot":"","sources":["../../src/tools/upsert.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { z } from 'zod';
2
+ import { verify } from '../core/lifecycle.js';
3
+ import { batchText, respond } from './respond.js';
4
+ export function registerVerify({ server, store, ctx }) {
5
+ server.registerTool('verify', {
6
+ description: 'Mark nodes as checked and still correct. Use after confirming a fact against the source.',
7
+ inputSchema: { keys: z.array(z.string()).min(1) },
8
+ }, ({ keys }) => respond(async () => batchText('Verified', await verify(ctx, store, keys))));
9
+ }
10
+ //# sourceMappingURL=verify.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/tools/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAQ;IACzD,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,WAAW,EAAE,0FAA0F;QACvG,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;KAClD,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CACzF,CAAC;AACJ,CAAC"}
package/dist/ulid.js ADDED
@@ -0,0 +1,22 @@
1
+ import { getRandomValues } from 'node:crypto';
2
+ // Crockford base32, as the ULID spec uses.
3
+ const ENCODING = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
4
+ /** 26-character, time-sortable, random id (https://github.com/ulid/spec). */
5
+ export function ulid(now = Date.now()) {
6
+ let time = '';
7
+ let t = now;
8
+ for (let i = 0; i < 10; i++) {
9
+ time = ENCODING[t % 32] + time;
10
+ t = Math.floor(t / 32);
11
+ }
12
+ // 256 is a multiple of 32, so `% 32` stays uniform.
13
+ const bytes = getRandomValues(new Uint8Array(16));
14
+ let random = '';
15
+ for (const b of bytes)
16
+ random += ENCODING[b % 32];
17
+ return time + random;
18
+ }
19
+ export function isUlid(value) {
20
+ return /^[0-9A-HJKMNP-TV-Z]{26}$/.test(value);
21
+ }
22
+ //# sourceMappingURL=ulid.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ulid.js","sourceRoot":"","sources":["../src/ulid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,2CAA2C;AAC3C,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,UAAU,IAAI,CAAC,GAAG,GAAW,IAAI,CAAC,GAAG,EAAE;IAC3C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,CAAC,GAAG,GAAG,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;QAC/B,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,oDAAoD;IACpD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,OAAO,IAAI,GAAG,MAAM,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,68 @@
1
1
  {
2
2
  "name": "@bradwagoner/mcpdia",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "Shared glossary and knowledge-graph memory for LLMs, over MCP.",
5
+ "type": "module",
6
+ "license": "MIT",
7
+ "bin": {
8
+ "mcpdia": "dist/index.js"
9
+ },
10
+ "files": [
11
+ "dist"
12
+ ],
13
+ "engines": {
14
+ "node": ">=22"
15
+ },
16
+ "scripts": {
17
+ "build": "tsc -p tsconfig.build.json && node scripts/copy-migrations.mjs",
18
+ "typecheck": "tsc --noEmit",
19
+ "format": "prettier --write .",
20
+ "format:check": "prettier --check .",
21
+ "test": "vitest run",
22
+ "start": "node dist/index.js",
23
+ "bench:build": "tsc -p tsconfig.bench.json && node scripts/copy-migrations.mjs dist-bench/src",
24
+ "bench": "npm run bench:build && node dist-bench/bench/run.js",
25
+ "bench:lookups": "npm run bench:build && node dist-bench/bench/run-lookups.js",
26
+ "bench:growth": "npm run bench:build && node dist-bench/bench/run-growth.js",
27
+ "bench:stores": "npm run bench:build && node dist-bench/bench/run-stores.js",
28
+ "demo:markdown": "npm run bench:build && node dist-bench/bench/demo.js markdown",
29
+ "demo:seed": "npm run bench:build && node dist-bench/bench/demo.js seed",
30
+ "prepack": "npm run build"
31
+ },
32
+ "keywords": [
33
+ "mcp",
34
+ "knowledge-graph",
35
+ "llm-memory",
36
+ "glossary"
37
+ ],
38
+ "dependencies": {
39
+ "@modelcontextprotocol/sdk": "^1.32.1",
40
+ "better-sqlite3": "^13.0.3",
41
+ "pg": "^8.23.1",
42
+ "zod": "^4.6.5"
43
+ },
44
+ "devDependencies": {
45
+ "@anthropic-ai/sdk": "^0.133.0",
46
+ "@electric-sql/pglite": "^0.5.11",
47
+ "@types/better-sqlite3": "^9.6.0",
48
+ "@types/node": "^26.6.4",
49
+ "@types/pg": "^8.23.1",
50
+ "prettier": "^3.9.9",
51
+ "typescript": "^7.0.2",
52
+ "vitest": "^5.0.3"
53
+ },
54
+ "allowScripts": {
55
+ "better-sqlite3@13.0.3": true
56
+ },
57
+ "publishConfig": {
58
+ "access": "public"
59
+ },
60
+ "repository": {
61
+ "type": "git",
62
+ "url": "git+https://github.com/bradwagoner/mcpdia.git"
63
+ },
64
+ "homepage": "https://github.com/bradwagoner/mcpdia#readme",
65
+ "bugs": {
66
+ "url": "https://github.com/bradwagoner/mcpdia/issues"
67
+ }
68
+ }