@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 +1 @@
1
- {"version":3,"file":"support-export.d.ts","sourceRoot":"","sources":["../src/support-export.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"support-export.d.ts","sourceRoot":"","sources":["../src/support-export.ts"],"names":[],"mappings":"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"}
@@ -13,6 +13,7 @@
13
13
  // `support.ts` owns argv parsing, stdout/stderr, environment/state-dir resolution, and calling the
14
14
  // audit/evidence subsystems; this file owns everything that can be exercised without touching
15
15
  // argv, process.*, or another package's runtime.
16
+ import { createHash } from "node:crypto";
16
17
  import { closeSync, openSync, readFileSync, readSync, readdirSync, statSync } from "node:fs";
17
18
  import { join } from "node:path";
18
19
  import { isStoreFingerprint } from "@oscharko-dev/keiko-contracts";
@@ -23,6 +24,17 @@ import { isStoreFingerprint } from "@oscharko-dev/keiko-contracts";
23
24
  // byte is exactly as safe as `readVerbatimLogLines`'s existing full-file `split("\n")`.
24
25
  const NEWLINE_BYTE = 0x0a;
25
26
  export const CURRENT_LOG_FILE_NAME = "server.log";
27
+ // `lifecycle.ts`'s `logFile()` writes the UI/BFF process's raw, unredacted stdout+stderr here
28
+ // (`<stateDir>/ui.log`) — an acknowledged-unredacted operator channel, distinct from the redacted
29
+ // `server*.log` stream above. Named once here so the double-confirmation gate in `support.ts` and
30
+ // this module's own section builder never risk drifting on the literal.
31
+ export const UI_LOG_FILE_NAME = "ui.log";
32
+ // The one `sectionsExcluded` member Wave 6 introduces: always present unless the operator passed
33
+ // BOTH `--include-ui-log` AND `--i-understand-this-is-unredacted` on `keiko support export`
34
+ // (design doc §6.3) — a single flag is never sufficient consent. `support.ts` decides the gate (it
35
+ // owns argv); this constant keeps the section tag and the exclusion label byte-identical between
36
+ // the two files that need it.
37
+ export const UI_LOG_SECTION = "ui-log";
26
38
  // The sink's own DEFAULT_LOG_RETENTION_DAYS (7) keeps at most a week of rotated files on disk, so
27
39
  // 50MB is a generous ceiling for a single export; --max-bytes on the CLI overrides it.
28
40
  export const DEFAULT_MAX_BUNDLE_BYTES = 50 * 1024 * 1024;
@@ -280,7 +292,7 @@ export function buildSupportBundleManifest(input) {
280
292
  currentFileTailTruncated: input.currentFileTailTruncated,
281
293
  budgetExceeded: input.budgetExceeded,
282
294
  skippedLogFiles: input.skippedLogFiles,
283
- sectionsExcluded: [],
295
+ sectionsExcluded: input.sectionsExcluded,
284
296
  auditSummary: redactedAuditSummary(input.auditSummary),
285
297
  evidenceIndexCount: input.evidenceIndexCount,
286
298
  // Defense-in-depth (never trust the producer unconditionally, matching this repo's redaction
@@ -291,12 +303,34 @@ export function buildSupportBundleManifest(input) {
291
303
  storesUnavailable: partitioned.unavailable,
292
304
  };
293
305
  }
294
- // Line 1 (the manifest) plus every already-read content line, in file order. The manifest is
295
- // built from `readKeptFiles`'s result (see `support.ts`'s `runSupportExport`) so its
296
- // `sourceLogFiles`/`skippedLogFiles` reflect what was actually read, not merely what was kept
297
- // after the size budget — never touches an already-copied line's bytes.
298
- export function serializeBundleLines(manifest, contentLines) {
299
- return [JSON.stringify(manifest), ...contentLines];
306
+ export function buildUiLogSection(content) {
307
+ return { $section: "ui-log", content };
308
+ }
309
+ export function buildConfigSnapshotSection(fields) {
310
+ return { $section: "config-snapshot", fields };
311
+ }
312
+ export function buildEvidenceManifestSection(runId, manifest) {
313
+ return { $section: "evidence-manifest", runId, manifest };
314
+ }
315
+ // Line 1 (the manifest), then any Wave 6 `$section` records (config-snapshot always, ui-log and
316
+ // evidence-manifest only when their gates pass), then every already-read content line, in file
317
+ // order. The manifest is built from `readKeptFiles`'s result (see `support.ts`'s
318
+ // `runSupportExport`) so its `sourceLogFiles`/`skippedLogFiles` reflect what was actually read, not
319
+ // merely what was kept after the size budget — never touches an already-copied line's bytes.
320
+ export function serializeBundleLines(manifest, sections, contentLines) {
321
+ const sectionLines = sections.map((section) => JSON.stringify(section));
322
+ return [JSON.stringify(manifest), ...sectionLines, ...contentLines];
323
+ }
324
+ // A cheap integrity story for an artifact that crosses a customer-machine-to-agent trust boundary:
325
+ // the caller (`support.ts`) writes this hex digest to a `<output>.sha256` sidecar alongside the
326
+ // `.jsonl` bundle, computed over the EXACT bytes written to the bundle file (the same UTF-8
327
+ // encoding `writeFileSync(outPath, contents, "utf8")` produces) — not a gate requirement, but worth
328
+ // the one-line addition.
329
+ export function bundleSha256Hex(bundleContents) {
330
+ return createHash("sha256").update(bundleContents, "utf8").digest("hex");
331
+ }
332
+ export function sha256SidecarPath(outPath) {
333
+ return `${outPath}.sha256`;
300
334
  }
301
335
  // Joins lines with a single trailing newline, the same shape server-log.ts's own file sink writes
302
336
  // (one JSON object per line) so a bundle round-trips through the same line-splitting convention
@@ -14,11 +14,17 @@ interface ExportArgs {
14
14
  readonly out: string | undefined;
15
15
  readonly stateDir: string | undefined;
16
16
  readonly maxBytes: number | undefined;
17
+ readonly includeUiLog: boolean;
18
+ readonly iUnderstandUnredacted: boolean;
19
+ readonly includeEvidenceRunIds: readonly string[];
17
20
  }
18
21
  interface AnalyzeArgs {
19
22
  readonly file: string;
20
23
  readonly correlationId: string | undefined;
21
24
  readonly json: boolean;
25
+ readonly clusters: boolean;
26
+ readonly seed: boolean;
27
+ readonly emitFixture: string | undefined;
22
28
  }
23
29
  export type ParsedSupportArgs = {
24
30
  readonly kind: "help";
@@ -1 +1 @@
1
- {"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../src/support.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,KAAK,YAAY,EAAyC,MAAM,YAAY,CAAC;AAOtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA8CzC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACxC,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC9C,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CACpD;AAED,UAAU,UAAU;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAgE9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAc3E;AAuRD,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,KAAK,EACT,GAAG,GAAE,SAAc,EACnB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CAcjB"}
1
+ {"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../src/support.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,KAAK,YAAY,EAAyC,MAAM,YAAY,CAAC;AAOtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAgFzC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACxC,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC9C,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CACpD;AAED,UAAU,UAAU;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAGtC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAGvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAG3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AA8G9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAc3E;AA0hBD,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,KAAK,EACT,GAAG,GAAE,SAAc,EACnB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CAcjB"}
@@ -9,8 +9,8 @@
9
9
  // audit/evidence subsystems. The exporter's and analyzer's own logic — file discovery, size-budget
10
10
  // selection, manifest assembly, parsing, grouping, ordering, rendering — lives in
11
11
  // ./support-export.ts and ./support-analyze.ts, each independently unit-tested on data, not argv.
12
- import { readFileSync, writeFileSync } from "node:fs";
13
- import { isAbsolute, join, resolve } from "node:path";
12
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
13
+ import { dirname, isAbsolute, join, resolve } from "node:path";
14
14
  import { KEIKO_PRODUCT_VERSION } from "@oscharko-dev/keiko-contracts";
15
15
  import { AuditLoadError, auditLocalStateResult } from "./audit.js";
16
16
  // GEN-PERF-CLI-001 — the evidence graph (and, below, the server module graph) load at dispatch,
@@ -20,29 +20,47 @@ import { AuditLoadError, auditLocalStateResult } from "./audit.js";
20
20
  // same lazily-loaded server module, via `server.collectStoreFingerprints`.
21
21
  import { loadEvidence, loadServer } from "./lazy-modules.js";
22
22
  import { resolveStateDir } from "./state-paths.js";
23
- import { analyzeLogText, findTimeline, renderHumanAllTimelines, renderHumanTimeline, } from "./support-analyze.js";
24
- import { buildSupportBundleManifest, bundleText, DEFAULT_MAX_BUNDLE_BYTES, describeErrorKind, discoverServerLogFiles, readKeptFiles, selectLogFilesWithinBudget, serializeBundleLines, } from "./support-export.js";
23
+ import { analyzeLogText, buildReproductionSeed, findTimeline, renderGatewayReplayScriptFixture, renderHumanAllTimelines, renderHumanClusters, renderHumanReproductionSeed, renderHumanTimeline, } from "./support-analyze.js";
24
+ import { buildConfigSnapshotSection, buildEvidenceManifestSection, buildSupportBundleManifest, buildUiLogSection, bundleSha256Hex, bundleText, DEFAULT_MAX_BUNDLE_BYTES, describeErrorKind, discoverServerLogFiles, readKeptFiles, selectLogFilesWithinBudget, serializeBundleLines, sha256SidecarPath, UI_LOG_FILE_NAME, UI_LOG_SECTION, } from "./support-export.js";
25
25
  const USAGE = `Usage:
26
26
  keiko support export [--out PATH] [--state-dir PATH] [--max-bytes N]
27
- keiko support analyze FILE [--correlation-id ID] [--json]
27
+ [--include-ui-log --i-understand-this-is-unredacted]
28
+ [--include-evidence RUNID[,RUNID...]]
29
+ keiko support analyze FILE [--correlation-id ID] [--json] [--clusters]
30
+ [--seed] [--emit-fixture PATH]
28
31
 
29
32
  export writes a redacted .jsonl support bundle: a manifest line (local-state audit summary,
30
33
  evidence-index count, exactly which log files were copied, and a redacted schema/integrity
31
- fingerprint for each of the ui, local-knowledge, and memory-vault stores found under --state-dir)
32
- followed by every line of <state-dir>/logs/server*.log, copied byte-for-byte. A store that has
34
+ fingerprint for each of the ui, local-knowledge, and memory-vault stores found under --state-dir),
35
+ an always-present config-snapshot section (Keiko's own resolved KEIKO_* runtime configuration,
36
+ redacted), then every line of <state-dir>/logs/server*.log, copied byte-for-byte. A store that has
33
37
  never been used from this state dir, or that cannot be opened (corrupt, or a vault key the
34
38
  operator has not supplied), is named in the manifest's storesUnavailable instead of failing the
35
39
  export. Default --out is ./keiko-support-<timestamp>.jsonl (colons replaced with '-'); default
36
40
  --max-bytes is 50MB — the oldest log files are dropped first when the cap would be exceeded, and
37
41
  always named in the manifest's truncatedLogFiles. The current log file is never dropped; if it
38
42
  alone still exceeds the cap, only its tail is exported instead, named in the manifest's
39
- currentFileTailTruncated.
43
+ currentFileTailTruncated. A <output>.sha256 sidecar carries a SHA-256 digest of the bundle's bytes.
44
+
45
+ <state-dir>/ui.log (the UI/BFF process's raw, unredacted stdout+stderr) is excluded by default and
46
+ always named in the manifest's sectionsExcluded — attaching it requires BOTH --include-ui-log AND
47
+ --i-understand-this-is-unredacted; either flag alone still excludes it. --include-evidence attaches
48
+ the FULL EvidenceStore manifest for each listed runId (beyond the index-only summary above) for
49
+ deep replay; a runId that does not exist under --state-dir contributes no section.
40
50
 
41
51
  analyze reads FILE (a support bundle or a raw server.log — auto-detected), groups its lines by
42
52
  correlationId, and prints one reconstructed timeline per id. Each process lifetime is ordered by
43
53
  seq; lifetimes are ordered by the position of their first line in the file, because the log
44
54
  envelope promises no order across processes.
45
- --correlation-id narrows to a single id; --json emits the machine-readable form.
55
+ --correlation-id narrows to a single id; --json emits the machine-readable form. --clusters prints
56
+ a whole-file view of every parsed line grouped by (category, op, errorKind), independent of
57
+ --correlation-id: a count and up to 5 sample correlation ids per group. --seed (requires
58
+ --correlation-id) prints a ReproductionSeed — a gatewayScript/httpRequest/storeFingerprint/
59
+ indexingJob/stackFrames/causeChain reconstruction for that one correlationId, plus a warnings field
60
+ naming exactly what could not be reconstructed and why. --emit-fixture PATH (requires
61
+ --correlation-id) writes a ready-to-paste TypeScript GatewayReplayScriptEntry[] fixture, derived
62
+ from that seed's gatewayScript, to PATH — refusing to overwrite an existing file and creating
63
+ parent directories as needed. --seed and --emit-fixture may be combined in one invocation.
46
64
  `;
47
65
  // Returns the value of a `--flag value` pair: undefined when the flag is absent, null when it is
48
66
  // present but missing (or immediately followed by another flag) its value — same contract as
@@ -60,13 +78,25 @@ function parsePositiveInteger(value) {
60
78
  const parsed = Number(value);
61
79
  return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
62
80
  }
81
+ // Splits a `--include-evidence` value on commas, trimming each id and dropping empty entries — a
82
+ // trailing comma or repeated separator must not manufacture a phantom empty runId that
83
+ // `loadEvidence` would then reject.
84
+ function parseIncludeEvidenceIds(raw) {
85
+ if (raw === undefined)
86
+ return [];
87
+ return raw
88
+ .split(",")
89
+ .map((id) => id.trim())
90
+ .filter((id) => id.length > 0);
91
+ }
63
92
  function parseExportArgs(args) {
64
93
  if (args.includes("--help") || args.includes("-h"))
65
94
  return { kind: "help" };
66
95
  const out = flagValue(args, "--out");
67
96
  const stateDir = flagValue(args, "--state-dir");
68
97
  const maxBytesRaw = flagValue(args, "--max-bytes");
69
- if (out === null || stateDir === null || maxBytesRaw === null) {
98
+ const includeEvidenceRaw = flagValue(args, "--include-evidence");
99
+ if (out === null || stateDir === null || maxBytesRaw === null || includeEvidenceRaw === null) {
70
100
  return {
71
101
  kind: "usage",
72
102
  message: `keiko support export: a flag is missing its value.\n${USAGE}`,
@@ -79,7 +109,17 @@ function parseExportArgs(args) {
79
109
  message: `keiko support export: --max-bytes must be a positive integer.\n${USAGE}`,
80
110
  };
81
111
  }
82
- return { kind: "ok", value: { out, stateDir, maxBytes } };
112
+ return {
113
+ kind: "ok",
114
+ value: {
115
+ out,
116
+ stateDir,
117
+ maxBytes,
118
+ includeUiLog: args.includes("--include-ui-log"),
119
+ iUnderstandUnredacted: args.includes("--i-understand-this-is-unredacted"),
120
+ includeEvidenceRunIds: parseIncludeEvidenceIds(includeEvidenceRaw),
121
+ },
122
+ };
83
123
  }
84
124
  function parseAnalyzeArgs(args) {
85
125
  if (args.includes("--help") || args.includes("-h"))
@@ -99,7 +139,31 @@ function parseAnalyzeArgs(args) {
99
139
  message: `keiko support analyze: --correlation-id is missing its value.\n${USAGE}`,
100
140
  };
101
141
  }
102
- return { kind: "ok", value: { file, correlationId, json: rest.includes("--json") } };
142
+ const emitFixture = flagValue(rest, "--emit-fixture");
143
+ if (emitFixture === null) {
144
+ return {
145
+ kind: "usage",
146
+ message: `keiko support analyze: --emit-fixture is missing its value.\n${USAGE}`,
147
+ };
148
+ }
149
+ const seed = rest.includes("--seed");
150
+ if ((seed || emitFixture !== undefined) && correlationId === undefined) {
151
+ return {
152
+ kind: "usage",
153
+ message: `keiko support analyze: --seed/--emit-fixture require --correlation-id.\n${USAGE}`,
154
+ };
155
+ }
156
+ return {
157
+ kind: "ok",
158
+ value: {
159
+ file,
160
+ correlationId,
161
+ json: rest.includes("--json"),
162
+ clusters: rest.includes("--clusters"),
163
+ seed,
164
+ emitFixture,
165
+ },
166
+ };
103
167
  }
104
168
  export function parseSupportArgs(args) {
105
169
  const [subcommand, ...rest] = args;
@@ -189,9 +253,15 @@ function collectLogContent(logsDir, maxBytes) {
189
253
  // (ENOENT/EACCES/EROFS) when it has one, since a Node fs error is always a plain `Error` and
190
254
  // `error.constructor.name` is therefore always just `"Error"`, telling an operator nothing the
191
255
  // generic prefix didn't already say. Returns undefined on success, an exit code on failure.
256
+ // Also writes the `<output>.sha256` sidecar (design doc §6.2's closing addendum): a cheap
257
+ // integrity story for an artifact that crosses a customer-machine-to-agent trust boundary, computed
258
+ // over the EXACT bytes just written to `outPath`. A failure writing either file reports the same
259
+ // content-free outcome and writes neither half — a bundle without its sidecar, or a sidecar for
260
+ // bytes that were never actually persisted, are both worse than refusing the export.
192
261
  function writeBundleOrExitCode(outPath, contents, io) {
193
262
  try {
194
263
  writeFileSync(outPath, contents, "utf8");
264
+ writeFileSync(sha256SidecarPath(outPath), `${bundleSha256Hex(contents)}\n`, "utf8");
195
265
  return undefined;
196
266
  }
197
267
  catch (error) {
@@ -239,6 +309,107 @@ function logContentManifestFields(logContent) {
239
309
  skippedLogFiles: logContent.skippedLogFiles,
240
310
  };
241
311
  }
312
+ // A missing or unreadable ui.log (no `keiko start` has ever run against this state dir, or a
313
+ // permission error) means there is nothing to attach — never a failed export.
314
+ function readUiLogContentOrUndefined(stateDir) {
315
+ try {
316
+ return readFileSync(join(stateDir, UI_LOG_FILE_NAME), "utf8");
317
+ }
318
+ catch {
319
+ return undefined;
320
+ }
321
+ }
322
+ function resolveUiLogInclusion(stateDir, args) {
323
+ const consented = args.includeUiLog && args.iUnderstandUnredacted;
324
+ const content = consented ? readUiLogContentOrUndefined(stateDir) : undefined;
325
+ return content === undefined
326
+ ? { section: undefined, excluded: true }
327
+ : { section: buildUiLogSection(content), excluded: false };
328
+ }
329
+ // A `KEIKO_`-prefixed env name is collected with the prefix fused on, so `redactLogFields`'s
330
+ // field-NAME denylist (an exact match on the WHOLE normalized name, `log-redaction.ts`) can never
331
+ // fire on it: normalization turns `KEIKO_DEFAULT_API_KEY` into `keikodefaultapikey`, which does
332
+ // not equal the denylist's `apikey`/`key` entries. Leaving safety to the generic value-shape
333
+ // heuristics alone is not enough either — they do not catch, for example, a hex-only secret (no
334
+ // uppercase character, so the high-entropy check never fires) or any other operator-chosen
335
+ // credential shape they were never designed to enumerate. This is therefore a second, independent
336
+ // gate at the COLLECTION layer: a credential-shaped segment anywhere in the name (split on `_`)
337
+ // refuses the field outright, before its value is ever read into the snapshot at all.
338
+ const CREDENTIAL_NAME_SEGMENTS = new Set([
339
+ "key",
340
+ "keys",
341
+ "apikey",
342
+ "apikeys",
343
+ "secret",
344
+ "secrets",
345
+ "token",
346
+ "tokens",
347
+ "credential",
348
+ "credentials",
349
+ "password",
350
+ "passwd",
351
+ "pwd",
352
+ "auth",
353
+ "cert",
354
+ "certificate",
355
+ ]);
356
+ function isCredentialShapedEnvName(key) {
357
+ return key
358
+ .toLowerCase()
359
+ .split("_")
360
+ .some((segment) => CREDENTIAL_NAME_SEGMENTS.has(segment));
361
+ }
362
+ // "The resolved runtime configuration" scoped to what this CLI itself resolves from the
363
+ // environment — its own `KEIKO_*` vocabulary (KEIKO_STATE_DIR, KEIKO_CONFIG_FILE,
364
+ // KEIKO_EVIDENCE_DIR, …) — passed through the server's `redactLogFields` choke point (never a
365
+ // second redaction implementation, AGENTS.md §7) before embedding. Always attached, unlike
366
+ // ui-log/evidence-manifest, which are opt-in. `isCredentialShapedEnvName` runs first and is not a
367
+ // duplicate of that choke point: it refuses a credential-shaped NAME outright, a layer
368
+ // `redactLogFields` structurally cannot reach once the prefix has fused the name.
369
+ function keikoConfigEnvFields(env) {
370
+ const fields = {};
371
+ for (const [key, value] of Object.entries(env)) {
372
+ if (key.startsWith("KEIKO_") && value !== undefined && !isCredentialShapedEnvName(key)) {
373
+ fields[key] = value;
374
+ }
375
+ }
376
+ return fields;
377
+ }
378
+ function resolveConfigSnapshotSection(env, server) {
379
+ return buildConfigSnapshotSection(server.redactLogFields(keikoConfigEnvFields(env)) ?? {});
380
+ }
381
+ // Attaches the FULL EvidenceStore manifest for each `--include-evidence` runId, beyond the
382
+ // index-only `evidenceIndexCount` summary Wave 1 already carries — deep replay. A runId that does
383
+ // not resolve (never used from this state dir, or an unreadable/malformed manifest) contributes no
384
+ // section; this never fails the export, the same "count, don't fail" discipline
385
+ // `resolveEvidenceIndexCount` already uses.
386
+ async function resolveIncludedEvidenceSections(evidenceDir, runIds, deps) {
387
+ if (runIds.length === 0)
388
+ return [];
389
+ try {
390
+ const evidence = await loadEvidence();
391
+ const store = deps.evidenceStore ?? evidence.createNodeEvidenceStore(evidenceDir);
392
+ const sections = [];
393
+ for (const runId of runIds) {
394
+ const manifest = evidence.loadEvidence(store, runId);
395
+ if (manifest !== undefined)
396
+ sections.push(buildEvidenceManifestSection(runId, manifest));
397
+ }
398
+ return sections;
399
+ }
400
+ catch {
401
+ return [];
402
+ }
403
+ }
404
+ // Assembles every Wave 6 `$section` record in the bundle's fixed order: config-snapshot (always),
405
+ // then each requested evidence-manifest, then ui-log last (when its gate passed) — content
406
+ // verbatim, so it sits closest to the raw log lines that follow it.
407
+ function assembleWave6Sections(env, server, uiLog, evidenceSections) {
408
+ const configSnapshot = resolveConfigSnapshotSection(env, server);
409
+ return uiLog.section === undefined
410
+ ? [configSnapshot, ...evidenceSections]
411
+ : [configSnapshot, ...evidenceSections, uiLog.section];
412
+ }
242
413
  async function runSupportExport(args, io, env, deps) {
243
414
  const cwd = deps.cwd ?? process.cwd();
244
415
  const now = deps.now ?? (() => new Date());
@@ -261,6 +432,8 @@ async function runSupportExport(args, io, env, deps) {
261
432
  // I/O, wasted if the export is about to be refused anyway.
262
433
  reportStoreFingerprintProgress(io);
263
434
  const storeFingerprintCollection = await server.collectStoreFingerprints({ stateDir, env });
435
+ const uiLog = resolveUiLogInclusion(stateDir, args);
436
+ const evidenceSections = await resolveIncludedEvidenceSections(evidenceDir, args.includeEvidenceRunIds, deps);
264
437
  const generatedAtDate = now();
265
438
  const manifest = buildSupportBundleManifest({
266
439
  ...processProvenance(server, generatedAtDate, stateDirSource),
@@ -269,8 +442,10 @@ async function runSupportExport(args, io, env, deps) {
269
442
  evidenceIndexCount,
270
443
  storeFingerprints: storeFingerprintCollection.fingerprints,
271
444
  storesUnavailable: storeFingerprintCollection.unavailable,
445
+ sectionsExcluded: uiLog.excluded ? [UI_LOG_SECTION] : [],
272
446
  });
273
- const lines = serializeBundleLines(manifest, logContent.contentLines);
447
+ const sections = assembleWave6Sections(env, server, uiLog, evidenceSections);
448
+ const lines = serializeBundleLines(manifest, sections, logContent.contentLines);
274
449
  const outPath = resolveOutPath(cwd, args.out, generatedAtDate);
275
450
  const failureCode = writeBundleOrExitCode(outPath, bundleText(lines), io);
276
451
  if (failureCode !== undefined)
@@ -295,6 +470,14 @@ function emitAllTimelines(result, json, io) {
295
470
  io.out(json ? `${JSON.stringify(result)}\n` : renderHumanAllTimelines(result));
296
471
  return 0;
297
472
  }
473
+ // Wave 6 (epic #3233 closeout, gap #1) — `--clusters`: a standalone, whole-file view independent
474
+ // of --correlation-id (support-analyze.ts's `renderHumanClusters` docstring reserves it for
475
+ // exactly this flag). Emits the bare `OpCluster[]` under --json, never nested inside a larger
476
+ // envelope, since this is deliberately a focused report, not a slice of the default output.
477
+ function emitClusters(clusters, json, io) {
478
+ io.out(json ? `${JSON.stringify(clusters)}\n` : renderHumanClusters(clusters));
479
+ return 0;
480
+ }
298
481
  function readAnalyzeSource(filePath, io) {
299
482
  try {
300
483
  return readFileSync(filePath, "utf8");
@@ -306,12 +489,105 @@ function readAnalyzeSource(filePath, io) {
306
489
  return 1;
307
490
  }
308
491
  }
492
+ function resolveFixturePath(cwd, path) {
493
+ return isAbsolute(path) ? path : resolve(cwd, path);
494
+ }
495
+ // Fail-closed (disclosed gap #1's fix): never overwrites an existing file — a fixture is meant to
496
+ // be hand-edited after generation, and silently clobbering that would destroy real work — and
497
+ // creates the parent directory so `--emit-fixture some/new/dir/fixture.ts` does not require the
498
+ // operator to `mkdir -p` first. Content-free error reporting, same discipline as
499
+ // `writeBundleOrExitCode`: an fs error's message can quote the path it was writing.
500
+ function writeFixtureOrExitCode(path, contents, io) {
501
+ if (existsSync(path)) {
502
+ io.err(`keiko support analyze: refusing to overwrite existing file: ${path}\n`);
503
+ return 1;
504
+ }
505
+ try {
506
+ mkdirSync(dirname(path), { recursive: true });
507
+ writeFileSync(path, contents, "utf8");
508
+ return undefined;
509
+ }
510
+ catch (error) {
511
+ io.err(`keiko support analyze: could not write fixture: ${describeErrorKind(error)}\n`);
512
+ return 1;
513
+ }
514
+ }
515
+ // Writes the `--emit-fixture` file from `seed.gatewayScript`, when present and non-empty. Returns
516
+ // undefined (nothing to report) when `--emit-fixture` was not requested; the resolved path on
517
+ // success; or an exit code on a genuine failure (no reconstructible script, or a write error).
518
+ function emitFixtureIfRequested(seed, emitFixture, correlationId, cwd, io) {
519
+ if (emitFixture === undefined)
520
+ return undefined;
521
+ const fixtureText = seed.gatewayScript === undefined
522
+ ? undefined
523
+ : renderGatewayReplayScriptFixture(seed.gatewayScript);
524
+ if (fixtureText === undefined) {
525
+ io.err(`keiko support analyze: no gateway replay script to write for correlationId=${correlationId}\n`);
526
+ return { exitCode: 1 };
527
+ }
528
+ const path = resolveFixturePath(cwd, emitFixture);
529
+ const failureCode = writeFixtureOrExitCode(path, fixtureText, io);
530
+ return failureCode === undefined ? { path } : { exitCode: failureCode };
531
+ }
532
+ // `--emit-fixture` given without `--seed`: nothing to print but the write itself, kept in the
533
+ // same JSON-vs-text discipline as every other emit* helper here.
534
+ function reportFixtureOnly(fixturePath, json, io) {
535
+ if (fixturePath === undefined)
536
+ return;
537
+ io.out(json ? `${JSON.stringify({ fixturePath })}\n` : `Wrote fixture to ${fixturePath}\n`);
538
+ }
539
+ // `--seed`: prints the seed itself, with `fixturePath` folded into the same JSON object when a
540
+ // fixture was also written (so --json stays a single JSON object, never two), or a trailing
541
+ // confirmation line in human mode.
542
+ function emitSeedResult(seed, fixturePath, json, io) {
543
+ if (json) {
544
+ const payload = fixturePath === undefined ? seed : { ...seed, fixturePath };
545
+ io.out(`${JSON.stringify(payload, null, 2)}\n`);
546
+ return;
547
+ }
548
+ io.out(renderHumanReproductionSeed(seed));
549
+ if (fixturePath !== undefined)
550
+ io.out(`Wrote fixture to ${fixturePath}\n`);
551
+ }
552
+ // `--seed` / `--emit-fixture` (both require --correlation-id, enforced by `parseAnalyzeArgs`):
553
+ // builds one `ReproductionSeed`, optionally writes the fixture derived from its `gatewayScript`,
554
+ // then reports according to which of the two flags were actually requested.
555
+ function runSeedAndFixture(text, args, cwd, io) {
556
+ const correlationId = args.correlationId;
557
+ if (correlationId === undefined) {
558
+ // Unreachable in practice: parseAnalyzeArgs rejects --seed/--emit-fixture without
559
+ // --correlation-id before this function is ever called. Guarded so this function's own
560
+ // string-typed correlationId use stays honest rather than relying on an external invariant.
561
+ io.err(`keiko support analyze: --seed/--emit-fixture require --correlation-id.\n${USAGE}`);
562
+ return 2;
563
+ }
564
+ const seed = buildReproductionSeed(text, correlationId, new Date());
565
+ if (seed === undefined)
566
+ return reportMissingCorrelationId(correlationId, io);
567
+ const fixtureOutcome = emitFixtureIfRequested(seed, args.emitFixture, correlationId, cwd, io);
568
+ if (fixtureOutcome !== undefined && "exitCode" in fixtureOutcome)
569
+ return fixtureOutcome.exitCode;
570
+ const fixturePath = fixtureOutcome?.path;
571
+ if (args.seed) {
572
+ emitSeedResult(seed, fixturePath, args.json, io);
573
+ }
574
+ else {
575
+ reportFixtureOnly(fixturePath, args.json, io);
576
+ }
577
+ return 0;
578
+ }
309
579
  function runSupportAnalyze(args, io, deps) {
310
580
  const cwd = deps.cwd ?? process.cwd();
311
581
  const filePath = isAbsolute(args.file) ? args.file : resolve(cwd, args.file);
312
582
  const text = readAnalyzeSource(filePath, io);
313
583
  if (typeof text === "number")
314
584
  return text;
585
+ if (args.clusters) {
586
+ return emitClusters(analyzeLogText(text).clusters, args.json, io);
587
+ }
588
+ if (args.seed || args.emitFixture !== undefined) {
589
+ return runSeedAndFixture(text, args, cwd, io);
590
+ }
315
591
  const result = analyzeLogText(text);
316
592
  if (args.correlationId === undefined) {
317
593
  return emitAllTimelines(result, args.json, io);
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oscharko-dev/keiko-cli",
3
- "version": "0.3.16",
3
+ "version": "0.3.17",
4
4
  "type": "module",
5
5
  "license": "Apache-2.0",
6
6
  "description": "Internal CLI package: command modules for the `keiko` binary shipped via the root product package (ADR-0019). Not published independently.",
@@ -21,17 +21,17 @@
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-model-gateway": "0.3.16",
27
- "@oscharko-dev/keiko-workspace": "0.3.16",
28
- "@oscharko-dev/keiko-evaluations": "0.3.16",
29
- "@oscharko-dev/keiko-evidence": "0.3.16",
30
- "@oscharko-dev/keiko-verification": "0.3.16",
31
- "@oscharko-dev/keiko-harness": "0.3.16",
32
- "@oscharko-dev/keiko-sdk": "0.3.16",
33
- "@oscharko-dev/keiko-workflows": "0.3.16",
34
- "@oscharko-dev/keiko-server": "0.3.16",
35
- "@oscharko-dev/keiko-memory-vault": "0.3.16"
24
+ "@oscharko-dev/keiko-contracts": "0.3.17",
25
+ "@oscharko-dev/keiko-security": "0.3.17",
26
+ "@oscharko-dev/keiko-model-gateway": "0.3.17",
27
+ "@oscharko-dev/keiko-workspace": "0.3.17",
28
+ "@oscharko-dev/keiko-evaluations": "0.3.17",
29
+ "@oscharko-dev/keiko-evidence": "0.3.17",
30
+ "@oscharko-dev/keiko-verification": "0.3.17",
31
+ "@oscharko-dev/keiko-harness": "0.3.17",
32
+ "@oscharko-dev/keiko-sdk": "0.3.17",
33
+ "@oscharko-dev/keiko-workflows": "0.3.17",
34
+ "@oscharko-dev/keiko-server": "0.3.17",
35
+ "@oscharko-dev/keiko-memory-vault": "0.3.17"
36
36
  }
37
37
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oscharko-dev/keiko-connectors",
3
- "version": "0.3.16",
3
+ "version": "0.3.17",
4
4
  "type": "module",
5
5
  "license": "Apache-2.0",
6
6
  "description": "Internal connectors package: governed Atlassian (Confluence/Jira) connector domain logic — encrypted credential custody over the shared secret vault, opaque authRef resolution, the injectable AtlassianHttpPort transport seam, and the bounded connection-verification probe (ADR-0128, ADR-0019). No direct network or filesystem capability; keiko-server is the sole composition root. Not published independently.",
@@ -21,7 +21,7 @@
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"
24
+ "@oscharko-dev/keiko-contracts": "0.3.17",
25
+ "@oscharko-dev/keiko-security": "0.3.17"
26
26
  }
27
27
  }
@@ -1,5 +1,5 @@
1
- export declare const KEIKO_CONTRACTS_VERSION: "0.3.16";
2
- export declare const KEIKO_PRODUCT_VERSION: "0.3.16";
1
+ export declare const KEIKO_CONTRACTS_VERSION: "0.3.17";
2
+ export declare const KEIKO_PRODUCT_VERSION: "0.3.17";
3
3
  export { clampUnit } from "./numeric.js";
4
4
  export { binaryNdcgAtK, mean } from "./eval-metrics.js";
5
5
  export { sortedStrings } from "./stable-order.js";
@@ -16,12 +16,12 @@
16
16
  // KnowledgeCapsule / CapsuleSet primitives, document and vector lineage records, connector
17
17
  // graph state, and pure validation helpers. No implementation — types only. Implementation
18
18
  // lands in subsequent epic children.
19
- export const KEIKO_CONTRACTS_VERSION = "0.3.16";
19
+ export const KEIKO_CONTRACTS_VERSION = "0.3.17";
20
20
  // Single-source product version. Surfaced as `keiko --version`, in the BFF healthcheck
21
21
  // response, and as the SDK's exported `SDK_VERSION` constant. Kept here on the leaf
22
22
  // package so every consumer reaches it through one stable import path. Bump in lockstep
23
23
  // with the root package.json "version" field as part of every release.
24
- export const KEIKO_PRODUCT_VERSION = "0.3.16";
24
+ export const KEIKO_PRODUCT_VERSION = "0.3.17";
25
25
  // ─── Shared numeric primitive (GEN-DUP-SEMANTIC-003) ────────────────────────────
26
26
  export { clampUnit } from "./numeric.js";
27
27
  // ─── Deterministic retrieval-evaluation primitives (ADR-0152 D5 amendment, Issue #2635) ──
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oscharko-dev/keiko-contracts",
3
- "version": "0.3.16",
3
+ "version": "0.3.17",
4
4
  "type": "module",
5
5
  "license": "Apache-2.0",
6
6
  "description": "Internal workspace package: shared Keiko contracts. Not published independently.",