@oscharko-dev/keiko 0.3.16 → 0.3.17

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 (214) hide show
  1. package/dist/ui/csp-hashes.json +6 -6
  2. package/dist/ui/static/404.html +1 -1
  3. package/dist/ui/static/__next.__PAGE__.txt +1 -1
  4. package/dist/ui/static/__next._full.txt +1 -1
  5. package/dist/ui/static/__next._head.txt +1 -1
  6. package/dist/ui/static/__next._index.txt +1 -1
  7. package/dist/ui/static/__next._tree.txt +1 -1
  8. package/dist/ui/static/_not-found/__next._full.txt +1 -1
  9. package/dist/ui/static/_not-found/__next._head.txt +1 -1
  10. package/dist/ui/static/_not-found/__next._index.txt +1 -1
  11. package/dist/ui/static/_not-found/__next._not-found.__PAGE__.txt +1 -1
  12. package/dist/ui/static/_not-found/__next._not-found.txt +1 -1
  13. package/dist/ui/static/_not-found/__next._tree.txt +1 -1
  14. package/dist/ui/static/_not-found.html +1 -1
  15. package/dist/ui/static/_not-found.txt +1 -1
  16. package/dist/ui/static/atlassian-connectors/__next._full.txt +1 -1
  17. package/dist/ui/static/atlassian-connectors/__next._head.txt +1 -1
  18. package/dist/ui/static/atlassian-connectors/__next._index.txt +1 -1
  19. package/dist/ui/static/atlassian-connectors/__next._tree.txt +1 -1
  20. package/dist/ui/static/atlassian-connectors/__next.atlassian-connectors.__PAGE__.txt +1 -1
  21. package/dist/ui/static/atlassian-connectors/__next.atlassian-connectors.txt +1 -1
  22. package/dist/ui/static/atlassian-connectors.html +1 -1
  23. package/dist/ui/static/atlassian-connectors.txt +1 -1
  24. package/dist/ui/static/index.html +1 -1
  25. package/dist/ui/static/index.txt +1 -1
  26. package/dist/ui/static/launch/__next._full.txt +1 -1
  27. package/dist/ui/static/launch/__next._head.txt +1 -1
  28. package/dist/ui/static/launch/__next._index.txt +1 -1
  29. package/dist/ui/static/launch/__next._tree.txt +1 -1
  30. package/dist/ui/static/launch/__next.launch.__PAGE__.txt +1 -1
  31. package/dist/ui/static/launch/__next.launch.txt +1 -1
  32. package/dist/ui/static/launch.html +1 -1
  33. package/dist/ui/static/launch.txt +1 -1
  34. package/dist/ui/static/local-knowledge/__next._full.txt +1 -1
  35. package/dist/ui/static/local-knowledge/__next._head.txt +1 -1
  36. package/dist/ui/static/local-knowledge/__next._index.txt +1 -1
  37. package/dist/ui/static/local-knowledge/__next._tree.txt +1 -1
  38. package/dist/ui/static/local-knowledge/__next.local-knowledge.__PAGE__.txt +1 -1
  39. package/dist/ui/static/local-knowledge/__next.local-knowledge.txt +1 -1
  40. package/dist/ui/static/local-knowledge/capsule/__next._full.txt +1 -1
  41. package/dist/ui/static/local-knowledge/capsule/__next._head.txt +1 -1
  42. package/dist/ui/static/local-knowledge/capsule/__next._index.txt +1 -1
  43. package/dist/ui/static/local-knowledge/capsule/__next._tree.txt +1 -1
  44. package/dist/ui/static/local-knowledge/capsule/__next.local-knowledge.capsule.__PAGE__.txt +1 -1
  45. package/dist/ui/static/local-knowledge/capsule/__next.local-knowledge.capsule.txt +1 -1
  46. package/dist/ui/static/local-knowledge/capsule/__next.local-knowledge.txt +1 -1
  47. package/dist/ui/static/local-knowledge/capsule.html +1 -1
  48. package/dist/ui/static/local-knowledge/capsule.txt +1 -1
  49. package/dist/ui/static/local-knowledge.html +1 -1
  50. package/dist/ui/static/local-knowledge.txt +1 -1
  51. package/node_modules/@oscharko-dev/keiko-cli/dist/investigate.d.ts +8 -0
  52. package/node_modules/@oscharko-dev/keiko-cli/dist/investigate.d.ts.map +1 -1
  53. package/node_modules/@oscharko-dev/keiko-cli/dist/investigate.js +283 -16
  54. package/node_modules/@oscharko-dev/keiko-cli/dist/support-analyze.d.ts +71 -0
  55. package/node_modules/@oscharko-dev/keiko-cli/dist/support-analyze.d.ts.map +1 -1
  56. package/node_modules/@oscharko-dev/keiko-cli/dist/support-analyze.js +420 -11
  57. package/node_modules/@oscharko-dev/keiko-cli/dist/support-export.d.ts +23 -1
  58. package/node_modules/@oscharko-dev/keiko-cli/dist/support-export.d.ts.map +1 -1
  59. package/node_modules/@oscharko-dev/keiko-cli/dist/support-export.js +41 -7
  60. package/node_modules/@oscharko-dev/keiko-cli/dist/support.d.ts +6 -0
  61. package/node_modules/@oscharko-dev/keiko-cli/dist/support.d.ts.map +1 -1
  62. package/node_modules/@oscharko-dev/keiko-cli/dist/support.js +289 -13
  63. package/node_modules/@oscharko-dev/keiko-cli/package.json +13 -13
  64. package/node_modules/@oscharko-dev/keiko-connectors/package.json +3 -3
  65. package/node_modules/@oscharko-dev/keiko-contracts/dist/index.d.ts +2 -2
  66. package/node_modules/@oscharko-dev/keiko-contracts/dist/index.js +2 -2
  67. package/node_modules/@oscharko-dev/keiko-contracts/package.json +1 -1
  68. package/node_modules/@oscharko-dev/keiko-evaluations/package.json +9 -9
  69. package/node_modules/@oscharko-dev/keiko-evidence/dist/version.d.ts +1 -1
  70. package/node_modules/@oscharko-dev/keiko-evidence/dist/version.js +1 -1
  71. package/node_modules/@oscharko-dev/keiko-evidence/package.json +4 -4
  72. package/node_modules/@oscharko-dev/keiko-git/package.json +1 -1
  73. package/node_modules/@oscharko-dev/keiko-harness/dist/version.d.ts +1 -1
  74. package/node_modules/@oscharko-dev/keiko-harness/dist/version.js +1 -1
  75. package/node_modules/@oscharko-dev/keiko-harness/package.json +6 -6
  76. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/version.d.ts +1 -1
  77. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/version.js +1 -1
  78. package/node_modules/@oscharko-dev/keiko-local-knowledge/package.json +5 -5
  79. package/node_modules/@oscharko-dev/keiko-memory-capture/dist/version.d.ts +1 -1
  80. package/node_modules/@oscharko-dev/keiko-memory-capture/dist/version.js +1 -1
  81. package/node_modules/@oscharko-dev/keiko-memory-capture/package.json +3 -3
  82. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/consolidate.d.ts +1 -0
  83. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/consolidate.d.ts.map +1 -1
  84. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/consolidate.js +26 -6
  85. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/index.d.ts +2 -1
  86. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/index.d.ts.map +1 -1
  87. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/index.js +1 -0
  88. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/log-port.d.ts +19 -0
  89. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/log-port.d.ts.map +1 -0
  90. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/log-port.js +112 -0
  91. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/types.d.ts +2 -0
  92. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/types.d.ts.map +1 -1
  93. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/version.d.ts +1 -1
  94. package/node_modules/@oscharko-dev/keiko-memory-consolidation/dist/version.js +1 -1
  95. package/node_modules/@oscharko-dev/keiko-memory-consolidation/package.json +3 -3
  96. package/node_modules/@oscharko-dev/keiko-memory-governance/dist/version.d.ts +1 -1
  97. package/node_modules/@oscharko-dev/keiko-memory-governance/dist/version.js +1 -1
  98. package/node_modules/@oscharko-dev/keiko-memory-governance/package.json +3 -3
  99. package/node_modules/@oscharko-dev/keiko-memory-retrieval/dist/version.d.ts +1 -1
  100. package/node_modules/@oscharko-dev/keiko-memory-retrieval/dist/version.js +1 -1
  101. package/node_modules/@oscharko-dev/keiko-memory-retrieval/package.json +3 -3
  102. package/node_modules/@oscharko-dev/keiko-memory-vault/dist/version.d.ts +1 -1
  103. package/node_modules/@oscharko-dev/keiko-memory-vault/dist/version.js +1 -1
  104. package/node_modules/@oscharko-dev/keiko-memory-vault/package.json +3 -3
  105. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/openai-adapter.d.ts +4 -0
  106. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/openai-adapter.d.ts.map +1 -1
  107. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/openai-adapter.js +25 -0
  108. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/version.d.ts +1 -1
  109. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/version.js +1 -1
  110. package/node_modules/@oscharko-dev/keiko-model-gateway/package.json +3 -3
  111. package/node_modules/@oscharko-dev/keiko-quality-intelligence/package.json +3 -3
  112. package/node_modules/@oscharko-dev/keiko-sandbox/package.json +2 -2
  113. package/node_modules/@oscharko-dev/keiko-sdk/package.json +9 -9
  114. package/node_modules/@oscharko-dev/keiko-security/dist/version.d.ts +1 -1
  115. package/node_modules/@oscharko-dev/keiko-security/dist/version.js +1 -1
  116. package/node_modules/@oscharko-dev/keiko-security/package.json +2 -2
  117. package/node_modules/@oscharko-dev/keiko-server/dist/atlassian/httpPort.d.ts +1 -0
  118. package/node_modules/@oscharko-dev/keiko-server/dist/atlassian/httpPort.d.ts.map +1 -1
  119. package/node_modules/@oscharko-dev/keiko-server/dist/atlassian/httpPort.js +24 -1
  120. package/node_modules/@oscharko-dev/keiko-server/dist/chat-handlers.d.ts.map +1 -1
  121. package/node_modules/@oscharko-dev/keiko-server/dist/chat-handlers.js +1 -0
  122. package/node_modules/@oscharko-dev/keiko-server/dist/coding-app-session/sessionChannel.d.ts.map +1 -1
  123. package/node_modules/@oscharko-dev/keiko-server/dist/coding-app-session/sessionChannel.js +3 -3
  124. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeEventHub.d.ts.map +1 -1
  125. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeEventHub.js +3 -3
  126. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingRuntimeManager.js +19 -4
  127. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingSafeActivityProjection.d.ts.map +1 -1
  128. package/node_modules/@oscharko-dev/keiko-server/dist/coding-runtime/codingSafeActivityProjection.js +23 -3
  129. package/node_modules/@oscharko-dev/keiko-server/dist/diagnostics-log.d.ts +2 -2
  130. package/node_modules/@oscharko-dev/keiko-server/dist/diagnostics-log.d.ts.map +1 -1
  131. package/node_modules/@oscharko-dev/keiko-server/dist/diagnostics-log.js +97 -13
  132. package/node_modules/@oscharko-dev/keiko-server/dist/gateway-setup.d.ts.map +1 -1
  133. package/node_modules/@oscharko-dev/keiko-server/dist/gateway-setup.js +8 -3
  134. package/node_modules/@oscharko-dev/keiko-server/dist/grounded-entailment-stage.d.ts.map +1 -1
  135. package/node_modules/@oscharko-dev/keiko-server/dist/grounded-entailment-stage.js +7 -5
  136. package/node_modules/@oscharko-dev/keiko-server/dist/index.d.ts +1 -1
  137. package/node_modules/@oscharko-dev/keiko-server/dist/index.d.ts.map +1 -1
  138. package/node_modules/@oscharko-dev/keiko-server/dist/index.js +5 -2
  139. package/node_modules/@oscharko-dev/keiko-server/dist/memory-conflict-advisory.d.ts.map +1 -1
  140. package/node_modules/@oscharko-dev/keiko-server/dist/memory-conflict-advisory.js +9 -3
  141. package/node_modules/@oscharko-dev/keiko-server/dist/memory-consolidation-handlers.d.ts.map +1 -1
  142. package/node_modules/@oscharko-dev/keiko-server/dist/memory-consolidation-handlers.js +56 -19
  143. package/node_modules/@oscharko-dev/keiko-server/dist/memory-handlers.d.ts +1 -1
  144. package/node_modules/@oscharko-dev/keiko-server/dist/memory-handlers.d.ts.map +1 -1
  145. package/node_modules/@oscharko-dev/keiko-server/dist/memory-handlers.js +80 -29
  146. package/node_modules/@oscharko-dev/keiko-server/dist/memory-maintenance-handlers.d.ts +2 -0
  147. package/node_modules/@oscharko-dev/keiko-server/dist/memory-maintenance-handlers.d.ts.map +1 -1
  148. package/node_modules/@oscharko-dev/keiko-server/dist/memory-maintenance-handlers.js +18 -2
  149. package/node_modules/@oscharko-dev/keiko-server/dist/memory-salience.d.ts.map +1 -1
  150. package/node_modules/@oscharko-dev/keiko-server/dist/memory-salience.js +18 -7
  151. package/node_modules/@oscharko-dev/keiko-server/dist/observability/server-log.d.ts +1 -1
  152. package/node_modules/@oscharko-dev/keiko-server/dist/observability/server-log.d.ts.map +1 -1
  153. package/node_modules/@oscharko-dev/keiko-server/dist/observability/server-logger.d.ts.map +1 -1
  154. package/node_modules/@oscharko-dev/keiko-server/dist/observability/server-logger.js +1 -0
  155. package/node_modules/@oscharko-dev/keiko-server/dist/process-log-sink.d.ts +11 -0
  156. package/node_modules/@oscharko-dev/keiko-server/dist/process-log-sink.d.ts.map +1 -1
  157. package/node_modules/@oscharko-dev/keiko-server/dist/process-log-sink.js +17 -0
  158. package/node_modules/@oscharko-dev/keiko-server/dist/qualityIntelligence/figmaSnapshotRoutes.d.ts.map +1 -1
  159. package/node_modules/@oscharko-dev/keiko-server/dist/qualityIntelligence/figmaSnapshotRoutes.js +10 -4
  160. package/node_modules/@oscharko-dev/keiko-server/dist/sink.d.ts +4 -0
  161. package/node_modules/@oscharko-dev/keiko-server/dist/sink.d.ts.map +1 -1
  162. package/node_modules/@oscharko-dev/keiko-server/dist/sink.js +98 -0
  163. package/node_modules/@oscharko-dev/keiko-server/dist/store/messages.d.ts.map +1 -1
  164. package/node_modules/@oscharko-dev/keiko-server/dist/store/messages.js +16 -1
  165. package/node_modules/@oscharko-dev/keiko-server/dist/update-preflight-catalog.d.ts +2 -1
  166. package/node_modules/@oscharko-dev/keiko-server/dist/update-preflight-catalog.d.ts.map +1 -1
  167. package/node_modules/@oscharko-dev/keiko-server/dist/update-preflight-catalog.js +17 -2
  168. package/node_modules/@oscharko-dev/keiko-server/dist/update-preflight-routes.d.ts.map +1 -1
  169. package/node_modules/@oscharko-dev/keiko-server/dist/update-preflight-routes.js +2 -2
  170. package/node_modules/@oscharko-dev/keiko-server/dist/voice-realtime.d.ts +4 -0
  171. package/node_modules/@oscharko-dev/keiko-server/dist/voice-realtime.d.ts.map +1 -1
  172. package/node_modules/@oscharko-dev/keiko-server/dist/voice-realtime.js +68 -13
  173. package/node_modules/@oscharko-dev/keiko-server/package.json +21 -21
  174. package/node_modules/@oscharko-dev/keiko-tools/dist/version.d.ts +1 -1
  175. package/node_modules/@oscharko-dev/keiko-tools/dist/version.js +1 -1
  176. package/node_modules/@oscharko-dev/keiko-tools/package.json +5 -5
  177. package/node_modules/@oscharko-dev/keiko-verification/package.json +5 -5
  178. package/node_modules/@oscharko-dev/keiko-workflows/package.json +10 -10
  179. package/node_modules/@oscharko-dev/keiko-workspace/dist/version.d.ts +1 -1
  180. package/node_modules/@oscharko-dev/keiko-workspace/dist/version.js +1 -1
  181. package/node_modules/@oscharko-dev/keiko-workspace/package.json +3 -3
  182. package/package.json +26 -25
  183. package/release-impact.catalog.json +69 -12
  184. package/vendor/oscharko-dev-keiko-cli-0.3.17.tgz +0 -0
  185. package/vendor/{oscharko-dev-keiko-connectors-0.3.16.tgz → oscharko-dev-keiko-connectors-0.3.17.tgz} +0 -0
  186. package/vendor/{oscharko-dev-keiko-contracts-0.3.16.tgz → oscharko-dev-keiko-contracts-0.3.17.tgz} +0 -0
  187. package/vendor/{oscharko-dev-keiko-evaluations-0.3.16.tgz → oscharko-dev-keiko-evaluations-0.3.17.tgz} +0 -0
  188. package/vendor/{oscharko-dev-keiko-evidence-0.3.16.tgz → oscharko-dev-keiko-evidence-0.3.17.tgz} +0 -0
  189. package/vendor/{oscharko-dev-keiko-git-0.3.16.tgz → oscharko-dev-keiko-git-0.3.17.tgz} +0 -0
  190. package/vendor/oscharko-dev-keiko-harness-0.3.17.tgz +0 -0
  191. package/vendor/{oscharko-dev-keiko-local-knowledge-0.3.16.tgz → oscharko-dev-keiko-local-knowledge-0.3.17.tgz} +0 -0
  192. package/vendor/{oscharko-dev-keiko-memory-capture-0.3.16.tgz → oscharko-dev-keiko-memory-capture-0.3.17.tgz} +0 -0
  193. package/vendor/oscharko-dev-keiko-memory-consolidation-0.3.17.tgz +0 -0
  194. package/vendor/{oscharko-dev-keiko-memory-governance-0.3.16.tgz → oscharko-dev-keiko-memory-governance-0.3.17.tgz} +0 -0
  195. package/vendor/{oscharko-dev-keiko-memory-retrieval-0.3.16.tgz → oscharko-dev-keiko-memory-retrieval-0.3.17.tgz} +0 -0
  196. package/vendor/{oscharko-dev-keiko-memory-vault-0.3.16.tgz → oscharko-dev-keiko-memory-vault-0.3.17.tgz} +0 -0
  197. package/vendor/{oscharko-dev-keiko-model-gateway-0.3.16.tgz → oscharko-dev-keiko-model-gateway-0.3.17.tgz} +0 -0
  198. package/vendor/{oscharko-dev-keiko-quality-intelligence-0.3.16.tgz → oscharko-dev-keiko-quality-intelligence-0.3.17.tgz} +0 -0
  199. package/vendor/{oscharko-dev-keiko-sandbox-0.3.16.tgz → oscharko-dev-keiko-sandbox-0.3.17.tgz} +0 -0
  200. package/vendor/{oscharko-dev-keiko-sdk-0.3.16.tgz → oscharko-dev-keiko-sdk-0.3.17.tgz} +0 -0
  201. package/vendor/oscharko-dev-keiko-security-0.3.17.tgz +0 -0
  202. package/vendor/oscharko-dev-keiko-server-0.3.17.tgz +0 -0
  203. package/vendor/{oscharko-dev-keiko-tools-0.3.16.tgz → oscharko-dev-keiko-tools-0.3.17.tgz} +0 -0
  204. package/vendor/{oscharko-dev-keiko-verification-0.3.16.tgz → oscharko-dev-keiko-verification-0.3.17.tgz} +0 -0
  205. package/vendor/{oscharko-dev-keiko-workflows-0.3.16.tgz → oscharko-dev-keiko-workflows-0.3.17.tgz} +0 -0
  206. package/vendor/{oscharko-dev-keiko-workspace-0.3.16.tgz → oscharko-dev-keiko-workspace-0.3.17.tgz} +0 -0
  207. package/vendor/oscharko-dev-keiko-cli-0.3.16.tgz +0 -0
  208. package/vendor/oscharko-dev-keiko-harness-0.3.16.tgz +0 -0
  209. package/vendor/oscharko-dev-keiko-memory-consolidation-0.3.16.tgz +0 -0
  210. package/vendor/oscharko-dev-keiko-security-0.3.16.tgz +0 -0
  211. package/vendor/oscharko-dev-keiko-server-0.3.16.tgz +0 -0
  212. /package/dist/ui/static/_next/static/{nV-Flxo4itfIzasbhujy9 → C3-P-HHUm15MLLjtORoPG}/_buildManifest.js +0 -0
  213. /package/dist/ui/static/_next/static/{nV-Flxo4itfIzasbhujy9 → C3-P-HHUm15MLLjtORoPG}/_clientMiddlewareManifest.js +0 -0
  214. /package/dist/ui/static/_next/static/{nV-Flxo4itfIzasbhujy9 → C3-P-HHUm15MLLjtORoPG}/_ssgManifest.js +0 -0
@@ -1,3 +1,4 @@
1
+ import { type ServerDiagnosticSink } from "./diagnostics-log.js";
1
2
  export interface StreamEvent {
2
3
  readonly schemaVersion: "1";
3
4
  readonly runId: string;
@@ -13,6 +14,7 @@ export interface SseWriter {
13
14
  export interface QueueEventSinkOptions {
14
15
  readonly bufferCapacity?: number | undefined;
15
16
  readonly maxBytes?: number | undefined;
17
+ readonly diagnostics?: ServerDiagnosticSink | undefined;
16
18
  }
17
19
  export declare class QueueEventSink {
18
20
  private readonly buffer;
@@ -20,8 +22,10 @@ export declare class QueueEventSink {
20
22
  private readonly capacity;
21
23
  private readonly maxBytes;
22
24
  private readonly writers;
25
+ private readonly diagnostics;
23
26
  private terminated;
24
27
  readonly emit: (event: StreamEvent) => void;
28
+ private teeTerminalDiagnostic;
25
29
  constructor(options?: QueueEventSinkOptions);
26
30
  attach(writer: SseWriter, afterSeq: number): () => void;
27
31
  closeAll(): void;
@@ -1 +1 @@
1
- {"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../src/sink.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAQD,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAaD,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,UAAU,CAAS;IAG3B,QAAQ,CAAC,IAAI,UAAW,WAAW,KAAG,IAAI,CAyBxC;IAEF,YAAY,OAAO,GAAE,qBAA0B,EAU9C;IAKD,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,IAAI,CActD;IAID,QAAQ,IAAI,IAAI,CASf;IAED,YAAY,IAAI,OAAO,CAEtB;IAGD,QAAQ,CAAC,QAAQ,SAAK,GAAG,SAAS,WAAW,EAAE,CAE9C;IAID,gBAAgB,IAAI,MAAM,CAEzB;CACF"}
1
+ {"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../src/sink.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,sBAAsB,CAAC;AAM9B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAqGD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAQD,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAIvC,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACzD;AAaD,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAC/D,OAAO,CAAC,UAAU,CAAS;IAG3B,QAAQ,CAAC,IAAI,UAAW,WAAW,KAAG,IAAI,CA0BxC;IAKF,OAAO,CAAC,qBAAqB;IAe7B,YAAY,OAAO,GAAE,qBAA0B,EAW9C;IAKD,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,IAAI,CActD;IAID,QAAQ,IAAI,IAAI,CASf;IAED,YAAY,IAAI,OAAO,CAEtB;IAGD,QAAQ,CAAC,QAAQ,SAAK,GAAG,SAAS,WAAW,EAAE,CAE9C;IAID,gBAAgB,IAAI,MAAM,CAEzB;CACF"}
@@ -10,6 +10,83 @@
10
10
  // dropped past the cap), and (b) fans the event out to any currently-attached SSE writers. A late or
11
11
  // reconnecting subscriber replays the buffer (respecting Last-Event-ID = the harness `seq`), then
12
12
  // receives live events, then a close after the terminal event.
13
+ //
14
+ // (c) it also tees every TERMINAL event (run:completed/failed/cancelled, bug:completed/failed,
15
+ // workflow:completed/failed — #2902 w4b) through `emitServerDiagnostic`, keyed by the event's own
16
+ // `runId`. Before this, a run's terminal outcome existed ONLY as an SSE frame: if no writer was
17
+ // attached when it fired — a closed browser tab, a dropped connection — the outcome was fanned out
18
+ // to nobody, and once the ring buffer's TTL expired it left no trace anywhere, including
19
+ // `server.log`. The tee makes the terminal outcome durable regardless of who, if anyone, was
20
+ // listening on SSE at the moment it happened.
21
+ import { emitServerDiagnostic, } from "./diagnostics-log.js";
22
+ import { machineToken } from "./observability/error-classification.js";
23
+ const TERMINAL_DIAGNOSTICS = {
24
+ "run:completed": {
25
+ operation: "harness.run.completed",
26
+ errorClass: "HarnessRunCompleted",
27
+ message: "Harness run reached a terminal completed state.",
28
+ },
29
+ "run:failed": {
30
+ operation: "harness.run.failed",
31
+ errorClass: "HarnessRunFailed",
32
+ message: "Harness run reached a terminal failed state.",
33
+ },
34
+ "run:cancelled": {
35
+ operation: "harness.run.cancelled",
36
+ errorClass: "HarnessRunCancelled",
37
+ message: "Harness run reached a terminal cancelled state.",
38
+ },
39
+ "bug:completed": {
40
+ operation: "workflow.bug-investigation.completed",
41
+ errorClass: "BugInvestigationCompleted",
42
+ message: "Bug-investigation workflow reached a terminal completed state.",
43
+ },
44
+ "bug:failed": {
45
+ operation: "workflow.bug-investigation.failed",
46
+ errorClass: "BugInvestigationFailed",
47
+ message: "Bug-investigation workflow reached a terminal failed state.",
48
+ },
49
+ "workflow:completed": {
50
+ operation: "workflow.unit-tests.completed",
51
+ errorClass: "UnitTestWorkflowCompleted",
52
+ message: "Unit-test workflow reached a terminal completed state.",
53
+ },
54
+ "workflow:failed": {
55
+ operation: "workflow.unit-tests.failed",
56
+ errorClass: "UnitTestWorkflowFailed",
57
+ message: "Unit-test workflow reached a terminal failed state.",
58
+ },
59
+ };
60
+ function stringOrUndefined(value) {
61
+ return typeof value === "string" ? value : undefined;
62
+ }
63
+ // Every terminal type that carries a machine-readable outcome code names it directly
64
+ // (`errorCode`) or nests it one level under a closed-vocabulary field (`failure.category` — a
65
+ // HARNESS_CODE; `atState` — a HarnessStateName; `status` — a BugWorkflowStatus/WorkflowStatus) —
66
+ // never free text such as `report`/`reason`/`failure.message`, which no extractor here reads. A
67
+ // type absent from this table (e.g. `run:completed`, which carries no outcome code) yields
68
+ // `undefined` via the lookup miss in `terminalDiagnosticCode`, not a listed no-op branch.
69
+ //
70
+ // `errorCode` is NOT itself a closed union at its producer (bug-investigation/stages.ts sets it
71
+ // to `error instanceof Error ? error.name : "UNKNOWN"` — a mutable, caller-settable `Error.name`),
72
+ // unlike `failure.category` / `atState` / `status`, which are already closed unions at their
73
+ // source. So the `bug:failed` / `workflow:failed` extractors additionally bound it through
74
+ // `machineToken` (MACHINE_TOKEN_SHAPE) here, at the writer, rather than trusting it as free-form
75
+ // `string` and leaving the bound to whatever generic redaction runs downstream.
76
+ const CODE_EXTRACTORS = {
77
+ "run:failed": (raw) => stringOrUndefined(raw.failure?.category),
78
+ "run:cancelled": (raw) => stringOrUndefined(raw.atState),
79
+ "bug:completed": (raw) => stringOrUndefined(raw.status),
80
+ "bug:failed": (raw) => machineToken(raw.errorCode),
81
+ "workflow:completed": (raw) => stringOrUndefined(raw.status),
82
+ "workflow:failed": (raw) => machineToken(raw.errorCode),
83
+ };
84
+ // Reads a bounded, machine-token-shaped outcome code off a terminal event without importing any
85
+ // concrete event union into this structurally-typed sink (see header comment).
86
+ function terminalDiagnosticCode(event) {
87
+ const extractor = CODE_EXTRACTORS[event.type];
88
+ return extractor === undefined ? undefined : extractor(event);
89
+ }
13
90
  const DEFAULT_BUFFER_CAPACITY = 512;
14
91
  // 1 MiB parity with CODING_RUNTIME_EVENT_HUB_MAX_BYTES. Small enough that one large
15
92
  // patch:proposed diff cannot pin megabytes of buffered replay per active run, big
@@ -26,6 +103,7 @@ export class QueueEventSink {
26
103
  capacity;
27
104
  maxBytes;
28
105
  writers = new Set();
106
+ diagnostics;
29
107
  terminated = false;
30
108
  // Bound so the sink can be passed directly as an `EventSink`/`WorkflowEventSink`/`BugWorkflowEventSink`.
31
109
  emit = (event) => {
@@ -38,6 +116,7 @@ export class QueueEventSink {
38
116
  break;
39
117
  this.bufferedBytes -= dropped.bytes;
40
118
  }
119
+ this.teeTerminalDiagnostic(event);
41
120
  const failed = [];
42
121
  for (const writer of this.writers) {
43
122
  try {
@@ -56,6 +135,24 @@ export class QueueEventSink {
56
135
  }
57
136
  }
58
137
  };
138
+ // Writes a durable operator diagnostic for a terminal event's outcome, independent of whether
139
+ // any SSE writer was attached to receive it. `emitServerDiagnostic` never throws, so a
140
+ // diagnostics-sink failure can never interrupt the SSE fan-out this method runs alongside.
141
+ teeTerminalDiagnostic(event) {
142
+ const label = TERMINAL_DIAGNOSTICS[event.type];
143
+ if (label === undefined)
144
+ return;
145
+ const code = terminalDiagnosticCode(event);
146
+ emitServerDiagnostic(this.diagnostics, {
147
+ correlationId: event.runId,
148
+ timestamp: new Date().toISOString(),
149
+ operation: label.operation,
150
+ source: "sink.terminal-event",
151
+ errorClass: label.errorClass,
152
+ message: label.message,
153
+ ...(code === undefined ? {} : { code }),
154
+ });
155
+ }
59
156
  constructor(options = {}) {
60
157
  this.capacity = options.bufferCapacity ?? DEFAULT_BUFFER_CAPACITY;
61
158
  const maxBytes = options.maxBytes ?? DEFAULT_MAX_BUFFER_BYTES;
@@ -66,6 +163,7 @@ export class QueueEventSink {
66
163
  throw new RangeError("QueueEventSink maxBytes must be a finite, non-negative number");
67
164
  }
68
165
  this.maxBytes = maxBytes;
166
+ this.diagnostics = options.diagnostics;
69
167
  }
70
168
  // Attaches an SSE writer: replays the buffered events with `seq` strictly greater than
71
169
  // `afterSeq` (Last-Event-ID resume), then keeps the writer attached for live fan-out. Returns a
@@ -1 +1 @@
1
- {"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/store/messages.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/store/messages.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,OAAO,KAAK,EAEV,WAAW,EAEX,aAAa,EACb,cAAc,EACd,cAAc,EACd,gCAAgC,EAChC,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAuPpB,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CASzD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAIhG;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,EAChB,aAAa,EAAE,MAAM,GACpB,eAAe,GAAG,SAAS,CAiB7B;AA0DD,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAErF;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,SAAS,WAAW,EAAE,CAOxB;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,SAAS,WAAW,EAAE,CAOxB;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGrF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAUD,wBAAgB,cAAc,CAC5B,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAclB;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,MAAM,GACnB,IAAI,CAsBN;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAYT;AAoMD,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,oBAAoB,EAAE,MAAM,EAC5B,KAAK,EAAE,MAAM,GACZ,SAAS,WAAW,EAAE,CAKxB;AAED,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAQpE;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EACnC,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,SAAS,EAC3B,uBAAuB,CAAC,EAAE,MAAM,GAC/B,WAAW,CA2Bb;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,cAAc,EACtB,gBAAgB,EAAE,SAAS,gCAAgC,EAAE,GAAG,SAAS,EACzE,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAClC,WAAW,CAeb;AAED,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,GACT,SAAS,gCAAgC,EAAE,GAAG,SAAS,CAKzD;AA8BD,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,kBAAkB,EAAE,MAAM,EAC1B,0BAA0B,EAAE,MAAM,GAAG,SAAS,GAC7C,IAAI,CASN;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,EAC7B,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAClC,WAAW,CA6Bb;AAMD,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,WAAW,CA6Bb"}
@@ -3,7 +3,9 @@
3
3
  // - `cancelled` to the accepted workflow status set (parity with src/ui/runs.ts RunStatus).
4
4
  // - `task_type` column read/write so non-workflow runs (verify/explain-plan) can be labelled.
5
5
  // - updateMessage(): partial PATCH on the row, re-using the existing redact+truncate path.
6
+ import { randomUUID } from "node:crypto";
6
7
  import { validateKnowledgePodRetrievalActivity } from "@oscharko-dev/keiko-contracts";
8
+ import { contentFreeErrorClass, emitServerDiagnostic } from "../diagnostics-log.js";
7
9
  import { invalidRequest, notFound, UiStoreError } from "./errors.js";
8
10
  const MAX_SHORT_RESULT = 200;
9
11
  const MAX_TASK_TYPE = 64;
@@ -77,7 +79,20 @@ function parseGroundedPreviewCitations(raw) {
77
79
  try {
78
80
  return JSON.parse(raw);
79
81
  }
80
- catch {
82
+ catch (error) {
83
+ // Previously this silently dropped a corrupted stored citation row: the caller got back
84
+ // `undefined` with no trace anywhere that the row was malformed. Log a content-free
85
+ // diagnostic (error CLASS only — never the row itself, which can carry document text) noting
86
+ // the drop, then keep failing open: a stored preview annotation is not worth turning an
87
+ // otherwise-successful message read into a 500.
88
+ emitServerDiagnostic(undefined, {
89
+ correlationId: randomUUID(),
90
+ timestamp: new Date().toISOString(),
91
+ operation: "store.messages.grounded-preview-citations.read",
92
+ source: "store.messages.parse-grounded-preview-citations",
93
+ errorClass: contentFreeErrorClass(error),
94
+ message: "grounded-preview-citations-row-dropped",
95
+ });
81
96
  return undefined;
82
97
  }
83
98
  }
@@ -1,6 +1,7 @@
1
1
  import type { ReleaseImpactCatalog, ReleaseImpactEntry } from "@oscharko-dev/keiko-contracts";
2
+ import { type ServerDiagnosticSink } from "./diagnostics-log.js";
2
3
  export declare function bundledCatalogSearchRoots(): readonly string[];
3
4
  export declare function isBundledCatalogEntry(entry: unknown): entry is ReleaseImpactEntry;
4
5
  export declare function validateBundledCatalog(raw: unknown): ReleaseImpactCatalog | undefined;
5
- export declare function readBundledCatalogFromDisk(): ReleaseImpactCatalog | undefined;
6
+ export declare function readBundledCatalogFromDisk(diagnosticsSink?: ServerDiagnosticSink): ReleaseImpactCatalog | undefined;
6
7
  //# sourceMappingURL=update-preflight-catalog.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"update-preflight-catalog.d.ts","sourceRoot":"","sources":["../src/update-preflight-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,+BAA+B,CAAC;AAwFvC,wBAAgB,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAW7D;AAyDD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CASjF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAMrF;AAED,wBAAgB,0BAA0B,IAAI,oBAAoB,GAAG,SAAS,CAmB7E"}
1
+ {"version":3,"file":"update-preflight-catalog.d.ts","sourceRoot":"","sources":["../src/update-preflight-catalog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAiF9B,wBAAgB,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAW7D;AAyDD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CASjF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAMrF;AAED,wBAAgB,0BAA0B,CACxC,eAAe,CAAC,EAAE,oBAAoB,GACrC,oBAAoB,GAAG,SAAS,CAgClC"}
@@ -1,8 +1,10 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
2
  import { dirname, join } from "node:path";
3
3
  import { fileURLToPath } from "node:url";
4
+ import { randomUUID } from "node:crypto";
4
5
  import { RELEASE_IMPACT_CATEGORIES, RELEASE_IMPACT_PRIORITIES, RELEASE_IMPACT_PUBLISH_GATES, RELEASE_IMPACT_REMEDIATIONS, } from "@oscharko-dev/keiko-contracts";
5
6
  import { isRecord, isStableVersionString } from "./update-preflight-registry.js";
7
+ import { contentFreeErrorClass, emitServerDiagnostic, } from "./diagnostics-log.js";
6
8
  const RELEASE_IMPACT_USER_VISIBLE_CHANGES = [
7
9
  "none",
8
10
  "observable",
@@ -128,7 +130,7 @@ export function validateBundledCatalog(raw) {
128
130
  const entries = raw.entries.filter(isBundledCatalogEntry);
129
131
  return { schemaVersion: 1, entries };
130
132
  }
131
- export function readBundledCatalogFromDisk() {
133
+ export function readBundledCatalogFromDisk(diagnosticsSink) {
132
134
  for (const root of bundledCatalogSearchRoots()) {
133
135
  const candidate = join(root, "release-impact.catalog.json");
134
136
  if (!existsSync(candidate))
@@ -143,7 +145,20 @@ export function readBundledCatalogFromDisk() {
143
145
  bundledCatalogCache.set(candidate, validated);
144
146
  return validated;
145
147
  }
146
- catch {
148
+ catch (error) {
149
+ // Previously this discarded the read/parse failure entirely and cached "invalid" with no
150
+ // diagnostic and no retry — an operator running a build with a corrupted bundled catalog
151
+ // would silently lose release-impact-driven update warnings forever with no trace of why.
152
+ // Log a content-free diagnostic (error CLASS only, never the file content or the parse
153
+ // exception message) so the failure is visible before caching the negative result.
154
+ emitServerDiagnostic(diagnosticsSink, {
155
+ correlationId: randomUUID(),
156
+ timestamp: new Date().toISOString(),
157
+ operation: "update.preflight.bundled-catalog.read",
158
+ source: "update-preflight-catalog.read-bundled-catalog-from-disk",
159
+ errorClass: contentFreeErrorClass(error),
160
+ message: "release-impact-bundled-catalog-corrupted",
161
+ });
147
162
  bundledCatalogCache.set(candidate, undefined);
148
163
  return undefined;
149
164
  }
@@ -1 +1 @@
1
- {"version":3,"file":"update-preflight-routes.d.ts","sourceRoot":"","sources":["../src/update-preflight-routes.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAGtB,KAAK,qBAAqB,EAE3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAsB7D,UAAU,6BAA6B;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,iBAAiB,CAAC,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACtE,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrE;AA2JD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CAgBhC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,CAWxB;AA2BD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAEtB"}
1
+ {"version":3,"file":"update-preflight-routes.d.ts","sourceRoot":"","sources":["../src/update-preflight-routes.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAGtB,KAAK,qBAAqB,EAE3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAsB7D,UAAU,6BAA6B;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,iBAAiB,CAAC,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACtE,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrE;AA6JD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CAgBhC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,CAWxB;AA2BD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAEtB"}
@@ -7,7 +7,7 @@ import { readBundledCatalogFromDisk, validateBundledCatalog } from "./update-pre
7
7
  import { impactFromCatalog } from "./update-preflight-impact.js";
8
8
  import { currentVersionReport, degradedRegistryReport, portableCurrentVersionReport, portableInstallModeBlockedReport, portableReleaseUnavailableReport, portableUpdateAvailableReport, reportBase, updateAvailableReportFromOutcomes, } from "./update-preflight-report.js";
9
9
  async function updateAvailableReport(deps, base, currentVersion, targetVersion, registry, options) {
10
- const catalog = validateBundledCatalog(options.bundledCatalog) ?? readBundledCatalogFromDisk();
10
+ const catalog = validateBundledCatalog(options.bundledCatalog) ?? readBundledCatalogFromDisk(deps.diagnostics);
11
11
  const impactResolution = impactFromCatalog(catalog, currentVersion, targetVersion);
12
12
  const github = await fetchGitHubRelease(deps, targetVersion);
13
13
  const fallbackRelease = fallbackReleaseFromImpact(targetVersion, impactResolution.impact);
@@ -46,7 +46,7 @@ async function portablePreflightReport(deps, base, currentVersion, target, optio
46
46
  if (compareSemver(outcome.targetVersion, currentVersion) <= 0) {
47
47
  return portableCurrentVersionReport(base, outcome.targetVersion, outcome.release, outcome.portableAsset, outcome.warnings);
48
48
  }
49
- const catalog = validateBundledCatalog(options.bundledCatalog) ?? readBundledCatalogFromDisk();
49
+ const catalog = validateBundledCatalog(options.bundledCatalog) ?? readBundledCatalogFromDisk(deps.diagnostics);
50
50
  const impactResolution = impactFromCatalog(catalog, currentVersion, outcome.targetVersion);
51
51
  return portableUpdateAvailableReport(base, outcome.targetVersion, outcome.release, outcome.portableAsset, impactResolution, outcome.blockers, outcome.warnings);
52
52
  }
@@ -3,6 +3,7 @@ import type { Duplex } from "node:stream";
3
3
  import { type RealtimeNegotiationOutcome, type VoiceCapabilityResolution } from "@oscharko-dev/keiko-model-gateway";
4
4
  import { type VoiceControlMessage, type VoiceProfile, type VoiceProviderLocality, type VoiceSessionChatContext } from "@oscharko-dev/keiko-contracts";
5
5
  import { type UiHandlerDeps } from "./deps.js";
6
+ import { type ServerDiagnosticSink } from "./diagnostics-log.js";
6
7
  export declare const VOICE_CONTROL_PATH = "/api/voice/control";
7
8
  export declare const MAX_VOICE_CONTROL_FRAME_BYTES = 320000;
8
9
  interface SessionState {
@@ -34,6 +35,7 @@ export interface VoiceControlConnectionOptions {
34
35
  readonly negotiate: NegotiateFn;
35
36
  readonly redact: (value: unknown) => unknown;
36
37
  readonly correlationId: string;
38
+ readonly diagnostics: ServerDiagnosticSink | undefined;
37
39
  }
38
40
  export declare class VoiceControlConnection {
39
41
  private readonly socket;
@@ -41,11 +43,13 @@ export declare class VoiceControlConnection {
41
43
  private readonly negotiate;
42
44
  private readonly redact;
43
45
  private readonly correlationId;
46
+ private readonly diagnostics;
44
47
  private negotiation;
45
48
  private closed;
46
49
  constructor(options: VoiceControlConnectionOptions);
47
50
  start(resume: boolean): void;
48
51
  receive(raw: string): Promise<void>;
52
+ private endSession;
49
53
  dispose(): void;
50
54
  private dispatchIn;
51
55
  private cancelNegotiation;
@@ -1 +1 @@
1
- {"version":3,"file":"voice-realtime.d.ts","sourceRoot":"","sources":["../src/voice-realtime.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"voice-realtime.d.ts","sourceRoot":"","sources":["../src/voice-realtime.ts"],"names":[],"mappings":"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"}
@@ -23,6 +23,8 @@ import { isAllowedHost } from "./host-check.js";
23
23
  import { resolveCorrelationId } from "./correlation.js";
24
24
  import { currentGatewayConfig, currentGatewayEgressConfig } from "./deps.js";
25
25
  import { isVoiceDisabledByPolicy, isVoiceRealtimeCapable } from "./read-handlers.js";
26
+ import { emitServerDiagnostic, serverDiagnosticFromError, } from "./diagnostics-log.js";
27
+ import { getServerLogger } from "./observability/index.js";
26
28
  // The single loopback path the BFF WebSocket upgrade is re-opened for. Every other upgrade keeps the
27
29
  // hard 404 + socket.destroy() default (server.ts).
28
30
  export const VOICE_CONTROL_PATH = "/api/voice/control";
@@ -182,6 +184,17 @@ function buildNegotiationRequest(config, provider, offerSdp, deps, signal, safet
182
184
  ...(egress !== undefined ? { egress } : {}),
183
185
  };
184
186
  }
187
+ // Mirrors voice-live-dictation.ts's LiveDictationNegotiationError: a content-free stand-in error
188
+ // used only when a negotiation outcome carries a failure kind but no underlying thrown value (a
189
+ // typed protocol-level rejection rather than a caught exception), so serverDiagnosticFromError
190
+ // always has an Error-shaped input to classify.
191
+ class RealtimeControlNegotiationError extends Error {
192
+ code;
193
+ constructor(code) {
194
+ super("realtime control negotiation failed");
195
+ this.code = code;
196
+ }
197
+ }
185
198
  // The protocol state machine for one attached control socket. Pure of WebSocket/IO concerns beyond
186
199
  // the injected `socket.send` — every inbound frame is validated against the #496 contract, gated by
187
200
  // the session profile, and answered per the protocol; every outbound frame is sequenced, redacted,
@@ -192,6 +205,7 @@ export class VoiceControlConnection {
192
205
  negotiate;
193
206
  redact;
194
207
  correlationId;
208
+ diagnostics;
195
209
  negotiation;
196
210
  closed = false;
197
211
  constructor(options) {
@@ -200,11 +214,22 @@ export class VoiceControlConnection {
200
214
  this.negotiate = options.negotiate;
201
215
  this.redact = options.redact;
202
216
  this.correlationId = options.correlationId;
217
+ this.diagnostics = options.diagnostics;
203
218
  }
204
219
  // Re-delivers the buffered replayable events to a (re)attached client, then announces the resolved
205
220
  // session — the reconnect catch-up of protocol §7. The additive productive constant keeps the
206
221
  // WebSocket realization distinct from the immutable v1 HTTP/SSE compatibility value.
207
222
  start(resume) {
223
+ // Structured, correlation-keyed session-lifecycle line (w4b-voice-realtime, #2902): brackets
224
+ // dispose()'s session-ended line so an operator/agent reconstructing a defect can see exactly
225
+ // how long a control-plane session was attached. Content-free — profile and resume are both
226
+ // closed-vocabulary/boolean values, never the session or idempotency id.
227
+ getServerLogger().info({
228
+ category: "http",
229
+ op: "voice.realtime.session-started",
230
+ correlationId: this.correlationId,
231
+ extra: { profile: this.session.profile, resumed: resume },
232
+ });
208
233
  if (resume) {
209
234
  for (const buffered of replayEvents(this.session)) {
210
235
  this.dispatchOut(buffered);
@@ -267,12 +292,31 @@ export class VoiceControlConnection {
267
292
  this.session.lastClientSeq = Math.max(this.session.lastClientSeq, message.seq);
268
293
  await this.dispatchIn(message);
269
294
  }
270
- // Aborts any in-flight negotiation and marks the connection closed (socket lifecycle ended). The
271
- // session record is retained by the plane for the resume window; this only detaches the socket.
272
- dispose() {
295
+ // Marks the connection closed exactly once and aborts any in-flight negotiation. Shared by
296
+ // dispose() (the plane's ws "close" handler — an abrupt disconnect) and shutdown() (an explicit
297
+ // protocol-driven close, e.g. session.close or fail()) so the session-ended line brackets
298
+ // start()'s session-started line exactly once, whichever path reaches the connection's end
299
+ // first (w4b-voice-realtime, #2902). Returns whether this call performed the transition, so a
300
+ // caller that still owns follow-up work (shutdown()'s socket.close) can skip it when a prior
301
+ // call already closed the connection.
302
+ endSession() {
303
+ if (this.closed) {
304
+ return false;
305
+ }
273
306
  this.closed = true;
307
+ getServerLogger().info({
308
+ category: "http",
309
+ op: "voice.realtime.session-ended",
310
+ correlationId: this.correlationId,
311
+ });
274
312
  this.negotiation?.abort();
275
313
  this.negotiation = undefined;
314
+ return true;
315
+ }
316
+ // Aborts any in-flight negotiation and marks the connection closed (socket lifecycle ended). The
317
+ // session record is retained by the plane for the resume window; this only detaches the socket.
318
+ dispose() {
319
+ this.endSession();
276
320
  }
277
321
  async dispatchIn(message) {
278
322
  // Only the kinds that drive a host action are handled. Every other permitted kind is an
@@ -309,9 +353,18 @@ export class VoiceControlConnection {
309
353
  this.negotiation?.abort();
310
354
  this.negotiation = undefined;
311
355
  }
312
- failNegotiation() {
313
- // Same connection-scoped correlation id as every other negotiation attempt on this socket
314
- // (RB-6 / ADR-0173 D5) — never re-minted per failure.
356
+ // Mirrors voice-live-dictation.ts's reportNegotiationFailure (RB-6 / ADR-0173 D5, #2902
357
+ // w4b-voice-realtime): emits a body-free structured diagnostic — carrying the connection-scoped
358
+ // correlation id, never re-minted per failure — before answering the client's protocol error.
359
+ failNegotiation(kind, thrown) {
360
+ const diagnostic = serverDiagnosticFromError({
361
+ correlationId: this.correlationId,
362
+ operation: "voice.realtime.negotiate",
363
+ source: "voice.realtime",
364
+ error: thrown ?? new RealtimeControlNegotiationError(kind),
365
+ redact: (message) => String(this.redact(message)),
366
+ });
367
+ emitServerDiagnostic(this.diagnostics, { ...diagnostic, code: kind });
315
368
  this.emitError("negotiation-failed", this.correlationId);
316
369
  this.emit({ kind: "media.track.state", track: "audio-in", state: "ended" });
317
370
  }
@@ -326,10 +379,14 @@ export class VoiceControlConnection {
326
379
  superseded?.abort();
327
380
  this.emit({ kind: "media.track.state", track: "audio-in", state: "negotiating" });
328
381
  let outcome;
382
+ let thrown;
329
383
  try {
330
384
  outcome = await this.negotiate(offerSdp, this.session.chatContext, controller.signal);
331
385
  }
332
- catch {
386
+ catch (error) {
387
+ // Provider transports may reject instead of returning a typed failure. Preserve the thrown
388
+ // class for the redacted diagnostic while normalizing its stable machine code below.
389
+ thrown = error;
333
390
  outcome = { ok: false, kind: "transport" };
334
391
  }
335
392
  if (this.negotiation !== controller) {
@@ -341,11 +398,11 @@ export class VoiceControlConnection {
341
398
  return;
342
399
  }
343
400
  if (!outcome.ok) {
344
- this.failNegotiation();
401
+ this.failNegotiation(outcome.kind, thrown);
345
402
  return;
346
403
  }
347
404
  if (!isApprovedDirectionalSdp(outcome.value.answerSdp, "recvonly")) {
348
- this.failNegotiation();
405
+ this.failNegotiation("invalid-response", undefined);
349
406
  return;
350
407
  }
351
408
  // signal.sdp.answer is ephemeral + secret-bearing: it is sent to the live negotiation but never
@@ -397,12 +454,9 @@ export class VoiceControlConnection {
397
454
  this.shutdown(1008, code);
398
455
  }
399
456
  shutdown(code, reason) {
400
- if (this.closed) {
457
+ if (!this.endSession()) {
401
458
  return;
402
459
  }
403
- this.closed = true;
404
- this.negotiation?.abort();
405
- this.negotiation = undefined;
406
460
  try {
407
461
  this.socket.close(code, reason);
408
462
  }
@@ -703,6 +757,7 @@ class VoiceControlPlaneImpl {
703
757
  negotiate,
704
758
  redact: deps.redactor,
705
759
  correlationId,
760
+ diagnostics: deps.diagnostics,
706
761
  });
707
762
  connection.start(resolved.resume);
708
763
  });
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oscharko-dev/keiko-server",
3
- "version": "0.3.16",
3
+ "version": "0.3.17",
4
4
  "type": "module",
5
5
  "license": "Apache-2.0",
6
6
  "description": "Internal server package: local loopback BFF runtime (HTTP/SSE/WebSocket router, CSP, host check, CSRF gate, terminal, browser, files, run engine, SQLite-backed UI store) that mediates the browser presentation tier and the Node-side domain packages (ADR-0019). Not published independently.",
@@ -31,25 +31,25 @@
31
31
  },
32
32
  "private": true,
33
33
  "peerDependencies": {
34
- "@oscharko-dev/keiko-connectors": "0.3.16",
35
- "@oscharko-dev/keiko-contracts": "0.3.16",
36
- "@oscharko-dev/keiko-evidence": "0.3.16",
37
- "@oscharko-dev/keiko-git": "0.3.16",
38
- "@oscharko-dev/keiko-harness": "0.3.16",
39
- "@oscharko-dev/keiko-local-knowledge": "0.3.16",
40
- "@oscharko-dev/keiko-memory-capture": "0.3.16",
41
- "@oscharko-dev/keiko-memory-consolidation": "0.3.16",
42
- "@oscharko-dev/keiko-memory-governance": "0.3.16",
43
- "@oscharko-dev/keiko-memory-retrieval": "0.3.16",
44
- "@oscharko-dev/keiko-memory-vault": "0.3.16",
45
- "@oscharko-dev/keiko-model-gateway": "0.3.16",
46
- "@oscharko-dev/keiko-quality-intelligence": "0.3.16",
47
- "@oscharko-dev/keiko-sandbox": "0.3.16",
48
- "@oscharko-dev/keiko-sdk": "0.3.16",
49
- "@oscharko-dev/keiko-security": "0.3.16",
50
- "@oscharko-dev/keiko-tools": "0.3.16",
51
- "@oscharko-dev/keiko-verification": "0.3.16",
52
- "@oscharko-dev/keiko-workflows": "0.3.16",
53
- "@oscharko-dev/keiko-workspace": "0.3.16"
34
+ "@oscharko-dev/keiko-connectors": "0.3.17",
35
+ "@oscharko-dev/keiko-contracts": "0.3.17",
36
+ "@oscharko-dev/keiko-evidence": "0.3.17",
37
+ "@oscharko-dev/keiko-git": "0.3.17",
38
+ "@oscharko-dev/keiko-harness": "0.3.17",
39
+ "@oscharko-dev/keiko-local-knowledge": "0.3.17",
40
+ "@oscharko-dev/keiko-memory-capture": "0.3.17",
41
+ "@oscharko-dev/keiko-memory-consolidation": "0.3.17",
42
+ "@oscharko-dev/keiko-memory-governance": "0.3.17",
43
+ "@oscharko-dev/keiko-memory-retrieval": "0.3.17",
44
+ "@oscharko-dev/keiko-memory-vault": "0.3.17",
45
+ "@oscharko-dev/keiko-model-gateway": "0.3.17",
46
+ "@oscharko-dev/keiko-quality-intelligence": "0.3.17",
47
+ "@oscharko-dev/keiko-sandbox": "0.3.17",
48
+ "@oscharko-dev/keiko-sdk": "0.3.17",
49
+ "@oscharko-dev/keiko-security": "0.3.17",
50
+ "@oscharko-dev/keiko-tools": "0.3.17",
51
+ "@oscharko-dev/keiko-verification": "0.3.17",
52
+ "@oscharko-dev/keiko-workflows": "0.3.17",
53
+ "@oscharko-dev/keiko-workspace": "0.3.17"
54
54
  }
55
55
  }
@@ -1,2 +1,2 @@
1
- export declare const KEIKO_TOOLS_VERSION: "0.3.16";
1
+ export declare const KEIKO_TOOLS_VERSION: "0.3.17";
2
2
  //# sourceMappingURL=version.d.ts.map
@@ -1,3 +1,3 @@
1
1
  // Package version constant. Bumped in lockstep with the package.json version so consumers can
2
2
  // detect divergence in tests without parsing package metadata at runtime.
3
- export const KEIKO_TOOLS_VERSION = "0.3.16";
3
+ export const KEIKO_TOOLS_VERSION = "0.3.17";
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oscharko-dev/keiko-tools",
3
- "version": "0.3.16",
3
+ "version": "0.3.17",
4
4
  "type": "module",
5
5
  "license": "Apache-2.0",
6
6
  "description": "Internal tools package: Keiko safe tool-execution layer — terminal-policy command allowlist, env-isolated no-shell spawn, atomic patch workflow, browser CDP adapter, and the WorkspaceWriter boundary (ADR-0006 / ADR-0017). Not published independently.",
@@ -36,9 +36,9 @@
36
36
  },
37
37
  "private": true,
38
38
  "peerDependencies": {
39
- "@oscharko-dev/keiko-contracts": "0.3.16",
40
- "@oscharko-dev/keiko-sandbox": "0.3.16",
41
- "@oscharko-dev/keiko-security": "0.3.16",
42
- "@oscharko-dev/keiko-workspace": "0.3.16"
39
+ "@oscharko-dev/keiko-contracts": "0.3.17",
40
+ "@oscharko-dev/keiko-sandbox": "0.3.17",
41
+ "@oscharko-dev/keiko-security": "0.3.17",
42
+ "@oscharko-dev/keiko-workspace": "0.3.17"
43
43
  }
44
44
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oscharko-dev/keiko-verification",
3
- "version": "0.3.16",
3
+ "version": "0.3.17",
4
4
  "type": "module",
5
5
  "license": "Apache-2.0",
6
6
  "description": "Internal verification package: deterministic verification orchestrator — plan construction, resource-limit policy, best-effort memory monitoring, command classification, and audit/Markdown summaries (ADR-0007, ADR-0019). Not published independently.",
@@ -21,9 +21,9 @@
21
21
  },
22
22
  "private": true,
23
23
  "peerDependencies": {
24
- "@oscharko-dev/keiko-contracts": "0.3.16",
25
- "@oscharko-dev/keiko-security": "0.3.16",
26
- "@oscharko-dev/keiko-tools": "0.3.16",
27
- "@oscharko-dev/keiko-workspace": "0.3.16"
24
+ "@oscharko-dev/keiko-contracts": "0.3.17",
25
+ "@oscharko-dev/keiko-security": "0.3.17",
26
+ "@oscharko-dev/keiko-tools": "0.3.17",
27
+ "@oscharko-dev/keiko-workspace": "0.3.17"
28
28
  }
29
29
  }