@mfdaves/okf-mcp 0.9.1 → 0.13.0-rc.1

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 (115) hide show
  1. package/CHANGELOG.md +100 -0
  2. package/README.md +452 -26
  3. package/bin/okf-mcp.js +6 -1
  4. package/okf/okf-mcp/distribution/reference-bundle.md +10 -3
  5. package/okf/okf-mcp/index.md +2 -1
  6. package/okf/okf-mcp/interfaces/http-authoring-api.md +11 -2
  7. package/okf/okf-mcp/interfaces/mcp-http.md +64 -0
  8. package/okf/okf-mcp/interfaces/mcp-tools.md +25 -6
  9. package/okf/okf-mcp/overview/okf-mcp.md +16 -6
  10. package/okf/okf-mcp/policies/authoring-safety.md +28 -5
  11. package/okf/okf-mcp/runtime/indexer.md +14 -1
  12. package/okf/okf-mcp/runtime/mcp-server.md +16 -8
  13. package/okf/okf-mcp/specs/producer-api.md +16 -2
  14. package/package.json +17 -5
  15. package/server.json +38 -2
  16. package/src/assets.js +165 -73
  17. package/src/authoring/candidates.js +434 -0
  18. package/src/authoring/git-preflight.js +225 -0
  19. package/src/authoring/git-publish.js +783 -0
  20. package/src/authoring/live.js +757 -0
  21. package/src/authoring/paths.js +112 -0
  22. package/src/authoring/policy-hook.js +221 -0
  23. package/src/authoring/proposal-policy.js +159 -0
  24. package/src/authoring/receipts.js +373 -0
  25. package/src/authoring/render.js +38 -0
  26. package/src/authoring/shared.js +75 -0
  27. package/src/authoring/staging.js +216 -0
  28. package/src/authoring.js +386 -287
  29. package/src/cache/files.js +147 -0
  30. package/src/cache/lock.js +201 -0
  31. package/src/cache/paths.js +197 -0
  32. package/src/cache/store.js +703 -0
  33. package/src/catalog-text.js +19 -0
  34. package/src/cli/commands.js +448 -0
  35. package/src/cli/http-options.js +193 -0
  36. package/src/cli/options.js +554 -0
  37. package/src/cli/usage.js +96 -0
  38. package/src/cli.js +18 -932
  39. package/src/computation.js +99 -61
  40. package/src/context/assemble.js +567 -0
  41. package/src/context/cli-options.js +88 -0
  42. package/src/context/score.js +234 -0
  43. package/src/context/sections.js +274 -0
  44. package/src/embed/interface.js +160 -0
  45. package/src/embed/openai.js +715 -0
  46. package/src/embed/prepare.js +182 -0
  47. package/src/embed/units.js +96 -0
  48. package/src/error-details.js +53 -0
  49. package/src/git-source.js +112 -52
  50. package/src/graph.js +95 -37
  51. package/src/http-server.js +36 -17
  52. package/src/index.js +15 -0
  53. package/src/indexer/assemble.js +566 -0
  54. package/src/indexer/build.js +290 -0
  55. package/src/indexer/cache.js +81 -0
  56. package/src/indexer/edges.js +430 -0
  57. package/src/indexer/index.js +44 -0
  58. package/src/indexer/paths.js +178 -0
  59. package/src/indexer/resolve.js +282 -0
  60. package/src/indexer/update.js +720 -0
  61. package/src/indexer.js +3 -1068
  62. package/src/live-authoring.js +4 -2329
  63. package/src/markdown.js +21 -16
  64. package/src/mcp/auth.js +409 -0
  65. package/src/mcp/http.js +317 -0
  66. package/src/mcp/principal.js +59 -0
  67. package/src/mcp/registry.js +356 -0
  68. package/src/mcp/resources.js +45 -0
  69. package/src/mcp/server.js +567 -0
  70. package/src/mcp/tools/catalog.js +247 -0
  71. package/src/mcp/tools/computation.js +83 -0
  72. package/src/mcp/tools/context.js +133 -0
  73. package/src/mcp/tools/graph.js +167 -0
  74. package/src/mcp/tools/live-authoring.js +316 -0
  75. package/src/mcp/tools/migration.js +86 -0
  76. package/src/mcp/tools/producers.js +79 -0
  77. package/src/mcp/tools/proposals.js +225 -0
  78. package/src/mcp/tools/provenance.js +87 -0
  79. package/src/mcp/tools/remote.js +79 -0
  80. package/src/mcp/tools/search.js +242 -0
  81. package/src/mcp-server.js +3 -1611
  82. package/src/migration.js +431 -253
  83. package/src/parser.js +245 -130
  84. package/src/plugins.js +71 -48
  85. package/src/policy/write-policy.js +713 -0
  86. package/src/producer-publisher.js +202 -78
  87. package/src/producers.js +311 -103
  88. package/src/project.js +346 -93
  89. package/src/remote.js +96 -61
  90. package/src/search/cli-options.js +107 -0
  91. package/src/search/confidence.js +61 -0
  92. package/src/search/dense.js +304 -0
  93. package/src/search/embedding-cli.js +57 -0
  94. package/src/search/embedding-config.js +217 -0
  95. package/src/search/fusion.js +249 -0
  96. package/src/search/hybrid.js +526 -0
  97. package/src/search/languages.js +200 -0
  98. package/src/search/lexical.js +695 -0
  99. package/src/search/query.js +620 -0
  100. package/src/search/stem/among.js +43 -0
  101. package/src/search/stem/base-stemmer.js +311 -0
  102. package/src/search/stem/en-regions.js +456 -0
  103. package/src/search/stem/en-suffixes.js +664 -0
  104. package/src/search/stem/en-tables.js +176 -0
  105. package/src/search/stem/en.js +238 -0
  106. package/src/search/stem/it-regions.js +459 -0
  107. package/src/search/stem/it-suffixes.js +471 -0
  108. package/src/search/stem/it-tables.js +257 -0
  109. package/src/search/stem/it.js +155 -0
  110. package/src/search-index.js +2 -81
  111. package/src/search.js +2 -252
  112. package/src/store.js +134 -81
  113. package/src/tool-packs.js +346 -0
  114. package/src/v02.js +301 -105
  115. package/src/validation.js +24 -20
package/src/validation.js CHANGED
@@ -1,9 +1,6 @@
1
1
  "use strict";
2
2
 
3
- const CONFORMANCE_WARNING_CODES = new Set([
4
- "missing_frontmatter",
5
- "missing_type",
6
- ]);
3
+ const CONFORMANCE_WARNING_CODES = new Set(["missing_frontmatter", "missing_type"]);
7
4
 
8
5
  const PROJECT_INVALID_WARNING_CODES = new Set([
9
6
  "invalid_id",
@@ -29,12 +26,16 @@ function diagnosticKey(entry) {
29
26
  }
30
27
 
31
28
  function normalizeDiagnostic(entry, defaults) {
32
- return Object.assign({
33
- code: "validation_diagnostic",
34
- severity: "warning",
35
- layer: "project",
36
- message: "",
37
- }, defaults || {}, entry || {});
29
+ return Object.assign(
30
+ {
31
+ code: "validation_diagnostic",
32
+ severity: "warning",
33
+ layer: "project",
34
+ message: "",
35
+ },
36
+ defaults || {},
37
+ entry || {},
38
+ );
38
39
  }
39
40
 
40
41
  function validateIndex(index, bundle) {
@@ -88,21 +89,21 @@ function validateIndex(index, bundle) {
88
89
  add(entry, {
89
90
  severity: "warning",
90
91
  layer: "project",
91
- invalidatesProject: PROJECT_INVALID_WARNING_CODES.has(entry.code)
92
- || (entry.code === "broken_link" && strictLinks),
92
+ invalidatesProject:
93
+ PROJECT_INVALID_WARNING_CODES.has(entry.code) ||
94
+ (entry.code === "broken_link" && strictLinks),
93
95
  });
94
96
  });
95
97
 
96
- const conformanceErrors = diagnostics.filter((entry) => (
97
- entry.layer === "conformance" && entry.severity === "error"
98
- ));
98
+ const conformanceErrors = diagnostics.filter(
99
+ (entry) => entry.layer === "conformance" && entry.severity === "error",
100
+ );
99
101
  const projectDiagnostics = diagnostics.filter((entry) => entry.layer === "project");
100
102
  const advisories = diagnostics.filter((entry) => entry.layer === "v0.2");
101
103
  const computations = documents.filter((doc) => doc.signals && doc.signals.computation);
102
104
  const conformant = conformanceErrors.length === 0;
103
- const validForProject = conformant
104
- && errors.length === 0
105
- && !diagnostics.some((entry) => entry.invalidatesProject);
105
+ const validForProject =
106
+ conformant && errors.length === 0 && !diagnostics.some((entry) => entry.invalidatesProject);
106
107
 
107
108
  return {
108
109
  conformant,
@@ -115,8 +116,11 @@ function validateIndex(index, bundle) {
115
116
  advisories,
116
117
  readiness: {
117
118
  attestedComputations: computations.length,
118
- attestationReady: computations.filter((doc) => doc.signals.computation.attestationReady).length,
119
- attestationNotReady: computations.filter((doc) => !doc.signals.computation.attestationReady).map((doc) => doc.uri),
119
+ attestationReady: computations.filter((doc) => doc.signals.computation.attestationReady)
120
+ .length,
121
+ attestationNotReady: computations
122
+ .filter((doc) => !doc.signals.computation.attestationReady)
123
+ .map((doc) => doc.uri),
120
124
  },
121
125
  errors,
122
126
  warnings,