@snipcodeit/mgw 0.3.0 → 0.6.0

package/README.md

@@ -2,6 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@snipcodeit/mgw)](https://www.npmjs.com/package/@snipcodeit/mgw)
 [![CI](https://github.com/snipcodeit/mgw/actions/workflows/ci.yml/badge.svg)](https://github.com/snipcodeit/mgw/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-70%25-brightgreen)](./coverage/lcov-report/index.html)
 [![npm downloads](https://img.shields.io/npm/dm/@snipcodeit/mgw)](https://www.npmjs.com/package/@snipcodeit/mgw)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![node](https://img.shields.io/node/v/@snipcodeit/mgw)](https://nodejs.org)

package/bin/mgw-install.cjs

@@ -2,45 +2,84 @@
 'use strict';
 
 /**
- * bin/mgw-install.cjs — Idempotent slash command installer
+ * bin/mgw-install.cjs — Multi-CLI-aware idempotent slash command installer
  *
- * Runs automatically via npm postinstall. Copies the commands/ source tree
- * into ~/.claude/commands/mgw/ so Claude Code slash commands are available
- * without any manual copy step.
+ * Runs automatically via npm postinstall. Detects the active AI CLI
+ * (claude, gemini, or opencode — in priority order) and copies the
+ * commands/ source tree into the correct provider-specific commands
+ * directory so slash commands are available without any manual copy step.
  *
  * Behavior:
- * - If ~/.claude/ does not exist: prints a skip message and exits 0 (non-fatal)
- * - If ~/.claude/ exists: creates ~/.claude/commands/mgw/ and recursively
- *   copies commands/ into it (overwriting existing files — idempotent)
- * - Exits 0 in both cases
+ * - Auto-detects first available CLI binary (claude > gemini > opencode)
+ * - --provider=<id> flag overrides auto-detection
+ * - If no AI CLI is found on PATH: prints skip message and exits 0 (non-fatal)
+ * - If provider's base dir does not exist: prints skip message and exits 0
+ * - If previously installed provider differs: removes old install dir first
+ * - Idempotent: running twice for the same provider is safe
+ * - Tracks installed provider in ~/.mgw-install-state.json
  *
- * Dependencies: Node.js built-ins only (path, fs, os)
+ * Dependencies: Node.js built-ins only (path, fs, os, child_process)
  */
 
 const path = require('path');
 const fs = require('fs');
 const os = require('os');
+const { execSync } = require('child_process');
 
 // Source: commands/ directory relative to this script (bin/ → ../commands/)
 const sourceDir = path.join(__dirname, '..', 'commands');
 
-// Target: ~/.claude/commands/mgw/
-const claudeDir = path.join(os.homedir(), '.claude');
-const targetDir = path.join(claudeDir, 'commands', 'mgw');
+// State file for tracking installed provider across runs
+const statePath = path.join(os.homedir(), '.mgw-install-state.json');
 
-// Guard: if ~/.claude/ does not exist, skip silently with a clear message
-if (!fs.existsSync(claudeDir)) {
-  console.log(
-    'mgw: ~/.claude/ not found — skipping slash command install ' +
-    '(run `node ./bin/mgw-install.cjs` after installing Claude Code)'
-  );
-  process.exit(0);
+// Provider target directories — where each CLI expects slash commands
+const PROVIDER_TARGETS = {
+  claude:   path.join(os.homedir(), '.claude', 'commands', 'mgw'),
+  gemini:   path.join(os.homedir(), '.gemini', 'commands', 'mgw'),
+  opencode: path.join(os.homedir(), '.opencode', 'commands', 'mgw'),
+};
+
+// Valid provider IDs (order is also detection priority)
+const VALID_PROVIDERS = ['claude', 'gemini', 'opencode'];
+
+/**
+ * Parse --provider flag from process.argv.
+ * Handles both --provider=claude and --provider claude forms.
+ * @returns {string|null} provider ID string or null if not specified
+ */
+function parseProviderFlag() {
+  const args = process.argv.slice(2);
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith('--provider=')) {
+      return args[i].split('=')[1] || null;
+    }
+    if (args[i] === '--provider' && i + 1 < args.length) {
+      return args[i + 1];
+    }
+  }
+  return null;
 }
 
-// Guard: ensure commands/ source exists in this package
-if (!fs.existsSync(sourceDir)) {
-  console.log('mgw: commands/ source not found — skipping slash command install');
-  process.exit(0);
+/**
+ * Detect the active AI CLI by trying binaries in priority order.
+ * @param {string|null} forcedProvider - If set, skip detection and return this value.
+ * @returns {string|null} Provider ID of the first found binary, or null if none found.
+ */
+function detectProvider(forcedProvider) {
+  if (forcedProvider) {
+    return forcedProvider;
+  }
+
+  for (const id of VALID_PROVIDERS) {
+    try {
+      execSync(id + ' --version', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+      return id;
+    } catch (_) {
+      // Binary not found or not working — try next
+    }
+  }
+
+  return null;
 }
 
 /**
@@ -76,6 +115,64 @@ function copyDirRecursive(src, dest) {
   return count;
 }
 
+// --- Main ---
+
+// Guard: ensure commands/ source exists in this package
+if (!fs.existsSync(sourceDir)) {
+  console.log('mgw: commands/ source not found — skipping slash command install');
+  process.exit(0);
+}
+
+// Parse and validate --provider flag
+const flagProvider = parseProviderFlag();
+if (flagProvider !== null && !VALID_PROVIDERS.includes(flagProvider)) {
+  console.error(
+    'mgw: unknown provider "' + flagProvider + '" — valid options: ' + VALID_PROVIDERS.join(', ')
+  );
+  process.exit(1);
+}
+
+// Detect or use forced provider
+const detectedProvider = detectProvider(flagProvider);
+
+if (detectedProvider === null) {
+  console.log('mgw: no AI CLI found (claude/gemini/opencode) — skipping slash command install');
+  process.exit(0);
+}
+
+// Parent dir guard: provider's base config directory must already exist
+// (i.e. the user has run the CLI at least once to initialize it).
+// This MUST run before old-dir cleanup — otherwise switching to a provider
+// whose home dir doesn't exist would delete old commands and install nothing.
+const targetDir = PROVIDER_TARGETS[detectedProvider];
+const providerHomeDir = path.join(os.homedir(), '.' + detectedProvider);
+
+if (!fs.existsSync(providerHomeDir)) {
+  console.log(
+    'mgw: ~/.' + detectedProvider + '/ not found — skipping slash command install ' +
+    '(run the CLI once to initialize it)'
+  );
+  process.exit(0);
+}
+
+// Old-dir cleanup: if previously installed provider differs, remove old install.
+// Safe to run here — we've already confirmed the new provider's home dir exists.
+if (fs.existsSync(statePath)) {
+  try {
+    const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+    if (state.provider && state.provider !== detectedProvider && PROVIDER_TARGETS[state.provider]) {
+      const oldDir = PROVIDER_TARGETS[state.provider];
+      fs.rmSync(oldDir, { recursive: true, force: true });
+    }
+  } catch (_) {
+    // Corrupt or unreadable state file — ignore and continue
+  }
+}
+
 // Perform the install
 const fileCount = copyDirRecursive(sourceDir, targetDir);
-console.log(`mgw: installed ${fileCount} slash commands to ${targetDir}`);
+
+// Write state file
+fs.writeFileSync(statePath, JSON.stringify({ provider: detectedProvider }, null, 2));
+
+console.log('mgw: detected ' + detectedProvider + ' CLI — installed ' + fileCount + ' slash commands to ' + targetDir);

package/commands/board/create.md

@@ -399,6 +399,141 @@ print(json.dumps(result))
   else
     echo "  WARNING: GSD Route field creation failed"
   fi
+
+  # Field 6: Plan Summary (TEXT)
+  PLAN_SUMMARY_RESULT=$(gh api graphql -f query='
+    mutation($projectId: ID!) {
+      createProjectV2Field(input: {
+        projectId: $projectId
+        dataType: TEXT
+        name: "Plan Summary"
+      }) {
+        projectV2Field {
+          ... on ProjectV2Field {
+            id
+            name
+          }
+        }
+      }
+    }
+  ' -f projectId="$NEW_PROJECT_ID" 2>&1)
+
+  PLAN_SUMMARY_FIELD_ID=$(echo "$PLAN_SUMMARY_RESULT" | python3 -c "
+import json,sys
+d = json.load(sys.stdin)
+print(d['data']['createProjectV2Field']['projectV2Field']['id'])
+" 2>/dev/null)
+
+  if [ -n "$PLAN_SUMMARY_FIELD_ID" ]; then
+    echo "  Plan Summary field created: ${PLAN_SUMMARY_FIELD_ID}"
+  else
+    echo "  WARNING: Plan Summary field creation failed"
+  fi
+
+  # Field 7: Priority (SINGLE_SELECT)
+  PRIORITY_RESULT=$(gh api graphql -f query='
+    mutation($projectId: ID!) {
+      createProjectV2Field(input: {
+        projectId: $projectId
+        dataType: SINGLE_SELECT
+        name: "Priority"
+        singleSelectOptions: [
+          { name: "P0", color: RED, description: "Critical — blocking other work" }
+          { name: "P1", color: ORANGE, description: "High — needed this milestone" }
+          { name: "P2", color: YELLOW, description: "Medium — important but not urgent" }
+          { name: "P3", color: GRAY, description: "Low — nice to have" }
+        ]
+      }) {
+        projectV2Field {
+          ... on ProjectV2SingleSelectField {
+            id
+            name
+            options { id name }
+          }
+        }
+      }
+    }
+  ' -f projectId="$NEW_PROJECT_ID" 2>&1)
+
+  PRIORITY_FIELD_ID=$(echo "$PRIORITY_RESULT" | python3 -c "
+import json,sys
+d = json.load(sys.stdin)
+print(d['data']['createProjectV2Field']['projectV2Field']['id'])
+" 2>/dev/null)
+
+  PRIORITY_OPTIONS=$(echo "$PRIORITY_RESULT" | python3 -c "
+import json,sys
+d = json.load(sys.stdin)
+options = d['data']['createProjectV2Field']['projectV2Field']['options']
+name_to_id = {o['name']: o['id'] for o in options}
+print(json.dumps(name_to_id))
+" 2>/dev/null || echo "{}")
+
+  if [ -n "$PRIORITY_FIELD_ID" ]; then
+    echo "  Priority field created: ${PRIORITY_FIELD_ID}"
+  else
+    echo "  WARNING: Priority field creation failed"
+  fi
+
+  # Field 8: Start Date (DATE)
+  START_DATE_RESULT=$(gh api graphql -f query='
+    mutation($projectId: ID!) {
+      createProjectV2Field(input: {
+        projectId: $projectId
+        dataType: DATE
+        name: "Start Date"
+      }) {
+        projectV2Field {
+          ... on ProjectV2Field {
+            id
+            name
+          }
+        }
+      }
+    }
+  ' -f projectId="$NEW_PROJECT_ID" 2>&1)
+
+  START_DATE_FIELD_ID=$(echo "$START_DATE_RESULT" | python3 -c "
+import json,sys
+d = json.load(sys.stdin)
+print(d['data']['createProjectV2Field']['projectV2Field']['id'])
+" 2>/dev/null)
+
+  if [ -n "$START_DATE_FIELD_ID" ]; then
+    echo "  Start Date field created: ${START_DATE_FIELD_ID}"
+  else
+    echo "  WARNING: Start Date field creation failed"
+  fi
+
+  # Field 9: Target Date (DATE)
+  TARGET_DATE_RESULT=$(gh api graphql -f query='
+    mutation($projectId: ID!) {
+      createProjectV2Field(input: {
+        projectId: $projectId
+        dataType: DATE
+        name: "Target Date"
+      }) {
+        projectV2Field {
+          ... on ProjectV2Field {
+            id
+            name
+          }
+        }
+      }
+    }
+  ' -f projectId="$NEW_PROJECT_ID" 2>&1)
+
+  TARGET_DATE_FIELD_ID=$(echo "$TARGET_DATE_RESULT" | python3 -c "
+import json,sys
+d = json.load(sys.stdin)
+print(d['data']['createProjectV2Field']['projectV2Field']['id'])
+" 2>/dev/null)
+
+  if [ -n "$TARGET_DATE_FIELD_ID" ]; then
+    echo "  Target Date field created: ${TARGET_DATE_FIELD_ID}"
+  else
+    echo "  WARNING: Target Date field creation failed"
+  fi
 ```
 
 **Update project.json with board metadata:**
@@ -456,6 +591,36 @@ if '${GSD_ROUTE_FIELD_ID}':
         'options': gsd_route_options
     }
 
+if '${PLAN_SUMMARY_FIELD_ID}':
+    fields['plan_summary'] = {
+        'field_id': '${PLAN_SUMMARY_FIELD_ID}',
+        'field_name': 'Plan Summary',
+        'type': 'TEXT'
+    }
+
+priority_options = json.loads('''${PRIORITY_OPTIONS}''') if '${PRIORITY_OPTIONS}' != '{}' else {}
+if '${PRIORITY_FIELD_ID}':
+    fields['priority'] = {
+        'field_id': '${PRIORITY_FIELD_ID}',
+        'field_name': 'Priority',
+        'type': 'SINGLE_SELECT',
+        'options': priority_options
+    }
+
+if '${START_DATE_FIELD_ID}':
+    fields['start_date'] = {
+        'field_id': '${START_DATE_FIELD_ID}',
+        'field_name': 'Start Date',
+        'type': 'DATE'
+    }
+
+if '${TARGET_DATE_FIELD_ID}':
+    fields['target_date'] = {
+        'field_id': '${TARGET_DATE_FIELD_ID}',
+        'field_name': 'Target Date',
+        'type': 'DATE'
+    }
+
 # Update project_board section
 project['project']['project_board'] = {
     'number': int('${NEW_PROJECT_NUMBER}') if '${NEW_PROJECT_NUMBER}'.isdigit() else None,
@@ -484,9 +649,36 @@ PYEOF
   echo "  milestone         ${MILESTONE_FIELD_ID:-FAILED} (TEXT)"
   echo "  phase             ${PHASE_FIELD_ID:-FAILED} (TEXT)"
   echo "  gsd_route         ${GSD_ROUTE_FIELD_ID:-FAILED} (SINGLE_SELECT, 4 options)"
+  echo "  plan_summary      ${PLAN_SUMMARY_FIELD_ID:-FAILED} (TEXT)"
+  echo "  priority          ${PRIORITY_FIELD_ID:-FAILED} (SINGLE_SELECT, 4 options)"
+  echo "  start_date        ${START_DATE_FIELD_ID:-FAILED} (DATE)"
+  echo "  target_date       ${TARGET_DATE_FIELD_ID:-FAILED} (DATE)"
   echo ""
   echo "Field IDs stored in .mgw/project.json"
   echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo " VIEW SETUP GUIDE"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "Open your project board and create these views:"
+  echo ""
+  echo "1. Pipeline (Board)"
+  echo "   - Layout: Board | Column field: Status"
+  echo "   - Visible fields: Phase, GSD Route, Milestone, Priority"
+  echo ""
+  echo "2. Sprint Table (Table)"
+  echo "   - Layout: Table | Group by: Milestone"
+  echo "   - Columns: Status, Phase, Priority, Plan Summary, Assignees"
+  echo "   - Sort by: Priority (ascending)"
+  echo ""
+  echo "3. Roadmap (Roadmap)"
+  echo "   - Layout: Roadmap | Date field: Start Date -> Target Date"
+  echo "   - Group by: Milestone"
+  echo ""
+  echo "4. My Work (Table)"
+  echo "   - Layout: Table | Filter: assignee:@me"
+  echo "   - Columns: Status, Phase, Plan Summary, Priority"
+  echo ""
   echo "Next:"
   echo "  /mgw:board show      Display board state"
   echo "  /mgw:run 73          Sync issues onto board items (#73)"

package/commands/board/sync.md

@@ -385,6 +385,50 @@ print(stage_map.get(label, ''))
       fi
     fi
 
+    # Update Plan Summary field from latest plan comment (if field exists)
+    PLAN_SUMMARY_FIELD_ID=$(echo "$FIELDS_JSON" | python3 -c "
+import json,sys
+fields = json.load(sys.stdin)
+print(fields.get('plan_summary', {}).get('field_id', ''))
+" 2>/dev/null)
+
+    if [ -n "$PLAN_SUMMARY_FIELD_ID" ] && [ -n "$BOARD_ITEM_ID" ]; then
+      PLAN_SUMMARY=$(node -e "
+        const ic = require('./lib/issue-context.cjs');
+        ic.findLatestComment(${ISSUE_NUMBER}, 'plan')
+          .then(plan => {
+            if (plan) {
+              const body = plan.body.replace(/<!--[\\s\\S]*?-->\\n?/, '').trim();
+              const summary = body.split('\\n').slice(0, 3).join(' ').substring(0, 200);
+              process.stdout.write(summary);
+            }
+          })
+          .catch(() => {});
+      " 2>/dev/null || echo "")
+
+      if [ -n "$PLAN_SUMMARY" ]; then
+        gh api graphql -f query='
+          mutation($projectId: ID!, $itemId: ID!, $fieldId: ID!, $text: String!) {
+            updateProjectV2ItemFieldValue(input: {
+              projectId: $projectId
+              itemId: $itemId
+              fieldId: $fieldId
+              value: { text: $text }
+            }) { projectV2Item { id } }
+          }
+        ' -f projectId="$BOARD_NODE_ID" \
+          -f itemId="$BOARD_ITEM_ID" \
+          -f fieldId="$PLAN_SUMMARY_FIELD_ID" \
+          -f text="$PLAN_SUMMARY" 2>/dev/null || true
+
+        if [ -n "$CHANGED_FIELDS" ]; then
+          CHANGED_FIELDS="${CHANGED_FIELDS}, Plan Summary (updated)"
+        else
+          CHANGED_FIELDS="Plan Summary (updated)"
+        fi
+      fi
+    fi
+
     if [ -z "$CHANGED_FIELDS" ]; then
       CHANGED_FIELDS="no changes"
     fi

package/commands/board/views.md

@@ -27,6 +27,29 @@ if [ "$SUBCOMMAND" = "views" ]; then
     echo "  kanban   Create Board layout view (swimlanes by Status)"
     echo "  table    Create Table layout view (flat list with all fields)"
     echo "  roadmap  Create Roadmap layout view (timeline grouped by Milestone)"
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo " VIEW SETUP GUIDE"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "Open your project board and create these views:"
+    echo ""
+    echo "1. Pipeline (Board)"
+    echo "   - Layout: Board | Column field: Status"
+    echo "   - Visible fields: Phase, GSD Route, Milestone, Priority"
+    echo ""
+    echo "2. Sprint Table (Table)"
+    echo "   - Layout: Table | Group by: Milestone"
+    echo "   - Columns: Status, Phase, Priority, Plan Summary, Assignees"
+    echo "   - Sort by: Priority (ascending)"
+    echo ""
+    echo "3. Roadmap (Roadmap)"
+    echo "   - Layout: Roadmap | Date field: Start Date -> Target Date"
+    echo "   - Group by: Milestone"
+    echo ""
+    echo "4. My Work (Table)"
+    echo "   - Layout: Table | Filter: assignee:@me"
+    echo "   - Columns: Status, Phase, Plan Summary, Priority"
     exit 1
   fi
 

package/commands/context.md

@@ -0,0 +1,183 @@
+---
+name: mgw:context
+description: Show assembled context for an issue — what GSD agents see before planning/execution
+argument-hint: "<issue-number>"
+allowed-tools:
+  - Bash
+  - Read
+---
+
+<objective>
+Display the full assembled context for a GitHub issue, showing exactly what a GSD agent
+would receive as input before planning or execution. Useful for debugging context gaps,
+verifying that prior phase summaries are available, and checking what a second developer's
+agent will see.
+
+This command is read-only. It does not modify any state.
+</objective>
+
+<process>
+
+<step name="validate_input">
+**Validate issue number provided:**
+
+Parse $ARGUMENTS for a numeric issue number. If missing:
+```
+AskUserQuestion(
+  header: "Issue Number Required",
+  question: "Which issue number do you want context for?",
+  followUp: "Enter the GitHub issue number (e.g., 42)"
+)
+```
+</step>
+
+<step name="assemble_and_display">
+**Assemble full context from GitHub and display formatted output:**
+
+```bash
+REPO_ROOT=$(git rev-parse --show-toplevel)
+
+node -e "
+const ic = require('${REPO_ROOT}/lib/issue-context.cjs');
+
+(async () => {
+  // Assemble issue context
+  const ctx = await ic.assembleIssueContext(${ISSUE_NUMBER});
+  if (!ctx || !ctx.issue) {
+    console.log('No context found for issue #${ISSUE_NUMBER}.');
+    process.exit(0);
+  }
+
+  const issue = ctx.issue;
+  const milestone = issue.milestone || {};
+  const labels = (issue.labels || []).map(l => typeof l === 'object' ? l.name : l);
+
+  // Header
+  console.log('');
+  console.log('Issue #' + issue.number + ': ' + issue.title);
+  if (milestone.title) {
+    console.log('Milestone: ' + milestone.title);
+  }
+  console.log('Status: ' + (issue.state || 'unknown'));
+  if (labels.length > 0) {
+    console.log('Labels: ' + labels.join(', '));
+  }
+
+  // Vision
+  const vision = await ic.fetchProjectVision();
+  if (vision) {
+    console.log('');
+    console.log('-- Vision --');
+    console.log(vision.slice(0, 2000));
+  }
+
+  // Prior phases (from milestone siblings)
+  if (ctx.milestoneContext && ctx.milestoneContext.length > 0) {
+    console.log('');
+    console.log('-- Prior Phases --');
+    for (const s of ctx.milestoneContext) {
+      if (s.issueNumber === issue.number) continue;
+      console.log('Phase #' + s.issueNumber + ': ' + s.title);
+      if (s.summary) {
+        // Indent summary lines
+        const lines = s.summary.split('\\n').slice(0, 5);
+        for (const line of lines) {
+          console.log('  ' + line);
+        }
+      }
+    }
+  }
+
+  // Phase goal (from issue body)
+  if (issue.body) {
+    console.log('');
+    console.log('-- Phase Goal --');
+    // Extract acceptance criteria or goal sections from body
+    const body = issue.body;
+    const goalMatch = body.match(/##?\\s*(?:Goal|Description|Overview)\\s*\\n([\\s\\S]*?)(?=\\n##|$)/i);
+    if (goalMatch) {
+      console.log(goalMatch[1].trim().slice(0, 1000));
+    } else {
+      // Show first meaningful paragraph
+      const paras = body.split('\\n\\n').filter(p => p.trim() && !p.startsWith('<!--'));
+      if (paras.length > 0) {
+        console.log(paras[0].trim().slice(0, 1000));
+      }
+    }
+
+    const acMatch = body.match(/##?\\s*Acceptance\\s*Criteria\\s*\\n([\\s\\S]*?)(?=\\n##|$)/i);
+    if (acMatch) {
+      console.log('');
+      console.log('-- Acceptance Criteria --');
+      console.log(acMatch[1].trim().slice(0, 1000));
+    }
+  }
+
+  // Dependencies (from labels)
+  const blockedBy = labels.filter(l => l.startsWith('blocked-by:'));
+  const blocks = labels.filter(l => l.startsWith('blocks:'));
+  if (blockedBy.length > 0 || blocks.length > 0) {
+    console.log('');
+    console.log('-- Dependencies --');
+    if (blockedBy.length > 0) {
+      console.log('Blocked by: ' + blockedBy.map(l => l.replace('blocked-by:', '')).join(', '));
+    }
+    if (blocks.length > 0) {
+      console.log('Blocks: ' + blocks.map(l => l.replace('blocks:', '')).join(', '));
+    }
+  }
+
+  // Plan (if posted)
+  if (ctx.planComment) {
+    console.log('');
+    console.log('-- Plan (from structured comment) --');
+    const planBody = ctx.planComment.body.replace(/<!--[\\s\\S]*?-->\\n?/, '').trim();
+    console.log(planBody.slice(0, 2000));
+  }
+
+  // Summary (if posted)
+  if (ctx.summaryComment) {
+    console.log('');
+    console.log('-- Summary (from structured comment) --');
+    const summaryBody = ctx.summaryComment.body.replace(/<!--[\\s\\S]*?-->\\n?/, '').trim();
+    console.log(summaryBody.slice(0, 1000));
+  }
+
+  console.log('');
+})().catch(e => {
+  console.error('Error assembling context: ' + e.message);
+  process.exit(1);
+});
+" 2>/dev/null
+```
+</step>
+
+<step name="display">
+**Display context report with banner:**
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ MGW ► CONTEXT FOR #${ISSUE_NUMBER}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+${FORMATTED_OUTPUT}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Tip: This is what GSD agents see before planning.
+  → /mgw:run ${ISSUE_NUMBER}  — Execute this issue
+  → /mgw:status              — Project dashboard
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Issue number validated
+- [ ] Issue context assembled from GitHub comments via assembleIssueContext()
+- [ ] Vision fetched via fetchProjectVision() (GitHub Project README first, local fallback)
+- [ ] Output formatted with clear section headers (Vision, Prior Phases, Phase Goal, etc.)
+- [ ] Acceptance criteria extracted from issue body when present
+- [ ] Dependencies shown from labels
+- [ ] Plan and summary comments displayed when available
+- [ ] No state modified
+</success_criteria>