goalbuddy 0.3.6 → 0.3.8

package/examples/improve-goal-maker/state.yaml

@@ -1,224 +0,0 @@
-# Goal Maker v2 state.yaml
-# Board truth lives here. goal.md is the editable charter; notes/ holds long receipts only.
-
-version: 2
-
-goal:
-  title: "Improve Goal Maker"
-  slug: "improve-goal-maker"
-  kind: open_ended # specific | open_ended | recovery | audit
-  tranche: "Discover the highest-leverage local improvements to Goal Maker, complete the first safe implementation tranche, and leave a reviewable handoff for anything larger."
-  status: done # active | blocked | done
-
-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
-
-agents:
-  scout: installed
-  worker: installed
-  judge: installed
-
-active_task: null
-
-tasks:
-  - id: T001
-    type: scout
-    assignee: Scout
-    status: done
-    objective: "Map Goal Maker purpose, architecture, templates, scripts, tests, docs, verification commands, health signals, and improvement candidates."
-    inputs:
-      - README.md
-      - CONTRIBUTING.md
-      - package.json
-      - goal-maker/SKILL.md
-      - goal-maker/templates
-      - goal-maker/scripts
-      - goal-maker/test
-      - docs
-    constraints:
-      - "Read-only."
-      - "Do not edit implementation files."
-      - "Prefer concrete file-path evidence over generic advice."
-      - "Flag any mismatch between the skill contract, templates, checker, tests, and Codex agent behavior."
-    expected_output:
-      - "Repo map"
-      - "Verification commands"
-      - "Current failures or unknowns"
-      - "Ranked improvement candidates"
-      - "Candidate next tasks"
-    receipt:
-      result: done
-      note: notes/T001-repo-map.md
-      summary: "Repo map completed; verification is green, install/package checks work, and the top improvement area is Goal Maker workflow reliability around checker blind spots, agent installation assumptions, and template/skill drift."
-      evidence:
-        - README.md
-        - CONTRIBUTING.md
-        - package.json
-        - goal-maker/SKILL.md
-        - goal-maker/bin/goal-maker.mjs
-        - goal-maker/scripts/check-goal-state.mjs
-        - goal-maker/scripts/install-agents.mjs
-        - goal-maker/templates/state.yaml
-        - goal-maker/agents/goal_scout.toml
-        - goal-maker/agents/goal_worker.toml
-        - goal-maker/agents/goal_judge.toml
-        - goal-maker/test/check-goal-state.test.mjs
-      spawned_tasks:
-        - T002
-        - T003
-  - id: T002
-    type: scout
-    assignee: Scout
-    status: done
-    objective: "Investigate Goal Maker workflow risks, stale instructions, checker blind spots, and agent-installation assumptions."
-    inputs:
-      - "T001 receipt"
-      - goal-maker/agents
-      - goal-maker/scripts/check-goal-state.mjs
-      - goal-maker/scripts/install-agents.mjs
-      - goal-maker/templates
-      - goal-maker/test
-    constraints:
-      - "Read-only."
-      - "Do not edit implementation files."
-      - "Ground every risk in a file path, command result, or missing coverage."
-    expected_output:
-      - "Risk map"
-      - "Checker or template gaps"
-      - "Agent setup assumptions"
-      - "Small safe implementation candidates"
-    receipt:
-      result: done
-      note: notes/T002-risk-map.md
-      summary: "Risk map completed; doctor exits green with missing agents, checker accepts type/assignee mismatches, and update leaves stale agents unless forced."
-      evidence:
-        - goal-maker/bin/goal-maker.mjs
-        - goal-maker/scripts/check-goal-state.mjs
-        - goal-maker/scripts/install-agents.mjs
-        - goal-maker/test/check-goal-state.test.mjs
-        - README.md
-      spawned_tasks:
-        - T003
-  - id: T003
-    type: judge
-    assignee: Judge
-    status: done
-    objective: "Choose the first safe implementation tranche by impact, confidence, reversibility, and verification strength."
-    inputs:
-      - "T001 receipt"
-      - "T002 receipt if available"
-      - "Current dirty diff"
-    constraints:
-      - "Do not implement."
-      - "Pick small reviewable work."
-      - "Prefer changes that improve Goal Maker reliability or clarity without widening scope."
-    expected_output:
-      - "Decision"
-      - "First Worker task with allowed_files and verify commands"
-      - "Blocked or deferred tasks"
-    receipt:
-      result: done
-      decision: "Implement the doctor missing-agent reliability fix first; it directly supports the Goal Maker setup contract, is small, reversible, and can be verified with focused CLI tests plus npm run check."
-      evidence:
-        - examples/improve-goal-maker/notes/T001-repo-map.md
-        - examples/improve-goal-maker/notes/T002-risk-map.md
-        - goal-maker/bin/goal-maker.mjs
-        - package.json
-      next_allowed_task: T004
-      blocked_tasks:
-        - "Checker type/assignee mismatch fix deferred until after doctor reliability tranche."
-        - "Agent update overwrite semantics deferred because it may need owner policy on preserving local custom agents."
-      required_board_updates:
-        - "Set T004 active with allowed_files limited to the CLI and focused CLI test."
-  - id: T004
-    type: worker
-    assignee: Worker
-    status: done
-    objective: "Make `goal-maker doctor` fail when any required bundled agent definition is missing, with focused CLI test coverage."
-    allowed_files:
-      - goal-maker/bin/goal-maker.mjs
-      - goal-maker/test/goal-maker-cli.test.mjs
-    verify:
-      - npm run check
-      - tmp=$(mktemp -d); node goal-maker/bin/goal-maker.mjs install --codex-home "$tmp" >/dev/null && rm "$tmp/agents/goal_worker.toml" && ! node goal-maker/bin/goal-maker.mjs doctor --codex-home "$tmp"; rc=$?; rm -rf "$tmp"; exit $rc
-    stop_if:
-      - "Need files outside allowed_files."
-      - "Behavior is ambiguous."
-      - "Verification fails twice."
-      - "Need to touch unrelated asset changes in the dirty worktree."
-    receipt:
-      result: done
-      changed_files:
-        - goal-maker/bin/goal-maker.mjs
-        - goal-maker/test/goal-maker-cli.test.mjs
-      commands:
-        - cmd: node --test goal-maker/test/goal-maker-cli.test.mjs
-          status: fail_expected_red
-        - cmd: node --test goal-maker/test/goal-maker-cli.test.mjs
-          status: pass
-        - cmd: node --check goal-maker/bin/goal-maker.mjs
-          status: pass
-        - cmd: npm run check
-          status: pass
-        - cmd: tmp=$(mktemp -d); node goal-maker/bin/goal-maker.mjs install --codex-home "$tmp" >/dev/null && rm "$tmp/agents/goal_worker.toml" && ! node goal-maker/bin/goal-maker.mjs doctor --codex-home "$tmp"; rc=$?; rm -rf "$tmp"; exit $rc
-          status: pass
-        - cmd: git diff --check
-          status: pass
-      summary: "`goal-maker doctor` now reports `missing_agents` and exits non-zero when any required bundled agent definition is absent; focused CLI coverage was added."
-  - id: T999
-    type: judge
-    assignee: Judge
-    status: done
-    objective: "Audit whether the current tranche is complete."
-    inputs:
-      - "All done task receipts"
-      - "Last verification"
-      - "Current dirty diff"
-    constraints:
-      - "Do not implement."
-      - "Completion requires evidence from receipts and verification."
-    expected_output:
-      - "complete | not_complete"
-      - "missing evidence"
-      - "next task if not complete"
-    receipt:
-      result: done
-      decision: complete
-      summary: "Current tranche is complete: Scout mapped the repo, Scout/Judge selected the doctor missing-agent reliability fix, Worker implemented it inside allowed files, and fresh verification passed."
-      evidence:
-        - examples/improve-goal-maker/notes/T001-repo-map.md
-        - examples/improve-goal-maker/notes/T002-risk-map.md
-        - goal-maker/bin/goal-maker.mjs
-        - goal-maker/test/goal-maker-cli.test.mjs
-      verification:
-        - cmd: npm run check
-          status: pass
-        - cmd: tmp=$(mktemp -d); node goal-maker/bin/goal-maker.mjs install --codex-home "$tmp" >/dev/null && rm "$tmp/agents/goal_worker.toml" && ! node goal-maker/bin/goal-maker.mjs doctor --codex-home "$tmp"; rc=$?; rm -rf "$tmp"; exit $rc
-          status: pass
-        - cmd: git diff --check
-          status: pass
-        - cmd: node goal-maker/scripts/check-goal-state.mjs examples/improve-goal-maker/state.yaml
-          status: pass
-      deferred:
-        - "Checker type/assignee mismatch validation."
-        - "Agent update overwrite semantics."
-        - "Optional checker validation for missing or invalid agents section."
-
-checks:
-  dirty_fingerprint: unknown
-  last_verification:
-    result: pass
-    task: T999
-    commands:
-      - cmd: npm run check
-        status: pass
-      - cmd: tmp=$(mktemp -d); node goal-maker/bin/goal-maker.mjs install --codex-home "$tmp" >/dev/null && rm "$tmp/agents/goal_worker.toml" && ! node goal-maker/bin/goal-maker.mjs doctor --codex-home "$tmp"; rc=$?; rm -rf "$tmp"; exit $rc
-        status: pass
-      - cmd: git diff --check
-        status: pass
-      - cmd: node goal-maker/scripts/check-goal-state.mjs examples/improve-goal-maker/state.yaml
-        status: pass

package/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/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/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