@hivemagnus/magnus-server 0.0.0-stage → 1.0.2

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 (356) hide show
  1. package/.env.example +171 -0
  2. package/LICENSE +202 -0
  3. package/README.md +169 -2
  4. package/agent-version.json +1 -0
  5. package/dist/ai/HEARTBEAT.md +56 -0
  6. package/dist/ai/IDENTITY.md +54 -0
  7. package/dist/ai/MEMORY.md +40 -0
  8. package/dist/ai/TOOLS.md +538 -0
  9. package/dist/ai/USER.md +32 -0
  10. package/dist/cli/args.js +62 -0
  11. package/dist/cli/env-catalog.js +131 -0
  12. package/dist/cli/preflight.js +89 -0
  13. package/dist/cli.js +175 -0
  14. package/dist/config/cors.js +16 -0
  15. package/dist/config/env.js +392 -0
  16. package/dist/config/features.js +16 -0
  17. package/dist/config/index.js +3 -0
  18. package/dist/config/listener-security.js +38 -0
  19. package/dist/config/version.js +31 -0
  20. package/dist/db/client.js +44 -0
  21. package/dist/db/generated/prisma/browser.js +18 -0
  22. package/dist/db/generated/prisma/client.js +35 -0
  23. package/dist/db/generated/prisma/commonInputTypes.js +11 -0
  24. package/dist/db/generated/prisma/enums.js +42 -0
  25. package/dist/db/generated/prisma/internal/class.js +50 -0
  26. package/dist/db/generated/prisma/internal/prismaNamespace.js +1598 -0
  27. package/dist/db/generated/prisma/internal/prismaNamespaceBrowser.js +1569 -0
  28. package/dist/db/generated/prisma/models/A2ATask.js +2 -0
  29. package/dist/db/generated/prisma/models/AdmissionFence.js +2 -0
  30. package/dist/db/generated/prisma/models/Agent.js +2 -0
  31. package/dist/db/generated/prisma/models/AiConversation.js +2 -0
  32. package/dist/db/generated/prisma/models/AiDashboard.js +2 -0
  33. package/dist/db/generated/prisma/models/AiMemory.js +2 -0
  34. package/dist/db/generated/prisma/models/AiMessage.js +2 -0
  35. package/dist/db/generated/prisma/models/AiScheduledOp.js +2 -0
  36. package/dist/db/generated/prisma/models/AlertConditionState.js +2 -0
  37. package/dist/db/generated/prisma/models/AlertRule.js +2 -0
  38. package/dist/db/generated/prisma/models/AlertViolation.js +2 -0
  39. package/dist/db/generated/prisma/models/AnomalyEvent.js +2 -0
  40. package/dist/db/generated/prisma/models/ApplicationObservation.js +2 -0
  41. package/dist/db/generated/prisma/models/ArdentInstallation.js +2 -0
  42. package/dist/db/generated/prisma/models/ArdentProfile.js +2 -0
  43. package/dist/db/generated/prisma/models/ArdentScopeEnrollment.js +2 -0
  44. package/dist/db/generated/prisma/models/CommandResourceFence.js +2 -0
  45. package/dist/db/generated/prisma/models/CommandResourceLease.js +2 -0
  46. package/dist/db/generated/prisma/models/CommandResult.js +2 -0
  47. package/dist/db/generated/prisma/models/CronJob.js +2 -0
  48. package/dist/db/generated/prisma/models/CronJobExecution.js +2 -0
  49. package/dist/db/generated/prisma/models/DeployJob.js +2 -0
  50. package/dist/db/generated/prisma/models/DriftScan.js +2 -0
  51. package/dist/db/generated/prisma/models/EngineeringMetricSample.js +2 -0
  52. package/dist/db/generated/prisma/models/EngineeringRecoveryExercise.js +2 -0
  53. package/dist/db/generated/prisma/models/ExecutionRun.js +2 -0
  54. package/dist/db/generated/prisma/models/FilePatchTask.js +2 -0
  55. package/dist/db/generated/prisma/models/GpuSnapshot.js +2 -0
  56. package/dist/db/generated/prisma/models/HealthSnapshot.js +2 -0
  57. package/dist/db/generated/prisma/models/HermesCoreRollout.js +2 -0
  58. package/dist/db/generated/prisma/models/HermesCoreRolloutHost.js +2 -0
  59. package/dist/db/generated/prisma/models/HermesCredentialPool.js +2 -0
  60. package/dist/db/generated/prisma/models/HermesCredentialPoolAttachment.js +2 -0
  61. package/dist/db/generated/prisma/models/HermesCronJob.js +2 -0
  62. package/dist/db/generated/prisma/models/HermesHook.js +2 -0
  63. package/dist/db/generated/prisma/models/HermesInstallation.js +2 -0
  64. package/dist/db/generated/prisma/models/HermesMcpServer.js +2 -0
  65. package/dist/db/generated/prisma/models/HermesMcpServerAttachment.js +2 -0
  66. package/dist/db/generated/prisma/models/HermesMessagingBinding.js +2 -0
  67. package/dist/db/generated/prisma/models/HermesOperationJob.js +2 -0
  68. package/dist/db/generated/prisma/models/HermesPluginInstall.js +2 -0
  69. package/dist/db/generated/prisma/models/HermesProfile.js +2 -0
  70. package/dist/db/generated/prisma/models/HermesProviderConfig.js +2 -0
  71. package/dist/db/generated/prisma/models/HermesRegistryClient.js +2 -0
  72. package/dist/db/generated/prisma/models/HermesRegistryInventory.js +2 -0
  73. package/dist/db/generated/prisma/models/HermesRegistryReceipt.js +2 -0
  74. package/dist/db/generated/prisma/models/HermesRegistryRevision.js +2 -0
  75. package/dist/db/generated/prisma/models/HermesRegistryTarget.js +2 -0
  76. package/dist/db/generated/prisma/models/HermesRole.js +2 -0
  77. package/dist/db/generated/prisma/models/HermesRoleApplication.js +2 -0
  78. package/dist/db/generated/prisma/models/HermesSkillAssignment.js +2 -0
  79. package/dist/db/generated/prisma/models/HermesToolsetPolicy.js +2 -0
  80. package/dist/db/generated/prisma/models/IncidentLesson.js +2 -0
  81. package/dist/db/generated/prisma/models/LibraryCategory.js +2 -0
  82. package/dist/db/generated/prisma/models/LibraryFile.js +2 -0
  83. package/dist/db/generated/prisma/models/LogEntry.js +2 -0
  84. package/dist/db/generated/prisma/models/MagnusReleaseCanary.js +2 -0
  85. package/dist/db/generated/prisma/models/MaintenanceWindow.js +2 -0
  86. package/dist/db/generated/prisma/models/ManagedCronDefinition.js +2 -0
  87. package/dist/db/generated/prisma/models/ManagedCronOccurrence.js +2 -0
  88. package/dist/db/generated/prisma/models/Node.js +2 -0
  89. package/dist/db/generated/prisma/models/Notification.js +2 -0
  90. package/dist/db/generated/prisma/models/NotificationPreference.js +2 -0
  91. package/dist/db/generated/prisma/models/RemediationExecution.js +2 -0
  92. package/dist/db/generated/prisma/models/RemediationRule.js +2 -0
  93. package/dist/db/generated/prisma/models/RemoteCommand.js +2 -0
  94. package/dist/db/generated/prisma/models/ResourceDrainParticipant.js +2 -0
  95. package/dist/db/generated/prisma/models/ResourceEnrollment.js +2 -0
  96. package/dist/db/generated/prisma/models/ResourceParticipantWork.js +2 -0
  97. package/dist/db/generated/prisma/models/Role.js +2 -0
  98. package/dist/db/generated/prisma/models/RoleApplication.js +2 -0
  99. package/dist/db/generated/prisma/models/RolloutTarget.js +2 -0
  100. package/dist/db/generated/prisma/models/SecurityExportOutbox.js +2 -0
  101. package/dist/db/generated/prisma/models/SecurityFusionAction.js +2 -0
  102. package/dist/db/generated/prisma/models/SecurityFusionActionApproval.js +2 -0
  103. package/dist/db/generated/prisma/models/SecurityFusionCase.js +2 -0
  104. package/dist/db/generated/prisma/models/SecurityFusionCaseActivity.js +2 -0
  105. package/dist/db/generated/prisma/models/SecurityFusionCaseEntity.js +2 -0
  106. package/dist/db/generated/prisma/models/SecurityFusionCaseEvent.js +2 -0
  107. package/dist/db/generated/prisma/models/SecurityFusionCaseRelationship.js +2 -0
  108. package/dist/db/generated/prisma/models/SecurityFusionCollector.js +2 -0
  109. package/dist/db/generated/prisma/models/SecurityFusionCommandOutbox.js +2 -0
  110. package/dist/db/generated/prisma/models/SecurityFusionDeletionReceipt.js +2 -0
  111. package/dist/db/generated/prisma/models/SecurityFusionDelivery.js +2 -0
  112. package/dist/db/generated/prisma/models/SecurityFusionEntity.js +2 -0
  113. package/dist/db/generated/prisma/models/SecurityFusionEntityAlias.js +2 -0
  114. package/dist/db/generated/prisma/models/SecurityFusionEvent.js +2 -0
  115. package/dist/db/generated/prisma/models/SecurityFusionEventEntity.js +2 -0
  116. package/dist/db/generated/prisma/models/SecurityFusionEvidence.js +2 -0
  117. package/dist/db/generated/prisma/models/SecurityFusionInvestigation.js +2 -0
  118. package/dist/db/generated/prisma/models/SecurityFusionNonce.js +2 -0
  119. package/dist/db/generated/prisma/models/SecurityFusionReceiptChainHead.js +2 -0
  120. package/dist/db/generated/prisma/models/SecurityFusionRuleVersion.js +2 -0
  121. package/dist/db/generated/prisma/models/SecurityFusionSourceState.js +2 -0
  122. package/dist/db/generated/prisma/models/SecurityServiceState.js +2 -0
  123. package/dist/db/generated/prisma/models/SharedResourceFence.js +2 -0
  124. package/dist/db/generated/prisma/models/SharedResourceLease.js +2 -0
  125. package/dist/db/generated/prisma/models/SharedResourceLeaseResource.js +2 -0
  126. package/dist/db/generated/prisma/models/SkillInstallation.js +2 -0
  127. package/dist/db/generated/prisma/models/SkillRegistryEntry.js +2 -0
  128. package/dist/db/generated/prisma/models/SkillTag.js +2 -0
  129. package/dist/db/generated/prisma/models/SkillVersion.js +2 -0
  130. package/dist/db/generated/prisma/models/TeamApprovalDecision.js +2 -0
  131. package/dist/db/generated/prisma/models/User.js +2 -0
  132. package/dist/db/generated/prisma/models/WebhookDelivery.js +2 -0
  133. package/dist/db/generated/prisma/models/WebhookEndpoint.js +2 -0
  134. package/dist/db/generated/prisma/models.js +2 -0
  135. package/dist/db/index.js +3 -0
  136. package/dist/db/read-retry.js +35 -0
  137. package/dist/db/seed.js +348 -0
  138. package/dist/index.js +162 -0
  139. package/dist/middleware/auth.js +361 -0
  140. package/dist/middleware/body-limit.js +14 -0
  141. package/dist/middleware/correlation-id.js +13 -0
  142. package/dist/middleware/error-handler.js +28 -0
  143. package/dist/middleware/iam-token.js +21 -0
  144. package/dist/middleware/rate-limit.js +78 -0
  145. package/dist/middleware/request-logger.js +85 -0
  146. package/dist/middleware/security-headers.js +23 -0
  147. package/dist/middleware/tracing.js +120 -0
  148. package/dist/middleware/user-status.js +33 -0
  149. package/dist/openapi/spec.js +2656 -0
  150. package/dist/queue/redis.js +20 -0
  151. package/dist/queue/requeue.js +27 -0
  152. package/dist/queue/workers.js +342 -0
  153. package/dist/routes/ai-schedule.js +73 -0
  154. package/dist/routes/alerts.js +79 -0
  155. package/dist/routes/anomalies.js +101 -0
  156. package/dist/routes/ardent.js +82 -0
  157. package/dist/routes/assistant.js +417 -0
  158. package/dist/routes/audit.js +138 -0
  159. package/dist/routes/codex.js +65 -0
  160. package/dist/routes/commands.js +226 -0
  161. package/dist/routes/credentials.js +58 -0
  162. package/dist/routes/cron.js +292 -0
  163. package/dist/routes/dependencies.js +49 -0
  164. package/dist/routes/deploy.js +18 -0
  165. package/dist/routes/discovery.js +168 -0
  166. package/dist/routes/docs.js +24 -0
  167. package/dist/routes/drift.js +126 -0
  168. package/dist/routes/events-stream.js +87 -0
  169. package/dist/routes/files.js +214 -0
  170. package/dist/routes/fleet-checks.js +21 -0
  171. package/dist/routes/health.js +133 -0
  172. package/dist/routes/heartbeat.js +545 -0
  173. package/dist/routes/hermes-registry.js +278 -0
  174. package/dist/routes/hermes.js +61 -0
  175. package/dist/routes/library.js +402 -0
  176. package/dist/routes/logs.js +172 -0
  177. package/dist/routes/managed-cron.js +23 -0
  178. package/dist/routes/mcp.js +39 -0
  179. package/dist/routes/metrics.js +187 -0
  180. package/dist/routes/nodes.js +951 -0
  181. package/dist/routes/notifications.js +130 -0
  182. package/dist/routes/ops.js +258 -0
  183. package/dist/routes/orchestra.js +430 -0
  184. package/dist/routes/predictions.js +23 -0
  185. package/dist/routes/profiling.js +68 -0
  186. package/dist/routes/quick-command.js +72 -0
  187. package/dist/routes/remediation.js +111 -0
  188. package/dist/routes/resource-leases.js +297 -0
  189. package/dist/routes/roles.js +370 -0
  190. package/dist/routes/rollout.js +124 -0
  191. package/dist/routes/scan.js +116 -0
  192. package/dist/routes/security-backup.js +58 -0
  193. package/dist/routes/security-fusion.js +605 -0
  194. package/dist/routes/security-integration.js +71 -0
  195. package/dist/routes/self-update.js +129 -0
  196. package/dist/routes/shared-resource-leases.js +78 -0
  197. package/dist/routes/skills.js +485 -0
  198. package/dist/routes/stats.js +96 -0
  199. package/dist/routes/team-approvals.js +23 -0
  200. package/dist/routes/terminal-ticket.js +15 -0
  201. package/dist/routes/terminal.js +17 -0
  202. package/dist/routes/topology.js +37 -0
  203. package/dist/routes/users.js +219 -0
  204. package/dist/routes/webhooks.js +137 -0
  205. package/dist/schemas/command-reconciliation.js +14 -0
  206. package/dist/schemas/commands.js +51 -0
  207. package/dist/schemas/cron.js +33 -0
  208. package/dist/schemas/deploy.js +20 -0
  209. package/dist/schemas/files.js +14 -0
  210. package/dist/schemas/hermes.js +69 -0
  211. package/dist/schemas/index.js +11 -0
  212. package/dist/schemas/library.js +48 -0
  213. package/dist/schemas/logs.js +35 -0
  214. package/dist/schemas/managed-cron.js +127 -0
  215. package/dist/schemas/node-responses.js +87 -0
  216. package/dist/schemas/node-session-receipt.js +84 -0
  217. package/dist/schemas/nodes.js +36 -0
  218. package/dist/schemas/orchestra.js +118 -0
  219. package/dist/schemas/resource-participant-reconciliation.js +99 -0
  220. package/dist/schemas/roles.js +54 -0
  221. package/dist/schemas/shared-resource-lease.js +132 -0
  222. package/dist/schemas/skills.js +44 -0
  223. package/dist/schemas/users.js +28 -0
  224. package/dist/scripts/run-disposable-recovery-exercise.js +39 -0
  225. package/dist/sdk/index.js +2 -0
  226. package/dist/sdk/node-api-client.js +474 -0
  227. package/dist/security/approval-assertion.js +66 -0
  228. package/dist/security/command-completion-registry.js +35 -0
  229. package/dist/security/command-request.js +12 -0
  230. package/dist/security/command-result-signature.js +34 -0
  231. package/dist/security/managed-http.js +45 -0
  232. package/dist/security/native-completion-registry.js +44 -0
  233. package/dist/server.js +178 -0
  234. package/dist/services/admission-fence.js +71 -0
  235. package/dist/services/ai-assistant-service.js +2523 -0
  236. package/dist/services/ai-correlation-service.js +225 -0
  237. package/dist/services/ai-export-service.js +141 -0
  238. package/dist/services/ai-insights-service.js +219 -0
  239. package/dist/services/ai-schedule-service.js +145 -0
  240. package/dist/services/ai-scratchpad-service.js +222 -0
  241. package/dist/services/ai-tools.js +1343 -0
  242. package/dist/services/alert-service.js +313 -0
  243. package/dist/services/anomaly-detector.js +419 -0
  244. package/dist/services/api-local-work.js +79 -0
  245. package/dist/services/application-probes.js +309 -0
  246. package/dist/services/ardent-scope-enrollment.js +123 -0
  247. package/dist/services/ardent-service.js +86 -0
  248. package/dist/services/audit-service.js +308 -0
  249. package/dist/services/codex-service.js +209 -0
  250. package/dist/services/command-lifecycle.js +60 -0
  251. package/dist/services/command-resource-leases.js +305 -0
  252. package/dist/services/control-host-node.js +242 -0
  253. package/dist/services/credential-rotation-service.js +294 -0
  254. package/dist/services/dependency-service.js +145 -0
  255. package/dist/services/disposable-recovery-runner.js +595 -0
  256. package/dist/services/docker-group-health.js +121 -0
  257. package/dist/services/engineering-assurance.js +492 -0
  258. package/dist/services/engineering-evidence-ledger.js +94 -0
  259. package/dist/services/engineering-metric-evidence.js +26 -0
  260. package/dist/services/event-bus.js +227 -0
  261. package/dist/services/fleet-check-log.js +102 -0
  262. package/dist/services/forecast-service.js +154 -0
  263. package/dist/services/health-retention.js +175 -0
  264. package/dist/services/heartbeat-stream.js +63 -0
  265. package/dist/services/hermes-catalog-import.js +62 -0
  266. package/dist/services/hermes-cli-parser.js +671 -0
  267. package/dist/services/hermes-core-rollout.js +90 -0
  268. package/dist/services/hermes-dashboard-endpoint.js +13 -0
  269. package/dist/services/hermes-plugin-source.js +149 -0
  270. package/dist/services/hermes-registry-service.js +258 -0
  271. package/dist/services/hermes-service.js +566 -0
  272. package/dist/services/hivemem-client.js +85 -0
  273. package/dist/services/host-local-writer.js +82 -0
  274. package/dist/services/incident-evidence.js +110 -0
  275. package/dist/services/incident-lessons.js +186 -0
  276. package/dist/services/llm-providers/anthropic.js +143 -0
  277. package/dist/services/llm-providers/index.js +7 -0
  278. package/dist/services/llm-providers/llama-cpp.js +237 -0
  279. package/dist/services/llm-providers/ollama.js +292 -0
  280. package/dist/services/llm-providers/openai-compatible.js +200 -0
  281. package/dist/services/llm-providers/provider-error.js +36 -0
  282. package/dist/services/llm-providers/registry.js +45 -0
  283. package/dist/services/llm-providers/types.js +2 -0
  284. package/dist/services/log-emitter.js +19 -0
  285. package/dist/services/log-retention.js +66 -0
  286. package/dist/services/maintenance-service.js +29 -0
  287. package/dist/services/managed-cron.js +493 -0
  288. package/dist/services/managed-ssh-admission.js +68 -0
  289. package/dist/services/monitor-pulse.js +10 -0
  290. package/dist/services/node-issue-monitor.js +71 -0
  291. package/dist/services/node-service.js +35 -0
  292. package/dist/services/notification-retention.js +51 -0
  293. package/dist/services/notification-service.js +94 -0
  294. package/dist/services/operational-observations.js +112 -0
  295. package/dist/services/operations-config.js +67 -0
  296. package/dist/services/ops-service.js +491 -0
  297. package/dist/services/orchestra-extras-service.js +370 -0
  298. package/dist/services/orchestra-resources-service.js +530 -0
  299. package/dist/services/os-scheduler-writer.js +73 -0
  300. package/dist/services/password-service.js +22 -0
  301. package/dist/services/prediction-service.js +284 -0
  302. package/dist/services/recovery-exercises.js +682 -0
  303. package/dist/services/remediation-service.js +325 -0
  304. package/dist/services/resource-enrollment.js +433 -0
  305. package/dist/services/resource-node-lock.js +18 -0
  306. package/dist/services/resource-participant-work.js +302 -0
  307. package/dist/services/role-service.js +388 -0
  308. package/dist/services/rollout-service.js +440 -0
  309. package/dist/services/security-export.js +185 -0
  310. package/dist/services/security-fusion-actions.js +22 -0
  311. package/dist/services/security-fusion-approvals.js +83 -0
  312. package/dist/services/security-fusion-evidence-integrity.js +144 -0
  313. package/dist/services/security-fusion-ingest.js +101 -0
  314. package/dist/services/security-fusion-outbox.js +185 -0
  315. package/dist/services/security-fusion-receipt-chain.js +134 -0
  316. package/dist/services/security-fusion-service.js +751 -0
  317. package/dist/services/security-fusion-verification.js +50 -0
  318. package/dist/services/self-update-service.js +200 -0
  319. package/dist/services/shared-resource-leases.js +413 -0
  320. package/dist/services/skill-publication-bundle.js +90 -0
  321. package/dist/services/skill-publication-settlement.js +36 -0
  322. package/dist/services/skill-publication-state.js +40 -0
  323. package/dist/services/skill-registry-service.js +327 -0
  324. package/dist/services/skill-service.js +148 -0
  325. package/dist/services/ssh-exec-service.js +139 -0
  326. package/dist/services/ssh-host-verification.js +27 -0
  327. package/dist/services/tailscale-node-key-service.js +75 -0
  328. package/dist/services/team-approvals.js +118 -0
  329. package/dist/services/topology-service.js +138 -0
  330. package/dist/services/transfer-authority-snapshot.js +151 -0
  331. package/dist/services/webhook-credential-migration.js +97 -0
  332. package/dist/services/webhook-security.js +242 -0
  333. package/dist/services/webhook-service.js +494 -0
  334. package/dist/types/auth.js +3 -0
  335. package/dist/types/index.js +3 -0
  336. package/dist/types/library.js +3 -0
  337. package/dist/types/notifications.js +3 -0
  338. package/dist/types/roles.js +3 -0
  339. package/dist/types/shared-contracts.js +3 -0
  340. package/dist/utils/env.js +141 -0
  341. package/dist/utils/heartbeat-peer.js +19 -0
  342. package/dist/utils/idempotency.js +45 -0
  343. package/dist/utils/ip.js +25 -0
  344. package/dist/utils/json-fields.js +94 -0
  345. package/dist/utils/local-tls.js +39 -0
  346. package/dist/utils/magnus-home.js +15 -0
  347. package/dist/utils/node-url.js +59 -0
  348. package/dist/utils/redact.js +26 -0
  349. package/dist/utils/safe-equal.js +13 -0
  350. package/dist/utils/sentinel-nodes.js +16 -0
  351. package/dist/utils/validate.js +41 -0
  352. package/package.json +119 -4
  353. package/prisma/migrations/20261031000000_baseline/migration.sql +2935 -0
  354. package/prisma/migrations/migration_lock.toml +3 -0
  355. package/prisma/schema.prisma +2185 -0
  356. package/prisma.config.ts +14 -0
@@ -0,0 +1,49 @@
1
+ /**
2
+ * dependencies.ts — Node dependency mapping routes.
3
+ *
4
+ * GET /dependencies — cached dependency graph
5
+ * POST /dependencies/scan — force fresh dependency scan
6
+ */
7
+ import { Hono } from 'hono';
8
+ import { authMiddleware, getUser, requireRole } from '../middleware/auth.js';
9
+ import { buildDependencyGraph } from '../services/dependency-service.js';
10
+ export const dependenciesRouter = new Hono();
11
+ dependenciesRouter.use('*', authMiddleware);
12
+ // ── In-memory cache (10 min TTL) ──
13
+ let cachedGraph = null;
14
+ let cacheExpiry = 0;
15
+ const CACHE_TTL_MS = 10 * 60 * 1000;
16
+ /**
17
+ * GET /dependencies
18
+ * Return the current dependency graph (cached for 10 min).
19
+ */
20
+ dependenciesRouter.get('/', async (c) => {
21
+ if (!cachedGraph || Date.now() > cacheExpiry) {
22
+ cachedGraph = await buildDependencyGraph();
23
+ cacheExpiry = Date.now() + CACHE_TTL_MS;
24
+ }
25
+ // The plugin read credential may observe topology, but never receives node
26
+ // IPs, process names, PIDs, or port-level connection details.
27
+ if (getUser(c).userId.startsWith('service:magnus-plugin-read:')) {
28
+ return c.json({ success: true, data: {
29
+ discoveredAt: cachedGraph.discoveredAt,
30
+ status: cachedGraph.status,
31
+ nodes: cachedGraph.nodes.map(({ id, name, collection }) => ({ id, name, collection: {
32
+ status: collection.status, observedAt: collection.observedAt,
33
+ reason: collection.status === 'unknown' ? 'collection_unavailable' : null,
34
+ } })),
35
+ edges: cachedGraph.edges.map(({ from, to, service, connectionCount }) => ({ from, to, service, connectionCount })),
36
+ } });
37
+ }
38
+ return c.json({ success: true, data: cachedGraph });
39
+ });
40
+ /**
41
+ * POST /dependencies/scan
42
+ * Force a fresh dependency scan.
43
+ */
44
+ dependenciesRouter.post('/scan', requireRole('ADMIN', 'OPERATOR'), async (c) => {
45
+ cachedGraph = await buildDependencyGraph();
46
+ cacheExpiry = Date.now() + CACHE_TTL_MS;
47
+ return c.json({ success: true, data: cachedGraph });
48
+ });
49
+ //# sourceMappingURL=dependencies.js.map
@@ -0,0 +1,18 @@
1
+ import { Hono } from 'hono';
2
+ import { authMiddleware } from '../middleware/auth.js';
3
+ /**
4
+ * Browser-driven deployment is retired. The previous implementation accepted
5
+ * reusable SSH passwords, issued invalid shared-host certificates, omitted
6
+ * Result/log credentials, and treated systemd "active" as rollout success.
7
+ * Reviewed key-only scripts are the sole production deployment interface.
8
+ */
9
+ export const deployRouter = new Hono();
10
+ deployRouter.use('*', authMiddleware);
11
+ deployRouter.all('*', (c) => c.json({
12
+ success: false,
13
+ error: {
14
+ code: 'DEPLOYMENT_PATH_RETIRED',
15
+ message: 'Legacy API-driven deployment is retired; use the reviewed key-only deployment scripts.',
16
+ },
17
+ }, 410));
18
+ //# sourceMappingURL=deploy.js.map
@@ -0,0 +1,168 @@
1
+ import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
2
+ import { createSocket } from 'node:dgram';
3
+ import { Hono } from 'hono';
4
+ import { authMiddleware, requireRole } from '../middleware/auth.js';
5
+ import { HttpError } from '../middleware/error-handler.js';
6
+ import { getDb } from '../db/index.js';
7
+ import { AGENT_DISCOVERY_SECRET, ENABLE_AGENT_DISCOVERY } from '../utils/env.js';
8
+ export const discoveryRouter = new Hono();
9
+ discoveryRouter.use('*', authMiddleware);
10
+ const DISCOVERY_PORT = 4199;
11
+ const DISCOVERY_TARGET = '255.255.255.255';
12
+ const DISCOVERY_TIMEOUT_MS = 5_000;
13
+ const DISCOVERY_SKEW_MS = 30_000;
14
+ const NONCE_PATTERN = /^[A-Za-z0-9_-]{32,128}$/;
15
+ const SIGNATURE_PATTERN = /^[A-Za-z0-9_-]{43}$/;
16
+ function safeEqual(left, right) {
17
+ const leftBuffer = Buffer.from(left);
18
+ const rightBuffer = Buffer.from(right);
19
+ if (leftBuffer.length !== rightBuffer.length) {
20
+ timingSafeEqual(leftBuffer, leftBuffer);
21
+ return false;
22
+ }
23
+ return timingSafeEqual(leftBuffer, rightBuffer);
24
+ }
25
+ function sign(secret, value) {
26
+ return createHmac('sha256', secret).update(JSON.stringify(value)).digest('base64url');
27
+ }
28
+ function unsignedProbe(nonce, timestamp) {
29
+ return { type: 'MAGNUS_DISCOVER', nonce, timestamp };
30
+ }
31
+ function unsignedResponse(response) {
32
+ return {
33
+ type: 'MAGNUS_AGENT_RESPONSE',
34
+ nonce: response.nonce,
35
+ timestamp: response.timestamp,
36
+ hostname: response.hostname,
37
+ fqdn: response.fqdn,
38
+ port: response.port,
39
+ version: response.version,
40
+ };
41
+ }
42
+ /** Create the nonce-bound signed UDP probe understood by current agents. */
43
+ export function createDiscoveryProbe(secret, timestamp = Date.now(), nonce = randomBytes(32).toString('base64url')) {
44
+ if (secret.length < 32)
45
+ throw new Error('AGENT_DISCOVERY_SECRET must contain at least 32 characters');
46
+ const unsigned = unsignedProbe(nonce, timestamp);
47
+ return { ...unsigned, signature: sign(secret, unsigned) };
48
+ }
49
+ /** Accept only a fresh, signed response bound to this scan's nonce. */
50
+ export function verifyDiscoveryResponse(value, secret, expectedNonce, now = Date.now()) {
51
+ if (!value || typeof value !== 'object' || secret.length < 32)
52
+ return false;
53
+ const response = value;
54
+ if (response.type !== 'MAGNUS_AGENT_RESPONSE'
55
+ || response.nonce !== expectedNonce
56
+ || !NONCE_PATTERN.test(response.nonce)
57
+ || typeof response.timestamp !== 'number'
58
+ || !Number.isSafeInteger(response.timestamp)
59
+ || Math.abs(now - response.timestamp) > DISCOVERY_SKEW_MS
60
+ || typeof response.hostname !== 'string'
61
+ || !response.hostname
62
+ || response.hostname.length > 253
63
+ || /[\r\n]/.test(response.hostname)
64
+ || typeof response.fqdn !== 'string'
65
+ || !response.fqdn
66
+ || response.fqdn.length > 253
67
+ || /[\r\n]/.test(response.fqdn)
68
+ || typeof response.port !== 'number'
69
+ || !Number.isInteger(response.port)
70
+ || response.port < 1
71
+ || response.port > 65_535
72
+ || typeof response.version !== 'string'
73
+ || !response.version
74
+ || response.version.length > 253
75
+ || /[\r\n]/.test(response.version)
76
+ || typeof response.signature !== 'string'
77
+ || !SIGNATURE_PATTERN.test(response.signature))
78
+ return false;
79
+ const unsigned = unsignedResponse(response);
80
+ return safeEqual(response.signature, sign(secret, unsigned));
81
+ }
82
+ /** POST /discovery/scan — authenticated API plus authenticated UDP exchange. */
83
+ discoveryRouter.post('/scan', requireRole('ADMIN', 'OPERATOR'), async (c) => {
84
+ if (!ENABLE_AGENT_DISCOVERY || AGENT_DISCOVERY_SECRET.length < 32) {
85
+ throw new HttpError(503, 'DISCOVERY_DISABLED', 'Authenticated agent discovery is not configured');
86
+ }
87
+ const body = await c.req.json().catch(() => ({}));
88
+ const requestedTimeout = Number(body.timeoutMs ?? DISCOVERY_TIMEOUT_MS);
89
+ const timeout = Number.isFinite(requestedTimeout)
90
+ ? Math.min(Math.max(Math.trunc(requestedTimeout), 250), 10_000)
91
+ : DISCOVERY_TIMEOUT_MS;
92
+ const discovered = await scanNetwork(timeout, AGENT_DISCOVERY_SECRET);
93
+ const db = getDb();
94
+ const existingNodes = await db.node.findMany({ select: { ipAddress: true, hostname: true } });
95
+ const existingIps = new Set(existingNodes.map((node) => node.ipAddress));
96
+ const existingHostnames = new Set(existingNodes.map((node) => node.hostname));
97
+ const results = discovered.map((agent) => ({
98
+ ...agent,
99
+ registered: existingIps.has(agent.ip)
100
+ || existingHostnames.has(agent.hostname)
101
+ || existingHostnames.has(agent.fqdn),
102
+ }));
103
+ return c.json({
104
+ success: true,
105
+ data: results,
106
+ meta: { total: results.length, newAgents: results.filter((result) => !result.registered).length },
107
+ });
108
+ });
109
+ function scanNetwork(timeoutMs, secret) {
110
+ return new Promise((resolve) => {
111
+ const agents = [];
112
+ const seen = new Set();
113
+ const socket = createSocket({ type: 'udp4', reuseAddr: true });
114
+ const probe = createDiscoveryProbe(secret);
115
+ let timer;
116
+ socket.on('message', (message, remote) => {
117
+ let parsed;
118
+ try {
119
+ parsed = JSON.parse(message.toString('utf8'));
120
+ }
121
+ catch {
122
+ return;
123
+ }
124
+ if (!verifyDiscoveryResponse(parsed, secret, probe.nonce))
125
+ return;
126
+ const key = `${remote.address}:${parsed.port}`;
127
+ if (seen.has(key))
128
+ return;
129
+ seen.add(key);
130
+ agents.push({
131
+ hostname: parsed.hostname,
132
+ fqdn: parsed.fqdn,
133
+ ip: remote.address,
134
+ port: parsed.port,
135
+ version: parsed.version,
136
+ });
137
+ });
138
+ let settled = false;
139
+ const finish = () => {
140
+ if (settled)
141
+ return;
142
+ settled = true;
143
+ if (timer)
144
+ clearTimeout(timer);
145
+ try {
146
+ socket.close();
147
+ }
148
+ catch { /* already closed */ }
149
+ resolve(agents);
150
+ };
151
+ socket.on('error', (error) => {
152
+ console.warn('[Discovery] Socket error:', error.message);
153
+ finish();
154
+ });
155
+ socket.bind(0, () => {
156
+ socket.setBroadcast(true);
157
+ const message = Buffer.from(JSON.stringify(probe));
158
+ socket.send(message, 0, message.length, DISCOVERY_PORT, DISCOVERY_TARGET, (error) => {
159
+ if (error) {
160
+ console.warn('[Discovery] Broadcast send error:', error.message);
161
+ finish();
162
+ }
163
+ });
164
+ });
165
+ timer = setTimeout(finish, timeoutMs);
166
+ });
167
+ }
168
+ //# sourceMappingURL=discovery.js.map
@@ -0,0 +1,24 @@
1
+ /**
2
+ * API documentation routes — serves OpenAPI spec + Swagger UI.
3
+ *
4
+ * - `GET /api/docs` — interactive Swagger UI
5
+ * - `GET /api/docs/openapi.json` — raw OpenAPI 3.1 JSON spec
6
+ */
7
+ import { Hono } from 'hono';
8
+ import { swaggerUI } from '@hono/swagger-ui';
9
+ import { buildOpenApiSpec } from '../openapi/spec.js';
10
+ export const docsRouter = new Hono();
11
+ // Cache the spec object — rebuilt only on process restart
12
+ let cachedSpec = null;
13
+ function getSpec() {
14
+ if (!cachedSpec)
15
+ cachedSpec = buildOpenApiSpec();
16
+ return cachedSpec;
17
+ }
18
+ // ── Raw OpenAPI JSON ──
19
+ docsRouter.get('/openapi.json', (c) => {
20
+ return c.json(getSpec());
21
+ });
22
+ // ── Swagger UI ──
23
+ docsRouter.get('/', swaggerUI({ url: '/api/docs/openapi.json' }));
24
+ //# sourceMappingURL=docs.js.map
@@ -0,0 +1,126 @@
1
+ import { Hono } from 'hono';
2
+ import { nanoid } from 'nanoid';
3
+ import ky from 'ky';
4
+ import { authMiddleware, requireRole, getUser } from '../middleware/auth.js';
5
+ import { getDb } from '../db/index.js';
6
+ import { HttpError } from '../middleware/error-handler.js';
7
+ import { getNodeManagerSecret } from '../utils/env.js';
8
+ import { getNodeBaseUrl } from '../utils/node-url.js';
9
+ import { logAuditEvent } from '../services/audit-service.js';
10
+ export const driftRouter = new Hono();
11
+ driftRouter.use('*', authMiddleware);
12
+ /**
13
+ * POST /drift/scan
14
+ * Trigger a drift scan on a specific node.
15
+ * Body: { nodeId: string, checks: [...] }
16
+ */
17
+ driftRouter.post('/scan', requireRole('ADMIN', 'OPERATOR'), async (c) => {
18
+ const user = getUser(c);
19
+ const body = await c.req.json();
20
+ if (!body.nodeId)
21
+ throw new HttpError(400, 'VALIDATION_ERROR', 'nodeId is required');
22
+ if (!body.checks?.length)
23
+ throw new HttpError(400, 'VALIDATION_ERROR', 'checks array is required');
24
+ const db = getDb();
25
+ const node = await db.node.findUnique({ where: { id: body.nodeId } });
26
+ if (!node)
27
+ throw new HttpError(404, 'NOT_FOUND', 'Node not found');
28
+ // Use the node's recorded endpoint, like every other agent call.
29
+ const agentUrl = `${getNodeBaseUrl(node.ipAddress, node.port)}/api/v1/drift/scan`;
30
+ let agentResponse;
31
+ try {
32
+ const res = await ky.post(agentUrl, {
33
+ json: { checks: body.checks },
34
+ headers: { 'x-node-token': getNodeManagerSecret() },
35
+ timeout: 30_000,
36
+ }).json();
37
+ agentResponse = res.data;
38
+ }
39
+ catch (err) {
40
+ const msg = err instanceof Error ? err.message : String(err);
41
+ // Store error scan
42
+ const scan = await db.driftScan.create({
43
+ data: {
44
+ id: nanoid(),
45
+ nodeId: body.nodeId,
46
+ status: 'error',
47
+ findings: JSON.stringify([{ error: msg }]),
48
+ },
49
+ });
50
+ return c.json({ success: true, data: { scan, error: msg } });
51
+ }
52
+ // Store scan results
53
+ const scan = await db.driftScan.create({
54
+ data: {
55
+ id: nanoid(),
56
+ nodeId: body.nodeId,
57
+ status: agentResponse.status,
58
+ findings: JSON.stringify(agentResponse.findings),
59
+ },
60
+ });
61
+ await logAuditEvent({
62
+ action: 'drift.scan',
63
+ actorId: user.userId,
64
+ targetType: 'node',
65
+ targetId: body.nodeId,
66
+ details: { status: agentResponse.status, driftCount: agentResponse.driftCount },
67
+ });
68
+ return c.json({
69
+ success: true,
70
+ data: {
71
+ id: scan.id,
72
+ nodeId: scan.nodeId,
73
+ status: scan.status,
74
+ findings: agentResponse.findings,
75
+ scannedAt: scan.scannedAt,
76
+ },
77
+ });
78
+ });
79
+ /**
80
+ * GET /drift/:nodeId
81
+ * Get drift scan history for a node.
82
+ */
83
+ driftRouter.get('/:nodeId', async (c) => {
84
+ const db = getDb();
85
+ const nodeId = c.req.param('nodeId');
86
+ const scans = await db.driftScan.findMany({
87
+ where: { nodeId },
88
+ orderBy: { scannedAt: 'desc' },
89
+ take: 20,
90
+ });
91
+ return c.json({
92
+ success: true,
93
+ data: scans.map((s) => ({
94
+ id: s.id,
95
+ nodeId: s.nodeId,
96
+ status: s.status,
97
+ findings: JSON.parse(s.findings),
98
+ scannedAt: s.scannedAt,
99
+ })),
100
+ });
101
+ });
102
+ /**
103
+ * GET /drift/:nodeId/latest
104
+ * Get the latest drift scan for a node.
105
+ */
106
+ driftRouter.get('/:nodeId/latest', async (c) => {
107
+ const db = getDb();
108
+ const nodeId = c.req.param('nodeId');
109
+ const scan = await db.driftScan.findFirst({
110
+ where: { nodeId },
111
+ orderBy: { scannedAt: 'desc' },
112
+ });
113
+ if (!scan)
114
+ throw new HttpError(404, 'NOT_FOUND', 'No drift scans found for this node');
115
+ return c.json({
116
+ success: true,
117
+ data: {
118
+ id: scan.id,
119
+ nodeId: scan.nodeId,
120
+ status: scan.status,
121
+ findings: JSON.parse(scan.findings),
122
+ scannedAt: scan.scannedAt,
123
+ },
124
+ });
125
+ });
126
+ //# sourceMappingURL=drift.js.map
@@ -0,0 +1,87 @@
1
+ import { Hono } from 'hono';
2
+ import { authMiddleware } from '../middleware/auth.js';
3
+ import { eventBus } from '../services/event-bus.js';
4
+ export const eventsStreamRouter = new Hono();
5
+ eventsStreamRouter.use('*', authMiddleware);
6
+ /**
7
+ * GET /events/stream — SSE endpoint for real-time fleet events.
8
+ *
9
+ * Subscribes to the Redis event bus and pushes events to the client.
10
+ * Supports optional `channels` query param (comma-separated) to filter.
11
+ */
12
+ eventsStreamRouter.get('/', async (c) => {
13
+ const channelFilter = c.req.query('channels')?.split(',').filter(Boolean);
14
+ c.header('Content-Type', 'text/event-stream');
15
+ c.header('Cache-Control', 'no-cache');
16
+ c.header('Connection', 'keep-alive');
17
+ c.header('X-Accel-Buffering', 'no');
18
+ const signal = c.req.raw.signal;
19
+ let keepAlive;
20
+ let unsubscribe;
21
+ let closed = false;
22
+ // Idempotent cleanup for every exit path: client abort, stream cancel, or a
23
+ // disconnect that happened while the subscription was still being set up.
24
+ const cleanup = () => {
25
+ closed = true;
26
+ if (keepAlive)
27
+ clearInterval(keepAlive);
28
+ keepAlive = undefined;
29
+ unsubscribe?.();
30
+ unsubscribe = undefined;
31
+ signal.removeEventListener('abort', cleanup);
32
+ };
33
+ signal.addEventListener('abort', cleanup, { once: true });
34
+ const stream = new ReadableStream({
35
+ async start(controller) {
36
+ const encoder = new TextEncoder();
37
+ const send = (event, data) => {
38
+ try {
39
+ controller.enqueue(encoder.encode(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`));
40
+ }
41
+ catch {
42
+ // Stream closed
43
+ }
44
+ };
45
+ // Send initial connection event
46
+ send('connected', { timestamp: new Date().toISOString() });
47
+ // Keep-alive every 30s
48
+ keepAlive = setInterval(() => {
49
+ try {
50
+ controller.enqueue(encoder.encode(': keepalive\n\n'));
51
+ }
52
+ catch {
53
+ cleanup();
54
+ }
55
+ }, 30_000);
56
+ // Subscribe to all events via event bus
57
+ const off = await eventBus.subscribe('*', (channel, data) => {
58
+ // Apply channel filter if provided
59
+ if (channelFilter && channelFilter.length > 0) {
60
+ const match = channelFilter.some((f) => channel.startsWith(f));
61
+ if (!match)
62
+ return;
63
+ }
64
+ send(channel, data);
65
+ });
66
+ // The client may have gone away during the await above.
67
+ if (closed || signal.aborted) {
68
+ off();
69
+ cleanup();
70
+ return;
71
+ }
72
+ unsubscribe = off;
73
+ },
74
+ cancel() {
75
+ cleanup();
76
+ },
77
+ });
78
+ return new Response(stream, {
79
+ headers: {
80
+ 'Content-Type': 'text/event-stream',
81
+ 'Cache-Control': 'no-cache',
82
+ 'Connection': 'keep-alive',
83
+ 'X-Accel-Buffering': 'no',
84
+ },
85
+ });
86
+ });
87
+ //# sourceMappingURL=events-stream.js.map
@@ -0,0 +1,214 @@
1
+ import { Hono } from 'hono';
2
+ import { getDb } from '../db/index.js';
3
+ import { authMiddleware, getUser, requireRole } from '../middleware/auth.js';
4
+ import { logAuditEvent } from '../services/audit-service.js';
5
+ import { NodeApiClient } from '../sdk/index.js';
6
+ import { getNodeBaseUrl } from '../utils/node-url.js';
7
+ import { HttpError } from '../middleware/error-handler.js';
8
+ import { getNodeManagerSecret } from '../utils/env.js';
9
+ import { parseBody } from '../utils/validate.js';
10
+ import { fileUpdateSchema } from '../schemas/files.js';
11
+ import { enforceIdempotencyFromHeader } from '../utils/idempotency.js';
12
+ /** POSIX single-quote a string for safe shell interpolation. */
13
+ function sq(s) {
14
+ return "'" + s.replace(/'/g, "'\\''") + "'";
15
+ }
16
+ export const filesRouter = new Hono();
17
+ filesRouter.use('*', authMiddleware);
18
+ const STALE_THRESHOLD_MS = Number(process.env['STALE_NODE_THRESHOLD_MS'] ?? 120_000);
19
+ function isNodeStale(lastHeartbeatAt) {
20
+ return !lastHeartbeatAt || Date.now() - lastHeartbeatAt.getTime() > STALE_THRESHOLD_MS;
21
+ }
22
+ function pathPolicy(filePath) {
23
+ if (filePath.includes('..') || filePath.trim() === '/' || filePath.startsWith('/proc/') || filePath.startsWith('/sys/')) {
24
+ return 'blocked-path';
25
+ }
26
+ if (filePath.startsWith('/etc/') || filePath.startsWith('/root/') || filePath.startsWith('/var/lib/')) {
27
+ return 'sensitive-system-path';
28
+ }
29
+ return 'safe-app-path';
30
+ }
31
+ // ── Push file update to nodes ──
32
+ filesRouter.post('/update', requireRole('ADMIN', 'OPERATOR'), async (c) => {
33
+ const db = getDb();
34
+ const user = getUser(c);
35
+ const body = await parseBody(c, fileUpdateSchema);
36
+ const nodeIds = body.nodeIds;
37
+ const filePath = body.filePath;
38
+ const content = body.content;
39
+ const nodes = await db.node.findMany({
40
+ where: { id: { in: nodeIds }, status: 'ONLINE' },
41
+ });
42
+ const policy = pathPolicy(filePath);
43
+ if (policy === 'blocked-path') {
44
+ throw new HttpError(400, 'BLOCKED_PATH', `File path is blocked by policy: ${filePath}`);
45
+ }
46
+ const staleTargets = nodes.filter((node) => isNodeStale(node.lastHeartbeatAt));
47
+ if (staleTargets.length > 0) {
48
+ throw new HttpError(409, 'STALE_NODE_BLOCKED', `File update blocked for stale node(s): ${staleTargets.map((node) => node.name).join(', ')}`);
49
+ }
50
+ if (body.previewOnly) {
51
+ return c.json({
52
+ success: true,
53
+ data: {
54
+ previewOnly: true,
55
+ filePath,
56
+ policy,
57
+ targetCount: nodes.length,
58
+ backupPlanned: body.backup,
59
+ contentBytes: Buffer.byteLength(content, 'utf-8'),
60
+ },
61
+ });
62
+ }
63
+ // Claim after validation/preview/preflight so a rejected retry is not a duplicate.
64
+ await enforceIdempotencyFromHeader(c);
65
+ const tasks = await Promise.all(nodes.map(async (node) => {
66
+ const task = await db.filePatchTask.create({
67
+ data: {
68
+ nodeId: node.id,
69
+ filePath,
70
+ direction: 'push',
71
+ content,
72
+ status: 'pending',
73
+ createdBy: user.userId,
74
+ },
75
+ });
76
+ // Dispatch to node agent
77
+ const client = new NodeApiClient({
78
+ baseUrl: getNodeBaseUrl(node.ipAddress, node.port),
79
+ resourceNodeId: node.id, resourceActorId: 'system:file-api',
80
+ nodeToken: getNodeManagerSecret(),
81
+ });
82
+ try {
83
+ if (body.backup) {
84
+ const stamp = new Date().toISOString().replace(/[:.]/g, '-');
85
+ await client.executeCommand({
86
+ commandId: `file-backup-${Date.now()}`,
87
+ command: `if [ -f ${sq(filePath)} ]; then cp -p ${sq(filePath)} ${sq(`${filePath}.magnus-backup.${stamp}`)}; fi`,
88
+ args: [],
89
+ timeoutSeconds: 15,
90
+ }).catch(() => {
91
+ // Backup is best-effort for compatibility with restricted paths;
92
+ // the write path below will still report any real failure.
93
+ });
94
+ }
95
+ try {
96
+ await client.writeFile({
97
+ filePath,
98
+ content,
99
+ createIfMissing: body.createIfMissing ?? true,
100
+ });
101
+ }
102
+ catch (writeErr) {
103
+ // Fallback: if the agent is old and doesn't have /files/write (404),
104
+ // write via the command executor using base64 decode piped to tee.
105
+ const is404 = writeErr &&
106
+ typeof writeErr === 'object' &&
107
+ 'response' in writeErr
108
+ ? writeErr.response.status === 404
109
+ : false;
110
+ if (!is404)
111
+ throw writeErr;
112
+ // Encode content as base64 to avoid shell escaping issues with
113
+ // arbitrary file content (quotes, newlines, special chars, etc.)
114
+ const b64 = Buffer.from(content, 'utf-8').toString('base64');
115
+ const parentDir = filePath.replace(/\/[^/]+$/, '');
116
+ const mkdirPrefix = body.createIfMissing !== false
117
+ ? `mkdir -p ${sq(parentDir)} && `
118
+ : '';
119
+ const pipeRes = await client.executeCommand({
120
+ commandId: `file-write-${Date.now()}`,
121
+ command: `${mkdirPrefix}printf '%s' ${sq(b64)} | base64 -d > ${sq(filePath)}`,
122
+ args: [],
123
+ timeoutSeconds: 15,
124
+ });
125
+ if (pipeRes.data.exitCode !== 0) {
126
+ throw new Error(pipeRes.data.stderr || 'Failed to write file via command fallback');
127
+ }
128
+ }
129
+ await db.filePatchTask.update({
130
+ where: { id: task.id },
131
+ data: { status: 'completed', completedAt: new Date() },
132
+ });
133
+ return { ...task, status: 'completed' };
134
+ }
135
+ catch (err) {
136
+ const message = err instanceof Error ? err.message : String(err);
137
+ await db.filePatchTask.update({
138
+ where: { id: task.id },
139
+ data: { status: 'failed', error: message },
140
+ });
141
+ return { ...task, status: 'failed', error: message };
142
+ }
143
+ }));
144
+ await logAuditEvent({
145
+ action: 'file.update',
146
+ actorId: user.userId,
147
+ targetType: 'file',
148
+ targetId: filePath,
149
+ details: { nodeIds, filePath },
150
+ });
151
+ // If every task failed, return 502 so the dashboard can show an error
152
+ const allFailed = tasks.length > 0 && tasks.every((t) => t.status === 'failed');
153
+ const statusCode = allFailed ? 502 : 201;
154
+ return c.json({ success: !allFailed, data: tasks }, statusCode);
155
+ });
156
+ // ── Read file from a node ──
157
+ filesRouter.get('/read', requireRole('ADMIN', 'OPERATOR'), async (c) => {
158
+ const db = getDb();
159
+ const user = getUser(c);
160
+ const nodeId = c.req.query('nodeId');
161
+ const filePath = c.req.query('filePath');
162
+ if (!nodeId || !filePath) {
163
+ throw new HttpError(400, 'VALIDATION_ERROR', 'nodeId and filePath are required');
164
+ }
165
+ const node = await db.node.findUnique({ where: { id: nodeId } });
166
+ if (!node)
167
+ throw new HttpError(404, 'NOT_FOUND', 'Node not found');
168
+ const client = new NodeApiClient({
169
+ baseUrl: getNodeBaseUrl(node.ipAddress, node.port),
170
+ resourceNodeId: node.id, resourceActorId: 'system:file-api',
171
+ nodeToken: getNodeManagerSecret(),
172
+ });
173
+ let responseData;
174
+ try {
175
+ const response = await client.readFile(filePath);
176
+ responseData = response.data;
177
+ }
178
+ catch (err) {
179
+ // Fallback: if the node-manager doesn't have /files/read (404 on older
180
+ // agents), read the file via the command executor using `cat`.
181
+ const is404 = err && typeof err === 'object' && 'response' in err
182
+ ? err.response.status === 404
183
+ : false;
184
+ if (!is404)
185
+ throw err;
186
+ const cmdRes = await client.executeCommand({
187
+ commandId: `file-read-${Date.now()}`,
188
+ command: `cat ${sq(filePath)}`,
189
+ args: [],
190
+ timeoutSeconds: 10,
191
+ });
192
+ const result = cmdRes.data;
193
+ if (result.exitCode !== 0) {
194
+ throw new HttpError(500, 'FILE_READ_ERROR', result.stderr || 'Failed to read file');
195
+ }
196
+ responseData = {
197
+ nodeId: node.id,
198
+ filePath,
199
+ content: result.stdout,
200
+ checksum: '',
201
+ sizeBytes: result.stdout.length,
202
+ modifiedAt: new Date().toISOString(),
203
+ };
204
+ }
205
+ await logAuditEvent({
206
+ action: 'file.read',
207
+ actorId: user.userId,
208
+ targetType: 'file',
209
+ targetId: filePath,
210
+ details: { nodeId },
211
+ });
212
+ return c.json({ success: true, data: responseData });
213
+ });
214
+ //# sourceMappingURL=files.js.map