@snipcodeit/mgw 0.2.2 → 0.4.0

package/commands/sync.md

@@ -33,6 +33,18 @@ Run periodically or when starting a new session to get a clean view.
 
 <process>
 
+<step name="parse_arguments">
+**Parse sync flags:**
+```bash
+FULL_SYNC=false
+for arg in "$@"; do
+  case "$arg" in
+    --full) FULL_SYNC=true ;;
+  esac
+done
+```
+</step>
+
 <step name="pull_board_state">
 **Pull board state to reconstruct missing local .mgw/active/ files.**
 
@@ -348,6 +360,63 @@ rebuilt from board data — triage results and GSD artifacts will need to be re-
 issue advances to `planning` or beyond.
 </step>
 
+<step name="rebuild_from_committed">
+**Rebuild project context from committed planning files (--full only):**
+
+Only runs when `--full` flag is passed. This is the multi-machine context rebuild:
+after `git pull`, a developer runs `mgw:sync --full` to reconstruct full project
+context from committed `.planning/` files and the board.
+
+```bash
+if [ "$FULL_SYNC" = "true" ]; then
+  echo "Full sync: rebuilding project context from committed planning files..."
+
+  # 1. Check for committed ROADMAP.md
+  if [ -f ".planning/ROADMAP.md" ]; then
+    echo "  Found committed ROADMAP.md"
+    ROADMAP_ANALYSIS=$(node ~/.claude/get-shit-done/bin/gsd-tools.cjs roadmap analyze 2>/dev/null || echo '{}')
+    PHASE_COUNT=$(echo "$ROADMAP_ANALYSIS" | python3 -c "import json,sys; print(len(json.load(sys.stdin).get('phases',[])))" 2>/dev/null || echo "0")
+    echo "  ROADMAP.md contains ${PHASE_COUNT} phases"
+  else
+    echo "  No committed ROADMAP.md found — planning context unavailable"
+    echo "  (This is expected if the project hasn't run a milestone yet)"
+  fi
+
+  # 2. Scan for committed phase artifacts
+  COMMITTED_PLANS=$(find .planning -name '*-PLAN.md' -not -path '.planning/quick/*' 2>/dev/null | wc -l)
+  COMMITTED_SUMMARIES=$(find .planning -name '*-SUMMARY.md' -not -path '.planning/quick/*' 2>/dev/null | wc -l)
+  echo "  Committed phase plans: ${COMMITTED_PLANS}"
+  echo "  Committed phase summaries: ${COMMITTED_SUMMARIES}"
+
+  # 3. If project.json is missing but board + ROADMAP exist, offer to reconstruct
+  if [ ! -f "${MGW_DIR}/project.json" ] && [ -f ".planning/ROADMAP.md" ] && [ -n "$BOARD_NODE_ID" ]; then
+    echo ""
+    echo "  project.json is missing but ROADMAP.md and board are available."
+    echo "  Run /mgw:project to reconstruct full project state."
+    echo "  (Board state has been pulled — active issues are available)"
+  fi
+
+  # 4. Rebuild context cache from GitHub issue comments
+  echo "  Rebuilding context cache from GitHub issue comments..."
+  node -e "
+const ic = require('${REPO_ROOT}/lib/issue-context.cjs');
+ic.rebuildContextCache()
+  .then(stats => console.log('  Cached summaries for', stats.issueCount, 'issues across', stats.milestoneCount, 'milestones'))
+  .catch(e => console.error('  Cache rebuild failed:', e.message));
+" 2>/dev/null || echo "  Context cache rebuild skipped (issue-context module not available)"
+
+  # 5. Refresh Project README with current milestone progress
+  echo "  Refreshing Project README..."
+  node -e "
+const ic = require('${REPO_ROOT}/lib/issue-context.cjs');
+ic.updateProjectReadme()
+  .then(ok => console.log(ok ? '  Project README updated' : '  Project README skipped (no board configured)'))
+  .catch(() => console.log('  Project README refresh skipped'));
+" 2>/dev/null || true
+fi
+```
+</step>
+
 <step name="scan_active">
 **Scan all active issue states:**
 

package/commands/workflows/gsd.md

@@ -364,24 +364,12 @@ and codebase to classify, then MGW presents the result and offers follow-up acti
 - **NEVER** let MGW read application source code directly — spawn an analysis agent
 - **NEVER** omit `subagent_type` from a Task() call — always specify the agent type
 
-## Consumers
-
-| Pattern | Referenced By |
-|---------|-------------|
-| Standard spawn template | run.md, issue.md, pr.md, ask.md, review.md |
-| Comment classification | run.md (pre-flight), review.md (standalone) |
-| Quick pipeline | run.md |
-| Milestone pipeline | run.md, milestone.md |
-| Question classification | ask.md |
-| Model resolution | run.md |
-TB|## PR Review Pattern
+## PR Review Pattern
 
 MGW:review has two modes:
 1. **Issue Comment Review** (default) — Classifies new comments on an issue since triage
 2. **PR Deep Review** (with --pr flag or PR URL) — Comprehensive senior engineer review
 
-The PR Deep Review pattern below is for Mode 2. This is problem-solving orchestration
-
 Used by `/mgw:review` for deep PR analysis. This is problem-solving orchestration
 (not execution orchestration) — the reviewer has high autonomy to analyze, question
 assumptions, and provide architectural guidance.

package/dist/bin/mgw.cjs

@@ -1,17 +1,18 @@
 #!/usr/bin/env node
 'use strict';
 
-var index = require('../index-BiwU0uWA.cjs');
+var index = require('../index-B-_JvYpz.cjs');
 var require$$0 = require('commander');
 var require$$1 = require('path');
-var require$$0$2 = require('fs');
+var require$$2 = require('fs');
 var require$$0$1 = require('child_process');
+require('os');
 require('events');
 
 var mgw$1 = {};
 
-var version = "0.2.2";
-var require$$10 = {
+var version = "0.4.0";
+var require$$11 = {
 	version: version};
 
 var hasRequiredMgw;
@@ -21,17 +22,18 @@ function requireMgw () {
 	hasRequiredMgw = 1;
 	const { Command } = require$$0;
 	const path = require$$1;
-	const fs = require$$0$2;
+	const fs = require$$2;
 	const { execSync } = require$$0$1;
-	const { assertClaudeAvailable, invokeClaude, getCommandsDir } = index.requireClaude();
+	const { ProviderManager } = index.requireProviderManager();
 	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 { startTimer } = index.requireLogger();
+	const pkg = require$$11;
 	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");
+	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").option("--provider <provider>", "AI provider override (default: claude)");
 	const STAGE_LABELS = {
 	  run: "pipeline",
 	  init: "init",
@@ -43,15 +45,21 @@ function requireMgw () {
 	  next: "next"
 	};
 	async function runAiCommand(commandName, userPrompt, opts) {
-	  assertClaudeAvailable();
-	  const cmdFile = path.join(getCommandsDir(), `${commandName}.md`);
+	  const provider = ProviderManager.getProvider(opts.provider);
+	  provider.assertAvailable();
+	  const cmdFile = path.join(provider.getCommandsDir(), `${commandName}.md`);
 	  const stageLabel = STAGE_LABELS[commandName] || commandName;
+	  const issueMatch = String(userPrompt).match(/^\d+/);
+	  const timer = startTimer({
+	    command: commandName,
+	    issue: issueMatch ? parseInt(issueMatch[0], 10) : void 0
+	  });
 	  if (opts.quiet) {
 	    const spinner = createSpinner(`mgw:${stageLabel}`);
 	    spinner.start();
 	    let result;
 	    try {
-	      result = await invokeClaude(cmdFile, userPrompt, {
+	      result = await provider.invoke(cmdFile, userPrompt, {
 	        model: opts.model,
 	        quiet: true,
 	        dryRun: opts.dryRun,
@@ -59,12 +67,15 @@ function requireMgw () {
 	      });
 	    } catch (err) {
 	      spinner.fail(`${stageLabel} failed`);
+	      timer.finish("error", err.message);
 	      throw err;
 	    }
 	    if (result.exitCode === 0) {
 	      spinner.succeed(`${stageLabel} complete`);
+	      timer.finish("ok");
 	    } else {
 	      spinner.fail(`${stageLabel} failed (exit ${result.exitCode})`);
+	      timer.finish("error", `exit ${result.exitCode}`);
 	    }
 	    if (result.output) {
 	      process.stdout.write(result.output);
@@ -75,12 +86,13 @@ function requireMgw () {
 	    spinner.start();
 	    await new Promise((r) => setTimeout(r, 80));
 	    spinner.stop();
-	    const result = await invokeClaude(cmdFile, userPrompt, {
+	    const result = await provider.invoke(cmdFile, userPrompt, {
 	      model: opts.model,
 	      quiet: false,
 	      dryRun: opts.dryRun,
 	      json: opts.json
 	    });
+	    timer.finish(result.exitCode === 0 ? "ok" : "error", result.exitCode !== 0 ? `exit ${result.exitCode}` : void 0);
 	    process.exitCode = result.exitCode;
 	  }
 	}
@@ -150,6 +162,7 @@ function requireMgw () {
 	});
 	program.command("sync").description("Reconcile .mgw/ state with GitHub").action(async function() {
 	  const opts = this.optsWithGlobals();
+	  const syncTimer = startTimer({ command: "sync" });
 	  const activeDir = getActiveDir();
 	  if (!fs.existsSync(activeDir)) {
 	    if (opts.json) {
@@ -192,7 +205,7 @@ function requireMgw () {
 	    }
 	    let ghIssue;
 	    try {
-	      ghIssue = getIssue(number);
+	      ghIssue = await getIssue(number);
 	    } catch (err) {
 	      error(`Failed to fetch issue #${number} from GitHub: ${err.message}`);
 	      results.push({ number, file, status: "error", error: err.message });
@@ -234,6 +247,7 @@ function requireMgw () {
 	    const ok = results.filter((r) => r.status === "ok").length;
 	    log(`sync complete: ${ok} up-to-date, ${archived} archived`);
 	  }
+	  syncTimer.finish("ok");
 	});
 	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();
@@ -248,7 +262,7 @@ function requireMgw () {
 	  if (opts.milestone) ghFilters.milestone = opts.milestone;
 	  let issues;
 	  try {
-	    issues = listIssues(ghFilters);
+	    issues = await listIssues(ghFilters);
 	  } catch (err) {
 	    error("Failed to list issues: " + err.message);
 	    process.exitCode = 1;
@@ -343,8 +357,86 @@ function requireMgw () {
 	    log("Linked: " + refA + " <-> " + refB);
 	  }
 	});
+	program.command("log").description("Query execution logs").option("--since <period>", "time period: 1d, 7d, 30d, or ISO date").option("--issue <number>", "filter by issue number").option("--command <name>", "filter by command name").option("--limit <n>", "max entries (default: 50)", "50").option("--metrics", "show aggregated metrics instead of log entries").action(function() {
+	  const opts = this.optsWithGlobals();
+	  const { readLogs, aggregateMetrics } = index.requireLogger();
+	  const logOpts = {
+	    since: opts.since,
+	    issue: opts.issue ? parseInt(opts.issue, 10) : void 0,
+	    command: opts.command,
+	    limit: opts.metrics ? void 0 : parseInt(opts.limit, 10) || 50
+	  };
+	  const entries = readLogs(logOpts);
+	  if (opts.metrics) {
+	    const metrics = aggregateMetrics(entries);
+	    if (opts.json) {
+	      log(formatJson(metrics));
+	    } else {
+	      log(`Total invocations: ${metrics.total}`);
+	      log(`Avg duration: ${metrics.avgDuration}ms`);
+	      log(`Failure rate: ${metrics.failureRate}%`);
+	      log("");
+	      log("By command:");
+	      for (const [cmd, stats] of Object.entries(metrics.byCommand)) {
+	        log(`  ${cmd}: ${stats.count} calls, ${stats.errors} errors, avg ${stats.avgDuration}ms`);
+	      }
+	    }
+	    return;
+	  }
+	  if (entries.length === 0) {
+	    log("No log entries found.");
+	    return;
+	  }
+	  if (opts.json) {
+	    log(formatJson(entries));
+	    return;
+	  }
+	  for (const e of entries) {
+	    const ts = e.timestamp ? e.timestamp.slice(0, 19).replace("T", " ") : "?";
+	    const issue = e.issue ? `#${e.issue}` : "";
+	    const dur = typeof e.duration_ms === "number" ? `${e.duration_ms}ms` : "";
+	    const status = e.status === "error" ? `ERR: ${e.error || "unknown"}` : e.status;
+	    log(`${ts}  ${(e.command || "").padEnd(12)} ${issue.padEnd(6)} ${dur.padEnd(8)} ${status}`);
+	  }
+	});
+	program.command("metrics").description("Show execution metrics \u2014 success rates, durations, command usage").option("--since <period>", "time period: 1d, 7d, 30d, or ISO date (default: 7d)", "7d").option("--issue <number>", "filter by issue number").option("--command <name>", "filter by command name").action(function() {
+	  const opts = this.optsWithGlobals();
+	  const { readLogs, aggregateMetrics } = index.requireLogger();
+	  const { USE_COLOR, COLORS } = index.requireOutput();
+	  const logOpts = {
+	    since: opts.since,
+	    issue: opts.issue ? parseInt(opts.issue, 10) : void 0,
+	    command: opts.command
+	  };
+	  const entries = readLogs(logOpts);
+	  const metrics = aggregateMetrics(entries);
+	  if (opts.json) {
+	    log(formatJson(metrics));
+	    return;
+	  }
+	  if (metrics.total === 0) {
+	    log("No log entries found for the given period.");
+	    return;
+	  }
+	  const dim = USE_COLOR ? COLORS.dim : "";
+	  const bold = USE_COLOR ? COLORS.bold : "";
+	  const reset = USE_COLOR ? COLORS.reset : "";
+	  log(`${bold}Execution Metrics${reset} ${dim}(${opts.since})${reset}`);
+	  log("");
+	  log(`  Total invocations:  ${metrics.total}`);
+	  log(`  Avg duration:       ${metrics.avgDuration}ms`);
+	  log(`  Failure rate:       ${metrics.failureRate}%`);
+	  log("");
+	  log(`${bold}By Command${reset}`);
+	  log(`${"  Command".padEnd(16)} ${"Calls".padEnd(8)} ${"Errors".padEnd(8)} ${"Avg ms".padEnd(10)}`);
+	  log(`  ${dim}${"\u2500".repeat(38)}${reset}`);
+	  for (const [cmd, stats] of Object.entries(metrics.byCommand)) {
+	    log(`  ${cmd.padEnd(14)} ${String(stats.count).padEnd(8)} ${String(stats.errors).padEnd(8)} ${String(stats.avgDuration).padEnd(10)}`);
+	  }
+	});
 	program.command("help").description("Show command reference").action(function() {
-	  const helpMdPath = path.join(getCommandsDir(), "help.md");
+	  const opts = this.optsWithGlobals();
+	  const helpMdPath = path.join(ProviderManager.getProvider(opts.provider).getCommandsDir(), "help.md");
 	  let helpText;
 	  try {
 	    const raw = fs.readFileSync(helpMdPath, "utf-8");