get-research-done 1.1.0

package/hooks/dist/grd-statusline.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+// Claude Code Statusline - GRD Edition
+// Shows: model | current task | directory | context usage
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Read JSON from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    const model = data.model?.display_name || 'Claude';
+    const dir = data.workspace?.current_dir || process.cwd();
+    const session = data.session_id || '';
+    const remaining = data.context_window?.remaining_percentage;
+
+    // Context window display (shows USED percentage)
+    let ctx = '';
+    if (remaining != null) {
+      const rem = Math.round(remaining);
+      const used = Math.max(0, Math.min(100, 100 - rem));
+
+      // Build progress bar (10 segments)
+      const filled = Math.floor(used / 10);
+      const bar = '█'.repeat(filled) + '░'.repeat(10 - filled);
+
+      // Color based on usage
+      if (used < 50) {
+        ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
+      } else if (used < 65) {
+        ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
+      } else if (used < 80) {
+        ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
+      } else {
+        ctx = ` \x1b[5;31m💀 ${bar} ${used}%\x1b[0m`;
+      }
+    }
+
+    // Current task from todos
+    let task = '';
+    const homeDir = os.homedir();
+    const todosDir = path.join(homeDir, '.claude', 'todos');
+    if (session && fs.existsSync(todosDir)) {
+      const files = fs.readdirSync(todosDir)
+        .filter(f => f.startsWith(session) && f.includes('-agent-') && f.endsWith('.json'))
+        .map(f => ({ name: f, mtime: fs.statSync(path.join(todosDir, f)).mtime }))
+        .sort((a, b) => b.mtime - a.mtime);
+
+      if (files.length > 0) {
+        try {
+          const todos = JSON.parse(fs.readFileSync(path.join(todosDir, files[0].name), 'utf8'));
+          const inProgress = todos.find(t => t.status === 'in_progress');
+          if (inProgress) task = inProgress.activeForm || '';
+        } catch (e) {}
+      }
+    }
+
+    // GRD update available?
+    let grdUpdate = '';
+    const cacheFile = path.join(homeDir, '.claude', 'cache', 'grd-update-check.json');
+    if (fs.existsSync(cacheFile)) {
+      try {
+        const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+        if (cache.update_available) {
+          grdUpdate = '\x1b[33m⬆ /grd:update\x1b[0m │ ';
+        }
+      } catch (e) {}
+    }
+
+    // Output
+    const dirname = path.basename(dir);
+    if (task) {
+      process.stdout.write(`${grdUpdate}\x1b[2m${model}\x1b[0m │ \x1b[1m${task}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
+    } else {
+      process.stdout.write(`${grdUpdate}\x1b[2m${model}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
+    }
+  } catch (e) {
+    // Silent fail - don't break statusline on parse errors
+  }
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "get-research-done",
+  "version": "1.1.0",
+  "description": "A recursive, agentic framework for ML research with hypothesis-driven experimentation for Claude Code by Ulmentflam.",
+  "bin": {
+    "get-research-done": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "commands",
+    "get-research-done",
+    "agents",
+    "hooks/dist",
+    "scripts"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "research",
+    "ml",
+    "machine-learning",
+    "meta-prompting",
+    "context-engineering",
+    "hypothesis-driven"
+  ],
+  "author": "Ulmentflam",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ulmentflam/get-research-done.git"
+  },
+  "homepage": "https://github.com/ulmentflam/get-research-done",
+  "bugs": {
+    "url": "https://github.com/ulmentflam/get-research-done/issues"
+  },
+  "engines": {
+    "node": ">=16.7.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.27.2"
+  },
+  "scripts": {
+    "build:hooks": "node scripts/build-hooks.js",
+    "prepublishOnly": "npm run build:hooks"
+  }
+}

package/scripts/audit-help-commands.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+# Audit help.md documentation coverage
+# Usage: ./scripts/audit-help-commands.sh
+
+COMMANDS_DIR=".claude/commands/grd"
+HELP_FILE="$COMMANDS_DIR/help.md"
+
+echo "=== GRD Command Coverage Audit ==="
+echo ""
+
+# Check help.md exists
+if [ ! -f "$HELP_FILE" ]; then
+    echo "ERROR: $HELP_FILE not found"
+    exit 1
+fi
+
+# Count actual command files (excluding help itself)
+ACTUAL_COUNT=$(ls "$COMMANDS_DIR"/*.md 2>/dev/null | grep -v help.md | wc -l | tr -d ' ')
+echo "Command files found: $ACTUAL_COUNT"
+
+# Count documented commands in help.md (looking for /grd: pattern)
+DOCUMENTED_COUNT=$(grep -oE '/grd:[a-z-]+' "$HELP_FILE" | sort -u | wc -l | tr -d ' ')
+echo "Unique commands in help.md: $DOCUMENTED_COUNT"
+echo ""
+
+# V1.1 commands that MUST be documented
+echo "=== V1.1 Command Verification ==="
+
+V11_COMMANDS=(
+    "quick-explore"
+    "insights"
+    "new-study"
+    "complete-study"
+    "scope-study"
+    "plan-study"
+    "run-study"
+    "validate-study"
+    "audit-study"
+    "plan-study-gaps"
+)
+
+V11_PASS=0
+V11_FAIL=0
+
+for cmd in "${V11_COMMANDS[@]}"; do
+    if grep -q "/grd:$cmd" "$HELP_FILE"; then
+        echo "  [PASS] /grd:$cmd documented"
+        ((V11_PASS++))
+    else
+        echo "  [FAIL] /grd:$cmd NOT in help.md"
+        ((V11_FAIL++))
+    fi
+done
+
+echo ""
+echo "V1.1 commands: $V11_PASS passed, $V11_FAIL failed"
+echo ""
+
+# Deprecated commands that should NOT appear
+echo "=== Deprecated Commands (should NOT appear) ==="
+
+DEPRECATED=(
+    "new-milestone"
+    "complete-milestone"
+    "discuss-phase"
+    "execute-phase"
+    "verify-work"
+    "audit-milestone"
+    "plan-milestone-gaps"
+)
+
+DEP_PASS=0
+DEP_FAIL=0
+
+for cmd in "${DEPRECATED[@]}"; do
+    if grep -q "/grd:$cmd" "$HELP_FILE"; then
+        echo "  [FAIL] /grd:$cmd still in help.md (should be removed)"
+        ((DEP_FAIL++))
+    else
+        echo "  [PASS] /grd:$cmd not in help.md"
+        ((DEP_PASS++))
+    fi
+done
+
+echo ""
+echo "Deprecated check: $DEP_PASS passed, $DEP_FAIL failed"
+echo ""
+
+# Command file coverage (optional - commands with files but not documented)
+echo "=== Command File Coverage ==="
+
+UNDOCUMENTED=0
+for file in "$COMMANDS_DIR"/*.md; do
+    [ "$file" = "$COMMANDS_DIR/help.md" ] && continue
+    cmd=$(basename "$file" .md)
+    if ! grep -q "/grd:$cmd" "$HELP_FILE"; then
+        echo "  [WARN] $cmd has file but not documented in help.md"
+        ((UNDOCUMENTED++))
+    fi
+done
+
+if [ $UNDOCUMENTED -eq 0 ]; then
+    echo "  All command files are documented"
+fi
+
+echo ""
+echo "=== Summary ==="
+TOTAL_FAIL=$((V11_FAIL + DEP_FAIL))
+if [ $TOTAL_FAIL -eq 0 ]; then
+    echo "AUDIT PASSED: All v1.1 commands documented, no deprecated commands found"
+    exit 0
+else
+    echo "AUDIT FAILED: $TOTAL_FAIL issues found"
+    exit 1
+fi

package/scripts/build-hooks.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * Copy GRD hooks to dist for installation.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const HOOKS_DIR = path.join(__dirname, '..', 'hooks');
+const DIST_DIR = path.join(HOOKS_DIR, 'dist');
+
+// Hooks to copy (pure Node.js, no bundling needed)
+const HOOKS_TO_COPY = [
+  'grd-check-update.js',
+  'grd-statusline.js'
+];
+
+function build() {
+  // Ensure dist directory exists
+  if (!fs.existsSync(DIST_DIR)) {
+    fs.mkdirSync(DIST_DIR, { recursive: true });
+  }
+
+  // Copy hooks to dist
+  for (const hook of HOOKS_TO_COPY) {
+    const src = path.join(HOOKS_DIR, hook);
+    const dest = path.join(DIST_DIR, hook);
+
+    if (!fs.existsSync(src)) {
+      console.warn(`Warning: ${hook} not found, skipping`);
+      continue;
+    }
+
+    console.log(`Copying ${hook}...`);
+    fs.copyFileSync(src, dest);
+    console.log(`  → ${dest}`);
+  }
+
+  console.log('\nBuild complete.');
+}
+
+build();

package/scripts/verify-all-commands.sh

@@ -0,0 +1,246 @@
+#!/bin/bash
+# Comprehensive GRD command verification
+# Checks: help.md coverage, file structure, agent/workflow references
+# Usage: ./scripts/verify-all-commands.sh
+
+COMMANDS_DIR=".claude/commands/grd"
+AGENTS_DIR=".claude/agents"
+WORKFLOWS_DIR=".claude/get-research-done/workflows"
+HELP_FILE="$COMMANDS_DIR/help.md"
+
+# Built-in Claude Code agent types (not custom agent files)
+BUILTIN_AGENTS="general-purpose|Explore|Plan|Bash"
+
+echo "═══════════════════════════════════════════════════════════════"
+echo "  GRD Command Verification Suite"
+echo "═══════════════════════════════════════════════════════════════"
+echo ""
+
+TOTAL_PASS=0
+TOTAL_FAIL=0
+TOTAL_WARN=0
+
+# ─────────────────────────────────────────────────────────────────
+# SECTION 1: Help.md Documentation Coverage
+# ─────────────────────────────────────────────────────────────────
+echo "┌─────────────────────────────────────────────────────────────┐"
+echo "│  Section 1: Help.md Documentation Coverage                  │"
+echo "└─────────────────────────────────────────────────────────────┘"
+echo ""
+
+if [ ! -f "$HELP_FILE" ]; then
+    echo "ERROR: $HELP_FILE not found"
+    exit 1
+fi
+
+HELP_PASS=0
+HELP_FAIL=0
+
+for file in "$COMMANDS_DIR"/*.md; do
+    [ "$file" = "$COMMANDS_DIR/help.md" ] && continue
+    cmd=$(basename "$file" .md)
+
+    if grep -q "/grd:$cmd" "$HELP_FILE"; then
+        echo "  [PASS] /grd:$cmd documented"
+        ((HELP_PASS++))
+    else
+        echo "  [FAIL] /grd:$cmd NOT documented in help.md"
+        ((HELP_FAIL++))
+    fi
+done
+
+echo ""
+echo "  Summary: $HELP_PASS documented, $HELP_FAIL missing"
+TOTAL_PASS=$((TOTAL_PASS + HELP_PASS))
+TOTAL_FAIL=$((TOTAL_FAIL + HELP_FAIL))
+
+# ─────────────────────────────────────────────────────────────────
+# SECTION 2: Command File Structure Validation
+# ─────────────────────────────────────────────────────────────────
+echo ""
+echo "┌─────────────────────────────────────────────────────────────┐"
+echo "│  Section 2: Command File Structure Validation               │"
+echo "└─────────────────────────────────────────────────────────────┘"
+echo ""
+
+STRUCT_PASS=0
+STRUCT_FAIL=0
+STRUCT_WARN=0
+
+for file in "$COMMANDS_DIR"/*.md; do
+    [ "$file" = "$COMMANDS_DIR/help.md" ] && continue
+    cmd=$(basename "$file" .md)
+    issues=""
+    warnings=""
+
+    # Check file is not empty
+    if [ ! -s "$file" ]; then
+        issues="$issues empty-file"
+    fi
+
+    # Check for description (should have some content describing the command)
+    line_count=$(wc -l < "$file" | tr -d ' ')
+    if [ "$line_count" -lt 5 ]; then
+        warnings="$warnings short-file($line_count lines)"
+    fi
+
+    # Check for XML-style tags (common structure elements)
+    has_objective=$(grep -c '<objective>\|<purpose>' "$file" 2>/dev/null || echo "0")
+    has_context=$(grep -c '<context>\|<execution_context>' "$file" 2>/dev/null || echo "0")
+    has_process=$(grep -c '<process>\|<tasks>\|<steps>' "$file" 2>/dev/null || echo "0")
+
+    # Commands should have at least objective/purpose
+    if [ "$has_objective" -eq 0 ] && [ "$has_context" -eq 0 ]; then
+        # Check for alternative structures (some commands use different formats)
+        has_any_structure=$(grep -cE '^##|^<[a-z_]+>' "$file" 2>/dev/null || echo "0")
+        if [ "$has_any_structure" -lt 2 ]; then
+            warnings="$warnings minimal-structure"
+        fi
+    fi
+
+    # Report results
+    if [ -n "$issues" ]; then
+        echo "  [FAIL] $cmd:$issues"
+        ((STRUCT_FAIL++))
+    elif [ -n "$warnings" ]; then
+        echo "  [WARN] $cmd:$warnings"
+        ((STRUCT_WARN++))
+    else
+        echo "  [PASS] $cmd: valid structure"
+        ((STRUCT_PASS++))
+    fi
+done
+
+echo ""
+echo "  Summary: $STRUCT_PASS valid, $STRUCT_WARN warnings, $STRUCT_FAIL invalid"
+TOTAL_PASS=$((TOTAL_PASS + STRUCT_PASS))
+TOTAL_FAIL=$((TOTAL_FAIL + STRUCT_FAIL))
+TOTAL_WARN=$((TOTAL_WARN + STRUCT_WARN))
+
+# ─────────────────────────────────────────────────────────────────
+# SECTION 3: Agent Reference Validation
+# ─────────────────────────────────────────────────────────────────
+echo ""
+echo "┌─────────────────────────────────────────────────────────────┐"
+echo "│  Section 3: Agent Reference Validation                      │"
+echo "└─────────────────────────────────────────────────────────────┘"
+echo ""
+
+AGENT_PASS=0
+AGENT_FAIL=0
+AGENT_WARN=0
+
+for file in "$COMMANDS_DIR"/*.md; do
+    [ "$file" = "$COMMANDS_DIR/help.md" ] && continue
+    cmd=$(basename "$file" .md)
+
+    # Extract agent references from subagent_type="..." patterns only
+    # More precise regex to avoid matching prose text
+    agent_refs=$(grep -oE 'subagent_type\s*[=:]\s*"[a-zA-Z-]+"' "$file" 2>/dev/null | \
+                 sed 's/subagent_type[[:space:]]*[=:][[:space:]]*"//' | \
+                 sed 's/"$//' | \
+                 sort -u)
+
+    if [ -z "$agent_refs" ]; then
+        # No agent references - might be a simple command
+        echo "  [INFO] $cmd: no agent references (may be orchestrator-only)"
+        continue
+    fi
+
+    for agent in $agent_refs; do
+        # Check if it's a built-in agent type
+        if echo "$agent" | grep -qE "^($BUILTIN_AGENTS)$"; then
+            echo "  [PASS] $cmd → $agent (built-in agent type)"
+            ((AGENT_PASS++))
+            continue
+        fi
+
+        # Check if agent file exists
+        if [ -f "$AGENTS_DIR/$agent.md" ]; then
+            echo "  [PASS] $cmd → $agent (exists)"
+            ((AGENT_PASS++))
+        else
+            echo "  [FAIL] $cmd → $agent (NOT FOUND in $AGENTS_DIR/)"
+            ((AGENT_FAIL++))
+        fi
+    done
+done
+
+echo ""
+echo "  Summary: $AGENT_PASS valid refs, $AGENT_FAIL invalid refs"
+TOTAL_PASS=$((TOTAL_PASS + AGENT_PASS))
+TOTAL_FAIL=$((TOTAL_FAIL + AGENT_FAIL))
+
+# ─────────────────────────────────────────────────────────────────
+# SECTION 4: Workflow Reference Validation
+# ─────────────────────────────────────────────────────────────────
+echo ""
+echo "┌─────────────────────────────────────────────────────────────┐"
+echo "│  Section 4: Workflow Reference Validation                   │"
+echo "└─────────────────────────────────────────────────────────────┘"
+echo ""
+
+WORKFLOW_PASS=0
+WORKFLOW_FAIL=0
+
+for file in "$COMMANDS_DIR"/*.md; do
+    [ "$file" = "$COMMANDS_DIR/help.md" ] && continue
+    cmd=$(basename "$file" .md)
+
+    # Extract workflow references (@...workflows/... or workflows/...)
+    workflow_refs=$(grep -oE 'workflows/[a-z-]+\.md|workflows/[a-z-]+' "$file" 2>/dev/null | \
+                    sed 's/workflows\///' | \
+                    sed 's/\.md$//' | \
+                    sort -u)
+
+    if [ -z "$workflow_refs" ]; then
+        continue
+    fi
+
+    for workflow in $workflow_refs; do
+        # Check multiple possible locations
+        found=0
+        for dir in ".claude/get-research-done/workflows" ".claude/get-shit-done/workflows" ".claude/workflows"; do
+            if [ -f "$dir/$workflow.md" ]; then
+                echo "  [PASS] $cmd → $workflow (exists in $dir)"
+                ((WORKFLOW_PASS++))
+                found=1
+                break
+            fi
+        done
+
+        if [ $found -eq 0 ]; then
+            echo "  [FAIL] $cmd → $workflow (NOT FOUND)"
+            ((WORKFLOW_FAIL++))
+        fi
+    done
+done
+
+echo ""
+echo "  Summary: $WORKFLOW_PASS valid refs, $WORKFLOW_FAIL invalid refs"
+TOTAL_PASS=$((TOTAL_PASS + WORKFLOW_PASS))
+TOTAL_FAIL=$((TOTAL_FAIL + WORKFLOW_FAIL))
+
+# ─────────────────────────────────────────────────────────────────
+# FINAL SUMMARY
+# ─────────────────────────────────────────────────────────────────
+echo ""
+echo "═══════════════════════════════════════════════════════════════"
+echo "  FINAL SUMMARY"
+echo "═══════════════════════════════════════════════════════════════"
+echo ""
+echo "  Total Checks:"
+echo "    PASS: $TOTAL_PASS"
+echo "    WARN: $TOTAL_WARN"
+echo "    FAIL: $TOTAL_FAIL"
+echo ""
+
+if [ $TOTAL_FAIL -eq 0 ]; then
+    echo "  ✓ VERIFICATION PASSED"
+    echo ""
+    exit 0
+else
+    echo "  ✗ VERIFICATION FAILED ($TOTAL_FAIL issues)"
+    echo ""
+    exit 1
+fi

package/scripts/verify-architect-warning.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Document architect warning verification (manual observation required)
+# Usage: ./scripts/verify-architect-warning.sh
+
+echo "=== Architect Warning Verification ==="
+echo ""
+echo "This test requires manual observation of architect output."
+echo ""
+echo "Test Procedure:"
+echo "1. Ensure only quick-explore was run (DATA_REPORT.md has Quick header)"
+echo "2. Run: /grd:architect"
+echo "3. Observe output for warning about data depth"
+echo ""
+echo "Expected Warning Patterns (look for any of these):"
+echo "  - 'Quick Explore' data may be insufficient"
+echo "  - quick-explore only provides basic"
+echo "  - run full /grd:explore for"
+echo "  - data reconnaissance not completed"
+echo "  - WARNING: No DATA_REPORT.md"
+echo ""
+echo "Verification:"
+echo "  If warning appears: TEST PASSED"
+echo "  If no warning and architect proceeds: TEST FAILED"
+echo ""
+
+# Check current DATA_REPORT.md status as helper
+if [ -f ".planning/DATA_REPORT.md" ]; then
+    if head -30 ".planning/DATA_REPORT.md" | grep -qi "Quick Explore"; then
+        echo "Current state: DATA_REPORT.md has Quick Explore header (correct setup)"
+    else
+        echo "Current state: DATA_REPORT.md is NOT Quick mode (wrong setup for this test)"
+    fi
+else
+    echo "Current state: No DATA_REPORT.md (architect will warn about missing file)"
+fi

package/scripts/verify-insights-mode.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# Verify Insights mode produced both output files
+# Usage: ./scripts/verify-insights-mode.sh [planning-dir]
+
+PLANNING_DIR="${1:-.planning}"
+
+PASS=0
+FAIL=0
+
+# Check DATA_REPORT.md exists
+if [ -f "$PLANNING_DIR/DATA_REPORT.md" ]; then
+    echo "PASS: DATA_REPORT.md exists"
+    ((PASS++))
+else
+    echo "FAIL: DATA_REPORT.md not found"
+    ((FAIL++))
+fi
+
+# Check INSIGHTS_SUMMARY.md exists
+if [ -f "$PLANNING_DIR/INSIGHTS_SUMMARY.md" ]; then
+    echo "PASS: INSIGHTS_SUMMARY.md exists"
+    ((PASS++))
+else
+    echo "FAIL: INSIGHTS_SUMMARY.md not found"
+    ((FAIL++))
+fi
+
+# Check INSIGHTS_SUMMARY.md has expected sections
+if [ -f "$PLANNING_DIR/INSIGHTS_SUMMARY.md" ]; then
+    if grep -qi "TL;DR\|5 Things to Know\|What This Means" "$PLANNING_DIR/INSIGHTS_SUMMARY.md"; then
+        echo "PASS: INSIGHTS_SUMMARY.md has expected sections"
+        ((PASS++))
+    else
+        echo "WARN: INSIGHTS_SUMMARY.md may be missing expected sections"
+    fi
+fi
+
+echo ""
+echo "Summary: $PASS passed, $FAIL failed"
+[ $FAIL -eq 0 ] && exit 0 || exit 1

package/scripts/verify-quick-mode.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Verify DATA_REPORT.md contains Quick Explore Mode header
+# Usage: ./scripts/verify-quick-mode.sh [path-to-data-report]
+
+DATA_REPORT="${1:-.planning/DATA_REPORT.md}"
+
+if [ ! -f "$DATA_REPORT" ]; then
+    echo "ERROR: $DATA_REPORT not found"
+    exit 1
+fi
+
+# Check for Quick Explore header in first 30 lines
+if head -30 "$DATA_REPORT" | grep -qi "Quick Explore"; then
+    echo "PASS: Quick Explore header found"
+    exit 0
+else
+    echo "FAIL: Quick Explore header not found in first 30 lines"
+    echo "Hint: This file may be from full explore mode"
+    exit 1
+fi