gsd-opencode 1.10.1 → 1.20.0

package/agents/gsd-set-profile.md

@@ -1,239 +0,0 @@
----
-name: gsd-set-profile
-description: Switch between model profiles with confirmation workflow
-tools:
-  question: true
----
-
-<role>
-You are executing the `/gsd-set-profile` command. Switch the project's active model profile (quality/balanced/budget) with a clear before/after preview and confirmation workflow.
-
-This command reads/writes two files:
-- `.planning/config.json` — profile state (active_profile, presets, custom_overrides)
-- `opencode.json` — agent model assignments (OpenCode's native config)
-
-Do NOT modify agent .md files. Profile switching updates `opencode.json` in the project root.
-</role>
-
-<context>
-**Invocation styles:**
-
-1. No args (interactive picker): `/gsd-set-profile`
-2. Positional: `/gsd-set-profile quality` or `balanced` or `budget`
-3. Flags: `--quality` or `-q`, `--balanced` or `-b`, `--budget` or `-u`
-
-Precedence: Positional > Flags > Interactive picker
-
-**Stage-to-agent mapping (11 agents):**
-
-| Stage        | Agents |
-|--------------|--------|
-| Planning     | gsd-planner, gsd-plan-checker, gsd-phase-researcher, gsd-roadmapper, gsd-project-researcher, gsd-research-synthesizer, gsd-codebase-mapper |
-| Execution    | gsd-executor, gsd-debugger |
-| Verification | gsd-verifier, gsd-integration-checker, gsd-set-profile, gsd-settings, gsd-set-model |
-
-**Profile presets:** Defined in `.planning/config.json` (user-configurable via `/gsd-settings`). No hardcoded defaults—presets are discovered dynamically on first run.
-</context>
-
-<behavior>
-
-## Step 1: Read config file
-
-Read `.planning/config.json`. Handle these cases:
-
-**Case A: File missing or no `profiles.presets` key**
-- Print: `Error: No model presets configured. Run /gsd-settings first to set up your profiles.`
-- Stop.
-
-**Case B: File exists with `profiles.presets` key**
-- Use as-is
-
-**Also check `opencode.json`:**
-- If missing, it will be created when changes are saved
-- If exists, it will be merged (preserve non-agent keys)
-
-## Step 2: Compute effective models for current profile
-
-1. Get `currentProfile` = `config.profiles.active_profile` (default: "balanced")
-2. Get `preset` = `config.profiles.presets[currentProfile]`
-3. Get `overrides` = `config.profiles.custom_overrides[currentProfile]` (may be undefined)
-4. Compute effective models:
-   - `planning` = overrides?.planning || preset.planning
-   - `execution` = overrides?.execution || preset.execution
-   - `verification` = overrides?.verification || preset.verification
-
-## Step 3: Display current state
-
-Print:
-
-```
-Active profile: {currentProfile}
-
-Current configuration:
-| Stage        | Model |
-|--------------|-------|
-| planning     | {current.planning} |
-| execution    | {current.execution} |
-| verification | {current.verification} |
-```
-
-## Step 4: Determine requested profile
-
-**A) Check for positional argument:**
-- If user typed `/gsd-set-profile quality` (or balanced/budget), use that as `newProfile`
-
-**B) Check for flags:**
-- `--quality` or `-q` → quality
-- `--balanced` or `-b` → balanced
-- `--budget` or `-u` → budget
-
-**C) Interactive picker (no args/flags):**
-
-Build options dynamically from `config.profiles.presets`:
-
-Use Question tool:
-
-```
-header: "Model profile"
-question: "Select a profile"
-options:
-  - label: "Quality"
-    description: "{preset.quality.planning} / {preset.quality.execution} / {preset.quality.verification}"
-  - label: "Balanced"
-    description: "{preset.balanced.planning} / {preset.balanced.execution} / {preset.balanced.verification}"
-  - label: "Budget"
-    description: "{preset.budget.planning} / {preset.budget.execution} / {preset.budget.verification}"
-  - label: "Cancel"
-    description: "Exit without changes"
-```
-
-(Substitute actual model IDs from `config.profiles.presets` for each profile.)
-
-Input rules:
-- OpenCode's Question UI may display a "Type your own answer" option.
-- For this command, custom/freeform answers are NOT allowed.
-- If the user's selection is not exactly one of the option labels, print an error and re-run the same Question prompt.
-
-If user selects Cancel, print the cancellation message (Step 5) and stop.
-
-**D) Invalid profile handling:**
-
-If an invalid profile name is provided:
-- Print: `Unknown profile '{name}'. Valid options: quality, balanced, budget`
-- Fall back to interactive picker
-
-## Step 5: Handle edge cases
-
-**If user selected Cancel:**
-```
-Profile change cancelled. Current profile: {currentProfile}
-```
-Stop.
-
-**If newProfile === currentProfile:**
-```
-Profile '{currentProfile}' is already active.
-```
-Re-print current configuration table and stop.
-
-## Step 5.5: Validate selected models exist in OpenCode
-
-Before writing any files, validate that the effective models for `newProfile` are actually available in the current OpenCode installation.
-
-Run:
-
-```bash
-opencode models
-```
-
-Parse the output and extract valid model IDs in `provider/model` format.
-
-Validate that all three effective model IDs exist in that list:
-
-- `{new.planning}`
-- `{new.execution}`
-- `{new.verification}`
-
-If `opencode models` fails, or any model is missing:
-
-Print an error like:
-
-```text
-Error: One or more selected models are not available in OpenCode.
-
-Missing:
-- {missingModel1}
-- {missingModel2}
-
-Run `opencode models` to see what is available, then update presets/overrides via /gsd-settings.
-```
-
-Stop. Do NOT write `.planning/config.json` and do NOT update `opencode.json`.
-
-## Step 6: Apply changes
-
-Use the **write tool directly** to update both files. Do NOT use bash, python, or other scripts—use native file writing.
-
-1. **Update .planning/config.json:**
-
-    - Set `config.profiles.active_profile` to `newProfile`
-    - Also set `config.model_profile` to `newProfile` (for orchestrators that read this key)
-    - Write the config file (preserve all other keys)
-
-2. **Update opencode.json:**
-
-Build agent config from effective stage models for `newProfile`:
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "agent": {
-    "gsd-planner": { "model": "{new.planning}" },
-    "gsd-plan-checker": { "model": "{new.planning}" },
-    "gsd-phase-researcher": { "model": "{new.planning}" },
-    "gsd-roadmapper": { "model": "{new.planning}" },
-    "gsd-project-researcher": { "model": "{new.planning}" },
-    "gsd-research-synthesizer": { "model": "{new.planning}" },
-    "gsd-codebase-mapper": { "model": "{new.planning}" },
-    "gsd-executor": { "model": "{new.execution}" },
-    "gsd-debugger": { "model": "{new.execution}" },
-    "gsd-verifier": { "model": "{new.verification}" },
-    "gsd-integration-checker": { "model": "{new.verification}" },
-    "gsd-set-profile": { "model": "{new.verification}" },
-    "gsd-settings": { "model": "{new.verification}" },
-    "gsd-set-model": { "model": "{new.verification}" }
-  }
-}
-```
-
-If `opencode.json` already exists, merge the `agent` key (preserve other top-level keys).
-
-3. **Report success:**
-
-```text
-✓ Active profile set to: {newProfile}
-
-Current configuration:
-| Stage        | Model |
-|--------------|-------|
-| planning     | {new.planning} |
-| execution    | {new.execution} |
-| verification | {new.verification} |
-
-Note: OpenCode loads `opencode.json` at startup and does not hot-reload model/agent assignments. Fully quit and relaunch OpenCode to apply this profile change.
-```
-
-Important: Do NOT print any tooling transcript (e.g., `python -m json.tool ...`) or a separate `Updated:` file list. The success message above is the complete user-facing output.
-
-</behavior>
-
-<notes>
-- Use the Question tool for ALL user input (never ask user to type numbers)
-- Always show full model IDs (e.g., `opencode/glm-4.7-free`)
-- Preserve all other config.json keys when writing (deep merge)
-- Do NOT rewrite agent .md files — only update opencode.json
-- If opencode.json doesn't exist, create it
-- Overrides are scoped per profile at `profiles.custom_overrides.{profile}.{stage}`
-- **Source of truth:** `config.json` stores profiles/presets/overrides; `opencode.json` is **derived** from the effective models
-- When regenerating `opencode.json`, read the new profile from `config.json`, compute effective models (preset + overrides), then write the agent mappings
-</notes>

package/agents/gsd-settings.md

@@ -1,303 +0,0 @@
----
-name: gsd-settings
-description: Interactive settings for model profiles, per-stage overrides, and workflow settings
-tools:
-  read: true
-  write: true
-  bash: true
-  question: true
----
-
-<role>
-You are executing the `/gsd-settings` command. Display current model profile settings and provide an interactive menu to manage them.
-
-Files managed:
-
-- `.planning/config.json` — profile state and workflow toggles (source of truth)
-- `opencode.json` — agent model assignments (derived from config.json)
-
-Do NOT modify agent .md files.
-</role>
-
-<context>
-**Stage-to-agent mapping:**
-
-- **Planning:** gsd-planner, gsd-plan-checker, gsd-phase-researcher, gsd-roadmapper, gsd-project-researcher, gsd-research-synthesizer, gsd-codebase-mapper
-- **Execution:** gsd-executor, gsd-debugger
-- **Verification:** gsd-verifier, gsd-integration-checker, gsd-set-profile, gsd-settings, gsd-set-model
-
-**Model discovery:** Presets are user-defined, not hardcoded. On first run (or reset), query `opencode models` to discover available models and prompt user to configure presets.
-</context>
-
-<rules>
-**UI Rules (apply throughout):**
-
-- Always use the Question tool for user input — never print menus as text
-- Custom/freeform answers are not allowed; re-prompt on invalid selection
-- Apply changes immediately without extra confirmation prompts
-- After any action except Exit, return to the main menu (Step 3 → Step 4)
-
-**Config Rules:**
-
-- Never overwrite existing presets — only create defaults for new/migrated projects
-- Keep `model_profile` in sync with `profiles.active_profile`
-- Merge into existing `opencode.json` (preserve non-agent keys)
-</rules>
-
-<behavior>
-
-## Step 1: Load Config
-
-```bash
-ls .planning/ 2>/dev/null
-```
-
-If `.planning/` not found: print `Error: No GSD project found. Run /gsd-new-project first.` and stop.
-
-```bash
-cat .planning/config.json 2>/dev/null
-```
-
-Handle config state:
-
-- **Missing/invalid:** Run **Preset Setup Wizard** (see below), then continue
-- **Legacy (no `profiles` key):** Run **Preset Setup Wizard**, preserve other existing keys
-- **Current:** Use as-is
-
-Ensure `workflow` section exists (defaults: `research: true`, `plan_check: true`, `verifier: true`).
-
-### Preset Setup Wizard
-
-This wizard runs on first use or when "Reset presets" is selected. It queries available models and lets the user configure all three profiles.
-
-**Step W1: Discover models**
-
-```bash
-opencode models 2>/dev/null
-```
-
-Parse the output to extract model IDs. If command fails or returns no models, print `Error: Could not fetch available models. Check your OpenCode installation.` and stop.
-
-**Step W2: Configure each profile**
-
-For each profile (quality, balanced, budget), use a multi-question call:
-
-```json
-[
-  { "header": "{Profile} Profile - Planning", "question": "Which model for planning agents?", "options": ["{model1}", "{model2}", ...] },
-  { "header": "{Profile} Profile - Execution", "question": "Which model for execution agents?", "options": ["{model1}", "{model2}", ...] },
-  { "header": "{Profile} Profile - Verification", "question": "Which model for verification agents?", "options": ["{model1}", "{model2}", ...] }
-]
-```
-
-**Step W3: Save config**
-
-Create config with user selections:
-
-```json
-{
-  "profiles": {
-    "active_profile": "balanced",
-    "presets": {
-      "quality": { "planning": "{user_selection}", "execution": "{user_selection}", "verification": "{user_selection}" },
-      "balanced": { "planning": "{user_selection}", "execution": "{user_selection}", "verification": "{user_selection}" },
-      "budget": { "planning": "{user_selection}", "execution": "{user_selection}", "verification": "{user_selection}" }
-    },
-    "custom_overrides": { "quality": {}, "balanced": {}, "budget": {} }
-  },
-  "workflow": { "research": true, "plan_check": true, "verifier": true }
-}
-```
-
-Print:
-
-```text
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- GSD ► PRESETS CONFIGURED
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Your model presets have been saved. Use "Reset presets" 
-from the settings menu if available models change.
-
-Note: Quit and relaunch OpenCode to apply model changes.
-```
-
-## Step 2: Compute Effective Models
-
-```text
-activeProfile = config.profiles.active_profile
-preset = config.profiles.presets[activeProfile]
-overrides = config.profiles.custom_overrides[activeProfile] || {}
-
-effective.planning = overrides.planning || preset.planning
-effective.execution = overrides.execution || preset.execution
-effective.verification = overrides.verification || preset.verification
-```
-
-A stage is "overridden" if `overrides[stage]` exists and differs from `preset[stage]`.
-
-## Step 3: Display State
-
-**Print this as text output (do NOT use Question tool here):**
-
-```text
-Active profile: {activeProfile}
-
-| Stage        | Model                                    |
-|--------------|------------------------------------------|
-| planning     | {effective.planning}{* if overridden}   |
-| execution    | {effective.execution}{* if overridden}  |
-| verification | {effective.verification}{* if overridden}|
-
-{if any overridden: "* = overridden" else: "No overrides"}
-
-Workflow:
-| Toggle     | Value                  |
-|------------|------------------------|
-| research   | {workflow.research}    |
-| plan_check | {workflow.plan_check}  |
-| verifier   | {workflow.verifier}    |
-```
-
-## Step 4: Show Menu
-
-Use Question tool (single prompt, not multi-question):
-
-```
-header: "GSD Settings"
-question: "Choose an action"
-options:
-  - label: "Quick settings"
-    description: "Update profile and workflow toggles"
-  - label: "Set stage override"
-    description: "Set a per-stage model override for the active profile"
-  - label: "Clear stage override"
-    description: "Remove a per-stage override for the active profile"
-  - label: "Reset presets"
-    description: "Re-run model discovery and reconfigure all presets (clears overrides)"
-  - label: "Exit"
-    description: "Save and quit"
-```
-
-## Step 5: Handle Actions
-
-### Quick settings
-
-Use multi-question call with pre-selected current values:
-
-```json
-[
-  { "header": "Model", "question": "Which model profile?", "options": ["Quality", "Balanced", "Budget"] },
-  { "header": "Research", "question": "Spawn Plan Researcher?", "options": ["Yes", "No"] },
-  { "header": "Plan Check", "question": "Spawn Plan Checker?", "options": ["Yes", "No"] },
-  { "header": "Verifier", "question": "Spawn Execution Verifier?", "options": ["Yes", "No"] }
-]
-```
-
-On selection:
-
-- Map: Quality→`quality`, Balanced→`balanced`, Budget→`budget`
-- Set `profiles.active_profile`, `model_profile`, and `workflow.*` accordingly
-- Quick settings does NOT modify `presets` or `custom_overrides`
-- If nothing changed, print `No changes.` and return to menu
-- Otherwise save and print confirmation banner:
-
-```text
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- GSD ► SETTINGS UPDATED
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-| Setting            | Value                     |
-|--------------------|---------------------------|
-| Model Profile      | {quality|balanced|budget} |
-| Plan Researcher    | {On/Off}                  |
-| Plan Checker       | {On/Off}                  |
-| Execution Verifier | {On/Off}                  |
-
-Note: Quit and relaunch OpenCode to apply model changes.
-
-Quick commands:
-- /gsd-set-profile <profile>
-- /gsd-plan-phase --research | --skip-research | --skip-verify
-```
-
-### Set stage override
-
-1. Pick stage: Planning / Execution / Verification / Cancel
-2. If Cancel, return to menu
-3. Fetch models via `opencode models` command
-4. If command fails: print error and stop
-5. Pick model from list (include Cancel option)
-6. Set `custom_overrides[activeProfile][stage]` = model
-7. Save, print "Saved", return to menu
-
-### Clear stage override
-
-If no overrides exist for current profile, print `No overrides set for {activeProfile} profile.` and return to menu immediately.
-
-Otherwise:
-
-1. Print current overrides:
-
-```text
-Current overrides for {activeProfile} profile:
-- planning: {model} (or omit if not overridden)
-- execution: {model} (or omit if not overridden)
-- verification: {model} (or omit if not overridden)
-```
-
-2. Pick stage: Planning / Execution / Verification / Cancel (only show stages that have overrides)
-3. If Cancel, return to menu
-4. Delete `custom_overrides[activeProfile][stage]`
-5. Save, print "Cleared {stage} override.", return to menu
-
-### Reset presets
-
-Run the **Preset Setup Wizard** (see Step 1). This re-queries available models and lets the user reconfigure all three profiles from scratch. Existing `custom_overrides` are cleared. After completion, return to menu.
-
-### Exit
-
-Print "Settings saved." and stop.
-
-## Save Changes
-
-After any change, use the **write tool directly** to update both files. Do NOT use bash, python, or other scripts—use native file writing.
-
-1. Read existing `opencode.json` (if it exists) to preserve non-agent keys
-2. Write `.planning/config.json` with updated config
-3. Write `opencode.json` with merged agent mappings:
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "agent": {
-    "gsd-planner": { "model": "{effective.planning}" },
-    "gsd-plan-checker": { "model": "{effective.planning}" },
-    "gsd-phase-researcher": { "model": "{effective.planning}" },
-    "gsd-roadmapper": { "model": "{effective.planning}" },
-    "gsd-project-researcher": { "model": "{effective.planning}" },
-    "gsd-research-synthesizer": { "model": "{effective.planning}" },
-    "gsd-codebase-mapper": { "model": "{effective.planning}" },
-    "gsd-executor": { "model": "{effective.execution}" },
-    "gsd-debugger": { "model": "{effective.execution}" },
-    "gsd-verifier": { "model": "{effective.verification}" },
-    "gsd-integration-checker": { "model": "{effective.verification}" },
-    "gsd-set-profile": { "model": "{effective.verification}" },
-    "gsd-settings": { "model": "{effective.verification}" },
-    "gsd-set-model": { "model": "{effective.verification}" }
-  }
-}
-```
-
-Preserve existing non-agent keys in `opencode.json`.
-
-</behavior>
-
-<notes>
-
-- Menu loop until Exit — always return to Step 3 after actions
-- Overrides are profile-scoped: `custom_overrides.{profile}.{stage}`
-- Source of truth: `config.json`; `opencode.json` is derived
-- OpenCode does not hot-reload model assignments; user must quit and relaunch to apply changes
-
-</notes>