@apralabs/apra-fleet 0.4.4 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (268) hide show
  1. package/README.md +49 -4
  2. package/dist/agents/backlog-groomer.md +5 -0
  3. package/dist/agents/ci-watcher.md +5 -0
  4. package/dist/agents/deployer.md +20 -2
  5. package/dist/agents/doer.md +38 -2
  6. package/dist/agents/harvester.md +12 -9
  7. package/dist/agents/integ-test-runner.md +5 -0
  8. package/dist/agents/kb-reconciler.md +6 -0
  9. package/dist/agents/plan-reviewer.md +5 -0
  10. package/dist/agents/planner.md +5 -0
  11. package/dist/agents/regression-test-runner.md +5 -0
  12. package/dist/agents/reviewer.md +67 -15
  13. package/dist/agents/schemas/deployer-output.json +5 -0
  14. package/dist/agents/schemas/doer-output.json +78 -2
  15. package/dist/agents/schemas/reviewer-output.json +104 -2
  16. package/dist/cli/auth.js +5 -1
  17. package/dist/cli/beads-pin.js +6 -7
  18. package/dist/cli/claude-mod.d.ts +75 -0
  19. package/dist/cli/claude-mod.js +288 -0
  20. package/dist/cli/dolt-install.d.ts +1 -1
  21. package/dist/cli/dolt-install.js +5 -1
  22. package/dist/cli/fleet-se-guard.d.ts +8 -0
  23. package/dist/cli/fleet-se-guard.js +19 -3
  24. package/dist/cli/install-guard.d.ts +9 -0
  25. package/dist/cli/install-guard.js +24 -0
  26. package/dist/cli/install.d.ts +12 -0
  27. package/dist/cli/install.js +180 -20
  28. package/dist/cli/kb-profile.d.ts +16 -0
  29. package/dist/cli/kb-profile.js +81 -0
  30. package/dist/cli/start.js +3 -0
  31. package/dist/cli/uninstall.js +13 -3
  32. package/dist/cli/update.d.ts +4 -0
  33. package/dist/cli/update.js +19 -3
  34. package/dist/commands/kb-server.d.ts +10 -1
  35. package/dist/commands/kb-server.js +285 -11
  36. package/dist/index.js +22 -1
  37. package/dist/os/git-executable.d.ts +57 -0
  38. package/dist/os/git-executable.js +85 -0
  39. package/dist/os/go-concurrency.d.ts +44 -0
  40. package/dist/os/go-concurrency.js +53 -0
  41. package/dist/os/index.d.ts +1 -0
  42. package/dist/os/index.js +1 -0
  43. package/dist/os/linux.d.ts +2 -0
  44. package/dist/os/linux.js +10 -1
  45. package/dist/os/os-commands.d.ts +25 -0
  46. package/dist/os/os-commands.js +2 -0
  47. package/dist/os/windows-executable.d.ts +53 -0
  48. package/dist/os/windows-executable.js +185 -0
  49. package/dist/os/windows-gitbash.d.ts +23 -14
  50. package/dist/os/windows-gitbash.js +40 -16
  51. package/dist/os/windows.d.ts +2 -0
  52. package/dist/os/windows.js +37 -6
  53. package/dist/paths.d.ts +10 -1
  54. package/dist/paths.js +19 -2
  55. package/dist/services/agy-project.d.ts +7 -1
  56. package/dist/services/agy-project.js +7 -2
  57. package/dist/services/auth-socket.d.ts +18 -0
  58. package/dist/services/auth-socket.js +30 -4
  59. package/dist/services/credential-store.d.ts +33 -0
  60. package/dist/services/credential-store.js +79 -2
  61. package/dist/services/http-transport.d.ts +29 -0
  62. package/dist/services/http-transport.js +166 -37
  63. package/dist/services/kb-tool-profile.d.ts +36 -0
  64. package/dist/services/kb-tool-profile.js +88 -0
  65. package/dist/services/knowledge/bible-blob-id.js +10 -1
  66. package/dist/services/knowledge/bible-import.d.ts +108 -0
  67. package/dist/services/knowledge/bible-import.js +137 -4
  68. package/dist/services/knowledge/file-hash.js +6 -5
  69. package/dist/services/knowledge/http-provider.d.ts +303 -20
  70. package/dist/services/knowledge/http-provider.js +795 -125
  71. package/dist/services/knowledge/kb-config.d.ts +65 -1
  72. package/dist/services/knowledge/kb-config.js +143 -3
  73. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  74. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  75. package/dist/services/knowledge/kb-providers.d.ts +9 -2
  76. package/dist/services/knowledge/kb-providers.js +67 -37
  77. package/dist/services/knowledge/kb-removed-scope-keys.js +1 -1
  78. package/dist/services/knowledge/kb-self.d.ts +122 -9
  79. package/dist/services/knowledge/kb-self.js +196 -36
  80. package/dist/services/knowledge/member-bible-view.js +16 -3
  81. package/dist/services/knowledge/path-validation.d.ts +7 -0
  82. package/dist/services/knowledge/path-validation.js +11 -0
  83. package/dist/services/knowledge/project-slug.js +3 -2
  84. package/dist/services/knowledge/repository-header.d.ts +77 -0
  85. package/dist/services/knowledge/repository-header.js +233 -0
  86. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  87. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  88. package/dist/services/knowledge/sqlite-provider.d.ts +169 -0
  89. package/dist/services/knowledge/sqlite-provider.js +416 -4
  90. package/dist/services/knowledge/types.d.ts +15 -2
  91. package/dist/services/member-busy.d.ts +12 -0
  92. package/dist/services/member-busy.js +20 -0
  93. package/dist/services/member-config-io.d.ts +3 -2
  94. package/dist/services/member-config-io.js +7 -4
  95. package/dist/services/member-fleet-install.js +1 -0
  96. package/dist/services/member-tool-allowlist.d.ts +1 -1
  97. package/dist/services/member-tool-allowlist.js +8 -4
  98. package/dist/services/port-holder.js +2 -1
  99. package/dist/services/service-manager/types.d.ts +17 -1
  100. package/dist/services/service-manager/windows.d.ts +7 -2
  101. package/dist/services/service-manager/windows.js +28 -11
  102. package/dist/services/service-notice.d.ts +7 -0
  103. package/dist/services/service-notice.js +19 -0
  104. package/dist/services/session-registry.d.ts +13 -0
  105. package/dist/services/session-registry.js +13 -0
  106. package/dist/services/session-roots.d.ts +67 -0
  107. package/dist/services/session-roots.js +126 -0
  108. package/dist/services/statusline.d.ts +21 -0
  109. package/dist/services/statusline.js +97 -1
  110. package/dist/services/supervisor-service-cleanup.js +2 -1
  111. package/dist/services/tool-registry.js +108 -20
  112. package/dist/services/tool-scope.d.ts +34 -1
  113. package/dist/services/tool-scope.js +27 -2
  114. package/dist/services/vcs/azure-devops.js +10 -0
  115. package/dist/services/vcs/bitbucket.d.ts +22 -1
  116. package/dist/services/vcs/bitbucket.js +163 -17
  117. package/dist/services/vcs/types.d.ts +25 -2
  118. package/dist/services/watch/project-resolver.js +2 -1
  119. package/dist/skills/pm/cost.md +5 -1
  120. package/dist/skills/pm/index.md +9 -9
  121. package/dist/skills/pm/sprint.md +2 -1
  122. package/dist/tools/check-status.d.ts +51 -0
  123. package/dist/tools/check-status.js +124 -12
  124. package/dist/tools/code-intelligence-freshness.js +1 -1
  125. package/dist/tools/code-intelligence-gitnexus.d.ts +19 -0
  126. package/dist/tools/code-intelligence-gitnexus.js +166 -9
  127. package/dist/tools/code-intelligence-readiness.d.ts +58 -1
  128. package/dist/tools/code-intelligence-readiness.js +93 -8
  129. package/dist/tools/code-intelligence-reindex.d.ts +25 -1
  130. package/dist/tools/code-intelligence-reindex.js +76 -4
  131. package/dist/tools/code-intelligence.d.ts +1 -1
  132. package/dist/tools/code-intelligence.js +1 -1
  133. package/dist/tools/execute-command.js +14 -8
  134. package/dist/tools/execute-prompt.js +6 -2
  135. package/dist/tools/fleet-snapshot.d.ts +21 -0
  136. package/dist/tools/fleet-snapshot.js +78 -0
  137. package/dist/tools/kb-bible-commit.d.ts +25 -11
  138. package/dist/tools/kb-bible-commit.js +142 -33
  139. package/dist/tools/kb-capture.d.ts +2 -2
  140. package/dist/tools/kb-context.js +47 -27
  141. package/dist/tools/kb-demote.d.ts +27 -0
  142. package/dist/tools/kb-demote.js +37 -0
  143. package/dist/tools/kb-export.d.ts +35 -3
  144. package/dist/tools/kb-export.js +56 -13
  145. package/dist/tools/kb-feedback.d.ts +2 -0
  146. package/dist/tools/kb-feedback.js +17 -7
  147. package/dist/tools/kb-harvest.js +28 -9
  148. package/dist/tools/kb-import.d.ts +18 -2
  149. package/dist/tools/kb-import.js +24 -9
  150. package/dist/tools/kb-invalidate.d.ts +11 -3
  151. package/dist/tools/kb-invalidate.js +80 -7
  152. package/dist/tools/kb-list.js +38 -10
  153. package/dist/tools/kb-promote.js +6 -4
  154. package/dist/tools/kb-query.d.ts +3 -0
  155. package/dist/tools/kb-query.js +181 -37
  156. package/dist/tools/kb-session-prime.d.ts +4 -4
  157. package/dist/tools/kb-session-prime.js +89 -9
  158. package/dist/tools/kb-setup.d.ts +20 -0
  159. package/dist/tools/kb-setup.js +149 -11
  160. package/dist/tools/list-members.js +1 -1
  161. package/dist/tools/member-detail.js +7 -3
  162. package/dist/tools/provision-vcs-auth.d.ts +28 -3
  163. package/dist/tools/provision-vcs-auth.js +53 -7
  164. package/dist/tools/receive-files.js +7 -4
  165. package/dist/tools/send-files.js +5 -4
  166. package/dist/tools/send-message.d.ts +3 -0
  167. package/dist/tools/send-message.js +15 -2
  168. package/dist/tools/stop-prompt.js +3 -1
  169. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  170. package/dist/tools/vcs-credential-exec.js +90 -11
  171. package/dist/utils/process-utils.js +5 -1
  172. package/dist/utils/redact-known-secrets.d.ts +17 -0
  173. package/dist/utils/redact-known-secrets.js +70 -0
  174. package/dist/utils/skill-matrix.js +1 -1
  175. package/dist/utils/vcs-provider-detect.js +2 -2
  176. package/dist/workflows/auto-sprint.js +245 -9
  177. package/package.json +10 -7
  178. package/packages/apra-fleet-client/package.json +1 -1
  179. package/packages/apra-fleet-client/src/client/api.mjs +172 -19
  180. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +35 -2
  181. package/packages/apra-fleet-client/src/client/transport.mjs +6 -0
  182. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +5 -0
  183. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +5 -0
  184. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +20 -2
  185. package/packages/apra-fleet-se/apra-pm/agents/doer.md +38 -2
  186. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +12 -9
  187. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +5 -0
  188. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +6 -0
  189. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +5 -0
  190. package/packages/apra-fleet-se/apra-pm/agents/planner.md +5 -0
  191. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +5 -0
  192. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +67 -15
  193. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  194. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +78 -2
  195. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +104 -2
  196. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  197. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +9 -9
  198. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +2 -1
  199. package/packages/apra-fleet-se/bin/cli.mjs +104 -31
  200. package/packages/apra-fleet-se/bin/serve.mjs +46 -8
  201. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +184 -32
  202. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  203. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +21 -0
  204. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  205. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  206. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +158 -1
  207. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +82 -2
  208. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +23 -6
  209. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  210. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  211. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  212. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +44 -11
  213. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +4 -1
  214. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  215. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +314 -19
  216. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +72 -4
  217. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +7 -1
  218. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +112 -1
  219. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +36 -2
  220. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +736 -101
  221. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +1 -1
  222. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +7 -1
  223. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +49 -2
  224. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +206 -3
  225. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +61 -3
  226. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +81 -31
  227. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +7 -3
  228. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +39 -14
  229. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +17 -1
  230. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +18 -3
  231. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +14 -1
  232. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +32 -5
  233. package/packages/apra-fleet-se/fleet-sprint/runner.js +824 -98
  234. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +4 -2
  235. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +54 -1
  236. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +29 -2
  237. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  238. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +3 -2
  239. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +20 -0
  240. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +21 -0
  241. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +9 -0
  242. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +605 -32
  243. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  244. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +89 -1
  245. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +225 -2
  246. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  247. package/packages/apra-fleet-se/src/supervisor/api.mjs +148 -8
  248. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +6 -3
  249. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +30 -10
  250. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +17 -4
  251. package/packages/apra-fleet-se/src/supervisor/history.mjs +8 -1
  252. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +92 -2
  253. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +26 -1
  254. package/packages/apra-fleet-se/src/supervisor/server.mjs +151 -8
  255. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +11 -9
  256. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +7 -1
  257. package/packages/apra-fleet-workflow/package.json +2 -1
  258. package/packages/apra-fleet-workflow/src/viewer/index.mjs +86 -5
  259. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  260. package/packages/apra-fleet-workflow/src/workflow/index.mjs +34 -2
  261. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  262. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  263. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  264. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  265. package/skills/fleet/auth-bitbucket.md +47 -20
  266. package/skills/fleet/onboarding.md +1 -1
  267. package/skills/fleet/skill-matrix.md +3 -3
  268. package/version.json +1 -1
@@ -0,0 +1,88 @@
1
+ export type FleetMemberStatus = 'busy' | 'idle' | 'offline' | 'unknown'
2
+
3
+ export type FleetMember = {
4
+ id: string
5
+ name: string
6
+ icon: string
7
+ category: string | null
8
+ status: FleetMemberStatus
9
+ quietForS?: number
10
+ reservedBy?: string
11
+ }
12
+
13
+ export type FleetView = {
14
+ /** Server version, absent until the first good read. */
15
+ version?: string
16
+ members: FleetMember[]
17
+ /** Epoch ms of the last read attempt that answered, 0 before any. */
18
+ fetchedAt: number
19
+ /** Why the last read failed, absent when it succeeded. */
20
+ error?: string
21
+ }
22
+
23
+ /** One stored secret as credential_store_list describes it: never its value. */
24
+ export type SecretRow = {
25
+ name: string
26
+ /** 'persistent' survives a server restart; 'session' does not. */
27
+ scope: string
28
+ /** '*' or a comma-separated list of member names. */
29
+ members: string
30
+ /** 'none', 'expired', or e.g. '3h 12m remaining'. */
31
+ expiry: string
32
+ }
33
+
34
+ export type SecretsView = {
35
+ items: SecretRow[]
36
+ /** Epoch ms of the last list that answered, 0 before any. */
37
+ fetchedAt: number
38
+ error?: string
39
+ }
40
+
41
+ /**
42
+ * The Secrets section's controls. The secret's value is never held here:
43
+ * 'link' carries only the one-time link to the server's own entry form.
44
+ */
45
+ export type SecretForm = {
46
+ mode: 'closed' | 'form' | 'link'
47
+ name: string
48
+ /** '' (all members), '*', or a comma-separated list of member names. */
49
+ members: string
50
+ keep: 'persistent' | 'session'
51
+ ttl: 'none' | '1h' | '1d' | '7d'
52
+ /** The name is an existing secret's: the form replaces its value. */
53
+ replacing?: boolean
54
+ link?: string
55
+ linkExpires?: string
56
+ /** Shown beside the link when it is neither https nor loopback. */
57
+ warning?: string
58
+ /** The secret awaiting a confirm press before it is deleted. */
59
+ confirmDelete?: string
60
+ /** One line about the last action (deleted, failed, ...). */
61
+ note?: string
62
+ }
63
+
64
+ /** The members list's Remove control: which member awaits a confirm, and the last outcome. */
65
+ export type MemberAction = {
66
+ /** Name of the member awaiting a confirm press before it is removed. */
67
+ confirmRemove?: string
68
+ /** One line about the last removal (removed, refused as busy or held, ...). */
69
+ note?: string
70
+ }
71
+
72
+ /** What the pane shows: which sections are open, and which show their less-used fields. */
73
+ export type PaneLayout = {
74
+ membersOpen: boolean
75
+ secretsOpen: boolean
76
+ /** Members: a state note (quiet time, stall, free, unreachable), holder and short id beside each row. */
77
+ moreMembers: boolean
78
+ /** Secrets: scope, allowed members and expiry beside each row. */
79
+ moreSecrets: boolean
80
+ /** The add/replace form: members, keep and expiry (all members, persistent, never by default). */
81
+ moreOptions: boolean
82
+ }
83
+
84
+ declare module 'claude-code' {
85
+ interface PluginState {
86
+ 'fleet-status': { view: FleetView; secrets: SecretsView; secretForm: SecretForm; memberAction: MemberAction; layout: PaneLayout }
87
+ }
88
+ }
@@ -1,39 +1,46 @@
1
1
  # Bitbucket Authentication
2
2
 
3
- API tokens (app passwords) tied to a user account. Long-lived, no auto-expire.
3
+ Scoped Atlassian API tokens tied to a user account. Bitbucket app passwords
4
+ are retired (Atlassian CHANGE-3222) and are not supported.
4
5
 
5
6
  ## Setup
6
7
 
7
8
  1. Go to `https://id.atlassian.com/manage-profile/security/api-tokens`
8
- (or Bitbucket: Settings > Personal Bitbucket settings > App passwords)
9
- 2. Create app password with required scopes (see below)
9
+ 2. Choose "Create API token with scopes", app Bitbucket, with the required scopes (see below)
10
10
  3. Copy token - shown only once
11
- 4. Provide token, email, and workspace slug when prompted
11
+ 4. Store the token as the fleet secret `bitbucket_api_token` (`credential_store_set name=bitbucket_api_token`) and provide the workspace slug. The secret name `bitbucket_api_token` is FIXED: it is not configurable and there is no fallback name. No email is needed.
12
12
 
13
13
  ## Deploy
14
14
 
15
15
  ```
16
- provision_vcs_auth(member_id, provider: 'bitbucket', email: '...', api_token: 'ATBB_...', workspace: '...')
16
+ provision_vcs_auth(member_id, provider: 'bitbucket', api_token: '{{secret.bitbucket_api_token}}', workspace: '...')
17
17
  ```
18
18
 
19
+ `email` is optional and ignored for authentication (kept only as metadata if
20
+ given). The git credential helper always uses the fixed username
21
+ `x-bitbucket-api-token-auth`; re-provisioning a member whose helper still
22
+ carries an email username rewrites it. Verification GETs the member's origin
23
+ repository over REST with `Authorization: Bearer` and runs a non-interactive
24
+ `git ls-remote` against the origin -- both must pass for `verified: true`.
25
+
19
26
  ## Scopes
20
27
 
21
28
  | Role | Scopes |
22
29
  |------|--------|
23
- | development | `repository:write`, `pullrequest:write` |
24
- | code-review | `repository:read`, `pullrequest:read` |
25
- | testing | `repository:read`, `pipeline:read` |
26
- | devops | `repository:admin`, `pipeline:write`, `pullrequest:write` |
27
- | debugging | `repository:read` |
30
+ | development | `read:repository:bitbucket`, `write:repository:bitbucket`, `read:pullrequest:bitbucket`, `write:pullrequest:bitbucket` |
31
+ | code-review | `read:repository:bitbucket`, `read:pullrequest:bitbucket` |
32
+ | testing | `read:repository:bitbucket`, `read:pipeline:bitbucket` |
33
+ | devops | `admin:repository:bitbucket`, `read:repository:bitbucket`, `write:repository:bitbucket`, `read:pullrequest:bitbucket`, `write:pullrequest:bitbucket`, `read:pipeline:bitbucket`, `write:pipeline:bitbucket` |
34
+ | debugging | `read:repository:bitbucket` |
28
35
 
29
- Union of all roles assigned to the member.
36
+ Union of all roles assigned to the member. A fleet-sprint member that pushes
37
+ and opens PRs needs the four development scopes.
30
38
 
31
39
  ## Test
32
40
 
33
41
  ```bash
34
- curl -sf -u email:token https://api.bitbucket.org/2.0/user
35
- curl -sf -u email:token https://api.bitbucket.org/2.0/repositories/{workspace}?pagelen=1
36
- git ls-remote https://bitbucket.org/{workspace}/{repo}.git HEAD
42
+ curl -sf -H "Authorization: Bearer $TOKEN" https://api.bitbucket.org/2.0/repositories/{workspace}/{repo}
43
+ GIT_TERMINAL_PROMPT=0 git ls-remote https://bitbucket.org/{workspace}/{repo}.git HEAD
37
44
  ```
38
45
 
39
46
  ## Storing tokens for reuse
@@ -43,23 +50,43 @@ After provisioning VCS auth, you can store the Bitbucket API token in the creden
43
50
  **Store a Bitbucket token for reuse:**
44
51
 
45
52
  ```
46
- credential_store_set name=bitbucket_token
53
+ credential_store_set name=bitbucket_api_token
47
54
  ```
48
55
 
49
56
  **Use it in a command on a member:**
50
57
 
51
58
  ```
52
- execute_command command="curl -sf -u me@example.com:{{secret.bitbucket_token}} https://api.bitbucket.org/2.0/user"
53
- execute_command command="git remote set-url origin https://me@example.com:{{secret.bitbucket_token}}@bitbucket.org/workspace/repo.git"
59
+ execute_command command="curl -sf -H 'Authorization: Bearer '{{secret.bitbucket_api_token}} https://api.bitbucket.org/2.0/repositories/workspace/repo"
54
60
  ```
55
61
 
56
- The token is resolved server-side and redacted in output (`[REDACTED:bitbucket_token]`) - it never appears in the LLM conversation or command logs.
62
+ `{{secret.NAME}}` is substituted already quoted for the member's shell, so
63
+ reference it bare, never inside your own quotes. The example above is for a
64
+ POSIX shell; on a PowerShell member use
65
+ `curl.exe -sf -H ('Authorization: Bearer ' + {{secret.bitbucket_api_token}}) https://api.bitbucket.org/2.0/repositories/workspace/repo`.
66
+
67
+ The token is resolved server-side and redacted in output (`[REDACTED:bitbucket_api_token]`) - it never appears in the LLM conversation or command logs.
68
+
69
+ ## Upgrading from 0.4.4
70
+
71
+ - If you followed the older version of this doc you stored the token as
72
+ `bitbucket_token`. Store it again as `bitbucket_api_token`
73
+ (`credential_store_set name=bitbucket_api_token`); nothing reads the old name.
74
+ - A remote member is re-provisioned automatically the first time its old
75
+ helper fails the sprint's credential probe.
76
+ - A LOCAL member is never re-provisioned automatically. Re-provision each one
77
+ by hand, once:
78
+ `provision_vcs_auth member_name=MEMBER provider=bitbucket workspace=WORKSPACE api_token={{secret.bitbucket_api_token}}`
79
+ - Azure DevOps members now take the same probe-first path: a rotated PAT is
80
+ deployed only after the old one fails its probe; re-run `provision_vcs_auth`
81
+ to deploy it sooner.
57
82
 
58
83
  ## Troubleshooting
59
84
 
60
85
  | Symptom | Fix |
61
86
  |---------|-----|
62
- | 401 Unauthorized | Verify email matches Atlassian account; regenerate token |
63
- | 403 Forbidden | Create new app password with additional scopes |
87
+ | 401 Unauthorized (`rest_unauthorized`) | Token revoked or missing scopes; regenerate it and update the `bitbucket_api_token` secret |
88
+ | git fails, REST ok (`git_auth_failed`) | Re-run `provision_vcs_auth` so the helper carries the fixed username `x-bitbucket-api-token-auth` |
89
+ | 403 Forbidden | The API token lacks a scope; create a new API token with the missing scopes and store it as `bitbucket_api_token` |
90
+ | 410 Gone | An app password is still in use (retired); replace it with an API token stored as `bitbucket_api_token` |
64
91
  | Repository not found | Check workspace slug in Bitbucket URL |
65
92
  | Clone prompts for password | Re-run `provision_vcs_auth` |
@@ -64,7 +64,7 @@ Add to the member's status file:
64
64
  - VCS: Bitbucket (kumaakh/apra-lic-mgr)
65
65
  - Roles: development, code-review
66
66
  - Auth: Bitbucket API token (verified)
67
- - Skills: bitbucket-devops (installed)
67
+ - Skills: bitbucket (installed)
68
68
  ```
69
69
 
70
70
  ## Pre-loading credentials before dispatch
@@ -11,8 +11,8 @@ stored in the member's `tags` array.
11
11
  | Project | VCS | Tag | Required Skills |
12
12
  |---------|-----|-----|----------------|
13
13
  | Any | GitHub | Any | None (gh CLI sufficient) |
14
- | Any | Bitbucket | devops | `bitbucket-devops` |
15
- | Any | Bitbucket | code-review | `bitbucket-devops` |
14
+ | Any | Bitbucket | devops | `bitbucket` |
15
+ | Any | Bitbucket | code-review | `bitbucket` |
16
16
  | Any | Bitbucket | development | None |
17
17
  | Any | Bitbucket | testing | None |
18
18
  | Any | Bitbucket | debugging | None |
@@ -26,7 +26,7 @@ stored in the member's `tags` array.
26
26
 
27
27
  | Skill | Purpose |
28
28
  |-------|---------|
29
- | `bitbucket-devops` | Bitbucket API: create/merge PRs, manage pipelines, review code |
29
+ | `bitbucket` | Bitbucket API: create/merge PRs, manage pipelines, review code (agent-marketplace plugin) |
30
30
  | `aprapipes-devops` | ApraPipes-specific build, test, deployment |
31
31
  | `azdevops-devops` | Azure DevOps API operations (planned) |
32
32
  | `lvsm-log-analyzer-skill` | SiteManager log analysis for AVMS/BBNVR devices |
package/version.json CHANGED
@@ -1,3 +1,3 @@
1
1
  {
2
- "version": "0.4.4"
2
+ "version": "0.4.5"
3
3
  }