@noodleseed/one 0.120.0 → 0.121.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 (416) hide show
  1. package/dist/commands/auth-ops.d.ts.map +1 -1
  2. package/dist/commands/auth-ops.js +1 -0
  3. package/dist/commands/auth-ops.js.map +1 -1
  4. package/dist/commands/catalog-data-bootstrap-authoring.d.ts.map +1 -1
  5. package/dist/commands/catalog-data-bootstrap-authoring.js +98 -189
  6. package/dist/commands/catalog-data-bootstrap-authoring.js.map +1 -1
  7. package/dist/commands/mcp-apps.d.ts.map +1 -1
  8. package/dist/commands/mcp-apps.js +1 -0
  9. package/dist/commands/mcp-apps.js.map +1 -1
  10. package/dist/commands/project-setup.d.ts.map +1 -1
  11. package/dist/commands/project-setup.js +25 -5
  12. package/dist/commands/project-setup.js.map +1 -1
  13. package/dist/delegated-token-exchange-preflight.d.ts.map +1 -1
  14. package/dist/delegated-token-exchange-preflight.js +1 -0
  15. package/dist/delegated-token-exchange-preflight.js.map +1 -1
  16. package/dist/deploy.d.ts.map +1 -1
  17. package/dist/deploy.js +8 -131
  18. package/dist/deploy.js.map +1 -1
  19. package/dist/index.d.ts +1 -3
  20. package/dist/index.d.ts.map +1 -1
  21. package/dist/index.js +1 -1
  22. package/dist/index.js.map +1 -1
  23. package/dist/local-compile.d.ts.map +1 -1
  24. package/dist/local-compile.js +1 -0
  25. package/dist/local-compile.js.map +1 -1
  26. package/node_modules/@noodle-borg/agent-kit/dist/curated/error-fixes.d.ts.map +1 -1
  27. package/node_modules/@noodle-borg/agent-kit/dist/curated/error-fixes.js +2 -0
  28. package/node_modules/@noodle-borg/agent-kit/dist/curated/error-fixes.js.map +1 -1
  29. package/node_modules/@noodle-borg/agent-kit/dist/generated/example-files.d.ts.map +1 -1
  30. package/node_modules/@noodle-borg/agent-kit/dist/generated/example-files.js +7 -5
  31. package/node_modules/@noodle-borg/agent-kit/dist/generated/example-files.js.map +1 -1
  32. package/node_modules/@noodle-borg/agent-kit/dist/generated/surface.d.ts.map +1 -1
  33. package/node_modules/@noodle-borg/agent-kit/dist/generated/surface.js +5 -0
  34. package/node_modules/@noodle-borg/agent-kit/dist/generated/surface.js.map +1 -1
  35. package/node_modules/@noodle-borg/agent-kit/dist/plugin-submission.js +1 -1
  36. package/node_modules/@noodle-borg/agent-kit/dist/plugin-submission.js.map +1 -1
  37. package/node_modules/@noodle-borg/agent-kit/dist/product-skill-ownership.d.ts.map +1 -1
  38. package/node_modules/@noodle-borg/agent-kit/dist/product-skill-ownership.js +5 -3
  39. package/node_modules/@noodle-borg/agent-kit/dist/product-skill-ownership.js.map +1 -1
  40. package/node_modules/@noodle-borg/agent-kit/dist/skill-authoring-refs.d.ts.map +1 -1
  41. package/node_modules/@noodle-borg/agent-kit/dist/skill-authoring-refs.js +20 -0
  42. package/node_modules/@noodle-borg/agent-kit/dist/skill-authoring-refs.js.map +1 -1
  43. package/node_modules/@noodle-borg/agent-kit/dist/skill-operations-refs.d.ts.map +1 -1
  44. package/node_modules/@noodle-borg/agent-kit/dist/skill-operations-refs.js +5 -1
  45. package/node_modules/@noodle-borg/agent-kit/dist/skill-operations-refs.js.map +1 -1
  46. package/node_modules/@noodle-borg/agent-packaging/dist/host-package-assets.d.ts +2 -1
  47. package/node_modules/@noodle-borg/agent-packaging/dist/host-package-assets.d.ts.map +1 -1
  48. package/node_modules/@noodle-borg/agent-packaging/dist/host-package-assets.js +11 -1
  49. package/node_modules/@noodle-borg/agent-packaging/dist/host-package-assets.js.map +1 -1
  50. package/node_modules/@noodle-borg/agent-packaging/dist/host-packaging-types.d.ts +16 -3
  51. package/node_modules/@noodle-borg/agent-packaging/dist/host-packaging-types.d.ts.map +1 -1
  52. package/node_modules/@noodle-borg/agent-packaging/dist/host-packaging-validation.d.ts.map +1 -1
  53. package/node_modules/@noodle-borg/agent-packaging/dist/host-packaging-validation.js +13 -4
  54. package/node_modules/@noodle-borg/agent-packaging/dist/host-packaging-validation.js.map +1 -1
  55. package/node_modules/@noodle-borg/agent-packaging/dist/index.d.ts +1 -0
  56. package/node_modules/@noodle-borg/agent-packaging/dist/index.d.ts.map +1 -1
  57. package/node_modules/@noodle-borg/agent-packaging/dist/index.js +1 -0
  58. package/node_modules/@noodle-borg/agent-packaging/dist/index.js.map +1 -1
  59. package/node_modules/@noodle-borg/agent-packaging/dist/product-skill-validation.d.ts.map +1 -1
  60. package/node_modules/@noodle-borg/agent-packaging/dist/product-skill-validation.js +4 -3
  61. package/node_modules/@noodle-borg/agent-packaging/dist/product-skill-validation.js.map +1 -1
  62. package/node_modules/@noodle-borg/assistant-gateway/package.json +1 -1
  63. package/node_modules/@noodle-borg/authoring/dist/assistant.d.ts +4 -3
  64. package/node_modules/@noodle-borg/authoring/dist/assistant.d.ts.map +1 -1
  65. package/node_modules/@noodle-borg/authoring/dist/assistant.js.map +1 -1
  66. package/node_modules/@noodle-borg/authoring/dist/distribution.d.ts +17 -3
  67. package/node_modules/@noodle-borg/authoring/dist/distribution.d.ts.map +1 -1
  68. package/node_modules/@noodle-borg/authoring/dist/distribution.js.map +1 -1
  69. package/node_modules/@noodle-borg/authoring/dist/index.d.ts +2 -1
  70. package/node_modules/@noodle-borg/authoring/dist/index.d.ts.map +1 -1
  71. package/node_modules/@noodle-borg/authoring/dist/index.js +1 -0
  72. package/node_modules/@noodle-borg/authoring/dist/index.js.map +1 -1
  73. package/node_modules/@noodle-borg/authoring/dist/knowledge.d.ts +70 -0
  74. package/node_modules/@noodle-borg/authoring/dist/knowledge.d.ts.map +1 -0
  75. package/node_modules/@noodle-borg/authoring/dist/knowledge.js +50 -0
  76. package/node_modules/@noodle-borg/authoring/dist/knowledge.js.map +1 -0
  77. package/node_modules/@noodle-borg/authoring/dist/load-authored.d.ts +24 -0
  78. package/node_modules/@noodle-borg/authoring/dist/load-authored.d.ts.map +1 -0
  79. package/node_modules/@noodle-borg/authoring/dist/load-authored.js +141 -0
  80. package/node_modules/@noodle-borg/authoring/dist/load-authored.js.map +1 -0
  81. package/node_modules/@noodle-borg/authoring/dist/react/components.d.ts +3 -3
  82. package/node_modules/@noodle-borg/authoring/dist/react/native-components.d.ts +2 -2
  83. package/node_modules/@noodle-borg/authoring/dist/server.d.ts +3 -0
  84. package/node_modules/@noodle-borg/authoring/dist/server.d.ts.map +1 -1
  85. package/node_modules/@noodle-borg/authoring/dist/server.js +4 -0
  86. package/node_modules/@noodle-borg/authoring/dist/server.js.map +1 -1
  87. package/node_modules/@noodle-borg/authoring/package.json +5 -0
  88. package/node_modules/@noodle-borg/brand-kit/dist/index.d.ts +8 -0
  89. package/node_modules/@noodle-borg/brand-kit/dist/index.d.ts.map +1 -0
  90. package/node_modules/@noodle-borg/brand-kit/dist/index.js +8 -0
  91. package/node_modules/@noodle-borg/brand-kit/dist/index.js.map +1 -0
  92. package/node_modules/@noodle-borg/{compiler/dist/widget-palette.d.ts → brand-kit/dist/palette.d.ts} +1 -1
  93. package/node_modules/@noodle-borg/brand-kit/dist/palette.d.ts.map +1 -0
  94. package/node_modules/@noodle-borg/{compiler/dist/widget-palette.js → brand-kit/dist/palette.js} +1 -1
  95. package/node_modules/@noodle-borg/brand-kit/dist/palette.js.map +1 -0
  96. package/node_modules/@noodle-borg/{compiler/dist/widget-ui-style.d.ts → brand-kit/dist/ui-style.d.ts} +1 -1
  97. package/node_modules/@noodle-borg/brand-kit/dist/ui-style.d.ts.map +1 -0
  98. package/node_modules/@noodle-borg/{compiler/dist/widget-ui-style.js → brand-kit/dist/ui-style.js} +1 -1
  99. package/node_modules/@noodle-borg/brand-kit/dist/ui-style.js.map +1 -0
  100. package/node_modules/@noodle-borg/brand-kit/package.json +28 -0
  101. package/node_modules/@noodle-borg/compiler/dist/artifact/assemble.d.ts +2 -1
  102. package/node_modules/@noodle-borg/compiler/dist/artifact/assemble.d.ts.map +1 -1
  103. package/node_modules/@noodle-borg/compiler/dist/artifact/assemble.js +2 -1
  104. package/node_modules/@noodle-borg/compiler/dist/artifact/assemble.js.map +1 -1
  105. package/node_modules/@noodle-borg/compiler/dist/artifact/types.d.ts +3 -0
  106. package/node_modules/@noodle-borg/compiler/dist/artifact/types.d.ts.map +1 -1
  107. package/node_modules/@noodle-borg/compiler/dist/artifact/types.js.map +1 -1
  108. package/node_modules/@noodle-borg/compiler/dist/branding.d.ts.map +1 -1
  109. package/node_modules/@noodle-borg/compiler/dist/branding.js +1 -1
  110. package/node_modules/@noodle-borg/compiler/dist/branding.js.map +1 -1
  111. package/node_modules/@noodle-borg/compiler/dist/compile.d.ts +8 -0
  112. package/node_modules/@noodle-borg/compiler/dist/compile.d.ts.map +1 -1
  113. package/node_modules/@noodle-borg/compiler/dist/compile.js +8 -1
  114. package/node_modules/@noodle-borg/compiler/dist/compile.js.map +1 -1
  115. package/node_modules/@noodle-borg/compiler/dist/errors.d.ts +1 -1
  116. package/node_modules/@noodle-borg/compiler/dist/errors.d.ts.map +1 -1
  117. package/node_modules/@noodle-borg/compiler/dist/index.d.ts +1 -1
  118. package/node_modules/@noodle-borg/compiler/dist/index.d.ts.map +1 -1
  119. package/node_modules/@noodle-borg/compiler/dist/index.js +1 -1
  120. package/node_modules/@noodle-borg/compiler/dist/index.js.map +1 -1
  121. package/node_modules/@noodle-borg/compiler/dist/manifest/schema.d.ts +36 -0
  122. package/node_modules/@noodle-borg/compiler/dist/manifest/schema.d.ts.map +1 -1
  123. package/node_modules/@noodle-borg/compiler/dist/manifest/schema.js +7 -1
  124. package/node_modules/@noodle-borg/compiler/dist/manifest/schema.js.map +1 -1
  125. package/node_modules/@noodle-borg/compiler/dist/manifest/website-projection.d.ts +4 -0
  126. package/node_modules/@noodle-borg/compiler/dist/manifest/website-projection.d.ts.map +1 -1
  127. package/node_modules/@noodle-borg/compiler/dist/manifest/website-projection.js +1 -0
  128. package/node_modules/@noodle-borg/compiler/dist/manifest/website-projection.js.map +1 -1
  129. package/node_modules/@noodle-borg/compiler/dist/widget-emit.d.ts +1 -1
  130. package/node_modules/@noodle-borg/compiler/dist/widget-emit.d.ts.map +1 -1
  131. package/node_modules/@noodle-borg/compiler/dist/widget-emit.js +1 -1
  132. package/node_modules/@noodle-borg/compiler/dist/widget-emit.js.map +1 -1
  133. package/node_modules/@noodle-borg/compiler/dist/widget-size-validation.d.ts +1 -1
  134. package/node_modules/@noodle-borg/compiler/dist/widget-size-validation.d.ts.map +1 -1
  135. package/node_modules/@noodle-borg/compiler/dist/widget-size-validation.js.map +1 -1
  136. package/node_modules/@noodle-borg/compiler/package.json +3 -0
  137. package/node_modules/@noodle-borg/knowledge/dist/bm25.d.ts +14 -0
  138. package/node_modules/@noodle-borg/knowledge/dist/bm25.d.ts.map +1 -0
  139. package/node_modules/@noodle-borg/knowledge/dist/bm25.js +133 -0
  140. package/node_modules/@noodle-borg/knowledge/dist/bm25.js.map +1 -0
  141. package/node_modules/@noodle-borg/knowledge/dist/budget.d.ts +37 -0
  142. package/node_modules/@noodle-borg/knowledge/dist/budget.d.ts.map +1 -0
  143. package/node_modules/@noodle-borg/knowledge/dist/budget.js +52 -0
  144. package/node_modules/@noodle-borg/knowledge/dist/budget.js.map +1 -0
  145. package/node_modules/@noodle-borg/knowledge/dist/compile.d.ts +52 -0
  146. package/node_modules/@noodle-borg/knowledge/dist/compile.d.ts.map +1 -0
  147. package/node_modules/@noodle-borg/knowledge/dist/compile.js +250 -0
  148. package/node_modules/@noodle-borg/knowledge/dist/compile.js.map +1 -0
  149. package/node_modules/@noodle-borg/knowledge/dist/conformance.d.ts +21 -0
  150. package/node_modules/@noodle-borg/knowledge/dist/conformance.d.ts.map +1 -0
  151. package/node_modules/@noodle-borg/knowledge/dist/conformance.js +225 -0
  152. package/node_modules/@noodle-borg/knowledge/dist/conformance.js.map +1 -0
  153. package/node_modules/@noodle-borg/knowledge/dist/fakes.d.ts +23 -0
  154. package/node_modules/@noodle-borg/knowledge/dist/fakes.d.ts.map +1 -0
  155. package/node_modules/@noodle-borg/knowledge/dist/fakes.js +141 -0
  156. package/node_modules/@noodle-borg/knowledge/dist/fakes.js.map +1 -0
  157. package/node_modules/@noodle-borg/knowledge/dist/fusion.d.ts +27 -0
  158. package/node_modules/@noodle-borg/knowledge/dist/fusion.d.ts.map +1 -0
  159. package/node_modules/@noodle-borg/knowledge/dist/fusion.js +119 -0
  160. package/node_modules/@noodle-borg/knowledge/dist/fusion.js.map +1 -0
  161. package/node_modules/@noodle-borg/knowledge/dist/google-agent-search.d.ts +49 -0
  162. package/node_modules/@noodle-borg/knowledge/dist/google-agent-search.d.ts.map +1 -0
  163. package/node_modules/@noodle-borg/knowledge/dist/google-agent-search.js +235 -0
  164. package/node_modules/@noodle-borg/knowledge/dist/google-agent-search.js.map +1 -0
  165. package/node_modules/@noodle-borg/knowledge/dist/hits.d.ts +31 -0
  166. package/node_modules/@noodle-borg/knowledge/dist/hits.d.ts.map +1 -0
  167. package/node_modules/@noodle-borg/knowledge/dist/hits.js +75 -0
  168. package/node_modules/@noodle-borg/knowledge/dist/hits.js.map +1 -0
  169. package/node_modules/@noodle-borg/knowledge/dist/index.d.ts +25 -0
  170. package/node_modules/@noodle-borg/knowledge/dist/index.d.ts.map +1 -0
  171. package/node_modules/@noodle-borg/knowledge/dist/index.js +25 -0
  172. package/node_modules/@noodle-borg/knowledge/dist/index.js.map +1 -0
  173. package/node_modules/@noodle-borg/knowledge/dist/ir.d.ts +53 -0
  174. package/node_modules/@noodle-borg/knowledge/dist/ir.d.ts.map +1 -0
  175. package/node_modules/@noodle-borg/knowledge/dist/ir.js +87 -0
  176. package/node_modules/@noodle-borg/knowledge/dist/ir.js.map +1 -0
  177. package/node_modules/@noodle-borg/knowledge/dist/limits.d.ts +19 -0
  178. package/node_modules/@noodle-borg/knowledge/dist/limits.d.ts.map +1 -0
  179. package/node_modules/@noodle-borg/knowledge/dist/limits.js +19 -0
  180. package/node_modules/@noodle-borg/knowledge/dist/limits.js.map +1 -0
  181. package/node_modules/@noodle-borg/knowledge/dist/manifest-schema.d.ts +42 -0
  182. package/node_modules/@noodle-borg/knowledge/dist/manifest-schema.d.ts.map +1 -0
  183. package/node_modules/@noodle-borg/knowledge/dist/manifest-schema.js +45 -0
  184. package/node_modules/@noodle-borg/knowledge/dist/manifest-schema.js.map +1 -0
  185. package/node_modules/@noodle-borg/knowledge/dist/ports.d.ts +56 -0
  186. package/node_modules/@noodle-borg/knowledge/dist/ports.d.ts.map +1 -0
  187. package/node_modules/@noodle-borg/knowledge/dist/ports.js +13 -0
  188. package/node_modules/@noodle-borg/knowledge/dist/ports.js.map +1 -0
  189. package/node_modules/@noodle-borg/knowledge/dist/postgres-revision-store.d.ts +33 -0
  190. package/node_modules/@noodle-borg/knowledge/dist/postgres-revision-store.d.ts.map +1 -0
  191. package/node_modules/@noodle-borg/knowledge/dist/postgres-revision-store.js +200 -0
  192. package/node_modules/@noodle-borg/knowledge/dist/postgres-revision-store.js.map +1 -0
  193. package/node_modules/@noodle-borg/knowledge/dist/revision-store.d.ts +59 -0
  194. package/node_modules/@noodle-borg/knowledge/dist/revision-store.d.ts.map +1 -0
  195. package/node_modules/@noodle-borg/knowledge/dist/revision-store.js +128 -0
  196. package/node_modules/@noodle-borg/knowledge/dist/revision-store.js.map +1 -0
  197. package/node_modules/@noodle-borg/knowledge/package.json +36 -0
  198. package/node_modules/@noodle-borg/module/dist/contract.d.ts +2 -0
  199. package/node_modules/@noodle-borg/module/dist/contract.d.ts.map +1 -1
  200. package/node_modules/@noodle-borg/module/dist/contract.js.map +1 -1
  201. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-render.d.ts +4 -0
  202. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-render.d.ts.map +1 -0
  203. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-render.js +147 -0
  204. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-render.js.map +1 -0
  205. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-types.d.ts +14 -0
  206. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-types.d.ts.map +1 -0
  207. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-types.js +2 -0
  208. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-types.js.map +1 -0
  209. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-validation.d.ts +10 -0
  210. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-validation.d.ts.map +1 -0
  211. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-validation.js +152 -0
  212. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector-validation.js.map +1 -0
  213. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector.d.ts +7 -0
  214. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector.d.ts.map +1 -0
  215. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector.js +24 -0
  216. package/node_modules/@noodle-borg/plugin-distribution/dist/anthropic-connector.js.map +1 -0
  217. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-distribution-command.d.ts +6 -0
  218. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-distribution-command.d.ts.map +1 -0
  219. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-distribution-command.js +260 -0
  220. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-distribution-command.js.map +1 -0
  221. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin-render.d.ts +3 -0
  222. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin-render.d.ts.map +1 -0
  223. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin-render.js +89 -0
  224. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin-render.js.map +1 -0
  225. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin-validation.d.ts +3 -0
  226. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin-validation.d.ts.map +1 -0
  227. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin-validation.js +16 -0
  228. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin-validation.js.map +1 -0
  229. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin.d.ts +5 -0
  230. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin.d.ts.map +1 -0
  231. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin.js +15 -0
  232. package/node_modules/@noodle-borg/plugin-distribution/dist/claude-plugin.js.map +1 -0
  233. package/node_modules/@noodle-borg/plugin-distribution/dist/command.d.ts +3 -0
  234. package/node_modules/@noodle-borg/plugin-distribution/dist/command.d.ts.map +1 -0
  235. package/node_modules/@noodle-borg/plugin-distribution/dist/command.js +3 -0
  236. package/node_modules/@noodle-borg/plugin-distribution/dist/command.js.map +1 -0
  237. package/node_modules/@noodle-borg/plugin-distribution/dist/distribution-command-support.d.ts +37 -0
  238. package/node_modules/@noodle-borg/plugin-distribution/dist/distribution-command-support.d.ts.map +1 -0
  239. package/node_modules/@noodle-borg/plugin-distribution/dist/distribution-command-support.js +60 -0
  240. package/node_modules/@noodle-borg/plugin-distribution/dist/distribution-command-support.js.map +1 -0
  241. package/node_modules/@noodle-borg/plugin-distribution/dist/index.d.ts +2 -0
  242. package/node_modules/@noodle-borg/plugin-distribution/dist/index.d.ts.map +1 -1
  243. package/node_modules/@noodle-borg/plugin-distribution/dist/index.js +2 -0
  244. package/node_modules/@noodle-borg/plugin-distribution/dist/index.js.map +1 -1
  245. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-command.d.ts +3 -28
  246. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-command.d.ts.map +1 -1
  247. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-command.js +23 -64
  248. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-command.js.map +1 -1
  249. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-render.d.ts.map +1 -1
  250. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-render.js +3 -97
  251. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-render.js.map +1 -1
  252. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-validation.d.ts.map +1 -1
  253. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-validation.js +19 -8
  254. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-plugin-validation.js.map +1 -1
  255. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-submission-render.d.ts +5 -0
  256. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-submission-render.d.ts.map +1 -0
  257. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-submission-render.js +147 -0
  258. package/node_modules/@noodle-borg/plugin-distribution/dist/openai-submission-render.js.map +1 -0
  259. package/node_modules/@noodle-borg/plugin-distribution/dist/public-url.d.ts +3 -0
  260. package/node_modules/@noodle-borg/plugin-distribution/dist/public-url.d.ts.map +1 -0
  261. package/node_modules/@noodle-borg/plugin-distribution/dist/public-url.js +22 -0
  262. package/node_modules/@noodle-borg/plugin-distribution/dist/public-url.js.map +1 -0
  263. package/node_modules/@noodle-borg/plugin-distribution/package.json +2 -2
  264. package/node_modules/@noodle-borg/protocol/dist/handlers/resources.d.ts +1 -1
  265. package/node_modules/@noodle-borg/protocol/dist/handlers/resources.d.ts.map +1 -1
  266. package/node_modules/@noodle-borg/protocol/dist/handlers/resources.js +1 -1
  267. package/node_modules/@noodle-borg/protocol/dist/handlers/resources.js.map +1 -1
  268. package/node_modules/@noodle-borg/protocol/dist/v2/response-observation.d.ts +1 -1
  269. package/node_modules/@noodle-borg/protocol/dist/v2/response-observation.d.ts.map +1 -1
  270. package/node_modules/@noodle-borg/protocol/dist/v2/response-observation.js +1 -1
  271. package/node_modules/@noodle-borg/protocol/dist/v2/response-observation.js.map +1 -1
  272. package/node_modules/@noodle-borg/protocol/dist/v2/server.d.ts.map +1 -1
  273. package/node_modules/@noodle-borg/protocol/dist/v2/server.js +1 -1
  274. package/node_modules/@noodle-borg/protocol/dist/v2/server.js.map +1 -1
  275. package/node_modules/@noodle-borg/protocol/package.json +1 -0
  276. package/node_modules/@noodle-borg/service/dist/index.d.ts +0 -1
  277. package/node_modules/@noodle-borg/service/dist/index.d.ts.map +1 -1
  278. package/node_modules/@noodle-borg/service/dist/index.js +0 -1
  279. package/node_modules/@noodle-borg/service/dist/index.js.map +1 -1
  280. package/node_modules/@noodle-borg/service/dist/main.js +0 -52
  281. package/node_modules/@noodle-borg/service/dist/main.js.map +1 -1
  282. package/node_modules/@noodle-borg/service/dist/modules/host.d.ts +2 -6
  283. package/node_modules/@noodle-borg/service/dist/modules/host.d.ts.map +1 -1
  284. package/node_modules/@noodle-borg/service/dist/modules/host.js.map +1 -1
  285. package/node_modules/@noodle-borg/service/dist/options.d.ts +1 -21
  286. package/node_modules/@noodle-borg/service/dist/options.d.ts.map +1 -1
  287. package/node_modules/@noodle-borg/service/dist/serve-options.d.ts +7 -1
  288. package/node_modules/@noodle-borg/service/dist/serve-options.d.ts.map +1 -1
  289. package/node_modules/@noodle-borg/service/dist/serve.d.ts +0 -1
  290. package/node_modules/@noodle-borg/service/dist/serve.d.ts.map +1 -1
  291. package/node_modules/@noodle-borg/service/dist/serve.js +22 -26
  292. package/node_modules/@noodle-borg/service/dist/serve.js.map +1 -1
  293. package/node_modules/@noodle-borg/service/dist/service-config.d.ts +1 -1
  294. package/node_modules/@noodle-borg/service/dist/service-config.d.ts.map +1 -1
  295. package/node_modules/@noodle-borg/service/dist/service-config.js.map +1 -1
  296. package/node_modules/@noodle-borg/service/dist/service.d.ts.map +1 -1
  297. package/node_modules/@noodle-borg/service/dist/service.js +1 -24
  298. package/node_modules/@noodle-borg/service/dist/service.js.map +1 -1
  299. package/node_modules/@noodle-borg/service/package.json +1 -0
  300. package/node_modules/@noodle-borg/service-modules/dist/index.d.ts +9 -0
  301. package/node_modules/@noodle-borg/service-modules/dist/index.d.ts.map +1 -0
  302. package/node_modules/@noodle-borg/service-modules/dist/index.js +9 -0
  303. package/node_modules/@noodle-borg/service-modules/dist/index.js.map +1 -0
  304. package/node_modules/@noodle-borg/service-modules/dist/loaded-module.d.ts +8 -0
  305. package/node_modules/@noodle-borg/service-modules/dist/loaded-module.d.ts.map +1 -0
  306. package/node_modules/@noodle-borg/service-modules/dist/loaded-module.js +2 -0
  307. package/node_modules/@noodle-borg/service-modules/dist/loaded-module.js.map +1 -0
  308. package/node_modules/@noodle-borg/{service/dist/modules → service-modules/dist}/loader.d.ts +1 -1
  309. package/node_modules/@noodle-borg/service-modules/dist/loader.d.ts.map +1 -0
  310. package/node_modules/@noodle-borg/service-modules/dist/loader.js.map +1 -0
  311. package/node_modules/@noodle-borg/service-modules/package.json +32 -0
  312. package/node_modules/@noodle-borg/uri-template/dist/index.d.ts +7 -0
  313. package/node_modules/@noodle-borg/uri-template/dist/index.d.ts.map +1 -0
  314. package/node_modules/@noodle-borg/uri-template/dist/index.js +7 -0
  315. package/node_modules/@noodle-borg/uri-template/dist/index.js.map +1 -0
  316. package/node_modules/@noodle-borg/uri-template/package.json +28 -0
  317. package/node_modules/@noodleseed/assistant/dist/{chunk-7L52WJ2E.js → chunk-MZNENVFY.js} +11 -3
  318. package/node_modules/@noodleseed/assistant/dist/{chunk-7L52WJ2E.js.map → chunk-MZNENVFY.js.map} +1 -1
  319. package/node_modules/@noodleseed/assistant/dist/{chunk-NPV64PUX.js → chunk-RIKRQFKS.js} +5 -1
  320. package/node_modules/@noodleseed/assistant/dist/{chunk-NPV64PUX.js.map → chunk-RIKRQFKS.js.map} +1 -1
  321. package/node_modules/@noodleseed/assistant/dist/{client-Ii_xTV09.d.ts → client-B6pnBmF8.d.ts} +1 -0
  322. package/node_modules/@noodleseed/assistant/dist/{client-401BAJqk.d.cts → client-BQ30Fq-c.d.cts} +1 -0
  323. package/node_modules/@noodleseed/assistant/dist/client.cjs +4 -0
  324. package/node_modules/@noodleseed/assistant/dist/client.cjs.map +1 -1
  325. package/node_modules/@noodleseed/assistant/dist/client.d.cts +1 -1
  326. package/node_modules/@noodleseed/assistant/dist/client.d.ts +1 -1
  327. package/node_modules/@noodleseed/assistant/dist/client.js +1 -1
  328. package/node_modules/@noodleseed/assistant/dist/embed.global.js +2 -2
  329. package/node_modules/@noodleseed/assistant/dist/index.cjs +13 -1
  330. package/node_modules/@noodleseed/assistant/dist/index.cjs.map +1 -1
  331. package/node_modules/@noodleseed/assistant/dist/index.d.cts +2 -2
  332. package/node_modules/@noodleseed/assistant/dist/index.d.ts +2 -2
  333. package/node_modules/@noodleseed/assistant/dist/index.js +2 -2
  334. package/node_modules/@noodleseed/assistant/dist/react/client.cjs +4 -0
  335. package/node_modules/@noodleseed/assistant/dist/react/client.cjs.map +1 -1
  336. package/node_modules/@noodleseed/assistant/dist/react/client.d.cts +1 -1
  337. package/node_modules/@noodleseed/assistant/dist/react/client.d.ts +1 -1
  338. package/node_modules/@noodleseed/assistant/dist/react/client.js +1 -1
  339. package/node_modules/@noodleseed/assistant/dist/react.cjs +13 -1
  340. package/node_modules/@noodleseed/assistant/dist/react.cjs.map +1 -1
  341. package/node_modules/@noodleseed/assistant/dist/react.d.cts +1 -1
  342. package/node_modules/@noodleseed/assistant/dist/react.d.ts +1 -1
  343. package/node_modules/@noodleseed/assistant/dist/react.js +2 -2
  344. package/node_modules/@noodleseed/assistant/package.json +2 -1
  345. package/package.json +5 -1
  346. package/node_modules/@noodle-borg/compiler/dist/widget-palette.d.ts.map +0 -1
  347. package/node_modules/@noodle-borg/compiler/dist/widget-palette.js.map +0 -1
  348. package/node_modules/@noodle-borg/compiler/dist/widget-ui-style.d.ts.map +0 -1
  349. package/node_modules/@noodle-borg/compiler/dist/widget-ui-style.js.map +0 -1
  350. package/node_modules/@noodle-borg/service/dist/feedback-operations/bootstrap.d.ts +0 -7
  351. package/node_modules/@noodle-borg/service/dist/feedback-operations/bootstrap.d.ts.map +0 -1
  352. package/node_modules/@noodle-borg/service/dist/feedback-operations/bootstrap.js +0 -23
  353. package/node_modules/@noodle-borg/service/dist/feedback-operations/bootstrap.js.map +0 -1
  354. package/node_modules/@noodle-borg/service/dist/feedback-operations/config.d.ts +0 -12
  355. package/node_modules/@noodle-borg/service/dist/feedback-operations/config.d.ts.map +0 -1
  356. package/node_modules/@noodle-borg/service/dist/feedback-operations/config.js +0 -47
  357. package/node_modules/@noodle-borg/service/dist/feedback-operations/config.js.map +0 -1
  358. package/node_modules/@noodle-borg/service/dist/feedback-operations/contracts.d.ts +0 -24
  359. package/node_modules/@noodle-borg/service/dist/feedback-operations/contracts.d.ts.map +0 -1
  360. package/node_modules/@noodle-borg/service/dist/feedback-operations/contracts.js +0 -2
  361. package/node_modules/@noodle-borg/service/dist/feedback-operations/contracts.js.map +0 -1
  362. package/node_modules/@noodle-borg/service/dist/feedback-operations/delivery-worker.d.ts +0 -29
  363. package/node_modules/@noodle-borg/service/dist/feedback-operations/delivery-worker.d.ts.map +0 -1
  364. package/node_modules/@noodle-borg/service/dist/feedback-operations/delivery-worker.js +0 -263
  365. package/node_modules/@noodle-borg/service/dist/feedback-operations/delivery-worker.js.map +0 -1
  366. package/node_modules/@noodle-borg/service/dist/feedback-operations/linear-client.d.ts +0 -39
  367. package/node_modules/@noodle-borg/service/dist/feedback-operations/linear-client.d.ts.map +0 -1
  368. package/node_modules/@noodle-borg/service/dist/feedback-operations/linear-client.js +0 -142
  369. package/node_modules/@noodle-borg/service/dist/feedback-operations/linear-client.js.map +0 -1
  370. package/node_modules/@noodle-borg/service/dist/feedback-operations/reporter-email.d.ts +0 -33
  371. package/node_modules/@noodle-borg/service/dist/feedback-operations/reporter-email.d.ts.map +0 -1
  372. package/node_modules/@noodle-borg/service/dist/feedback-operations/reporter-email.js +0 -142
  373. package/node_modules/@noodle-borg/service/dist/feedback-operations/reporter-email.js.map +0 -1
  374. package/node_modules/@noodle-borg/service/dist/feedback-operations/slack-card.d.ts +0 -138
  375. package/node_modules/@noodle-borg/service/dist/feedback-operations/slack-card.d.ts.map +0 -1
  376. package/node_modules/@noodle-borg/service/dist/feedback-operations/slack-card.js +0 -199
  377. package/node_modules/@noodle-borg/service/dist/feedback-operations/slack-card.js.map +0 -1
  378. package/node_modules/@noodle-borg/service/dist/feedback-operations/slack-client.d.ts +0 -52
  379. package/node_modules/@noodle-borg/service/dist/feedback-operations/slack-client.d.ts.map +0 -1
  380. package/node_modules/@noodle-borg/service/dist/feedback-operations/slack-client.js +0 -103
  381. package/node_modules/@noodle-borg/service/dist/feedback-operations/slack-client.js.map +0 -1
  382. package/node_modules/@noodle-borg/service/dist/github/feedback-issues.d.ts +0 -44
  383. package/node_modules/@noodle-borg/service/dist/github/feedback-issues.d.ts.map +0 -1
  384. package/node_modules/@noodle-borg/service/dist/github/feedback-issues.js +0 -117
  385. package/node_modules/@noodle-borg/service/dist/github/feedback-issues.js.map +0 -1
  386. package/node_modules/@noodle-borg/service/dist/modules/loader.d.ts.map +0 -1
  387. package/node_modules/@noodle-borg/service/dist/modules/loader.js.map +0 -1
  388. package/node_modules/@noodle-borg/service/dist/routes/feedback-operations-dispatch.d.ts +0 -10
  389. package/node_modules/@noodle-borg/service/dist/routes/feedback-operations-dispatch.d.ts.map +0 -1
  390. package/node_modules/@noodle-borg/service/dist/routes/feedback-operations-dispatch.js +0 -54
  391. package/node_modules/@noodle-borg/service/dist/routes/feedback-operations-dispatch.js.map +0 -1
  392. package/node_modules/@noodle-borg/service/dist/routes/feedback.d.ts +0 -30
  393. package/node_modules/@noodle-borg/service/dist/routes/feedback.d.ts.map +0 -1
  394. package/node_modules/@noodle-borg/service/dist/routes/feedback.js +0 -233
  395. package/node_modules/@noodle-borg/service/dist/routes/feedback.js.map +0 -1
  396. package/node_modules/@noodle-borg/service/dist/routes/linear-feedback-webhook.d.ts +0 -17
  397. package/node_modules/@noodle-borg/service/dist/routes/linear-feedback-webhook.d.ts.map +0 -1
  398. package/node_modules/@noodle-borg/service/dist/routes/linear-feedback-webhook.js +0 -141
  399. package/node_modules/@noodle-borg/service/dist/routes/linear-feedback-webhook.js.map +0 -1
  400. package/node_modules/@noodle-borg/service/dist/routes/slack-feedback-actions.d.ts +0 -15
  401. package/node_modules/@noodle-borg/service/dist/routes/slack-feedback-actions.d.ts.map +0 -1
  402. package/node_modules/@noodle-borg/service/dist/routes/slack-feedback-actions.js +0 -135
  403. package/node_modules/@noodle-borg/service/dist/routes/slack-feedback-actions.js.map +0 -1
  404. package/node_modules/@noodle-borg/service/dist/store/feedback-operations.d.ts +0 -188
  405. package/node_modules/@noodle-borg/service/dist/store/feedback-operations.d.ts.map +0 -1
  406. package/node_modules/@noodle-borg/service/dist/store/feedback-operations.js +0 -489
  407. package/node_modules/@noodle-borg/service/dist/store/feedback-operations.js.map +0 -1
  408. package/node_modules/@noodle-borg/service/dist/store/postgres-feedback-operations.d.ts +0 -35
  409. package/node_modules/@noodle-borg/service/dist/store/postgres-feedback-operations.d.ts.map +0 -1
  410. package/node_modules/@noodle-borg/service/dist/store/postgres-feedback-operations.js +0 -172
  411. package/node_modules/@noodle-borg/service/dist/store/postgres-feedback-operations.js.map +0 -1
  412. /package/node_modules/@noodle-borg/{service/dist/modules → service-modules/dist}/loader.js +0 -0
  413. /package/node_modules/@noodle-borg/{compiler → uri-template}/dist/uri-template.d.ts +0 -0
  414. /package/node_modules/@noodle-borg/{compiler → uri-template}/dist/uri-template.d.ts.map +0 -0
  415. /package/node_modules/@noodle-borg/{compiler → uri-template}/dist/uri-template.js +0 -0
  416. /package/node_modules/@noodle-borg/{compiler → uri-template}/dist/uri-template.js.map +0 -0
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Core v2 manifest fragment for knowledge components (ADR 0202). Owned here so the pinned
3
+ * compiler only wires the surface; the shapes are the single source both the manifest schema
4
+ * and the compile pass consume.
5
+ */
6
+ import { z } from 'zod';
7
+ /**
8
+ * One deploy-coupled knowledge document. Authoring form carries `path`/`title`; the compile
9
+ * pass reads the file, verifies the structural limits, and fills `sha256`/`bytes` — the
10
+ * compiled form never carries document contents.
11
+ */
12
+ export declare const knowledgeDocumentManifestSchema: z.ZodObject<{
13
+ path: z.ZodString;
14
+ title: z.ZodString;
15
+ sourceUrl: z.ZodOptional<z.ZodURL>;
16
+ sha256: z.ZodOptional<z.ZodString>;
17
+ bytes: z.ZodOptional<z.ZodNumber>;
18
+ }, z.core.$strict>;
19
+ export declare const knowledgeSiteManifestSchema: z.ZodObject<{
20
+ origin: z.ZodURL;
21
+ include: z.ZodArray<z.ZodString>;
22
+ }, z.core.$strict>;
23
+ export declare const knowledgeComponentManifestSchema: z.ZodObject<{
24
+ name: z.ZodString;
25
+ title: z.ZodString;
26
+ description: z.ZodString;
27
+ documents: z.ZodArray<z.ZodObject<{
28
+ path: z.ZodString;
29
+ title: z.ZodString;
30
+ sourceUrl: z.ZodOptional<z.ZodURL>;
31
+ sha256: z.ZodOptional<z.ZodString>;
32
+ bytes: z.ZodOptional<z.ZodNumber>;
33
+ }, z.core.$strict>>;
34
+ sites: z.ZodArray<z.ZodObject<{
35
+ origin: z.ZodURL;
36
+ include: z.ZodArray<z.ZodString>;
37
+ }, z.core.$strict>>;
38
+ }, z.core.$strict>;
39
+ export type KnowledgeDocumentManifest = z.infer<typeof knowledgeDocumentManifestSchema>;
40
+ export type KnowledgeSiteManifest = z.infer<typeof knowledgeSiteManifestSchema>;
41
+ export type KnowledgeComponentManifest = z.infer<typeof knowledgeComponentManifestSchema>;
42
+ //# sourceMappingURL=manifest-schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../src/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;kBAiBjC,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;kBAO7B,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;kBAQlC,CAAC;AAEZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Core v2 manifest fragment for knowledge components (ADR 0202). Owned here so the pinned
3
+ * compiler only wires the surface; the shapes are the single source both the manifest schema
4
+ * and the compile pass consume.
5
+ */
6
+ import { z } from 'zod';
7
+ const httpsUrlSchema = z.url().regex(/^https:\/\//, 'must use https');
8
+ /**
9
+ * One deploy-coupled knowledge document. Authoring form carries `path`/`title`; the compile
10
+ * pass reads the file, verifies the structural limits, and fills `sha256`/`bytes` — the
11
+ * compiled form never carries document contents.
12
+ */
13
+ export const knowledgeDocumentManifestSchema = z
14
+ .object({
15
+ path: z
16
+ .string()
17
+ .min(1)
18
+ .refine((value) => !value.startsWith('/') && !value.split('/').includes('..'), 'document path must stay inside the project root'),
19
+ title: z.string().trim().min(1),
20
+ sourceUrl: httpsUrlSchema.optional(),
21
+ sha256: z
22
+ .string()
23
+ .regex(/^[0-9a-f]{64}$/, 'must be a lowercase hex SHA-256')
24
+ .optional(),
25
+ bytes: z.number().int().positive().optional(),
26
+ })
27
+ .strict();
28
+ export const knowledgeSiteManifestSchema = z
29
+ .object({
30
+ origin: httpsUrlSchema.refine((value) => !value.slice('https://'.length).includes('/'), {
31
+ message: 'site origin must not contain a path',
32
+ }),
33
+ include: z.array(z.string().min(1)).min(1),
34
+ })
35
+ .strict();
36
+ export const knowledgeComponentManifestSchema = z
37
+ .object({
38
+ name: z.string().regex(/^[a-z][a-z0-9_]*$/, 'must be lowercase snake-case'),
39
+ title: z.string().trim().min(1),
40
+ description: z.string().min(1),
41
+ documents: z.array(knowledgeDocumentManifestSchema).max(100),
42
+ sites: z.array(knowledgeSiteManifestSchema),
43
+ })
44
+ .strict();
45
+ //# sourceMappingURL=manifest-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../src/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EACrE,iDAAiD,CAClD;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,KAAK,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;SAC1D,QAAQ,EAAE;IACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QACtF,OAAO,EAAE,qCAAqC;KAC/C,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC;KAC9C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,8BAA8B,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;CAC5C,CAAC;KACD,MAAM,EAAE,CAAC"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Provider-neutral knowledge ports (ADR 0202). A fake and a production implementation pass
3
+ * the same conformance suites; provider names, scores, and answers never cross these seams.
4
+ */
5
+ import type { SearchHit, SearchRequest } from './hits.js';
6
+ import type { AudiencePredicate, DocumentDescriptor, KnowledgeScope, SitePolicy } from './ir.js';
7
+ /** Which provider layer failed, so operators see the accountable surface, never content. */
8
+ export type KnowledgeErrorLayer = 'request' | 'predicate' | 'provider' | 'store' | 'not-found';
9
+ export declare class KnowledgeError extends Error {
10
+ readonly layer: KnowledgeErrorLayer;
11
+ constructor(layer: KnowledgeErrorLayer, message: string, options?: {
12
+ cause?: unknown;
13
+ });
14
+ }
15
+ /** One staged document: its compiled descriptor plus the UTF-8 content the provider will index. */
16
+ export interface StagedDocument {
17
+ readonly descriptor: DocumentDescriptor;
18
+ readonly text: string;
19
+ }
20
+ export interface KnowledgeRevision {
21
+ /** Opaque provider/adapter-local revision identifier pinned by the deploy record. */
22
+ readonly revisionId: string;
23
+ readonly scope: KnowledgeScope;
24
+ readonly componentName: string;
25
+ readonly documents: readonly DocumentDescriptor[];
26
+ }
27
+ /**
28
+ * Publishes and queries deployment-versioned text documents. Implementations must:
29
+ * stage complete revisions, verify a positive typed-predicate query before activation,
30
+ * activate atomically, and delete only unreferenced revisions.
31
+ */
32
+ export interface KnowledgeIndex {
33
+ /** Stage a complete replacement revision and return its identifier. Idempotent on content hash. */
34
+ stage(scope: KnowledgeScope, componentName: string, documents: readonly StagedDocument[]): Promise<KnowledgeRevision>;
35
+ /**
36
+ * Prove the staged revision answers a positive filtered query for the given predicate —
37
+ * the launch gate that catches a knowledge base that silently returns nothing.
38
+ */
39
+ verify(revisionId: string, predicate: AudiencePredicate): Promise<boolean>;
40
+ /** Make the staged revision the one searches read. Fails if not staged. */
41
+ activate(revisionId: string): Promise<void>;
42
+ /** Query the active revision for the scope/component. */
43
+ search(scope: KnowledgeScope, componentName: string, request: SearchRequest): Promise<readonly SearchHit[]>;
44
+ /** Delete only a revision no activation or deployment pin references. */
45
+ delete(revisionId: string): Promise<void>;
46
+ /** The revision searches currently read, if one is active. */
47
+ activeRevision(scope: KnowledgeScope, componentName: string): Promise<KnowledgeRevision | undefined>;
48
+ }
49
+ /**
50
+ * Queries provider-managed live public websites. The mandatory predicate must carry
51
+ * `audience: public`; results are exact-origin/path-approved only.
52
+ */
53
+ export interface SiteSearch {
54
+ search(policy: SitePolicy, predicate: AudiencePredicate, request: SearchRequest): Promise<readonly SearchHit[]>;
55
+ }
56
+ //# sourceMappingURL=ports.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjG,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE/F,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;gBAExB,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKvF;AAED,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,KAAK,CACH,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,SAAS,cAAc,EAAE,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,yDAAyD;IACzD,MAAM,CACJ,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACjC,yEAAyE;IACzE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,cAAc,CACZ,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CACJ,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;CAClC"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Provider-neutral knowledge ports (ADR 0202). A fake and a production implementation pass
3
+ * the same conformance suites; provider names, scores, and answers never cross these seams.
4
+ */
5
+ export class KnowledgeError extends Error {
6
+ layer;
7
+ constructor(layer, message, options) {
8
+ super(message, options);
9
+ this.name = 'KnowledgeError';
10
+ this.layer = layer;
11
+ }
12
+ }
13
+ //# sourceMappingURL=ports.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ports.js","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,KAAK,CAAsB;IAEpC,YAAY,KAA0B,EAAE,OAAe,EAAE,OAA6B;QACpF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Durable knowledge revision store: Postgres parity for the deploy-coupled publication
3
+ * transaction (ADR 0202). Every state transition the in-memory store makes in one process,
4
+ * this store makes atomically across every service instance:
5
+ *
6
+ * - stage is idempotent on (scope, content_hash);
7
+ * - activate retires the previous active revision and pins the deployment in one transaction;
8
+ * - rollback reselects exactly the revision the target deployment pinned;
9
+ * - GC removes only revisions that are neither active nor pinned;
10
+ * - leases serialize publication per component/scope with a bounded timeout.
11
+ */
12
+ import type { Pool } from 'pg';
13
+ import type { KnowledgeScope } from './ir.js';
14
+ import { type KnowledgeRevision } from './ports.js';
15
+ import type { KnowledgeRevisionStore, LeaseTicket, RevisionRecord, StageRevisionInput } from './revision-store.js';
16
+ export declare class PostgresKnowledgeRevisionStore implements KnowledgeRevisionStore {
17
+ #private;
18
+ constructor(pool: Pool);
19
+ ensureSchema(): Promise<void>;
20
+ stage(input: StageRevisionInput): Promise<KnowledgeRevision>;
21
+ acquireLease(scope: KnowledgeScope, componentName: string, holder: string): Promise<LeaseTicket>;
22
+ releaseLease(ticket: LeaseTicket): Promise<void>;
23
+ activate(scope: KnowledgeScope, componentName: string, revisionId: string, deploymentId: string): Promise<void>;
24
+ pin(revisionId: string, deploymentId: string): Promise<void>;
25
+ rollback(deploymentId: string): Promise<KnowledgeRevision | undefined>;
26
+ collectGarbage(): Promise<number>;
27
+ active(scope: KnowledgeScope, componentName: string): Promise<KnowledgeRevision | undefined>;
28
+ record(revisionId: string): Promise<RevisionRecord | undefined>;
29
+ delete(revisionId: string): Promise<void>;
30
+ private rowScope;
31
+ private toRevision;
32
+ }
33
+ //# sourceMappingURL=postgres-revision-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"postgres-revision-store.d.ts","sourceRoot":"","sources":["../src/postgres-revision-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAgB7B,qBAAa,8BAA+B,YAAW,sBAAsB;;gBAG/D,IAAI,EAAE,IAAI;IAIhB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B7B,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8B5D,YAAY,CAChB,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC;IAmBjB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,QAAQ,CACZ,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAmCV,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAwCtE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAWjC,MAAM,CACV,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IASnC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAoB/D,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;CAQnB"}
@@ -0,0 +1,200 @@
1
+ import { knowledgeScopeKey } from './ir.js';
2
+ import { KnowledgeError } from './ports.js';
3
+ const LEASE_TIMEOUT_MS = 60_000;
4
+ export class PostgresKnowledgeRevisionStore {
5
+ #pool;
6
+ constructor(pool) {
7
+ this.#pool = pool;
8
+ }
9
+ async ensureSchema() {
10
+ await this.#pool.query(`
11
+ CREATE TABLE IF NOT EXISTS knowledge_revisions (
12
+ revision_id text PRIMARY KEY,
13
+ org text NOT NULL,
14
+ app text NOT NULL,
15
+ env text NOT NULL,
16
+ component_name text NOT NULL,
17
+ content_hash text NOT NULL,
18
+ state text NOT NULL DEFAULT 'staged',
19
+ documents jsonb NOT NULL,
20
+ staged_at timestamptz NOT NULL DEFAULT now(),
21
+ UNIQUE (org, app, env, component_name, content_hash)
22
+ )
23
+ `);
24
+ await this.#pool.query(`
25
+ CREATE TABLE IF NOT EXISTS knowledge_deployment_pins (
26
+ deployment_id text PRIMARY KEY,
27
+ revision_id text NOT NULL REFERENCES knowledge_revisions (revision_id) ON DELETE CASCADE
28
+ )
29
+ `);
30
+ await this.#pool.query(`
31
+ CREATE TABLE IF NOT EXISTS knowledge_publication_leases (
32
+ scope_key text PRIMARY KEY,
33
+ holder text NOT NULL,
34
+ acquired_at timestamptz NOT NULL DEFAULT now()
35
+ )
36
+ `);
37
+ }
38
+ async stage(input) {
39
+ const result = await this.#pool.query(`INSERT INTO knowledge_revisions (revision_id, org, app, env, component_name, content_hash, documents)
40
+ VALUES ($1, $2, $3, $4, $5, $6, $7::jsonb)
41
+ ON CONFLICT (org, app, env, component_name, content_hash) DO NOTHING
42
+ RETURNING revision_id, org, app, env, component_name, content_hash, state, documents, staged_at`, [
43
+ input.revision.revisionId,
44
+ input.scope.org,
45
+ input.scope.app,
46
+ input.scope.env,
47
+ input.componentName,
48
+ input.contentHash,
49
+ JSON.stringify(input.revision.documents),
50
+ ]);
51
+ if (result.rows[0] !== undefined)
52
+ return this.toRevision(result.rows[0]);
53
+ // Idempotent reuse: the unique scope+hash row already exists.
54
+ const existing = await this.#pool.query(`SELECT revision_id, org, app, env, component_name, content_hash, state, documents, staged_at
55
+ FROM knowledge_revisions
56
+ WHERE org = $1 AND app = $2 AND env = $3 AND component_name = $4 AND content_hash = $5`, [input.scope.org, input.scope.app, input.scope.env, input.componentName, input.contentHash]);
57
+ const row = existing.rows[0];
58
+ if (row === undefined)
59
+ throw new KnowledgeError('store', 'staged revision disappeared mid-transaction');
60
+ return this.toRevision(row);
61
+ }
62
+ async acquireLease(scope, componentName, holder) {
63
+ const scopeKey = knowledgeScopeKey(scope, componentName);
64
+ for (;;) {
65
+ const result = await this.#pool.query(`INSERT INTO knowledge_publication_leases (scope_key, holder, acquired_at)
66
+ VALUES ($1, $2, now())
67
+ ON CONFLICT (scope_key) DO UPDATE
68
+ SET holder = $2, acquired_at = now()
69
+ WHERE knowledge_publication_leases.acquired_at < now() - interval '${LEASE_TIMEOUT_MS} milliseconds'
70
+ RETURNING scope_key`, [scopeKey, holder]);
71
+ if (result.rows[0] !== undefined) {
72
+ return { scopeKey, leaseId: `${scopeKey}:${holder}` };
73
+ }
74
+ await new Promise((resolve) => setTimeout(resolve, 25));
75
+ }
76
+ }
77
+ async releaseLease(ticket) {
78
+ await this.#pool.query('DELETE FROM knowledge_publication_leases WHERE scope_key = $1', [
79
+ ticket.scopeKey,
80
+ ]);
81
+ }
82
+ async activate(scope, componentName, revisionId, deploymentId) {
83
+ const client = await this.#pool.connect();
84
+ try {
85
+ await client.query('BEGIN');
86
+ const existing = await client.query('SELECT * FROM knowledge_revisions WHERE revision_id = $1 FOR UPDATE', [revisionId]);
87
+ if (existing.rows[0] === undefined) {
88
+ await client.query('ROLLBACK');
89
+ throw new KnowledgeError('not-found', `revision ${revisionId} is not staged`);
90
+ }
91
+ await client.query(`UPDATE knowledge_revisions SET state = 'retired'
92
+ WHERE org = $1 AND app = $2 AND env = $3 AND component_name = $4 AND state = 'active' AND revision_id <> $5`, [scope.org, scope.app, scope.env, componentName, revisionId]);
93
+ await client.query(`UPDATE knowledge_revisions SET state = 'active' WHERE revision_id = $1`, [
94
+ revisionId,
95
+ ]);
96
+ await client.query(`INSERT INTO knowledge_deployment_pins (deployment_id, revision_id)
97
+ VALUES ($1, $2)
98
+ ON CONFLICT (deployment_id) DO UPDATE SET revision_id = $2`, [deploymentId, revisionId]);
99
+ await client.query('COMMIT');
100
+ }
101
+ catch (error) {
102
+ await client.query('ROLLBACK').catch(() => undefined);
103
+ throw error;
104
+ }
105
+ finally {
106
+ client.release();
107
+ }
108
+ }
109
+ async pin(revisionId, deploymentId) {
110
+ const result = await this.#pool.query(`INSERT INTO knowledge_deployment_pins (deployment_id, revision_id)
111
+ VALUES ($1, $2)
112
+ ON CONFLICT (deployment_id) DO UPDATE SET revision_id = $2
113
+ RETURNING revision_id`, [deploymentId, revisionId]);
114
+ if (result.rows[0] === undefined)
115
+ throw new KnowledgeError('not-found', `revision ${revisionId} is not staged`);
116
+ }
117
+ async rollback(deploymentId) {
118
+ const client = await this.#pool.connect();
119
+ try {
120
+ await client.query('BEGIN');
121
+ const pinned = await client.query('SELECT revision_id FROM knowledge_deployment_pins WHERE deployment_id = $1', [deploymentId]);
122
+ const revisionId = pinned.rows[0]?.revision_id;
123
+ if (revisionId === undefined) {
124
+ await client.query('COMMIT');
125
+ return undefined;
126
+ }
127
+ const target = await client.query('SELECT * FROM knowledge_revisions WHERE revision_id = $1', [revisionId]);
128
+ if (target.rows[0] === undefined) {
129
+ await client.query('COMMIT');
130
+ return undefined;
131
+ }
132
+ const scope = this.rowScope(target.rows[0]);
133
+ await client.query(`UPDATE knowledge_revisions SET state = 'retired'
134
+ WHERE org = $1 AND app = $2 AND env = $3 AND component_name = $4 AND state = 'active' AND revision_id <> $5`, [scope.org, scope.app, scope.env, target.rows[0].component_name, revisionId]);
135
+ await client.query(`UPDATE knowledge_revisions SET state = 'active' WHERE revision_id = $1`, [
136
+ revisionId,
137
+ ]);
138
+ await client.query('COMMIT');
139
+ return this.toRevision(target.rows[0]);
140
+ }
141
+ catch (error) {
142
+ await client.query('ROLLBACK').catch(() => undefined);
143
+ throw error;
144
+ }
145
+ finally {
146
+ client.release();
147
+ }
148
+ }
149
+ async collectGarbage() {
150
+ const result = await this.#pool.query(`DELETE FROM knowledge_revisions r
151
+ WHERE r.state <> 'active'
152
+ AND NOT EXISTS (
153
+ SELECT 1 FROM knowledge_deployment_pins p WHERE p.revision_id = r.revision_id
154
+ )`);
155
+ return result.rowCount ?? 0;
156
+ }
157
+ async active(scope, componentName) {
158
+ const result = await this.#pool.query(`SELECT * FROM knowledge_revisions
159
+ WHERE org = $1 AND app = $2 AND env = $3 AND component_name = $4 AND state = 'active'`, [scope.org, scope.app, scope.env, componentName]);
160
+ return result.rows[0] === undefined ? undefined : this.toRevision(result.rows[0]);
161
+ }
162
+ async record(revisionId) {
163
+ const result = await this.#pool.query('SELECT * FROM knowledge_revisions WHERE revision_id = $1', [revisionId]);
164
+ const row = result.rows[0];
165
+ if (row === undefined)
166
+ return undefined;
167
+ const pins = await this.#pool.query('SELECT deployment_id FROM knowledge_deployment_pins WHERE revision_id = $1', [revisionId]);
168
+ return {
169
+ revision: this.toRevision(row),
170
+ contentHash: row.content_hash,
171
+ state: row.state,
172
+ pins: new Set(pins.rows.map((pin) => pin.deployment_id)),
173
+ stagedAt: new Date(row.staged_at).getTime(),
174
+ };
175
+ }
176
+ async delete(revisionId) {
177
+ const record = await this.record(revisionId);
178
+ if (record === undefined)
179
+ return;
180
+ if (record.state === 'active') {
181
+ throw new KnowledgeError('store', 'cannot delete the active revision');
182
+ }
183
+ if (record.pins.size > 0) {
184
+ throw new KnowledgeError('store', 'cannot delete a deployment-pinned revision');
185
+ }
186
+ await this.#pool.query('DELETE FROM knowledge_revisions WHERE revision_id = $1', [revisionId]);
187
+ }
188
+ rowScope(row) {
189
+ return { org: row.org, app: row.app, env: row.env };
190
+ }
191
+ toRevision(row) {
192
+ return {
193
+ revisionId: row.revision_id,
194
+ scope: this.rowScope(row),
195
+ componentName: row.component_name,
196
+ documents: row.documents,
197
+ };
198
+ }
199
+ }
200
+ //# sourceMappingURL=postgres-revision-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"postgres-revision-store.js","sourceRoot":"","sources":["../src/postgres-revision-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ import type { KnowledgeScope } from './ir.js';
2
+ import type { KnowledgeRevision } from './ports.js';
3
+ export interface StageRevisionInput {
4
+ readonly scope: KnowledgeScope;
5
+ readonly componentName: string;
6
+ /** Content hash of the complete document set — equal sets reuse the same revision. */
7
+ readonly contentHash: string;
8
+ readonly revision: KnowledgeRevision;
9
+ }
10
+ export interface LeaseTicket {
11
+ readonly scopeKey: string;
12
+ readonly leaseId: string;
13
+ }
14
+ export interface RevisionRecord {
15
+ readonly revision: KnowledgeRevision;
16
+ readonly contentHash: string;
17
+ readonly state: 'staged' | 'active' | 'retired';
18
+ /** Deployment ids that pin this revision against GC. */
19
+ readonly pins: ReadonlySet<string>;
20
+ readonly stagedAt: number;
21
+ }
22
+ export interface KnowledgeRevisionStore {
23
+ /** Record a staged revision. Re-staging the same contentHash for the scope is idempotent. */
24
+ stage(input: StageRevisionInput): Promise<KnowledgeRevision>;
25
+ /** Serialize publication per component/scope; resolves when the lease is held. */
26
+ acquireLease(scope: KnowledgeScope, componentName: string, holder: string): Promise<LeaseTicket>;
27
+ releaseLease(ticket: LeaseTicket): Promise<void>;
28
+ /** Atomically pair artifact activation with the revision: verify, then flip both. */
29
+ activate(scope: KnowledgeScope, componentName: string, revisionId: string, deploymentId: string): Promise<void>;
30
+ /** Mark a deployment as pinning the revision it activated. */
31
+ pin(revisionId: string, deploymentId: string): Promise<void>;
32
+ /** Rollback reselects the revision the target deployment pinned; returns it when reselved. */
33
+ rollback(deploymentId: string): Promise<KnowledgeRevision | undefined>;
34
+ /** Remove revisions that are neither active nor pinned. Returns the removed count. */
35
+ collectGarbage(): Promise<number>;
36
+ /** Active revision for a scope/component, if any. */
37
+ active(scope: KnowledgeScope, componentName: string): Promise<KnowledgeRevision | undefined>;
38
+ /** A specific revision by id (diagnostics/status only). */
39
+ record(revisionId: string): Promise<RevisionRecord | undefined>;
40
+ /** Delete a revision record; refuses an active or pinned one. */
41
+ delete(revisionId: string): Promise<void>;
42
+ }
43
+ export declare function documentsContentHash(documentHashes: readonly string[]): string;
44
+ export declare class InMemoryKnowledgeRevisionStore implements KnowledgeRevisionStore {
45
+ private readonly records;
46
+ private readonly leases;
47
+ private readonly deploymentPins;
48
+ stage(input: StageRevisionInput): Promise<KnowledgeRevision>;
49
+ acquireLease(scope: KnowledgeScope, componentName: string, holder: string): Promise<LeaseTicket>;
50
+ releaseLease(ticket: LeaseTicket): Promise<void>;
51
+ activate(scope: KnowledgeScope, componentName: string, revisionId: string, deploymentId: string): Promise<void>;
52
+ pin(revisionId: string, deploymentId: string): Promise<void>;
53
+ rollback(deploymentId: string): Promise<KnowledgeRevision | undefined>;
54
+ collectGarbage(): Promise<number>;
55
+ active(scope: KnowledgeScope, componentName: string): Promise<KnowledgeRevision | undefined>;
56
+ record(revisionId: string): Promise<RevisionRecord | undefined>;
57
+ delete(revisionId: string): Promise<void>;
58
+ }
59
+ //# sourceMappingURL=revision-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revision-store.d.ts","sourceRoot":"","sources":["../src/revision-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,128 @@
1
+ /**
2
+ * Deploy-coupled knowledge revision store (ADR 0202 publication transaction): staged/active
3
+ * state, content-hash reuse, publication leases, positive-predicate verification, atomic
4
+ * artifact+revision activation, deployment pins, rollback pairing, retention, and GC.
5
+ *
6
+ * The store owns *coordination*; the `KnowledgeIndex` port owns provider bytes. A deployment
7
+ * stages through the port, records the revision here, verifies, then activates both as one
8
+ * transaction; failure retains the previous pair.
9
+ */
10
+ import { createHash } from 'node:crypto';
11
+ import { knowledgeScopeKey } from './ir.js';
12
+ import { KnowledgeError } from './ports.js';
13
+ export function documentsContentHash(documentHashes) {
14
+ return createHash('sha256').update(documentHashes.join('\n')).digest('hex');
15
+ }
16
+ const LEASE_TIMEOUT_MS = 60_000;
17
+ export class InMemoryKnowledgeRevisionStore {
18
+ records = new Map();
19
+ leases = new Map();
20
+ deploymentPins = new Map();
21
+ async stage(input) {
22
+ const scopeKey = knowledgeScopeKey(input.scope, input.componentName);
23
+ const existing = [...this.records.values()].find((record) => knowledgeScopeKey(record.revision.scope, record.revision.componentName) === scopeKey &&
24
+ record.contentHash === input.contentHash);
25
+ if (existing !== undefined)
26
+ return existing.revision;
27
+ const record = {
28
+ revision: input.revision,
29
+ contentHash: input.contentHash,
30
+ state: 'staged',
31
+ pins: new Set(),
32
+ stagedAt: Date.now(),
33
+ };
34
+ this.records.set(input.revision.revisionId, record);
35
+ return input.revision;
36
+ }
37
+ async acquireLease(scope, componentName, holder) {
38
+ const scopeKey = knowledgeScopeKey(scope, componentName);
39
+ for (;;) {
40
+ const existing = this.leases.get(scopeKey);
41
+ const now = Date.now();
42
+ if (existing === undefined || now - existing.acquiredAt > LEASE_TIMEOUT_MS) {
43
+ this.leases.set(scopeKey, { holder, acquiredAt: now });
44
+ return { scopeKey, leaseId: `${scopeKey}:${now}:${holder}` };
45
+ }
46
+ await new Promise((resolve) => setTimeout(resolve, 5));
47
+ }
48
+ }
49
+ async releaseLease(ticket) {
50
+ this.leases.delete(ticket.scopeKey);
51
+ }
52
+ async activate(scope, componentName, revisionId, deploymentId) {
53
+ const record = this.records.get(revisionId);
54
+ if (record === undefined) {
55
+ throw new KnowledgeError('not-found', `revision ${revisionId} is not staged`);
56
+ }
57
+ const scopeKey = knowledgeScopeKey(scope, componentName);
58
+ const currentActive = [...this.records.values()].find((candidate) => candidate.state === 'active' &&
59
+ knowledgeScopeKey(candidate.revision.scope, candidate.revision.componentName) === scopeKey);
60
+ if (currentActive !== undefined && currentActive.revision.revisionId !== revisionId) {
61
+ currentActive.state = 'retired';
62
+ }
63
+ record.state = 'active';
64
+ record.pins.add(deploymentId);
65
+ this.deploymentPins.set(deploymentId, revisionId);
66
+ }
67
+ async pin(revisionId, deploymentId) {
68
+ const record = this.records.get(revisionId);
69
+ if (record === undefined)
70
+ throw new KnowledgeError('not-found', `revision ${revisionId} is not staged`);
71
+ record.pins.add(deploymentId);
72
+ this.deploymentPins.set(deploymentId, revisionId);
73
+ }
74
+ async rollback(deploymentId) {
75
+ const revisionId = this.deploymentPins.get(deploymentId);
76
+ if (revisionId === undefined)
77
+ return undefined;
78
+ const record = this.records.get(revisionId);
79
+ if (record === undefined)
80
+ return undefined;
81
+ const scopeKey = knowledgeScopeKey(record.revision.scope, record.revision.componentName);
82
+ for (const candidate of this.records.values()) {
83
+ if (candidate.state === 'active' &&
84
+ knowledgeScopeKey(candidate.revision.scope, candidate.revision.componentName) ===
85
+ scopeKey &&
86
+ candidate.revision.revisionId !== revisionId) {
87
+ candidate.state = 'retired';
88
+ }
89
+ }
90
+ record.state = 'active';
91
+ return record.revision;
92
+ }
93
+ async collectGarbage() {
94
+ let removed = 0;
95
+ for (const [revisionId, record] of this.records) {
96
+ if (record.state !== 'active' && record.pins.size === 0) {
97
+ this.records.delete(revisionId);
98
+ removed += 1;
99
+ }
100
+ }
101
+ return removed;
102
+ }
103
+ async active(scope, componentName) {
104
+ const scopeKey = knowledgeScopeKey(scope, componentName);
105
+ const record = [...this.records.values()].find((candidate) => candidate.state === 'active' &&
106
+ knowledgeScopeKey(candidate.revision.scope, candidate.revision.componentName) === scopeKey);
107
+ return record?.revision;
108
+ }
109
+ async record(revisionId) {
110
+ const record = this.records.get(revisionId);
111
+ if (record === undefined)
112
+ return undefined;
113
+ return { ...record, pins: new Set(record.pins) };
114
+ }
115
+ async delete(revisionId) {
116
+ const record = this.records.get(revisionId);
117
+ if (record === undefined)
118
+ return;
119
+ if (record.state === 'active') {
120
+ throw new KnowledgeError('store', 'cannot delete the active revision');
121
+ }
122
+ if (record.pins.size > 0) {
123
+ throw new KnowledgeError('store', 'cannot delete a deployment-pinned revision');
124
+ }
125
+ this.records.delete(revisionId);
126
+ }
127
+ }
128
+ //# sourceMappingURL=revision-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revision-store.js","sourceRoot":"","sources":["../src/revision-store.ts"],"names":[],"mappings":"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"}