gsd-opencode 1.10.2 → 1.20.0

package/{lib → bin/dm/lib}/constants.js

@@ -52,7 +52,13 @@ export const PATH_PATTERNS = {
    * These are absolute references to the global config that need to be
    * replaced for local installs.
    */
-  absoluteReference: /@~\/\.config\/opencode\//g
+  absoluteReference: /@~\/\.config\/opencode\//g,
+  /**
+   * Pattern to match bare ~/.config/opencode/ references (without @ prefix).
+   * These appear in workflow files that call gsd-tools.cjs directly.
+   * Must be replaced for both global and local installs to ensure correct paths.
+   */
+  tildeConfigReference: /~\/\.config\/opencode\//g
 };
 
 /**
@@ -65,7 +71,7 @@ export const PATH_PATTERNS = {
  * 
  * @type {string[]}
  */
-export const DIRECTORIES_TO_COPY = ['agents', 'commands', 'get-shit-done'];
+export const DIRECTORIES_TO_COPY = ['agents', 'commands', 'get-shit-done', 'rules', 'skills'];
 
 /**
  * Command directory mapping for source-to-destination path transformation.
@@ -149,6 +155,7 @@ export const ALLOWED_NAMESPACES = [
   /^agents\/gsd-/,      // agents/gsd-* directories
   /^command\/gsd\//,    // command/gsd/* files (legacy structure)
   /^commands\/gsd\//,   // commands/gsd/* files (new structure)
+  /^rules\/gsd-/,       // rules/gsd-* directories
   /^skills\/gsd-/,      // skills/gsd-* directories
   /^get-shit-done\//    // get-shit-done/ directory - fully owned
 ];
@@ -180,7 +187,7 @@ export const ERROR_CODES = {
  * Useful for importing all constants at once.
  * 
  * @example
- * import constants from './lib/constants.js';
+ * import constants from './dm/lib/constants.js';
  * console.log(constants.DEFAULT_CONFIG_DIR);
  */
 export default {

package/{src → bin/dm/src}/commands/install.js

@@ -85,7 +85,7 @@ ${cyan}   ██████╗ ███████╗██████╗
  */
 async function getPackageVersion(sourceDir) {
   try {
-    // Read from the source directory's package.json
+    // read from the source directory's package.json
     const packageJsonPath = path.join(sourceDir, "package.json");
 
     const content = await fs.readFile(packageJsonPath, "utf-8");
@@ -106,10 +106,10 @@ async function getPackageVersion(sourceDir) {
 function getSourceDirectory() {
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = path.dirname(__filename);
-  const packageRoot = path.resolve(__dirname, "../..");
+  const packageRoot = path.resolve(__dirname, "../../../..");
 
-  // Source is the package root directory
-  // This contains the distribution files (agents, command, get-shit-done)
+  // Source is the package root directory (4 levels up from commands/ to gsd-opencode/)
+  // This contains the distribution files (agents, commands, get-shit-done, rules, skills)
   return packageRoot;
 }
 
@@ -315,6 +315,7 @@ async function cleanupEmptyDirectories(targetDir, namespaces, logger) {
     "agents/gsd-roadmapper",
     "agents/gsd-set-model",
     "agents/gsd-verifier",
+    "skills/gsd-oc-select-model",
   ];
 
   for (const dir of dirsToCheck) {

package/{src → bin/dm/src}/commands/uninstall.js

@@ -284,6 +284,7 @@ async function buildFallbackManifest(targetDir) {
     "agents",
     "command/gsd", // Old structure (singular)
     "commands/gsd", // New structure (plural)
+    "rules",
     "skills",
     "get-shit-done",
   ];
@@ -392,12 +393,13 @@ async function categorizeItems(files, targetDir) {
   }
 
   // Ensure top-level directories in allowed namespaces are tracked for cleanup
-  // This includes get-shit-done, agents, command, commands, skills
+  // This includes get-shit-done, agents, command, commands, rules, skills
   // Include both old (command) and new (commands) structures
   const topLevelDirs = [
     "agents",
     "command",
     "commands",
+    "rules",
     "skills",
     "get-shit-done",
   ];

package/{src → bin/dm/src}/services/backup-manager.js

@@ -211,7 +211,7 @@ export class BackupManager {
         throw error;
       }
 
-      // Read backup directory contents
+      // read backup directory contents
       const entries = await fs.readdir(this._backupDir, { withFileTypes: true });
 
       // Filter for files (not directories) with date prefix

package/{src → bin/dm/src}/services/config.js

@@ -186,7 +186,7 @@ export class ConfigManager {
       // Ensure target directory exists
       await fs.mkdir(targetDir, { recursive: true });
 
-      // Write version file
+      // write version file
       await fs.writeFile(versionPath, version.trim(), 'utf-8');
     } catch (error) {
       if (error.code === 'EACCES') {

package/{src → bin/dm/src}/services/file-ops.js

@@ -471,7 +471,7 @@ export class FileOperations {
     const isMarkdown = sourcePath.endsWith('.md');
 
     if (isMarkdown) {
-      // Read, replace, and write markdown content
+      // read, replace, and write markdown content
       let content = await fs.readFile(sourcePath, 'utf-8');
 
       // Optimization: Skip files that don't contain any patterns needing replacement
@@ -481,8 +481,12 @@ export class FileOperations {
       if (PATH_PATTERNS.absoluteReference) {
         PATH_PATTERNS.absoluteReference.lastIndex = 0; // Reset regex
       }
+      const hasTildeRef = PATH_PATTERNS.tildeConfigReference && PATH_PATTERNS.tildeConfigReference.test(content);
+      if (PATH_PATTERNS.tildeConfigReference) {
+        PATH_PATTERNS.tildeConfigReference.lastIndex = 0; // Reset regex
+      }
 
-      if (!hasGsdRef && !hasAbsRef) {
+      if (!hasGsdRef && !hasAbsRef && !hasTildeRef) {
         await fs.copyFile(sourcePath, targetPath, fsConstants.COPYFILE_FICLONE);
         return;
       }
@@ -497,8 +501,18 @@ export class FileOperations {
         () => targetDir + '/'
       );
 
+      // Replace bare ~/.config/opencode/ references with actual path
+      // This handles workflow files that call: node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs
+      // This applies to BOTH global and local installs to ensure correct paths
+      if (PATH_PATTERNS.tildeConfigReference) {
+        content = content.replace(
+          PATH_PATTERNS.tildeConfigReference,
+          () => targetDir + '/'
+        );
+      }
+
       // For local installs, also replace @~/.config/opencode/ with local path
-      // This handles files that have hardcoded global references
+      // This handles files that have hardcoded global references with @ prefix
       if (this.scopeManager.scope === 'local' && PATH_PATTERNS.absoluteReference) {
         content = content.replace(
           PATH_PATTERNS.absoluteReference,
@@ -588,9 +602,11 @@ export class FileOperations {
         // Cross-device move needed
         this.logger.debug('Cross-device move detected, using copy+delete');
         await this._crossDeviceMove(tempDir, targetDir);
-      } else if (error.code === 'ENOTEMPTY' || error.code === 'EEXIST') {
+      } else if (error.code === 'ENOTEMPTY' || error.code === 'EEXIST' || error.code === 'EPERM') {
         // Target exists with other files - MERGE instead of replace
         // This preserves existing opencode configuration
+        // NOTE: On Windows, fs.rename throws EPERM instead of ENOTEMPTY/EEXIST
+        // when target directory exists. Fixed: 2026-02-26
         this.logger.debug('Target exists with existing files, merging contents');
         await this._mergeDirectories(tempDir, targetDir);
         // Clean up temp directory after merge

package/{src → bin/dm/src}/services/health-checker.js

@@ -268,7 +268,9 @@ export class HealthChecker {
     const sampleFiles = [
       { dir: 'agents', file: 'gsd-executor.md' },
       { dir: 'command', file: 'gsd/help.md' },
-      { dir: 'get-shit-done', file: 'templates/summary.md' }
+      { dir: 'get-shit-done', file: 'templates/summary.md' },
+      { dir: 'rules', file: 'gsd-oc-work-hard.md' },
+      { dir: 'skills', file: 'gsd-oc-select-model/SKILL.md' }
     ];
 
     for (const { dir, file } of sampleFiles) {

package/{src → bin/dm/src}/services/repair-service.js

@@ -418,7 +418,9 @@ export class RepairService {
     const sampleFiles = [
       { dir: 'agents', file: 'gsd-executor.md' },
       { dir: 'command', file: 'gsd/help.md' },
-      { dir: 'get-shit-done', file: 'templates/summary.md' }
+      { dir: 'get-shit-done', file: 'templates/summary.md' },
+      { dir: 'rules', file: 'gsd-oc-work-hard.md' },
+      { dir: 'skills', file: 'gsd-oc-select-model/SKILL.md' }
     ];
 
     const expectedPrefix = targetDir + '/';

package/{src → bin/dm/src}/services/settings.js

@@ -355,7 +355,7 @@ export class SettingsManager {
    * Saves configuration to disk atomically.
    *
    * Private method that writes configuration using the atomic write pattern:
-   * 1. Write to a temporary file
+   * 1. write to a temporary file
    * 2. Rename temp file to final location
    *
    * This ensures that the configuration file is never in a partially written

package/{src → bin/dm/src}/services/update-service.js

@@ -404,7 +404,7 @@ export class UpdateService {
    * Validates that the update can proceed by checking:
    * - Installation exists (if required)
    * - Target version exists
-   * - Write permissions are available
+   * - write permissions are available
    *
    * @param {string|null} targetVersion - Specific version to validate (null for latest)
    * @returns {Promise<Object>} Validation result
@@ -442,7 +442,7 @@ export class UpdateService {
       } else if (error.code === 'ENOENT') {
         // Directory doesn't exist, which is fine for new installs
       } else {
-        errors.push(`Write permission check failed: ${error.message}`);
+        errors.push(`write permission check failed: ${error.message}`);
       }
     }
 

package/bin/gsd.js

@@ -20,15 +20,15 @@
 
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { installCommand } from '../src/commands/install.js';
-import { listCommand } from '../src/commands/list.js';
-import { uninstallCommand } from '../src/commands/uninstall.js';
-import { configGetCommand, configSetCommand, configResetCommand, configListCommand } from '../src/commands/config.js';
-import { checkCommand } from '../src/commands/check.js';
-import { repairCommand } from '../src/commands/repair.js';
-import { updateCommand } from '../src/commands/update.js';
-import { logger, setVerbose } from '../src/utils/logger.js';
-import { ERROR_CODES } from '../lib/constants.js';
+import { installCommand } from './dm/src/commands/install.js';
+import { listCommand } from './dm/src/commands/list.js';
+import { uninstallCommand } from './dm/src/commands/uninstall.js';
+import { configGetCommand, configSetCommand, configResetCommand, configListCommand } from './dm/src/commands/config.js';
+import { checkCommand } from './dm/src/commands/check.js';
+import { repairCommand } from './dm/src/commands/repair.js';
+import { updateCommand } from './dm/src/commands/update.js';
+import { logger, setVerbose } from './dm/src/utils/logger.js';
+import { ERROR_CODES } from './dm/lib/constants.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import path from 'path';

package/commands/gsd/gsd-add-phase.md

@@ -0,0 +1,43 @@
+---
+name: gsd-add-phase
+description: Add phase to end of current milestone in roadmap
+argument-hint: <description>
+allowed-tools:
+  - read
+  - write
+  - bash
+---
+
+<objective>
+Add a new integer phase to the end of the current milestone in the roadmap.
+
+Routes to the add-phase workflow which handles:
+- Phase number calculation (next sequential integer)
+- Directory creation with slug generation
+- Roadmap structure updates
+- STATE.md roadmap evolution tracking
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/add-phase.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (phase description)
+
+Roadmap and state are resolved in-workflow via `init phase-op` and targeted tool calls.
+</context>
+
+<process>
+**Follow the add-phase workflow** from `@~/.config/opencode/get-shit-done/workflows/add-phase.md`.
+
+The workflow handles all logic including:
+1. Argument parsing and validation
+2. Roadmap existence checking
+3. Current milestone identification
+4. Next phase number calculation (ignoring decimals)
+5. Slug generation from description
+6. Phase directory creation
+7. Roadmap entry insertion
+8. STATE.md updates
+</process>

package/commands/gsd/gsd-add-todo.md

@@ -0,0 +1,47 @@
+---
+name: gsd-add-todo
+description: Capture idea or task as todo from current conversation context
+argument-hint: [optional description]
+allowed-tools:
+  - read
+  - write
+  - bash
+  - question
+---
+
+<objective>
+Capture an idea, task, or issue that surfaces during a GSD session as a structured todo for later work.
+
+Routes to the add-todo workflow which handles:
+- Directory structure creation
+- Content extraction from arguments or conversation
+- Area inference from file paths
+- Duplicate detection and resolution
+- Todo file creation with frontmatter
+- STATE.md updates
+- Git commits
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/add-todo.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (optional todo description)
+
+State is resolved in-workflow via `init todos` and targeted reads.
+</context>
+
+<process>
+**Follow the add-todo workflow** from `@~/.config/opencode/get-shit-done/workflows/add-todo.md`.
+
+The workflow handles all logic including:
+1. Directory ensuring
+2. Existing area checking
+3. Content extraction (arguments or conversation)
+4. Area inference
+5. Duplicate checking
+6. File creation with slug generation
+7. STATE.md updates
+8. Git commits
+</process>

package/commands/gsd/gsd-audit-milestone.md

@@ -0,0 +1,36 @@
+---
+name: gsd-audit-milestone
+description: Audit milestone completion against original intent before archiving
+argument-hint: "[version]"
+allowed-tools:
+  - read
+  - glob
+  - grep
+  - bash
+  - task
+  - write
+---
+<objective>
+Verify milestone achieved its definition of done. Check requirements coverage, cross-phase integration, and end-to-end flows.
+
+**This command IS the orchestrator.** Reads existing VERIFICATION.md files (phases already verified during execute-phase), aggregates tech debt and deferred gaps, then spawns integration checker for cross-phase wiring.
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/audit-milestone.md
+</execution_context>
+
+<context>
+Version: $ARGUMENTS (optional — defaults to current milestone)
+
+Core planning files are resolved in-workflow (`init milestone-op`) and loaded only as needed.
+
+**Completed Work:**
+glob: .planning/phases/*/*-SUMMARY.md
+glob: .planning/phases/*/*-VERIFICATION.md
+</context>
+
+<process>
+Execute the audit-milestone workflow from @~/.config/opencode/get-shit-done/workflows/audit-milestone.md end-to-end.
+Preserve all workflow gates (scope determination, verification reading, integration check, requirements coverage, routing).
+</process>

package/commands/gsd/gsd-check-todos.md

@@ -0,0 +1,45 @@
+---
+name: gsd-check-todos
+description: List pending todos and select one to work on
+argument-hint: [area filter]
+allowed-tools:
+  - read
+  - write
+  - bash
+  - question
+---
+
+<objective>
+List all pending todos, allow selection, load full context for the selected todo, and route to appropriate action.
+
+Routes to the check-todos workflow which handles:
+- Todo counting and listing with area filtering
+- Interactive selection with full context loading
+- Roadmap correlation checking
+- Action routing (work now, add to phase, brainstorm, create phase)
+- STATE.md updates and git commits
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/check-todos.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (optional area filter)
+
+Todo state and roadmap correlation are loaded in-workflow using `init todos` and targeted reads.
+</context>
+
+<process>
+**Follow the check-todos workflow** from `@~/.config/opencode/get-shit-done/workflows/check-todos.md`.
+
+The workflow handles all logic including:
+1. Todo existence checking
+2. Area filtering
+3. Interactive listing and selection
+4. Full context loading with file summaries
+5. Roadmap correlation checking
+6. Action offering and execution
+7. STATE.md updates
+8. Git commits
+</process>

package/commands/gsd/gsd-cleanup.md

@@ -0,0 +1,18 @@
+---
+name: gsd-cleanup
+description: Archive accumulated phase directories from completed milestones
+---
+<objective>
+Archive phase directories from completed milestones into `.planning/milestones/v{X.Y}-phases/`.
+
+Use when `.planning/phases/` has accumulated directories from past milestones.
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/cleanup.md
+</execution_context>
+
+<process>
+Follow the cleanup workflow at @~/.config/opencode/get-shit-done/workflows/cleanup.md.
+Identify completed milestones, show a dry-run summary, and archive on confirmation.
+</process>

package/commands/gsd/{complete-milestone.md → gsd-complete-milestone.md}

@@ -3,7 +3,7 @@ type: prompt
 name: gsd-complete-milestone
 description: Archive completed milestone and prepare for next version
 argument-hint: <version>
-tools:
+allowed-tools:
   - read
   - write
   - bash

package/commands/gsd/{debug.md → gsd-debug.md}

@@ -2,10 +2,10 @@
 name: gsd-debug
 description: Systematic debugging with persistent state across context resets
 argument-hint: [issue description]
-tools:
+allowed-tools:
   - read
   - bash
-
+  - task
   - question
 ---
 
@@ -18,7 +18,7 @@ Debug issues using scientific method with subagent isolation.
 </objective>
 
 <context>
-User's issue: `$ARGUMENTS`
+User's issue: $ARGUMENTS
 
 Check for active sessions:
 ```bash
@@ -28,31 +28,24 @@ ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
 
 <process>
 
-## 0. Resolve Model Profile
-
-read model profile for agent spawning:
+## 0. Initialize Context
 
 ```bash
-MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+INIT=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs state load)
 ```
 
-Default to "balanced" if not set.
-
-**Model lookup table:**
-
-| Agent | quality | balanced | budget |
-|-------|---------|----------|--------|
-| gsd-debugger | opus | sonnet | sonnet |
-
-Store resolved model for use in Task calls below.
+Extract `commit_docs` from init JSON. Resolve debugger model:
+```bash
+DEBUGGER_MODEL=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs resolve-model gsd-debugger --raw)
+```
 
 ## 1. Check Active Sessions
 
-If active sessions exist AND no `$ARGUMENTS`:
+If active sessions exist AND no $ARGUMENTS:
 - List sessions with status, hypothesis, next action
 - User picks number to resume OR describes new issue
 
-If `$ARGUMENTS` provided OR user describes new issue:
+If $ARGUMENTS provided OR user describes new issue:
 - Continue to symptom gathering
 
 ## 2. Gather Symptoms (if new issue)
@@ -97,7 +90,7 @@ Create: .planning/debug/{slug}.md
 ```
 
 ```
-Task(
+task(
   prompt=filled_prompt,
   subagent_type="gsd-debugger",
   model="{debugger_model}",
@@ -136,7 +129,9 @@ Continue debugging {slug}. Evidence is in the debug file.
 </objective>
 
 <prior_state>
-Debug file: @.planning/debug/{slug}.md
+<files_to_read>
+- .planning/debug/{slug}.md (Debug session state)
+</files_to_read>
 </prior_state>
 
 <checkpoint_response>
@@ -150,7 +145,7 @@ goal: find_and_fix
 ```
 
 ```
-Task(
+task(
   prompt=continuation_prompt,
   subagent_type="gsd-debugger",
   model="{debugger_model}",

package/commands/gsd/{discuss-phase.md → gsd-discuss-phase.md}

@@ -1,14 +1,15 @@
 ---
 name: gsd-discuss-phase
 description: Gather phase context through adaptive questioning before planning
-argument-hint: "<phase>"
-tools:
+argument-hint: "<phase> [--auto]"
+allowed-tools:
   - read
   - write
   - bash
   - glob
   - grep
   - question
+  - task
 ---
 
 <objective>
@@ -20,7 +21,7 @@ Extract implementation decisions that downstream agents need — researcher and
 3. Deep-dive each selected area until satisfied
 4. Create CONTEXT.md with decisions that guide research and planning
 
-**Output:** `{phase}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again
+**Output:** `{phase_num}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again
 </objective>
 
 <execution_context>
@@ -29,13 +30,9 @@ Extract implementation decisions that downstream agents need — researcher and
 </execution_context>
 
 <context>
-Phase number: `$ARGUMENTS` (required)
+Phase number: $ARGUMENTS (required)
 
-**Load project state:**
-@.planning/STATE.md
-
-**Load roadmap:**
-@.planning/ROADMAP.md
+Context files are resolved in-workflow using `init phase-op` and roadmap/state tool calls.
 </context>
 
 <process>

package/commands/gsd/gsd-execute-phase.md

@@ -0,0 +1,41 @@
+---
+name: gsd-execute-phase
+description: Execute all plans in a phase with wave-based parallelization
+argument-hint: "<phase-number> [--gaps-only]"
+allowed-tools:
+  - read
+  - write
+  - edit
+  - glob
+  - grep
+  - bash
+  - task
+  - todowrite
+  - question
+---
+<objective>
+Execute all plans in a phase using wave-based parallel execution.
+
+Orchestrator stays lean: discover plans, analyze dependencies, group into waves, spawn subagents, collect results. Each subagent loads the full execute-plan context and handles its own plan.
+
+Context budget: ~15% orchestrator, 100% fresh per subagent.
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/execute-phase.md
+@~/.config/opencode/get-shit-done/references/ui-brand.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS
+
+**Flags:**
+- `--gaps-only` — Execute only gap closure plans (plans with `gap_closure: true` in frontmatter). Use after verify-work creates fix plans.
+
+Context files are resolved inside the workflow via `gsd-tools init execute-phase` and per-subagent `<files_to_read>` blocks.
+</context>
+
+<process>
+Execute the execute-phase workflow from @~/.config/opencode/get-shit-done/workflows/execute-phase.md end-to-end.
+Preserve all workflow gates (wave execution, checkpoint handling, verification, state updates, routing).
+</process>

package/commands/gsd/gsd-health.md

@@ -0,0 +1,22 @@
+---
+name: gsd-health
+description: Diagnose planning directory health and optionally repair issues
+argument-hint: [--repair]
+allowed-tools:
+  - read
+  - bash
+  - write
+  - question
+---
+<objective>
+Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.
+</objective>
+
+<execution_context>
+@~/.config/opencode/get-shit-done/workflows/health.md
+</execution_context>
+
+<process>
+Execute the health workflow from @~/.config/opencode/get-shit-done/workflows/health.md end-to-end.
+Parse --repair flag from arguments and pass to workflow.
+</process>