fix: sync align-pr-branch component surfaces

- add align-pr-branch to the bundled component config in the root, core, and opencode manifests
- document align-pr-branch in the component index and add a dedicated reference page
- keep the new shared component aligned across runtime, config, and docs surfaces

Author: dbpolito

kompass.jsonc

@@ -51,6 +51,7 @@
   },
 
   "components": {
+    "align-pr-branch": { "enabled": true },
     "change-summary": { "enabled": true },
     "changes-summary": { "enabled": true },
     "commit": { "enabled": true },

packages/core/kompass.jsonc

@@ -51,6 +51,7 @@
   },
 
   "components": {
+    "align-pr-branch": { "enabled": true },
     "change-summary": { "enabled": true },
     "changes-summary": { "enabled": true },
     "commit": { "enabled": true },

packages/opencode/kompass.jsonc

@@ -51,6 +51,7 @@
   },
 
   "components": {
+    "align-pr-branch": { "enabled": true },
     "change-summary": { "enabled": true },
     "changes-summary": { "enabled": true },
     "commit": { "enabled": true },

packages/web/src/content/docs/docs/reference/components/align-pr-branch.mdx

@@ -0,0 +1,12 @@
+---
+title: align-pr-branch
+description: Shared partial for aligning PR-scoped commands to the pull request branch.
+---
+
+## Behavior
+
+- requires the caller to provide `<pr-branch>`
+- runs `gh pr checkout <pr-context.pr.number>` before local PR analysis or edits
+- stores the active branch as `<active-branch>` after checkout
+- stops if checkout fails or if the active branch does not match `<pr-branch>`
+- accepts caller-provided wording through `it.action` and `it.scope`

packages/web/src/content/docs/docs/reference/components/index.mdx

@@ -7,6 +7,7 @@ Kompass command templates can include reusable Eta partials from `packages/core/
 
 Bundled components:
 
+- `align-pr-branch`
 - `change-summary`
 - `changes-summary`
 - `commit`
@@ -18,6 +19,10 @@ Bundled components:
 
 ## Bundled components
 
+### `align-pr-branch`
+
+Guides PR-scoped commands to switch onto the PR head branch with `gh pr checkout`, capture the active branch, and stop if local work is not aligned to the PR branch.
+
 ### `change-summary`
 
 Loads changes with `changes_load`, analyzes file-level diffs, and groups the work into concise what/why themes.