Skip to content

docs: fold provider wrapper-scope + reachability-keyed-ack notes into roadmap#15

Merged
raspbeguy merged 1 commit into
mainfrom
docs/roadmap-confirm-arm-wrapper-notes
Jun 22, 2026
Merged

docs: fold provider wrapper-scope + reachability-keyed-ack notes into roadmap#15
raspbeguy merged 1 commit into
mainfrom
docs/roadmap-confirm-arm-wrapper-notes

Conversation

@raspbeguy

Copy link
Copy Markdown
Member

Follow-up to the standalone POST /confirm roadmap entry, folding in two refinements that came back from the terraform-provider side after the design converged.

  1. Operator-scope corollary: the wrap token is necessarily broader than the apply it guards (wrapping a network:routes-only apply needs :rw on all 7 network-backed resources, since the package-wide revert can restore any of them). The guide must say "mint the wrap token at package granularity" or a narrow token hits a confusing 403 on arm.

  2. Reference wrapper: its natural home is the provider repo (the concrete consumer), and its ack-vs-rollback must key on management-path reachability, not terraform apply's exit code. A partial failure where the box is still reachable should ack (Terraform already recorded the resources that succeeded, so acking keeps the box consistent with state); only an unreachable box should be left to auto-revert. This resolves the "forgotten ack silently reverts committed sibling changes" hazard cleanly.

Docs-only. No wire surface changes.

🤖 Generated with Claude Code

… roadmap

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@raspbeguy raspbeguy merged commit 598825a into main Jun 22, 2026
5 checks passed
@raspbeguy raspbeguy deleted the docs/roadmap-confirm-arm-wrapper-notes branch June 22, 2026 18:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant