@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.
- package/.env.example +171 -0
- package/LICENSE +202 -0
- package/README.md +169 -2
- package/agent-version.json +1 -0
- package/dist/ai/HEARTBEAT.md +56 -0
- package/dist/ai/IDENTITY.md +54 -0
- package/dist/ai/MEMORY.md +40 -0
- package/dist/ai/TOOLS.md +538 -0
- package/dist/ai/USER.md +32 -0
- package/dist/cli/args.js +62 -0
- package/dist/cli/env-catalog.js +131 -0
- package/dist/cli/preflight.js +89 -0
- package/dist/cli.js +175 -0
- package/dist/config/cors.js +16 -0
- package/dist/config/env.js +392 -0
- package/dist/config/features.js +16 -0
- package/dist/config/index.js +3 -0
- package/dist/config/listener-security.js +38 -0
- package/dist/config/version.js +31 -0
- package/dist/db/client.js +44 -0
- package/dist/db/generated/prisma/browser.js +18 -0
- package/dist/db/generated/prisma/client.js +35 -0
- package/dist/db/generated/prisma/commonInputTypes.js +11 -0
- package/dist/db/generated/prisma/enums.js +42 -0
- package/dist/db/generated/prisma/internal/class.js +50 -0
- package/dist/db/generated/prisma/internal/prismaNamespace.js +1598 -0
- package/dist/db/generated/prisma/internal/prismaNamespaceBrowser.js +1569 -0
- package/dist/db/generated/prisma/models/A2ATask.js +2 -0
- package/dist/db/generated/prisma/models/AdmissionFence.js +2 -0
- package/dist/db/generated/prisma/models/Agent.js +2 -0
- package/dist/db/generated/prisma/models/AiConversation.js +2 -0
- package/dist/db/generated/prisma/models/AiDashboard.js +2 -0
- package/dist/db/generated/prisma/models/AiMemory.js +2 -0
- package/dist/db/generated/prisma/models/AiMessage.js +2 -0
- package/dist/db/generated/prisma/models/AiScheduledOp.js +2 -0
- package/dist/db/generated/prisma/models/AlertConditionState.js +2 -0
- package/dist/db/generated/prisma/models/AlertRule.js +2 -0
- package/dist/db/generated/prisma/models/AlertViolation.js +2 -0
- package/dist/db/generated/prisma/models/AnomalyEvent.js +2 -0
- package/dist/db/generated/prisma/models/ApplicationObservation.js +2 -0
- package/dist/db/generated/prisma/models/ArdentInstallation.js +2 -0
- package/dist/db/generated/prisma/models/ArdentProfile.js +2 -0
- package/dist/db/generated/prisma/models/ArdentScopeEnrollment.js +2 -0
- package/dist/db/generated/prisma/models/CommandResourceFence.js +2 -0
- package/dist/db/generated/prisma/models/CommandResourceLease.js +2 -0
- package/dist/db/generated/prisma/models/CommandResult.js +2 -0
- package/dist/db/generated/prisma/models/CronJob.js +2 -0
- package/dist/db/generated/prisma/models/CronJobExecution.js +2 -0
- package/dist/db/generated/prisma/models/DeployJob.js +2 -0
- package/dist/db/generated/prisma/models/DriftScan.js +2 -0
- package/dist/db/generated/prisma/models/EngineeringMetricSample.js +2 -0
- package/dist/db/generated/prisma/models/EngineeringRecoveryExercise.js +2 -0
- package/dist/db/generated/prisma/models/ExecutionRun.js +2 -0
- package/dist/db/generated/prisma/models/FilePatchTask.js +2 -0
- package/dist/db/generated/prisma/models/GpuSnapshot.js +2 -0
- package/dist/db/generated/prisma/models/HealthSnapshot.js +2 -0
- package/dist/db/generated/prisma/models/HermesCoreRollout.js +2 -0
- package/dist/db/generated/prisma/models/HermesCoreRolloutHost.js +2 -0
- package/dist/db/generated/prisma/models/HermesCredentialPool.js +2 -0
- package/dist/db/generated/prisma/models/HermesCredentialPoolAttachment.js +2 -0
- package/dist/db/generated/prisma/models/HermesCronJob.js +2 -0
- package/dist/db/generated/prisma/models/HermesHook.js +2 -0
- package/dist/db/generated/prisma/models/HermesInstallation.js +2 -0
- package/dist/db/generated/prisma/models/HermesMcpServer.js +2 -0
- package/dist/db/generated/prisma/models/HermesMcpServerAttachment.js +2 -0
- package/dist/db/generated/prisma/models/HermesMessagingBinding.js +2 -0
- package/dist/db/generated/prisma/models/HermesOperationJob.js +2 -0
- package/dist/db/generated/prisma/models/HermesPluginInstall.js +2 -0
- package/dist/db/generated/prisma/models/HermesProfile.js +2 -0
- package/dist/db/generated/prisma/models/HermesProviderConfig.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryClient.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryInventory.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryReceipt.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryRevision.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryTarget.js +2 -0
- package/dist/db/generated/prisma/models/HermesRole.js +2 -0
- package/dist/db/generated/prisma/models/HermesRoleApplication.js +2 -0
- package/dist/db/generated/prisma/models/HermesSkillAssignment.js +2 -0
- package/dist/db/generated/prisma/models/HermesToolsetPolicy.js +2 -0
- package/dist/db/generated/prisma/models/IncidentLesson.js +2 -0
- package/dist/db/generated/prisma/models/LibraryCategory.js +2 -0
- package/dist/db/generated/prisma/models/LibraryFile.js +2 -0
- package/dist/db/generated/prisma/models/LogEntry.js +2 -0
- package/dist/db/generated/prisma/models/MagnusReleaseCanary.js +2 -0
- package/dist/db/generated/prisma/models/MaintenanceWindow.js +2 -0
- package/dist/db/generated/prisma/models/ManagedCronDefinition.js +2 -0
- package/dist/db/generated/prisma/models/ManagedCronOccurrence.js +2 -0
- package/dist/db/generated/prisma/models/Node.js +2 -0
- package/dist/db/generated/prisma/models/Notification.js +2 -0
- package/dist/db/generated/prisma/models/NotificationPreference.js +2 -0
- package/dist/db/generated/prisma/models/RemediationExecution.js +2 -0
- package/dist/db/generated/prisma/models/RemediationRule.js +2 -0
- package/dist/db/generated/prisma/models/RemoteCommand.js +2 -0
- package/dist/db/generated/prisma/models/ResourceDrainParticipant.js +2 -0
- package/dist/db/generated/prisma/models/ResourceEnrollment.js +2 -0
- package/dist/db/generated/prisma/models/ResourceParticipantWork.js +2 -0
- package/dist/db/generated/prisma/models/Role.js +2 -0
- package/dist/db/generated/prisma/models/RoleApplication.js +2 -0
- package/dist/db/generated/prisma/models/RolloutTarget.js +2 -0
- package/dist/db/generated/prisma/models/SecurityExportOutbox.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionAction.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionActionApproval.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCase.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCaseActivity.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCaseEntity.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCaseEvent.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCaseRelationship.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCollector.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCommandOutbox.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionDeletionReceipt.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionDelivery.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEntity.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEntityAlias.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEvent.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEventEntity.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEvidence.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionInvestigation.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionNonce.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionReceiptChainHead.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionRuleVersion.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionSourceState.js +2 -0
- package/dist/db/generated/prisma/models/SecurityServiceState.js +2 -0
- package/dist/db/generated/prisma/models/SharedResourceFence.js +2 -0
- package/dist/db/generated/prisma/models/SharedResourceLease.js +2 -0
- package/dist/db/generated/prisma/models/SharedResourceLeaseResource.js +2 -0
- package/dist/db/generated/prisma/models/SkillInstallation.js +2 -0
- package/dist/db/generated/prisma/models/SkillRegistryEntry.js +2 -0
- package/dist/db/generated/prisma/models/SkillTag.js +2 -0
- package/dist/db/generated/prisma/models/SkillVersion.js +2 -0
- package/dist/db/generated/prisma/models/TeamApprovalDecision.js +2 -0
- package/dist/db/generated/prisma/models/User.js +2 -0
- package/dist/db/generated/prisma/models/WebhookDelivery.js +2 -0
- package/dist/db/generated/prisma/models/WebhookEndpoint.js +2 -0
- package/dist/db/generated/prisma/models.js +2 -0
- package/dist/db/index.js +3 -0
- package/dist/db/read-retry.js +35 -0
- package/dist/db/seed.js +348 -0
- package/dist/index.js +162 -0
- package/dist/middleware/auth.js +361 -0
- package/dist/middleware/body-limit.js +14 -0
- package/dist/middleware/correlation-id.js +13 -0
- package/dist/middleware/error-handler.js +28 -0
- package/dist/middleware/iam-token.js +21 -0
- package/dist/middleware/rate-limit.js +78 -0
- package/dist/middleware/request-logger.js +85 -0
- package/dist/middleware/security-headers.js +23 -0
- package/dist/middleware/tracing.js +120 -0
- package/dist/middleware/user-status.js +33 -0
- package/dist/openapi/spec.js +2656 -0
- package/dist/queue/redis.js +20 -0
- package/dist/queue/requeue.js +27 -0
- package/dist/queue/workers.js +342 -0
- package/dist/routes/ai-schedule.js +73 -0
- package/dist/routes/alerts.js +79 -0
- package/dist/routes/anomalies.js +101 -0
- package/dist/routes/ardent.js +82 -0
- package/dist/routes/assistant.js +417 -0
- package/dist/routes/audit.js +138 -0
- package/dist/routes/codex.js +65 -0
- package/dist/routes/commands.js +226 -0
- package/dist/routes/credentials.js +58 -0
- package/dist/routes/cron.js +292 -0
- package/dist/routes/dependencies.js +49 -0
- package/dist/routes/deploy.js +18 -0
- package/dist/routes/discovery.js +168 -0
- package/dist/routes/docs.js +24 -0
- package/dist/routes/drift.js +126 -0
- package/dist/routes/events-stream.js +87 -0
- package/dist/routes/files.js +214 -0
- package/dist/routes/fleet-checks.js +21 -0
- package/dist/routes/health.js +133 -0
- package/dist/routes/heartbeat.js +545 -0
- package/dist/routes/hermes-registry.js +278 -0
- package/dist/routes/hermes.js +61 -0
- package/dist/routes/library.js +402 -0
- package/dist/routes/logs.js +172 -0
- package/dist/routes/managed-cron.js +23 -0
- package/dist/routes/mcp.js +39 -0
- package/dist/routes/metrics.js +187 -0
- package/dist/routes/nodes.js +951 -0
- package/dist/routes/notifications.js +130 -0
- package/dist/routes/ops.js +258 -0
- package/dist/routes/orchestra.js +430 -0
- package/dist/routes/predictions.js +23 -0
- package/dist/routes/profiling.js +68 -0
- package/dist/routes/quick-command.js +72 -0
- package/dist/routes/remediation.js +111 -0
- package/dist/routes/resource-leases.js +297 -0
- package/dist/routes/roles.js +370 -0
- package/dist/routes/rollout.js +124 -0
- package/dist/routes/scan.js +116 -0
- package/dist/routes/security-backup.js +58 -0
- package/dist/routes/security-fusion.js +605 -0
- package/dist/routes/security-integration.js +71 -0
- package/dist/routes/self-update.js +129 -0
- package/dist/routes/shared-resource-leases.js +78 -0
- package/dist/routes/skills.js +485 -0
- package/dist/routes/stats.js +96 -0
- package/dist/routes/team-approvals.js +23 -0
- package/dist/routes/terminal-ticket.js +15 -0
- package/dist/routes/terminal.js +17 -0
- package/dist/routes/topology.js +37 -0
- package/dist/routes/users.js +219 -0
- package/dist/routes/webhooks.js +137 -0
- package/dist/schemas/command-reconciliation.js +14 -0
- package/dist/schemas/commands.js +51 -0
- package/dist/schemas/cron.js +33 -0
- package/dist/schemas/deploy.js +20 -0
- package/dist/schemas/files.js +14 -0
- package/dist/schemas/hermes.js +69 -0
- package/dist/schemas/index.js +11 -0
- package/dist/schemas/library.js +48 -0
- package/dist/schemas/logs.js +35 -0
- package/dist/schemas/managed-cron.js +127 -0
- package/dist/schemas/node-responses.js +87 -0
- package/dist/schemas/node-session-receipt.js +84 -0
- package/dist/schemas/nodes.js +36 -0
- package/dist/schemas/orchestra.js +118 -0
- package/dist/schemas/resource-participant-reconciliation.js +99 -0
- package/dist/schemas/roles.js +54 -0
- package/dist/schemas/shared-resource-lease.js +132 -0
- package/dist/schemas/skills.js +44 -0
- package/dist/schemas/users.js +28 -0
- package/dist/scripts/run-disposable-recovery-exercise.js +39 -0
- package/dist/sdk/index.js +2 -0
- package/dist/sdk/node-api-client.js +474 -0
- package/dist/security/approval-assertion.js +66 -0
- package/dist/security/command-completion-registry.js +35 -0
- package/dist/security/command-request.js +12 -0
- package/dist/security/command-result-signature.js +34 -0
- package/dist/security/managed-http.js +45 -0
- package/dist/security/native-completion-registry.js +44 -0
- package/dist/server.js +178 -0
- package/dist/services/admission-fence.js +71 -0
- package/dist/services/ai-assistant-service.js +2523 -0
- package/dist/services/ai-correlation-service.js +225 -0
- package/dist/services/ai-export-service.js +141 -0
- package/dist/services/ai-insights-service.js +219 -0
- package/dist/services/ai-schedule-service.js +145 -0
- package/dist/services/ai-scratchpad-service.js +222 -0
- package/dist/services/ai-tools.js +1343 -0
- package/dist/services/alert-service.js +313 -0
- package/dist/services/anomaly-detector.js +419 -0
- package/dist/services/api-local-work.js +79 -0
- package/dist/services/application-probes.js +309 -0
- package/dist/services/ardent-scope-enrollment.js +123 -0
- package/dist/services/ardent-service.js +86 -0
- package/dist/services/audit-service.js +308 -0
- package/dist/services/codex-service.js +209 -0
- package/dist/services/command-lifecycle.js +60 -0
- package/dist/services/command-resource-leases.js +305 -0
- package/dist/services/control-host-node.js +242 -0
- package/dist/services/credential-rotation-service.js +294 -0
- package/dist/services/dependency-service.js +145 -0
- package/dist/services/disposable-recovery-runner.js +595 -0
- package/dist/services/docker-group-health.js +121 -0
- package/dist/services/engineering-assurance.js +492 -0
- package/dist/services/engineering-evidence-ledger.js +94 -0
- package/dist/services/engineering-metric-evidence.js +26 -0
- package/dist/services/event-bus.js +227 -0
- package/dist/services/fleet-check-log.js +102 -0
- package/dist/services/forecast-service.js +154 -0
- package/dist/services/health-retention.js +175 -0
- package/dist/services/heartbeat-stream.js +63 -0
- package/dist/services/hermes-catalog-import.js +62 -0
- package/dist/services/hermes-cli-parser.js +671 -0
- package/dist/services/hermes-core-rollout.js +90 -0
- package/dist/services/hermes-dashboard-endpoint.js +13 -0
- package/dist/services/hermes-plugin-source.js +149 -0
- package/dist/services/hermes-registry-service.js +258 -0
- package/dist/services/hermes-service.js +566 -0
- package/dist/services/hivemem-client.js +85 -0
- package/dist/services/host-local-writer.js +82 -0
- package/dist/services/incident-evidence.js +110 -0
- package/dist/services/incident-lessons.js +186 -0
- package/dist/services/llm-providers/anthropic.js +143 -0
- package/dist/services/llm-providers/index.js +7 -0
- package/dist/services/llm-providers/llama-cpp.js +237 -0
- package/dist/services/llm-providers/ollama.js +292 -0
- package/dist/services/llm-providers/openai-compatible.js +200 -0
- package/dist/services/llm-providers/provider-error.js +36 -0
- package/dist/services/llm-providers/registry.js +45 -0
- package/dist/services/llm-providers/types.js +2 -0
- package/dist/services/log-emitter.js +19 -0
- package/dist/services/log-retention.js +66 -0
- package/dist/services/maintenance-service.js +29 -0
- package/dist/services/managed-cron.js +493 -0
- package/dist/services/managed-ssh-admission.js +68 -0
- package/dist/services/monitor-pulse.js +10 -0
- package/dist/services/node-issue-monitor.js +71 -0
- package/dist/services/node-service.js +35 -0
- package/dist/services/notification-retention.js +51 -0
- package/dist/services/notification-service.js +94 -0
- package/dist/services/operational-observations.js +112 -0
- package/dist/services/operations-config.js +67 -0
- package/dist/services/ops-service.js +491 -0
- package/dist/services/orchestra-extras-service.js +370 -0
- package/dist/services/orchestra-resources-service.js +530 -0
- package/dist/services/os-scheduler-writer.js +73 -0
- package/dist/services/password-service.js +22 -0
- package/dist/services/prediction-service.js +284 -0
- package/dist/services/recovery-exercises.js +682 -0
- package/dist/services/remediation-service.js +325 -0
- package/dist/services/resource-enrollment.js +433 -0
- package/dist/services/resource-node-lock.js +18 -0
- package/dist/services/resource-participant-work.js +302 -0
- package/dist/services/role-service.js +388 -0
- package/dist/services/rollout-service.js +440 -0
- package/dist/services/security-export.js +185 -0
- package/dist/services/security-fusion-actions.js +22 -0
- package/dist/services/security-fusion-approvals.js +83 -0
- package/dist/services/security-fusion-evidence-integrity.js +144 -0
- package/dist/services/security-fusion-ingest.js +101 -0
- package/dist/services/security-fusion-outbox.js +185 -0
- package/dist/services/security-fusion-receipt-chain.js +134 -0
- package/dist/services/security-fusion-service.js +751 -0
- package/dist/services/security-fusion-verification.js +50 -0
- package/dist/services/self-update-service.js +200 -0
- package/dist/services/shared-resource-leases.js +413 -0
- package/dist/services/skill-publication-bundle.js +90 -0
- package/dist/services/skill-publication-settlement.js +36 -0
- package/dist/services/skill-publication-state.js +40 -0
- package/dist/services/skill-registry-service.js +327 -0
- package/dist/services/skill-service.js +148 -0
- package/dist/services/ssh-exec-service.js +139 -0
- package/dist/services/ssh-host-verification.js +27 -0
- package/dist/services/tailscale-node-key-service.js +75 -0
- package/dist/services/team-approvals.js +118 -0
- package/dist/services/topology-service.js +138 -0
- package/dist/services/transfer-authority-snapshot.js +151 -0
- package/dist/services/webhook-credential-migration.js +97 -0
- package/dist/services/webhook-security.js +242 -0
- package/dist/services/webhook-service.js +494 -0
- package/dist/types/auth.js +3 -0
- package/dist/types/index.js +3 -0
- package/dist/types/library.js +3 -0
- package/dist/types/notifications.js +3 -0
- package/dist/types/roles.js +3 -0
- package/dist/types/shared-contracts.js +3 -0
- package/dist/utils/env.js +141 -0
- package/dist/utils/heartbeat-peer.js +19 -0
- package/dist/utils/idempotency.js +45 -0
- package/dist/utils/ip.js +25 -0
- package/dist/utils/json-fields.js +94 -0
- package/dist/utils/local-tls.js +39 -0
- package/dist/utils/magnus-home.js +15 -0
- package/dist/utils/node-url.js +59 -0
- package/dist/utils/redact.js +26 -0
- package/dist/utils/safe-equal.js +13 -0
- package/dist/utils/sentinel-nodes.js +16 -0
- package/dist/utils/validate.js +41 -0
- package/package.json +119 -4
- package/prisma/migrations/20261031000000_baseline/migration.sql +2935 -0
- package/prisma/migrations/migration_lock.toml +3 -0
- package/prisma/schema.prisma +2185 -0
- 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
|