@snipcodeit/mgw 0.1.2 → 0.2.0

package/commands/sync.md

@@ -464,6 +464,81 @@ Classify each issue into:
 - **Unreviewed comments:** COMMENT_DELTA > 0 — new comments posted since triage that haven't been classified
 </step>
 
+<step name="label_drift_detection">
+**Label Drift Detection:**
+
+For each active issue state file in `.mgw/active/`, compare the stored `labels` field
+against the live GitHub labels to detect MGW pipeline label drift:
+
+```python
+label_drift = []
+
+for each state_file in .mgw/active/*.json:
+  stored_labels = state['labels']  # list stored at last pipeline write
+  live_labels_json = subprocess.run(
+    ['gh', 'issue', 'view', str(issue_number), '--json', 'labels', '--jq', '[.labels[].name]'],
+    capture_output=True, text=True
+  ).stdout.strip()
+  live_labels = json.loads(live_labels_json or '[]')
+
+  # Find MGW labels in stored vs live
+  stored_mgw = [l for l in stored_labels if l.startswith('mgw:')]
+  live_mgw = [l for l in live_labels if l.startswith('mgw:')]
+
+  if set(stored_mgw) != set(live_mgw):
+    label_drift.append({
+      'issue': issue_number,
+      'stored': stored_mgw,
+      'live': live_mgw,
+      'pipeline_stage': state['pipeline_stage']
+    })
+```
+
+If label drift detected, include in the drift report output:
+
+```
+Label drift detected for ${COUNT} issue(s):
+  #N: stored=[mgw:in-progress], live=[] — pipeline_stage=${STAGE}
+```
+
+**Offer repair:**
+```
+AskUserQuestion(
+  header: "Label Drift Detected",
+  question: "Live GitHub labels don't match .mgw state for ${COUNT} issue(s). Repair?",
+  options: [
+    { label: "Repair all", description: "Re-apply correct label for each issue's pipeline_stage via remove_mgw_labels_and_apply" },
+    { label: "Skip", description: "Log drift only — no changes" }
+  ]
+)
+```
+
+If "Repair all":
+```bash
+# For each drifted issue, determine correct label from pipeline_stage and re-apply
+CORRECT_LABEL=$(python3 -c "
+stage_to_label = {
+  'triaged': 'mgw:triaged',
+  'needs-info': 'mgw:needs-info',
+  'needs-security-review': 'mgw:needs-security-review',
+  'discussing': 'mgw:discussing',
+  'approved': 'mgw:approved',
+  'planning': 'mgw:in-progress',
+  'executing': 'mgw:in-progress',
+  'verifying': 'mgw:in-progress',
+  'blocked': 'mgw:blocked',
+  'done': '',
+  'pr-created': '',
+  'failed': '',
+}
+print(stage_to_label.get('${PIPELINE_STAGE}', ''))
+")
+remove_mgw_labels_and_apply ${ISSUE_NUMBER} "${CORRECT_LABEL}"
+```
+
+Log repair actions: "Repaired label for #N: applied ${CORRECT_LABEL} (pipeline_stage=${STAGE})"
+</step>
+
 <step name="health_check">
 **GSD health check (if .planning/ exists):**
 
@@ -570,5 +645,7 @@ ${gsd_milestone_consistency ? 'GSD Milestone Links:\n' + gsd_milestone_consisten
 - [ ] Lingering worktrees cleaned up for completed items
 - [ ] Branch deletion offered for completed items
 - [ ] Stale/orphaned/drift items flagged (including comment drift and milestone inconsistencies)
+- [ ] Label drift detected between .mgw/active labels field and live GitHub labels
+- [ ] Repair offered for drifted issues via remove_mgw_labels_and_apply
 - [ ] Summary presented
 </success_criteria>

package/commands/workflows/github.md

@@ -95,12 +95,15 @@ Seven labels for pipeline stage tracking. Created by init.md, managed by issue.m
 | `mgw:blocked` | `b60205` | Pipeline blocked by stakeholder comment |
 
 ### Remove MGW Labels and Apply New
-Used when transitioning pipeline stages. Removes all `mgw:*` pipeline labels, then applies the target label.
+Used when transitioning pipeline stages. Removes all `mgw:*` pipeline labels, then applies the target label. Returns non-zero if any gh operation failed.
 ```bash
-# Remove all mgw: pipeline labels from issue, then apply new one
+# Remove all mgw: pipeline labels from issue, then apply new one.
+# Pass empty string as NEW_LABEL to remove all MGW labels without applying a new one.
+# Returns non-zero if any label operation failed.
 remove_mgw_labels_and_apply() {
   local ISSUE_NUMBER="$1"
   local NEW_LABEL="$2"
+  local LABEL_FAILED=0
 
   # Get current labels
   CURRENT_LABELS=$(gh issue view "$ISSUE_NUMBER" --json labels --jq '.labels[].name' 2>/dev/null)
@@ -109,15 +112,27 @@ remove_mgw_labels_and_apply() {
   for LABEL in $CURRENT_LABELS; do
     case "$LABEL" in
       mgw:triaged|mgw:needs-info|mgw:needs-security-review|mgw:discussing|mgw:approved|mgw:in-progress|mgw:blocked)
-        gh issue edit "$ISSUE_NUMBER" --remove-label "$LABEL" 2>/dev/null
+        gh issue edit "$ISSUE_NUMBER" --remove-label "$LABEL"
+        RC=$?
+        if [ $RC -ne 0 ]; then
+          echo "MGW WARNING: failed to remove label $LABEL from issue $ISSUE_NUMBER (exit $RC)" >&2
+          LABEL_FAILED=1
+        fi
         ;;
     esac
   done
 
   # Apply new label
   if [ -n "$NEW_LABEL" ]; then
-    gh issue edit "$ISSUE_NUMBER" --add-label "$NEW_LABEL" 2>/dev/null
+    gh issue edit "$ISSUE_NUMBER" --add-label "$NEW_LABEL"
+    RC=$?
+    if [ $RC -ne 0 ]; then
+      echo "MGW WARNING: failed to add label $NEW_LABEL to issue $ISSUE_NUMBER (exit $RC)" >&2
+      LABEL_FAILED=1
+    fi
   fi
+
+  return $LABEL_FAILED
 }
 ```
 

package/completions/mgw.bash

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# mgw bash completion script
+# Source this file or add to /etc/bash_completion.d/mgw
+# Generated by bin/generate-completions.cjs
+
+_mgw() {
+  local cur prev words cword
+  _init_completion 2>/dev/null || {
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+  }
+
+  local subcommands="run init project milestone next issue update pr sync issues link help"
+
+  local global_flags="--dry-run --json --verbose -v --debug --model"
+
+  case "$prev" in
+    mgw)
+      COMPREPLY=( $(compgen -W "$subcommands $global_flags" -- "$cur") )
+      return
+      ;;
+    run)
+      COMPREPLY=( $(compgen -W "--quiet --auto $global_flags" -- "$cur") )
+      return
+      ;;
+    init)
+      COMPREPLY=( $(compgen -W "$global_flags" -- "$cur") )
+      return
+      ;;
+    project)
+      COMPREPLY=( $(compgen -W "$global_flags" -- "$cur") )
+      return
+      ;;
+    milestone)
+      COMPREPLY=( $(compgen -W "--interactive $global_flags" -- "$cur") )
+      return
+      ;;
+    next)
+      COMPREPLY=( $(compgen -W "$global_flags" -- "$cur") )
+      return
+      ;;
+    issue)
+      COMPREPLY=( $(compgen -W "$global_flags" -- "$cur") )
+      return
+      ;;
+    update)
+      COMPREPLY=( $(compgen -W "$global_flags" -- "$cur") )
+      return
+      ;;
+    pr)
+      COMPREPLY=( $(compgen -W "--base $global_flags" -- "$cur") )
+      return
+      ;;
+    sync)
+      COMPREPLY=( $(compgen -W "$global_flags" -- "$cur") )
+      return
+      ;;
+    issues)
+      COMPREPLY=( $(compgen -W "--label --milestone --assignee --state --search -s --limit $global_flags" -- "$cur") )
+      return
+      ;;
+    link)
+      COMPREPLY=( $(compgen -W "--quiet $global_flags" -- "$cur") )
+      return
+      ;;
+    help)
+      COMPREPLY=()
+      return
+      ;;
+    --model)
+      # Offer common Claude model names
+      COMPREPLY=( $(compgen -W "claude-opus-4-5 claude-sonnet-4-5 claude-haiku-4-5" -- "$cur") )
+      return
+      ;;
+    --state)
+      COMPREPLY=( $(compgen -W "open closed all" -- "$cur") )
+      return
+      ;;
+    --assignee)
+      COMPREPLY=( $(compgen -W "all @me" -- "$cur") )
+      return
+      ;;
+  esac
+
+  # If cur starts with - complete flags for the current subcommand
+  if [[ "$cur" == -* ]]; then
+    # Find the subcommand in words
+    local subcmd=""
+    for word in "${words[@]}"; do
+      if [[ " $subcommands " == *" $word "* ]]; then
+        subcmd="$word"
+        break
+      fi
+    done
+
+    case "$subcmd" in
+      run)      COMPREPLY=( $(compgen -W "--quiet --auto $global_flags" -- "$cur") ) ;;
+      milestone) COMPREPLY=( $(compgen -W "--interactive $global_flags" -- "$cur") ) ;;
+      pr)       COMPREPLY=( $(compgen -W "--base $global_flags" -- "$cur") ) ;;
+      issues)   COMPREPLY=( $(compgen -W "--label --milestone --assignee --state --search -s --limit $global_flags" -- "$cur") ) ;;
+      link)     COMPREPLY=( $(compgen -W "--quiet $global_flags" -- "$cur") ) ;;
+      *)        COMPREPLY=( $(compgen -W "$global_flags" -- "$cur") ) ;;
+    esac
+    return
+  fi
+
+  # Default: suggest subcommands
+  COMPREPLY=( $(compgen -W "$subcommands" -- "$cur") )
+}
+
+complete -F _mgw mgw

package/completions/mgw.fish

@@ -0,0 +1,99 @@
+# mgw fish completion script
+# Place in ~/.config/fish/completions/mgw.fish
+# or run: fisher install (if using a fish plugin manager)
+# Generated by bin/generate-completions.cjs
+
+# Disable file completions by default for mgw
+complete -c mgw -f
+
+# ---------------------------------------------------------------------------
+# Global flags (available for all subcommands)
+# ---------------------------------------------------------------------------
+complete -c mgw -n '__fish_use_subcommand' -l dry-run  -d 'show what would happen without executing'
+complete -c mgw -n '__fish_use_subcommand' -l json     -d 'output structured JSON'
+complete -c mgw -n '__fish_use_subcommand' -s v -l verbose -d 'show API calls and file writes'
+complete -c mgw -n '__fish_use_subcommand' -l debug    -d 'full payloads and timings'
+complete -c mgw -n '__fish_use_subcommand' -l model    -d 'Claude model override' -r
+
+# ---------------------------------------------------------------------------
+# Subcommands
+# ---------------------------------------------------------------------------
+complete -c mgw -n '__fish_use_subcommand' -a run       -d 'Run the full pipeline for an issue'
+complete -c mgw -n '__fish_use_subcommand' -a init      -d 'Bootstrap repo for MGW (state, templates, labels)'
+complete -c mgw -n '__fish_use_subcommand' -a project   -d 'Initialize project from template (milestones, issues, ROADMAP)'
+complete -c mgw -n '__fish_use_subcommand' -a milestone -d 'Execute milestone issues in dependency order'
+complete -c mgw -n '__fish_use_subcommand' -a next      -d 'Show next unblocked issue'
+complete -c mgw -n '__fish_use_subcommand' -a issue     -d 'Triage issue against codebase'
+complete -c mgw -n '__fish_use_subcommand' -a update    -d 'Post status comment on issue'
+complete -c mgw -n '__fish_use_subcommand' -a pr        -d 'Create PR from GSD artifacts'
+complete -c mgw -n '__fish_use_subcommand' -a sync      -d 'Reconcile .mgw/ state with GitHub'
+complete -c mgw -n '__fish_use_subcommand' -a issues    -d 'Browse open issues'
+complete -c mgw -n '__fish_use_subcommand' -a link      -d 'Cross-reference issues/PRs/branches'
+complete -c mgw -n '__fish_use_subcommand' -a help      -d 'Show command reference'
+
+# ---------------------------------------------------------------------------
+# run <issue-number>
+# ---------------------------------------------------------------------------
+complete -c mgw -n '__fish_seen_subcommand_from run' -l quiet -d 'buffer output, show summary at end'
+complete -c mgw -n '__fish_seen_subcommand_from run' -l auto  -d 'phase chaining: discuss -> plan -> execute'
+complete -c mgw -n '__fish_seen_subcommand_from run' -l dry-run -d 'show what would happen without executing'
+complete -c mgw -n '__fish_seen_subcommand_from run' -l json    -d 'output structured JSON'
+complete -c mgw -n '__fish_seen_subcommand_from run' -s v -l verbose -d 'show API calls and file writes'
+complete -c mgw -n '__fish_seen_subcommand_from run' -l debug   -d 'full payloads and timings'
+complete -c mgw -n '__fish_seen_subcommand_from run' -l model   -d 'Claude model override' -r
+
+# ---------------------------------------------------------------------------
+# milestone [number]
+# ---------------------------------------------------------------------------
+complete -c mgw -n '__fish_seen_subcommand_from milestone' -l interactive -d 'pause between issues for review'
+complete -c mgw -n '__fish_seen_subcommand_from milestone' -l dry-run -d 'show what would happen without executing'
+complete -c mgw -n '__fish_seen_subcommand_from milestone' -l json    -d 'output structured JSON'
+complete -c mgw -n '__fish_seen_subcommand_from milestone' -s v -l verbose -d 'show API calls and file writes'
+complete -c mgw -n '__fish_seen_subcommand_from milestone' -l debug   -d 'full payloads and timings'
+complete -c mgw -n '__fish_seen_subcommand_from milestone' -l model   -d 'Claude model override' -r
+
+# ---------------------------------------------------------------------------
+# pr [number]
+# ---------------------------------------------------------------------------
+complete -c mgw -n '__fish_seen_subcommand_from pr' -l base  -d 'custom base branch' -r
+complete -c mgw -n '__fish_seen_subcommand_from pr' -l dry-run -d 'show what would happen without executing'
+complete -c mgw -n '__fish_seen_subcommand_from pr' -l json    -d 'output structured JSON'
+complete -c mgw -n '__fish_seen_subcommand_from pr' -s v -l verbose -d 'show API calls and file writes'
+complete -c mgw -n '__fish_seen_subcommand_from pr' -l debug   -d 'full payloads and timings'
+complete -c mgw -n '__fish_seen_subcommand_from pr' -l model   -d 'Claude model override' -r
+
+# ---------------------------------------------------------------------------
+# issues [filters]
+# ---------------------------------------------------------------------------
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l label     -d 'filter by label' -r
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l milestone -d 'filter by milestone' -r
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l assignee  -d 'filter by assignee' -r -a 'all @me'
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l state     -d 'issue state' -r -a 'open closed all'
+complete -c mgw -n '__fish_seen_subcommand_from issues' -s s -l search -d 'pre-populate fuzzy search input' -r
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l limit     -d 'max issues to load' -r -a '10 25 50 100'
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l dry-run   -d 'show what would happen without executing'
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l json      -d 'output structured JSON'
+complete -c mgw -n '__fish_seen_subcommand_from issues' -s v -l verbose -d 'show API calls and file writes'
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l debug     -d 'full payloads and timings'
+complete -c mgw -n '__fish_seen_subcommand_from issues' -l model     -d 'Claude model override' -r
+
+# ---------------------------------------------------------------------------
+# link <ref-a> <ref-b>
+# ---------------------------------------------------------------------------
+complete -c mgw -n '__fish_seen_subcommand_from link' -l quiet   -d 'no GitHub comments'
+complete -c mgw -n '__fish_seen_subcommand_from link' -l dry-run -d 'show what would happen without executing'
+complete -c mgw -n '__fish_seen_subcommand_from link' -l json    -d 'output structured JSON'
+complete -c mgw -n '__fish_seen_subcommand_from link' -s v -l verbose -d 'show API calls and file writes'
+complete -c mgw -n '__fish_seen_subcommand_from link' -l debug   -d 'full payloads and timings'
+complete -c mgw -n '__fish_seen_subcommand_from link' -l model   -d 'Claude model override' -r
+
+# ---------------------------------------------------------------------------
+# Subcommands that only take global flags (no subcommand-specific flags)
+# ---------------------------------------------------------------------------
+for _mgw_cmd in init project next issue update sync help
+  complete -c mgw -n "__fish_seen_subcommand_from $_mgw_cmd" -l dry-run -d 'show what would happen without executing'
+  complete -c mgw -n "__fish_seen_subcommand_from $_mgw_cmd" -l json    -d 'output structured JSON'
+  complete -c mgw -n "__fish_seen_subcommand_from $_mgw_cmd" -s v -l verbose -d 'show API calls and file writes'
+  complete -c mgw -n "__fish_seen_subcommand_from $_mgw_cmd" -l debug   -d 'full payloads and timings'
+  complete -c mgw -n "__fish_seen_subcommand_from $_mgw_cmd" -l model   -d 'Claude model override' -r
+end

package/completions/mgw.zsh

@@ -0,0 +1,142 @@
+#compdef mgw
+# mgw zsh completion script
+# Place in a directory on your $fpath (e.g. /usr/local/share/zsh/site-functions/_mgw)
+# or source directly: source completions/mgw.zsh
+# Generated by bin/generate-completions.cjs
+
+_mgw() {
+  local context state state_descr line
+  typeset -A opt_args
+
+  local -a global_flags
+  global_flags=(
+    '--dry-run[show what would happen without executing]'
+    '--json[output structured JSON]'
+    '(-v --verbose)'{-v,--verbose}'[show API calls and file writes]'
+    '--debug[full payloads and timings]'
+    '--model[Claude model override]:model:(claude-opus-4-5 claude-sonnet-4-5 claude-haiku-4-5)'
+  )
+
+  _arguments -C \
+    "${global_flags[@]}" \
+    '(-h --help)'{-h,--help}'[display help]' \
+    '(-V --version)'{-V,--version}'[output the version number]' \
+    '1: :_mgw_subcommands' \
+    '*:: :->subcommand_args' \
+    && return 0
+
+  case "$state" in
+    subcommand_args)
+      case "$words[1]" in
+        run)
+          _arguments \
+            "${global_flags[@]}" \
+            '--quiet[buffer output, show summary at end]' \
+            '--auto[phase chaining: discuss -> plan -> execute]' \
+            '1:issue-number:_mgw_issue_numbers' \
+            && return 0
+          ;;
+        init)
+          _arguments "${global_flags[@]}" && return 0
+          ;;
+        project)
+          _arguments "${global_flags[@]}" && return 0
+          ;;
+        milestone)
+          _arguments \
+            "${global_flags[@]}" \
+            '--interactive[pause between issues for review]' \
+            '1::milestone-number:' \
+            && return 0
+          ;;
+        next)
+          _arguments "${global_flags[@]}" && return 0
+          ;;
+        issue)
+          _arguments \
+            "${global_flags[@]}" \
+            '1:issue-number:_mgw_issue_numbers' \
+            && return 0
+          ;;
+        update)
+          _arguments \
+            "${global_flags[@]}" \
+            '1:issue-number:_mgw_issue_numbers' \
+            '2::message:' \
+            && return 0
+          ;;
+        pr)
+          _arguments \
+            "${global_flags[@]}" \
+            '--base[custom base branch]:branch:_git_branch_names' \
+            '1::issue-number:_mgw_issue_numbers' \
+            && return 0
+          ;;
+        sync)
+          _arguments "${global_flags[@]}" && return 0
+          ;;
+        issues)
+          _arguments \
+            "${global_flags[@]}" \
+            '--label[filter by label]:label:' \
+            '--milestone[filter by milestone]:milestone:' \
+            '--assignee[filter by assignee]:assignee:(all @me)' \
+            '--state[issue state]:state:(open closed all)' \
+            '(-s --search)'{-s,--search}'[pre-populate fuzzy search input]:query:' \
+            '--limit[max issues to load]:number:(10 25 50 100)' \
+            && return 0
+          ;;
+        link)
+          _arguments \
+            "${global_flags[@]}" \
+            '--quiet[no GitHub comments]' \
+            '1:ref-a:' \
+            '2:ref-b:' \
+            && return 0
+          ;;
+        help)
+          return 0
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_mgw_subcommands() {
+  local -a subcommands
+  subcommands=(
+    'run:Run the full pipeline for an issue'
+    'init:Bootstrap repo for MGW (state, templates, labels)'
+    'project:Initialize project from template (milestones, issues, ROADMAP)'
+    'milestone:Execute milestone issues in dependency order'
+    'next:Show next unblocked issue'
+    'issue:Triage issue against codebase'
+    'update:Post status comment on issue'
+    'pr:Create PR from GSD artifacts'
+    'sync:Reconcile .mgw/ state with GitHub'
+    'issues:Browse open issues'
+    'link:Cross-reference issues/PRs/branches'
+    'help:Show command reference'
+  )
+  _describe 'mgw subcommand' subcommands
+}
+
+_mgw_issue_numbers() {
+  # Attempt to complete issue numbers from active .mgw/ state
+  local -a active_issues
+  local active_dir=".mgw/active"
+  if [[ -d "$active_dir" ]]; then
+    for f in "$active_dir"/*.json; do
+      [[ -f "$f" ]] || continue
+      local num="${${f:t}%%[-_]*}"
+      [[ "$num" =~ ^[0-9]+$ ]] && active_issues+=("$num")
+    done
+  fi
+  if (( ${#active_issues[@]} > 0 )); then
+    _describe 'issue number' active_issues
+  else
+    _message 'issue number'
+  fi
+}
+
+_mgw "$@"

package/dist/bin/mgw.cjs

@@ -1,16 +1,17 @@
 #!/usr/bin/env node
 'use strict';
 
-var claude = require('../claude-Dk1oVsaG.cjs');
+var index = require('../index-CXfe9U4l.cjs');
 var require$$0 = require('commander');
 var require$$1 = require('path');
 var require$$0$2 = require('fs');
 var require$$0$1 = require('child_process');
+require('events');
 
 var mgw$1 = {};
 
-var version = "0.1.2";
-var require$$8 = {
+var version = "0.2.0";
+var require$$10 = {
 	version: version};
 
 var hasRequiredMgw;
@@ -22,26 +23,85 @@ function requireMgw () {
 	const path = require$$1;
 	const fs = require$$0$2;
 	const { execSync } = require$$0$1;
-	const { assertClaudeAvailable, invokeClaude, getCommandsDir } = claude.requireClaude();
-	const { log, error, formatJson, verbose } = claude.requireOutput();
-	const { getActiveDir, getCompletedDir, getMgwDir } = claude.requireState();
-	const { getIssue, listIssues } = claude.requireGithub();
-	const pkg = require$$8;
+	const { assertClaudeAvailable, invokeClaude, getCommandsDir } = index.requireClaude();
+	const { log, error, formatJson, verbose } = index.requireOutput();
+	const { getActiveDir, getCompletedDir, getMgwDir } = index.requireState();
+	const { getIssue, listIssues } = index.requireGithub();
+	const { createIssuesBrowser } = index.requireTui();
+	const { createSpinner } = index.requireSpinner();
+	const pkg = require$$10;
 	const program = new Command();
 	program.name("mgw").description("GitHub issue pipeline automation \u2014 Day 1 idea to Go Live").version(pkg.version).option("--dry-run", "show what would happen without executing").option("--json", "output structured JSON").option("-v, --verbose", "show API calls and file writes").option("--debug", "full payloads and timings").option("--model <model>", "Claude model override");
+	const STAGE_LABELS = {
+	  run: "pipeline",
+	  init: "init",
+	  project: "project",
+	  milestone: "milestone",
+	  issue: "triage",
+	  pr: "create-pr",
+	  update: "update",
+	  next: "next"
+	};
 	async function runAiCommand(commandName, userPrompt, opts) {
 	  assertClaudeAvailable();
 	  const cmdFile = path.join(getCommandsDir(), `${commandName}.md`);
-	  const result = await invokeClaude(cmdFile, userPrompt, {
-	    model: opts.model,
-	    quiet: opts.quiet,
-	    dryRun: opts.dryRun,
-	    json: opts.json
-	  });
-	  process.exitCode = result.exitCode;
+	  const stageLabel = STAGE_LABELS[commandName] || commandName;
+	  if (opts.quiet) {
+	    const spinner = createSpinner(`mgw:${stageLabel}`);
+	    spinner.start();
+	    let result;
+	    try {
+	      result = await invokeClaude(cmdFile, userPrompt, {
+	        model: opts.model,
+	        quiet: true,
+	        dryRun: opts.dryRun,
+	        json: opts.json
+	      });
+	    } catch (err) {
+	      spinner.fail(`${stageLabel} failed`);
+	      throw err;
+	    }
+	    if (result.exitCode === 0) {
+	      spinner.succeed(`${stageLabel} complete`);
+	    } else {
+	      spinner.fail(`${stageLabel} failed (exit ${result.exitCode})`);
+	    }
+	    if (result.output) {
+	      process.stdout.write(result.output);
+	    }
+	    process.exitCode = result.exitCode;
+	  } else {
+	    const spinner = createSpinner(`mgw:${stageLabel}`);
+	    spinner.start();
+	    await new Promise((r) => setTimeout(r, 80));
+	    spinner.stop();
+	    const result = await invokeClaude(cmdFile, userPrompt, {
+	      model: opts.model,
+	      quiet: false,
+	      dryRun: opts.dryRun,
+	      json: opts.json
+	    });
+	    process.exitCode = result.exitCode;
+	  }
 	}
+	const RUN_PIPELINE_STAGES = [
+	  "validate",
+	  "triage",
+	  "create-worktree",
+	  "execute-gsd",
+	  "create-pr"
+	];
 	program.command("run <issue-number>").description("Run the full pipeline for an issue").option("--quiet", "buffer output, show summary at end").option("--auto", "phase chaining: discuss -> plan -> execute").action(async function(issueNumber) {
 	  const opts = this.optsWithGlobals();
+	  if (!opts.json) {
+	    const { USE_COLOR, COLORS } = index.requireOutput();
+	    const dim = USE_COLOR ? COLORS.dim : "";
+	    const reset = USE_COLOR ? COLORS.reset : "";
+	    const bold = USE_COLOR ? COLORS.bold : "";
+	    const stages = RUN_PIPELINE_STAGES.join(` ${dim}\u2192${reset} `);
+	    process.stdout.write(`${bold}mgw:run${reset} #${issueNumber}  ${dim}${stages}${reset}
+`);
+	  }
 	  await runAiCommand("run", issueNumber, opts);
 	});
 	program.command("init").description("Bootstrap repo for MGW (state, templates, labels)").action(async function() {
@@ -161,12 +221,15 @@ function requireMgw () {
 	    log(`sync complete: ${ok} up-to-date, ${archived} archived`);
 	  }
 	});
-	program.command("issues [filters...]").description("List open issues").option("--label <label>", "filter by label").option("--milestone <name>", "filter by milestone").option("--assignee <user>", "filter by assignee (default: @me)", "@me").option("--state <state>", "issue state: open, closed, all (default: open)", "open").action(async function() {
+	program.command("issues [filters...]").description("Browse open issues \u2014 interactive TUI in TTY, static table otherwise").option("--label <label>", "filter by label").option("--milestone <name>", "filter by milestone").option("--assignee <user>", 'filter by assignee ("all" = no filter, default: all)', "all").option("--state <state>", "issue state: open, closed, all (default: open)", "open").option("-s, --search <query>", "pre-populate fuzzy search input").option("--limit <n>", "max issues to load (default: 50)", "50").action(async function() {
 	  const opts = this.optsWithGlobals();
 	  const ghFilters = {
-	    assignee: opts.assignee || "@me",
-	    state: opts.state || "open"
+	    state: opts.state || "open",
+	    limit: parseInt(opts.limit, 10) || 50
 	  };
+	  if (opts.assignee && opts.assignee !== "all") {
+	    ghFilters.assignee = opts.assignee;
+	  }
 	  if (opts.label) ghFilters.label = opts.label;
 	  if (opts.milestone) ghFilters.milestone = opts.milestone;
 	  let issues;
@@ -185,16 +248,23 @@ function requireMgw () {
 	    log("No issues found.");
 	    return;
 	  }
-	  const pad = (s, n) => String(s).padEnd(n);
-	  log(pad("#", 6) + pad("Title", 60) + pad("State", 10) + "Labels");
-	  log("-".repeat(90));
-	  for (const issue of issues) {
-	    const labels = (issue.labels || []).map((l) => l.name || l).join(", ");
-	    log(
-	      pad(issue.number, 6) + pad((issue.title || "").substring(0, 58), 60) + pad(issue.state || "", 10) + labels
-	    );
-	  }
-	  log("\n" + issues.length + " issue(s)");
+	  await createIssuesBrowser({
+	    issues,
+	    onSelect: function(issue) {
+	      log("\nSelected: #" + issue.number + " \u2014 " + issue.title);
+	      log("Run: mgw issue " + issue.number);
+	      process.exit(0);
+	    },
+	    onQuit: function() {
+	      process.exit(0);
+	    },
+	    initialQuery: opts.search || "",
+	    initialFilter: {
+	      label: opts.label,
+	      milestone: opts.milestone,
+	      assignee: opts.assignee || "all"
+	    }
+	  });
 	});
 	program.command("link <ref-a> <ref-b>").description("Cross-reference issues/PRs/branches").option("--quiet", "no GitHub comments").action(async function(refA, refB) {
 	  const opts = this.optsWithGlobals();
@@ -286,6 +356,6 @@ function requireMgw () {
 }
 
 var mgwExports = requireMgw();
-var mgw = /*@__PURE__*/claude.getDefaultExportFromCjs(mgwExports);
+var mgw = /*@__PURE__*/index.getDefaultExportFromCjs(mgwExports);
 
 module.exports = mgw;