@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.
- package/README.md +49 -4
- package/dist/agents/backlog-groomer.md +5 -0
- package/dist/agents/ci-watcher.md +5 -0
- package/dist/agents/deployer.md +20 -2
- package/dist/agents/doer.md +38 -2
- package/dist/agents/harvester.md +12 -9
- package/dist/agents/integ-test-runner.md +5 -0
- package/dist/agents/kb-reconciler.md +6 -0
- package/dist/agents/plan-reviewer.md +5 -0
- package/dist/agents/planner.md +5 -0
- package/dist/agents/regression-test-runner.md +5 -0
- package/dist/agents/reviewer.md +67 -15
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +78 -2
- package/dist/agents/schemas/reviewer-output.json +104 -2
- package/dist/cli/auth.js +5 -1
- package/dist/cli/beads-pin.js +6 -7
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/dolt-install.d.ts +1 -1
- package/dist/cli/dolt-install.js +5 -1
- package/dist/cli/fleet-se-guard.d.ts +8 -0
- package/dist/cli/fleet-se-guard.js +19 -3
- package/dist/cli/install-guard.d.ts +9 -0
- package/dist/cli/install-guard.js +24 -0
- package/dist/cli/install.d.ts +12 -0
- package/dist/cli/install.js +180 -20
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/start.js +3 -0
- package/dist/cli/uninstall.js +13 -3
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +19 -3
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +285 -11
- package/dist/index.js +22 -1
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +2 -0
- package/dist/os/linux.js +10 -1
- package/dist/os/os-commands.d.ts +25 -0
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +23 -14
- package/dist/os/windows-gitbash.js +40 -16
- package/dist/os/windows.d.ts +2 -0
- package/dist/os/windows.js +37 -6
- package/dist/paths.d.ts +10 -1
- package/dist/paths.js +19 -2
- package/dist/services/agy-project.d.ts +7 -1
- package/dist/services/agy-project.js +7 -2
- package/dist/services/auth-socket.d.ts +18 -0
- package/dist/services/auth-socket.js +30 -4
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/http-transport.d.ts +29 -0
- package/dist/services/http-transport.js +166 -37
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-blob-id.js +10 -1
- package/dist/services/knowledge/bible-import.d.ts +108 -0
- package/dist/services/knowledge/bible-import.js +137 -4
- package/dist/services/knowledge/file-hash.js +6 -5
- package/dist/services/knowledge/http-provider.d.ts +303 -20
- package/dist/services/knowledge/http-provider.js +795 -125
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-providers.d.ts +9 -2
- package/dist/services/knowledge/kb-providers.js +67 -37
- package/dist/services/knowledge/kb-removed-scope-keys.js +1 -1
- package/dist/services/knowledge/kb-self.d.ts +122 -9
- package/dist/services/knowledge/kb-self.js +196 -36
- package/dist/services/knowledge/member-bible-view.js +16 -3
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/project-slug.js +3 -2
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +169 -0
- package/dist/services/knowledge/sqlite-provider.js +416 -4
- package/dist/services/knowledge/types.d.ts +15 -2
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-config-io.d.ts +3 -2
- package/dist/services/member-config-io.js +7 -4
- package/dist/services/member-fleet-install.js +1 -0
- package/dist/services/member-tool-allowlist.d.ts +1 -1
- package/dist/services/member-tool-allowlist.js +8 -4
- package/dist/services/port-holder.js +2 -1
- package/dist/services/service-manager/types.d.ts +17 -1
- package/dist/services/service-manager/windows.d.ts +7 -2
- package/dist/services/service-manager/windows.js +28 -11
- package/dist/services/service-notice.d.ts +7 -0
- package/dist/services/service-notice.js +19 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/supervisor-service-cleanup.js +2 -1
- package/dist/services/tool-registry.js +108 -20
- package/dist/services/tool-scope.d.ts +34 -1
- package/dist/services/tool-scope.js +27 -2
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +2 -1
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +9 -9
- package/dist/skills/pm/sprint.md +2 -1
- package/dist/tools/check-status.d.ts +51 -0
- package/dist/tools/check-status.js +124 -12
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +19 -0
- package/dist/tools/code-intelligence-gitnexus.js +166 -9
- package/dist/tools/code-intelligence-readiness.d.ts +58 -1
- package/dist/tools/code-intelligence-readiness.js +93 -8
- package/dist/tools/code-intelligence-reindex.d.ts +25 -1
- package/dist/tools/code-intelligence-reindex.js +76 -4
- package/dist/tools/code-intelligence.d.ts +1 -1
- package/dist/tools/code-intelligence.js +1 -1
- package/dist/tools/execute-command.js +14 -8
- package/dist/tools/execute-prompt.js +6 -2
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +25 -11
- package/dist/tools/kb-bible-commit.js +142 -33
- package/dist/tools/kb-capture.d.ts +2 -2
- package/dist/tools/kb-context.js +47 -27
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +35 -3
- package/dist/tools/kb-export.js +56 -13
- package/dist/tools/kb-feedback.d.ts +2 -0
- package/dist/tools/kb-feedback.js +17 -7
- package/dist/tools/kb-harvest.js +28 -9
- package/dist/tools/kb-import.d.ts +18 -2
- package/dist/tools/kb-import.js +24 -9
- package/dist/tools/kb-invalidate.d.ts +11 -3
- package/dist/tools/kb-invalidate.js +80 -7
- package/dist/tools/kb-list.js +38 -10
- package/dist/tools/kb-promote.js +6 -4
- package/dist/tools/kb-query.d.ts +3 -0
- package/dist/tools/kb-query.js +181 -37
- package/dist/tools/kb-session-prime.d.ts +4 -4
- package/dist/tools/kb-session-prime.js +89 -9
- package/dist/tools/kb-setup.d.ts +20 -0
- package/dist/tools/kb-setup.js +149 -11
- package/dist/tools/list-members.js +1 -1
- package/dist/tools/member-detail.js +7 -3
- package/dist/tools/provision-vcs-auth.d.ts +28 -3
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +7 -4
- package/dist/tools/send-files.js +5 -4
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +90 -11
- package/dist/utils/process-utils.js +5 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/workflows/auto-sprint.js +245 -9
- package/package.json +10 -7
- package/packages/apra-fleet-client/package.json +1 -1
- package/packages/apra-fleet-client/src/client/api.mjs +172 -19
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +35 -2
- package/packages/apra-fleet-client/src/client/transport.mjs +6 -0
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +20 -2
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +38 -2
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +12 -9
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +6 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +67 -15
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +78 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +104 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +9 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +2 -1
- package/packages/apra-fleet-se/bin/cli.mjs +104 -31
- package/packages/apra-fleet-se/bin/serve.mjs +46 -8
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +184 -32
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +21 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +158 -1
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +82 -2
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +23 -6
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +44 -11
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +4 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +314 -19
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +72 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +7 -1
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +112 -1
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +36 -2
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +736 -101
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +1 -1
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +7 -1
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +49 -2
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +206 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +61 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +81 -31
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +7 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +39 -14
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +17 -1
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +18 -3
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +14 -1
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +32 -5
- package/packages/apra-fleet-se/fleet-sprint/runner.js +824 -98
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +4 -2
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +54 -1
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +29 -2
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +3 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +21 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +605 -32
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +89 -1
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +225 -2
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/src/supervisor/api.mjs +148 -8
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +6 -3
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +30 -10
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +17 -4
- package/packages/apra-fleet-se/src/supervisor/history.mjs +8 -1
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +92 -2
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +26 -1
- package/packages/apra-fleet-se/src/supervisor/server.mjs +151 -8
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +11 -9
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +7 -1
- package/packages/apra-fleet-workflow/package.json +2 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +86 -5
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +34 -2
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/skill-matrix.md +3 -3
- 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
|
|
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
|
-
|
|
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.
|
|
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',
|
|
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:
|
|
25
|
-
| testing | `repository:
|
|
26
|
-
| devops | `repository:
|
|
27
|
-
| debugging | `repository:
|
|
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 -
|
|
35
|
-
|
|
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=
|
|
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 -
|
|
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
|
-
|
|
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 |
|
|
63
|
-
|
|
|
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
|
|
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
|
|
15
|
-
| Any | Bitbucket | code-review | `bitbucket
|
|
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
|
|
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