@apralabs/apra-fleet 0.4.1 → 0.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -8
- package/dist/agents/backlog-groomer.md +17 -21
- package/dist/agents/ci-watcher.md +3 -0
- package/dist/agents/deployer.md +22 -44
- package/dist/agents/doer.md +131 -132
- package/dist/agents/harvester.md +20 -32
- package/dist/agents/integ-test-runner.md +81 -113
- package/dist/agents/kb-reconciler.md +31 -42
- package/dist/agents/plan-reviewer.md +32 -44
- package/dist/agents/planner.md +51 -63
- package/dist/agents/regression-test-runner.md +65 -80
- package/dist/agents/reviewer.md +56 -83
- package/dist/agents/schemas/integ-test-runner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +4 -17
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +1 -2
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +3 -3
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +4 -13
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +5 -39
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/register-member.js +1 -1
- package/dist/cli/start.d.ts.map +1 -1
- package/dist/cli/start.js +7 -0
- package/dist/cli/start.js.map +1 -1
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +5 -3
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/watch.d.ts +26 -3
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +41 -9
- package/dist/cli/watch.js.map +1 -1
- package/dist/os/git-bash-candidates.d.ts +35 -0
- package/dist/os/git-bash-candidates.d.ts.map +1 -0
- package/dist/os/git-bash-candidates.js +46 -0
- package/dist/os/git-bash-candidates.js.map +1 -0
- package/dist/os/index.d.ts +13 -4
- package/dist/os/index.d.ts.map +1 -1
- package/dist/os/index.js +17 -2
- package/dist/os/index.js.map +1 -1
- package/dist/os/linux.js +1 -1
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +7 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/os-commands.js.map +1 -1
- package/dist/os/windows-gitbash.d.ts +93 -0
- package/dist/os/windows-gitbash.d.ts.map +1 -0
- package/dist/os/windows-gitbash.js +244 -0
- package/dist/os/windows-gitbash.js.map +1 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +27 -5
- package/dist/os/windows.js.map +1 -1
- package/dist/providers/agy.d.ts +3 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +11 -2
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +3 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +22 -3
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +3 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +5 -2
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +3 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +7 -2
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/index.d.ts +0 -1
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +0 -3
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +3 -2
- package/dist/providers/none.d.ts.map +1 -1
- package/dist/providers/none.js +5 -2
- package/dist/providers/none.js.map +1 -1
- package/dist/providers/opencode.d.ts +3 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +5 -2
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +16 -7
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +2 -2
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.js +2 -2
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/cloud/activity.js +2 -2
- package/dist/services/cloud/activity.js.map +1 -1
- package/dist/services/context-admission.d.ts.map +1 -1
- package/dist/services/context-admission.js +9 -7
- package/dist/services/context-admission.js.map +1 -1
- package/dist/services/credential-cleanup.d.ts.map +1 -1
- package/dist/services/credential-cleanup.js +22 -3
- package/dist/services/credential-cleanup.js.map +1 -1
- package/dist/services/member-home.d.ts +1 -1
- package/dist/services/member-home.d.ts.map +1 -1
- package/dist/services/member-home.js +15 -12
- package/dist/services/member-home.js.map +1 -1
- package/dist/services/model-pricing.d.ts.map +1 -1
- package/dist/services/model-pricing.js +0 -5
- package/dist/services/model-pricing.js.map +1 -1
- package/dist/services/orphan-recovery.d.ts +6 -3
- package/dist/services/orphan-recovery.d.ts.map +1 -1
- package/dist/services/orphan-recovery.js +17 -14
- package/dist/services/orphan-recovery.js.map +1 -1
- package/dist/services/preflight-check.js +2 -2
- package/dist/services/preflight-check.js.map +1 -1
- package/dist/services/shell-probe.d.ts +131 -0
- package/dist/services/shell-probe.d.ts.map +1 -0
- package/dist/services/shell-probe.js +210 -0
- package/dist/services/shell-probe.js.map +1 -0
- package/dist/services/singleton.d.ts +2 -0
- package/dist/services/singleton.d.ts.map +1 -1
- package/dist/services/singleton.js +1 -1
- package/dist/services/singleton.js.map +1 -1
- package/dist/services/ssh.js +2 -2
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/find-log-file.d.ts.map +1 -1
- package/dist/services/stall/find-log-file.js +22 -16
- package/dist/services/stall/find-log-file.js.map +1 -1
- package/dist/services/stall/read-log-tail.d.ts.map +1 -1
- package/dist/services/stall/read-log-tail.js +6 -5
- package/dist/services/stall/read-log-tail.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +35 -42
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts +9 -0
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +40 -6
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/user-config.js +1 -1
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/azure-devops.d.ts +1 -1
- package/dist/services/vcs/azure-devops.d.ts.map +1 -1
- package/dist/services/vcs/azure-devops.js +105 -10
- package/dist/services/vcs/azure-devops.js.map +1 -1
- package/dist/services/vcs/bitbucket.d.ts.map +1 -1
- package/dist/services/vcs/bitbucket.js +16 -0
- package/dist/services/vcs/bitbucket.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +24 -0
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +123 -2
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +2 -1
- package/dist/skills/pm/SKILL.md +0 -1
- package/dist/skills/pm/cost.md +0 -1
- package/dist/skills/pm/fleet-addendum.md +0 -1
- package/dist/tools/check-status.js +3 -3
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/cloud-control.js +2 -2
- package/dist/tools/cloud-control.js.map +1 -1
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +37 -24
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +28 -12
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +55 -18
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +5 -3
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts.map +1 -1
- package/dist/tools/member-reservation.js +13 -1
- package/dist/tools/member-reservation.js.map +1 -1
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +17 -2
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.js +5 -5
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +5 -2
- package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
- package/dist/tools/provision-vcs-auth.js +58 -52
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +18 -12
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +42 -4
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.js +2 -2
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/revoke-vcs-auth.js +2 -2
- package/dist/tools/revoke-vcs-auth.js.map +1 -1
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -1
- package/dist/tools/setup-ssh-key.js.map +1 -1
- package/dist/tools/stop-prompt.js +2 -2
- package/dist/tools/stop-prompt.js.map +1 -1
- package/dist/tools/update-agent-cli.js +2 -2
- package/dist/tools/update-agent-cli.js.map +1 -1
- package/dist/tools/update-member.d.ts +18 -12
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +18 -1
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +11 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +36 -0
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +39 -1
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/platform.d.ts +7 -0
- package/dist/utils/platform.d.ts.map +1 -1
- package/dist/utils/platform.js +11 -1
- package/dist/utils/platform.js.map +1 -1
- package/dist/utils/workspace-trust.d.ts.map +1 -1
- package/dist/utils/workspace-trust.js +5 -1
- package/dist/utils/workspace-trust.js.map +1 -1
- package/dist/workflows/auto-sprint.js +4 -17
- package/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +92 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +17 -21
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +3 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +22 -44
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +131 -132
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +20 -32
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +81 -113
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +31 -42
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +32 -44
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +51 -63
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +65 -80
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +56 -83
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +0 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +0 -1
- package/packages/apra-fleet-se/bin/cli.mjs +132 -3
- package/packages/apra-fleet-se/bin/serve.mjs +36 -1
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +151 -33
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +22 -7
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +9 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +2 -2
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +67 -16
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +41 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1140 -209
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +154 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +2 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +51 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +657 -12
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +60 -43
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +205 -2
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +164 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +92 -37
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +167 -1
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +435 -31
- package/skills/fleet/SKILL.md +20 -9
- package/skills/fleet/auth-azdevops.md +44 -5
- package/skills/fleet/auth-bitbucket.md +3 -3
- package/skills/fleet/auth-github.md +2 -2
- package/skills/fleet/beads-conflict-resolution.md +141 -0
- package/skills/fleet/beads.md +16 -12
- package/skills/fleet/onboarding.md +4 -4
- package/skills/fleet/permissions.md +6 -6
- package/skills/fleet/skill-matrix.md +1 -1
- package/skills/fleet/troubleshooting.md +2 -1
- package/version.json +1 -1
- package/dist/providers/gemini.d.ts +0 -52
- package/dist/providers/gemini.d.ts.map +0 -1
- package/dist/providers/gemini.js +0 -236
- package/dist/providers/gemini.js.map +0 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
*/
|
|
4
4
|
import type { Agent } from '../types.js';
|
|
5
5
|
import type { RemoteOS } from './platform.js';
|
|
6
|
+
import type { MemberShell } from '../os/os-commands.js';
|
|
6
7
|
/**
|
|
7
8
|
* Look up an agent by ID or return a formatted error string.
|
|
8
9
|
* Eliminates the repeated pattern of getAgent() + "not found" check in every tool.
|
|
@@ -13,6 +14,41 @@ export declare function getAgentOrFail(id: string): Agent | string;
|
|
|
13
14
|
* Eliminates repeated `agent.os ?? 'linux'` casts.
|
|
14
15
|
*/
|
|
15
16
|
export declare function getAgentOS(agent: Agent): RemoteOS;
|
|
17
|
+
/**
|
|
18
|
+
* Get the registered shell for an agent (undefined if none recorded/detected).
|
|
19
|
+
* Pass alongside getAgentOS() to getOsCommands() so a gitbash Windows member
|
|
20
|
+
* resolves to bash command strings instead of the PowerShell default.
|
|
21
|
+
*/
|
|
22
|
+
export declare function getAgentShell(agent: Agent): MemberShell | undefined;
|
|
23
|
+
/**
|
|
24
|
+
* True when `os`/`shell` resolve to a POSIX-speaking shell -- any non-Windows
|
|
25
|
+
* OS, or a Windows member registered as Git-for-Windows bash
|
|
26
|
+
* (apra-fleet-7dir.2.4/2.5). A Windows member with no shell recorded, or
|
|
27
|
+
* pwsh7/powershell5, still resolves to PowerShell exactly as before.
|
|
28
|
+
*
|
|
29
|
+
* THE single definition of this predicate (apra-fleet-7dir.11) -- every
|
|
30
|
+
* former private copy (member-home.ts, orphan-recovery.ts,
|
|
31
|
+
* compose-permissions.ts, execute-prompt.ts's isPosixShellMember) now calls
|
|
32
|
+
* through here so a future shell enum value (WSL, cmd) is added in exactly
|
|
33
|
+
* one place.
|
|
34
|
+
*
|
|
35
|
+
* The first parameter also accepts a plain `isWindows` boolean, for the one
|
|
36
|
+
* call site (compose-permissions.ts) that only ever had a boolean on hand --
|
|
37
|
+
* behaviourally identical to passing 'windows' / a non-windows RemoteOS,
|
|
38
|
+
* kept as an overload rather than forcing that caller to synthesize a
|
|
39
|
+
* RemoteOS value it doesn't otherwise need. `os: RemoteOS` also accepts a
|
|
40
|
+
* `TargetOS` (src/providers/provider.ts) value as-is: the two are the same
|
|
41
|
+
* three-value string union, just declared independently.
|
|
42
|
+
*/
|
|
43
|
+
export declare function isPosixShell(os: RemoteOS, shell?: MemberShell): boolean;
|
|
44
|
+
export declare function isPosixShell(isWindows: boolean, shell?: MemberShell): boolean;
|
|
45
|
+
/**
|
|
46
|
+
* Agent-taking convenience wrapper around isPosixShell -- reads the member's
|
|
47
|
+
* os/shell off the Agent itself instead of requiring the caller to unpack
|
|
48
|
+
* getAgentOS(agent)/getAgentShell(agent) first (apra-fleet-7dir.11; formerly
|
|
49
|
+
* execute-prompt.ts's private isPosixShellMember).
|
|
50
|
+
*/
|
|
51
|
+
export declare function isPosixShellMember(agent: Agent): boolean;
|
|
16
52
|
/**
|
|
17
53
|
* Format a host label for display.
|
|
18
54
|
* Local agents show "(local)", relay agents show "(relay)", remote agents
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/agent-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"agent-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/agent-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;AACzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;AAM/E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIpD;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAEpE;AAmBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAgBvF;AAOD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GAClD;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAarD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAOpE"}
|
|
@@ -17,6 +17,27 @@ export function getAgentOrFail(id) {
|
|
|
17
17
|
export function getAgentOS(agent) {
|
|
18
18
|
return (agent.os ?? 'linux');
|
|
19
19
|
}
|
|
20
|
+
/**
|
|
21
|
+
* Get the registered shell for an agent (undefined if none recorded/detected).
|
|
22
|
+
* Pass alongside getAgentOS() to getOsCommands() so a gitbash Windows member
|
|
23
|
+
* resolves to bash command strings instead of the PowerShell default.
|
|
24
|
+
*/
|
|
25
|
+
export function getAgentShell(agent) {
|
|
26
|
+
return agent.shell;
|
|
27
|
+
}
|
|
28
|
+
export function isPosixShell(osOrIsWindows, shell) {
|
|
29
|
+
const isWindows = typeof osOrIsWindows === 'boolean' ? osOrIsWindows : osOrIsWindows === 'windows';
|
|
30
|
+
return !isWindows || shell === 'gitbash';
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Agent-taking convenience wrapper around isPosixShell -- reads the member's
|
|
34
|
+
* os/shell off the Agent itself instead of requiring the caller to unpack
|
|
35
|
+
* getAgentOS(agent)/getAgentShell(agent) first (apra-fleet-7dir.11; formerly
|
|
36
|
+
* execute-prompt.ts's private isPosixShellMember).
|
|
37
|
+
*/
|
|
38
|
+
export function isPosixShellMember(agent) {
|
|
39
|
+
return isPosixShell(getAgentOS(agent), getAgentShell(agent));
|
|
40
|
+
}
|
|
20
41
|
/**
|
|
21
42
|
* Format a host label for display.
|
|
22
43
|
* Local agents show "(local)", relay agents show "(relay)", remote agents
|
|
@@ -40,7 +61,20 @@ let idleTouchHook;
|
|
|
40
61
|
export function setIdleTouchHook(fn) {
|
|
41
62
|
idleTouchHook = fn;
|
|
42
63
|
}
|
|
43
|
-
const EXPIRY_WARNING_MS = 10 * 60 * 1000; // 10 minutes
|
|
64
|
+
const EXPIRY_WARNING_MS = 10 * 60 * 1000; // 10 minutes -- sized for GitHub App tokens (~1hr lifetime)
|
|
65
|
+
// apra-fleet-5co8.5.1: long-lived PAT providers (Azure DevOps PATs run
|
|
66
|
+
// weeks/months per skills/fleet/auth-azdevops.md's "Set expiration"
|
|
67
|
+
// guidance, unlike a GitHub App token's ~1hr lifetime the 10-minute
|
|
68
|
+
// threshold above was designed for) need a heads-up long before the
|
|
69
|
+
// minute-scale check above would ever fire.
|
|
70
|
+
const DAY_SCALE_WARNING_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
|
|
71
|
+
// apra-fleet-5co8.5.1: providers this day-scale threshold applies to.
|
|
72
|
+
// Deliberately scoped by provider rather than made unconditional: a
|
|
73
|
+
// GitHub App token's remaining lifetime is always well inside 7 days, so an
|
|
74
|
+
// unscoped check would spuriously warn on every fresh GitHub deploy and
|
|
75
|
+
// change existing GitHub short-lived-token behavior (see
|
|
76
|
+
// agent-helpers.test.ts 'returns null when token is not near expiry').
|
|
77
|
+
const DAY_SCALE_WARNING_PROVIDERS = new Set(['azure-devops']);
|
|
44
78
|
/**
|
|
45
79
|
* Check if an agent's VCS token is expired or expiring soon.
|
|
46
80
|
* Returns a warning string if action is needed, or null if OK / no expiry tracked.
|
|
@@ -57,6 +91,10 @@ export function checkVcsTokenExpiry(agent, now = new Date()) {
|
|
|
57
91
|
const mins = Math.ceil(remaining / 60000);
|
|
58
92
|
return `⚠️ VCS token expires in ${mins} minute${mins === 1 ? '' : 's'} (${agent.vcsTokenExpiresAt}) — consider refreshing.`;
|
|
59
93
|
}
|
|
94
|
+
if (agent.vcsProvider && DAY_SCALE_WARNING_PROVIDERS.has(agent.vcsProvider) && remaining <= DAY_SCALE_WARNING_MS) {
|
|
95
|
+
const days = Math.ceil(remaining / (24 * 60 * 60 * 1000));
|
|
96
|
+
return `⚠️ VCS token expires in ${days} day${days === 1 ? '' : 's'} (${agent.vcsTokenExpiresAt}) — consider refreshing.`;
|
|
97
|
+
}
|
|
60
98
|
return null;
|
|
61
99
|
}
|
|
62
100
|
// In-memory PID store — transient, lives only for the server process lifetime.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-helpers.js","sourceRoot":"","sources":["../../src/utils/agent-helpers.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"agent-helpers.js","sourceRoot":"","sources":["../../src/utils/agent-helpers.ts"],"names":[],"mappings":"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"}
|
package/dist/utils/platform.d.ts
CHANGED
|
@@ -9,5 +9,12 @@ export declare function isContainedInWorkFolder(workFolder: string, remotePath:
|
|
|
9
9
|
* that path.posix.resolve incorrectly treats as relative (since they don't start with '/').
|
|
10
10
|
*/
|
|
11
11
|
export declare function resolveRemotePath(workFolder: string, subPath: string): string;
|
|
12
|
+
/**
|
|
13
|
+
* True when `uname -s` output identifies a POSIX-emulation layer running on
|
|
14
|
+
* Windows (Git-for-Windows / MSYS2 / Cygwin). This is the ONLY reliable way to
|
|
15
|
+
* tell a Git-for-Windows bash.exe apart from the WSL launcher of the same name
|
|
16
|
+
* under System32: the WSL one also exits 0 but reports "Linux".
|
|
17
|
+
*/
|
|
18
|
+
export declare function isWindowsPosixUname(unameOutput: string): boolean;
|
|
12
19
|
export declare function detectOS(unameOutput: string, verOutput: string): RemoteOS;
|
|
13
20
|
//# sourceMappingURL=platform.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAErD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAqBvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW7E;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAWzE"}
|
|
1
|
+
{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAErD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAqBvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW7E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAWzE"}
|
package/dist/utils/platform.js
CHANGED
|
@@ -44,6 +44,16 @@ export function resolveRemotePath(workFolder, subPath) {
|
|
|
44
44
|
return path.posix.resolve(normWorkFolder, normSubPath);
|
|
45
45
|
}
|
|
46
46
|
}
|
|
47
|
+
/**
|
|
48
|
+
* True when `uname -s` output identifies a POSIX-emulation layer running on
|
|
49
|
+
* Windows (Git-for-Windows / MSYS2 / Cygwin). This is the ONLY reliable way to
|
|
50
|
+
* tell a Git-for-Windows bash.exe apart from the WSL launcher of the same name
|
|
51
|
+
* under System32: the WSL one also exits 0 but reports "Linux".
|
|
52
|
+
*/
|
|
53
|
+
export function isWindowsPosixUname(unameOutput) {
|
|
54
|
+
const uname = unameOutput.trim().toLowerCase();
|
|
55
|
+
return uname.startsWith('mingw') || uname.startsWith('msys') || uname.startsWith('cygwin');
|
|
56
|
+
}
|
|
47
57
|
export function detectOS(unameOutput, verOutput) {
|
|
48
58
|
if (verOutput.toLowerCase().includes('windows') || verOutput.toLowerCase().includes('microsoft')) {
|
|
49
59
|
return 'windows';
|
|
@@ -52,7 +62,7 @@ export function detectOS(unameOutput, verOutput) {
|
|
|
52
62
|
if (uname === 'darwin')
|
|
53
63
|
return 'macos';
|
|
54
64
|
// Git Bash / MSYS2 / Cygwin on Windows report MINGW*, MSYS*, or CYGWIN*
|
|
55
|
-
if (
|
|
65
|
+
if (isWindowsPosixUname(unameOutput)) {
|
|
56
66
|
return 'windows';
|
|
57
67
|
}
|
|
58
68
|
return 'linux';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,UAAkB;IAC5E,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE9D,IAAI,QAAgB,CAAC;IACrB,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,cAAc,EAAE,CAAC;QACnF,4FAA4F;QAC5F,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAAC,CAAC;iBAC9B,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;QAC9C,CAAC;QACD,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,QAAQ,KAAK,cAAc,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,cAAc,GAAG,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,OAAe;IACnE,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE9D,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACjF,OAAO,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,WAAW,EAAE,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,SAAiB;IAC7D,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjG,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IACvC,wEAAwE;IACxE,IAAI,
|
|
1
|
+
{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspace-trust.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;
|
|
1
|
+
{"version":3,"file":"workspace-trust.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvH"}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { getStrategy } from '../services/strategy.js';
|
|
2
2
|
import { getProvider } from '../providers/index.js';
|
|
3
|
+
import { getAgentShell } from './agent-helpers.js';
|
|
3
4
|
import { logLine, logWarn } from './log-helpers.js';
|
|
4
5
|
/**
|
|
5
6
|
* Idempotently seeds Claude workspace trust for `agent`'s work folder
|
|
@@ -25,7 +26,10 @@ export async function seedWorkspaceTrust(agent, strategy, tag = 'workspace-trust
|
|
|
25
26
|
try {
|
|
26
27
|
const provider = getProvider(agent.llmProvider);
|
|
27
28
|
const strat = strategy ?? getStrategy(agent);
|
|
28
|
-
const result = await provider.ensureWorkspaceTrusted(agent.workFolder, (command, timeoutMs) => strat.execCommand(command, timeoutMs), agent.os
|
|
29
|
+
const result = await provider.ensureWorkspaceTrusted(agent.workFolder, (command, timeoutMs) => strat.execCommand(command, timeoutMs), agent.os,
|
|
30
|
+
// The member's REGISTERED shell, not just its OS: a gitbash Windows
|
|
31
|
+
// member needs POSIX trust-seeding strings (apra-fleet-7dir.2.8).
|
|
32
|
+
getAgentShell(agent));
|
|
29
33
|
logLine(tag, `workspace trust for "${agent.friendlyName}": ${result.detail}`, agent);
|
|
30
34
|
}
|
|
31
35
|
catch (e) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspace-trust.js","sourceRoot":"","sources":["../../src/utils/workspace-trust.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAY,EAAE,QAAwB,EAAE,GAAG,GAAG,iBAAiB;IACtG,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,QAAQ,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,sBAAsB,CAClD,KAAK,CAAC,UAAU,EAChB,CAAC,OAAe,EAAE,SAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,EAC9E,KAAK,CAAC,EAAE,
|
|
1
|
+
{"version":3,"file":"workspace-trust.js","sourceRoot":"","sources":["../../src/utils/workspace-trust.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAY,EAAE,QAAwB,EAAE,GAAG,GAAG,iBAAiB;IACtG,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,QAAQ,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,sBAAsB,CAClD,KAAK,CAAC,UAAU,EAChB,CAAC,OAAe,EAAE,SAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,EAC9E,KAAK,CAAC,EAAE;QACR,oEAAoE;QACpE,kEAAkE;QAClE,aAAa,CAAC,KAAK,CAAC,CACrB,CAAC;QACF,OAAO,CAAC,GAAG,EAAE,wBAAwB,KAAK,CAAC,YAAY,MAAM,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,EAAE,sCAAsC,KAAK,CAAC,YAAY,kBAAkB,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACnH,CAAC;AACH,CAAC"}
|
|
@@ -1612,7 +1612,7 @@ const INTEG_RUN_SCHEMA = {
|
|
|
1612
1612
|
},
|
|
1613
1613
|
"deployedSha": {
|
|
1614
1614
|
"type": "string",
|
|
1615
|
-
"description": "The
|
|
1615
|
+
"description": "The git commit the verification actually ran against. Optional for backward compatibility, but an orchestrator that supplied a deployed SHA in the dispatch prompt treats a missing or mismatching value as INCONCLUSIVE evidence (never a pass). See integ-test-runner.md Step 4."
|
|
1616
1616
|
},
|
|
1617
1617
|
"verifySetClosed": {
|
|
1618
1618
|
"type": "array",
|
|
@@ -1689,7 +1689,7 @@ const REGRESSION_RUN_SCHEMA = {
|
|
|
1689
1689
|
},
|
|
1690
1690
|
"smokePassed": {
|
|
1691
1691
|
"type": "boolean",
|
|
1692
|
-
"description": "Result of playbook Part 2 -- the
|
|
1692
|
+
"description": "Result of playbook Part 2 -- the sandbox smoke test."
|
|
1693
1693
|
},
|
|
1694
1694
|
"bugsFiled": {
|
|
1695
1695
|
"type": "array",
|
|
@@ -1704,21 +1704,8 @@ const REGRESSION_RUN_SCHEMA = {
|
|
|
1704
1704
|
},
|
|
1705
1705
|
"smokeEvidence": {
|
|
1706
1706
|
"type": "object",
|
|
1707
|
-
"
|
|
1708
|
-
"
|
|
1709
|
-
"versionStdout": {
|
|
1710
|
-
"type": "string",
|
|
1711
|
-
"description": "Verbatim stdout of running the toy CLI's --version on the sprint branch."
|
|
1712
|
-
},
|
|
1713
|
-
"canaryStatus": {
|
|
1714
|
-
"type": "string",
|
|
1715
|
-
"description": "The status field from `bd show gh-toy-4ef` (e.g. \"closed\")."
|
|
1716
|
-
},
|
|
1717
|
-
"toyRepoHeadSha": {
|
|
1718
|
-
"type": "string",
|
|
1719
|
-
"description": "The toy repo's head commit SHA after the toy sprint."
|
|
1720
|
-
}
|
|
1721
|
-
}
|
|
1707
|
+
"additionalProperties": true,
|
|
1708
|
+
"description": "Optional structured evidence from Part 2 (the target repo's own smoke test), so the result is machine-checkable instead of self-reported prose. This schema does not define its shape -- the target repo's regression-test-playbook.md (Part 2 / smoke test section) does. Omit if that playbook defines no structured evidence."
|
|
1722
1709
|
}
|
|
1723
1710
|
}
|
|
1724
1711
|
};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@apralabs/apra-fleet",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.2",
|
|
4
4
|
"description": "MCP server for orchestrating multiple agentic AI instances (Claude, Gemini, Codex, Copilot, AGY) across machines via SSH",
|
|
5
5
|
"author": "Apra Labs",
|
|
6
6
|
"homepage": "https://github.com/Apra-Labs/apra-fleet",
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
"apra-fleet": "dist/index.js"
|
|
24
24
|
},
|
|
25
25
|
"engines": {
|
|
26
|
-
"node": ">=22.
|
|
26
|
+
"node": ">=22.16.0"
|
|
27
27
|
},
|
|
28
28
|
"files": [
|
|
29
29
|
"dist/",
|
|
@@ -100,10 +100,25 @@
|
|
|
100
100
|
* @property {"password" | "key"} [auth_type] - Authentication method
|
|
101
101
|
* @property {string} [password] - SSH password
|
|
102
102
|
* @property {string} [key_path] - Path to SSH private key
|
|
103
|
-
* @property {
|
|
103
|
+
* @property {"read" | "push" | "admin" | "issues" | "full"} [git_access] - Git access level for this member
|
|
104
|
+
* @property {string[]} [git_repos] - Git repositories this member can access (e.g. ["Apra-Labs/ApraPipes"])
|
|
105
|
+
* @property {"aws"} [cloud_provider] - Cloud provider. When set, cloud_instance_id and key_path are required.
|
|
106
|
+
* @property {string} [cloud_instance_id] - EC2 instance ID (e.g. "i-0abc123def456789a"). Required when cloud_provider is set.
|
|
107
|
+
* @property {string} [cloud_region] - AWS region (default: "us-east-1")
|
|
108
|
+
* @property {string} [cloud_profile] - AWS CLI profile name (e.g. "apra")
|
|
109
|
+
* @property {number} [cloud_idle_timeout_min] - Minutes of inactivity before auto-stop (default: 30)
|
|
110
|
+
* @property {string} [cloud_activity_command] - Custom shell command for workload detection. Must output "busy" or "idle" on stdout.
|
|
111
|
+
* @property {"claude" | "codex" | "copilot" | "agy" | "opencode" | "none"} [llm_provider] - LLM provider for this member (default: "claude")
|
|
112
|
+
* @property {"gpt-oss-120b" | "gpt-120" | "gemini-3.5-flash-lite" | "haiku" | "gpt-5.4-mini"} [model_cheap] - Custom cheap model choice from a curated list
|
|
113
|
+
* @property {"gemini-3.5-flash" | "gpt-oss-120b" | "gpt-120" | "sonnet" | "gpt-5.4"} [model_standard] - Custom standard model choice from a curated list
|
|
114
|
+
* @property {"sonnet" | "opus" | "gpt-oss-120b"} [model_premium] - Custom premium model choice from a curated list
|
|
115
|
+
* @property {{cheap?: string, standard?: string, premium?: string}} [model_tiers] - Per-member model tier map. A single model fills all tiers.
|
|
116
|
+
* @property {"codebase-memory" | "gitnexus" | "none"} [code_intel_provider] - Code-intelligence provider for this member (default: fleet-wide config)
|
|
104
117
|
* @property {string} [category] - Optional group label
|
|
105
118
|
* @property {string[]} [tags] - Optional list of free-form labels
|
|
106
119
|
* @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode for unattended execution
|
|
120
|
+
* @property {boolean} [unreservable] - Mark this member as never exclusively reservable, so it can be shared by more than one sprint at once (e.g. fleet-sprint's shared "orchestrator" role)
|
|
121
|
+
* @property {"gitbash" | "pwsh7" | "powershell5"} [shell] - Override the probed Windows shell for this member. Windows members only -- ignored for non-windows members.
|
|
107
122
|
*/
|
|
108
123
|
|
|
109
124
|
/**
|
|
@@ -117,11 +132,54 @@
|
|
|
117
132
|
* @property {number} [port] - New SSH port
|
|
118
133
|
* @property {"password" | "key"} [auth_type] - New auth method
|
|
119
134
|
* @property {string} [password] - New SSH password
|
|
135
|
+
* @property {boolean} [rotate_password] - Trigger secure out-of-band password re-entry for a member already using password auth. Ignored if auth_type is not password.
|
|
120
136
|
* @property {string} [key_path] - New SSH private key path
|
|
121
|
-
* @property {
|
|
137
|
+
* @property {"read" | "push" | "admin" | "issues" | "full"} [git_access] - Git access level for this member
|
|
138
|
+
* @property {string[]} [git_repos] - Git repositories this member can access (e.g. ["Apra-Labs/ApraPipes"])
|
|
139
|
+
* @property {string} [icon] - Override the auto-assigned emoji icon. Use named aliases (e.g. blue-circle, green-square) or a raw emoji.
|
|
140
|
+
* @property {string} [cloud_region] - AWS region for the cloud instance
|
|
141
|
+
* @property {string} [cloud_profile] - AWS CLI profile name
|
|
142
|
+
* @property {number} [cloud_idle_timeout_min] - Minutes of inactivity before auto-stop
|
|
143
|
+
* @property {string} [cloud_activity_command] - Custom shell command for workload detection. Must output "busy" or "idle". Pass empty string to clear.
|
|
144
|
+
* @property {"claude" | "codex" | "copilot" | "agy" | "opencode"} [llm_provider] - Change the LLM provider
|
|
145
|
+
* @property {"gpt-oss-120b" | "gpt-120" | "gemini-3.5-flash-lite" | "haiku" | "gpt-5.4-mini"} [model_cheap] - Change custom cheap model
|
|
146
|
+
* @property {"gemini-3.5-flash" | "gpt-oss-120b" | "gpt-120" | "sonnet" | "gpt-5.4"} [model_standard] - Change custom standard model
|
|
147
|
+
* @property {"sonnet" | "opus" | "gpt-oss-120b"} [model_premium] - Change custom premium model
|
|
148
|
+
* @property {{cheap?: string, standard?: string, premium?: string}} [model_tiers] - Per-member model tier map with free-form model IDs. A single model fills all tiers.
|
|
149
|
+
* @property {"codebase-memory" | "gitnexus" | "none"} [code_intel_provider] - Change the code-intelligence provider for this member
|
|
122
150
|
* @property {string} [category] - Group label
|
|
123
151
|
* @property {string[]} [tags] - Free-form labels
|
|
124
152
|
* @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode
|
|
153
|
+
* @property {boolean} [unreservable] - Mark/unmark this member as shared/never exclusively reservable
|
|
154
|
+
* @property {"gitbash" | "pwsh7" | "powershell5"} [shell] - Override the probed Windows shell for this member. Windows members only -- ignored for non-windows members.
|
|
155
|
+
*/
|
|
156
|
+
|
|
157
|
+
/**
|
|
158
|
+
* Structured result returned by memberDetail() when called with format: 'json'
|
|
159
|
+
* (src/tools/member-detail.ts). When format is 'compact' (the default), memberDetail()
|
|
160
|
+
* instead returns a plain multi-line text summary, not this shape.
|
|
161
|
+
* @typedef {Object} MemberDetailResult
|
|
162
|
+
* @property {string} server_version - Fleet server version string
|
|
163
|
+
* @property {string} name - Friendly name of the member
|
|
164
|
+
* @property {string} icon - Emoji icon for this member
|
|
165
|
+
* @property {string} id - UUID of the member
|
|
166
|
+
* @property {"local" | "remote"} type - Member type
|
|
167
|
+
* @property {string} host - "(local)" for local members, or "host:port" for remote members
|
|
168
|
+
* @property {string} [username] - SSH username (remote members)
|
|
169
|
+
* @property {string} os - Detected/registered operating system
|
|
170
|
+
* @property {"gitbash" | "pwsh7" | "powershell5"} [shell] - Registered Windows shell for this member (Windows members only)
|
|
171
|
+
* @property {string} folder - Working directory on the target machine
|
|
172
|
+
* @property {string} [repo_remote_url] - Origin URL of the git repo in `folder`, when known
|
|
173
|
+
* @property {string} [vcsProvider] - VCS provider configured for this member
|
|
174
|
+
* @property {Object} connectivity - Connectivity check result (status, latencyMs, auth, keyPath, or error)
|
|
175
|
+
* @property {boolean} [offline] - Set when the member could not be reached
|
|
176
|
+
* @property {string} llmProvider - LLM provider for this member (default: "claude")
|
|
177
|
+
* @property {Object} [llm_cli] - LLM CLI info: { version, auth }
|
|
178
|
+
* @property {Object|string} [tokenUsage] - Cumulative token usage, or "compute only" for llmProvider "none"
|
|
179
|
+
* @property {Object} [session] - Session info: { id, lastActivity, lastLlmActivityAt, status, idleSecs }
|
|
180
|
+
* @property {Object} [resources] - System resource snapshot: { cpu, memory, disk, gpu }
|
|
181
|
+
* @property {string} [branch] - Current git branch in `folder`, when it is a git repo
|
|
182
|
+
* @property {Object} [cloud] - Cloud instance details, for cloud-backed members only
|
|
125
183
|
*/
|
|
126
184
|
|
|
127
185
|
/**
|
|
@@ -162,6 +220,35 @@
|
|
|
162
220
|
* @property {string} [org_url] - Azure DevOps organization URL (e.g. https://dev.azure.com/myorg)
|
|
163
221
|
* @property {string} [pat] - Azure DevOps personal access token. Supports {{secure.NAME}}
|
|
164
222
|
* token -- resolved from the credential store server-side before use.
|
|
223
|
+
* @property {string} [pat_expires_at] - ISO 8601 date/time the Azure DevOps PAT expires, as
|
|
224
|
+
* chosen when creating the token. Propagated to the member registry so provisioning can
|
|
225
|
+
* warn when the PAT is nearing expiry. Must be parseable by Date.parse -- the server
|
|
226
|
+
* REJECTS an unparseable value rather than storing it, because a NaN expiry silences the
|
|
227
|
+
* warning and makes the credential-cleanup timer fall back to its 55-minute default.
|
|
228
|
+
*/
|
|
229
|
+
|
|
230
|
+
/**
|
|
231
|
+
* @typedef {Object} VcsPullRequestResponseMapping
|
|
232
|
+
* @property {string} idField - Body field carrying the PR identifier
|
|
233
|
+
* (GitHub: 'number', Azure DevOps: 'pullRequestId').
|
|
234
|
+
* @property {string|null} webUrlField - Body field carrying the browsable PR
|
|
235
|
+
* URL, or null when the body carries none (Azure DevOps).
|
|
236
|
+
* @property {string|null} webUrlTemplate - Template to CONSTRUCT the
|
|
237
|
+
* browsable URL when webUrlField is null, or null when the URL is read
|
|
238
|
+
* straight from the body.
|
|
239
|
+
*
|
|
240
|
+
* Mirrors the `pullRequestResponse` descriptor hook (apra-fleet-lzfv.4) from
|
|
241
|
+
* packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs and the
|
|
242
|
+
* canonical src/services/vcs/types.ts `VcsPullRequestResponseMapping`
|
|
243
|
+
* field-for-field, so the fleet-sprint provider registry, the server-side
|
|
244
|
+
* VCS contract and this client never drift. Declaration-only: the
|
|
245
|
+
* executable `map(body, ctx)` the JS descriptor also carries is
|
|
246
|
+
* deliberately NOT restated here, because index.mjs's own contract comment
|
|
247
|
+
* says a mirroring consumer restates `idField`/`webUrlField`/
|
|
248
|
+
* `webUrlTemplate` while `map` stays the single executable source of truth
|
|
249
|
+
* that reads those same declared fields. This typedef is declarative-only
|
|
250
|
+
* today: no MCP tool in this client yet returns a create-pull-request
|
|
251
|
+
* response for a caller to map.
|
|
165
252
|
*/
|
|
166
253
|
|
|
167
254
|
/**
|
|
@@ -319,8 +406,10 @@ export class ApraFleet {
|
|
|
319
406
|
}
|
|
320
407
|
|
|
321
408
|
/**
|
|
322
|
-
* Get detailed status for one member: connectivity, session, work folder, provider.
|
|
409
|
+
* Get detailed status for one member: connectivity, session, work folder, provider, registered shell (Windows).
|
|
323
410
|
* @param {{ member_id?: string, member_name?: string, format?: 'compact'|'json' }} options
|
|
411
|
+
* @returns {Promise<string|MemberDetailResult>} A compact text summary when format is
|
|
412
|
+
* "compact" (default), or the structured MemberDetailResult object when format is "json".
|
|
324
413
|
*/
|
|
325
414
|
async memberDetail(options) {
|
|
326
415
|
return this.mcpClient.callTool('member_detail', options);
|
|
@@ -16,9 +16,7 @@ analyze AND mutate beads directly -- but you never touch code beyond reading it.
|
|
|
16
16
|
2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo whose backlog
|
|
17
17
|
you are grooming, and `hint_modules` naming the subsystems the assigned beads touch.
|
|
18
18
|
Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts. This matters
|
|
19
|
-
most for duplicate detection and sprint-set grouping
|
|
20
|
-
are often the same underlying issue, and the KB is where that has already been written
|
|
21
|
-
down.
|
|
19
|
+
most for duplicate detection and sprint-set grouping.
|
|
22
20
|
3. When grooming turns up a durable backlog fact -- two ids that are genuinely the same
|
|
23
21
|
work, a dependency between beads that their text does not state, or a recurring reason
|
|
24
22
|
items land unactionable -- call `mcp__apra-fleet__kb_capture` with type "knowledge".
|
|
@@ -94,24 +92,23 @@ The canonical machine-readable contract lives in the sibling file
|
|
|
94
92
|
|
|
95
93
|
## Beads semantics
|
|
96
94
|
|
|
97
|
-
|
|
95
|
+
Graph semantics (`parent-child` = grouping, `blocks` = ordering, epic rules, `bd epic
|
|
96
|
+
status` gotchas) are canonical in `_shared/GRAPH-SEMANTICS.md`, the sibling file
|
|
97
|
+
installed alongside this one -- read it; do not restate or improvise those rules here.
|
|
98
|
+
Semantics specific to this role:
|
|
99
|
+
|
|
98
100
|
- `assignee` is set explicitly (`bd update <id> --assignee <identity>`) or via
|
|
99
101
|
`bd update <id> --claim` (also flips status to `in_progress`). Fall back to `owner`
|
|
100
|
-
(static, set
|
|
101
|
-
-
|
|
102
|
-
|
|
103
|
-
`open`/`in_progress`.
|
|
104
|
-
- `epic -> feature -> task` is a loose convention. The one hard rule: an epic may
|
|
105
|
-
`blocks` only another epic -- bd does not enforce same-type pairs.
|
|
106
|
-
- `bd epic status <id>` only rolls up correctly when `<id>` is actually typed `epic`;
|
|
107
|
-
on a non-epic id it silently returns unrelated epics.
|
|
102
|
+
(static, set at creation) only when `assignee` is empty.
|
|
103
|
+
- Only three things hide a bead from ready work: an unclosed child, an unmet `blocks`
|
|
104
|
+
dependency, or status not `open`/`in_progress`. `issue_type` never does.
|
|
108
105
|
- `gate` (`bd create --type=gate --await-type=<kind> --await-id=<id>`) blocks dependents
|
|
109
106
|
until an external condition resolves. Documented await-types are GitHub-shaped; when
|
|
110
107
|
recommending a gate, describe the pattern and let the operator pick an await-type
|
|
111
108
|
matching their actual VCS/CI.
|
|
112
|
-
- Title prefixes are convention, not schema, but widely matched on: `[test]` =
|
|
113
|
-
work
|
|
114
|
-
|
|
109
|
+
- Title prefixes are convention, not schema, but widely matched on: `[test]` =
|
|
110
|
+
verification work; `[impl]` = implementation; `[integ]` = filed by an integration
|
|
111
|
+
pass; `[regression][carry-over]` = rolled-over regression bug.
|
|
115
112
|
|
|
116
113
|
## Step 1 -- Load the backlog, scoped to identity
|
|
117
114
|
|
|
@@ -127,9 +124,8 @@ Fall back to non-`--json`/non-`--assignee` forms if unsupported, then filter cli
|
|
|
127
124
|
visibly separate. `bd show <id> --json` before any judgment call -- never flag
|
|
128
125
|
description quality from a summary line alone.
|
|
129
126
|
|
|
130
|
-
If a `bd` JSON payload is too large to read directly, redirect it
|
|
131
|
-
|
|
132
|
-
existing `.beads/` gitignore entry) -- never write scratch JSON to the repo root.
|
|
127
|
+
If a `bd` JSON payload is too large to read directly, redirect it to a gitignored
|
|
128
|
+
scratch path (e.g. `.beads/tmp/<name>.json`) -- never to the repo root.
|
|
133
129
|
|
|
134
130
|
## Step 2 -- Structural deadlock scan (every time)
|
|
135
131
|
|
|
@@ -241,10 +237,10 @@ The canonical machine-readable contract for this output lives in the sibling fil
|
|
|
241
237
|
```json
|
|
242
238
|
{
|
|
243
239
|
"status": "OK",
|
|
244
|
-
"identity": "
|
|
240
|
+
"identity": "dev@example.com",
|
|
245
241
|
"notes": "12 ready, 2 sprint sets proposed, 1 duplicate merged, 3 needing grooming.",
|
|
246
242
|
"ready": [
|
|
247
|
-
{ "id": "BD-14", "type": "task", "priority": "P1", "status": "open", "assignee": "
|
|
243
|
+
{ "id": "BD-14", "type": "task", "priority": "P1", "status": "open", "assignee": "dev@example.com", "ageDays": 4, "size": "M", "rationale": "No blockers, clear AC, feeds the auth epic." }
|
|
248
244
|
],
|
|
249
245
|
"sprintSets": [
|
|
250
246
|
{ "label": "auth-hardening", "beadIds": ["BD-14", "BD-15"], "reason": "Shared parent BD-10, sequential blocks edge." }
|
|
@@ -263,7 +259,7 @@ The canonical machine-readable contract for this output lives in the sibling fil
|
|
|
263
259
|
],
|
|
264
260
|
"notYours": [],
|
|
265
261
|
"stale": [
|
|
266
|
-
{ "id": "BD-60", "type": "bug", "priority": "P1", "status": "open", "assignee": "
|
|
262
|
+
{ "id": "BD-60", "type": "bug", "priority": "P1", "status": "open", "assignee": "dev@example.com", "ageDays": 95, "size": "S", "rationale": "P1, 95 days untouched -- likely dropped, confirm before continuing to carry it." }
|
|
267
263
|
],
|
|
268
264
|
"structuralIssues": [
|
|
269
265
|
{ "kind": "deadlock", "description": "BD-70 blocks its own parent BD-71", "beadIds": ["BD-70", "BD-71"] }
|
|
@@ -48,6 +48,9 @@ gh run list --pr <prNumber> --limit 5 --json databaseId,status,conclusion,headSh
|
|
|
48
48
|
(In PR-scoped mode, apply Step 2 to the runs for the PR's head commit instead of
|
|
49
49
|
`expectedHeadSha`.)
|
|
50
50
|
|
|
51
|
+
If `gh` is unavailable or the repo's remote is not GitHub, do not guess at another CI
|
|
52
|
+
system: return `status: "not_configured"` with `notes` naming what was found.
|
|
53
|
+
|
|
51
54
|
## Step 2 -- Interpret the result
|
|
52
55
|
|
|
53
56
|
**No runs returned**: CI has never been triggered on this branch.
|
|
@@ -30,27 +30,19 @@ not improvise deploy steps that are not written down in the runbook.
|
|
|
30
30
|
|
|
31
31
|
## Step 0a -- Check permissions before running anything
|
|
32
32
|
|
|
33
|
-
Read `deploy.md`.
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
`.claude/settings.json` (
|
|
37
|
-
`.claude/settings.local.json` (
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
Run the merge MECHANICALLY, in one command, rather than reading each file
|
|
48
|
-
separately and merging by eye -- two sequential `cat`s invite stopping at the
|
|
49
|
-
first (often-empty) file and never getting to the second, which silently
|
|
50
|
-
reports a real grant as missing (observed live, apra-fleet: `settings.json`
|
|
51
|
-
legitimately carries no `permissions.allow` in this repo's convention -- every
|
|
52
|
-
grant lives in `settings.local.json` -- so a by-eye read that stops at the
|
|
53
|
-
first empty file always concludes "nothing is granted" even when it is):
|
|
33
|
+
Read `deploy.md`. If it has a `## Permissions` section, verify each listed
|
|
34
|
+
command prefix is covered by the MERGED effective permission set -- on
|
|
35
|
+
Claude Code, the union of `permissions.allow` from BOTH
|
|
36
|
+
`.claude/settings.json` (team-committed baseline) AND
|
|
37
|
+
`.claude/settings.local.json` (per-checkout, gitignored -- the only file the
|
|
38
|
+
fleet's `compose_permissions` tool writes to; see
|
|
39
|
+
`skills/fleet/permissions.md`). A grant in either file counts; a broader
|
|
40
|
+
prefix counts too (e.g. `Bash(docker:*)` covers `docker compose`). Other
|
|
41
|
+
providers keep the equivalent allowlist in their own native config file.
|
|
42
|
+
|
|
43
|
+
Compute the union MECHANICALLY, in one command -- reading the files
|
|
44
|
+
separately and merging by eye reliably misses grants when the first file is
|
|
45
|
+
empty:
|
|
54
46
|
|
|
55
47
|
```bash
|
|
56
48
|
node -e '
|
|
@@ -67,29 +59,15 @@ console.log(JSON.stringify([...allow], null, 2));
|
|
|
67
59
|
# use your provider's native config file(s) otherwise
|
|
68
60
|
```
|
|
69
61
|
|
|
70
|
-
Check every required
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
grant(s), then re-trigger the sprint.
|
|
80
|
-
|
|
81
|
-
Do NOT attempt to add the permissions yourself, by editing any file directly:
|
|
82
|
-
- `.claude/settings.json` is the team-committed baseline -- changes there
|
|
83
|
-
require the team/a PR, never a self-edit.
|
|
84
|
-
- `.claude/settings.local.json` is the correct target for an individual/local
|
|
85
|
-
grant, but it must be provisioned via the `compose_permissions` MCP tool
|
|
86
|
-
(grant mode), NOT hand-edited either -- that tool is the provider-agnostic
|
|
87
|
-
delivery mechanism (this repo supports non-Claude providers too: Gemini,
|
|
88
|
-
AGY, OpenCode, Codex -- each has its own native config path via the same
|
|
89
|
-
tool).
|
|
90
|
-
The correct escalation when a required permission is missing from the merged
|
|
91
|
-
effective set is: ask the orchestrator/operator to run `compose_permissions`
|
|
92
|
-
with the missing grant. Do NOT proceed past Step 0a if any permissions are missing.
|
|
62
|
+
Check every required prefix against this one merged list. If any prefix has
|
|
63
|
+
no covering entry, STOP immediately and return `deployed: false`, listing
|
|
64
|
+
every missing entry in `notes` and asking the orchestrator/operator to run
|
|
65
|
+
`compose_permissions` with the missing grant(s), then re-trigger the sprint.
|
|
66
|
+
NEVER add permissions yourself: `.claude/settings.json` changes require a
|
|
67
|
+
team PR, and `.claude/settings.local.json` must be provisioned via the
|
|
68
|
+
`compose_permissions` MCP tool (the provider-agnostic delivery mechanism
|
|
69
|
+
across all supported providers), never hand-edited. Do NOT proceed past
|
|
70
|
+
Step 0a while any permission is missing.
|
|
93
71
|
|
|
94
72
|
## Step 0b -- Knowledge Bank (required -- do this BEFORE any deploy.md operation)
|
|
95
73
|
|