@aiwg/cli 2026.10.15 → 2026.10.18

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 (286) hide show
  1. package/agentic/code/providers/pi/aiwg-bridge.ts +45 -7
  2. package/dist/src/artifacts/citation-parser.js +7 -6
  3. package/dist/src/artifacts/corpus-tools/citation-densify.js +4 -2
  4. package/dist/src/artifacts/corpus-tools/cli.js +8 -3
  5. package/dist/src/artifacts/corpus-tools/discovery-log.js +26 -24
  6. package/dist/src/artifacts/corpus-tools/expand-cli.js +3 -2
  7. package/dist/src/artifacts/corpus-tools/expand-dates.js +107 -0
  8. package/dist/src/artifacts/corpus-tools/expand-queue.js +4 -1
  9. package/dist/src/artifacts/corpus-tools/expand-review.js +104 -0
  10. package/dist/src/artifacts/corpus-tools/expand-state.js +17 -1
  11. package/dist/src/artifacts/corpus-tools/expand.js +16 -17
  12. package/dist/src/artifacts/corpus-tools/induction-audit.js +7 -6
  13. package/dist/src/artifacts/corpus-tools/integrity-scan.js +3 -3
  14. package/dist/src/artifacts/corpus-tools/radar-shared.js +7 -9
  15. package/dist/src/artifacts/corpus-tools/ref-files.js +11 -0
  16. package/dist/src/artifacts/corpus-tools/resolve-cli.js +11 -3
  17. package/dist/src/artifacts/corpus-tools/resolve.js +42 -11
  18. package/dist/src/artifacts/corpus-tools/retrieval-lab.js +2 -1
  19. package/dist/src/artifacts/corpus-tools/sidecar-lint.js +4 -4
  20. package/dist/src/artifacts/corpus-tools/sidecar-repair.js +2 -1
  21. package/dist/src/artifacts/corpus-views/ref-parser.js +3 -17
  22. package/dist/src/artifacts/graph-query.js +5 -3
  23. package/dist/src/artifacts/hybrid-query.js +11 -2
  24. package/dist/src/artifacts/index-refresh.js +2 -0
  25. package/dist/src/artifacts/query-engine-corpus.js +217 -0
  26. package/dist/src/artifacts/query-engine-discover-output.js +229 -0
  27. package/dist/src/artifacts/query-engine-discover.js +285 -0
  28. package/dist/src/artifacts/query-engine-entries.js +188 -0
  29. package/dist/src/artifacts/query-engine-index.js +249 -0
  30. package/dist/src/artifacts/query-engine-matching.js +143 -0
  31. package/dist/src/artifacts/query-engine-options.js +2 -0
  32. package/dist/src/artifacts/query-engine-rules.js +202 -0
  33. package/dist/src/artifacts/query-engine-scoring.js +436 -0
  34. package/dist/src/artifacts/query-engine-show-card.js +194 -0
  35. package/dist/src/artifacts/query-engine-show-load.js +211 -0
  36. package/dist/src/artifacts/query-engine-show.js +300 -0
  37. package/dist/src/artifacts/query-engine.js +7 -2576
  38. package/dist/src/cli/handlers/daemon.js +17 -1
  39. package/dist/src/cli/handlers/doctor-args.js +10 -5
  40. package/dist/src/cli/handlers/doctor-help.js +4 -1
  41. package/dist/src/cli/handlers/index.js +2 -2
  42. package/dist/src/cli/handlers/mc-agents.js +111 -0
  43. package/dist/src/cli/handlers/mc-args.js +54 -0
  44. package/dist/src/cli/handlers/mc-control.js +227 -0
  45. package/dist/src/cli/handlers/mc-dispatch.js +203 -0
  46. package/dist/src/cli/handlers/mc-help.js +171 -0
  47. package/dist/src/cli/handlers/mc-run.js +343 -0
  48. package/dist/src/cli/handlers/mc-session.js +138 -0
  49. package/dist/src/cli/handlers/mc-status.js +258 -0
  50. package/dist/src/cli/handlers/mc-summary.js +43 -0
  51. package/dist/src/cli/handlers/mc-types.js +3 -0
  52. package/dist/src/cli/handlers/mc-worker.js +205 -0
  53. package/dist/src/cli/handlers/mc.js +12 -1665
  54. package/dist/src/cli/handlers/models-refusal.js +13 -0
  55. package/dist/src/cli/handlers/models-resource-sample.js +10 -0
  56. package/dist/src/cli/handlers/models.js +5 -3
  57. package/dist/src/cli/handlers/regenerate.js +8 -16
  58. package/dist/src/cli/handlers/remove-bundled.js +133 -0
  59. package/dist/src/cli/handlers/remove-options.js +31 -0
  60. package/dist/src/cli/handlers/remove-user.js +174 -0
  61. package/dist/src/cli/handlers/remove.js +201 -0
  62. package/dist/src/cli/handlers/sessions.js +7 -7
  63. package/dist/src/cli/handlers/subcommands-bundles.js +257 -0
  64. package/dist/src/cli/handlers/subcommands-discovery.js +165 -0
  65. package/dist/src/cli/handlers/subcommands-list-format.js +129 -0
  66. package/dist/src/cli/handlers/subcommands-list.js +250 -0
  67. package/dist/src/cli/handlers/subcommands-plugins.js +213 -0
  68. package/dist/src/cli/handlers/subcommands-quickref.js +58 -0
  69. package/dist/src/cli/handlers/subcommands-rlm.js +113 -0
  70. package/dist/src/cli/handlers/subcommands-services.js +66 -0
  71. package/dist/src/cli/handlers/subcommands-storage.js +259 -0
  72. package/dist/src/cli/handlers/subcommands.js +18 -1976
  73. package/dist/src/cli/handlers/update.js +157 -0
  74. package/dist/src/cli/handlers/use.js +14 -4
  75. package/dist/src/cli/handlers/utilities.js +3 -560
  76. package/dist/src/cli/handlers/utility-doctor.js +412 -0
  77. package/dist/src/cli/scope-resolver.js +1 -142
  78. package/dist/src/cli/services/deployment-verification.js +0 -1
  79. package/dist/src/cli/user-scope-mirror.js +173 -0
  80. package/dist/src/config/aiwg-config.js +2 -1
  81. package/dist/src/config/authorization-cli.js +7 -3
  82. package/dist/src/config/dispatch-host-thresholds.js +2 -0
  83. package/dist/src/config/dispatch-thresholds-runtime.d.mts +3 -2
  84. package/dist/src/config/dispatch-thresholds-runtime.mjs +21 -7
  85. package/dist/src/config/framework-aliases.js +12 -0
  86. package/dist/src/config/host-resource-report.d.mts +24 -0
  87. package/dist/src/config/host-resource-report.mjs +110 -0
  88. package/dist/src/config/host-resource-runtime.d.mts +37 -0
  89. package/dist/src/config/host-resource-runtime.mjs +296 -0
  90. package/dist/src/config/installed-selection.js +22 -0
  91. package/dist/src/config/worker-invocation-marker.d.mts +1 -0
  92. package/dist/src/config/worker-invocation-marker.mjs +2 -0
  93. package/dist/src/decision/ensemble-study/artifacts.js +7 -0
  94. package/dist/src/decision/ensemble-study/gate-policy.js +58 -0
  95. package/dist/src/decision/ensemble-study/gates.js +78 -0
  96. package/dist/src/decision/ensemble-study/protocol.js +18 -21
  97. package/dist/src/decision/ensemble-study/score.js +3 -2
  98. package/dist/src/decision/ensemble-study/statistics.js +7 -26
  99. package/dist/src/decision/heldout/access.js +74 -0
  100. package/dist/src/decision/heldout/calibration.js +1 -0
  101. package/dist/src/decision/heldout/collector.js +8 -1
  102. package/dist/src/decision/sensitivity/comparative-gates.js +135 -0
  103. package/dist/src/decision/sensitivity/comparative.js +18 -41
  104. package/dist/src/effects/verifiers/file.js +22 -5
  105. package/dist/src/extensions/claude-attribution.js +82 -0
  106. package/dist/src/extensions/claude-hooks-installer.js +133 -69
  107. package/dist/src/extensions/commands/daemon.js +109 -0
  108. package/dist/src/extensions/commands/definitions.js +5 -89
  109. package/dist/src/gates/evaluate.js +2 -358
  110. package/dist/src/gates/heldout.js +17 -7
  111. package/dist/src/gates/observations.js +363 -0
  112. package/dist/src/gates/pack-composition.js +270 -0
  113. package/dist/src/gates/pack-tightening.js +197 -0
  114. package/dist/src/gates/pack-validation.js +262 -0
  115. package/dist/src/gates/registry-error.js +5 -0
  116. package/dist/src/gates/registry.js +13 -685
  117. package/dist/src/lint/check-patterns.js +163 -0
  118. package/dist/src/lint/checks.js +268 -0
  119. package/dist/src/lint/reference-resolution.js +54 -0
  120. package/dist/src/lint/runner.js +3 -465
  121. package/dist/src/mcp/helpers.mjs +11 -1
  122. package/dist/src/mcp/json-document.mjs +29 -0
  123. package/dist/src/mcp/muse-native-config.mjs +1 -28
  124. package/dist/src/memory/project-registry.js +44 -4
  125. package/dist/src/mission-protocol/worker-review-gate.js +7 -0
  126. package/dist/src/models/worker-plan.js +36 -5
  127. package/dist/src/models/wrapper-deployment.js +25 -12
  128. package/dist/src/models/wrapper-enforcement.js +47 -7
  129. package/dist/src/network-analysis/research.js +2 -1
  130. package/dist/src/plugin/command-ownership.js +34 -0
  131. package/dist/src/plugin/skill-command-frontmatter.js +197 -0
  132. package/dist/src/plugin/skill-command-translator.js +6 -232
  133. package/dist/src/policy/hitl-check.js +14 -4
  134. package/dist/src/policy/hitl-consume.js +54 -0
  135. package/dist/src/policy/hitl-receipt.js +2 -0
  136. package/dist/src/policy/hitl.js +11 -3
  137. package/dist/src/providers/context-output-ownership.js +26 -0
  138. package/dist/src/providers/deployment-ownership.d.mts +19 -0
  139. package/dist/src/providers/deployment-ownership.mjs +226 -0
  140. package/dist/src/providers/deployment-removal.js +200 -0
  141. package/dist/src/providers/provider-context-contracts.js +162 -0
  142. package/dist/src/providers/provider-definition-schema.js +136 -0
  143. package/dist/src/providers/provider-definitions.js +8 -1298
  144. package/dist/src/providers/provider-seeds-1.js +360 -0
  145. package/dist/src/providers/provider-seeds-2.js +387 -0
  146. package/dist/src/providers/provider-seeds-3.js +262 -0
  147. package/dist/src/providers/removal-transaction.js +86 -0
  148. package/dist/src/providers/settings-document.d.mts +3 -0
  149. package/dist/src/providers/settings-document.mjs +47 -0
  150. package/dist/src/providers/settings-removal.js +190 -0
  151. package/dist/src/providers/skill-ownership.d.mts +19 -2
  152. package/dist/src/providers/skill-ownership.mjs +12 -4
  153. package/dist/src/providers/transformation-receipt-integration.js +15 -271
  154. package/dist/src/providers/transformation-receipt-outputs.js +99 -0
  155. package/dist/src/providers/transformation-receipt-source.js +194 -0
  156. package/dist/src/research/clients/arxiv.js +4 -30
  157. package/dist/src/research/clients/base.js +48 -22
  158. package/dist/src/research/identity.js +42 -4
  159. package/dist/src/research/query-cli.js +3 -87
  160. package/dist/src/research/query-options.js +87 -0
  161. package/dist/src/research/reference-match.js +105 -24
  162. package/dist/src/research/services/acquisition.js +9 -7
  163. package/dist/src/research/services/citation.js +5 -2
  164. package/dist/src/research/types.js +2 -0
  165. package/dist/src/rules/activation.mjs +15 -6
  166. package/dist/src/rules/core-startup.mjs +2 -2
  167. package/dist/src/serve/mission-conductor.js +52 -4
  168. package/dist/src/serve/mission-summary.js +56 -0
  169. package/dist/src/sessions/adapters/grok-build-native.js +23 -0
  170. package/dist/src/sessions/adapters/grok-build.js +14 -7
  171. package/dist/src/sessions/workspace-discovery.js +5 -5
  172. package/dist/src/smiths/context-pipeline/aiwg-md.js +39 -46
  173. package/dist/src/smiths/context-pipeline/claude-hook.js +1 -1
  174. package/dist/src/smiths/context-pipeline/code-regions.js +28 -0
  175. package/dist/src/smiths/context-pipeline/context-file-safety.js +3 -0
  176. package/dist/src/smiths/context-pipeline/finalization.js +81 -51
  177. package/dist/src/smiths/context-pipeline/generator.js +10 -11
  178. package/dist/src/smiths/context-pipeline/managed-hook.js +1 -1
  179. package/dist/src/smiths/context-pipeline/muse-bridge.js +2 -2
  180. package/dist/src/smiths/context-pipeline/provider-policy.js +6 -12
  181. package/dist/src/smiths/context-pipeline/workspace-audit.js +299 -0
  182. package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +148 -0
  183. package/dist/src/smiths/context-pipeline/workspace-context-shared.js +111 -0
  184. package/dist/src/smiths/context-pipeline/workspace-context.js +8 -1373
  185. package/dist/src/smiths/context-pipeline/workspace-doctor.js +192 -0
  186. package/dist/src/smiths/context-pipeline/workspace-document.js +201 -0
  187. package/dist/src/smiths/context-pipeline/workspace-extraction.js +205 -0
  188. package/dist/src/smiths/context-pipeline/workspace-migration.js +250 -0
  189. package/dist/src/smiths/hook-bridge/index.js +9 -0
  190. package/package.json +13 -1
  191. package/schemas/decision/D17StudyProtocol.v1.schema.json +39 -67
  192. package/schemas/decision/D29Study.v10.schema.json +65 -0
  193. package/tools/agents/deploy-agents.mjs +24 -675
  194. package/tools/agents/deploy-command-mirrors.mjs +229 -0
  195. package/tools/agents/deploy-options.mjs +258 -0
  196. package/tools/agents/deploy-support.mjs +165 -0
  197. package/tools/agents/providers/base-addon-discovery.mjs +139 -0
  198. package/tools/agents/providers/base-behaviors.mjs +168 -0
  199. package/tools/agents/providers/base-context.mjs +205 -0
  200. package/tools/agents/providers/base-contract.mjs +116 -0
  201. package/tools/agents/providers/base-files.mjs +252 -0
  202. package/tools/agents/providers/base-flat-artifacts.mjs +233 -0
  203. package/tools/agents/providers/base-framework-discovery.mjs +309 -0
  204. package/tools/agents/providers/base-frontmatter.mjs +196 -0
  205. package/tools/agents/providers/base-inventory.mjs +269 -0
  206. package/tools/agents/providers/base-kernel-skills.mjs +354 -0
  207. package/tools/agents/providers/base-migrations.mjs +258 -0
  208. package/tools/agents/providers/base-models-platforms.mjs +273 -0
  209. package/tools/agents/providers/base-rule-index.mjs +450 -0
  210. package/tools/agents/providers/base-runtime.mjs +60 -0
  211. package/tools/agents/providers/base-skill-copy.mjs +273 -0
  212. package/tools/agents/providers/base.mjs +16 -3364
  213. package/tools/agents/providers/claude-post-deploy.mjs +20 -1
  214. package/tools/agents/providers/context-write.mjs +4 -0
  215. package/tools/agents/providers/hermes-startup.mjs +0 -5
  216. package/tools/agents/providers/muse.mjs +7 -2
  217. package/tools/agents/providers/pi.mjs +3 -1
  218. package/tools/agents/providers/rule-delivery-surface.mjs +359 -0
  219. package/tools/agents/providers/rule-delivery.mjs +20 -1144
  220. package/tools/agents/providers/rule-deployment-commit.mjs +148 -0
  221. package/tools/agents/providers/rule-deployment-prepare.mjs +461 -0
  222. package/tools/agents/providers/rule-deployment-state.mjs +300 -0
  223. package/tools/agents/providers/rule-projection.mjs +3 -0
  224. package/tools/daemon/README.md +511 -0
  225. package/tools/daemon/adapters/base-adapter.mjs +84 -0
  226. package/tools/daemon/adapters/webhook-adapter.mjs +107 -0
  227. package/tools/daemon/agent-supervisor.mjs +299 -0
  228. package/tools/daemon/automation-engine.mjs +310 -0
  229. package/tools/daemon/autonomous-engine.mjs +346 -0
  230. package/tools/daemon/behavior-loader.mjs +316 -0
  231. package/tools/daemon/behavior.mjs +174 -0
  232. package/tools/daemon/concierge/intent-router.mjs +401 -0
  233. package/tools/daemon/concierge/orchestrator.mjs +272 -0
  234. package/tools/daemon/concierge/response-translator.mjs +462 -0
  235. package/tools/daemon/config.mjs +377 -0
  236. package/tools/daemon/cron-scheduler.mjs +178 -0
  237. package/tools/daemon/daemon-main.mjs +1169 -0
  238. package/tools/daemon/event-router.mjs +84 -0
  239. package/tools/daemon/file-watcher.mjs +383 -0
  240. package/tools/daemon/index.mjs +1181 -0
  241. package/tools/daemon/init-profile.mjs +124 -0
  242. package/tools/daemon/ipc-client.mjs +197 -0
  243. package/tools/daemon/ipc-ops-handlers.mjs +236 -0
  244. package/tools/daemon/ipc-server.mjs +275 -0
  245. package/tools/daemon/maintenance-owner.mjs +79 -0
  246. package/tools/daemon/memory-manager.mjs +386 -0
  247. package/tools/daemon/message-router.mjs +194 -0
  248. package/tools/daemon/provider-watcher.mjs +585 -0
  249. package/tools/daemon/pty-adapter.mjs +420 -0
  250. package/tools/daemon/repl-chat.mjs +359 -0
  251. package/tools/daemon/resource-bounds.mjs +88 -0
  252. package/tools/daemon/sandbox-transport.mjs +295 -0
  253. package/tools/daemon/scheduled-task-runner.mjs +535 -0
  254. package/tools/daemon/task-store.mjs +450 -0
  255. package/tools/daemon/tmux-manager.mjs +324 -0
  256. package/tools/daemon/update-policy.mjs +517 -0
  257. package/tools/daemon/web-server.mjs +399 -0
  258. package/tools/daemon/web-ui/index.html +585 -0
  259. package/tools/daemon/web-ui/styles.css +156 -0
  260. package/tools/docker/Dockerfile.daemon +35 -0
  261. package/tools/docker/container-manager.mjs +291 -0
  262. package/tools/messaging/adapter-registry.mjs +230 -0
  263. package/tools/messaging/adapters/base.mjs +326 -0
  264. package/tools/messaging/adapters/discord.mjs +462 -0
  265. package/tools/messaging/adapters/slack.mjs +402 -0
  266. package/tools/messaging/adapters/telegram.mjs +552 -0
  267. package/tools/messaging/chat-handler.mjs +297 -0
  268. package/tools/messaging/command-router.mjs +269 -0
  269. package/tools/messaging/event-bus.mjs +199 -0
  270. package/tools/messaging/index.mjs +456 -0
  271. package/tools/messaging/message-formatter.mjs +320 -0
  272. package/tools/messaging/room-manager.mjs +277 -0
  273. package/tools/messaging/types.mjs +94 -0
  274. package/tools/providers/pi-bridge-policy.mjs +4 -0
  275. package/tools/ralph-external/daemon-supervisor.mjs +394 -0
  276. package/tools/ralph-external/lib/behavior-registry.mjs +270 -0
  277. package/tools/ralph-external/lib/worker-invocation-processes.mjs +7 -4
  278. package/tools/ralph-external/lib/worker-isolation-args.mjs +217 -0
  279. package/tools/ralph-external/lib/worker-isolation-status.mjs +19 -0
  280. package/tools/ralph-external/lib/worker-isolation.mjs +11 -237
  281. package/tools/ralph-external/lib/worker-overflow.mjs +10 -2
  282. package/tools/ralph-external/lib/worker-termination.mjs +15 -8
  283. package/tools/ralph-external/lib/worker-unit-cleanup.mjs +72 -0
  284. package/tools/ralph-external/session-launcher.mjs +7 -7
  285. package/tools/scripts/resource-preflight.mjs +3 -242
  286. package/vscode-extension/schemas/aiwg.config.v1.json +2 -4
@@ -0,0 +1,462 @@
1
+ /**
2
+ * ConciergeResponseTranslator — converts raw skill/agent/flow output into
3
+ * composed, appropriately-toned replies for the daemon Concierge.
4
+ *
5
+ * Pipeline position:
6
+ * [ Skill / Agent / Flow ] → raw output
7
+ * ↓
8
+ * [ ResponseTranslator ]
9
+ * - Apply tone rules (prompt, pertinent, pleasant, professional, discreet)
10
+ * - Reduce technical noise (paths, stack traces, debug lines)
11
+ * - Reformat for audience
12
+ * - Preserve fidelity — no actionable information is silently dropped
13
+ * ↓
14
+ * [ User ]
15
+ *
16
+ * Bypass: callers may pass { raw: true } or { verbose: true } to skip
17
+ * translation entirely (for debugging or power-user access).
18
+ *
19
+ * @issue #607
20
+ * @tests @test/unit/daemon/concierge/response-translator.test.js
21
+ */
22
+
23
+ // ---------------------------------------------------------------------------
24
+ // Constants
25
+ // ---------------------------------------------------------------------------
26
+
27
+ /**
28
+ * Sensitive operation categories.
29
+ * When raw output is classified as one of these, discreet mode is applied
30
+ * automatically unless the caller explicitly requests verbose output.
31
+ */
32
+ const SENSITIVE_OPERATION_CATEGORIES = new Set([
33
+ 'token-rotation',
34
+ 'credential-update',
35
+ 'security-finding',
36
+ 'key-management',
37
+ ]);
38
+
39
+ /**
40
+ * Patterns that identify sensitive content in raw output.
41
+ * Matched lines are suppressed in discreet mode.
42
+ */
43
+ const SENSITIVE_PATTERNS = [
44
+ /\b(token|secret|api[_-]?key|password|credential|private[_-]?key|bearer)\s*[:=]\s*\S+/i,
45
+ /eyJ[A-Za-z0-9_-]{10,}/, // JWT token shape
46
+ /ghp_[A-Za-z0-9]{36}/, // GitHub PAT
47
+ /sk-[A-Za-z0-9]{32,}/, // OpenAI key shape
48
+ /\b[0-9a-f]{40}\b/, // 40-char hex (token/hash)
49
+ ];
50
+
51
+ /**
52
+ * Patterns that indicate technical noise to suppress by default.
53
+ */
54
+ const NOISE_PATTERNS = [
55
+ /^\s+at\s+\S+\s+\(\S+:\d+:\d+\)/m, // JS stack frame
56
+ /^\s+at\s+\S+:\d+:\d+$/m, // Node stack frame (no parens)
57
+ /^(node|npm|yarn|pnpm):.*error/im, // Toolchain noise
58
+ /\bDEBUG\b.*:/i, // Debug log lines
59
+ /\bTRACE\b.*:/i, // Trace log lines
60
+ /^\[.*\]\s*(debug|trace|verbose)\b/im, // Structured debug/trace entries
61
+ ];
62
+
63
+ /**
64
+ * Absolute file paths that should be redacted in discreet mode.
65
+ * Replaced with a short placeholder.
66
+ */
67
+ const PATH_PATTERN = /(?:\/(?:home|Users|root|tmp|var|opt|mnt|srv|etc|usr|private)\S+|[A-Z]:[\\\/]\S+)/g;
68
+
69
+ /**
70
+ * Filler phrases that violate the "pertinent" tone rule.
71
+ * Stripped from translated output.
72
+ */
73
+ const FILLER_PHRASES = [
74
+ /\bi have\s+(successfully|just|now)\s+/gi,
75
+ /\bas\s+you\s+requested[,.]?\s*/gi,
76
+ /\bcertainly[!,.]?\s*/gi,
77
+ /\bof\s+course[!,.]?\s*/gi,
78
+ /\bgreat\s+(question|idea|suggestion)[!.]?\s*/gi,
79
+ /\bi('d|would)\s+be\s+happy\s+to\s+/gi,
80
+ /\bplease\s+note\s+that\s*/gi,
81
+ /\bit('s|is)\s+important\s+to\s+note\s+that\s*/gi,
82
+ /\bthank\s+you\s+for\s+(your\s+)?(patience|question|feedback)[.!]?\s*/gi,
83
+ ];
84
+
85
+ // ---------------------------------------------------------------------------
86
+ // Raw output type classifier
87
+ // ---------------------------------------------------------------------------
88
+
89
+ /**
90
+ * Classify the raw output into a translation strategy.
91
+ *
92
+ * @param {string} raw
93
+ * @param {string} [sourceType] Explicit type hint from caller ('doctor', 'sync', 'agent', etc.)
94
+ * @returns {string} Output type key
95
+ */
96
+ function classifyOutput(raw, sourceType) {
97
+ if (sourceType) return sourceType;
98
+ if (!raw || typeof raw !== 'string') return 'empty';
99
+
100
+ const lower = raw.toLowerCase();
101
+
102
+ if (lower.includes('error') && (lower.includes('stack') || lower.includes(' at '))) {
103
+ return 'stack-trace';
104
+ }
105
+ if (/✓|✗|●\s*(pass|fail)|tests?\s+(passed|failed)/i.test(raw)) {
106
+ return 'test-results';
107
+ }
108
+ if (/\b(synced?|updated?\s+to|redeployed|provider)\b/i.test(raw)) {
109
+ return 'sync-log';
110
+ }
111
+ if (/\b(healthy?|ok|warning|error|issue)\b.*\n.*\b(healthy?|ok|warning|error|issue)\b/i.test(raw)) {
112
+ return 'doctor-output';
113
+ }
114
+ if (/^(error|warn(ing)?|info|debug):/im.test(raw)) {
115
+ return 'log-output';
116
+ }
117
+ if (raw.trim().length === 0) {
118
+ return 'empty';
119
+ }
120
+
121
+ return 'agent-result';
122
+ }
123
+
124
+ // ---------------------------------------------------------------------------
125
+ // ConciergeResponseTranslator
126
+ // ---------------------------------------------------------------------------
127
+
128
+ export class ConciergeResponseTranslator {
129
+ /**
130
+ * @param {Object} [options]
131
+ * @param {boolean} [options.redactPaths=true] Strip absolute paths from output
132
+ * @param {boolean} [options.stripFiller=true] Remove filler phrases
133
+ * @param {boolean} [options.suppressNoise=true] Remove debug/trace lines
134
+ * @param {number} [options.summaryThreshold=500] Character count above which
135
+ * output is summarised with an expand offer (0 = never summarise)
136
+ */
137
+ constructor({
138
+ redactPaths = true,
139
+ stripFiller = true,
140
+ suppressNoise = true,
141
+ summaryThreshold = 500,
142
+ } = {}) {
143
+ this.redactPaths = redactPaths;
144
+ this.stripFiller = stripFiller;
145
+ this.suppressNoise = suppressNoise;
146
+ this.summaryThreshold = summaryThreshold;
147
+ }
148
+
149
+ // -------------------------------------------------------------------------
150
+ // Public API
151
+ // -------------------------------------------------------------------------
152
+
153
+ /**
154
+ * Translate raw output into a composed, concierge-voiced response.
155
+ *
156
+ * @param {string} raw Raw output from the underlying skill/agent/flow
157
+ * @param {Object} [options]
158
+ * @param {boolean} [options.raw] Skip translation (return raw as-is)
159
+ * @param {boolean} [options.verbose] Alias for raw
160
+ * @param {string} [options.sourceType] Output type hint (see classifyOutput)
161
+ * @param {boolean} [options.discreet] Force discreet mode
162
+ * @param {boolean} [options.isSensitive] Mark as sensitive (enables discreet mode)
163
+ * @param {string} [options.context] Brief context string for anonymous outputs
164
+ * @returns {TranslationResult}
165
+ */
166
+ translate(raw, options = {}) {
167
+ const { raw: rawMode, verbose, sourceType, discreet, isSensitive, context } = options;
168
+ const bypass = rawMode || verbose;
169
+
170
+ if (bypass) {
171
+ return { translated: raw ?? '', bypassed: true, discreetApplied: false };
172
+ }
173
+
174
+ const outputType = classifyOutput(raw, sourceType);
175
+ const applyDiscreet = discreet || isSensitive || SENSITIVE_OPERATION_CATEGORIES.has(outputType);
176
+
177
+ let result = raw ?? '';
178
+
179
+ // 1. Suppress sensitive content in discreet mode
180
+ if (applyDiscreet) {
181
+ result = this._applySensitiveRedaction(result);
182
+ }
183
+
184
+ // 2. Remove technical noise (stack frames, debug lines)
185
+ if (this.suppressNoise) {
186
+ result = this._suppressNoise(result);
187
+ }
188
+
189
+ // 3. Redact absolute file paths
190
+ if (this.redactPaths && applyDiscreet) {
191
+ result = result.replace(PATH_PATTERN, '[path]');
192
+ }
193
+
194
+ // 4. Strip filler phrases
195
+ if (this.stripFiller) {
196
+ result = this._stripFiller(result);
197
+ }
198
+
199
+ // 5. Apply type-specific translation
200
+ result = this._translateByType(result, outputType, context);
201
+
202
+ // 6. Normalise whitespace
203
+ result = result.replace(/\n{3,}/g, '\n\n').trim();
204
+
205
+ return {
206
+ translated: result,
207
+ bypassed: false,
208
+ discreetApplied: applyDiscreet,
209
+ outputType,
210
+ };
211
+ }
212
+
213
+ /**
214
+ * Check whether a string contains sensitive content.
215
+ * Used by callers to decide whether to enable discreet mode.
216
+ *
217
+ * @param {string} text
218
+ * @returns {boolean}
219
+ */
220
+ isSensitiveContent(text) {
221
+ if (!text) return false;
222
+ return SENSITIVE_PATTERNS.some((p) => p.test(text));
223
+ }
224
+
225
+ /**
226
+ * Determine whether a given operation category triggers discreet mode.
227
+ *
228
+ * @param {string} category
229
+ * @returns {boolean}
230
+ */
231
+ isSensitiveCategory(category) {
232
+ return SENSITIVE_OPERATION_CATEGORIES.has(category);
233
+ }
234
+
235
+ // -------------------------------------------------------------------------
236
+ // Type-specific translation strategies
237
+ // -------------------------------------------------------------------------
238
+
239
+ /**
240
+ * Route to the appropriate translation strategy by output type.
241
+ */
242
+ _translateByType(text, outputType, context) {
243
+ switch (outputType) {
244
+ case 'doctor-output': return this._translateDoctorOutput(text);
245
+ case 'stack-trace': return this._translateStackTrace(text, context);
246
+ case 'sync-log': return this._translateSyncLog(text);
247
+ case 'test-results': return this._translateTestResults(text);
248
+ case 'log-output': return this._translateLogOutput(text);
249
+ case 'empty': return this._translateEmpty(context);
250
+ case 'token-rotation':
251
+ case 'credential-update':
252
+ case 'key-management': return this._translateSensitiveOp(text, context);
253
+ default: return this._translateAgentResult(text);
254
+ }
255
+ }
256
+
257
+ /**
258
+ * `aiwg doctor` output → concise health summary
259
+ */
260
+ _translateDoctorOutput(text) {
261
+ const issues = [];
262
+ const lines = text.split('\n');
263
+
264
+ let healthyCount = 0;
265
+ let issueCount = 0;
266
+
267
+ for (const line of lines) {
268
+ if (/\b(ok|healthy|pass|✓)\b/i.test(line)) {
269
+ healthyCount++;
270
+ } else if (/\b(error|fail|warn(ing)?|issue|missing|✗)\b/i.test(line)) {
271
+ issueCount++;
272
+ // Extract a short label from the line for the summary
273
+ const label = line.replace(/^.*?(error|fail|warn(ing)?|issue|missing|✗)[:\s]*/i, '').trim();
274
+ if (label && label.length < 120) {
275
+ issues.push(label);
276
+ }
277
+ }
278
+ }
279
+
280
+ if (issueCount === 0) {
281
+ return 'All systems healthy.';
282
+ }
283
+
284
+ const summary = `${issueCount} issue${issueCount === 1 ? '' : 's'} found.`;
285
+ const detail = issues.slice(0, 3).join('; ');
286
+ return issues.length > 0
287
+ ? `${summary} ${detail}${issues.length > 3 ? ` (and ${issues.length - 3} more)` : '.'}`
288
+ : summary;
289
+ }
290
+
291
+ /**
292
+ * Stack trace / error → actionable summary
293
+ */
294
+ _translateStackTrace(text, context) {
295
+ // Extract the top-level error message (first non-blank line)
296
+ const lines = text.split('\n').filter((l) => l.trim());
297
+ const topError = lines.find((l) => /\b(error|exception|failed|cannot|unable)\b/i.test(l));
298
+ const errorLabel = topError
299
+ ? topError.replace(/^(Error|TypeError|RangeError|SyntaxError):\s*/i, '').trim()
300
+ : 'an unexpected error';
301
+
302
+ const what = context ? `${context}` : 'the operation';
303
+ return `I encountered a problem with ${what} — ${errorLabel}. The details have been logged.`;
304
+ }
305
+
306
+ /**
307
+ * Verbose sync log → compact confirmation
308
+ */
309
+ _translateSyncLog(text) {
310
+ // Look for version number
311
+ const versionMatch = text.match(/v?(\d{4}\.\d+\.\d+)/);
312
+ const version = versionMatch ? `v${versionMatch[1]}` : null;
313
+
314
+ // Count redeployed providers
315
+ const redeployMatches = text.match(/redeploy(ed|ing)/gi);
316
+ const redeployCount = redeployMatches ? redeployMatches.length : null;
317
+
318
+ if (version && redeployCount) {
319
+ return `Updated to ${version}. ${redeployCount} provider${redeployCount === 1 ? '' : 's'} redeployed.`;
320
+ }
321
+ if (version) {
322
+ return `Updated to ${version}.`;
323
+ }
324
+
325
+ return 'Sync complete.';
326
+ }
327
+
328
+ /**
329
+ * Test results → concise pass/fail summary
330
+ */
331
+ _translateTestResults(text) {
332
+ const passMatch = text.match(/(\d+)\s+(tests?\s+)?(passed|✓)/i);
333
+ const failMatch = text.match(/(\d+)\s+(tests?\s+)?(failed|✗|●)/i);
334
+
335
+ const passed = passMatch ? parseInt(passMatch[1], 10) : null;
336
+ const failed = failMatch ? parseInt(failMatch[1], 10) : null;
337
+
338
+ if (failed !== null && failed > 0) {
339
+ const detail = passed !== null ? ` (${passed} passed)` : '';
340
+ return `${failed} test${failed === 1 ? '' : 's'} failed${detail}. Review the output for details.`;
341
+ }
342
+
343
+ if (passed !== null) {
344
+ return `All ${passed} test${passed === 1 ? '' : 's'} passed.`;
345
+ }
346
+
347
+ // Fallback: preserve the result but strip noise
348
+ return text.trim();
349
+ }
350
+
351
+ /**
352
+ * Structured log output → surface warnings/errors only
353
+ */
354
+ _translateLogOutput(text) {
355
+ const lines = text.split('\n');
356
+ const important = lines.filter((l) => /^(error|warn(ing)?|fatal):/i.test(l.trim()));
357
+
358
+ if (important.length === 0) {
359
+ return 'Completed successfully.';
360
+ }
361
+
362
+ return important.slice(0, 5).join('\n');
363
+ }
364
+
365
+ /**
366
+ * Empty output → in-persona acknowledgment
367
+ */
368
+ _translateEmpty(context) {
369
+ return context ? `${context} — no output returned.` : 'Completed — no output to report.';
370
+ }
371
+
372
+ /**
373
+ * Sensitive operation output → minimal confirmation
374
+ */
375
+ _translateSensitiveOp(_text, context) {
376
+ const what = context || 'The operation';
377
+ return `${what} completed. Ask for details if needed.`;
378
+ }
379
+
380
+ /**
381
+ * Generic agent/skill result → structured summary
382
+ */
383
+ _translateAgentResult(text) {
384
+ if (!text || !text.trim()) return this._translateEmpty();
385
+
386
+ // If already compact, return as-is
387
+ if (text.trim().length <= this.summaryThreshold) {
388
+ return text.trim();
389
+ }
390
+
391
+ // Long output: extract the first meaningful paragraph as a summary
392
+ const paragraphs = text.split(/\n\n+/).filter((p) => p.trim());
393
+ if (paragraphs.length > 1) {
394
+ const summary = paragraphs[0].trim();
395
+ return summary + '\n\n*(Full details available — ask to expand.)*';
396
+ }
397
+
398
+ return text.trim();
399
+ }
400
+
401
+ // -------------------------------------------------------------------------
402
+ // Noise / filler / redaction helpers
403
+ // -------------------------------------------------------------------------
404
+
405
+ /**
406
+ * Redact lines containing sensitive credential patterns.
407
+ */
408
+ _applySensitiveRedaction(text) {
409
+ return text
410
+ .split('\n')
411
+ .map((line) => {
412
+ for (const pattern of SENSITIVE_PATTERNS) {
413
+ if (pattern.test(line)) {
414
+ return '[sensitive content redacted]';
415
+ }
416
+ }
417
+ return line;
418
+ })
419
+ .join('\n');
420
+ }
421
+
422
+ /**
423
+ * Remove debug/trace noise lines while preserving the rest.
424
+ */
425
+ _suppressNoise(text) {
426
+ return text
427
+ .split('\n')
428
+ .filter((line) => !NOISE_PATTERNS.some((p) => p.test(line)))
429
+ .join('\n');
430
+ }
431
+
432
+ /**
433
+ * Strip filler phrases that violate the "pertinent" tone rule.
434
+ */
435
+ _stripFiller(text) {
436
+ let result = text;
437
+ for (const pattern of FILLER_PHRASES) {
438
+ result = result.replace(pattern, '');
439
+ }
440
+ return result;
441
+ }
442
+ }
443
+
444
+ // ---------------------------------------------------------------------------
445
+ // Exports
446
+ // ---------------------------------------------------------------------------
447
+
448
+ export {
449
+ SENSITIVE_OPERATION_CATEGORIES,
450
+ SENSITIVE_PATTERNS,
451
+ NOISE_PATTERNS,
452
+ FILLER_PHRASES,
453
+ classifyOutput,
454
+ };
455
+
456
+ /**
457
+ * @typedef {Object} TranslationResult
458
+ * @property {string} translated The translated (or raw-bypassed) response
459
+ * @property {boolean} bypassed True when raw/verbose bypass was applied
460
+ * @property {boolean} discreetApplied True when discreet mode was applied
461
+ * @property {string} [outputType] Classified output type (absent when bypassed)
462
+ */