@snipcodeit/mgw 0.2.1 → 0.3.0

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,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 
-var index = require('../index-CXfe9U4l.cjs');
+var index = require('../index-s7v-ifd0.cjs');
 var require$$0 = require('commander');
 var require$$1 = require('path');
 var require$$0$2 = require('fs');
@@ -10,8 +10,8 @@ require('events');
 
 var mgw$1 = {};
 
-var version = "0.2.1";
-var require$$10 = {
+var version = "0.3.0";
+var require$$11 = {
 	version: version};
 
 var hasRequiredMgw;
@@ -29,7 +29,8 @@ function requireMgw () {
 	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");
 	const STAGE_LABELS = {
@@ -46,6 +47,11 @@ function requireMgw () {
 	  assertClaudeAvailable();
 	  const cmdFile = path.join(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();
@@ -59,12 +65,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);
@@ -81,6 +90,7 @@ function requireMgw () {
 	      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 +160,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 +203,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 +245,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 +260,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,6 +355,83 @@ 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");
 	  let helpText;