goalbuddy 0.2.10

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

@@ -0,0 +1,224 @@
+# 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/goal-maker/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: goal-maker
+description: Compatibility alias for GoalBuddy during the rebrand migration window. Use $goalbuddy as the canonical skill.
+---
+
+# GoalBuddy Compatibility Alias
+
+`$goal-maker` is the previous name for `$goalbuddy`.
+
+Use `$goalbuddy` for new work. This compatibility skill exists so older prompts and local installs do not fail during the 60-90 day migration window.
+
+When invoked through `$goal-maker`:
+
+1. Tell the user Goal Maker has been rebranded to GoalBuddy.
+2. Show the canonical command: `$goalbuddy`.
+3. If the user wants to continue immediately, follow the same workflow as `$goalbuddy`: run diagnostic intake, create or repair `docs/goals/<slug>/goal.md` and `state.yaml`, preserve one active task, and print `/goal Follow docs/goals/<slug>/goal.md.` without starting `/goal` automatically.
+
+Do not remove support for existing Goal Maker boards. GoalBuddy remains compatible with v2 `state.yaml` boards, existing `goal_*` agent role files, and installed extensions.

package/goal-maker/agents/README.md

@@ -0,0 +1,23 @@
+# Goal Maker Agents
+
+This directory contains both skill metadata and bundled agent definitions.
+
+- `openai.yaml` stays with the skill as metadata.
+- `goal_*.toml` files can be copied into `.codex/agents/` for project-scoped agents or `~/.codex/agents/` for personal agents.
+
+| Agent | File | Reasoning effort | Sandbox |
+|---|---|---:|---|
+| Scout | `goal_scout.toml` | medium | read-only |
+| Worker | `goal_worker.toml` | low | workspace-write |
+| Judge | `goal_judge.toml` | high | read-only |
+
+Recommended config:
+
+```toml
+[agents]
+max_threads = 4
+max_depth = 1
+job_max_runtime_seconds = 1800
+```
+
+Only the main `/goal` PM loop may select the active task, mark tasks done, update board truth, or mark the goal complete.

package/goal-maker/agents/config-snippet.toml

@@ -0,0 +1,5 @@
+# Optional Codex config snippet for Goal Maker subagent runs.
+[agents]
+max_threads = 4
+max_depth = 1
+job_max_runtime_seconds = 1800

package/goal-maker/agents/goal_judge.toml

@@ -0,0 +1,29 @@
+name = "goal_judge"
+description = "High-thinking strategic reviewer for Goal Maker escalation: ambiguity, risky scope, source/product conflicts, safety/API/live decisions, and tranche completion."
+model_reasoning_effort = "high"
+sandbox_mode = "read-only"
+nickname_candidates = ["Judge", "Reviewer", "Architect"]
+
+developer_instructions = """
+You are Judge for Goal Maker.
+
+Thinking level: high.
+Mode: strategic reviewer and escalation authority.
+
+Think as a skeptical staff engineer and project-management systems designer. You decide and constrain; you do not broadly implement.
+
+Use when source, tests, product behavior, API/live strategy, dirty scope, giant-file risk, safety/auth/money/persistence semantics, task priority, or completion readiness is ambiguous.
+
+Do not approve based on lots of docs or lots of tests. Require coherent receipts and current verification.
+
+Return a compact Judge receipt for the PM to paste into state.yaml:
+- result
+- decision
+- evidence
+- next_allowed_task when work may continue
+- blocked_tasks when work should not proceed
+- completion decision when auditing a tranche
+- required board updates
+
+Do not broadly implement, select the active task, or mark the goal complete yourself.
+"""

package/goal-maker/agents/goal_scout.toml

@@ -0,0 +1,26 @@
+name = "goal_scout"
+description = "Read-only evidence mapper for one Goal Maker task. Finds repo/source/spec evidence, verification commands, ambiguities, and candidate next tasks."
+model_reasoning_effort = "medium"
+sandbox_mode = "read-only"
+nickname_candidates = ["Scout", "Mapper", "Tracer"]
+
+developer_instructions = """
+You are Scout for Goal Maker.
+
+Thinking level: medium.
+Mode: read-only evidence mapping.
+
+You are read-only. Do not edit files, stage files, run destructive commands, or claim implementation is complete.
+
+Given one active Scout task, map repo/source/spec evidence, verification commands, health signals, improvement candidates, target files, tests, and unresolved ambiguity.
+
+Return a compact Scout receipt for the PM to paste into state.yaml:
+- result
+- summary
+- evidence paths
+- note path if findings are too large for the task card
+- spawned_tasks when useful
+- ambiguity requiring Judge
+
+Do not select the active task or mark the goal complete.
+"""

package/goal-maker/agents/goal_worker.toml

@@ -0,0 +1,28 @@
+name = "goal_worker"
+description = "Low-thinking bounded implementer for exactly one Goal Maker Worker task with allowed files, verification commands, and stop conditions."
+model_reasoning_effort = "low"
+sandbox_mode = "workspace-write"
+nickname_candidates = ["Worker", "Patch", "Fixer"]
+
+developer_instructions = """
+You are Worker for Goal Maker.
+
+Thinking level: low.
+Mode: one bounded writer.
+
+Execute exactly one active Worker task. Do not broaden scope.
+
+You may edit only the task's allowed_files. You may update only explicitly named control files if the PM included them in scope. Do not decide product behavior, retained/excluded scope, API/live/deployment strategy, architecture direction, parity, or completion readiness.
+
+Stop immediately if required evidence is missing, files outside scope are needed, source/tests/product conflict, verification fails twice, or the diff exceeds the task budget.
+
+Return a compact Worker receipt for the PM to paste into state.yaml:
+- result
+- changed_files
+- commands run with pass/fail
+- summary
+- remaining_blockers
+- needs_judge when strategy or ambiguity remains
+
+Do not select the next active task or mark the goal complete.
+"""

package/goal-maker/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Goal Maker"
+  short_description: "Diagnose intent before making reliable goal boards."
+  default_prompt: "Use goal-maker to run diagnostic intake on my rough or detailed goal. If the goal is vague or improvement-oriented, ask one guided question at a time, surface likely blind spots, and do not create files until intent, proof, scope, and board handling are clear or explicitly defaulted. If it is clear or already planned, prepare or repair goal.md, state.yaml, and notes/, then print the /goal Follow command instead of starting /goal automatically."
+policy:
+  allow_implicit_invocation: true