goalbuddy 0.3.6 → 0.3.7

package/goalbuddy/extend/github-projects/test/github-projects.test.mjs

@@ -1,267 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { readFile } from "node:fs/promises";
-import { resolve } from "node:path";
-import { GoalStateError, normalizeGoalBoard, parseGoalStateText } from "../scripts/lib/goal-state.mjs";
-import {
-  GITHUB_PROJECT_FIELDS,
-  GITHUB_PROJECT_VIEWS,
-  agentLaneForTask,
-  buildDraftIssueBody,
-  buildFieldUpdates,
-  ensureGoalProjectViews,
-  planGitHubProjectSync,
-  priorityForTask,
-  projectStatusForTask,
-  workTypeForTask,
-} from "../scripts/lib/github-projects.mjs";
-
-describe("goal state parsing", () => {
-  it("normalizes a GoalBuddy v2 board", async () => {
-    const text = await readFile(resolve("extend/github-projects/examples/goal-board-sync/state.yaml"), "utf8");
-    const board = normalizeGoalBoard(parseGoalStateText(text));
-
-    assert.equal(board.title, "Goal board sync MVP");
-    assert.equal(board.activeTask, "T002");
-    assert.equal(board.tasks.length, 3);
-    assert.equal(board.tasks[0].title, "Map external board API requirements");
-    assert.equal(board.tasks[1].priority, "P1");
-    assert.equal(board.tasks[0].receiptSummary, "The board sync can read GoalBuddy state.yaml and mirror tasks into an external board.");
-    assert.equal(board.tasks[0].goalRole, "Scout");
-    assert.equal(board.tasks[1].agentResponsible, "Worker");
-    assert.equal(board.tasks[1].credentialGate, "Credentials");
-    assert.equal(board.tasks[1].parentId, "T001");
-    assert.deepEqual(board.tasks[1].dependsOn, ["T001"]);
-    assert.deepEqual(board.tasks[1].verify, [
-      "node --test extend/github-projects/test/*.test.mjs",
-      "node extend/github-projects/scripts/sync-github-project.mjs --state extend/github-projects/examples/goal-board-sync/state.yaml --dry-run",
-    ]);
-  });
-
-  it("rejects malformed task status", () => {
-    const parsed = parseGoalStateText(`
-version: 2
-goal:
-  title: "Bad board"
-  slug: "bad-board"
-tasks:
-  - id: T001
-    status: moving
-    objective: "Bad status"
-`);
-
-    assert.throws(() => normalizeGoalBoard(parsed), GoalStateError);
-  });
-});
-
-describe("GitHub Projects mapping", () => {
-  it("plans GitHub draft issue creates and updates by task id", () => {
-    const tasks = [
-      {
-        id: "T001",
-        title: "T001: Existing",
-        objective: "Existing",
-        status: "done",
-        type: "scout",
-        assignee: "Scout",
-        receiptSummary: "Done",
-        verify: [],
-        allowedFiles: [],
-        updatedLabel: "receipt:done",
-      },
-      {
-        id: "T002",
-        title: "T002: New",
-        objective: "New",
-        status: "queued",
-        type: "worker",
-        assignee: "Worker",
-        receiptSummary: "",
-        verify: [],
-        allowedFiles: [],
-        updatedLabel: "receipt:none",
-      },
-    ];
-
-    const operations = planGitHubProjectSync(tasks, [
-      {
-        id: "PVTI_existing",
-        taskId: { text: "T001" },
-        content: { __typename: "DraftIssue", id: "DI_existing" },
-      },
-    ]);
-
-    assert.equal(operations[0].type, "update");
-    assert.equal(operations[0].itemId, "PVTI_existing");
-    assert.equal(operations[0].draftIssueId, "DI_existing");
-    assert.equal(operations[1].type, "create");
-  });
-
-  it("builds GitHub field updates for text and single-select fields", () => {
-    const fields = {
-      taskId: { id: "F_task" },
-      status: { id: "F_status", name: GITHUB_PROJECT_FIELDS.status, options: [{ id: "O_progress", name: "In Progress" }] },
-      priority: { id: "F_priority", name: GITHUB_PROJECT_FIELDS.priority, options: [{ id: "O_p1", name: "P1" }] },
-      workType: { id: "F_type", name: GITHUB_PROJECT_FIELDS.workType, options: [{ id: "O_execution", name: "Execution" }] },
-      agentLane: { id: "F_lane", name: GITHUB_PROJECT_FIELDS.agentLane, options: [{ id: "O_worker", name: "Worker" }] },
-      owner: { id: "F_owner" },
-      goalRole: { id: "F_goal_role" },
-      agentResponsible: { id: "F_agent" },
-      credentialGate: { id: "F_gate" },
-      parentId: { id: "F_parent" },
-      dependsOn: { id: "F_depends" },
-      receiptSummary: { id: "F_receipt" },
-      verify: { id: "F_verify" },
-      allowedFiles: { id: "F_allowed" },
-      updated: { id: "F_updated" },
-    };
-    const task = {
-      id: "T002",
-      status: "active",
-      type: "worker",
-      assignee: "Worker",
-      goalRole: "Worker",
-      agentResponsible: "Worker",
-      credentialGate: "None",
-      receiptSummary: "",
-      verify: ["npm test"],
-      allowedFiles: ["scripts/**"],
-      parentId: "T001",
-      dependsOn: ["T001"],
-      updatedLabel: "receipt:none",
-    };
-
-    const updates = buildFieldUpdates(task, fields);
-    assert.equal(updates.length, 15);
-    assert.deepEqual(updates.find((update) => update.fieldId === "F_status").value, {
-      singleSelectOptionId: "O_progress",
-    });
-    assert.deepEqual(updates.find((update) => update.fieldId === "F_task").value, {
-      text: "T002",
-    });
-    assert.deepEqual(updates.find((update) => update.fieldId === "F_lane").value, {
-      singleSelectOptionId: "O_worker",
-    });
-    assert.deepEqual(updates.find((update) => update.fieldId === "F_goal_role").value, { text: "Worker" });
-    assert.deepEqual(updates.find((update) => update.fieldId === "F_agent").value, { text: "Worker" });
-    assert.deepEqual(updates.find((update) => update.fieldId === "F_gate").value, { text: "None" });
-    assert.deepEqual(updates.find((update) => update.fieldId === "F_parent").value, { text: "T001" });
-    assert.deepEqual(updates.find((update) => update.fieldId === "F_depends").value, { text: "T001" });
-  });
-
-  it("builds a draft issue body that points back to the state file", () => {
-    const body = buildDraftIssueBody(
-      {
-        id: "T002",
-        objective: "Run sync.",
-        status: "active",
-        type: "worker",
-        assignee: "Worker",
-        receiptSummary: "",
-        verify: ["npm test"],
-        allowedFiles: ["scripts/**"],
-        parentId: "T001",
-        dependsOn: ["T001"],
-      },
-      {
-        sourcePath: "extend/github-projects/examples/goal-board-sync/state.yaml",
-      }
-    );
-
-    assert.match(body, /YAML remains the source of truth/);
-    assert.match(body, /Task ID: T002/);
-    assert.match(body, /Parent: T001/);
-    assert.match(body, /Depends on:/);
-    assert.match(body, /extend\/github-projects\/examples\/goal-board-sync\/state\.yaml/);
-  });
-
-  it("creates only the Goal Board GitHub Project view with visible fields when missing", async () => {
-    const restCalls = [];
-    const views = await ensureGoalProjectViews({
-      client: {
-        rest: async (path, options) => {
-          restCalls.push({ path, options });
-          return {
-            html_url: "https://github.com/users/example/projects/1/views/2",
-          };
-        },
-      },
-      project: {
-        number: 1,
-        owner: { __typename: "User", login: "example" },
-        views: { nodes: [] },
-      },
-      fields: {
-        taskId: { databaseId: 1 },
-        status: { databaseId: 2 },
-        priority: { databaseId: 3 },
-        workType: { databaseId: 4 },
-        owner: { databaseId: 5 },
-        agentLane: { databaseId: 13 },
-        goalRole: { databaseId: 10 },
-        agentResponsible: { databaseId: 11 },
-        credentialGate: { databaseId: 12 },
-        receiptSummary: { databaseId: 6 },
-        verify: { databaseId: 7 },
-        allowedFiles: { databaseId: 8 },
-        updated: { databaseId: 9 },
-      },
-    });
-
-    assert.equal(views.board.html_url, "https://github.com/users/example/projects/1/views/2");
-    assert.equal(views.agentWorkboard, undefined);
-    assert.equal(restCalls.length, 1);
-    assert.equal(restCalls[0].path, "users/example/projectsV2/1/views");
-    assert.equal(restCalls[0].options.body.layout, "board");
-    assert.equal(restCalls[0].options.body.name, GITHUB_PROJECT_VIEWS.board.name);
-    assert.deepEqual(restCalls[0].options.body.visible_fields, [3, 2, 4, 5, 10, 11, 13, 12]);
-    assert.equal(restCalls[0].options.body.group_by, undefined);
-  });
-
-  it("reuses an existing Goal Board view without creating extra views", async () => {
-    const views = await ensureGoalProjectViews({
-      client: {
-        rest: async () => {
-          throw new Error("REST should not be called for existing views.");
-        },
-      },
-      project: {
-        number: 1,
-        owner: { __typename: "User", login: "example" },
-        views: {
-          nodes: [
-            { id: "PVTV_board", name: "Goal Board", layout: "BOARD_LAYOUT" },
-            { id: "PVTV_agent", name: "Agent Workboard", layout: "BOARD_LAYOUT" },
-          ],
-        },
-      },
-      fields: {},
-    });
-
-    assert.equal(views.board.id, "PVTV_board");
-    assert.equal(views.agentWorkboard, undefined);
-  });
-
-  it("maps GoalBuddy task statuses to native GitHub board statuses", () => {
-    assert.equal(projectStatusForTask("queued"), "Todo");
-    assert.equal(projectStatusForTask("active"), "In Progress");
-    assert.equal(projectStatusForTask("blocked"), "Blocked");
-    assert.equal(projectStatusForTask("done"), "Done");
-  });
-
-  it("maps GoalBuddy task types and priorities to lean PM fields", () => {
-    assert.equal(workTypeForTask("scout"), "Discovery");
-    assert.equal(workTypeForTask("judge"), "Decision");
-    assert.equal(workTypeForTask("worker"), "Execution");
-    assert.equal(priorityForTask({ status: "blocked", type: "worker" }), "P0");
-    assert.equal(priorityForTask({ status: "active", type: "worker" }), "P1");
-    assert.equal(priorityForTask({ status: "queued", type: "scout" }), "P2");
-    assert.equal(priorityForTask({ status: "done", type: "worker" }), "P3");
-    assert.equal(priorityForTask({ status: "queued", type: "scout", priority: "P0" }), "P0");
-    assert.equal(agentLaneForTask({ assignee: "PM" }), "PM");
-    assert.equal(agentLaneForTask({ agentResponsible: "Scout" }), "Scout");
-    assert.equal(agentLaneForTask({ goalRole: "Judge" }), "Judge");
-    assert.equal(agentLaneForTask({ agentResponsible: "Worker" }), "Worker");
-    assert.equal(agentLaneForTask({ agentResponsible: "User" }), "User");
-  });
-});

package/goalbuddy/extend/local-goal-board/extension.yaml

@@ -1,39 +0,0 @@
-id: local-goal-board
-name: Local Goal Board
-kind: visualization
-version: 0.2.0
-source_of_truth: local
-description: Generate and serve a GoalBuddy-branded local Kanban board that updates live from a goal directory's state.yaml, notes, and linked depth-1 sub-goals.
-local_use_prompt: Run the bundled local board script for docs/goals/<slug>. It writes a tiny web app into docs/goals/<slug>/.goalbuddy-board and serves it through the shared goalbuddy.localhost:41737 local board hub with live SSE updates from state.yaml, notes, and linked depth-1 sub-goals. Multiple active boards are available from the board header switcher. Use --once --json for generation checks and no long-running server.
-use_when:
-  - A human wants to watch a GoalBuddy run in a local board UI.
-  - The goal needs GitHub-Projects-like visibility without GitHub credentials.
-  - state.yaml and notes should remain the source of truth while the browser updates live.
-  - A parent task links a depth-1 child board under subgoals/.
-activation: user_requested
-outputs:
-  - Local GoalBuddy board web app
-  - Live state.yaml and notes viewer
-requires_approval: false
-safe_by_default: true
-reads:
-  - docs/goals/<slug>/state.yaml
-  - docs/goals/<slug>/notes
-  - docs/goals/<slug>/subgoals
-writes:
-  - docs/goals/<slug>/.goalbuddy-board
-side_effects:
-  - Starts or reuses the shared local-only HTTP board hub when not run with --once.
-agent_instructions:
-  - Use the bundled local-goal-board script; do not build a static-only mockup.
-  - Keep state.yaml authoritative; the app is only a viewer.
-  - Require live no-manual-reload updates through the local server event stream.
-  - Keep the generated UI simple, clean, minimal, and GoalBuddy branded.
-auth:
-  env: []
-supports:
-  dry_run: true
-  live_local_board: true
-  live_updates: true
-  credentials_required: false
-  generated_goal_artifact: true

package/internal/assets/extend-release.svg

@@ -1,83 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="900" viewBox="0 0 1600 900" role="img" aria-labelledby="title desc">
-  <title id="title">GoalBuddy Extend release graphic</title>
-  <desc id="desc">A white-background black-and-red diagram showing a vague Codex goal becoming a GoalBuddy board, then extending to optional add-ons through a GitHub-hosted catalog.</desc>
-  <defs>
-    <style>
-      .bg { fill: #ffffff; }
-      .ink { fill: none; stroke: #141414; stroke-width: 8; stroke-linecap: round; stroke-linejoin: round; }
-      .thin { fill: none; stroke: #141414; stroke-width: 5; stroke-linecap: round; stroke-linejoin: round; }
-      .red { fill: none; stroke: #e1261c; stroke-width: 8; stroke-linecap: round; stroke-linejoin: round; }
-      .redfill { fill: #e1261c; }
-      .inkfill { fill: #141414; }
-      .muted { fill: #5b5f68; }
-      text { font-family: Arial, Helvetica, sans-serif; letter-spacing: 0; }
-      .label { font-size: 40px; font-weight: 700; }
-      .small { font-size: 26px; font-weight: 500; }
-      .mono { font-family: Menlo, Consolas, monospace; font-size: 30px; font-weight: 700; }
-      .title { font-size: 86px; font-weight: 800; }
-    </style>
-  </defs>
-
-  <rect class="bg" width="1600" height="900"/>
-
-  <text x="110" y="130" class="title inkfill">goalbuddy EXTEND</text>
-  <path class="red" d="M960 102 C1105 70 1255 76 1385 112"/>
-  <path class="red" d="M1372 91 L1394 116 L1362 130"/>
-  <text x="115" y="190" class="small muted">Open-ended Codex work becomes a local board. Optional integrations stay outside the core.</text>
-
-  <g transform="translate(105 280)">
-    <rect x="0" y="0" width="315" height="190" rx="24" class="thin"/>
-    <text x="34" y="58" class="label inkfill">vague goal</text>
-    <text x="34" y="105" class="small muted">“improve this”</text>
-    <path class="thin" d="M36 142 H212"/>
-    <path class="thin" d="M36 165 H152"/>
-  </g>
-
-  <path class="ink" d="M445 375 H565"/>
-  <path class="ink" d="M542 348 L572 375 L542 402"/>
-
-  <g transform="translate(600 250)">
-    <rect x="0" y="0" width="430" height="250" rx="28" class="ink"/>
-    <text x="38" y="62" class="label inkfill">local board</text>
-    <g transform="translate(42 98)">
-      <circle cx="20" cy="20" r="13" class="redfill"/>
-      <text x="52" y="30" class="small inkfill">Scout maps repo</text>
-    </g>
-    <g transform="translate(42 145)">
-      <circle cx="20" cy="20" r="13" class="redfill"/>
-      <text x="52" y="30" class="small inkfill">Judge picks scope</text>
-    </g>
-    <g transform="translate(42 192)">
-      <circle cx="20" cy="20" r="13" class="redfill"/>
-      <text x="52" y="30" class="small inkfill">Worker patches</text>
-    </g>
-  </g>
-
-  <path class="ink" d="M1060 375 H1130"/>
-  <path class="ink" d="M1107 348 L1137 375 L1107 402"/>
-
-  <g transform="translate(1160 245)">
-    <rect x="0" y="0" width="330" height="260" rx="28" class="red"/>
-    <text x="38" y="64" class="label inkfill">extend</text>
-    <text x="38" y="108" class="mono redfill">catalog.json</text>
-    <path class="thin" d="M42 144 H255"/>
-    <text x="42" y="190" class="small inkfill">publish</text>
-    <text x="42" y="228" class="small inkfill">report</text>
-    <text x="165" y="190" class="small inkfill">intake</text>
-    <text x="165" y="228" class="small inkfill">roles</text>
-  </g>
-
-  <g transform="translate(175 640)">
-    <path class="thin" d="M0 0 H1250"/>
-    <text x="0" y="62" class="small inkfill">core stays stable</text>
-    <text x="355" y="62" class="small inkfill">extensions move through GitHub</text>
-    <text x="870" y="62" class="small inkfill">state.yaml remains truth</text>
-    <circle cx="305" cy="51" r="7" class="redfill"/>
-    <circle cx="820" cy="51" r="7" class="redfill"/>
-  </g>
-
-  <g transform="translate(1110 735)">
-    <rect x="0" y="0" width="300" height="72" rx="36" class="red"/>
-    <text x="38" y="47" class="mono redfill">npx goalbuddy</text>
-  </g>
-</svg>

package/plugins/goalbuddy/skills/goalbuddy/extend/github-projects/README.md

@@ -1,105 +0,0 @@
-# GitHub Projects
-
-Mirror a GoalBuddy `state.yaml` board into GitHub Projects without making GitHub the source of truth.
-
-This extension ports the GitHub Projects work from PR #1 into the catalog-based extension system. It keeps the package core dependency-free and optional, while giving teams a practical way to publish a GoalBuddy board into a familiar project surface.
-
-## Use When
-
-- A long-running GoalBuddy board needs stakeholder visibility in GitHub Projects.
-- A team wants one-way sync from `state.yaml` into ProjectV2 draft issues.
-- The PM needs a dry-run plan before using GitHub credentials.
-- Existing GoalBuddy receipts, verification commands, allowed files, owners, and dependencies should be visible in a board layout.
-
-## What It Creates
-
-The live sync ensures a GitHub Project has:
-
-- Draft issues keyed by `Task ID`, so reruns update existing cards instead of duplicating them.
-- Status mapping: `queued -> Todo`, `active -> In Progress`, `blocked -> Blocked`, `done -> Done`.
-- Single-select fields for `Status`, `Priority`, `Work Type`, and `Agent Lane`.
-- Text fields for `Task ID`, `Owner`, `Goal Role`, `Agent Responsible`, `Credential Gate`, `Parent ID`, `Depends On`, `Receipt Summary`, `Verify`, `Allowed Files`, and `Goal Updated`.
-- A `Goal Board` board-layout view for PM flow.
-
-The extension must use the bundled sync script for live writes. Do not use Computer Use, browser automation, or the GitHub web UI to create or repair the board view. Do not replace the script with `gh project` commands; `gh project` does not expose the complete ProjectV2 view creation path this extension needs. The script uses GitHub GraphQL for projects, fields, items, and draft issues, plus the GitHub REST Project views endpoint for the `Goal Board` view.
-
-The sync only creates or reuses `Goal Board`. It does not create a default Table view, an `Agent Workboard`, or extra role-specific views. GitHub may still show views that already existed on the Project.
-
-The extension does not promise custom board grouping or sort order. GitHub's public Project views REST API currently accepts `name`, `layout`, `filter`, and `visible_fields` when creating a view, and GraphQL exposes grouping/sort fields for reading but not a public mutation for saving them. Because that display state cannot be written reliably through the public API, the sync only creates supported fields, cards, and the single `Goal Board` view.
-
-## Inputs
-
-- `docs/goals/<slug>/state.yaml`
-- Optional `GITHUB_PROJECT_ID`
-- Optional `GITHUB_PROJECT_OWNER` and `GITHUB_PROJECT_NUMBER`
-- `GITHUB_TOKEN` or `GH_TOKEN` for live sync
-
-## Dry Run
-
-Dry-run mode does not call GitHub:
-
-```bash
-node extend/github-projects/scripts/sync-github-project.mjs \
-  --state docs/goals/<slug>/state.yaml \
-  --dry-run
-```
-
-For structured output:
-
-```bash
-node extend/github-projects/scripts/sync-github-project.mjs \
-  --state docs/goals/<slug>/state.yaml \
-  --dry-run \
-  --json
-```
-
-## Live Sync
-
-Always run the bundled script for live sync. It creates or reuses the `Goal Board` view as part of the same run that syncs fields and draft issues.
-
-Use a ProjectV2 node ID:
-
-```bash
-GITHUB_TOKEN=... node extend/github-projects/scripts/sync-github-project.mjs \
-  --state docs/goals/<slug>/state.yaml \
-  --project-id <project-node-id>
-```
-
-Or use an owner and project number:
-
-```bash
-GITHUB_TOKEN=... node extend/github-projects/scripts/sync-github-project.mjs \
-  --state docs/goals/<slug>/state.yaml \
-  --owner <user-or-org> \
-  --project-number <number>
-```
-
-Environment alternatives:
-
-- `GITHUB_PROJECT_ID`
-- `GITHUB_PROJECT_OWNER`
-- `GITHUB_PROJECT_NUMBER`
-- `GITHUB_TOKEN` or `GH_TOKEN`
-
-## Verification
-
-```bash
-node --test extend/github-projects/test/*.test.mjs
-node extend/github-projects/scripts/sync-github-project.mjs \
-  --state extend/github-projects/examples/goal-board-sync/state.yaml \
-  --dry-run
-node extend/github-projects/scripts/sync-github-project.mjs \
-  --state extend/github-projects/examples/goal-board-sync/state.yaml \
-  --dry-run \
-  --json
-```
-
-## Boundaries
-
-- `state.yaml` remains authoritative.
-- The sync is one-way from GoalBuddy to GitHub Projects.
-- Missing GitHub credentials block only live sync, not local dry-run validation.
-- Live sync creates or updates GitHub Project draft issues, fields, and the `Goal Board` view through the bundled script.
-- Agents must not fall back to Computer Use, browser automation, or the GitHub web UI for Project setup.
-- Agents must not claim ProjectV2 board views are UI-only; GitHub's REST Project views API supports creating board-layout views.
-- Native GitHub issue hierarchy and dependencies are represented as fields because ProjectV2 draft issues do not provide full issue relationship semantics.

package/plugins/goalbuddy/skills/goalbuddy/extend/github-projects/examples/goal-board-sync/state.yaml

@@ -1,63 +0,0 @@
-version: 2
-
-goal:
-  title: "Goal board sync MVP"
-  slug: "goal-board-sync-mvp"
-  kind: specific
-  tranche: "Mirror a GoalBuddy board into an external Kanban surface."
-  status: active
-
-rules:
-  pm_owns_state: true
-  one_active_task: true
-  max_write_workers: 1
-  no_implementation_without_worker_or_pm_task: true
-  no_completion_without_judge_or_pm_audit: true
-
-active_task: T002
-
-tasks:
-  - id: T001
-    type: scout
-    assignee: Scout
-    status: done
-    priority: P3
-    objective: "Map external board API requirements."
-    inputs:
-      - "Board API docs"
-    constraints:
-      - "Read-only."
-    expected_output:
-      - "Required scopes"
-      - "Field mapping"
-    receipt:
-      result: done
-      summary: "The board sync can read GoalBuddy state.yaml and mirror tasks into an external board."
-  - id: T002
-    type: worker
-    assignee: Worker
-    status: active
-    priority: P1
-    objective: "Implement one-way external board sync."
-    parent: T001
-    depends_on:
-      - T001
-    allowed_files:
-      - "extend/github-projects/scripts/**"
-      - "README.md"
-    verify:
-      - "node --test extend/github-projects/test/*.test.mjs"
-      - "node extend/github-projects/scripts/sync-github-project.mjs --state extend/github-projects/examples/goal-board-sync/state.yaml --dry-run"
-    stop_if:
-      - "Board API credentials are unavailable."
-    receipt: null
-  - id: T003
-    type: judge
-    assignee: Judge
-    status: queued
-    priority: P2
-    objective: "Audit whether the board sync MVP is ready to document."
-    parent: T002
-    depends_on:
-      - T002
-    receipt: null

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

@@ -1,43 +0,0 @@
-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