57 lines
1.7 KiB
Markdown
57 lines
1.7 KiB
Markdown
---
|
|
id: "01-design-package"
|
|
title: "Design package and task files"
|
|
status: completed
|
|
wave: 0
|
|
depends_on: []
|
|
plan: "plan.md"
|
|
spec: "../../specs/integrations/requirements/bitbucket-plugin.md"
|
|
---
|
|
|
|
# Task 01: Design package and task files
|
|
|
|
## Intent
|
|
|
|
Materialize approved Bitbucket connector behavior, generic host boundaries, ADRs, and
|
|
dependency-scoped implementation packets without touching production code.
|
|
|
|
## Dependencies
|
|
|
|
None.
|
|
|
|
## Owned paths
|
|
|
|
- `docs/specs/integrations/requirements/bitbucket-plugin.md`
|
|
- `docs/specs/INDEX.md`
|
|
- `docs/specs/plugins/requirements/plugins.md`
|
|
- `docs/decisions/2026-07-31-authenticated-plugin-actions.md`
|
|
- `docs/decisions/2026-07-31-plugin-repository-provider-extensions.md`
|
|
- `docs/decisions/2026-07-31-provider-neutral-git-credential-broker.md`
|
|
- `docs/decisions/INDEX.md`
|
|
- `docs/plans/bitbucket-plugin/`
|
|
- `docs/plans/plugins/GRPC-CONTRACT.md`
|
|
- `docs/plans/plugins/PLUGIN-API.md`
|
|
- `docs/plans/plugins/HOST-DATA-API.proto`
|
|
|
|
## Acceptance
|
|
|
|
1. Spec preserves Cloud+DC, API token/PAT+OAuth, full supported-capability parity,
|
|
plugin-first boundaries, native Link/review hooks, and composer submission
|
|
reauthorization.
|
|
2. Three ADRs and frozen contracts define generic reusable seams without Bitbucket API
|
|
payloads in the host.
|
|
3. `task-01` through `task-13` declare dependencies, owned paths, acceptance, exact
|
|
checks, and risks; indexes and relative links resolve.
|
|
|
|
## Verification
|
|
|
|
```sh
|
|
git diff --check
|
|
rg -n 'Link → Bitbucket Pull Request|submit-time|reauthoriz|Cloud|Data Center' docs/specs/bitbucket-plugin docs/plans/bitbucket-plugin
|
|
```
|
|
|
|
## Risks
|
|
|
|
Frozen contract drift can make later host/plugin tasks incompatible. Reconcile every
|
|
contract amendment with the approved parent plan before implementation starts.
|