@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,90 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { constants } from 'node:fs';
3
+ import { open, realpath } from 'node:fs/promises';
4
+ import path from 'node:path';
5
+ import { z } from 'zod';
6
+ import { getSkillsDir } from './skill-service.js';
7
+ const MAX_FILES = 256;
8
+ const MAX_BYTES = 3 * 1024 * 1024;
9
+ const safeSegment = z.string().min(1).max(128)
10
+ .regex(/^[a-zA-Z0-9][a-zA-Z0-9._+-]*$/)
11
+ .refine(value => value !== '.' && value !== '..' && !value.includes('..'), 'Unsafe skill identity');
12
+ const registryFileSchema = z.object({
13
+ path: z.string().min(1).max(240),
14
+ size: z.number().int().nonnegative().max(MAX_BYTES),
15
+ sha256: z.string().regex(/^[a-f0-9]{64}$/),
16
+ }).strict();
17
+ const sha256 = (value) => createHash('sha256').update(value).digest('hex');
18
+ function safeRelativeFile(value) {
19
+ if (value.includes('\\') || value.includes('\0') || path.posix.isAbsolute(value)
20
+ || path.posix.normalize(value) !== value
21
+ || value.split('/').some(segment => !segment || segment === '.' || segment === '..')) {
22
+ throw new Error('Published skill version contains an unsafe file path');
23
+ }
24
+ return value;
25
+ }
26
+ /**
27
+ * Snapshot exactly the files retained by the immutable registry version.
28
+ * The managed node request carries the bytes, so publication never depends on
29
+ * a mutable download URL or on a second unauthenticated fetch.
30
+ */
31
+ export async function buildSkillPublicationBundle(input) {
32
+ const skillName = safeSegment.parse(input.skillName);
33
+ const version = safeSegment.parse(input.version);
34
+ if (!/^[a-f0-9]{64}$/.test(input.registryContentSha256))
35
+ throw new Error('Published skill version digest is invalid');
36
+ const registryFiles = z.array(registryFileSchema).min(1).max(MAX_FILES).parse(JSON.parse(input.registryFilesJson));
37
+ if (new Set(registryFiles.map(file => safeRelativeFile(file.path))).size !== registryFiles.length)
38
+ throw new Error('Published skill version contains duplicate files');
39
+ if (!registryFiles.some(file => file.path === 'manifest.json'))
40
+ throw new Error('Published skill version lacks manifest.json');
41
+ // The registry stores the exact order used by its existing content-hash
42
+ // producer. The wire bundle separately uses code-unit order.
43
+ const registryDigest = sha256(registryFiles.map(file => `${file.path}:${file.sha256}`).join('\n'));
44
+ if (registryDigest !== input.registryContentSha256)
45
+ throw new Error('Published skill registry digest differs from its file index');
46
+ const files = [...registryFiles].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
47
+ const root = await realpath(getSkillsDir());
48
+ const skillRoot = await realpath(path.join(root, skillName));
49
+ if (skillRoot !== path.join(root, skillName))
50
+ throw new Error('Published skill source must not traverse a symbolic link');
51
+ const entries = [];
52
+ let totalBytes = 0;
53
+ for (const expected of files) {
54
+ const relative = safeRelativeFile(expected.path);
55
+ const absolute = path.join(skillRoot, ...relative.split('/'));
56
+ const handle = await open(absolute, constants.O_RDONLY | constants.O_NOFOLLOW);
57
+ try {
58
+ const before = await handle.stat();
59
+ if (!before.isFile() || before.nlink !== 1 || before.size !== expected.size || before.mode & 0o6022)
60
+ throw new Error('Published skill source file type, size, link count or mode is unsafe');
61
+ totalBytes += before.size;
62
+ if (totalBytes > MAX_BYTES)
63
+ throw new Error('Published skill bundle exceeds the bounded payload size');
64
+ const content = await handle.readFile();
65
+ const after = await handle.stat();
66
+ if (after.dev !== before.dev || after.ino !== before.ino || after.size !== before.size
67
+ || after.mtimeMs !== before.mtimeMs || content.byteLength !== before.size)
68
+ throw new Error('Published skill source changed while it was captured');
69
+ const contentSha256 = sha256(content);
70
+ if (contentSha256 !== expected.sha256)
71
+ throw new Error('Published skill source differs from its immutable registry version');
72
+ entries.push({ path: relative, mode: before.mode & 0o111 ? 493 : 420,
73
+ sha256: contentSha256, contentBase64: content.toString('base64') });
74
+ }
75
+ finally {
76
+ await handle.close();
77
+ }
78
+ }
79
+ const manifestEntry = entries.find(entry => entry.path === 'manifest.json');
80
+ const manifest = z.object({ name: z.literal(skillName), version: z.literal(version) }).passthrough()
81
+ .parse(JSON.parse(Buffer.from(manifestEntry.contentBase64, 'base64').toString('utf8')));
82
+ void manifest;
83
+ const bundle = { format: 'magnus-skill-bundle-v1', entries };
84
+ const bundleSha256 = sha256(JSON.stringify(bundle));
85
+ const treeSha256 = sha256(JSON.stringify({ format: 'magnus-skill-tree-v1',
86
+ entries: entries.map(({ path: filePath, mode, sha256: fileSha256 }) => ({ path: filePath, mode, sha256: fileSha256 })) }));
87
+ return { skillName, version, registryContentSha256: input.registryContentSha256,
88
+ bundleSha256, treeSha256, bundle };
89
+ }
90
+ //# sourceMappingURL=skill-publication-bundle.js.map
@@ -0,0 +1,36 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { z } from 'zod';
3
+ import { getDb } from '../db/index.js';
4
+ const noEffectSchema = z.object({
5
+ success: z.literal(false),
6
+ error: z.object({ code: z.literal('SKILL_PUBLICATION_NOT_COMMITTED'), message: z.string() }).strict(),
7
+ data: z.object({
8
+ skillName: z.string(), version: z.string(), bundleSha256: z.string().regex(/^[a-f0-9]{64}$/),
9
+ commandId: z.string(), requestSha256: z.string().regex(/^[a-f0-9]{64}$/), effect: z.literal('none'),
10
+ }).strict(),
11
+ }).strict();
12
+ const MARKER_PREFIX = 'signed-skill-no-effect:';
13
+ export function isSkillPublicationNoEffectSettlement(value) {
14
+ return typeof value === 'string' && new RegExp(`^${MARKER_PREFIX}[a-f0-9]{64}$`).test(value);
15
+ }
16
+ /** Promote an already signature-verified generic settlement only after its
17
+ * exact typed node response proves that this publication committed no effect. */
18
+ export async function correlateSkillPublicationNoEffect(input) {
19
+ const response = noEffectSchema.parse(JSON.parse(input.responseBody));
20
+ if (response.data.commandId !== input.commandId || response.data.requestSha256 !== input.requestSha256
21
+ || response.data.skillName !== input.skillName || response.data.version !== input.version
22
+ || response.data.bundleSha256 !== input.bundleSha256)
23
+ throw new Error('Skill publication no-effect response differs from the exact workflow');
24
+ const marker = `${MARKER_PREFIX}${createHash('sha256').update(input.responseBody).digest('hex')}`;
25
+ const db = getDb();
26
+ const changed = await db.commandResourceLease.updateMany({ where: { commandId: input.commandId,
27
+ requestSha256: input.requestSha256, state: 'released', settlement: 'signed-command-result' },
28
+ data: { settlement: marker } });
29
+ if (changed.count === 1)
30
+ return;
31
+ const current = await db.commandResourceLease.findUnique({ where: { commandId: input.commandId } });
32
+ if (!current || current.requestSha256 !== input.requestSha256 || current.state !== 'released'
33
+ || current.settlement !== marker)
34
+ throw new Error('Signed skill publication no-effect settlement changed before correlation');
35
+ }
36
+ //# sourceMappingURL=skill-publication-settlement.js.map
@@ -0,0 +1,40 @@
1
+ import { createHash } from 'node:crypto';
2
+ /** The command ledger is the durable successor journal while the installation
3
+ * row continues to describe the last receipt-proven installation. */
4
+ function publicationCommandId(identity, retryAfterCommandId) {
5
+ const digest = createHash('sha256').update(JSON.stringify({
6
+ domain: 'magnus.skill-publication-workflow.v1',
7
+ nodeId: identity.nodeId,
8
+ skillName: identity.skillName,
9
+ version: identity.version,
10
+ versionHash: identity.versionHash,
11
+ bundleSha256: identity.bundleSha256,
12
+ treeSha256: identity.treeSha256,
13
+ ...(retryAfterCommandId ? { retryAfterCommandId } : {}),
14
+ })).digest('hex');
15
+ return `skill-${digest}`;
16
+ }
17
+ export function skillPublicationCommandId(identity) {
18
+ return publicationCommandId(identity);
19
+ }
20
+ /** Advance only from a durable no-effect settlement. Including the prior ID
21
+ * keeps every retry generation bound to one exact, auditable predecessor. */
22
+ export function nextSkillPublicationCommandId(identity, retryAfterCommandId) {
23
+ return publicationCommandId(identity, retryAfterCommandId);
24
+ }
25
+ export function isSameSkillPublication(state, identity) {
26
+ return state.version === identity.version
27
+ && state.versionHash === identity.versionHash
28
+ && state.bundleSha256 === identity.bundleSha256
29
+ && state.treeSha256 === identity.treeSha256;
30
+ }
31
+ export function isExactInstalledPublication(state, identity, evidence) {
32
+ if (state.status !== 'installed' || !state.workflowCommandId
33
+ || !state.workflowRequestSha256 || !state.workflowReceiptSha256
34
+ || !isSameSkillPublication(state, identity))
35
+ return false;
36
+ return !evidence || (state.workflowCommandId === evidence.commandId
37
+ && state.workflowRequestSha256 === evidence.commandSha256
38
+ && state.workflowReceiptSha256 === evidence.receiptSha256);
39
+ }
40
+ //# sourceMappingURL=skill-publication-state.js.map
@@ -0,0 +1,327 @@
1
+ import { createHash } from 'node:crypto';
2
+ import fs from 'node:fs/promises';
3
+ import path from 'node:path';
4
+ import { getDb } from '../db/index.js';
5
+ import * as skillService from './skill-service.js';
6
+ // ─── Helpers ───
7
+ /** Compute SHA-256 of content string. */
8
+ function sha256(content) {
9
+ return createHash('sha256').update(content, 'utf-8').digest('hex');
10
+ }
11
+ /** Default skills directory — same as skill-service */
12
+ const DEFAULT_SKILLS_DIR = path.resolve(import.meta.dirname, '../../skills');
13
+ function getSkillsDir() {
14
+ return process.env['SKILLS_DIR'] ?? DEFAULT_SKILLS_DIR;
15
+ }
16
+ // ─── Registry API ───
17
+ /**
18
+ * List all registry entries with version count, tag count, and install count.
19
+ * Merges filesystem skills that have no registry entry yet.
20
+ */
21
+ export async function listRegistryEntries() {
22
+ const db = getDb();
23
+ const entries = await db.skillRegistryEntry.findMany({
24
+ orderBy: { slug: 'asc' },
25
+ include: {
26
+ versions: { orderBy: { createdAt: 'desc' }, take: 5 },
27
+ tags: true,
28
+ installations: { select: { nodeId: true, status: true, version: true } },
29
+ },
30
+ });
31
+ return entries.map((e) => ({
32
+ id: e.id,
33
+ slug: e.slug,
34
+ displayName: e.displayName,
35
+ description: e.description,
36
+ author: e.author,
37
+ source: e.source,
38
+ sourceUrl: e.sourceUrl,
39
+ entryPoint: e.entryPoint,
40
+ dependencies: JSON.parse(e.dependencies),
41
+ metadata: JSON.parse(e.metadata),
42
+ latestVersion: e.latestVersion,
43
+ status: e.status,
44
+ createdAt: e.createdAt.toISOString(),
45
+ updatedAt: e.updatedAt.toISOString(),
46
+ versionCount: e.versions.length,
47
+ versions: e.versions.map(formatVersion),
48
+ tags: e.tags.map((t) => ({
49
+ id: t.id,
50
+ tag: t.tag,
51
+ versionId: t.versionId,
52
+ createdAt: t.createdAt.toISOString(),
53
+ updatedAt: t.updatedAt.toISOString(),
54
+ })),
55
+ installations: e.installations.map((i) => ({
56
+ nodeId: i.nodeId,
57
+ status: i.status,
58
+ version: i.version,
59
+ })),
60
+ }));
61
+ }
62
+ /** Get a single registry entry by slug with full version history. */
63
+ export async function getRegistryEntry(slug) {
64
+ const db = getDb();
65
+ const entry = await db.skillRegistryEntry.findUnique({
66
+ where: { slug },
67
+ include: {
68
+ versions: { orderBy: { createdAt: 'desc' } },
69
+ tags: true,
70
+ installations: { select: { nodeId: true, status: true, version: true } },
71
+ },
72
+ });
73
+ if (!entry)
74
+ return null;
75
+ return {
76
+ id: entry.id,
77
+ slug: entry.slug,
78
+ displayName: entry.displayName,
79
+ description: entry.description,
80
+ author: entry.author,
81
+ source: entry.source,
82
+ sourceUrl: entry.sourceUrl,
83
+ entryPoint: entry.entryPoint,
84
+ dependencies: JSON.parse(entry.dependencies),
85
+ metadata: JSON.parse(entry.metadata),
86
+ latestVersion: entry.latestVersion,
87
+ status: entry.status,
88
+ createdAt: entry.createdAt.toISOString(),
89
+ updatedAt: entry.updatedAt.toISOString(),
90
+ versions: entry.versions.map(formatVersion),
91
+ tags: entry.tags.map((t) => ({
92
+ id: t.id,
93
+ tag: t.tag,
94
+ versionId: t.versionId,
95
+ createdAt: t.createdAt.toISOString(),
96
+ updatedAt: t.updatedAt.toISOString(),
97
+ })),
98
+ installations: entry.installations.map((i) => ({
99
+ nodeId: i.nodeId,
100
+ status: i.status,
101
+ version: i.version,
102
+ })),
103
+ };
104
+ }
105
+ /**
106
+ * Publish a new version of a filesystem skill to the registry.
107
+ * Creates the registry entry if it doesn't exist yet.
108
+ * Snapshots all files + computes content hash for the version.
109
+ */
110
+ export async function publishVersion(data) {
111
+ const db = getDb();
112
+ const { slug, version, changelog, tagNames, publishedBy } = data;
113
+ // 1. Read the filesystem skill
114
+ const fsSkill = await skillService.getSkill(slug);
115
+ if (!fsSkill) {
116
+ throw new Error(`Skill "${slug}" not found on filesystem`);
117
+ }
118
+ // 2. Snapshot files + compute hashes
119
+ const skillDir = path.join(getSkillsDir(), slug);
120
+ const fileEntries = [];
121
+ let totalSize = 0;
122
+ for (const fileName of fsSkill.files) {
123
+ const filePath = path.join(skillDir, fileName);
124
+ const content = await fs.readFile(filePath, 'utf-8');
125
+ const hash = sha256(content);
126
+ const size = Buffer.byteLength(content, 'utf-8');
127
+ fileEntries.push({ path: fileName, size, sha256: hash });
128
+ totalSize += size;
129
+ }
130
+ // Content hash = hash of sorted file hashes (deterministic)
131
+ const contentHash = sha256(fileEntries
132
+ .sort((a, b) => a.path.localeCompare(b.path))
133
+ .map((f) => `${f.path}:${f.sha256}`)
134
+ .join('\n'));
135
+ // 3. Upsert registry entry
136
+ let entry = await db.skillRegistryEntry.findUnique({ where: { slug } });
137
+ if (!entry) {
138
+ entry = await db.skillRegistryEntry.create({
139
+ data: {
140
+ slug,
141
+ displayName: fsSkill.name,
142
+ description: fsSkill.description,
143
+ author: fsSkill.author,
144
+ source: 'local',
145
+ entryPoint: fsSkill.entryPoint,
146
+ dependencies: JSON.stringify(fsSkill.dependencies),
147
+ metadata: JSON.stringify({}),
148
+ latestVersion: version,
149
+ status: 'active',
150
+ },
151
+ });
152
+ }
153
+ // 4. Check for duplicate version
154
+ const existingVersion = await db.skillVersion.findUnique({
155
+ where: { skillId_version: { skillId: entry.id, version } },
156
+ });
157
+ if (existingVersion) {
158
+ throw new Error(`Version "${version}" already exists for skill "${slug}"`);
159
+ }
160
+ // 5. Create version record
161
+ const skillVersion = await db.skillVersion.create({
162
+ data: {
163
+ skillId: entry.id,
164
+ version,
165
+ changelog: changelog ?? '',
166
+ contentHash,
167
+ files: JSON.stringify(fileEntries),
168
+ entryPoint: fsSkill.entryPoint,
169
+ sizeBytes: totalSize,
170
+ publishedBy,
171
+ },
172
+ });
173
+ // 6. Update latest version on entry
174
+ entry = await db.skillRegistryEntry.update({
175
+ where: { id: entry.id },
176
+ data: {
177
+ latestVersion: version,
178
+ description: fsSkill.description,
179
+ author: fsSkill.author,
180
+ entryPoint: fsSkill.entryPoint,
181
+ dependencies: JSON.stringify(fsSkill.dependencies),
182
+ },
183
+ });
184
+ // 7. Set tags (always set "latest", plus any user-provided tags)
185
+ const allTags = new Set(tagNames ?? []);
186
+ allTags.add('latest');
187
+ for (const tag of allTags) {
188
+ await db.skillTag.upsert({
189
+ where: { skillId_tag: { skillId: entry.id, tag } },
190
+ create: { skillId: entry.id, tag, versionId: skillVersion.id },
191
+ update: { versionId: skillVersion.id },
192
+ });
193
+ }
194
+ return {
195
+ entry: {
196
+ id: entry.id,
197
+ slug: entry.slug,
198
+ displayName: entry.displayName,
199
+ description: entry.description,
200
+ latestVersion: entry.latestVersion,
201
+ status: entry.status,
202
+ },
203
+ version: formatVersion(skillVersion),
204
+ };
205
+ }
206
+ /** Get version history for a skill. */
207
+ export async function getVersions(slug) {
208
+ const db = getDb();
209
+ const entry = await db.skillRegistryEntry.findUnique({ where: { slug } });
210
+ if (!entry)
211
+ return [];
212
+ const versions = await db.skillVersion.findMany({
213
+ where: { skillId: entry.id },
214
+ orderBy: { createdAt: 'desc' },
215
+ });
216
+ return versions.map(formatVersion);
217
+ }
218
+ /** Get a single version detail (with file list). */
219
+ export async function getVersionDetail(slug, version) {
220
+ const db = getDb();
221
+ const entry = await db.skillRegistryEntry.findUnique({ where: { slug } });
222
+ if (!entry)
223
+ return null;
224
+ const ver = await db.skillVersion.findUnique({
225
+ where: { skillId_version: { skillId: entry.id, version } },
226
+ });
227
+ if (!ver)
228
+ return null;
229
+ return {
230
+ ...formatVersion(ver),
231
+ files: JSON.parse(ver.files),
232
+ };
233
+ }
234
+ /** Set or move a tag to a specific version. */
235
+ export async function setTag(slug, tag, versionId) {
236
+ const db = getDb();
237
+ const entry = await db.skillRegistryEntry.findUnique({ where: { slug } });
238
+ if (!entry)
239
+ throw new Error(`Skill "${slug}" not found in registry`);
240
+ // Verify the version exists
241
+ const version = await db.skillVersion.findFirst({
242
+ where: { id: versionId, skillId: entry.id },
243
+ });
244
+ if (!version)
245
+ throw new Error(`Version not found`);
246
+ const skillTag = await db.skillTag.upsert({
247
+ where: { skillId_tag: { skillId: entry.id, tag } },
248
+ create: { skillId: entry.id, tag, versionId },
249
+ update: { versionId },
250
+ });
251
+ return {
252
+ id: skillTag.id,
253
+ tag: skillTag.tag,
254
+ versionId: skillTag.versionId,
255
+ version: version.version,
256
+ createdAt: skillTag.createdAt.toISOString(),
257
+ updatedAt: skillTag.updatedAt.toISOString(),
258
+ };
259
+ }
260
+ /** Sync all filesystem skills into registry (creates entries + initial versions for untracked skills). */
261
+ export async function syncFromFilesystem(publishedBy) {
262
+ const fsSkills = await skillService.listSkills();
263
+ const db = getDb();
264
+ const created = [];
265
+ const updated = [];
266
+ const skipped = [];
267
+ for (const skill of fsSkills) {
268
+ const existing = await db.skillRegistryEntry.findUnique({
269
+ where: { slug: skill.name },
270
+ include: { versions: { orderBy: { createdAt: 'desc' }, take: 1 } },
271
+ });
272
+ if (!existing) {
273
+ // Create entry + initial version
274
+ await publishVersion({
275
+ slug: skill.name,
276
+ version: skill.version,
277
+ changelog: 'Initial import from filesystem',
278
+ publishedBy,
279
+ });
280
+ created.push(skill.name);
281
+ }
282
+ else if (existing.latestVersion !== skill.version) {
283
+ // Version on filesystem differs — publish a new version
284
+ try {
285
+ await publishVersion({
286
+ slug: skill.name,
287
+ version: skill.version,
288
+ changelog: 'Synced from filesystem',
289
+ publishedBy,
290
+ });
291
+ updated.push(skill.name);
292
+ }
293
+ catch {
294
+ // Version may already exist — skip
295
+ skipped.push(skill.name);
296
+ }
297
+ }
298
+ else {
299
+ skipped.push(skill.name);
300
+ }
301
+ }
302
+ return { created, updated, skipped };
303
+ }
304
+ /** Delete a registry entry and all its versions/tags. */
305
+ export async function deleteRegistryEntry(slug) {
306
+ const db = getDb();
307
+ const entry = await db.skillRegistryEntry.findUnique({ where: { slug } });
308
+ if (!entry)
309
+ throw new Error(`Skill "${slug}" not found in registry`);
310
+ // Cascade delete handles versions and tags
311
+ await db.skillRegistryEntry.delete({ where: { id: entry.id } });
312
+ }
313
+ function formatVersion(v) {
314
+ const files = JSON.parse(v.files);
315
+ return {
316
+ id: v.id,
317
+ version: v.version,
318
+ changelog: v.changelog,
319
+ contentHash: v.contentHash,
320
+ entryPoint: v.entryPoint,
321
+ sizeBytes: v.sizeBytes,
322
+ fileCount: files.length,
323
+ publishedBy: v.publishedBy,
324
+ createdAt: v.createdAt.toISOString(),
325
+ };
326
+ }
327
+ //# sourceMappingURL=skill-registry-service.js.map
@@ -0,0 +1,148 @@
1
+ import fs from 'node:fs/promises';
2
+ import path from 'node:path';
3
+ // ─── Helpers ───
4
+ import { getSkillsDir as getPackageSkillsDir } from '@hivemagnus/magnus-skills';
5
+ /** Skills directory — uses SKILLS_DIR env var or the magnus-skills package path */
6
+ export function getSkillsDir() {
7
+ return process.env['SKILLS_DIR'] ?? getPackageSkillsDir();
8
+ }
9
+ function manifestPath(skillName) {
10
+ return path.join(getSkillsDir(), skillName, 'manifest.json');
11
+ }
12
+ function skillDir(skillName) {
13
+ return path.join(getSkillsDir(), skillName);
14
+ }
15
+ async function readManifest(skillName) {
16
+ const raw = await fs.readFile(manifestPath(skillName), 'utf-8');
17
+ return JSON.parse(raw);
18
+ }
19
+ async function writeManifest(skillName, manifest) {
20
+ await fs.writeFile(manifestPath(skillName), JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
21
+ }
22
+ async function listFilesInDir(dirPath) {
23
+ const entries = await fs.readdir(dirPath, { withFileTypes: true });
24
+ return entries.filter((e) => e.isFile()).map((e) => e.name);
25
+ }
26
+ // ─── Public API ───
27
+ /** List all skills by scanning the skills directory for manifest.json files. */
28
+ export async function listSkills() {
29
+ const dir = getSkillsDir();
30
+ let entries;
31
+ try {
32
+ entries = await fs.readdir(dir, { withFileTypes: true });
33
+ }
34
+ catch {
35
+ // Skills dir doesn't exist yet
36
+ return [];
37
+ }
38
+ const skills = [];
39
+ for (const entry of entries) {
40
+ if (!entry.isDirectory())
41
+ continue;
42
+ try {
43
+ const manifest = await readManifest(entry.name);
44
+ const files = await listFilesInDir(path.join(dir, entry.name));
45
+ skills.push({ ...manifest, files });
46
+ }
47
+ catch {
48
+ // Skip directories without valid manifest
49
+ }
50
+ }
51
+ return skills.sort((a, b) => a.name.localeCompare(b.name));
52
+ }
53
+ /** Get a single skill by name. Returns null if not found. */
54
+ export async function getSkill(name) {
55
+ try {
56
+ const manifest = await readManifest(name);
57
+ const files = await listFilesInDir(skillDir(name));
58
+ return { ...manifest, files };
59
+ }
60
+ catch {
61
+ return null;
62
+ }
63
+ }
64
+ /** Read a specific file from a skill directory. */
65
+ export async function getSkillFile(skillName, fileName) {
66
+ try {
67
+ const filePath = path.join(skillDir(skillName), fileName);
68
+ // Prevent directory traversal
69
+ const resolved = path.resolve(filePath);
70
+ if (!resolved.startsWith(path.resolve(skillDir(skillName))))
71
+ return null;
72
+ return await fs.readFile(filePath, 'utf-8');
73
+ }
74
+ catch {
75
+ return null;
76
+ }
77
+ }
78
+ /** Create a new skill directory with manifest.json and optional entry point. */
79
+ export async function createSkill(data) {
80
+ const dir = skillDir(data.name);
81
+ // Ensure directory doesn't already exist
82
+ try {
83
+ await fs.access(dir);
84
+ throw new Error(`Skill "${data.name}" already exists`);
85
+ }
86
+ catch (err) {
87
+ if (err instanceof Error && err.message.includes('already exists'))
88
+ throw err;
89
+ // ENOENT is expected — proceed
90
+ }
91
+ await fs.mkdir(dir, { recursive: true });
92
+ const manifest = {
93
+ name: data.name,
94
+ version: data.version,
95
+ description: data.description ?? '',
96
+ author: data.author ?? '',
97
+ entryPoint: data.entryPoint ?? 'run.sh',
98
+ dependencies: data.dependencies ?? [],
99
+ tags: data.tags ?? [],
100
+ };
101
+ await writeManifest(data.name, manifest);
102
+ // Create a stub entry point if it doesn't exist
103
+ const entryPath = path.join(dir, manifest.entryPoint);
104
+ try {
105
+ await fs.access(entryPath);
106
+ }
107
+ catch {
108
+ await fs.writeFile(entryPath, `#!/usr/bin/env bash\nset -euo pipefail\n\n# ${data.name} — entry point\necho "${data.name} v${data.version}"\n`, 'utf-8');
109
+ await fs.chmod(entryPath, 0o755);
110
+ }
111
+ const files = await listFilesInDir(dir);
112
+ return { ...manifest, files };
113
+ }
114
+ /** Update a skill's manifest fields. */
115
+ export async function updateSkill(name, data) {
116
+ const manifest = await readManifest(name);
117
+ if (data.version !== undefined)
118
+ manifest.version = data.version;
119
+ if (data.description !== undefined)
120
+ manifest.description = data.description;
121
+ if (data.author !== undefined)
122
+ manifest.author = data.author;
123
+ if (data.entryPoint !== undefined)
124
+ manifest.entryPoint = data.entryPoint;
125
+ if (data.dependencies !== undefined)
126
+ manifest.dependencies = data.dependencies;
127
+ if (data.tags !== undefined)
128
+ manifest.tags = data.tags;
129
+ await writeManifest(name, manifest);
130
+ const files = await listFilesInDir(skillDir(name));
131
+ return { ...manifest, files };
132
+ }
133
+ /** Update (or create) a file within a skill directory. */
134
+ export async function updateSkillFile(skillName, fileName, content) {
135
+ const filePath = path.join(skillDir(skillName), fileName);
136
+ // Prevent directory traversal
137
+ const resolved = path.resolve(filePath);
138
+ if (!resolved.startsWith(path.resolve(skillDir(skillName)))) {
139
+ throw new Error('Invalid file path');
140
+ }
141
+ await fs.writeFile(filePath, content, 'utf-8');
142
+ }
143
+ /** Delete a skill directory entirely. */
144
+ export async function deleteSkill(name) {
145
+ const dir = skillDir(name);
146
+ await fs.rm(dir, { recursive: true, force: true });
147
+ }
148
+ //# sourceMappingURL=skill-service.js.map