goalbuddy 0.3.5 → 0.3.7

package/examples/extend-catalog-workflow/notes/T001-extension-model-map.md

@@ -1,47 +0,0 @@
-# T001: Extension Model Map
-
-Task: `T001`
-Kind: `scout`
-Status: `done`
-
-## Summary
-
-The scalable frame is `extend`: optional extension folders live at the repo root under `extend/`, and catalog metadata lives at `extend/catalog.json`. The npm CLI should read the GitHub-hosted catalog so extension discovery can change without publishing a new npm version.
-
-Board publishing is the first likely extension family, but the extension surface should also support unrelated add-ons such as role guidance, reports, intake tools, and external channel publishing.
-
-## Recommended Vocabulary
-
-- Repo surface: `extend/`
-- Items inside `extend/`: extensions
-- Catalog file: `extend/catalog.json`
-- Public action for external surfaces: publish
-- Avoid umbrella words: export, sync, capabilities
-
-## Architecture Notes
-
-Core should own:
-
-- skill installation;
-- agent installation;
-- board checker scripts;
-- extension catalog discovery;
-- checksum-verified extension installation;
-- extension doctor checks.
-
-Extensions should own:
-
-- provider-specific behavior;
-- provider docs;
-- auth requirements;
-- fixtures and tests;
-- optional role or reporting guidance.
-
-No extension may define a second meaning of `state.yaml`.
-
-## Candidate Tasks
-
-- Add a catalog-backed `goal-maker extend` command.
-- Add root `extend/` documentation.
-- Keep package-only CLI/tests out of the installable skill folder.
-- Add repo agent guidance so future improvements consider docs, skill instructions, CLI, tests, examples, and extensions together.

package/examples/extend-catalog-workflow/notes/T002-architecture-decision.md

@@ -1,48 +0,0 @@
-# T002: Architecture Decision
-
-Task: `T002`
-Kind: `judge`
-Status: `done`
-
-## Decision
-
-Use `extend` as the high-level optional surface and call each item an extension. Keep the default catalog GitHub-hosted at:
-
-```text
-https://raw.githubusercontent.com/tolibear/goal-maker/main/extend/catalog.json
-```
-
-The npm package should contain the stable core and CLI. The catalog can change on GitHub without requiring users to update npm for every optional integration.
-
-## CLI Shape
-
-Use one top-level extension command instead of separate browse/list/show verbs:
-
-```bash
-goal-maker extend
-goal-maker extend <extension-id>
-goal-maker extend install <extension-id>
-goal-maker extend doctor [extension-id]
-```
-
-This keeps the UX simple:
-
-- no argument means "show the catalog";
-- an id means "show this extension";
-- `install` copies checksum-verified files into the local Goal Maker install;
-- `doctor` verifies installed extension files and required environment.
-
-## Repo Shape
-
-Keep the root relatively clean:
-
-```text
-goal-maker/   # installable skill payload
-internal/     # package/dev infrastructure
-extend/       # optional extension folders
-examples/     # completed sample runs
-extend/catalog.json  # GitHub-hosted extension catalog
-AGENTS.md     # repo-specific agent guidance
-```
-
-`goal-maker/scripts/` stays inside the skill because installed skill docs call those scripts directly.

package/examples/extend-catalog-workflow/notes/T003-implementation-summary.md

@@ -1,43 +0,0 @@
-# T003: Catalog CLI Implementation
-
-Task: `T003`
-Kind: `worker`
-Status: `done`
-
-## Summary
-
-Implemented the first catalog-backed `goal-maker extend` workflow.
-
-Commit:
-
-- `105850e Add extension catalog workflow`
-
-## Shipped Behavior
-
-- `goal-maker extend` reads the GitHub-hosted catalog and reports available/install/configuration state.
-- `goal-maker extend <id>` shows extension details.
-- `goal-maker extend install <id>` installs checksum-verified extension files.
-- `goal-maker extend doctor [id]` validates installed extension files and required environment.
-- Root `catalog.json` provides an initially empty GitHub-hosted catalog.
-- README documents the extension discovery/install flow.
-
-## Files Touched
-
-At this point in the run, the CLI still lived under `goal-maker/bin/`. A later cleanup task moved it to `internal/cli/`.
-
-- `README.md`
-- `catalog.json`
-- `goal-maker/bin/goal-maker.mjs`
-- `goal-maker/test/goal-maker-cli.test.mjs`
-- `package.json`
-
-## Verification
-
-Commands passed:
-
-```bash
-npm run check
-git diff --check
-node goal-maker/bin/goal-maker.mjs extend --catalog-url catalog.json --json
-npm publish --dry-run --json
-```

package/examples/extend-catalog-workflow/notes/T004-root-extend-folder.md

@@ -1,24 +0,0 @@
-# T004: Root Extend Folder
-
-Task: `T004`
-Kind: `pm`
-Status: `done`
-
-## Summary
-
-Added a visible root `extend/` folder with documentation so GitHub shows the extension surface even before real extensions exist.
-
-Commit:
-
-- `17c65c9 Document extension folder`
-
-## Files Touched
-
-- `README.md`
-- `extend/README.md`
-
-## Receipt Notes
-
-The folder intentionally contains only documentation for now. Git cannot track an empty directory, and the product decision was to avoid bundling sample extensions until a real extension is ready.
-
-The README now says extensions live under `extend/` and move through the GitHub-hosted `extend/catalog.json`.

package/examples/extend-catalog-workflow/notes/T005-layout-cleanup.md

@@ -1,46 +0,0 @@
-# T005: Skill Package Layout Cleanup
-
-Task: `T005`
-Kind: `worker`
-Status: `done`
-
-## Summary
-
-Separated package-only infrastructure from the installable skill payload while keeping the repo root clean.
-
-Commit:
-
-- `6faa5de Clean skill package layout`
-
-## Files Touched
-
-- `AGENTS.md`
-- `CONTRIBUTING.md`
-- `README.md`
-- `extend/README.md`
-- `goal-maker/SKILL.md`
-- `goal-maker/bin/goal-maker.mjs` -> `internal/cli/goal-maker.mjs`
-- `goal-maker/test/*.test.mjs` -> `internal/test/*.test.mjs`
-- `package.json`
-
-## Result
-
-The installable skill payload is now focused:
-
-```text
-goal-maker/
-  SKILL.md
-  agents/
-  scripts/
-  templates/
-```
-
-Package/dev infrastructure is grouped under:
-
-```text
-internal/
-  cli/
-  test/
-```
-
-Root `AGENTS.md` now tells future agents to consider README, SKILL.md, templates, checker behavior, CLI UX, examples, package contents, and extension catalog design when improving this repo.

package/examples/extend-catalog-workflow/notes/T006-catalog-location.md

@@ -1,50 +0,0 @@
-# T006: Catalog Location
-
-Task: `T006`
-Kind: `worker`
-Status: `done`
-
-## Summary
-
-Moved the hosted catalog from the repo root to `extend/catalog.json`.
-
-Commit:
-
-- This example/catalog-location commit.
-
-## Why
-
-The repo root should stay relatively clean, and `catalog.json` is part of the extension surface. Keeping it under `extend/` makes the shape easier to understand:
-
-```text
-extend/
-  README.md
-  catalog.json
-  <extension-id>/
-```
-
-The npm CLI still reads the catalog from GitHub raw, now at:
-
-```text
-https://raw.githubusercontent.com/tolibear/goal-maker/main/extend/catalog.json
-```
-
-## Files Touched
-
-- `catalog.json` -> `extend/catalog.json`
-- `internal/cli/goal-maker.mjs`
-- `README.md`
-- `AGENTS.md`
-- `extend/README.md`
-- `examples/extend-catalog-workflow/`
-
-## Verification
-
-Commands to verify this task:
-
-```bash
-npm run check
-git diff --check
-node internal/cli/goal-maker.mjs extend --catalog-url extend/catalog.json --json
-npm publish --dry-run --json
-```

package/examples/extend-catalog-workflow/notes/T999-completion-audit.md

@@ -1,36 +0,0 @@
-# T999: Completion Audit
-
-Task: `T999`
-Kind: `judge`
-Status: `done`
-
-## Decision
-
-Complete.
-
-## Audit
-
-| Requirement | Evidence | Status |
-|---|---|---|
-| Use `extend` as the high-level surface | `extend/README.md`, `README.md`, `AGENTS.md` | Complete |
-| Items inside `extend` are extensions | `extend/README.md`, `README.md`, catalog terminology | Complete |
-| Avoid frequent npm releases for catalog updates | `extend/catalog.json` and default raw GitHub catalog URL | Complete |
-| Keep extension discovery credential-free | `goal-maker extend` and `goal-maker extend <id>` inspect catalog metadata only | Complete |
-| Verify installed extensions safely | checksum validation and `.installed.json` manifest in CLI implementation | Complete |
-| Keep root reasonably clean | package/dev files grouped under `internal/` | Complete |
-| Keep skill payload clean | `goal-maker/` contains skill, agents, scripts, and templates only | Complete |
-| Teach future agents about improvement surfaces | root `AGENTS.md` and SKILL.md note | Complete |
-
-## Verification
-
-Commands passed during the implementation tranche:
-
-```bash
-npm run check
-git diff --check
-node internal/cli/goal-maker.mjs extend --catalog-url extend/catalog.json --json
-npm publish --dry-run --json
-node goal-maker/scripts/check-goal-state.mjs examples/extend-catalog-workflow/state.yaml
-```
-
-The final state is reviewable and maps to actual commits rather than simulated history.

package/examples/extend-catalog-workflow/state.yaml

@@ -1,327 +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: "Extend Catalog Workflow"
-  slug: "extend-catalog-workflow"
-  kind: open_ended
-  tranche: "Design and implement the extension catalog workflow, root extend surface, and clean package/skill layout."
-  status: 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
-    reasoning_hint: high
-    objective: "Map the product vocabulary, extension surfaces, catalog strategy, and repo boundaries for optional Goal Maker extensions."
-    inputs:
-      - README.md
-      - package.json
-      - goal-maker/SKILL.md
-      - goal-maker/scripts/check-goal-state.mjs
-      - docs/goals/board-publishing-surfaces/goal.md
-    constraints:
-      - "Read-only."
-      - "Do not implement."
-      - "Treat external services as generated views, not board truth."
-      - "Use extend as the high-level concept and extensions as item names."
-    expected_output:
-      - "Recommended vocabulary."
-      - "Catalog and extension repo shape."
-      - "Candidate implementation tasks."
-    receipt:
-      result: done
-      note: notes/T001-extension-model-map.md
-      summary: "Mapped `extend/` as the optional extension surface, `extend/catalog.json` as the GitHub-hosted catalog, and package/dev internals as separate from the installable skill payload."
-      evidence:
-        - README.md
-        - package.json
-        - goal-maker/SKILL.md
-        - goal-maker/scripts/check-goal-state.mjs
-      spawned_tasks:
-        - T002
-  - id: T002
-    type: judge
-    assignee: Judge
-    status: done
-    reasoning_hint: high
-    objective: "Choose the extension vocabulary, catalog source, CLI shape, and repo layout before implementation."
-    inputs:
-      - "T001 receipt"
-      - examples/extend-catalog-workflow/notes/T001-extension-model-map.md
-    constraints:
-      - "Do not implement."
-      - "Preserve Goal Maker's local-first model."
-      - "Keep the root relatively clean."
-      - "Avoid browse/list/show as separate user concepts."
-    expected_output:
-      - "Decision on extension language."
-      - "Decision on catalog hosting."
-      - "First implementation tranche."
-    receipt:
-      result: done
-      decision: "Use root `extend/`, `extend/catalog.json`, and `goal-maker extend` as the single discovery/details command; group package-only CLI and tests under `internal/` while keeping skill runtime scripts inside `goal-maker/scripts/`."
-      note: notes/T002-architecture-decision.md
-      evidence:
-        - examples/extend-catalog-workflow/notes/T001-extension-model-map.md
-        - README.md
-        - package.json
-      next_allowed_task: T003
-  - id: T003
-    type: worker
-    assignee: Worker
-    status: done
-    reasoning_hint: medium
-    objective: "Implement the first catalog-backed `goal-maker extend` workflow."
-    allowed_files:
-      - README.md
-      - catalog.json
-      - goal-maker/bin/goal-maker.mjs
-      - goal-maker/test/goal-maker-cli.test.mjs
-      - package.json
-    verify:
-      - npm run check
-      - git diff --check
-      - node goal-maker/bin/goal-maker.mjs extend --catalog-url catalog.json --json
-      - npm publish --dry-run --json
-    stop_if:
-      - "Need provider credentials."
-      - "Need files outside allowed_files."
-      - "Catalog or extension semantics become ambiguous."
-      - "Verification fails twice."
-    receipt:
-      result: done
-      changed_files:
-        - README.md
-        - catalog.json
-        - goal-maker/bin/goal-maker.mjs
-        - goal-maker/test/goal-maker-cli.test.mjs
-        - package.json
-      commands:
-        - cmd: npm run check
-          status: pass
-        - cmd: git diff --check
-          status: pass
-        - cmd: node goal-maker/bin/goal-maker.mjs extend --catalog-url catalog.json --json
-          status: pass
-        - cmd: npm publish --dry-run --json
-          status: pass
-      summary: "Implemented catalog-backed `goal-maker extend`, root `catalog.json`, checksum-verified extension install, extension doctor checks, and CLI test coverage."
-      note: notes/T003-implementation-summary.md
-      commits:
-        - 105850e
-      spawned_tasks:
-        - T004
-  - id: T004
-    type: pm
-    assignee: PM
-    status: done
-    reasoning_hint: medium
-    objective: "Add a visible root `extend/` folder without bundling placeholder extensions."
-    inputs:
-      - "T002 decision"
-      - "T003 receipt"
-      - "Owner feedback that the repo should show an `/extend` folder."
-    constraints:
-      - "Do not add fake bundled extensions."
-      - "Keep extensions as subfolders under root `extend/`."
-      - "Keep npm catalog behavior GitHub-hosted."
-    expected_output:
-      - "Root extend folder with documentation."
-      - "README wording that points to the extension surface."
-    receipt:
-      result: done
-      summary: "Added root `extend/README.md` so the repo has a visible extension surface while keeping the catalog empty until real extensions ship."
-      note: notes/T004-root-extend-folder.md
-      changed_files:
-        - README.md
-        - extend/README.md
-      commands:
-        - cmd: npm run check
-          status: pass
-      commits:
-        - 17c65c9
-      spawned_tasks:
-        - T005
-  - id: T005
-    type: worker
-    assignee: Worker
-    status: done
-    reasoning_hint: medium
-    objective: "Move package-only CLI/tests out of the installable skill folder and add repo-specific agent guidance."
-    allowed_files:
-      - AGENTS.md
-      - CONTRIBUTING.md
-      - README.md
-      - extend/README.md
-      - goal-maker/SKILL.md
-      - goal-maker/bin/goal-maker.mjs
-      - goal-maker/test/check-goal-state.test.mjs
-      - goal-maker/test/goal-maker-cli.test.mjs
-      - internal/cli/goal-maker.mjs
-      - internal/test/check-goal-state.test.mjs
-      - internal/test/goal-maker-cli.test.mjs
-      - package.json
-    verify:
-      - npm run check
-      - git diff --check
-      - tmp=$(mktemp -d); node internal/cli/goal-maker.mjs install --codex-home "$tmp"; node internal/cli/goal-maker.mjs doctor --codex-home "$tmp"; rm -rf "$tmp"
-      - npm publish --dry-run --json
-    stop_if:
-      - "Need to move skill runtime scripts out of `goal-maker/scripts/`."
-      - "Need root folders beyond `internal/`."
-      - "Verification fails twice."
-    receipt:
-      result: done
-      changed_files:
-        - AGENTS.md
-        - CONTRIBUTING.md
-        - README.md
-        - extend/README.md
-        - goal-maker/SKILL.md
-        - internal/cli/goal-maker.mjs
-        - internal/test/check-goal-state.test.mjs
-        - internal/test/goal-maker-cli.test.mjs
-        - package.json
-      commands:
-        - cmd: npm run check
-          status: pass
-        - cmd: git diff --check
-          status: pass
-        - cmd: tmp=$(mktemp -d); node internal/cli/goal-maker.mjs install --codex-home "$tmp"; node internal/cli/goal-maker.mjs doctor --codex-home "$tmp"; rm -rf "$tmp"
-          status: pass
-        - cmd: npm publish --dry-run --json
-          status: pass
-      summary: "Moved package-only CLI/tests under `internal/`, removed `goal-maker/bin` and `goal-maker/test` from the skill payload, added root `AGENTS.md`, and updated docs/package paths."
-      note: notes/T005-layout-cleanup.md
-      commits:
-        - 6faa5de
-      spawned_tasks:
-        - T006
-  - id: T006
-    type: worker
-    assignee: Worker
-    status: done
-    reasoning_hint: low
-    objective: "Move the hosted catalog into `extend/` and update the CLI/default docs to match."
-    allowed_files:
-      - AGENTS.md
-      - README.md
-      - extend/README.md
-      - catalog.json
-      - extend/catalog.json
-      - internal/cli/goal-maker.mjs
-      - package.json
-      - examples/extend-catalog-workflow
-    verify:
-      - npm run check
-      - git diff --check
-      - node internal/cli/goal-maker.mjs extend --catalog-url extend/catalog.json --json
-      - npm publish --dry-run --json
-    stop_if:
-      - "Need to add bundled extensions."
-      - "Need a separate extension registry."
-      - "Verification fails twice."
-    receipt:
-      result: done
-      changed_files:
-        - AGENTS.md
-        - README.md
-        - extend/README.md
-        - extend/catalog.json
-        - internal/cli/goal-maker.mjs
-        - package.json
-        - examples/extend-catalog-workflow/goal.md
-        - examples/extend-catalog-workflow/state.yaml
-        - examples/extend-catalog-workflow/notes/T006-catalog-location.md
-      commands:
-        - cmd: npm run check
-          status: pass
-        - cmd: git diff --check
-          status: pass
-        - cmd: node internal/cli/goal-maker.mjs extend --catalog-url extend/catalog.json --json
-          status: pass
-        - cmd: npm publish --dry-run --json
-          status: pass
-      summary: "Moved the GitHub-hosted catalog into `extend/catalog.json`, updated the CLI default raw URL, and adjusted docs/example references."
-      note: notes/T006-catalog-location.md
-      commits:
-        - "this example/catalog-location commit"
-      spawned_tasks:
-        - T999
-  - id: T999
-    type: judge
-    assignee: Judge
-    status: done
-    reasoning_hint: high
-    objective: "Audit whether the extension catalog and layout cleanup tranche is complete."
-    inputs:
-      - "All done task receipts"
-      - "Last verification"
-      - "Current package dry run"
-    constraints:
-      - "Do not implement."
-      - "Completion requires evidence from actual commits and verification commands."
-    expected_output:
-      - "complete | not_complete"
-      - "missing evidence"
-      - "next task if not complete"
-    receipt:
-      result: done
-      decision: complete
-      note: notes/T999-completion-audit.md
-      summary: "The tranche is complete: extension vocabulary, GitHub-hosted catalog, `extend` CLI workflow, root extension surface, package layout cleanup, and repo agent guidance are implemented and verified."
-      evidence:
-        - examples/extend-catalog-workflow/goal.md
-        - examples/extend-catalog-workflow/notes/T001-extension-model-map.md
-        - examples/extend-catalog-workflow/notes/T002-architecture-decision.md
-        - examples/extend-catalog-workflow/notes/T003-implementation-summary.md
-        - examples/extend-catalog-workflow/notes/T004-root-extend-folder.md
-        - examples/extend-catalog-workflow/notes/T005-layout-cleanup.md
-        - examples/extend-catalog-workflow/notes/T006-catalog-location.md
-        - AGENTS.md
-        - extend/catalog.json
-        - extend/README.md
-        - internal/cli/goal-maker.mjs
-        - package.json
-      verification:
-        - cmd: npm run check
-          status: pass
-        - cmd: git diff --check
-          status: pass
-        - cmd: npm publish --dry-run --json
-          status: pass
-        - cmd: node goal-maker/scripts/check-goal-state.mjs examples/extend-catalog-workflow/state.yaml
-          status: pass
-
-checks:
-  dirty_fingerprint: unknown
-  last_verification:
-    result: pass
-    task: T999
-    commands:
-      - cmd: npm run check
-        status: pass
-      - cmd: git diff --check
-        status: pass
-      - cmd: npm publish --dry-run --json
-        status: pass
-      - cmd: node goal-maker/scripts/check-goal-state.mjs examples/extend-catalog-workflow/state.yaml
-        status: pass

package/examples/github-pr-workflow-extension/pr-handoff.md

@@ -1,46 +0,0 @@
-# PR Handoff: Add GitHub PR Workflow Extension
-
-## Suggested Title
-
-Add GitHub PR workflow extension
-
-## Summary
-
-- Adds `github-pr-workflow` as a cataloged Goal Maker extension.
-- Documents a local-first workflow for turning goal receipts into GitHub PR handoff text.
-- Keeps `state.yaml` authoritative and treats GitHub PR content as generated review context.
-
-## Goal Context
-
-- Original request: `$goal-maker add a new extension to goal-maker`
-- Target outcome: a discoverable GitHub PR workflow integration extension with catalog metadata, docs, and example proof.
-- Completion proof: catalog entry, extension documentation, example artifact, and local checks.
-
-## Changed Files
-
-- `extend/catalog.json`
-- `extend/README.md`
-- `extend/github-pr-workflow/README.md`
-- `extend/github-pr-workflow/extension.yaml`
-- `examples/github-pr-workflow-extension/pr-handoff.md`
-- `README.md`
-
-## Verification
-
-```bash
-node internal/cli/goal-maker.mjs extend --catalog-url extend/catalog.json --json
-node internal/cli/goal-maker.mjs extend github-pr-workflow --catalog-url extend/catalog.json --json
-node internal/cli/goal-maker.mjs extend install github-pr-workflow --catalog-url extend/catalog.json --dry-run --json
-npm run check
-git diff --check
-```
-
-## Review Notes
-
-- This is a local handoff workflow, not live GitHub automation.
-- No GitHub token is required for discovery, details, or install dry-run.
-- Future live PR creation should be a separate extension or explicitly approved follow-up task.
-
-## Follow-Up
-
-- Consider a later command or template generator only after the cataloged workflow proves useful.