@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,82 @@
1
+ import { NODE_STATUSES } from '../store/GraphStore.js';
2
+ import { UserError } from './errors.js';
3
+ import { openConflicts, supersededByKey } from './nodes.js';
4
+ import { normalizeNodeType, normalizeTag } from './vocabulary.js';
5
+ /**
6
+ * Question words that match almost everything and rank nothing, so "what is
7
+ * left for v0.1" searches for "left v0 1". Kept when they are all there is.
8
+ */
9
+ const STOP_WORDS = new Set(('a an and are about at be by can did do does for from how i in is it of on or should ' +
10
+ 'the there this to was we were what when where which who why with you').split(' '));
11
+ /** Words only: FTS5 operators and punctuation in the query are ignored, and so are stop words. */
12
+ export function searchTerms(query) {
13
+ const words = query.toLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [];
14
+ const content = words.filter((w) => !STOP_WORDS.has(w));
15
+ return content.length ? content : words;
16
+ }
17
+ /**
18
+ * Nodes matching every word come first. If they don't fill the limit and there were
19
+ * several words, the rest is topped up with nodes matching any word (still ranked
20
+ * by relevance), labelled with the words they matched (ADR 0021).
21
+ */
22
+ export async function search(ctx, store, input) {
23
+ const terms = searchTerms(input.query);
24
+ if (terms.length === 0)
25
+ throw new UserError('The query has no words to search for.');
26
+ const base = {
27
+ namespaces: ctx.namespaces,
28
+ terms,
29
+ type: input.type ? normalizeNodeType(input.type) : undefined,
30
+ tag: input.tag ? normalizeTag(input.tag) : undefined,
31
+ statuses: input.allStatus ? NODE_STATUSES : undefined,
32
+ limit: input.limit,
33
+ };
34
+ const full = await store.search({ ...base, match: 'all' });
35
+ let nodes = full.nodes;
36
+ let total = full.total;
37
+ // No minimum-match cutoff: FTS5 doesn't say how many words a row matched, so partial hits are labelled instead.
38
+ if (nodes.length < input.limit && terms.length > 1) {
39
+ const any = await store.search({ ...base, match: 'any', limit: input.limit + nodes.length });
40
+ const shown = new Set(nodes.map((n) => n.id));
41
+ nodes = [...nodes, ...any.nodes.filter((n) => !shown.has(n.id))].slice(0, input.limit);
42
+ total = any.total;
43
+ }
44
+ const fullMatches = full.nodes.length;
45
+ const partial = fullMatches === 0 && total > 0;
46
+ let unknownType;
47
+ // stats() counts active nodes only, so it can't call a type unknown when deleted/superseded ones are searched too.
48
+ if (total === 0 && base.type && !input.allStatus) {
49
+ const used = (await store.stats(ctx.namespaces)).nodeTypes.map((t) => t.name);
50
+ if (!used.includes(base.type))
51
+ unknownType = base.type;
52
+ }
53
+ // Which words each partial hit matched, one search per word, so the caller can judge relevance.
54
+ const matched = new Map();
55
+ const ids = nodes.slice(fullMatches).map((n) => n.id);
56
+ if (ids.length) {
57
+ for (const term of terms) {
58
+ const { nodes } = await store.search({ ...base, terms: [term], match: 'all', ids, limit: ids.length });
59
+ for (const n of nodes)
60
+ matched.set(n.id, [...(matched.get(n.id) ?? []), term]);
61
+ }
62
+ }
63
+ const wantsCounts = input.level === 'summary' || input.level === 'snippet';
64
+ const counts = wantsCounts ? await store.edgeCounts(nodes.map((n) => n.id)) : undefined;
65
+ const conflicts = await openConflicts(ctx, store, nodes);
66
+ return {
67
+ query: input.query,
68
+ terms,
69
+ hits: await Promise.all(nodes.map(async (node, i) => ({
70
+ node,
71
+ edgeCount: counts?.get(node.id) ?? (wantsCounts ? 0 : undefined),
72
+ matched: i >= fullMatches ? (matched.get(node.id) ?? []) : undefined,
73
+ supersededByKey: await supersededByKey(ctx, store, node),
74
+ conflictKey: conflicts.get(node.id),
75
+ }))),
76
+ total,
77
+ fullMatches,
78
+ partial,
79
+ unknownType,
80
+ };
81
+ }
82
+ //# sourceMappingURL=search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAoC,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAqClE;;;GAGG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,CACE,sFAAsF;IACtF,sEAAsE,CACvE,CAAC,KAAK,CAAC,GAAG,CAAC,CACb,CAAC;AAEF,kGAAkG;AAClG,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IACjE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAY,EAAE,KAAiB,EAAE,KAAkB;IAC9E,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAErF,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5D,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QACpD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QACrD,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACvB,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACvB,gHAAgH;IAChH,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7F,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACvF,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IACtC,MAAM,OAAO,GAAG,WAAW,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;IAE/C,IAAI,WAAwC,CAAC;IAC7C,mHAAmH;IACnH,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;IACzD,CAAC;IAED,gGAAgG;IAChG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACvG,KAAK,MAAM,CAAC,IAAI,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;IAC3E,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACzD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK;QACL,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CACrB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI;YACJ,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChE,OAAO,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YACpE,eAAe,EAAE,MAAM,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC;YACxD,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SACpC,CAAC,CAAC,CACJ;QACD,KAAK;QACL,WAAW;QACX,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC"}
@@ -0,0 +1,31 @@
1
+ export const BUILT_IN = {
2
+ orient: { preset: 'standard' },
3
+ house_rules: [],
4
+ pinned: [],
5
+ 'get.max_keys': 10,
6
+ };
7
+ export async function getSetting(store, ctx, key) {
8
+ const rows = (await store.getSettings(ctx.namespaces, key))
9
+ .map((row) => ({ row, rank: scopeRank(row, ctx) }))
10
+ .filter((r) => r.rank > 0)
11
+ .sort((a, b) => a.rank - b.rank);
12
+ let value = BUILT_IN[key];
13
+ for (const { row } of rows) {
14
+ value = isPlainObject(value) && isPlainObject(row.value) ? { ...value, ...row.value } : row.value;
15
+ }
16
+ return value;
17
+ }
18
+ /** 0 means "not for this caller". */
19
+ function scopeRank(row, ctx) {
20
+ if (row.scope.startsWith('pack:'))
21
+ return 1;
22
+ if (row.scope === 'team')
23
+ return 2;
24
+ if (row.scope === `user:${ctx.caller}`)
25
+ return 3;
26
+ return 0;
27
+ }
28
+ function isPlainObject(v) {
29
+ return typeof v === 'object' && v !== null && !Array.isArray(v);
30
+ }
31
+ //# sourceMappingURL=settings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/core/settings.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;IAC9B,WAAW,EAAE,EAAE;IACf,MAAM,EAAE,EAAE;IACV,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAiB,EACjB,GAAY,EACZ,GAAM;IAEN,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;SACxD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;SACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,KAAK,GAAY,QAAQ,CAAC,GAAG,CAAC,CAAC;IACnC,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;QAC3B,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACpG,CAAC;IACD,OAAO,KAAoB,CAAC;AAC9B,CAAC;AAED,qCAAqC;AACrC,SAAS,SAAS,CAAC,GAAe,EAAE,GAAY;IAC9C,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,CAAC;IACjD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}
@@ -0,0 +1,308 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { UserError } from './errors.js';
3
+ import { EXPORT_FORMAT_VERSION } from './export.js';
4
+ /**
5
+ * Starter sets (ADR 0026): an export loaded into a namespace of its own. Each
6
+ * reload is a three-way check per key: base (what was last applied or
7
+ * acknowledged), yours (the node now) and incoming (the node in the source).
8
+ * Nodes you haven't touched follow the source; nodes you edited stay yours,
9
+ * and when the source changed them too, the load writes a conflict node to
10
+ * review rather than choosing for you (ADR 0008: fix by detection and cleanup).
11
+ */
12
+ /** Where the last load is remembered, per starter namespace. Not a layered setting. */
13
+ const LOADED_SCOPE = 'starter';
14
+ const LOADED_KEY = 'starter.loaded';
15
+ export const CONFLICT_TYPE = 'conflict';
16
+ export const CONFLICTS_WITH = 'conflicts_with';
17
+ /** Reads `mcpdia-jsonl` text, checking the header before anything is written. */
18
+ export function parseExport(text) {
19
+ const lines = withoutBom(text)
20
+ .split('\n')
21
+ .filter((l) => l.trim());
22
+ const rows = lines.map((line, i) => {
23
+ try {
24
+ return JSON.parse(line);
25
+ }
26
+ catch {
27
+ throw new UserError(`Line ${i + 1} is not JSON.`, 'Starter sets are files written by mcpdia export.');
28
+ }
29
+ });
30
+ const header = rows[0];
31
+ if (header?.kind !== 'header' || header.format !== 'mcpdia-jsonl') {
32
+ throw new UserError('Not an mcpdia export: the first line is not an mcpdia-jsonl header.');
33
+ }
34
+ if (typeof header.version !== 'number' || header.version > EXPORT_FORMAT_VERSION) {
35
+ throw new UserError(`Export format version ${String(header.version)} is newer than this MCPdia reads (${EXPORT_FORMAT_VERSION}).`, 'Update MCPdia.');
36
+ }
37
+ const nodes = rows.filter((r) => r.kind === 'node');
38
+ const edges = rows.filter((r) => r.kind === 'edge');
39
+ const seen = new Set();
40
+ for (const n of nodes) {
41
+ if (seen.has(n.key)) {
42
+ throw new UserError(`The export has ${n.key} twice, so it spans several namespaces.`, 'Export one namespace for a starter set: mcpdia export --namespace <ns>.');
43
+ }
44
+ seen.add(n.key);
45
+ }
46
+ return { header: header, nodes, edges };
47
+ }
48
+ export async function lastLoaded(store, namespace) {
49
+ const rows = await store.getSettings([namespace], LOADED_KEY);
50
+ return rows.find((r) => r.scope === LOADED_SCOPE)?.value;
51
+ }
52
+ /** The conflict node for a key: one per node, whatever the version. */
53
+ export function conflictKey(nodeKey) {
54
+ return `${CONFLICT_TYPE}/${nodeKey}`;
55
+ }
56
+ /** Editors on Windows often start a UTF-8 file with a byte-order mark. */
57
+ function withoutBom(text) {
58
+ return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
59
+ }
60
+ /**
61
+ * Brings `namespace` up to date with the export in `text`. Ends that were in
62
+ * the export's own namespaces move to `namespace`; links to anywhere else keep
63
+ * their namespace and resolve whenever that node exists (ADR 0007).
64
+ */
65
+ export async function loadStarter(store, namespace, source, text) {
66
+ const result = {
67
+ namespace,
68
+ unchanged: false,
69
+ nodes: 0,
70
+ created: 0,
71
+ updated: 0,
72
+ deleted: 0,
73
+ kept: 0,
74
+ edgesAdded: 0,
75
+ edgesRemoved: 0,
76
+ conflicts: [],
77
+ };
78
+ const before = await lastLoaded(store, namespace);
79
+ const { header, nodes, edges } = parseExport(text);
80
+ const hash = contentHash(withoutBom(text));
81
+ result.nodes = nodes.length;
82
+ if (before?.hash === hash) {
83
+ return { ...result, unchanged: true, conflicts: await openConflicts(store, namespace) };
84
+ }
85
+ const existing = new Map((await store.listNodes([namespace])).map((n) => [n.key, n]));
86
+ // A first load that stopped halfway leaves only the set's own rows, which are fine to finish.
87
+ if (!before && [...existing.values()].some((n) => n.source !== `starter:${namespace}`)) {
88
+ throw new UserError(`Namespace ${namespace} already has nodes that didn't come from a starter set.`, 'Load the set under another name.');
89
+ }
90
+ const fromSet = new Set(header.namespaces);
91
+ const moved = (ns) => (fromSet.has(ns) ? namespace : ns);
92
+ const by = `starter:${namespace}`;
93
+ const base = { ...before?.nodes };
94
+ const fresh = [];
95
+ /** The version this set last applied for a key, or undefined for nodes it never loaded. */
96
+ const lastFor = (node) => base[node.key] ?? (node.source === by && node.updatedBy === by ? versionHash(node) : undefined);
97
+ const idByOldId = new Map();
98
+ /** Nodes whose status should follow the source, set once every node exists. */
99
+ const follow = [];
100
+ for (const incoming of nodes) {
101
+ const theirs = versionHash(incoming);
102
+ let node = existing.get(incoming.key);
103
+ if (!node) {
104
+ node = await store.createNode({
105
+ ...nodeFields(incoming),
106
+ namespace,
107
+ key: incoming.key,
108
+ source: by,
109
+ author: incoming.author,
110
+ });
111
+ result.created++;
112
+ follow.push([node, incoming]);
113
+ base[incoming.key] = theirs;
114
+ }
115
+ else {
116
+ const yours = versionHash(node);
117
+ const last = lastFor(node);
118
+ if (yours === theirs) {
119
+ base[incoming.key] = theirs;
120
+ }
121
+ else if (last === theirs) {
122
+ result.kept++;
123
+ }
124
+ else if (last === yours) {
125
+ node = await store.updateNode(node.id, nodeFields(incoming), by);
126
+ result.updated++;
127
+ follow.push([node, incoming]);
128
+ base[incoming.key] = theirs;
129
+ }
130
+ else {
131
+ const entry = await writeConflict(store, namespace, by, node, incoming, theirs);
132
+ // A conflict you already resolved for this version counts as acknowledged.
133
+ if (entry)
134
+ fresh.push(entry);
135
+ else
136
+ base[incoming.key] = theirs;
137
+ }
138
+ }
139
+ idByOldId.set(incoming.id, node.id);
140
+ }
141
+ for (const [node, incoming] of follow) {
142
+ const supersededBy = incoming.supersededBy ? idByOldId.get(incoming.supersededBy) : undefined;
143
+ if (node.status !== incoming.status || (supersededBy && node.supersededBy !== supersededBy)) {
144
+ await store.setStatus(node.id, incoming.status, by, supersededBy);
145
+ }
146
+ }
147
+ // Gone from the source: follow it if you never touched the node, otherwise ask.
148
+ // Nodes you added to this namespace yourself were never in the set, so they're left alone.
149
+ const inSource = new Set(nodes.map((n) => n.key));
150
+ for (const node of existing.values()) {
151
+ if (inSource.has(node.key) || node.type === CONFLICT_TYPE || node.status === 'deleted')
152
+ continue;
153
+ if (!(node.key in base) && node.source !== by)
154
+ continue;
155
+ const last = lastFor(node);
156
+ if (last === versionHash(node)) {
157
+ await store.setStatus(node.id, 'deleted', by);
158
+ result.deleted++;
159
+ delete base[node.key];
160
+ }
161
+ else {
162
+ // Tied to the version removed, so a node that comes back and goes again asks again.
163
+ const entry = await writeConflict(store, namespace, by, node, null, `${REMOVED}:${last ?? ''}`);
164
+ if (entry)
165
+ fresh.push(entry);
166
+ }
167
+ }
168
+ // Links: add the set's, and remove only ones the set wrote before.
169
+ const wantedEdges = new Set();
170
+ for (const e of edges) {
171
+ const edge = {
172
+ fromNamespace: moved(e.fromNamespace),
173
+ fromKey: e.fromKey,
174
+ toNamespace: moved(e.toNamespace),
175
+ toKey: e.toKey,
176
+ type: e.type,
177
+ note: e.note,
178
+ source: by,
179
+ author: e.author,
180
+ };
181
+ wantedEdges.add(edgeKey(edge));
182
+ if ((await store.upsertEdge(edge)).created)
183
+ result.edgesAdded++;
184
+ }
185
+ const ours = new Set(before?.edges ?? []);
186
+ for (const e of await store.listEdges([namespace])) {
187
+ const key = edgeKey(e);
188
+ if (ours.has(key) && !wantedEdges.has(key)) {
189
+ await store.deleteEdge(e.id);
190
+ result.edgesRemoved++;
191
+ }
192
+ }
193
+ const loaded = {
194
+ hash,
195
+ source,
196
+ loadedAt: new Date().toISOString(),
197
+ nodes: base,
198
+ edges: [...wantedEdges],
199
+ };
200
+ await store.putSetting(namespace, LOADED_SCOPE, LOADED_KEY, loaded);
201
+ const freshKeys = new Set(fresh.map((c) => c.key));
202
+ const stillOpen = (await openConflicts(store, namespace)).filter((c) => !freshKeys.has(c.key));
203
+ return { ...result, conflicts: [...fresh, ...stillOpen] };
204
+ }
205
+ /** Stands in for the incoming version when the source dropped the node. */
206
+ const REMOVED = 'removed';
207
+ /**
208
+ * Writes or refreshes the one conflict node for `node`. Returns undefined when
209
+ * a conflict for this exact incoming version was already resolved (deleted),
210
+ * so a resolved conflict stays resolved until the source changes again.
211
+ */
212
+ async function writeConflict(store, namespace, by, node, incoming, incomingHash) {
213
+ const key = conflictKey(node.key);
214
+ const fields = {
215
+ type: CONFLICT_TYPE,
216
+ title: `Conflict: ${incoming?.title ?? node.title}`,
217
+ summary: incoming
218
+ ? `The starter set changed ${node.key} after you edited it. Compare, keep what's right, then delete this node.`
219
+ : `The starter set removed ${node.key}, which you edited. Keep it or delete it, then delete this node.`,
220
+ body: incoming ? conflictBody(incoming) : 'Removed upstream.',
221
+ properties: { starter: namespace, node_key: node.key, incoming_hash: incomingHash },
222
+ aliases: [],
223
+ tags: [CONFLICT_TYPE],
224
+ };
225
+ const current = await store.getNode(namespace, key);
226
+ let state;
227
+ if (!current) {
228
+ await store.createNode({ ...fields, namespace, key, source: by, author: by });
229
+ state = 'new';
230
+ }
231
+ else if (current.properties.incoming_hash === incomingHash) {
232
+ if (current.status === 'deleted')
233
+ return undefined;
234
+ state = 'open';
235
+ }
236
+ else {
237
+ await store.updateNode(current.id, fields, by);
238
+ if (current.status === 'deleted')
239
+ await store.setStatus(current.id, 'active', by);
240
+ state = current.status === 'deleted' ? 'reopened' : 'updated';
241
+ }
242
+ await store.upsertEdge({
243
+ fromNamespace: namespace,
244
+ fromKey: key,
245
+ toNamespace: node.namespace,
246
+ toKey: node.key,
247
+ type: CONFLICTS_WITH,
248
+ note: null,
249
+ source: by,
250
+ author: by,
251
+ });
252
+ return { key, nodeKey: node.key, state };
253
+ }
254
+ /** The incoming version, laid out so a model can compare it with yours. */
255
+ function conflictBody(n) {
256
+ return [
257
+ `Incoming title: ${n.title}`,
258
+ n.summary && `Incoming summary: ${n.summary}`,
259
+ n.tags?.length && `Incoming tags: ${n.tags.join(', ')}`,
260
+ n.status !== 'active' && `Incoming status: ${n.status}`,
261
+ n.body && `Incoming body:\n${n.body}`,
262
+ ]
263
+ .filter(Boolean)
264
+ .join('\n');
265
+ }
266
+ async function openConflicts(store, namespace) {
267
+ return (await store.listNodes([namespace]))
268
+ .filter((n) => n.type === CONFLICT_TYPE && n.status === 'active')
269
+ .map((n) => ({ key: n.key, nodeKey: String(n.properties.node_key ?? ''), state: 'open' }));
270
+ }
271
+ function edgeKey(e) {
272
+ return JSON.stringify([e.fromNamespace, e.fromKey, e.toNamespace, e.toKey, e.type]);
273
+ }
274
+ /** Hash of the export without its timestamp, so a fresh export of the same graph counts as unchanged. */
275
+ function contentHash(text) {
276
+ const lines = text.split('\n').filter((l) => l.trim());
277
+ const { exportedAt: _, ...header } = JSON.parse(lines[0]);
278
+ return createHash('sha256').update(JSON.stringify(header)).update(lines.slice(1).join('\n')).digest('hex');
279
+ }
280
+ /**
281
+ * A node's content: fields and status, never ids or timestamps. The replacing
282
+ * node is named by key presence only, since ids differ between graphs.
283
+ */
284
+ function versionHash(n) {
285
+ const status = n.status;
286
+ return createHash('sha256')
287
+ .update(stable({ ...nodeFields(n), status, superseded: Boolean(n.supersededBy) }))
288
+ .digest('hex')
289
+ .slice(0, 16);
290
+ }
291
+ function nodeFields(n) {
292
+ return {
293
+ type: n.type,
294
+ title: n.title,
295
+ summary: n.summary ?? null,
296
+ body: n.body ?? null,
297
+ properties: n.properties ?? {},
298
+ aliases: [...(n.aliases ?? [])].sort(),
299
+ tags: [...(n.tags ?? [])].sort(),
300
+ };
301
+ }
302
+ /** JSON with object keys sorted, so key order doesn't count as a change. */
303
+ function stable(value) {
304
+ return JSON.stringify(value, (_, v) => v && typeof v === 'object' && !Array.isArray(v)
305
+ ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => a.localeCompare(b)))
306
+ : v);
307
+ }
308
+ //# sourceMappingURL=starters.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"starters.js","sourceRoot":"","sources":["../../src/core/starters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAqB,MAAM,aAAa,CAAC;AAEvE;;;;;;;GAOG;AAEH,uFAAuF;AACvF,MAAM,YAAY,GAAG,SAAS,CAAC;AAC/B,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAEpC,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AA0C/C,iFAAiF;AACjF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC;SAC3B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,kDAAkD,CAAC,CAAC;QACxG,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAsC,CAAC;IAC5D,IAAI,MAAM,EAAE,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,qEAAqE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,GAAG,qBAAqB,EAAE,CAAC;QACjF,MAAM,IAAI,SAAS,CACjB,yBAAyB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,qCAAqC,qBAAqB,IAAI,EAC7G,gBAAgB,CACjB,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAA4B,CAAC;IAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAA4B,CAAC;IAC/E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,SAAS,CACjB,kBAAkB,CAAC,CAAC,GAAG,yCAAyC,EAChE,yEAAyE,CAC1E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAsB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAiB,EAAE,SAAiB;IACnE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,YAAY,CAAC,EAAE,KAAkC,CAAC;AACxF,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,GAAG,aAAa,IAAI,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,0EAA0E;AAC1E,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAiB,EACjB,SAAiB,EACjB,MAAc,EACd,IAAY;IAEZ,MAAM,MAAM,GAAe;QACzB,SAAS;QACT,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,CAAC;QACP,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,EAAE;KACd,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,MAAM,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC1F,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,8FAA8F;IAC9F,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,SAAS,EAAE,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,SAAS,CACjB,aAAa,SAAS,yDAAyD,EAC/E,kCAAkC,CACnC,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,WAAW,SAAS,EAAE,CAAC;IAClC,MAAM,IAAI,GAA2B,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,2FAA2F;IAC3F,MAAM,OAAO,GAAG,CAAC,IAAgB,EAAE,EAAE,CACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,IAAI,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAElG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,+EAA+E;IAC/E,MAAM,MAAM,GAA+B,EAAE,CAAC;IAE9C,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC;gBAC5B,GAAG,UAAU,CAAC,QAAQ,CAAC;gBACvB,SAAS;gBACT,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC,CAAC;YACH,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YAC9B,CAAC;iBAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,CAAC;iBAAM,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC1B,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjE,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAChF,2EAA2E;gBAC3E,IAAI,KAAK;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;oBACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACnC,CAAC;QACH,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9F,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,KAAK,YAAY,CAAC,EAAE,CAAC;YAC5F,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,2FAA2F;IAC3F,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACrC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,SAAS;QACjG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE;YAAE,SAAS;QACxD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAC9C,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,oFAAoF;YACpF,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;YAChG,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,GAAY;YACpB,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC;YACrC,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;YACjC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC;QACF,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAClE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7B,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAkB;QAC5B,IAAI;QACJ,MAAM;QACN,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAClC,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC;KACxB,CAAC;IACF,MAAM,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEpE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,CAAC,MAAM,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/F,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,KAAK,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,2EAA2E;AAC3E,MAAM,OAAO,GAAG,SAAS,CAAC;AAE1B;;;;GAIG;AACH,KAAK,UAAU,aAAa,CAC1B,KAAiB,EACjB,SAAiB,EACjB,EAAU,EACV,IAAgB,EAChB,QAA2B,EAC3B,YAAoB;IAEpB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,MAAM,GAAe;QACzB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa,QAAQ,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;QACnD,OAAO,EAAE,QAAQ;YACf,CAAC,CAAC,2BAA2B,IAAI,CAAC,GAAG,0EAA0E;YAC/G,CAAC,CAAC,2BAA2B,IAAI,CAAC,GAAG,kEAAkE;QACzG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,mBAAmB;QAC7D,UAAU,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE;QACnF,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,CAAC,aAAa,CAAC;KACtB,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,KAA6B,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9E,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;SAAM,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,KAAK,YAAY,EAAE,CAAC;QAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACnD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClF,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;IACD,MAAM,KAAK,CAAC,UAAU,CAAC;QACrB,aAAa,EAAE,SAAS;QACxB,OAAO,EAAE,GAAG;QACZ,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,KAAK,EAAE,IAAI,CAAC,GAAG;QACf,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;KACX,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC;AAED,2EAA2E;AAC3E,SAAS,YAAY,CAAC,CAAa;IACjC,OAAO;QACL,mBAAmB,CAAC,CAAC,KAAK,EAAE;QAC5B,CAAC,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC,OAAO,EAAE;QAC7C,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACvD,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,oBAAoB,CAAC,CAAC,MAAM,EAAE;QACvD,CAAC,CAAC,IAAI,IAAI,mBAAmB,CAAC,CAAC,IAAI,EAAE;KACtC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,KAAiB,EAAE,SAAiB;IAC/D,OAAO,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;SACxC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;SAChE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAe,EAAE,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,OAAO,CAAC,CAA+F;IAC9G,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,yGAAyG;AACzG,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAiB,CAAC;IAC3E,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7G,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,CAAa;IAChC,MAAM,MAAM,GAAe,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;SACjF,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,CAAa;IAC/B,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;QAC1B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;QACpB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;QAC9B,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;QACtC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAU,EAAE,EAAE,CAC7C,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAA4B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACzG,CAAC,CAAC,CAAC,CACN,CAAC;AACJ,CAAC"}
@@ -0,0 +1,24 @@
1
+ import { squashType, STARTER_EDGE_TYPES, STARTER_NODE_TYPES } from './vocabulary.js';
2
+ /** The vocabulary in use, with counts, so writers reuse types instead of inventing near-duplicates. */
3
+ export async function listTypes(ctx, store) {
4
+ const stats = await store.stats(ctx.namespaces);
5
+ const usedNode = new Set(stats.nodeTypes.map((t) => t.name));
6
+ const usedEdge = new Set(stats.edgeTypes.map((t) => t.name));
7
+ return {
8
+ nodeTypes: stats.nodeTypes,
9
+ edgeTypes: stats.edgeTypes,
10
+ unusedNodeStarters: STARTER_NODE_TYPES.filter((t) => !usedNode.has(t)),
11
+ unusedEdgeStarters: STARTER_EDGE_TYPES.filter((t) => !usedEdge.has(t)),
12
+ lookalikes: [...pairs([...usedNode]), ...pairs([...usedEdge])],
13
+ };
14
+ }
15
+ function pairs(names) {
16
+ const out = [];
17
+ names.forEach((a, i) => {
18
+ for (const b of names.slice(i + 1))
19
+ if (squashType(a) === squashType(b))
20
+ out.push([a, b]);
21
+ });
22
+ return out;
23
+ }
24
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAYrF,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAY,EAAE,KAAiB;IAC7D,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,kBAAkB,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtE,kBAAkB,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtE,UAAU,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAAe;IAC5B,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;YAAE,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,131 @@
1
+ import { VersionConflictError } from '../store/GraphStore.js';
2
+ import { UserError } from './errors.js';
3
+ import { cleanKey, displayKey, parseRef, suggestKey, uniqueKey } from './keys.js';
4
+ import { link, linkTarget } from './link.js';
5
+ import { findNode, supersededByKey, writableNamespace } from './nodes.js';
6
+ import { normalizeAlias, normalizeEdgeType, normalizeNodeType, normalizeTag, PARENT_EDGE_TYPES, STARTER_NODE_TYPES, } from './vocabulary.js';
7
+ /** Writes the node, then its links, the same as calling upsert and then link for each. */
8
+ export async function upsert(ctx, store, input) {
9
+ const links = input.links ?? [];
10
+ // Check the links before writing anything, so a bad one doesn't leave a half-done write.
11
+ for (const l of links) {
12
+ if (!normalizeEdgeType(l.type))
13
+ throw new UserError('A link type is empty.');
14
+ if (!l.to.trim())
15
+ throw new UserError('A link target is empty.');
16
+ await linkTarget(ctx, store, l.to);
17
+ }
18
+ const out = await writeNode(ctx, store, input);
19
+ // Link from the saved node's id: a displayed key can read back as a different namespace or as an id.
20
+ const written = [];
21
+ for (const l of links)
22
+ written.push(await link(ctx, store, { from: out.node.id, to: l.to, type: l.type, note: l.note }));
23
+ const hasParent = written.some((l) => PARENT_EDGE_TYPES.includes(l.edge.type));
24
+ const parentHint = out.created && !hasParent ? parentHintFor(ctx, out.node) : undefined;
25
+ const summaryHint = out.created && !out.node.summary
26
+ ? 'No summary: search shows only the title, so add a one-line summary if you can.'
27
+ : undefined;
28
+ return { ...out, links: written, parentHint, summaryHint };
29
+ }
30
+ /**
31
+ * Points out a missing parent. It names no candidate: a guess from recent
32
+ * writes is often wrong, and the model can search if it needs to.
33
+ */
34
+ function parentHintFor(ctx, node) {
35
+ const shown = displayKey(ctx, node.namespace, node.key);
36
+ return `${shown} has no parent. Most nodes sit under something, so this is probably not right; link it with part_of unless it starts something new.`;
37
+ }
38
+ /** The node part of upsert, without links or hints. Also used by supersede. */
39
+ export async function writeNode(ctx, store, input) {
40
+ const type = normalizeNodeType(input.type);
41
+ if (!type)
42
+ throw new UserError('type is empty.');
43
+ const title = input.title.trim();
44
+ if (!title)
45
+ throw new UserError('title is empty.');
46
+ const fields = {
47
+ type,
48
+ title,
49
+ summary: input.summary?.trim() || null,
50
+ body: input.body ?? null,
51
+ properties: input.properties ?? {},
52
+ aliases: unique((input.aliases ?? []).map(normalizeAlias)),
53
+ tags: unique((input.tags ?? []).map(normalizeTag)),
54
+ };
55
+ const typeHint = await typeSuggestion(ctx, store, type);
56
+ if (input.key !== undefined) {
57
+ const ref = parseRef(ctx, cleanKey(input.key));
58
+ const existing = await findNode(ctx, store, ref);
59
+ if (existing) {
60
+ const node = await update(ctx, store, existing, input, fields);
61
+ const removed = input.properties
62
+ ? Object.keys(existing.properties).filter((k) => !Object.hasOwn(fields.properties, k))
63
+ : [];
64
+ return {
65
+ node,
66
+ created: false,
67
+ // The node already had this type; it only looks new because the node was deleted.
68
+ typeHint: existing.type === type ? undefined : typeHint,
69
+ restored: existing.status === 'deleted' || undefined,
70
+ removedProperties: removed.length ? removed : undefined,
71
+ };
72
+ }
73
+ if (ref.kind === 'id')
74
+ throw new UserError(`Not found: ${ref.id}.`, 'Pass a key to create a node.');
75
+ const namespace = writableNamespace(ctx, ref);
76
+ if (!ref.key)
77
+ throw new UserError('key is empty.');
78
+ const node = await store.createNode({ ...fields, namespace, key: ref.key, source: 'local', author: ctx.caller });
79
+ return { node, created: true, typeHint };
80
+ }
81
+ // No key: build one from the title, and stop short of writing over a node that looks like the same thing.
82
+ const namespace = ctx.writeNamespace;
83
+ const base = suggestKey(type, title);
84
+ const clash = await store.getNode(namespace, base);
85
+ if (clash?.status === 'active') {
86
+ throw new UserError(`${displayKey(ctx, namespace, base)} already exists: "${clash.title}".`, `To update it, pass key: ${displayKey(ctx, namespace, base)}. To add a separate node, pass a different key.`);
87
+ }
88
+ const key = await uniqueKey(base, async (k) => (await store.getNode(namespace, k)) !== null);
89
+ const node = await store.createNode({ ...fields, namespace, key, source: 'local', author: ctx.caller });
90
+ return { node, created: true, typeHint };
91
+ }
92
+ async function update(ctx, store, existing, input, fields) {
93
+ const shown = displayKey(ctx, existing.namespace, existing.key);
94
+ if (existing.status === 'superseded') {
95
+ const next = await supersededByKey(ctx, store, existing);
96
+ throw new UserError(`${shown} is superseded${next ? ` by ${next}` : ''}.`, next ? `Update ${next} instead.` : undefined);
97
+ }
98
+ // Only what the caller passed changes; type and title are always passed.
99
+ const patch = { type: fields.type, title: fields.title };
100
+ if (input.summary !== undefined)
101
+ patch.summary = fields.summary;
102
+ if (input.body !== undefined)
103
+ patch.body = fields.body;
104
+ if (input.properties !== undefined)
105
+ patch.properties = fields.properties;
106
+ if (input.aliases !== undefined)
107
+ patch.aliases = fields.aliases;
108
+ if (input.tags !== undefined)
109
+ patch.tags = fields.tags;
110
+ try {
111
+ const node = await store.updateNode(existing.id, patch, ctx.caller, input.version);
112
+ // Writing to a deleted key brings that node back, history and all, rather than starting a second one.
113
+ return existing.status === 'deleted' ? await store.setStatus(existing.id, 'active', ctx.caller) : node;
114
+ }
115
+ catch (err) {
116
+ if (err instanceof VersionConflictError) {
117
+ throw new UserError(`${shown} changed: it is at v${err.current.version}, not v${input.version}.`, 'get it again and re-apply your change.');
118
+ }
119
+ throw err;
120
+ }
121
+ }
122
+ async function typeSuggestion(ctx, store, type) {
123
+ const used = (await store.stats(ctx.namespaces)).nodeTypes.map((t) => t.name);
124
+ if (used.includes(type) || STARTER_NODE_TYPES.includes(type))
125
+ return undefined;
126
+ return `Type "${type}" is new here. list_types shows the types in use.`;
127
+ }
128
+ function unique(values) {
129
+ return [...new Set(values.filter(Boolean))];
130
+ }
131
+ //# sourceMappingURL=upsert.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upsert.js","sourceRoot":"","sources":["../../src/core/upsert.ts"],"names":[],"mappings":"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"}