@apralabs/apra-fleet 0.3.6 → 0.4.1
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/README.md +378 -252
- package/dist/agents/backlog-groomer.md +303 -0
- package/dist/agents/ci-watcher.md +13 -1
- package/dist/agents/deployer.md +66 -13
- package/dist/agents/doer.md +67 -8
- package/dist/agents/harvester.md +22 -3
- package/dist/agents/integ-test-runner.md +166 -60
- package/dist/agents/kb-reconciler.md +216 -0
- package/dist/agents/plan-reviewer.md +88 -18
- package/dist/agents/planner.md +182 -19
- package/dist/agents/regression-test-runner.md +234 -0
- package/dist/agents/reviewer.md +125 -9
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/doer-output.json +63 -3
- package/dist/agents/schemas/harvester-output.json +59 -2
- package/dist/agents/schemas/integ-test-runner-output.json +34 -0
- package/dist/agents/schemas/kb-reconciler-output.json +87 -0
- package/dist/agents/schemas/planner-output.json +65 -0
- package/dist/agents/schemas/regression-test-runner-input.json +15 -0
- package/dist/agents/schemas/regression-test-runner-output.json +50 -0
- package/dist/agents/schemas/reviewer-output.json +108 -7
- package/dist/cli/agent-transform.d.ts +1 -0
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +77 -0
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts +3 -0
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +181 -5
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +5 -1
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +7 -1
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/dolt-install.d.ts +91 -0
- package/dist/cli/dolt-install.d.ts.map +1 -0
- package/dist/cli/dolt-install.js +334 -0
- package/dist/cli/dolt-install.js.map +1 -0
- package/dist/cli/install-guard.d.ts +29 -0
- package/dist/cli/install-guard.d.ts.map +1 -0
- package/dist/cli/install-guard.js +153 -0
- package/dist/cli/install-guard.js.map +1 -0
- package/dist/cli/install.d.ts +45 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +736 -109
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/join.d.ts +12 -0
- package/dist/cli/join.d.ts.map +1 -0
- package/dist/cli/join.js +87 -0
- package/dist/cli/join.js.map +1 -0
- package/dist/cli/kb-commit.d.ts +12 -0
- package/dist/cli/kb-commit.d.ts.map +1 -0
- package/dist/cli/kb-commit.js +53 -0
- package/dist/cli/kb-commit.js.map +1 -0
- package/dist/cli/kb-directives.d.ts +17 -0
- package/dist/cli/kb-directives.d.ts.map +1 -0
- package/dist/cli/kb-directives.js +146 -0
- package/dist/cli/kb-directives.js.map +1 -0
- package/dist/cli/kb-import.d.ts +13 -0
- package/dist/cli/kb-import.d.ts.map +1 -0
- package/dist/cli/kb-import.js +56 -0
- package/dist/cli/kb-import.js.map +1 -0
- package/dist/cli/register-member.d.ts +2 -0
- package/dist/cli/register-member.d.ts.map +1 -0
- package/dist/cli/register-member.js +193 -0
- package/dist/cli/register-member.js.map +1 -0
- package/dist/cli/restart.d.ts +2 -0
- package/dist/cli/restart.d.ts.map +1 -0
- package/dist/cli/restart.js +7 -0
- package/dist/cli/restart.js.map +1 -0
- package/dist/cli/spoke.d.ts +35 -0
- package/dist/cli/spoke.d.ts.map +1 -0
- package/dist/cli/spoke.js +212 -0
- package/dist/cli/spoke.js.map +1 -0
- package/dist/cli/start.d.ts +2 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/cli/start.js +92 -0
- package/dist/cli/start.js.map +1 -0
- package/dist/cli/status.d.ts +2 -0
- package/dist/cli/status.d.ts.map +1 -0
- package/dist/cli/status.js +83 -0
- package/dist/cli/status.js.map +1 -0
- package/dist/cli/stop.d.ts +2 -0
- package/dist/cli/stop.d.ts.map +1 -0
- package/dist/cli/stop.js +51 -0
- package/dist/cli/stop.js.map +1 -0
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +120 -9
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/update.d.ts.map +1 -1
- package/dist/cli/update.js +10 -1
- package/dist/cli/update.js.map +1 -1
- package/dist/cli/watch.d.ts +53 -4
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +118 -17
- package/dist/cli/watch.js.map +1 -1
- package/dist/cli/workflow-assets.d.ts +37 -0
- package/dist/cli/workflow-assets.d.ts.map +1 -0
- package/dist/cli/workflow-assets.js +144 -0
- package/dist/cli/workflow-assets.js.map +1 -0
- package/dist/cli/workflow.d.ts +75 -0
- package/dist/cli/workflow.d.ts.map +1 -0
- package/dist/cli/workflow.js +397 -0
- package/dist/cli/workflow.js.map +1 -0
- package/dist/commands/kb-server.d.ts +8 -0
- package/dist/commands/kb-server.d.ts.map +1 -0
- package/dist/commands/kb-server.js +221 -0
- package/dist/commands/kb-server.js.map +1 -0
- package/dist/hub-service/activity.d.ts +30 -0
- package/dist/hub-service/activity.d.ts.map +1 -0
- package/dist/hub-service/activity.js +20 -0
- package/dist/hub-service/activity.js.map +1 -0
- package/dist/hub-service/audit-log.d.ts +19 -0
- package/dist/hub-service/audit-log.d.ts.map +1 -0
- package/dist/hub-service/audit-log.js +13 -0
- package/dist/hub-service/audit-log.js.map +1 -0
- package/dist/hub-service/db/pool.d.ts +19 -0
- package/dist/hub-service/db/pool.d.ts.map +1 -0
- package/dist/hub-service/db/pool.js +53 -0
- package/dist/hub-service/db/pool.js.map +1 -0
- package/dist/hub-service/enrollment.d.ts +29 -0
- package/dist/hub-service/enrollment.d.ts.map +1 -0
- package/dist/hub-service/enrollment.js +48 -0
- package/dist/hub-service/enrollment.js.map +1 -0
- package/dist/hub-service/envelope-routes.d.ts +46 -0
- package/dist/hub-service/envelope-routes.d.ts.map +1 -0
- package/dist/hub-service/envelope-routes.js +94 -0
- package/dist/hub-service/envelope-routes.js.map +1 -0
- package/dist/hub-service/handlers/installers.d.ts +14 -0
- package/dist/hub-service/handlers/installers.d.ts.map +1 -0
- package/dist/hub-service/handlers/installers.js +8 -0
- package/dist/hub-service/handlers/installers.js.map +1 -0
- package/dist/hub-service/http-server.d.ts +31 -0
- package/dist/hub-service/http-server.d.ts.map +1 -0
- package/dist/hub-service/http-server.js +711 -0
- package/dist/hub-service/http-server.js.map +1 -0
- package/dist/hub-service/hub-jwt.d.ts +30 -0
- package/dist/hub-service/hub-jwt.d.ts.map +1 -0
- package/dist/hub-service/hub-jwt.js +105 -0
- package/dist/hub-service/hub-jwt.js.map +1 -0
- package/dist/hub-service/jwt-revocation.d.ts +20 -0
- package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
- package/dist/hub-service/jwt-revocation.js +18 -0
- package/dist/hub-service/jwt-revocation.js.map +1 -0
- package/dist/hub-service/machines.d.ts +16 -0
- package/dist/hub-service/machines.d.ts.map +1 -0
- package/dist/hub-service/machines.js +14 -0
- package/dist/hub-service/machines.js.map +1 -0
- package/dist/hub-service/main.d.ts +3 -0
- package/dist/hub-service/main.d.ts.map +1 -0
- package/dist/hub-service/main.js +64 -0
- package/dist/hub-service/main.js.map +1 -0
- package/dist/hub-service/member-tokens.d.ts +11 -0
- package/dist/hub-service/member-tokens.d.ts.map +1 -0
- package/dist/hub-service/member-tokens.js +49 -0
- package/dist/hub-service/member-tokens.js.map +1 -0
- package/dist/hub-service/member-view.d.ts +20 -0
- package/dist/hub-service/member-view.d.ts.map +1 -0
- package/dist/hub-service/member-view.js +76 -0
- package/dist/hub-service/member-view.js.map +1 -0
- package/dist/hub-service/members.d.ts +44 -0
- package/dist/hub-service/members.d.ts.map +1 -0
- package/dist/hub-service/members.js +25 -0
- package/dist/hub-service/members.js.map +1 -0
- package/dist/hub-service/presence.d.ts +40 -0
- package/dist/hub-service/presence.d.ts.map +1 -0
- package/dist/hub-service/presence.js +44 -0
- package/dist/hub-service/presence.js.map +1 -0
- package/dist/hub-service/project-view.d.ts +12 -0
- package/dist/hub-service/project-view.d.ts.map +1 -0
- package/dist/hub-service/project-view.js +34 -0
- package/dist/hub-service/project-view.js.map +1 -0
- package/dist/hub-service/projects.d.ts +48 -0
- package/dist/hub-service/projects.d.ts.map +1 -0
- package/dist/hub-service/projects.js +80 -0
- package/dist/hub-service/projects.js.map +1 -0
- package/dist/hub-service/relay-queue.d.ts +115 -0
- package/dist/hub-service/relay-queue.d.ts.map +1 -0
- package/dist/hub-service/relay-queue.js +148 -0
- package/dist/hub-service/relay-queue.js.map +1 -0
- package/dist/hub-service/session-jwt.d.ts +10 -0
- package/dist/hub-service/session-jwt.d.ts.map +1 -0
- package/dist/hub-service/session-jwt.js +69 -0
- package/dist/hub-service/session-jwt.js.map +1 -0
- package/dist/hub-service/usage.d.ts +40 -0
- package/dist/hub-service/usage.d.ts.map +1 -0
- package/dist/hub-service/usage.js +25 -0
- package/dist/hub-service/usage.js.map +1 -0
- package/dist/hub-service/users.d.ts +56 -0
- package/dist/hub-service/users.d.ts.map +1 -0
- package/dist/hub-service/users.js +72 -0
- package/dist/hub-service/users.js.map +1 -0
- package/dist/hub-service/workspaces.d.ts +20 -0
- package/dist/hub-service/workspaces.d.ts.map +1 -0
- package/dist/hub-service/workspaces.js +10 -0
- package/dist/hub-service/workspaces.js.map +1 -0
- package/dist/index.js +254 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +14 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +80 -4
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +15 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +36 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +74 -18
- package/dist/os/windows.js.map +1 -1
- package/dist/paths.d.ts +23 -0
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +29 -0
- package/dist/paths.js.map +1 -1
- package/dist/providers/agy.d.ts +20 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +259 -21
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +16 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +283 -16
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +13 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +36 -6
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +13 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +34 -7
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/email/headers.d.ts +15 -0
- package/dist/providers/email/headers.d.ts.map +1 -0
- package/dist/providers/email/headers.js +42 -0
- package/dist/providers/email/headers.js.map +1 -0
- package/dist/providers/email/index.d.ts +18 -0
- package/dist/providers/email/index.d.ts.map +1 -0
- package/dist/providers/email/index.js +60 -0
- package/dist/providers/email/index.js.map +1 -0
- package/dist/providers/email/provider.d.ts +49 -0
- package/dist/providers/email/provider.d.ts.map +1 -0
- package/dist/providers/email/provider.js +2 -0
- package/dist/providers/email/provider.js.map +1 -0
- package/dist/providers/email/sendgrid.d.ts +12 -0
- package/dist/providers/email/sendgrid.d.ts.map +1 -0
- package/dist/providers/email/sendgrid.js +67 -0
- package/dist/providers/email/sendgrid.js.map +1 -0
- package/dist/providers/email/smtp.d.ts +65 -0
- package/dist/providers/email/smtp.d.ts.map +1 -0
- package/dist/providers/email/smtp.js +373 -0
- package/dist/providers/email/smtp.js.map +1 -0
- package/dist/providers/gemini.d.ts +13 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +49 -5
- package/dist/providers/gemini.js.map +1 -1
- package/dist/providers/index.d.ts +1 -0
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +3 -0
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +61 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +124 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +14 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +104 -4
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +156 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +54 -0
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.d.ts +3 -3
- package/dist/services/agent-provisioner.d.ts.map +1 -1
- package/dist/services/agent-provisioner.js +11 -7
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/auth-socket.d.ts.map +1 -1
- package/dist/services/auth-socket.js +2 -0
- package/dist/services/auth-socket.js.map +1 -1
- package/dist/services/budget-awareness.d.ts +130 -0
- package/dist/services/budget-awareness.d.ts.map +1 -0
- package/dist/services/budget-awareness.js +129 -0
- package/dist/services/budget-awareness.js.map +1 -0
- package/dist/services/cloud/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +3 -0
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/cloud/task-wrapper.d.ts +18 -0
- package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
- package/dist/services/cloud/task-wrapper.js +157 -0
- package/dist/services/cloud/task-wrapper.js.map +1 -1
- package/dist/services/cloud-sync.d.ts +35 -0
- package/dist/services/cloud-sync.d.ts.map +1 -0
- package/dist/services/cloud-sync.js +90 -0
- package/dist/services/cloud-sync.js.map +1 -0
- package/dist/services/context-admission.d.ts +82 -0
- package/dist/services/context-admission.d.ts.map +1 -0
- package/dist/services/context-admission.js +136 -0
- package/dist/services/context-admission.js.map +1 -0
- package/dist/services/event-bus.d.ts +27 -0
- package/dist/services/event-bus.d.ts.map +1 -0
- package/dist/services/event-bus.js +20 -0
- package/dist/services/event-bus.js.map +1 -0
- package/dist/services/file-chunker.d.ts +38 -0
- package/dist/services/file-chunker.d.ts.map +1 -0
- package/dist/services/file-chunker.js +63 -0
- package/dist/services/file-chunker.js.map +1 -0
- package/dist/services/file-transfer-relay.d.ts +55 -0
- package/dist/services/file-transfer-relay.d.ts.map +1 -0
- package/dist/services/file-transfer-relay.js +115 -0
- package/dist/services/file-transfer-relay.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +12 -2
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +25 -0
- package/dist/services/http-transport.d.ts.map +1 -0
- package/dist/services/http-transport.js +371 -0
- package/dist/services/http-transport.js.map +1 -0
- package/dist/services/hub-client.d.ts +69 -0
- package/dist/services/hub-client.d.ts.map +1 -0
- package/dist/services/hub-client.js +217 -0
- package/dist/services/hub-client.js.map +1 -0
- package/dist/services/jwt.d.ts +17 -0
- package/dist/services/jwt.d.ts.map +1 -0
- package/dist/services/jwt.js +70 -0
- package/dist/services/jwt.js.map +1 -0
- package/dist/services/knowledge/audn.d.ts +37 -0
- package/dist/services/knowledge/audn.d.ts.map +1 -0
- package/dist/services/knowledge/audn.js +219 -0
- package/dist/services/knowledge/audn.js.map +1 -0
- package/dist/services/knowledge/file-hash.d.ts +11 -0
- package/dist/services/knowledge/file-hash.d.ts.map +1 -0
- package/dist/services/knowledge/file-hash.js +123 -0
- package/dist/services/knowledge/file-hash.js.map +1 -0
- package/dist/services/knowledge/http-provider.d.ts +46 -0
- package/dist/services/knowledge/http-provider.d.ts.map +1 -0
- package/dist/services/knowledge/http-provider.js +254 -0
- package/dist/services/knowledge/http-provider.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +15 -0
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
- package/dist/services/knowledge/kb-providers.js +92 -0
- package/dist/services/knowledge/kb-providers.js.map +1 -0
- package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
- package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
- package/dist/services/knowledge/kb-scope-input.js +11 -0
- package/dist/services/knowledge/kb-scope-input.js.map +1 -0
- package/dist/services/knowledge/kb-service.d.ts +3 -0
- package/dist/services/knowledge/kb-service.d.ts.map +1 -0
- package/dist/services/knowledge/kb-service.js +2 -0
- package/dist/services/knowledge/kb-service.js.map +1 -0
- package/dist/services/knowledge/path-validation.d.ts +2 -0
- package/dist/services/knowledge/path-validation.d.ts.map +1 -0
- package/dist/services/knowledge/path-validation.js +13 -0
- package/dist/services/knowledge/path-validation.js.map +1 -0
- package/dist/services/knowledge/pre-init.d.ts +14 -0
- package/dist/services/knowledge/pre-init.d.ts.map +1 -0
- package/dist/services/knowledge/pre-init.js +147 -0
- package/dist/services/knowledge/pre-init.js.map +1 -0
- package/dist/services/knowledge/project-slug.d.ts +2 -0
- package/dist/services/knowledge/project-slug.d.ts.map +1 -0
- package/dist/services/knowledge/project-slug.js +49 -0
- package/dist/services/knowledge/project-slug.js.map +1 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
- package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
- package/dist/services/knowledge/sqlite-provider.js +1646 -0
- package/dist/services/knowledge/sqlite-provider.js.map +1 -0
- package/dist/services/knowledge/types.d.ts +163 -0
- package/dist/services/knowledge/types.d.ts.map +1 -0
- package/dist/services/knowledge/types.js +9 -0
- package/dist/services/knowledge/types.js.map +1 -0
- package/dist/services/known-sessions.d.ts +8 -0
- package/dist/services/known-sessions.d.ts.map +1 -0
- package/dist/services/known-sessions.js +40 -0
- package/dist/services/known-sessions.js.map +1 -0
- package/dist/services/member-home.d.ts +89 -0
- package/dist/services/member-home.d.ts.map +1 -0
- package/dist/services/member-home.js +256 -0
- package/dist/services/member-home.js.map +1 -0
- package/dist/services/member-remote-url.d.ts +34 -0
- package/dist/services/member-remote-url.d.ts.map +1 -0
- package/dist/services/member-remote-url.js +39 -0
- package/dist/services/member-remote-url.js.map +1 -0
- package/dist/services/model-pricing.d.ts +36 -0
- package/dist/services/model-pricing.d.ts.map +1 -0
- package/dist/services/model-pricing.js +108 -0
- package/dist/services/model-pricing.js.map +1 -0
- package/dist/services/orphan-recovery.d.ts +59 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +122 -0
- package/dist/services/orphan-recovery.js.map +1 -0
- package/dist/services/pending-responses.d.ts +23 -0
- package/dist/services/pending-responses.d.ts.map +1 -0
- package/dist/services/pending-responses.js +52 -0
- package/dist/services/pending-responses.js.map +1 -0
- package/dist/services/preflight-check.d.ts +56 -0
- package/dist/services/preflight-check.d.ts.map +1 -0
- package/dist/services/preflight-check.js +277 -0
- package/dist/services/preflight-check.js.map +1 -0
- package/dist/services/registry.d.ts +4 -1
- package/dist/services/registry.d.ts.map +1 -1
- package/dist/services/registry.js +3 -0
- package/dist/services/registry.js.map +1 -1
- package/dist/services/relay-context.d.ts +23 -0
- package/dist/services/relay-context.d.ts.map +1 -0
- package/dist/services/relay-context.js +8 -0
- package/dist/services/relay-context.js.map +1 -0
- package/dist/services/relay-executor.d.ts +68 -0
- package/dist/services/relay-executor.d.ts.map +1 -0
- package/dist/services/relay-executor.js +70 -0
- package/dist/services/relay-executor.js.map +1 -0
- package/dist/services/relay-request.d.ts +65 -0
- package/dist/services/relay-request.d.ts.map +1 -0
- package/dist/services/relay-request.js +129 -0
- package/dist/services/relay-request.js.map +1 -0
- package/dist/services/relay-strategy.d.ts +19 -0
- package/dist/services/relay-strategy.d.ts.map +1 -0
- package/dist/services/relay-strategy.js +111 -0
- package/dist/services/relay-strategy.js.map +1 -0
- package/dist/services/service-manager/index.d.ts +5 -0
- package/dist/services/service-manager/index.d.ts.map +1 -0
- package/dist/services/service-manager/index.js +66 -0
- package/dist/services/service-manager/index.js.map +1 -0
- package/dist/services/service-manager/linux.d.ts +10 -0
- package/dist/services/service-manager/linux.d.ts.map +1 -0
- package/dist/services/service-manager/linux.js +97 -0
- package/dist/services/service-manager/linux.js.map +1 -0
- package/dist/services/service-manager/macos.d.ts +10 -0
- package/dist/services/service-manager/macos.d.ts.map +1 -0
- package/dist/services/service-manager/macos.js +94 -0
- package/dist/services/service-manager/macos.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +18 -0
- package/dist/services/service-manager/types.d.ts.map +1 -0
- package/dist/services/service-manager/types.js +5 -0
- package/dist/services/service-manager/types.js.map +1 -0
- package/dist/services/service-manager/windows.d.ts +10 -0
- package/dist/services/service-manager/windows.d.ts.map +1 -0
- package/dist/services/service-manager/windows.js +73 -0
- package/dist/services/service-manager/windows.js.map +1 -0
- package/dist/services/session-registry.d.ts +70 -0
- package/dist/services/session-registry.d.ts.map +1 -0
- package/dist/services/session-registry.js +91 -0
- package/dist/services/session-registry.js.map +1 -0
- package/dist/services/singleton.d.ts +15 -0
- package/dist/services/singleton.d.ts.map +1 -0
- package/dist/services/singleton.js +98 -0
- package/dist/services/singleton.js.map +1 -0
- package/dist/services/sprint-coordination.d.ts +168 -0
- package/dist/services/sprint-coordination.d.ts.map +1 -0
- package/dist/services/sprint-coordination.js +564 -0
- package/dist/services/sprint-coordination.js.map +1 -0
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +70 -3
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/log-path-resolver.d.ts +11 -8
- package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
- package/dist/services/stall/log-path-resolver.js +17 -33
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +32 -0
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +187 -12
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +50 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +268 -18
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +57 -7
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.d.ts +20 -0
- package/dist/services/substitution-engine.d.ts.map +1 -0
- package/dist/services/substitution-engine.js +92 -0
- package/dist/services/substitution-engine.js.map +1 -0
- package/dist/services/task-cleanup.d.ts.map +1 -1
- package/dist/services/task-cleanup.js +1 -9
- package/dist/services/task-cleanup.js.map +1 -1
- package/dist/services/token-issuer.d.ts +47 -0
- package/dist/services/token-issuer.d.ts.map +1 -0
- package/dist/services/token-issuer.js +63 -0
- package/dist/services/token-issuer.js.map +1 -0
- package/dist/services/tool-registry.d.ts +3 -0
- package/dist/services/tool-registry.d.ts.map +1 -0
- package/dist/services/tool-registry.js +225 -0
- package/dist/services/tool-registry.js.map +1 -0
- package/dist/services/user-config.d.ts +14 -0
- package/dist/services/user-config.d.ts.map +1 -1
- package/dist/services/user-config.js +55 -0
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +32 -1
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +44 -0
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/services/version-check.d.ts +22 -0
- package/dist/services/version-check.d.ts.map +1 -0
- package/dist/services/version-check.js +103 -0
- package/dist/services/version-check.js.map +1 -0
- package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
- package/dist/skills/pm/beads.md +6 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/skills/pm/fleet-addendum.md +6 -0
- package/dist/skills/pm/index.md +56 -0
- package/dist/skills/pm/kb-reconcile.md +132 -0
- package/dist/skills/pm/kb-review.md +109 -0
- package/dist/tools/check-status.d.ts +47 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +250 -2
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/child-id-allocator.d.ts +45 -0
- package/dist/tools/child-id-allocator.d.ts.map +1 -0
- package/dist/tools/child-id-allocator.js +62 -0
- package/dist/tools/child-id-allocator.js.map +1 -0
- package/dist/tools/cloud-control.d.ts +2 -2
- package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
- package/dist/tools/code-intelligence-codebase-memory.js +270 -0
- package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
- package/dist/tools/code-intelligence-freshness.d.ts +2 -0
- package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
- package/dist/tools/code-intelligence-freshness.js +26 -0
- package/dist/tools/code-intelligence-freshness.js.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.js +475 -0
- package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.js +65 -0
- package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
- package/dist/tools/code-intelligence-reindex.d.ts +7 -0
- package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
- package/dist/tools/code-intelligence-reindex.js +106 -0
- package/dist/tools/code-intelligence-reindex.js.map +1 -0
- package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
- package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
- package/dist/tools/code-intelligence-telemetry.js +52 -0
- package/dist/tools/code-intelligence-telemetry.js.map +1 -0
- package/dist/tools/code-intelligence-tests.d.ts +2 -0
- package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
- package/dist/tools/code-intelligence-tests.js +24 -0
- package/dist/tools/code-intelligence-tests.js.map +1 -0
- package/dist/tools/code-intelligence.d.ts +114 -0
- package/dist/tools/code-intelligence.d.ts.map +1 -0
- package/dist/tools/code-intelligence.js +124 -0
- package/dist/tools/code-intelligence.js.map +1 -0
- package/dist/tools/compose-permissions.d.ts +38 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +295 -33
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/dolt-push-mutex.d.ts +44 -0
- package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
- package/dist/tools/dolt-push-mutex.js +83 -0
- package/dist/tools/dolt-push-mutex.js.map +1 -0
- package/dist/tools/execute-command.d.ts +13 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +108 -21
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +84 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +1191 -88
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/get-member-model-pricing.d.ts +21 -0
- package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
- package/dist/tools/get-member-model-pricing.js +29 -0
- package/dist/tools/get-member-model-pricing.js.map +1 -0
- package/dist/tools/kb-capture.d.ts +53 -0
- package/dist/tools/kb-capture.d.ts.map +1 -0
- package/dist/tools/kb-capture.js +130 -0
- package/dist/tools/kb-capture.js.map +1 -0
- package/dist/tools/kb-context.d.ts +17 -0
- package/dist/tools/kb-context.d.ts.map +1 -0
- package/dist/tools/kb-context.js +29 -0
- package/dist/tools/kb-context.js.map +1 -0
- package/dist/tools/kb-export.d.ts +19 -0
- package/dist/tools/kb-export.d.ts.map +1 -0
- package/dist/tools/kb-export.js +344 -0
- package/dist/tools/kb-export.js.map +1 -0
- package/dist/tools/kb-feedback.d.ts +23 -0
- package/dist/tools/kb-feedback.d.ts.map +1 -0
- package/dist/tools/kb-feedback.js +43 -0
- package/dist/tools/kb-feedback.js.map +1 -0
- package/dist/tools/kb-freshness-sweep.d.ts +14 -0
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
- package/dist/tools/kb-freshness-sweep.js +29 -0
- package/dist/tools/kb-freshness-sweep.js.map +1 -0
- package/dist/tools/kb-harvest.d.ts +20 -0
- package/dist/tools/kb-harvest.d.ts.map +1 -0
- package/dist/tools/kb-harvest.js +143 -0
- package/dist/tools/kb-harvest.js.map +1 -0
- package/dist/tools/kb-import.d.ts +44 -0
- package/dist/tools/kb-import.d.ts.map +1 -0
- package/dist/tools/kb-import.js +239 -0
- package/dist/tools/kb-import.js.map +1 -0
- package/dist/tools/kb-invalidate.d.ts +19 -0
- package/dist/tools/kb-invalidate.d.ts.map +1 -0
- package/dist/tools/kb-invalidate.js +34 -0
- package/dist/tools/kb-invalidate.js.map +1 -0
- package/dist/tools/kb-list.d.ts +32 -0
- package/dist/tools/kb-list.d.ts.map +1 -0
- package/dist/tools/kb-list.js +43 -0
- package/dist/tools/kb-list.js.map +1 -0
- package/dist/tools/kb-promote.d.ts +20 -0
- package/dist/tools/kb-promote.d.ts.map +1 -0
- package/dist/tools/kb-promote.js +20 -0
- package/dist/tools/kb-promote.js.map +1 -0
- package/dist/tools/kb-query.d.ts +35 -0
- package/dist/tools/kb-query.d.ts.map +1 -0
- package/dist/tools/kb-query.js +111 -0
- package/dist/tools/kb-query.js.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.js +26 -0
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
- package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
- package/dist/tools/kb-resolve-contradiction.js +37 -0
- package/dist/tools/kb-resolve-contradiction.js.map +1 -0
- package/dist/tools/kb-session-prime.d.ts +26 -0
- package/dist/tools/kb-session-prime.d.ts.map +1 -0
- package/dist/tools/kb-session-prime.js +392 -0
- package/dist/tools/kb-session-prime.js.map +1 -0
- package/dist/tools/kb-setup.d.ts +20 -0
- package/dist/tools/kb-setup.d.ts.map +1 -0
- package/dist/tools/kb-setup.js +49 -0
- package/dist/tools/kb-setup.js.map +1 -0
- package/dist/tools/kb-stats.d.ts +20 -0
- package/dist/tools/kb-stats.d.ts.map +1 -0
- package/dist/tools/kb-stats.js +115 -0
- package/dist/tools/kb-stats.js.map +1 -0
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +39 -7
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +1 -1
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +16 -2
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +29 -0
- package/dist/tools/member-reservation.d.ts.map +1 -0
- package/dist/tools/member-reservation.js +71 -0
- package/dist/tools/member-reservation.js.map +1 -0
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +21 -3
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +10 -3
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +7 -7
- package/dist/tools/provision-vcs-auth.js +1 -1
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +20 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +174 -6
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +17 -3
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/report-status.d.ts +33 -0
- package/dist/tools/report-status.d.ts.map +1 -0
- package/dist/tools/report-status.js +45 -0
- package/dist/tools/report-status.js.map +1 -0
- package/dist/tools/respond-to-message.d.ts +21 -0
- package/dist/tools/respond-to-message.d.ts.map +1 -0
- package/dist/tools/respond-to-message.js +23 -0
- package/dist/tools/respond-to-message.js.map +1 -0
- package/dist/tools/send-email.d.ts +69 -0
- package/dist/tools/send-email.d.ts.map +1 -0
- package/dist/tools/send-email.js +177 -0
- package/dist/tools/send-email.js.map +1 -0
- package/dist/tools/send-files.d.ts +3 -0
- package/dist/tools/send-files.d.ts.map +1 -1
- package/dist/tools/send-files.js +88 -8
- package/dist/tools/send-files.js.map +1 -1
- package/dist/tools/send-message.d.ts +27 -0
- package/dist/tools/send-message.d.ts.map +1 -0
- package/dist/tools/send-message.js +46 -0
- package/dist/tools/send-message.js.map +1 -0
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -0
- package/dist/tools/setup-ssh-key.js.map +1 -1
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.d.ts.map +1 -1
- package/dist/tools/shutdown-server.js +19 -0
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/update-member.d.ts +11 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +36 -2
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +16 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +2 -1
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +7 -2
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/pid-helpers.d.ts +15 -0
- package/dist/utils/pid-helpers.d.ts.map +1 -1
- package/dist/utils/pid-helpers.js +23 -0
- package/dist/utils/pid-helpers.js.map +1 -1
- package/dist/utils/process-utils.d.ts +3 -0
- package/dist/utils/process-utils.d.ts.map +1 -0
- package/dist/utils/process-utils.js +42 -0
- package/dist/utils/process-utils.js.map +1 -0
- package/dist/utils/prompt-errors.d.ts +2 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +13 -3
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/session-caller.d.ts +28 -0
- package/dist/utils/session-caller.d.ts.map +1 -0
- package/dist/utils/session-caller.js +24 -0
- package/dist/utils/session-caller.js.map +1 -0
- package/dist/utils/work-folder-validation.d.ts +39 -0
- package/dist/utils/work-folder-validation.d.ts.map +1 -0
- package/dist/utils/work-folder-validation.js +60 -0
- package/dist/utils/work-folder-validation.js.map +1 -0
- package/dist/utils/workspace-trust.d.ts +24 -0
- package/dist/utils/workspace-trust.d.ts.map +1 -0
- package/dist/utils/workspace-trust.js +35 -0
- package/dist/utils/workspace-trust.js.map +1 -0
- package/dist/workflows/auto-sprint.js +994 -91
- package/package.json +40 -9
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +510 -0
- package/packages/apra-fleet-client/src/client/client.mjs +146 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
- package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
- package/packages/apra-fleet-se/apra-pm/version.json +3 -0
- package/packages/apra-fleet-se/bin/cli.mjs +864 -0
- package/packages/apra-fleet-se/bin/serve.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
- package/packages/apra-fleet-se/package.json +29 -0
- package/packages/apra-fleet-se/workflow.json +1 -0
- package/packages/apra-fleet-workflow/package.json +30 -0
- package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
- package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
- package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
- package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
- package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
- package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
- package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
- package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
- package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
- package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
- package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
- package/scripts/agy-transcript-reader.js +1 -0
- package/scripts/fleet-statusline.sh +17 -13
- package/skills/fleet/SKILL.md +37 -2
- package/skills/fleet/beads.md +14 -7
- package/skills/fleet/knowledge-agent.md +66 -0
- package/skills/fleet/permissions.md +76 -2
- package/skills/fleet/profiles/base-dev.json +11 -1
- package/skills/fleet/profiles/base-reviewer.json +9 -1
- package/skills/fleet/profiles/node.json +2 -2
- package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
- package/version.json +1 -1
- package/scripts/agy-settings-merge.js +0 -27
- /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DoltVCS -- the Dolt (beads-sync) provider for VCSModule.classifyFailure()
|
|
3
|
+
* (apra-fleet-647.1.3.2).
|
|
4
|
+
*
|
|
5
|
+
* `extends: null` DELIBERATELY -- this does NOT extend GenericGitVCS or
|
|
6
|
+
* GitHubVCS. classifyFailure()'s inheritance walk is ADDITIVE (a provider's
|
|
7
|
+
* own rules are checked FIRST, but every ancestor's rules are still checked
|
|
8
|
+
* too), so extending either would import git-flavored TRANSIENT texts
|
|
9
|
+
* ('fetch failed', 'transport failure while executing command',
|
|
10
|
+
* 'ssh_exchange_identification', ...) into Dolt's classification. Those
|
|
11
|
+
* strings classify 'unknown' (never retried) for dolt today; silently
|
|
12
|
+
* widening TRANSIENT would change that verdict, which apra-fleet-647.1.3.2
|
|
13
|
+
* AC3 (no verdict change) forbids. Every table below is therefore dolt's OWN
|
|
14
|
+
* copy, even where it duplicates a GenericGitVCS/GitHubVCS pattern verbatim
|
|
15
|
+
* (the 8 shared auth literals) -- see generic-git.mjs's "DELIBERATELY NOT
|
|
16
|
+
* FOLDED IN" note, which named this exact tradeoff in advance.
|
|
17
|
+
*
|
|
18
|
+
* PARITY CONSTRAINT: every regex table here is dolt-sync.mjs's own
|
|
19
|
+
* DOLT_*_PATTERNS verbatim (apra-fleet-417.3.1's classifyDoltFailure), so
|
|
20
|
+
* dolt-sync.mjs can delegate to VCSModule.classifyFailure(raw, {provider:
|
|
21
|
+
* 'dolt'}) with NO verdict change.
|
|
22
|
+
*
|
|
23
|
+
* PRECEDENCE (apra-fleet-spp / apra-fleet-417.3.1): no-remote, empty-remote
|
|
24
|
+
* and remote-unreachable are checked first (each is a distinct benign/fatal
|
|
25
|
+
* non-error condition that must win over a looser downstream pattern), THEN
|
|
26
|
+
* auth, THEN diverged, THEN transient -- auth is deliberately checked BEFORE
|
|
27
|
+
* diverged here (the OPPOSITE of GenericGitVCS/GitHubVCS's default
|
|
28
|
+
* DIVERGED-before-AUTH order): a live incident (2026-08-02, fleet-mac) had a
|
|
29
|
+
* `could not read Username for` credential failure misclassified as data
|
|
30
|
+
* divergence by a looser conflict pattern and hard-aborted an otherwise
|
|
31
|
+
* healthy sprint, when the fix was simply to re-provision credentials. A
|
|
32
|
+
* credential failure must never reach 'diverged' for dolt.
|
|
33
|
+
*
|
|
34
|
+
* PURITY: non-global regexes only -- see the note in ./generic-git.mjs.
|
|
35
|
+
*
|
|
36
|
+
* ASCII only.
|
|
37
|
+
*/
|
|
38
|
+
|
|
39
|
+
import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
|
|
40
|
+
|
|
41
|
+
/** Verbatim DOLT_NO_REMOTE_PATTERNS. */
|
|
42
|
+
const NO_REMOTE = [
|
|
43
|
+
/error 1105.*no remote/i,
|
|
44
|
+
/\bno remote\b/i,
|
|
45
|
+
];
|
|
46
|
+
|
|
47
|
+
/** Verbatim DOLT_EMPTY_REMOTE_PATTERNS. */
|
|
48
|
+
const EMPTY_REMOTE = [
|
|
49
|
+
/error 1105.*no branches found in remote/i,
|
|
50
|
+
/no branches found in remote/i,
|
|
51
|
+
];
|
|
52
|
+
|
|
53
|
+
/** Verbatim DOLT_REMOTE_UNREACHABLE_PATTERNS. */
|
|
54
|
+
const REMOTE_UNREACHABLE = [
|
|
55
|
+
/could not be accessed/i,
|
|
56
|
+
/failed to get remote db/i,
|
|
57
|
+
/stat [^:]+: no such file or directory/i,
|
|
58
|
+
];
|
|
59
|
+
|
|
60
|
+
/** Verbatim DOLT_AUTH_PATTERNS. dolt-sync.mjs's classifyDoltFailure returns a
|
|
61
|
+
* single undifferentiated 'auth' (no AUTH_EXPIRED/AUTH_DENIED split), so
|
|
62
|
+
* every one of these -- including the publickey-refusal literal -- lands in
|
|
63
|
+
* AUTH_EXPIRED here; toDoltVerdict() collapses both AUTH_* kinds back to
|
|
64
|
+
* 'auth' regardless, so this bucketing is verdict-neutral. */
|
|
65
|
+
const AUTH_EXPIRED = [
|
|
66
|
+
/could not read Username for/i,
|
|
67
|
+
/could not read Password for/i,
|
|
68
|
+
/Authentication failed/i,
|
|
69
|
+
/Permission denied \(publickey\)/i,
|
|
70
|
+
/remote: Invalid username or (token|password)/i,
|
|
71
|
+
/terminal prompts disabled/i,
|
|
72
|
+
/support for password authentication was removed/i,
|
|
73
|
+
/Bad credentials/i,
|
|
74
|
+
];
|
|
75
|
+
|
|
76
|
+
/** Verbatim DOLT_DIVERGED_PATTERNS. */
|
|
77
|
+
const DIVERGED = [
|
|
78
|
+
/conflict/i,
|
|
79
|
+
/would (be )?overwrit/i,
|
|
80
|
+
/cannot fast[- ]forward/i,
|
|
81
|
+
/not possible to fast[- ]forward/i,
|
|
82
|
+
/non-fast-forward/i,
|
|
83
|
+
/\[rejected\]/i,
|
|
84
|
+
/failed to push/i,
|
|
85
|
+
/updates were rejected/i,
|
|
86
|
+
/remote (is )?ahead/i,
|
|
87
|
+
/behind the remote/i,
|
|
88
|
+
/not up[- ]to[- ]date/i,
|
|
89
|
+
/have diverged/i,
|
|
90
|
+
/merge (is )?required/i,
|
|
91
|
+
/working set (is )?not clean/i,
|
|
92
|
+
];
|
|
93
|
+
|
|
94
|
+
/** Verbatim DOLT_TRANSIENT_PATTERNS. */
|
|
95
|
+
const TRANSIENT = [
|
|
96
|
+
/could not resolve host/i,
|
|
97
|
+
/unable to (access|connect)/i,
|
|
98
|
+
/connection (timed out|reset|refused)/i,
|
|
99
|
+
/operation timed out/i,
|
|
100
|
+
/\btimed out\b/i,
|
|
101
|
+
/\btimeout\b/i,
|
|
102
|
+
/temporary failure/i,
|
|
103
|
+
/early eof/i,
|
|
104
|
+
/rpc failed/i,
|
|
105
|
+
/the remote end hung up/i,
|
|
106
|
+
/server (is )?(starting|not ready|unavailable)/i,
|
|
107
|
+
/connection refused/i,
|
|
108
|
+
/dial tcp/i,
|
|
109
|
+
/i\/o timeout/i,
|
|
110
|
+
/database is locked/i,
|
|
111
|
+
/lock/i,
|
|
112
|
+
];
|
|
113
|
+
|
|
114
|
+
const PRECEDENCE = Object.freeze([
|
|
115
|
+
K.NO_REMOTE,
|
|
116
|
+
K.EMPTY_REMOTE,
|
|
117
|
+
K.REMOTE_UNREACHABLE,
|
|
118
|
+
K.AUTH_EXPIRED,
|
|
119
|
+
K.AUTH_DENIED,
|
|
120
|
+
K.DIVERGED,
|
|
121
|
+
K.TRANSIENT,
|
|
122
|
+
]);
|
|
123
|
+
|
|
124
|
+
export const DoltVCS = Object.freeze({
|
|
125
|
+
name: 'dolt',
|
|
126
|
+
extends: null,
|
|
127
|
+
precedence: PRECEDENCE,
|
|
128
|
+
rules: Object.freeze({
|
|
129
|
+
[K.NO_REMOTE]: NO_REMOTE,
|
|
130
|
+
[K.EMPTY_REMOTE]: EMPTY_REMOTE,
|
|
131
|
+
[K.REMOTE_UNREACHABLE]: REMOTE_UNREACHABLE,
|
|
132
|
+
[K.AUTH_EXPIRED]: AUTH_EXPIRED,
|
|
133
|
+
[K.DIVERGED]: DIVERGED,
|
|
134
|
+
[K.TRANSIENT]: TRANSIENT,
|
|
135
|
+
}),
|
|
136
|
+
/** Dolt stderr carries no vendor error code today. */
|
|
137
|
+
extractProviderCode() {
|
|
138
|
+
return null;
|
|
139
|
+
},
|
|
140
|
+
// Deliberately NO matchesHost/capabilitiesForHost: Dolt is a beads-sync
|
|
141
|
+
// backend, not a git-remote PR-hosting provider, so it must never be a
|
|
142
|
+
// candidate in VCSModule.capabilities()'s host dispatch
|
|
143
|
+
// (resolveVcsProviderForHost skips any provider with no matchesHost).
|
|
144
|
+
});
|
|
145
|
+
|
|
146
|
+
export default DoltVCS;
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GenericGitVCS -- the portable base provider for VCSModule.classifyFailure().
|
|
3
|
+
*
|
|
4
|
+
* Owns ONLY the texts any git/OpenSSH client emits regardless of who hosts the
|
|
5
|
+
* remote. Anything with a vendor's name, product literal or error code in it
|
|
6
|
+
* belongs in that vendor's provider file (see ./github.mjs), never here.
|
|
7
|
+
*
|
|
8
|
+
* Every provider file has this exact shape, and adding a provider means adding
|
|
9
|
+
* one more file like it (plus one registration line in ./index.mjs) -- never a
|
|
10
|
+
* change to classifyFailure's dispatch contract:
|
|
11
|
+
*
|
|
12
|
+
* {
|
|
13
|
+
* name: string // the `provider` value callers pass
|
|
14
|
+
* extends: string|null // provider whose rules are inherited
|
|
15
|
+
* rules: { [VCS_FAILURE_KIND]: RegExp[] }
|
|
16
|
+
* precedence: string[]|undefined // optional kind-check order override
|
|
17
|
+
* extractProviderCode: (raw) => string|null
|
|
18
|
+
* }
|
|
19
|
+
*
|
|
20
|
+
* PURITY: every regex here is non-global on purpose. A module-level /g regex
|
|
21
|
+
* retains `lastIndex` between calls, which would make classifyFailure return
|
|
22
|
+
* different answers for the same input on successive calls.
|
|
23
|
+
*
|
|
24
|
+
* PARITY CONSTRAINT (apra-fleet-647.1.3.1 AC2): the DIVERGED and TRANSIENT
|
|
25
|
+
* tables below are runner.js's GIT_DIVERGED_PATTERNS / GIT_TRANSIENT_PATTERNS
|
|
26
|
+
* verbatim, and the AUTH tables are the six PORTABLE members of
|
|
27
|
+
* GIT_AUTH_PATTERNS / DOLT_AUTH_PATTERNS (those two lists are identical; their
|
|
28
|
+
* two remaining members are GitHub literals and live in ./github.mjs). This is
|
|
29
|
+
* what lets apra-fleet-647.1.3.2 delete those tables and delegate with no
|
|
30
|
+
* verdict change.
|
|
31
|
+
*
|
|
32
|
+
* DELIBERATELY NOT FOLDED IN: dolt-sync.mjs's DOLT_TRANSIENT_PATTERNS is
|
|
33
|
+
* BROADER than the git set (bare /lock/i, /database is locked/i, /dial tcp/i,
|
|
34
|
+
* /connection refused/i, /server (is )?(starting|not ready|unavailable)/i,
|
|
35
|
+
* /unable to (access|connect)/i), and dolt has two extra classes with no
|
|
36
|
+
* neutral kind yet (empty-remote, remote-unreachable). Folding dolt's wider
|
|
37
|
+
* transient set in here would silently widen GIT classification -- a git stderr
|
|
38
|
+
* merely containing "lock" is 'unknown' (never retried) today and would start
|
|
39
|
+
* being retried. A dolt delegation must add its own provider file and the two
|
|
40
|
+
* missing kinds; it must not widen this one.
|
|
41
|
+
*
|
|
42
|
+
* ASCII only.
|
|
43
|
+
*/
|
|
44
|
+
|
|
45
|
+
import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
|
|
46
|
+
|
|
47
|
+
/** Non-fast-forward / unmerged / conflicted. Verbatim GIT_DIVERGED_PATTERNS. */
|
|
48
|
+
const DIVERGED = [
|
|
49
|
+
/not possible to fast-forward/i,
|
|
50
|
+
/non-fast-forward/i,
|
|
51
|
+
/fast-forwards? are not allowed/i,
|
|
52
|
+
/\[rejected\]/i,
|
|
53
|
+
/failed to push some refs/i,
|
|
54
|
+
/updates were rejected/i,
|
|
55
|
+
/unmerged/i,
|
|
56
|
+
/needs merge/i,
|
|
57
|
+
/would be overwritten/i,
|
|
58
|
+
/^conflict/im,
|
|
59
|
+
/automatic merge failed/i,
|
|
60
|
+
/have diverged/i,
|
|
61
|
+
];
|
|
62
|
+
|
|
63
|
+
/** Credential missing / stale / rejected as invalid -- re-provisioning can fix
|
|
64
|
+
* it. git and OpenSSH emit all of these with no vendor involvement: the first
|
|
65
|
+
* three are git's credential-helper prompts (or their suppression), and the
|
|
66
|
+
* last is git's own refusal text for basic-auth-over-HTTPS.
|
|
67
|
+
*
|
|
68
|
+
* apra-fleet-417.6: 'remote: 401 Unauthorized' is Gitea's literal in the
|
|
69
|
+
* 647.1.3 epic's provider list, but the text itself is a bare HTTP status
|
|
70
|
+
* with no vendor name or product literal in it -- exactly the kind of entry
|
|
71
|
+
* this file's header says belongs here rather than in a dedicated
|
|
72
|
+
* gitea.mjs. HTTP's own semantics pick the AUTH_* split: 401 means "you did
|
|
73
|
+
* not authenticate" (no/expired/invalid credential -- re-provisioning is the
|
|
74
|
+
* fix), as opposed to 403 ("you authenticated fine, but you may not do
|
|
75
|
+
* this" -- see AUTH_DENIED below). No dedicated Gitea provider file/registry
|
|
76
|
+
* entry is added for this: registering a classification-only 'gitea'
|
|
77
|
+
* provider would flip buildVcsCommand()'s unknown-provider error for it from
|
|
78
|
+
* "unsupported VCS provider" to "does not yet implement action", which is
|
|
79
|
+
* not this bead's scope. */
|
|
80
|
+
const AUTH_EXPIRED = [
|
|
81
|
+
/could not read Username for/i,
|
|
82
|
+
/could not read Password for/i,
|
|
83
|
+
/terminal prompts disabled/i,
|
|
84
|
+
/Authentication failed/i,
|
|
85
|
+
/support for password authentication was removed/i,
|
|
86
|
+
/remote:\s*401 Unauthorized/i,
|
|
87
|
+
];
|
|
88
|
+
|
|
89
|
+
/** Identity understood, access refused. OpenSSH offered a key and the server
|
|
90
|
+
* rejected it: minting the same credential again cannot help.
|
|
91
|
+
*
|
|
92
|
+
* apra-fleet-417.6: 'remote: HTTP Basic: Access denied' is GitLab's literal
|
|
93
|
+
* in the 647.1.3 epic's provider list, but -- same rationale as the 401
|
|
94
|
+
* entry above -- it names no vendor and is the generic Apache/git-http-
|
|
95
|
+
* backend basic-auth refusal text, so it lives here rather than in a
|
|
96
|
+
* dedicated gitlab.mjs (no registered 'gitlab' provider is added for the
|
|
97
|
+
* same buildVcsCommand()-error-shape reason documented on AUTH_EXPIRED
|
|
98
|
+
* above). The literal says "Access denied", not "expired"/"invalid" --
|
|
99
|
+
* HTTP's 403-shaped refusal, not a 401 -- so AUTH_DENIED, not
|
|
100
|
+
* AUTH_EXPIRED. */
|
|
101
|
+
const AUTH_DENIED = [
|
|
102
|
+
/Permission denied \(publickey\)/i,
|
|
103
|
+
/HTTP Basic:\s*Access denied/i,
|
|
104
|
+
];
|
|
105
|
+
|
|
106
|
+
/** Network / lock blips a plain retry can clear. Verbatim
|
|
107
|
+
* GIT_TRANSIENT_PATTERNS -- including the two dispatch-channel texts, which
|
|
108
|
+
* are a transient failure of the fleet transport rather than of git, and must
|
|
109
|
+
* be retried rather than left 'unknown' (which is sprint-fatal). */
|
|
110
|
+
const TRANSIENT = [
|
|
111
|
+
/could not resolve host/i,
|
|
112
|
+
/unable to access/i,
|
|
113
|
+
/connection (timed out|reset|refused)/i,
|
|
114
|
+
/operation timed out/i,
|
|
115
|
+
/\btimed out\b/i,
|
|
116
|
+
/\btimeout\b/i,
|
|
117
|
+
/temporary failure/i,
|
|
118
|
+
/early eof/i,
|
|
119
|
+
/rpc failed/i,
|
|
120
|
+
/the remote end hung up/i,
|
|
121
|
+
/index\.lock/i,
|
|
122
|
+
/unable to create '.*lock'/i,
|
|
123
|
+
/cannot lock ref/i,
|
|
124
|
+
/ssh_exchange_identification/i,
|
|
125
|
+
/transport failure while executing command/i,
|
|
126
|
+
/fetch failed/i,
|
|
127
|
+
];
|
|
128
|
+
|
|
129
|
+
/** No remote configured at all -- nothing to push or pull. Kept narrow on
|
|
130
|
+
* purpose: these must never swallow a real failure that merely mentions the
|
|
131
|
+
* word "remote". */
|
|
132
|
+
const NO_REMOTE = [
|
|
133
|
+
/error 1105.*no remote/i,
|
|
134
|
+
/\bno remote\b/i,
|
|
135
|
+
/no such remote/i,
|
|
136
|
+
];
|
|
137
|
+
|
|
138
|
+
/** VCSModule's OWN refusal texts (vcs-module.mjs buildVcsCommand). Kept to
|
|
139
|
+
* exactly those two literals -- a broad /not supported/i would capture
|
|
140
|
+
* unrelated remote chatter. */
|
|
141
|
+
const UNSUPPORTED_OPERATION = [
|
|
142
|
+
/unsupported VCS provider/i,
|
|
143
|
+
/does not yet implement action/i,
|
|
144
|
+
];
|
|
145
|
+
|
|
146
|
+
export const GenericGitVCS = Object.freeze({
|
|
147
|
+
name: 'generic-git',
|
|
148
|
+
extends: null,
|
|
149
|
+
rules: Object.freeze({
|
|
150
|
+
[K.DIVERGED]: DIVERGED,
|
|
151
|
+
[K.AUTH_EXPIRED]: AUTH_EXPIRED,
|
|
152
|
+
[K.AUTH_DENIED]: AUTH_DENIED,
|
|
153
|
+
[K.TRANSIENT]: TRANSIENT,
|
|
154
|
+
[K.NO_REMOTE]: NO_REMOTE,
|
|
155
|
+
[K.UNSUPPORTED_OPERATION]: UNSUPPORTED_OPERATION,
|
|
156
|
+
}),
|
|
157
|
+
/** Portable git stderr carries no vendor error code. */
|
|
158
|
+
extractProviderCode() {
|
|
159
|
+
return null;
|
|
160
|
+
},
|
|
161
|
+
/** Catch-all for VCSModule.capabilities() host dispatch (apra-fleet-
|
|
162
|
+
* 647.1.4.1): every resolvable host matches SOME provider, and this is
|
|
163
|
+
* the fallback when no more specific provider (e.g. GitHubVCS) claims
|
|
164
|
+
* it, so resolveVcsProviderForHost() never returns nothing. */
|
|
165
|
+
matchesHost() {
|
|
166
|
+
return true;
|
|
167
|
+
},
|
|
168
|
+
/** No REST create-pull-request implementation exists for a generic/
|
|
169
|
+
* unrecognized host (Azure DevOps, GitLab, or anything else VCSModule
|
|
170
|
+
* has no provider for yet) -- fails closed, never guesses a vendor. */
|
|
171
|
+
capabilitiesForHost() {
|
|
172
|
+
return { canOpenPullRequest: false };
|
|
173
|
+
},
|
|
174
|
+
});
|
|
175
|
+
|
|
176
|
+
export default GenericGitVCS;
|
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GitHubVCS -- the GitHub provider for VCSModule.classifyFailure(), and (apra-
|
|
3
|
+
* fleet-647.1.5.1) THE manifest entry for everything else GitHub-specific:
|
|
4
|
+
* its default auth mode and its create-pull-request/comment command builders.
|
|
5
|
+
* Before 647.1.5.1 those lived in two separate provider-name-keyed tables in
|
|
6
|
+
* vcs-module.mjs (BUILDERS, DEFAULT_AUTH_MODES) that a new provider had to
|
|
7
|
+
* also edit; now they are fields on THIS descriptor, so adding a provider is
|
|
8
|
+
* one file here, nothing in vcs-module.mjs.
|
|
9
|
+
*
|
|
10
|
+
* Owns ONLY GitHub's own literals and inherits everything portable from
|
|
11
|
+
* GenericGitVCS via `extends` (a GitHub push still fails with plain git and
|
|
12
|
+
* OpenSSH texts, so those must not be duplicated here). Inherited patterns are
|
|
13
|
+
* checked too; this file's patterns are checked FIRST within each kind, so a
|
|
14
|
+
* provider can always sharpen a base verdict without editing the base.
|
|
15
|
+
*
|
|
16
|
+
* PARITY NOTE (apra-fleet-647.1.3.1 AC2): the two members of runner.js's
|
|
17
|
+
* GIT_AUTH_PATTERNS / DOLT_AUTH_PATTERNS that are GitHub-specific live here.
|
|
18
|
+
* Together with GenericGitVCS's six, `provider: 'github'` reproduces those
|
|
19
|
+
* lists EXACTLY -- which is why 'github' is classifyFailure's default provider
|
|
20
|
+
* (see vcs-module.mjs): runner.js applies the full eight unconditionally today,
|
|
21
|
+
* so anything less would be a verdict regression for apra-fleet-647.1.3.2.
|
|
22
|
+
*
|
|
23
|
+
* PURITY: non-global regexes only -- see the note in ./generic-git.mjs.
|
|
24
|
+
*
|
|
25
|
+
* ASCII only.
|
|
26
|
+
*/
|
|
27
|
+
|
|
28
|
+
import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
|
|
29
|
+
|
|
30
|
+
const GITHUB_API = 'https://api.github.com';
|
|
31
|
+
const REDACTED = '***REDACTED***';
|
|
32
|
+
const REPO_RE = /^[\w.-]+\/[\w.-]+$/;
|
|
33
|
+
|
|
34
|
+
/** Single-quote a string for embedding in a shell command. The built curl
|
|
35
|
+
* command is dispatched through the member's own shell -- POSIX sh/bash
|
|
36
|
+
* closes/reopens the quote around an embedded single quote ('\''), but
|
|
37
|
+
* Windows PowerShell (the shell every Windows member's commands actually
|
|
38
|
+
* run through -- see wrapPowerShellEncoded()/isWindows in
|
|
39
|
+
* src/tools/remove-member.ts) escapes an embedded single quote inside a
|
|
40
|
+
* single-quoted string by DOUBLING it (''), not by backslash-closing. Using
|
|
41
|
+
* the POSIX form on a Windows member breaks the quoting outright (observed
|
|
42
|
+
* live: Publish PR crashing on any title/body containing an apostrophe).
|
|
43
|
+
* `os` is one of resolveMemberOs()'s return values ('windows'/'linux'/
|
|
44
|
+
* 'darwin'); anything other than 'windows' keeps the POSIX behavior
|
|
45
|
+
* byte-identical to before this branch existed. */
|
|
46
|
+
function shQuote(value, os) {
|
|
47
|
+
if (os === 'windows') {
|
|
48
|
+
return `'${String(value).replace(/'/g, "''")}'`;
|
|
49
|
+
}
|
|
50
|
+
return `'${String(value).replace(/'/g, `'\\''`)}'`;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function assertRepo(repo) {
|
|
54
|
+
const value = String(repo ?? '').trim();
|
|
55
|
+
if (!REPO_RE.test(value)) {
|
|
56
|
+
throw new Error(`ERROR: VCSModule: invalid repo "${repo}" -- expected "owner/name" (e.g. "Apra-Labs/apra-fleet").`);
|
|
57
|
+
}
|
|
58
|
+
return value;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
function assertToken(token) {
|
|
62
|
+
const value = String(token ?? '');
|
|
63
|
+
if (!value) {
|
|
64
|
+
throw new Error('ERROR: VCSModule: no token supplied -- caller must mint one via provision_vcs_auth before calling VCSModule.');
|
|
65
|
+
}
|
|
66
|
+
return value;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** Build the GitHub REST "create pull request" curl command.
|
|
70
|
+
* POST /repos/{owner}/{repo}/pulls -- see
|
|
71
|
+
* https://docs.github.com/en/rest/pulls/pulls#create-a-pull-request */
|
|
72
|
+
function buildGitHubCreatePrCommand({ repo, base, head, title, body, token, os }) {
|
|
73
|
+
const safeRepo = assertRepo(repo);
|
|
74
|
+
const safeToken = assertToken(token);
|
|
75
|
+
if (!base) throw new Error('ERROR: VCSModule: "base" branch is required to build a create-pull-request command.');
|
|
76
|
+
if (!head) throw new Error('ERROR: VCSModule: "head" branch is required to build a create-pull-request command.');
|
|
77
|
+
if (!title) throw new Error('ERROR: VCSModule: "title" is required to build a create-pull-request command.');
|
|
78
|
+
|
|
79
|
+
const payload = { title, head, base };
|
|
80
|
+
if (body !== undefined) payload.body = body;
|
|
81
|
+
const payloadJson = JSON.stringify(payload);
|
|
82
|
+
const url = `${GITHUB_API}/repos/${safeRepo}/pulls`;
|
|
83
|
+
|
|
84
|
+
const buildCurl = (authToken) => [
|
|
85
|
+
'curl -sS -X POST',
|
|
86
|
+
`-H ${shQuote(`Authorization: Bearer ${authToken}`, os)}`,
|
|
87
|
+
`-H ${shQuote('Accept: application/vnd.github+json', os)}`,
|
|
88
|
+
`-H ${shQuote('Content-Type: application/json', os)}`,
|
|
89
|
+
`-H ${shQuote('X-GitHub-Api-Version: 2022-11-28', os)}`,
|
|
90
|
+
`-d ${shQuote(payloadJson, os)}`,
|
|
91
|
+
`-w ${shQuote('\n%{http_code}', os)}`,
|
|
92
|
+
url,
|
|
93
|
+
].join(' ');
|
|
94
|
+
|
|
95
|
+
return {
|
|
96
|
+
provider: 'github',
|
|
97
|
+
action: 'create-pull-request',
|
|
98
|
+
command: buildCurl(safeToken),
|
|
99
|
+
logSafeCommand: buildCurl(REDACTED),
|
|
100
|
+
// Interpretation contract mirrors the reverted server-side tool
|
|
101
|
+
// (src/tools/create-pull-request.ts) so callers migrating to
|
|
102
|
+
// VCSModule keep the same success/already-exists/error semantics:
|
|
103
|
+
// - 2xx -> success; body has .number/.html_url
|
|
104
|
+
// - 422 + "already exists" text -> idempotent success
|
|
105
|
+
// - anything else -> error
|
|
106
|
+
interpret: {
|
|
107
|
+
successStatusRange: [200, 299],
|
|
108
|
+
alreadyExistsStatus: 422,
|
|
109
|
+
alreadyExistsPattern: 'already exists',
|
|
110
|
+
},
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/** Build the GitHub REST "comment on an issue/PR" curl command, used to
|
|
115
|
+
* annotate an existing PR when a sprint aborts after the PR was already
|
|
116
|
+
* raised (rather than opening a second PR for the same head).
|
|
117
|
+
* POST /repos/{owner}/{repo}/issues/{issue_number}/comments -- see
|
|
118
|
+
* https://docs.github.com/en/rest/issues/comments#create-an-issue-comment */
|
|
119
|
+
function buildGitHubCommentCommand({ repo, issue_number: issueNumber, body, token, os }) {
|
|
120
|
+
const safeRepo = assertRepo(repo);
|
|
121
|
+
const safeToken = assertToken(token);
|
|
122
|
+
if (!issueNumber) throw new Error('ERROR: VCSModule: "issue_number" is required to build a comment command.');
|
|
123
|
+
if (!body) throw new Error('ERROR: VCSModule: "body" is required to build a comment command.');
|
|
124
|
+
|
|
125
|
+
const payloadJson = JSON.stringify({ body });
|
|
126
|
+
const url = `${GITHUB_API}/repos/${safeRepo}/issues/${issueNumber}/comments`;
|
|
127
|
+
|
|
128
|
+
const buildCurl = (authToken) => [
|
|
129
|
+
'curl -sS -X POST',
|
|
130
|
+
`-H ${shQuote(`Authorization: Bearer ${authToken}`, os)}`,
|
|
131
|
+
`-H ${shQuote('Accept: application/vnd.github+json', os)}`,
|
|
132
|
+
`-H ${shQuote('Content-Type: application/json', os)}`,
|
|
133
|
+
`-H ${shQuote('X-GitHub-Api-Version: 2022-11-28', os)}`,
|
|
134
|
+
`-d ${shQuote(payloadJson, os)}`,
|
|
135
|
+
`-w ${shQuote('\n%{http_code}', os)}`,
|
|
136
|
+
url,
|
|
137
|
+
].join(' ');
|
|
138
|
+
|
|
139
|
+
return {
|
|
140
|
+
provider: 'github',
|
|
141
|
+
action: 'comment',
|
|
142
|
+
command: buildCurl(safeToken),
|
|
143
|
+
logSafeCommand: buildCurl(REDACTED),
|
|
144
|
+
interpret: {
|
|
145
|
+
successStatusRange: [200, 299],
|
|
146
|
+
},
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/** GitHub's credential-rejection literals. "remote: Invalid username or
|
|
151
|
+
* token/password" is what a git push over HTTPS gets back from GitHub with a
|
|
152
|
+
* dead PAT; "Bad credentials" is the REST API's equivalent, which reaches us
|
|
153
|
+
* through the curl commands VCSModule builds. Both mean the token itself is
|
|
154
|
+
* no longer good -- re-provisioning is the remedy, so AUTH_EXPIRED. */
|
|
155
|
+
const AUTH_EXPIRED = [
|
|
156
|
+
/remote: Invalid username or (token|password)/i,
|
|
157
|
+
/Bad credentials/i,
|
|
158
|
+
];
|
|
159
|
+
|
|
160
|
+
// DELIBERATELY ABSENT, and not an oversight: GitHub texts that are NOT in
|
|
161
|
+
// runner.js's pattern tables today -- scope/permission refusals ("Resource not
|
|
162
|
+
// accessible by integration", the vague "remote: Repository not found" for a
|
|
163
|
+
// private repo) and throttling ("API rate limit exceeded", "secondary rate
|
|
164
|
+
// limit"). Each classifies as 'unknown' today, so adding it here would CHANGE
|
|
165
|
+
// the verdict apra-fleet-647.1.3.2 must preserve: a rate-limit text would newly
|
|
166
|
+
// become retryable, a permission refusal would newly trigger the auth
|
|
167
|
+
// self-heal. Widening the taxonomy is a real behavior change and belongs in its
|
|
168
|
+
// own bead with its own tests, not smuggled in under a no-verdict-change
|
|
169
|
+
// consolidation.
|
|
170
|
+
|
|
171
|
+
/** Best-effort GitHub provider code, purely DIAGNOSTIC: never branch on it --
|
|
172
|
+
* branch on `kind`. Returns the HTTP status git/curl surfaced (e.g. '403'
|
|
173
|
+
* from git's "The requested URL returned error: 403", or the trailing status
|
|
174
|
+
* code the VCSModule curl commands append via -w '\n%{http_code}'), else null.
|
|
175
|
+
*
|
|
176
|
+
* Constructed in-function rather than hoisted: these are exec/match calls on
|
|
177
|
+
* patterns that must never carry `lastIndex` state between classifyFailure
|
|
178
|
+
* calls (AC3 purity).
|
|
179
|
+
*/
|
|
180
|
+
function extractProviderCode(raw) {
|
|
181
|
+
const text = String(raw == null ? '' : raw);
|
|
182
|
+
const urlError = text.match(/requested URL returned error:\s*(\d{3})/i);
|
|
183
|
+
if (urlError) return urlError[1];
|
|
184
|
+
const httpStatus = text.match(/\bHTTP(?:\/[\d.]+)?\s+(\d{3})\b/);
|
|
185
|
+
if (httpStatus) return httpStatus[1];
|
|
186
|
+
const trailing = text.match(/(?:^|\n)\s*(\d{3})\s*$/);
|
|
187
|
+
if (trailing) return trailing[1];
|
|
188
|
+
return null;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/** Host-recognition for VCSModule.capabilities() (apra-fleet-647.1.4.1).
|
|
192
|
+
* `github.com` itself plus GitHub Enterprise Server hosts, which have no
|
|
193
|
+
* fixed domain -- an operator names theirs anything ("github.mycompany.com",
|
|
194
|
+
* "ghe.internal", ...) -- so there is no closed literal list to match
|
|
195
|
+
* against. The portable signal every such host shares is the vendor name
|
|
196
|
+
* itself appearing in the hostname; a host with no "github" substring (Azure
|
|
197
|
+
* DevOps' dev.azure.com, GitLab's gitlab.com or a self-hosted
|
|
198
|
+
* gitlab.example.com, ...) is deliberately left to GenericGitVCS's
|
|
199
|
+
* catch-all rather than guessed at here. */
|
|
200
|
+
function matchesHost(host) {
|
|
201
|
+
return typeof host === 'string' && /github/i.test(host);
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
/** Every host this provider matches can open a PR via the REST call
|
|
205
|
+
* buildGitHubCreatePrCommand() builds -- github.com and GitHub Enterprise
|
|
206
|
+
* Server alike speak the same `/repos/{owner}/{repo}/pulls` shape. */
|
|
207
|
+
function capabilitiesForHost(_host) {
|
|
208
|
+
return { canOpenPullRequest: true };
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
export const GitHubVCS = Object.freeze({
|
|
212
|
+
name: 'github',
|
|
213
|
+
extends: 'generic-git',
|
|
214
|
+
rules: Object.freeze({
|
|
215
|
+
[K.AUTH_EXPIRED]: AUTH_EXPIRED,
|
|
216
|
+
}),
|
|
217
|
+
extractProviderCode,
|
|
218
|
+
matchesHost,
|
|
219
|
+
capabilitiesForHost,
|
|
220
|
+
// apra-fleet-647.1.5.1: GitHub's own default auth mode (App, never PAT --
|
|
221
|
+
// see vcs-module.mjs resolveProvider()'s header note on why this must stay
|
|
222
|
+
// 'github-app') and its command builders. A provider descriptor need not
|
|
223
|
+
// declare `defaultAuthMode`/`builders` at all (see ./generic-git.mjs,
|
|
224
|
+
// ./dolt.mjs -- classification-only providers that are not a member-facing
|
|
225
|
+
// VCS auth backend); declaring `defaultAuthMode` (even as `null`) is what
|
|
226
|
+
// makes a provider part of resolveProvider()'s/buildVcsCommand()'s known
|
|
227
|
+
// vocabulary -- see ./index.mjs's isAuthBackend().
|
|
228
|
+
defaultAuthMode: 'github-app',
|
|
229
|
+
builders: Object.freeze({
|
|
230
|
+
'create-pull-request': buildGitHubCreatePrCommand,
|
|
231
|
+
comment: buildGitHubCommentCommand,
|
|
232
|
+
}),
|
|
233
|
+
});
|
|
234
|
+
|
|
235
|
+
export default GitHubVCS;
|