@aiwg/cli 2026.10.15 → 2026.10.16

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 (180) 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 +23 -9
  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/cli/handlers/daemon.js +17 -1
  26. package/dist/src/cli/handlers/doctor-args.js +10 -5
  27. package/dist/src/cli/handlers/doctor-help.js +4 -1
  28. package/dist/src/cli/handlers/index.js +2 -2
  29. package/dist/src/cli/handlers/models-resource-sample.js +10 -0
  30. package/dist/src/cli/handlers/models.js +3 -2
  31. package/dist/src/cli/handlers/regenerate.js +8 -16
  32. package/dist/src/cli/handlers/sessions.js +7 -7
  33. package/dist/src/cli/handlers/subcommands.js +8 -0
  34. package/dist/src/cli/handlers/update.js +157 -0
  35. package/dist/src/cli/handlers/use.js +14 -4
  36. package/dist/src/cli/handlers/utilities.js +3 -560
  37. package/dist/src/cli/handlers/utility-doctor.js +412 -0
  38. package/dist/src/cli/services/deployment-verification.js +0 -1
  39. package/dist/src/config/aiwg-config.js +2 -1
  40. package/dist/src/config/authorization-cli.js +7 -3
  41. package/dist/src/config/dispatch-thresholds-runtime.d.mts +3 -2
  42. package/dist/src/config/dispatch-thresholds-runtime.mjs +17 -7
  43. package/dist/src/config/framework-aliases.js +12 -0
  44. package/dist/src/config/host-resource-report.d.mts +19 -0
  45. package/dist/src/config/host-resource-report.mjs +80 -0
  46. package/dist/src/config/host-resource-runtime.d.mts +34 -0
  47. package/dist/src/config/host-resource-runtime.mjs +293 -0
  48. package/dist/src/config/installed-selection.js +22 -0
  49. package/dist/src/config/worker-invocation-marker.d.mts +1 -0
  50. package/dist/src/config/worker-invocation-marker.mjs +2 -0
  51. package/dist/src/decision/heldout/access.js +74 -0
  52. package/dist/src/decision/heldout/calibration.js +1 -0
  53. package/dist/src/decision/heldout/collector.js +8 -1
  54. package/dist/src/effects/verifiers/file.js +22 -5
  55. package/dist/src/extensions/claude-attribution.js +82 -0
  56. package/dist/src/extensions/claude-hooks-installer.js +115 -69
  57. package/dist/src/extensions/commands/daemon.js +109 -0
  58. package/dist/src/extensions/commands/definitions.js +5 -89
  59. package/dist/src/gates/heldout.js +17 -7
  60. package/dist/src/lint/check-patterns.js +163 -0
  61. package/dist/src/lint/checks.js +268 -0
  62. package/dist/src/lint/reference-resolution.js +54 -0
  63. package/dist/src/lint/runner.js +3 -465
  64. package/dist/src/mcp/helpers.mjs +11 -1
  65. package/dist/src/memory/project-registry.js +44 -4
  66. package/dist/src/models/worker-plan.js +36 -5
  67. package/dist/src/models/wrapper-deployment.js +25 -12
  68. package/dist/src/models/wrapper-enforcement.js +47 -7
  69. package/dist/src/network-analysis/research.js +2 -1
  70. package/dist/src/policy/hitl-check.js +14 -4
  71. package/dist/src/policy/hitl-consume.js +54 -0
  72. package/dist/src/policy/hitl-receipt.js +2 -0
  73. package/dist/src/policy/hitl.js +11 -3
  74. package/dist/src/providers/provider-context-contracts.js +162 -0
  75. package/dist/src/providers/provider-definition-schema.js +136 -0
  76. package/dist/src/providers/provider-definitions.js +8 -1298
  77. package/dist/src/providers/provider-seeds-1.js +360 -0
  78. package/dist/src/providers/provider-seeds-2.js +387 -0
  79. package/dist/src/providers/provider-seeds-3.js +262 -0
  80. package/dist/src/research/clients/arxiv.js +4 -30
  81. package/dist/src/research/clients/base.js +48 -22
  82. package/dist/src/research/identity.js +34 -2
  83. package/dist/src/research/query-cli.js +3 -87
  84. package/dist/src/research/query-options.js +87 -0
  85. package/dist/src/research/reference-match.js +70 -24
  86. package/dist/src/research/services/acquisition.js +9 -7
  87. package/dist/src/research/services/citation.js +5 -2
  88. package/dist/src/research/types.js +2 -0
  89. package/dist/src/serve/mission-conductor.js +48 -4
  90. package/dist/src/sessions/adapters/grok-build-native.js +23 -0
  91. package/dist/src/sessions/adapters/grok-build.js +14 -7
  92. package/dist/src/sessions/workspace-discovery.js +5 -5
  93. package/dist/src/smiths/context-pipeline/aiwg-md.js +16 -46
  94. package/dist/src/smiths/context-pipeline/claude-hook.js +1 -1
  95. package/dist/src/smiths/context-pipeline/code-regions.js +28 -0
  96. package/dist/src/smiths/context-pipeline/finalization.js +81 -51
  97. package/dist/src/smiths/context-pipeline/generator.js +9 -10
  98. package/dist/src/smiths/context-pipeline/managed-hook.js +1 -1
  99. package/dist/src/smiths/context-pipeline/muse-bridge.js +2 -2
  100. package/dist/src/smiths/context-pipeline/provider-policy.js +6 -12
  101. package/dist/src/smiths/context-pipeline/workspace-audit.js +299 -0
  102. package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +148 -0
  103. package/dist/src/smiths/context-pipeline/workspace-context-shared.js +111 -0
  104. package/dist/src/smiths/context-pipeline/workspace-context.js +8 -1373
  105. package/dist/src/smiths/context-pipeline/workspace-doctor.js +192 -0
  106. package/dist/src/smiths/context-pipeline/workspace-document.js +201 -0
  107. package/dist/src/smiths/context-pipeline/workspace-extraction.js +205 -0
  108. package/dist/src/smiths/context-pipeline/workspace-migration.js +250 -0
  109. package/package.json +10 -1
  110. package/schemas/decision/D29Study.v10.schema.json +65 -0
  111. package/tools/agents/deploy-agents.mjs +10 -0
  112. package/tools/agents/providers/claude-post-deploy.mjs +12 -1
  113. package/tools/agents/providers/context-write.mjs +4 -0
  114. package/tools/agents/providers/pi.mjs +3 -1
  115. package/tools/agents/providers/rule-delivery-surface.mjs +332 -0
  116. package/tools/agents/providers/rule-delivery.mjs +20 -1144
  117. package/tools/agents/providers/rule-deployment-commit.mjs +144 -0
  118. package/tools/agents/providers/rule-deployment-prepare.mjs +452 -0
  119. package/tools/agents/providers/rule-deployment-state.mjs +300 -0
  120. package/tools/daemon/README.md +511 -0
  121. package/tools/daemon/adapters/base-adapter.mjs +84 -0
  122. package/tools/daemon/adapters/webhook-adapter.mjs +107 -0
  123. package/tools/daemon/agent-supervisor.mjs +299 -0
  124. package/tools/daemon/automation-engine.mjs +310 -0
  125. package/tools/daemon/autonomous-engine.mjs +346 -0
  126. package/tools/daemon/behavior-loader.mjs +316 -0
  127. package/tools/daemon/behavior.mjs +174 -0
  128. package/tools/daemon/concierge/intent-router.mjs +401 -0
  129. package/tools/daemon/concierge/orchestrator.mjs +272 -0
  130. package/tools/daemon/concierge/response-translator.mjs +462 -0
  131. package/tools/daemon/config.mjs +377 -0
  132. package/tools/daemon/cron-scheduler.mjs +178 -0
  133. package/tools/daemon/daemon-main.mjs +1169 -0
  134. package/tools/daemon/event-router.mjs +84 -0
  135. package/tools/daemon/file-watcher.mjs +383 -0
  136. package/tools/daemon/index.mjs +1181 -0
  137. package/tools/daemon/init-profile.mjs +124 -0
  138. package/tools/daemon/ipc-client.mjs +197 -0
  139. package/tools/daemon/ipc-ops-handlers.mjs +236 -0
  140. package/tools/daemon/ipc-server.mjs +275 -0
  141. package/tools/daemon/maintenance-owner.mjs +79 -0
  142. package/tools/daemon/memory-manager.mjs +386 -0
  143. package/tools/daemon/message-router.mjs +194 -0
  144. package/tools/daemon/provider-watcher.mjs +585 -0
  145. package/tools/daemon/pty-adapter.mjs +420 -0
  146. package/tools/daemon/repl-chat.mjs +359 -0
  147. package/tools/daemon/resource-bounds.mjs +88 -0
  148. package/tools/daemon/sandbox-transport.mjs +295 -0
  149. package/tools/daemon/scheduled-task-runner.mjs +535 -0
  150. package/tools/daemon/task-store.mjs +450 -0
  151. package/tools/daemon/tmux-manager.mjs +324 -0
  152. package/tools/daemon/update-policy.mjs +517 -0
  153. package/tools/daemon/web-server.mjs +399 -0
  154. package/tools/daemon/web-ui/index.html +585 -0
  155. package/tools/daemon/web-ui/styles.css +156 -0
  156. package/tools/docker/Dockerfile.daemon +35 -0
  157. package/tools/docker/container-manager.mjs +291 -0
  158. package/tools/messaging/adapter-registry.mjs +230 -0
  159. package/tools/messaging/adapters/base.mjs +326 -0
  160. package/tools/messaging/adapters/discord.mjs +462 -0
  161. package/tools/messaging/adapters/slack.mjs +402 -0
  162. package/tools/messaging/adapters/telegram.mjs +552 -0
  163. package/tools/messaging/chat-handler.mjs +297 -0
  164. package/tools/messaging/command-router.mjs +269 -0
  165. package/tools/messaging/event-bus.mjs +199 -0
  166. package/tools/messaging/index.mjs +456 -0
  167. package/tools/messaging/message-formatter.mjs +320 -0
  168. package/tools/messaging/room-manager.mjs +277 -0
  169. package/tools/messaging/types.mjs +94 -0
  170. package/tools/providers/pi-bridge-policy.mjs +4 -0
  171. package/tools/ralph-external/daemon-supervisor.mjs +394 -0
  172. package/tools/ralph-external/lib/behavior-registry.mjs +270 -0
  173. package/tools/ralph-external/lib/worker-invocation-processes.mjs +3 -2
  174. package/tools/ralph-external/lib/worker-isolation-args.mjs +217 -0
  175. package/tools/ralph-external/lib/worker-isolation-status.mjs +19 -0
  176. package/tools/ralph-external/lib/worker-isolation.mjs +11 -237
  177. package/tools/ralph-external/lib/worker-overflow.mjs +10 -2
  178. package/tools/ralph-external/lib/worker-unit-cleanup.mjs +72 -0
  179. package/tools/ralph-external/session-launcher.mjs +7 -7
  180. package/tools/scripts/resource-preflight.mjs +3 -242
@@ -0,0 +1,156 @@
1
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
2
+
3
+ :root {
4
+ --bg: #1a1a2e;
5
+ --bg2: #16213e;
6
+ --bg3: #0f3460;
7
+ --bg-alt: #1e1e38;
8
+ --text: #e0e0e0;
9
+ --muted: #8888aa;
10
+ --code: #c8d8f0;
11
+ --accent: #00d4aa;
12
+ --acc-dim: #009977;
13
+ --border: #2a2a4a;
14
+ --s-run: #00d4aa;
15
+ --s-que: #f0c040;
16
+ --s-fail: #e05050;
17
+ --s-done: #606080;
18
+ --radius: 4px;
19
+ --mono: 'Cascadia Code', 'Fira Code', 'Consolas', monospace;
20
+ --ui: system-ui, -apple-system, 'Segoe UI', sans-serif;
21
+ }
22
+
23
+ body {
24
+ background: var(--bg); color: var(--text); font-family: var(--ui);
25
+ font-size: 14px; line-height: 1.5; min-height: 100vh;
26
+ display: flex; flex-direction: column;
27
+ }
28
+
29
+ /* Header */
30
+ header {
31
+ background: var(--bg2); border-bottom: 1px solid var(--border);
32
+ padding: 10px 20px; display: flex; align-items: center; gap: 16px; flex-shrink: 0;
33
+ }
34
+ header h1 { font-size: 15px; font-weight: 600; color: var(--accent); font-family: var(--mono); letter-spacing: .05em; }
35
+ #daemon-status-badge {
36
+ font-size: 12px; font-family: var(--mono); color: var(--muted);
37
+ padding: 2px 8px; border: 1px solid var(--border); border-radius: var(--radius);
38
+ }
39
+ #daemon-status-badge.healthy { color: var(--s-run); border-color: var(--s-run); }
40
+ #daemon-status-badge.degraded { color: var(--s-que); border-color: var(--s-que); }
41
+ #daemon-status-badge.error { color: var(--s-fail); border-color: var(--s-fail); }
42
+ header .spacer { flex: 1; }
43
+ #uptime { font-size: 12px; color: var(--muted); font-family: var(--mono); }
44
+
45
+ /* Tabs */
46
+ nav#tabs {
47
+ background: var(--bg2); border-bottom: 1px solid var(--border);
48
+ display: flex; padding: 0 20px; gap: 2px; flex-shrink: 0;
49
+ }
50
+ nav#tabs button {
51
+ background: none; border: none; border-bottom: 2px solid transparent;
52
+ color: var(--muted); cursor: pointer; font-family: var(--ui); font-size: 13px;
53
+ padding: 10px 16px; transition: color .15s, border-color .15s;
54
+ }
55
+ nav#tabs button:hover { color: var(--text); }
56
+ nav#tabs button.active { color: var(--accent); border-bottom-color: var(--accent); }
57
+
58
+ /* Layout */
59
+ main { flex: 1; overflow: hidden; display: flex; flex-direction: column; }
60
+ .tab-panel { display: none; flex: 1; overflow: auto; padding: 20px; flex-direction: column; }
61
+ .tab-panel.active { display: flex; }
62
+ h2 {
63
+ font-size: 12px; font-weight: 700; color: var(--muted);
64
+ letter-spacing: .07em; text-transform: uppercase; margin-bottom: 12px;
65
+ }
66
+
67
+ /* Tables */
68
+ .table-wrap { overflow-x: auto; border: 1px solid var(--border); border-radius: var(--radius); }
69
+ table { width: 100%; border-collapse: collapse; font-size: 13px; }
70
+ thead tr { background: var(--bg3); }
71
+ thead th {
72
+ padding: 8px 12px; text-align: left; font-weight: 600;
73
+ color: var(--muted); font-size: 11px; letter-spacing: .06em;
74
+ text-transform: uppercase; white-space: nowrap;
75
+ }
76
+ tbody tr { border-top: 1px solid var(--border); cursor: pointer; transition: background .1s; }
77
+ tbody tr:nth-child(even) { background: var(--bg-alt); }
78
+ tbody tr:hover { background: var(--bg3); }
79
+ tbody tr.selected { background: #0f3460; outline: 1px solid var(--accent); }
80
+ td { padding: 8px 12px; font-family: var(--mono); font-size: 12px; white-space: nowrap; }
81
+ td.wrap { white-space: normal; word-break: break-word; max-width: 300px; }
82
+
83
+ /* Status dots */
84
+ .dot { display: inline-block; width: 8px; height: 8px; border-radius: 50%; margin-right: 6px; vertical-align: middle; }
85
+ .dot-running { background: var(--s-run); box-shadow: 0 0 6px var(--s-run); }
86
+ .dot-queued { background: var(--s-que); }
87
+ .dot-failed { background: var(--s-fail); }
88
+ .dot-completed { background: var(--s-done); }
89
+ .dot-permanently-failed { background: #c03030; }
90
+
91
+ /* Buttons */
92
+ .btn {
93
+ background: none; border: 1px solid var(--border); border-radius: var(--radius);
94
+ color: var(--text); cursor: pointer; font-family: var(--ui); font-size: 13px;
95
+ padding: 6px 14px; transition: background .15s, border-color .15s;
96
+ }
97
+ .btn:hover { background: var(--bg3); border-color: var(--accent); }
98
+ .btn-accent { background: var(--acc-dim); border-color: var(--accent); color: #fff; }
99
+ .btn-accent:hover { background: var(--accent); }
100
+ .btn-danger { border-color: var(--s-fail); color: var(--s-fail); }
101
+ .btn-danger:hover { background: rgba(224,80,80,.15); }
102
+ .btn-sm { padding: 3px 10px; font-size: 12px; }
103
+
104
+ /* Output */
105
+ #output-panel { display: flex; flex-direction: column; gap: 12px; }
106
+ #output-toolbar { display: flex; align-items: center; gap: 12px; }
107
+ #output-loop-id { font-family: var(--mono); color: var(--accent); font-size: 13px; }
108
+ #output-stream {
109
+ flex: 1; background: #0d0d1a; border: 1px solid var(--border);
110
+ border-radius: var(--radius); font-family: var(--mono); font-size: 12px;
111
+ color: var(--code); padding: 12px; overflow-y: auto;
112
+ white-space: pre-wrap; word-break: break-all;
113
+ min-height: 300px; max-height: calc(100vh - 240px);
114
+ }
115
+ #output-stream .line { display: block; line-height: 1.6; }
116
+
117
+ /* Submit form */
118
+ #submit-panel { max-width: 560px; }
119
+ .form-group { display: flex; flex-direction: column; gap: 6px; margin-bottom: 16px; }
120
+ .form-group label { font-size: 12px; color: var(--muted); font-weight: 600; letter-spacing: .04em; }
121
+ .form-group textarea,
122
+ .form-group input,
123
+ .form-group select {
124
+ background: var(--bg2); border: 1px solid var(--border); border-radius: var(--radius);
125
+ color: var(--text); font-family: var(--ui); font-size: 13px; padding: 8px 10px;
126
+ transition: border-color .15s; width: 100%;
127
+ }
128
+ .form-group textarea { min-height: 80px; resize: vertical; }
129
+ .form-group textarea:focus,
130
+ .form-group input:focus,
131
+ .form-group select:focus { border-color: var(--accent); outline: none; }
132
+ .form-row { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 12px; margin-bottom: 16px; }
133
+ #submit-result {
134
+ font-family: var(--mono); font-size: 12px; margin-top: 12px;
135
+ padding: 8px 12px; border-radius: var(--radius); display: none;
136
+ }
137
+ #submit-result.ok { background: rgba(0,212,170,.1); color: var(--accent); }
138
+ #submit-result.err { background: rgba(224,80,80,.1); color: var(--s-fail); }
139
+
140
+ /* Resources */
141
+ #resources-panel { max-width: 640px; }
142
+ .metrics-grid { display: grid; grid-template-columns: repeat(2,1fr); gap: 12px; margin-bottom: 20px; }
143
+ .metric-card { background: var(--bg2); border: 1px solid var(--border); border-radius: var(--radius); padding: 14px 16px; }
144
+ .metric-card .label { font-size: 11px; color: var(--muted); text-transform: uppercase; letter-spacing: .06em; margin-bottom: 6px; }
145
+ .metric-card .value { font-family: var(--mono); font-size: 22px; color: var(--accent); font-weight: 700; }
146
+ .metric-card .sub { font-size: 11px; color: var(--muted); margin-top: 2px; font-family: var(--mono); }
147
+ .progress-bar { height: 6px; background: var(--border); border-radius: 3px; margin-top: 8px; overflow: hidden; }
148
+ .progress-fill { height: 100%; background: var(--accent); border-radius: 3px; transition: width .4s; }
149
+ .progress-fill.warn { background: var(--s-que); }
150
+ .progress-fill.crit { background: var(--s-fail); }
151
+
152
+ /* Responsive */
153
+ @media (max-width: 640px) {
154
+ .form-row { grid-template-columns: 1fr; }
155
+ .metrics-grid { grid-template-columns: 1fr; }
156
+ }
@@ -0,0 +1,35 @@
1
+ FROM node:24-slim
2
+
3
+ # System dependencies
4
+ RUN apt-get update && apt-get install -y --no-install-recommends \
5
+ git \
6
+ curl \
7
+ ca-certificates \
8
+ && rm -rf /var/lib/apt/lists/*
9
+
10
+ # Install provider CLIs
11
+ RUN npm install -g @anthropic-ai/claude-code @openai/codex 2>/dev/null || true
12
+
13
+ # Copy AIWG package
14
+ WORKDIR /opt/aiwg
15
+ COPY package*.json ./
16
+ RUN npm ci --production --ignore-scripts 2>/dev/null || npm install --production --ignore-scripts
17
+ COPY . .
18
+
19
+ # Workspace mount point
20
+ RUN mkdir -p /workspace
21
+ WORKDIR /workspace
22
+
23
+ # Environment
24
+ ENV NODE_ENV=production
25
+ ENV CI=true
26
+ ENV AIWG_DOCKER=1
27
+
28
+ # Web UI port
29
+ EXPOSE 7474
30
+
31
+ # Health check via heartbeat file
32
+ HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
33
+ CMD node -e "const fs=require('fs');const hb=JSON.parse(fs.readFileSync('/workspace/.aiwg/daemon/heartbeat','utf8'));const age=Date.now()-new Date(hb.timestamp).getTime();process.exit(age<120000?0:1)"
34
+
35
+ ENTRYPOINT ["node", "/opt/aiwg/tools/daemon/daemon-main.mjs"]
@@ -0,0 +1,291 @@
1
+ /**
2
+ * ContainerManager — Docker lifecycle for daemon containerization.
3
+ *
4
+ * Manages building, starting, stopping, and monitoring the daemon
5
+ * Docker container. The entire daemon runs inside the container with
6
+ * the project directory mounted as a volume.
7
+ *
8
+ * @implements Plan: Daemon Starter — Docker Containerization
9
+ */
10
+
11
+ import { execFileSync, spawn } from 'child_process';
12
+ import { importImpl } from '../_resolve-impl.mjs';
13
+ import { createHash } from 'crypto';
14
+ import fs from 'fs';
15
+ import path from 'path';
16
+ import { fileURLToPath } from 'url';
17
+ import { homedir } from 'os';
18
+
19
+ const { boundedExecFileSync } = await importImpl(import.meta.url, 'process/bounded-child-process.mjs');
20
+
21
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
22
+ const CONTAINER_ID_FILE = '.aiwg/daemon/container-id';
23
+
24
+ /**
25
+ * @typedef {Object} ContainerManagerOptions
26
+ * @property {string} [projectDir] - Project directory to mount
27
+ * @property {string} [imageName] - Docker image name
28
+ * @property {string} [imageTag] - Docker image tag
29
+ * @property {number} [webPort] - Web UI port
30
+ * @property {Object} [dockerConfig] - Docker config from daemon.yaml
31
+ */
32
+
33
+ export class ContainerManager {
34
+ /** @type {string} */
35
+ #projectDir;
36
+
37
+ /** @type {string} */
38
+ #imageName;
39
+
40
+ /** @type {string} */
41
+ #imageTag;
42
+
43
+ /** @type {string} */
44
+ #containerName;
45
+
46
+ /** @type {number} */
47
+ #webPort;
48
+
49
+ /** @type {Object} */
50
+ #dockerConfig;
51
+
52
+ /**
53
+ * @param {ContainerManagerOptions} [options]
54
+ */
55
+ constructor(options = {}) {
56
+ this.#projectDir = options.projectDir || process.cwd();
57
+ this.#imageName = options.imageName || options.dockerConfig?.image?.split(':')[0] || 'aiwg-daemon';
58
+ this.#imageTag = options.imageTag || options.dockerConfig?.image?.split(':')[1] || 'latest';
59
+ this.#webPort = options.webPort || 7474;
60
+ this.#dockerConfig = options.dockerConfig || {};
61
+
62
+ const hash = createHash('md5').update(this.#projectDir).digest('hex').slice(0, 8);
63
+ this.#containerName = `aiwg-daemon-${hash}`;
64
+ }
65
+
66
+ /**
67
+ * Check if Docker is available.
68
+ *
69
+ * @returns {boolean}
70
+ */
71
+ isDockerAvailable() {
72
+ try {
73
+ boundedExecFileSync('docker', ['info'], 'quick', { stdio: 'ignore' });
74
+ return true;
75
+ } catch {
76
+ return false;
77
+ }
78
+ }
79
+
80
+ /**
81
+ * Build the Docker image if not present or if Dockerfile changed.
82
+ */
83
+ ensureImage() {
84
+ const dockerfile = path.join(__dirname, 'Dockerfile.daemon');
85
+ if (!fs.existsSync(dockerfile)) {
86
+ throw new Error(`Dockerfile not found: ${dockerfile}`);
87
+ }
88
+
89
+ const fullImage = `${this.#imageName}:${this.#imageTag}`;
90
+
91
+ // Check if image exists
92
+ try {
93
+ boundedExecFileSync('docker', ['image', 'inspect', fullImage], 'quick', { stdio: 'ignore' });
94
+ console.log(`[docker] Image ${fullImage} exists`);
95
+ return;
96
+ } catch {
97
+ // Image doesn't exist, build it
98
+ }
99
+
100
+ console.log(`[docker] Building image ${fullImage}...`);
101
+ const buildContext = this.#dockerConfig.buildContext || this.#projectDir;
102
+
103
+ boundedExecFileSync(
104
+ 'docker', ['build', '-f', dockerfile, '-t', fullImage, buildContext],
105
+ 'long',
106
+ { stdio: 'inherit' }
107
+ );
108
+
109
+ console.log(`[docker] Image ${fullImage} built successfully`);
110
+ }
111
+
112
+ /**
113
+ * Start the daemon container.
114
+ *
115
+ * @returns {{ containerId: string, containerName: string }}
116
+ */
117
+ start() {
118
+ if (!this.isDockerAvailable()) {
119
+ throw new Error('Docker is not available. Install Docker or run without --docker.');
120
+ }
121
+
122
+ // Stop existing container if running
123
+ this.#stopExisting();
124
+
125
+ this.ensureImage();
126
+
127
+ const fullImage = `${this.#imageName}:${this.#imageTag}`;
128
+ const home = homedir();
129
+
130
+ const args = [
131
+ 'run', '-d',
132
+ '--name', this.#containerName,
133
+ // Mount project directory
134
+ '-v', `${this.#projectDir}:/workspace`,
135
+ // Mount credentials read-only
136
+ '-v', `${home}/.config:/root/.config:ro`,
137
+ // Web UI port
138
+ '-p', `${this.#webPort}:7474`,
139
+ // Restart policy
140
+ '--restart', this.#dockerConfig.restart_policy || 'unless-stopped',
141
+ ];
142
+
143
+ // Resource limits
144
+ if (this.#dockerConfig.resources?.memory) {
145
+ args.push('--memory', this.#dockerConfig.resources.memory);
146
+ }
147
+ if (this.#dockerConfig.resources?.cpus) {
148
+ args.push('--cpus', this.#dockerConfig.resources.cpus);
149
+ }
150
+
151
+ // Extra environment from .env file
152
+ if (this.#dockerConfig.env_file) {
153
+ const envFile = path.resolve(this.#projectDir, this.#dockerConfig.env_file);
154
+ if (fs.existsSync(envFile)) {
155
+ args.push('--env-file', envFile);
156
+ }
157
+ }
158
+
159
+ // Pass through API key env vars
160
+ for (const envVar of ['ANTHROPIC_API_KEY', 'OPENAI_API_KEY', 'AIWG_TELEGRAM_TOKEN', 'AIWG_DISCORD_TOKEN']) {
161
+ if (process.env[envVar]) {
162
+ args.push('-e', envVar);
163
+ }
164
+ }
165
+
166
+ // Extra volumes
167
+ if (Array.isArray(this.#dockerConfig.volumes)) {
168
+ for (const vol of this.#dockerConfig.volumes) {
169
+ if (vol.source && vol.target) {
170
+ const src = path.resolve(this.#projectDir, vol.source);
171
+ args.push('-v', `${src}:${vol.target}:${vol.mode || 'rw'}`);
172
+ }
173
+ }
174
+ }
175
+
176
+ args.push(fullImage);
177
+
178
+ // `long`, not `quick` (#3062 finding 6): `docker run` can implicitly
179
+ // pull the image if the local build cache was invalidated.
180
+ const result = boundedExecFileSync('docker', args, 'long', { encoding: 'utf8' }).trim();
181
+ const containerId = result.slice(0, 12);
182
+
183
+ // Store container ID
184
+ const idDir = path.dirname(CONTAINER_ID_FILE);
185
+ if (!fs.existsSync(idDir)) {
186
+ fs.mkdirSync(idDir, { recursive: true });
187
+ }
188
+ fs.writeFileSync(CONTAINER_ID_FILE, containerId);
189
+
190
+ console.log(`[docker] Container started: ${this.#containerName} (${containerId})`);
191
+ return { containerId, containerName: this.#containerName };
192
+ }
193
+
194
+ /**
195
+ * Stop and remove the container.
196
+ */
197
+ stop() {
198
+ try {
199
+ execFileSync('docker', ['stop', this.#containerName], { stdio: 'ignore', timeout: 15000, killSignal: 'SIGKILL' });
200
+ } catch {
201
+ // Container may not be running
202
+ }
203
+
204
+ try {
205
+ boundedExecFileSync('docker', ['rm', this.#containerName], 'quick', { stdio: 'ignore' });
206
+ } catch {
207
+ // Container may not exist
208
+ }
209
+
210
+ // Clean up container ID file
211
+ if (fs.existsSync(CONTAINER_ID_FILE)) {
212
+ fs.unlinkSync(CONTAINER_ID_FILE);
213
+ }
214
+
215
+ console.log(`[docker] Container stopped: ${this.#containerName}`);
216
+ }
217
+
218
+ /**
219
+ * Get container status.
220
+ *
221
+ * @returns {{ running: boolean, containerId: string|null, health: string|null }}
222
+ */
223
+ status() {
224
+ try {
225
+ const output = boundedExecFileSync(
226
+ 'docker', ['inspect', '--format', '{{.State.Running}} {{.State.Health.Status}}', this.#containerName],
227
+ 'quick',
228
+ { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }
229
+ ).trim();
230
+
231
+ const [running, health] = output.split(' ');
232
+ return {
233
+ running: running === 'true',
234
+ containerId: this.#readContainerId(),
235
+ health: health || null,
236
+ };
237
+ } catch {
238
+ return { running: false, containerId: null, health: null };
239
+ }
240
+ }
241
+
242
+ /**
243
+ * Stream container logs.
244
+ *
245
+ * @param {boolean} [follow=false]
246
+ * @param {number} [lines=50]
247
+ * @returns {import('child_process').ChildProcess}
248
+ */
249
+ logs(follow = false, lines = 50) {
250
+ const args = ['logs', '--tail', String(lines)];
251
+ if (follow) args.push('-f');
252
+ args.push(this.#containerName);
253
+
254
+ return spawn('docker', args, { stdio: 'inherit' });
255
+ }
256
+
257
+ /**
258
+ * Stop existing container if running.
259
+ */
260
+ #stopExisting() {
261
+ try {
262
+ const output = boundedExecFileSync(
263
+ 'docker', ['ps', '-q', '-f', `name=${this.#containerName}`],
264
+ 'quick',
265
+ { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }
266
+ ).trim();
267
+
268
+ if (output) {
269
+ console.log(`[docker] Stopping existing container: ${this.#containerName}`);
270
+ this.stop();
271
+ }
272
+ } catch {
273
+ // No existing container
274
+ }
275
+ }
276
+
277
+ /**
278
+ * Read stored container ID.
279
+ *
280
+ * @returns {string|null}
281
+ */
282
+ #readContainerId() {
283
+ try {
284
+ return fs.readFileSync(CONTAINER_ID_FILE, 'utf8').trim();
285
+ } catch {
286
+ return null;
287
+ }
288
+ }
289
+ }
290
+
291
+ export default ContainerManager;
@@ -0,0 +1,230 @@
1
+ /**
2
+ * Lazy-loading adapter registry for messaging platforms.
3
+ *
4
+ * Discovers and instantiates platform adapters based on environment
5
+ * configuration. Adapters are only loaded when their platform is enabled.
6
+ *
7
+ * @implements @.aiwg/architecture/adrs/ADR-messaging-bot-mode.md
8
+ */
9
+
10
+ /**
11
+ * @typedef {Object} AdapterEntry
12
+ * @property {string} name
13
+ * @property {string} modulePath
14
+ * @property {string} envCheck - Environment variable that enables this adapter
15
+ * @property {import('./adapters/base.mjs').BaseAdapter|null} instance
16
+ * @property {'pending'|'loading'|'ready'|'error'|'shutdown'} status
17
+ * @property {string|null} error
18
+ */
19
+
20
+ /** @type {Map<string, AdapterEntry>} */
21
+ const ADAPTER_REGISTRY = new Map();
22
+
23
+ // Register known adapters
24
+ const KNOWN_ADAPTERS = [
25
+ {
26
+ name: 'slack',
27
+ modulePath: './adapters/slack.mjs',
28
+ envCheck: 'AIWG_SLACK_WEBHOOK_URL',
29
+ },
30
+ {
31
+ name: 'discord',
32
+ modulePath: './adapters/discord.mjs',
33
+ envCheck: 'AIWG_DISCORD_TOKEN',
34
+ },
35
+ {
36
+ name: 'telegram',
37
+ modulePath: './adapters/telegram.mjs',
38
+ envCheck: 'AIWG_TELEGRAM_TOKEN',
39
+ },
40
+ ];
41
+
42
+ /**
43
+ * Initialize the adapter registry with known adapters.
44
+ * Does NOT load adapters — only registers them.
45
+ */
46
+ export function initializeRegistry() {
47
+ ADAPTER_REGISTRY.clear();
48
+ for (const adapter of KNOWN_ADAPTERS) {
49
+ ADAPTER_REGISTRY.set(adapter.name, {
50
+ ...adapter,
51
+ instance: null,
52
+ status: 'pending',
53
+ error: null,
54
+ });
55
+ }
56
+ }
57
+
58
+ /**
59
+ * Discover which adapters are enabled based on environment variables.
60
+ *
61
+ * @returns {string[]} Names of enabled adapters
62
+ */
63
+ export function discoverEnabledAdapters(configs = {}) {
64
+ const enabled = [];
65
+ for (const [name, entry] of ADAPTER_REGISTRY) {
66
+ const config = configs[name];
67
+ const configured = name === 'slack' ? config?.webhookUrl : config?.botToken || config?.token;
68
+ if (configured || process.env[entry.envCheck]) {
69
+ enabled.push(name);
70
+ }
71
+ }
72
+ return enabled;
73
+ }
74
+
75
+ /**
76
+ * Load and initialize a specific adapter.
77
+ *
78
+ * @param {string} name - Adapter name
79
+ * @param {Object} config - Platform-specific configuration
80
+ * @returns {Promise<import('./adapters/base.mjs').BaseAdapter>}
81
+ */
82
+ export async function loadAdapter(name, config = {}) {
83
+ const entry = ADAPTER_REGISTRY.get(name);
84
+ if (!entry) {
85
+ throw new Error(
86
+ `Unknown adapter: "${name}". Available: ${[...ADAPTER_REGISTRY.keys()].join(', ')}`
87
+ );
88
+ }
89
+
90
+ if (entry.instance && entry.status === 'ready') {
91
+ return entry.instance;
92
+ }
93
+
94
+ entry.status = 'loading';
95
+
96
+ try {
97
+ const mod = await import(entry.modulePath);
98
+ const AdapterClass = mod.default || mod[`${capitalize(name)}Adapter`];
99
+
100
+ if (!AdapterClass) {
101
+ throw new Error(`Adapter module "${entry.modulePath}" does not export a default or named adapter class`);
102
+ }
103
+
104
+ const instance = new AdapterClass(config);
105
+ await instance.initialize();
106
+
107
+ entry.instance = instance;
108
+ entry.status = 'ready';
109
+ entry.error = null;
110
+
111
+ return instance;
112
+ } catch (error) {
113
+ entry.status = 'error';
114
+ entry.error = error.message;
115
+ throw error;
116
+ }
117
+ }
118
+
119
+ /**
120
+ * Load all enabled adapters.
121
+ *
122
+ * @param {Object} configs - Map of adapter name to config
123
+ * @returns {Promise<Map<string, import('./adapters/base.mjs').BaseAdapter>>}
124
+ */
125
+ export async function loadEnabledAdapters(configs = {}) {
126
+ const enabled = discoverEnabledAdapters(configs);
127
+ const loaded = new Map();
128
+
129
+ for (const name of enabled) {
130
+ try {
131
+ const adapter = await loadAdapter(name, configs[name] || {});
132
+ loaded.set(name, adapter);
133
+ console.log(`[AdapterRegistry] Loaded adapter: ${name}`);
134
+ } catch (error) {
135
+ console.error(`[AdapterRegistry] Failed to load adapter "${name}": ${error.message}`);
136
+ }
137
+ }
138
+
139
+ if (loaded.size === 0 && enabled.length > 0) {
140
+ console.warn('[AdapterRegistry] All enabled adapters failed to load');
141
+ }
142
+
143
+ return loaded;
144
+ }
145
+
146
+ /**
147
+ * Get a loaded adapter instance.
148
+ *
149
+ * @param {string} name
150
+ * @returns {import('./adapters/base.mjs').BaseAdapter|null}
151
+ */
152
+ export function getAdapter(name) {
153
+ const entry = ADAPTER_REGISTRY.get(name);
154
+ return entry?.instance || null;
155
+ }
156
+
157
+ /**
158
+ * Get status of all registered adapters.
159
+ *
160
+ * @returns {Array<{name: string, status: string, error: string|null, enabled: boolean}>}
161
+ */
162
+ export function getRegistryStatus() {
163
+ const statuses = [];
164
+ for (const [name, entry] of ADAPTER_REGISTRY) {
165
+ statuses.push({
166
+ name,
167
+ status: entry.status,
168
+ error: entry.error,
169
+ enabled: entry.status === 'ready' || !!process.env[entry.envCheck],
170
+ });
171
+ }
172
+ return statuses;
173
+ }
174
+
175
+ /**
176
+ * Shutdown all loaded adapters.
177
+ *
178
+ * @returns {Promise<void>}
179
+ */
180
+ export async function shutdownAll() {
181
+ const shutdownPromises = [];
182
+
183
+ for (const [name, entry] of ADAPTER_REGISTRY) {
184
+ if (entry.instance && entry.status === 'ready') {
185
+ shutdownPromises.push(
186
+ entry.instance.shutdown()
187
+ .then(() => {
188
+ entry.status = 'shutdown';
189
+ entry.instance = null;
190
+ console.log(`[AdapterRegistry] Shutdown adapter: ${name}`);
191
+ })
192
+ .catch((error) => {
193
+ entry.status = 'error';
194
+ entry.error = error.message;
195
+ console.error(`[AdapterRegistry] Error shutting down "${name}": ${error.message}`);
196
+ })
197
+ );
198
+ }
199
+ }
200
+
201
+ await Promise.allSettled(shutdownPromises);
202
+ }
203
+
204
+ /**
205
+ * Register a custom adapter (for plugins/extensions).
206
+ *
207
+ * @param {string} name
208
+ * @param {string} modulePath
209
+ * @param {string} envCheck
210
+ */
211
+ export function registerAdapter(name, modulePath, envCheck) {
212
+ if (ADAPTER_REGISTRY.has(name)) {
213
+ throw new Error(`Adapter "${name}" is already registered`);
214
+ }
215
+ ADAPTER_REGISTRY.set(name, {
216
+ name,
217
+ modulePath,
218
+ envCheck,
219
+ instance: null,
220
+ status: 'pending',
221
+ error: null,
222
+ });
223
+ }
224
+
225
+ function capitalize(s) {
226
+ return s.charAt(0).toUpperCase() + s.slice(1);
227
+ }
228
+
229
+ // Auto-initialize on import
230
+ initializeRegistry();