@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,127 @@
|
|
|
1
|
+
# Fleet Execution Addendum
|
|
2
|
+
|
|
3
|
+
This document covers features that apply ONLY when the pm skill runs in fleet
|
|
4
|
+
mode (dispatching to remote fleet members via execute_prompt). Fleet mode is an
|
|
5
|
+
integration with the separate apra-fleet product; apra-pm never requires it --
|
|
6
|
+
local subagent mode is the complete feature set, and the tools named here
|
|
7
|
+
(execute_prompt, compose_permissions, list_members, ...) exist only when
|
|
8
|
+
apra-fleet is installed. In local subagent
|
|
9
|
+
mode, everything here is skipped -- local subagents inherit the orchestrator's
|
|
10
|
+
permissions and context.
|
|
11
|
+
|
|
12
|
+
## Mode detection
|
|
13
|
+
|
|
14
|
+
At sprint start, detect the execution mode:
|
|
15
|
+
|
|
16
|
+
1. Probe for fleet MCP tools (fleet_status, list_members). If the tool is absent
|
|
17
|
+
or returns no members, fall to local mode.
|
|
18
|
+
2. An explicit --local or --fleet flag from the user overrides the probe.
|
|
19
|
+
3. Default: if fleet members are available AND the task tier has a matching
|
|
20
|
+
member, use fleet mode. Otherwise use local mode.
|
|
21
|
+
|
|
22
|
+
Record the mode in status.md at sprint init so recovery/resume uses the same
|
|
23
|
+
mode.
|
|
24
|
+
|
|
25
|
+
## Permissions
|
|
26
|
+
|
|
27
|
+
Compose and deliver permissions per the fleet skill permissions.md for each
|
|
28
|
+
member using tag-based selection: tags: ['doer'] for doer members, tags: ['reviewer']
|
|
29
|
+
for reviewer members. Recompose when switching tags (doer to reviewer or vice versa).
|
|
30
|
+
Each provider gets its native permission config -- compose_permissions handles the
|
|
31
|
+
format automatically.
|
|
32
|
+
|
|
33
|
+
Call compose_permissions before EVERY dispatch regardless of unattended mode.
|
|
34
|
+
|
|
35
|
+
### Unattended modes
|
|
36
|
+
|
|
37
|
+
- `update_member(unattended='auto')` -- safer auto-approval scoped to
|
|
38
|
+
explicitly listed operations.
|
|
39
|
+
- `update_member(unattended='dangerous')` -- full permission bypass. Prefer
|
|
40
|
+
auto over dangerous.
|
|
41
|
+
- Do NOT pass dangerously_skip_permissions to execute_prompt -- it is deprecated
|
|
42
|
+
and ignored.
|
|
43
|
+
|
|
44
|
+
### Mid-sprint permission denial
|
|
45
|
+
|
|
46
|
+
If a member is blocked by a permission denial:
|
|
47
|
+
|
|
48
|
+
1. Call compose_permissions with `grant: [<denied permission>]` and
|
|
49
|
+
project_folder.
|
|
50
|
+
2. This grants the missing permission, delivers the updated config, and appends
|
|
51
|
+
to the ledger so future phases start with it included.
|
|
52
|
+
3. Resume the member with resume=true.
|
|
53
|
+
4. Never bypass by running the denied command yourself via execute_command.
|
|
54
|
+
|
|
55
|
+
Act on the grant promptly -- the inactivity timer fires on stdout silence. If
|
|
56
|
+
it fires while you are composing permissions, resume=true still succeeds via
|
|
57
|
+
stale-session auto-recovery, but the member restarts without its in-progress
|
|
58
|
+
context.
|
|
59
|
+
|
|
60
|
+
## stop_prompt
|
|
61
|
+
|
|
62
|
+
Use stop_prompt (a fleet MCP tool) when a member is working on the wrong thing,
|
|
63
|
+
stuck in a loop, or dispatched with incorrect instructions. Always follow
|
|
64
|
+
immediately with resume=false to start a clean session.
|
|
65
|
+
|
|
66
|
+
stop_prompt kills the member's LLM process. This is distinct from stopping a
|
|
67
|
+
background orchestration sub-task within the PM's own session.
|
|
68
|
+
|
|
69
|
+
## Doer-reviewer pairing (fleet mode)
|
|
70
|
+
|
|
71
|
+
1. Record pair in status.md. Multiple pairs per project is normal.
|
|
72
|
+
2. Override icons via update_member -- doer gets circle, reviewer gets square,
|
|
73
|
+
same color.
|
|
74
|
+
3. Compose and deliver permissions for each member using tag-based selection:
|
|
75
|
+
tags: ['doer'] for the doer, tags: ['reviewer'] for the reviewer.
|
|
76
|
+
4. Send the role-specific agent context file via send_files before dispatch.
|
|
77
|
+
|
|
78
|
+
## Agent context file delivery
|
|
79
|
+
|
|
80
|
+
Each fleet member needs a provider-specific agent context file in their
|
|
81
|
+
work_folder root. It is the member's persistent execution model and survives
|
|
82
|
+
across session resumes.
|
|
83
|
+
|
|
84
|
+
### Provider filename table
|
|
85
|
+
|
|
86
|
+
Use member_detail -> llmProvider to determine the target filename:
|
|
87
|
+
|
|
88
|
+
| Provider | Filename |
|
|
89
|
+
|----------|----------|
|
|
90
|
+
| Claude | CLAUDE.md |
|
|
91
|
+
| Antigravity (agy) | AGY.md |
|
|
92
|
+
| Gemini | GEMINI.md |
|
|
93
|
+
| Codex | AGENTS.md |
|
|
94
|
+
| Copilot | COPILOT.md |
|
|
95
|
+
| OpenCode | OPENCODE.md |
|
|
96
|
+
|
|
97
|
+
### Rules
|
|
98
|
+
|
|
99
|
+
- Pick the correct template based on role and filename based on provider.
|
|
100
|
+
- Fill in {{branch}} and {{base_branch}} with the sprint branch and base branch
|
|
101
|
+
before delivering.
|
|
102
|
+
- Send to member via send_files to the member's work_folder root before dispatch.
|
|
103
|
+
- Never commit to git -- add the filename to the member's .gitignore.
|
|
104
|
+
- On role switch: send the new context file before dispatch.
|
|
105
|
+
- Remove before merge: use the cleanup procedure in sprint.md Completion.
|
|
106
|
+
|
|
107
|
+
## Secrets and credentials
|
|
108
|
+
|
|
109
|
+
Never pass raw secrets in execute_prompt prompts -- reference the credential by
|
|
110
|
+
name only (e.g. "authenticate using credential github_pat"). The member then
|
|
111
|
+
uses {{secure.github_pat}} in its own execute_command calls. The
|
|
112
|
+
{{secure.NAME}} token is substituted at launch time -- reference it bare in
|
|
113
|
+
execute_command, not inside your own quotes (it is already single-quote-escaped
|
|
114
|
+
by the fleet).
|
|
115
|
+
|
|
116
|
+
Email provider secrets follow the same credential-store pattern: store with
|
|
117
|
+
credential_store_set (names: "sendgrid_api_key" or "smtp_password"). The
|
|
118
|
+
send_email tool takes non-secret config inline (provider, host, port, user,
|
|
119
|
+
from) -- the workflow owns that config, not the server environment. Never pass
|
|
120
|
+
email secrets in workflow prompts, config files, or environment variables.
|
|
121
|
+
|
|
122
|
+
## Fleet call batching (R8)
|
|
123
|
+
|
|
124
|
+
When executing a sequence of fleet calls -- any combination of send_files,
|
|
125
|
+
execute_command, execute_prompt, receive_files -- club them into a single
|
|
126
|
+
background Agent rather than issuing individual calls or multiple background
|
|
127
|
+
agents. This reduces orchestrator turn overhead.
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# Project Index
|
|
2
|
+
|
|
3
|
+
Index the project repo for code intelligence so fleet members can use
|
|
4
|
+
code_graph, code_impact, code_query, and code_context tools.
|
|
5
|
+
|
|
6
|
+
## Flow
|
|
7
|
+
|
|
8
|
+
1. Read `<project>/status.md` to find the repo path and an available member.
|
|
9
|
+
2. Pick any online member whose work_folder is the project repo. If no member
|
|
10
|
+
is pointed at the repo, use any local online member and set `run_from` to
|
|
11
|
+
the repo path.
|
|
12
|
+
3. Run via `execute_command` (wrap in background Agent per fleet rules):
|
|
13
|
+
```
|
|
14
|
+
npx gitnexus analyze --embeddings
|
|
15
|
+
```
|
|
16
|
+
- `run_from`: project repo root
|
|
17
|
+
- `timeout_s`: 300 (indexing large repos can take a minute)
|
|
18
|
+
4. Report the result: nodes indexed, edges, flows (gitnexus prints this on
|
|
19
|
+
completion). If gitnexus is not installed, it will be fetched automatically
|
|
20
|
+
via npx.
|
|
21
|
+
5. Non-fatal: if the command fails (e.g. no package.json, unsupported language),
|
|
22
|
+
log the error and tell the user -- do not block the sprint.
|
|
23
|
+
|
|
24
|
+
## The `--embeddings` flag
|
|
25
|
+
|
|
26
|
+
- Enables semantic embedding generation using a LOCAL ONNX CPU model
|
|
27
|
+
(`Snowflake/snowflake-arctic-embed-xs`, 384-dim) bundled with gitnexus --
|
|
28
|
+
no API key, no external service, no config needed.
|
|
29
|
+
- One-time cost: the first `--embeddings` run on a machine downloads the
|
|
30
|
+
model (~87 MB) from HuggingFace and caches it at `~/.cache/huggingface`;
|
|
31
|
+
every run after that is offline.
|
|
32
|
+
- Embeddings are OFF by default and PRESERVED across a plain `analyze`
|
|
33
|
+
(only `--drop-embeddings` removes them), so passing `--embeddings` here is
|
|
34
|
+
additive and safe to run repeatedly.
|
|
35
|
+
- win32 caveat: on Windows, LadybugDB's VECTOR index is unavailable, so
|
|
36
|
+
semantic search falls back to an exact scan (capped at 10000 chunks) --
|
|
37
|
+
this still works, it is just brute-force rather than an ANN index. Not a
|
|
38
|
+
blocker; see `docs/code-intelligence-embeddings.md` for the full
|
|
39
|
+
investigation.
|
|
40
|
+
|
|
41
|
+
## When to run
|
|
42
|
+
|
|
43
|
+
- **Automatically inside `/pm init`** -- runs as the final step of project initialization.
|
|
44
|
+
The worktree must exist before indexing (gitnexus needs files on disk to analyze).
|
|
45
|
+
- **Automatically at VERIFY checkpoints** -- checkpoints re-run npx gitnexus analyze to keep
|
|
46
|
+
mid-sprint symbols visible to later phases (incremental via fileHashes in .gitnexus/meta.json,
|
|
47
|
+
takes seconds).
|
|
48
|
+
- After a large merge or rebase that changes many files
|
|
49
|
+
- When `kb_session_prime` returns many stale entries
|
|
50
|
+
- Any time the user asks to re-index (run `/pm index` explicitly)
|
|
51
|
+
|
|
52
|
+
## Notes
|
|
53
|
+
|
|
54
|
+
- Indexing is per-repo and persists on disk -- subsequent runs are incremental.
|
|
55
|
+
- The index is used by the gitnexus provider behind code_graph/impact/query/context.
|
|
56
|
+
- Fleet members never call gitnexus directly -- they use the fleet tools.
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
# /pm kb-reconcile
|
|
2
|
+
|
|
3
|
+
Reconcile a warm local KB against a merged bible after two or more branches
|
|
4
|
+
land -- absorb the incoming knowledge, revive entries whose basis matches
|
|
5
|
+
the merged worktree again, mechanically settle contradictions a file hash
|
|
6
|
+
can decide, and dispatch a reconciler agent for the rest. Ends with the
|
|
7
|
+
canonical bible re-exported so the merged branch's KB reflects merged truth.
|
|
8
|
+
|
|
9
|
+
## When to run
|
|
10
|
+
|
|
11
|
+
- After merging branches (including this sprint's own PR merging into its
|
|
12
|
+
base) -- as a standalone command, or as the post-merge hook inside
|
|
13
|
+
`/pm cleanup` (see SKILL.md's completion flow).
|
|
14
|
+
- Any time a local KB needs to catch up with a `.fleet/kb-canonical.json`
|
|
15
|
+
bible produced elsewhere (a teammate's branch, a different worktree) --
|
|
16
|
+
whether or not a formal merge just happened.
|
|
17
|
+
- Periodically, alongside `/pm kb-review`, as KB hygiene.
|
|
18
|
+
|
|
19
|
+
## Trust boundary (state honestly, do not skip)
|
|
20
|
+
|
|
21
|
+
Step 1 (`kb_import`) reads a bible file. Importing the repo-resolved
|
|
22
|
+
`.fleet/kb-canonical.json` is the git-reviewed, human-merged trusted channel
|
|
23
|
+
-- non-directive entries there keep their bible confidence. An explicit
|
|
24
|
+
`--path` bible is CALLER-ASSERTED trust: equivalent in power to the
|
|
25
|
+
already-exposed `kb_promote` surface (which can walk any entry
|
|
26
|
+
`INFERRED -> CONFIRMED` one call at a time), not a new privilege class.
|
|
27
|
+
`type: 'user-directive'` entries are quarantined to pending proposals either
|
|
28
|
+
way -- a bible can never smuggle an active directive; activation stays
|
|
29
|
+
CLI-only (`apra-fleet kb approve-directive`).
|
|
30
|
+
|
|
31
|
+
## Steps
|
|
32
|
+
|
|
33
|
+
### Step 1: Import the merged bible
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
kb_import({ repo: "<merged worktree path>" })
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
or the CLI equivalent, `apra-fleet kb import --repo <path>`, for a human
|
|
40
|
+
running this post-merge by hand. Omit `path` to resolve
|
|
41
|
+
`<repo>/.fleet/kb-canonical.json` (the trusted channel); pass an explicit
|
|
42
|
+
`path` only when importing a bible from somewhere else (caller-asserted
|
|
43
|
+
trust, see above).
|
|
44
|
+
|
|
45
|
+
Report: `{ imported, skipped, linked, flagged, sweep }`. `kb_import`
|
|
46
|
+
already runs a freshness sweep internally at the end of its own run, scoped
|
|
47
|
+
to the imported entries' impact -- Step 2 below is still worth running
|
|
48
|
+
explicitly (see its note).
|
|
49
|
+
|
|
50
|
+
### Step 2: Freshness sweep
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
kb_freshness_sweep()
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Re-hashes EVERY entry in the KB that carries a stored basis against the
|
|
57
|
+
CURRENT (merged) worktree -- not just the entries `kb_import` just touched.
|
|
58
|
+
Un-stales matches (the D2 predicate still excludes superseded, downvoted, and
|
|
59
|
+
invalidated entries from revival), stales mismatches. This is what actually
|
|
60
|
+
performs branch-switch revival: `kb_session_prime`'s candidate set excludes
|
|
61
|
+
stale entries by definition, so priming alone can never revive anything.
|
|
62
|
+
|
|
63
|
+
Idempotent, and worth running explicitly even right after `kb_import` (whose
|
|
64
|
+
internal sweep covers the same ground) because it also covers the
|
|
65
|
+
reconcile-WITHOUT-import path -- e.g. re-running `/pm kb-reconcile` after
|
|
66
|
+
just switching worktree state with no new bible to import.
|
|
67
|
+
|
|
68
|
+
No sweep is needed AFTER Step 3 or Step 4 below: `kb_resolve_contradiction`
|
|
69
|
+
sets each winner's final stale state itself, including the predicate-guarded
|
|
70
|
+
un-stale check, as part of resolving the pair (hardened D4) -- a
|
|
71
|
+
post-resolution sweep would be redundant.
|
|
72
|
+
|
|
73
|
+
### Step 3: Hash prefilter
|
|
74
|
+
|
|
75
|
+
```
|
|
76
|
+
kb_reconcile_prefilter()
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
For every remaining flagged contradiction pair (`flaggedPairs()` -- this
|
|
80
|
+
INCLUDES stale members; the imported side of a pair is typically stale
|
|
81
|
+
right after Step 1/2, and that is exactly the case this step exists to
|
|
82
|
+
resolve), re-hashes both sides' full source-file bases against the CURRENT
|
|
83
|
+
worktree. Exactly one side fully matching wins mechanically, via the same
|
|
84
|
+
`kb_resolve_contradiction` write path the reconciler agent uses (evidence:
|
|
85
|
+
`"hash-basis match on merged worktree"`). Pairs where both sides match, both
|
|
86
|
+
mismatch, either has an empty/missing basis, or either side is an ACTIVE
|
|
87
|
+
user-directive are left untouched for Step 4.
|
|
88
|
+
|
|
89
|
+
Report: `{ pairs, resolved, left_for_agent, skipped_directive }`.
|
|
90
|
+
|
|
91
|
+
### Step 4: Reconciler agent
|
|
92
|
+
|
|
93
|
+
If `left_for_agent` is non-empty, dispatch the `kb-reconciler` agent
|
|
94
|
+
(`agents/kb-reconciler.md`, model tier cheap/standard)
|
|
95
|
+
with that array. It reads the MERGED code via `code_context`/`code_impact`/
|
|
96
|
+
`code_query` (never Glob/Grep) for each remaining pair, resolves what the
|
|
97
|
+
code decides via `kb_resolve_contradiction`, falls back to a trust-tier
|
|
98
|
+
tiebreak (`CONFIRMED > INFERRED > UNVERIFIED`) when the code is silent, and
|
|
99
|
+
leaves genuinely undecidable pairs flagged for `/pm kb-review`. Active
|
|
100
|
+
user-directives are NEVER auto-retired. See `agents/kb-reconciler.md` for the
|
|
101
|
+
full process and the single-write-path rule.
|
|
102
|
+
|
|
103
|
+
If `left_for_agent` is empty, skip straight to Step 5.
|
|
104
|
+
|
|
105
|
+
### Step 5: Export
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
kb_export()
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Writes every live `CONFIRMED` project entry -- which now includes every
|
|
112
|
+
mechanical and agent-resolved winner -- to `.fleet/kb-canonical.json` and
|
|
113
|
+
auto-commits it (pathspec-only, identity `pm-kb`, non-fatal on any git
|
|
114
|
+
failure). This is existing `kb_export` machinery; no new commit step is
|
|
115
|
+
needed here. Push is not automatic; it rides the normal sprint push cadence.
|
|
116
|
+
|
|
117
|
+
## Report
|
|
118
|
+
|
|
119
|
+
After all steps:
|
|
120
|
+
|
|
121
|
+
```
|
|
122
|
+
/pm kb-reconcile complete.
|
|
123
|
+
Import: imported=<n> skipped=<n> linked=<n> flagged=<n>
|
|
124
|
+
Sweep: checked=<n> staled=<n> unstaled=<n>
|
|
125
|
+
Prefilter: pairs=<n> resolved=<n> left_for_agent=<n> skipped_directive=<n>
|
|
126
|
+
Reconciler: codeDecided=<n> tierDecided=<n> deferred=<n> (omitted if Step 4 was skipped)
|
|
127
|
+
Export: exported=<n> committed=<true|false>
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
Any `deferred` pairs from the reconciler, and any pair `kb_reconcile_prefilter`
|
|
131
|
+
skipped for an active directive, are handled the same way as any other
|
|
132
|
+
flagged entry going forward: surface them next time `/pm kb-review` runs.
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# /pm kb-review
|
|
2
|
+
|
|
3
|
+
Surface all contradiction-flagged KB entries and resolve them interactively.
|
|
4
|
+
|
|
5
|
+
Note: `/pm kb-review` also surfaces pending `user-directive` proposals (via
|
|
6
|
+
`kb_query({ flagged_only: true })`) and instructs the human to run
|
|
7
|
+
`apra-fleet kb approve-directive <id>` or `reject-directive <id>` -- these are
|
|
8
|
+
CLI-only resolutions, never `kb_promote`.
|
|
9
|
+
|
|
10
|
+
## When to run
|
|
11
|
+
|
|
12
|
+
- After any sprint completes, as part of KB hygiene.
|
|
13
|
+
- When an agent reports a `flagged` audn_decision from `kb_capture`.
|
|
14
|
+
- Periodically, to keep the KB free of unresolved contradictions.
|
|
15
|
+
|
|
16
|
+
## Steps
|
|
17
|
+
|
|
18
|
+
### Step 1: Fetch flagged entries
|
|
19
|
+
|
|
20
|
+
Call `kb_query(flagged_only=true)`.
|
|
21
|
+
|
|
22
|
+
- If the response says "No flagged contradictions found -- KB is clean.", report that to the user and stop.
|
|
23
|
+
- Otherwise, collect all returned entries.
|
|
24
|
+
|
|
25
|
+
### Step 2: Group into contradiction pairs
|
|
26
|
+
|
|
27
|
+
For each entry with `contradiction_of` set, pair it with the entry whose `id` matches `contradiction_of`.
|
|
28
|
+
Entries with `flagged_for_review=true` and no `contradiction_of` are the original (challenged) entries.
|
|
29
|
+
|
|
30
|
+
Group: `{ original: entry_A, challenger: entry_B }` where `entry_B.contradiction_of = entry_A.id`.
|
|
31
|
+
|
|
32
|
+
### Step 3: Present each pair to the user
|
|
33
|
+
|
|
34
|
+
For each pair, show:
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
Contradiction pair (N of M):
|
|
38
|
+
|
|
39
|
+
[ORIGINAL] id: <id> confidence: <confidence> created: <created_at>
|
|
40
|
+
Title: <title>
|
|
41
|
+
Summary: <summary>
|
|
42
|
+
Content: <content>
|
|
43
|
+
|
|
44
|
+
[CHALLENGER] id: <id> confidence: <confidence> created: <created_at>
|
|
45
|
+
Title: <title>
|
|
46
|
+
Summary: <summary>
|
|
47
|
+
Content: <content>
|
|
48
|
+
|
|
49
|
+
Resolution options:
|
|
50
|
+
A - Keep original, discard challenger
|
|
51
|
+
B - Keep challenger, discard original
|
|
52
|
+
M - Merge both into a new entry (you provide merged content)
|
|
53
|
+
D - Delete both (neither is correct)
|
|
54
|
+
S - Skip (defer to later)
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Wait for the user's response before proceeding to the next pair.
|
|
58
|
+
|
|
59
|
+
### Step 4: Apply resolution
|
|
60
|
+
|
|
61
|
+
Supersede is OPT-IN: you must name the entry you are retiring via
|
|
62
|
+
`supersedes=<id>`. It is honored only when AUDN independently matches that same
|
|
63
|
+
entry (same type, overlapping symbols and source_files), so the corrective
|
|
64
|
+
capture must still carry the SAME title/symbols/source_files as its target --
|
|
65
|
+
otherwise nothing is retired and you get a second live entry instead. A capture
|
|
66
|
+
without `supersedes` never retires anything.
|
|
67
|
+
|
|
68
|
+
**A -- Keep original:**
|
|
69
|
+
- `kb_promote(original.id, reason="contradiction resolved: original kept")` -- upgrades its confidence.
|
|
70
|
+
- `kb_capture` a new entry with the SAME title/symbols/source_files as the challenger, corrected content that carries no contradiction keyword or polarity word (or AUDN will flag it again instead of updating), `confidence=UNVERIFIED`, and `supersedes=<challenger.id>`. That retires the challenger.
|
|
71
|
+
|
|
72
|
+
**B -- Keep challenger:**
|
|
73
|
+
- `kb_promote(challenger.id, reason="contradiction resolved: challenger kept")`.
|
|
74
|
+
- `kb_capture` a corrected entry with the SAME title/symbols/source_files as the original, corrected content free of contradiction/polarity words, and `supersedes=<original.id>`. That retires the original.
|
|
75
|
+
|
|
76
|
+
**M -- Merge:**
|
|
77
|
+
- Ask the user to provide the merged content.
|
|
78
|
+
- `kb_capture` a new entry with merged content and `supersedes=<id of whichever entry it replaces>`. Repeat for the second entry if both must be retired -- `supersedes` names ONE entry, so retiring both takes two captures.
|
|
79
|
+
- `kb_promote` the newly captured entry id.
|
|
80
|
+
|
|
81
|
+
**D -- Delete both:**
|
|
82
|
+
- `kb_capture` a retraction entry: `title=<original title>`, `content="Retracted: neither entry describes current behavior."` (no contradiction keyword or polarity word, or AUDN will flag it again instead of updating), `confidence=UNVERIFIED`, `supersedes=<original.id>`.
|
|
83
|
+
- `kb_capture` same for the challenger, with `supersedes=<challenger.id>`.
|
|
84
|
+
|
|
85
|
+
**S -- Skip:**
|
|
86
|
+
- No action. Note it in the session summary.
|
|
87
|
+
|
|
88
|
+
**Verified actual behavior (T3.7, F11 e2e proof) -- read this before reporting "resolved":**
|
|
89
|
+
- Superseding an entry (via the corrective `kb_capture` above with `supersedes` set, AUDN decision `update`) sets its `superseded_at` and `stale=1`. That entry then drops out of every future `kb_query({flagged_only:true})` listing -- the tool always excludes superseded entries.
|
|
90
|
+
- `kb_promote` does **NOT** clear `flagged_for_review` and does **NOT** clear `contradiction_of`. This means the entry you KEPT (promoted, not superseded) stays visible in `kb_query({flagged_only:true})` forever -- it is not automatically delisted just because it was resolved. Do not expect the pair to fully disappear from the flagged list; expect only the superseded side to disappear. Recognize an already-resolved pair by its counterpart's absence (or by checking `promoted_at`/`confidence` on the id you kept), not by the pair vanishing entirely.
|
|
91
|
+
- A `kb_feedback`-downvoted entry (`stale=1` + `flagged_for_review=1`, never superseded) stays listed under `flagged_only` until it is separately resolved the same way -- superseded via a corrective capture, or otherwise retired. Simply promoting a *different* entry never clears it.
|
|
92
|
+
|
|
93
|
+
### Step 5: Report
|
|
94
|
+
|
|
95
|
+
After all pairs are processed, report:
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
KB Review complete.
|
|
99
|
+
- Pairs resolved: N
|
|
100
|
+
- Pairs skipped: M
|
|
101
|
+
- Total flagged entries cleared: K
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
"Cleared" here means the SUPERSEDED side of each resolved pair (the one whose
|
|
105
|
+
`superseded_at` got set) -- per the verified behavior in Step 4, the kept/
|
|
106
|
+
promoted side of a resolved pair remains in `kb_query({flagged_only:true})`
|
|
107
|
+
indefinitely, so K is normally N, not 2N. Do not report a pair as fully gone
|
|
108
|
+
from the flagged list; report it as resolved (one side superseded, the other
|
|
109
|
+
promoted).
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Simple Sprint
|
|
2
|
+
|
|
3
|
+
A lightweight flow for small, single-session tasks. Use this when the work is
|
|
4
|
+
small enough that the full plan/plan-review loop is unnecessary overhead. State
|
|
5
|
+
still lives in beads + git -- there is no PLAN.md or progress.json in any sprint.
|
|
6
|
+
|
|
7
|
+
## When to use
|
|
8
|
+
|
|
9
|
+
- 1-3 tasks, completable in a single session
|
|
10
|
+
- No complex phasing or cross-phase dependencies
|
|
11
|
+
- Low risk, well-understood scope
|
|
12
|
+
|
|
13
|
+
Use the full sprint lifecycle (sprint.md) for anything larger. If the work turns
|
|
14
|
+
out bigger than expected, promote to a full sprint.
|
|
15
|
+
|
|
16
|
+
## Flow
|
|
17
|
+
|
|
18
|
+
1. Write a concise requirements.md on the branch and commit.
|
|
19
|
+
2. Create a small beads sprint root + a task per item, each with `--acceptance="..."` and a
|
|
20
|
+
`--metadata '{"model": "<tier>"}'` tag.
|
|
21
|
+
3. Dispatch the doer (tier sized to the work). The doer claims each task
|
|
22
|
+
(`bd update <id> --claim`), implements, commits, pushes, and closes it
|
|
23
|
+
(`bd close <id>`).
|
|
24
|
+
4. Dispatch the reviewer (premium-tier, fresh session). It reads each task's acceptance
|
|
25
|
+
criteria (`bd show <id>`) + the diff and outputs a verdict: APPROVED or
|
|
26
|
+
CHANGES NEEDED.
|
|
27
|
+
5. On APPROVED: close the delivered source issues, clean sprint scaffolding from the
|
|
28
|
+
PR (see sprint.md Completion step 7 -- git rm sprint-created narrative files,
|
|
29
|
+
restore any the repo already shipped, then verify the net diff is product only),
|
|
30
|
+
commit as pm, raise the PR (or report the diff for local-only), remove the
|
|
31
|
+
worktree.
|
|
32
|
+
6. On CHANGES NEEDED: the orchestrator reads `reopenIds` and `newTasks` from the
|
|
33
|
+
reviewer's structured output (the reviewer never writes feedback.md); runs
|
|
34
|
+
`bd update <id> --status=open` for each reopen ID and `bd create` for each new
|
|
35
|
+
task; then re-dispatches the doer from step 3.
|
|
36
|
+
7. Create low-priority beads tasks for any unresolved findings or deferred items.
|
|
37
|
+
8. STOP: do not merge. Surface the PR URL and CI status to the user and await
|
|
38
|
+
explicit instruction.
|
|
39
|
+
|
|
40
|
+
## Rules
|
|
41
|
+
|
|
42
|
+
- Still requires pre-flight checks (see doer-reviewer-loop.md Pre-flight checks).
|
|
43
|
+
- In fleet mode: still requires permissions and doer/reviewer pairing (see
|
|
44
|
+
fleet-addendum.md).
|
|
45
|
+
- Beads + git carry the state -- as in every sprint, no progress.json or PLAN.md.
|
|
46
|
+
- Branch naming: choose a name that makes the purpose clear --
|
|
47
|
+
feat/<description>, fix/<description>, chore/<description>.
|
|
48
|
+
|
|
49
|
+
## Recovery after orchestrator restart
|
|
50
|
+
|
|
51
|
+
Recovery relies on beads and git history.
|
|
52
|
+
|
|
53
|
+
1. `bd list --tree <sprint-id>` (and `bd ready`) -- what is open, in progress, closed.
|
|
54
|
+
2. Per worktree: `git log --oneline -5` -- any commits since last known state?
|
|
55
|
+
3. `git status` -- uncommitted changes?
|
|
56
|
+
|
|
57
|
+
Then act:
|
|
58
|
+
|
|
59
|
+
- **Task in_progress with no matching commits** -> reset it
|
|
60
|
+
(`bd update <id> --status=open`) and re-dispatch the doer.
|
|
61
|
+
- **Work committed, next step clear** -> dispatch reviewer or continue doer.
|
|
62
|
+
- **At review checkpoint** -> dispatch reviewer (fresh session).
|
|
63
|
+
- **Uncommitted changes of unknown origin** -> escalate to user: "commit and
|
|
64
|
+
resume, or discard?"
|
|
65
|
+
- **No progress** -> re-dispatch from scratch.
|