goalbuddy 0.2.21 → 0.3.0

package/goalbuddy/extend/github-projects/extension.yaml

@@ -0,0 +1,43 @@
+id: github-projects
+name: GitHub Projects
+kind: integration
+version: 0.1.1
+source_of_truth: local
+description: Mirror GoalBuddy state.yaml tasks into GitHub Projects with dry-run planning, ProjectV2 fields, draft issue upserts, and one Goal Board view.
+local_use_prompt: Run the bundled GitHub Projects sync script for docs/goals/<slug>/state.yaml. Use --dry-run first unless the user has approved live GitHub writes, then run the same script with GITHUB_TOKEN or GH_TOKEN and --project-id or --owner plus --project-number. Do not use Computer Use, browser automation, the GitHub web UI, or gh project as a fallback.
+use_when:
+  - A long-running GoalBuddy board needs stakeholder visibility in GitHub Projects.
+  - The team wants one-way sync from state.yaml into ProjectV2 draft issues.
+  - The PM needs a safe dry-run plan before using GitHub credentials.
+  - GoalBuddy receipts, verification commands, allowed files, owners, role/agent fields, credential gates, and dependencies should appear in a GitHub board.
+activation: publish_handoff
+outputs:
+  - GitHub Projects dry-run plan
+  - GitHub ProjectV2 draft issue sync
+  - Goal Board ProjectV2 view
+requires_approval: true
+safe_by_default: false
+reads:
+  - docs/goals/<slug>/state.yaml
+  - GITHUB_PROJECT_ID
+  - GITHUB_PROJECT_OWNER
+  - GITHUB_PROJECT_NUMBER
+writes:
+  - GitHub ProjectV2 draft issues
+  - GitHub ProjectV2 fields
+  - GitHub ProjectV2 Goal Board view
+side_effects:
+  - Live sync creates or updates GitHub Project draft issues, fields, and views.
+agent_instructions:
+  - Use the bundled sync script for all live GitHub Projects writes.
+  - Do not use Computer Use, browser automation, or the GitHub web UI to create or repair Project views.
+  - Do not replace the bundled script with gh project commands; the script uses GraphQL plus the REST Project views endpoint.
+  - Do not claim ProjectV2 board views are UI-only; the GitHub REST Project views API supports creating board-layout views.
+auth:
+  env:
+    - GITHUB_TOKEN
+supports:
+  dry_run: true
+  live_github_projects: true
+  credentials_required: true
+  one_way_sync: true