@snipcodeit/mgw 0.3.0 → 0.4.0

package/commands/run/worktree.md

@@ -12,6 +12,47 @@ BRANCH_NAME="issue/${ISSUE_NUMBER}-${slug}"
 WORKTREE_DIR="${REPO_ROOT}/.worktrees/${BRANCH_NAME}"
 ```
 
+**Check for active work on this issue by another developer:**
+```bash
+# Check 1: Remote branch already exists (another machine pushed work)
+REMOTE_BRANCHES=$(git ls-remote --heads origin "issue/${ISSUE_NUMBER}-*" 2>/dev/null | awk '{print $2}' | sed 's|refs/heads/||')
+if [ -n "$REMOTE_BRANCHES" ]; then
+  echo "WARNING: Remote branch(es) already exist for issue #${ISSUE_NUMBER}:"
+  echo "$REMOTE_BRANCHES" | sed 's/^/  /'
+  echo ""
+  AskUserQuestion(
+    header: "Active Work Detected",
+    question: "Remote branch exists for #${ISSUE_NUMBER}. Another developer may be working on this. Proceed anyway?",
+    options: [
+      { label: "Proceed", description: "Create a new worktree anyway (may cause conflicts)" },
+      { label: "Abort", description: "Stop pipeline — coordinate with the other developer first" }
+    ]
+  )
+  if [ "$USER_CHOICE" = "Abort" ]; then
+    echo "Pipeline aborted — coordinate with the developer who owns the existing branch."
+    exit 1
+  fi
+fi
+
+# Check 2: Open PR already exists for this issue
+EXISTING_PR=$(gh pr list --search "issue/${ISSUE_NUMBER}-" --state open --json number,headRefName --jq '.[0].number' 2>/dev/null || echo "")
+if [ -n "$EXISTING_PR" ]; then
+  echo "WARNING: Open PR #${EXISTING_PR} already exists for issue #${ISSUE_NUMBER}."
+  echo "Creating a new worktree will produce a conflicting PR."
+  AskUserQuestion(
+    header: "Open PR Exists",
+    question: "PR #${EXISTING_PR} is already open for this issue. Proceed with a new worktree?",
+    options: [
+      { label: "Proceed", description: "Create new worktree anyway" },
+      { label: "Abort", description: "Stop — review the existing PR first" }
+    ]
+  )
+  if [ "$USER_CHOICE" = "Abort" ]; then
+    exit 1
+  fi
+fi
+```
+
 Ensure .worktrees/ is gitignored:
 ```bash
 mkdir -p "$(dirname "${WORKTREE_DIR}")"

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/dist/bin/mgw.cjs

@@ -1,16 +1,17 @@
 #!/usr/bin/env node
 'use strict';
 
-var index = require('../index-s7v-ifd0.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.3.0";
+var version = "0.4.0";
 var require$$11 = {
 	version: version};
 
@@ -21,9 +22,9 @@ 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();
@@ -32,7 +33,7 @@ function requireMgw () {
 	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",
@@ -44,8 +45,9 @@ 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({
@@ -57,7 +59,7 @@ function requireMgw () {
 	    spinner.start();
 	    let result;
 	    try {
-	      result = await invokeClaude(cmdFile, userPrompt, {
+	      result = await provider.invoke(cmdFile, userPrompt, {
 	        model: opts.model,
 	        quiet: true,
 	        dryRun: opts.dryRun,
@@ -84,7 +86,7 @@ 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,
@@ -433,7 +435,8 @@ function requireMgw () {
 	  }
 	});
 	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");

package/dist/{index-s7v-ifd0.cjs → index-B-_JvYpz.cjs}

@@ -1,9 +1,10 @@
 'use strict';
 
-var require$$0 = require('fs');
+var require$$2 = require('fs');
 var require$$1 = require('path');
-var require$$0$1 = require('child_process');
-var require$$0$2 = require('events');
+var require$$0 = require('child_process');
+var require$$3 = require('os');
+var require$$0$1 = require('events');
 
 function getDefaultExportFromCjs(x) {
   return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
@@ -15,7 +16,7 @@ var hasRequiredState;
 function requireState () {
 	if (hasRequiredState) return state;
 	hasRequiredState = 1;
-	const fs = require$$0;
+	const fs = require$$2;
 	const path = require$$1;
 	function getMgwDir() {
 	  return path.join(process.cwd(), ".mgw");
@@ -586,7 +587,7 @@ var hasRequiredGithub;
 function requireGithub () {
 	if (hasRequiredGithub) return github;
 	hasRequiredGithub = 1;
-	const { execSync } = require$$0$1;
+	const { execSync } = require$$0;
 	const { TimeoutError, GitHubApiError } = requireErrors();
 	const { withRetry } = requireRetry();
 	const GH_TIMEOUT_MS = 3e4;
@@ -957,16 +958,17 @@ function requireOutput () {
 	return output;
 }
 
-var claude;
-var hasRequiredClaude;
+var providerClaude;
+var hasRequiredProviderClaude;
 
-function requireClaude () {
-	if (hasRequiredClaude) return claude;
-	hasRequiredClaude = 1;
-	const { execSync, spawn } = require$$0$1;
+function requireProviderClaude () {
+	if (hasRequiredProviderClaude) return providerClaude;
+	hasRequiredProviderClaude = 1;
+	const { execSync, spawn } = require$$0;
 	const path = require$$1;
-	const fs = require$$0;
+	const fs = require$$2;
 	const { ClaudeNotAvailableError, TimeoutError } = requireErrors();
+	const PROVIDER_ID = "claude";
 	function getCommandsDir() {
 	  const dir = path.join(__dirname, "..", "commands");
 	  if (!fs.existsSync(dir)) {
@@ -977,7 +979,7 @@ This may indicate a corrupted installation. Try reinstalling mgw.`
 	  }
 	  return dir;
 	}
-	function assertClaudeAvailable() {
+	function assertAvailable() {
 	  try {
 	    execSync("claude --version", {
 	      encoding: "utf-8",
@@ -1021,7 +1023,7 @@ This may indicate a corrupted installation. Try reinstalling mgw.`
 	    );
 	  }
 	}
-	function invokeClaude(commandFile, userPrompt, opts) {
+	function invoke(commandFile, userPrompt, opts) {
 	  const o = opts || {};
 	  const args = ["-p"];
 	  if (commandFile) {
@@ -1071,12 +1073,204 @@ This may indicate a corrupted installation. Try reinstalling mgw.`
 	    });
 	  });
 	}
-	claude = {
-	  assertClaudeAvailable,
-	  invokeClaude,
-	  getCommandsDir
+	providerClaude = { PROVIDER_ID, assertAvailable, invoke, getCommandsDir };
+	return providerClaude;
+}
+
+var providerGemini;
+var hasRequiredProviderGemini;
+
+function requireProviderGemini () {
+	if (hasRequiredProviderGemini) return providerGemini;
+	hasRequiredProviderGemini = 1;
+	const { execSync, spawn } = require$$0;
+	const path = require$$1;
+	const fs = require$$2;
+	const os = require$$3;
+	const PROVIDER_ID = "gemini";
+	function getCommandsDir() {
+	  const dir = path.join(os.homedir(), ".gemini", "commands", "mgw");
+	  if (!fs.existsSync(dir)) {
+	    throw new Error(
+	      `Commands directory not found at: ${dir}
+Run: node bin/mgw-install.cjs --provider gemini
+(or reinstall the mgw package to trigger postinstall)`
+	    );
+	  }
+	  return dir;
+	}
+	function assertAvailable() {
+	  try {
+	    execSync("gemini --version", {
+	      encoding: "utf-8",
+	      stdio: ["pipe", "pipe", "pipe"]
+	    });
+	  } catch (err) {
+	    if (err.code === "ENOENT") {
+	      console.error(
+	        "Error: gemini CLI is not installed.\n\nInstall it with:\n  npm install -g @google/gemini-cli\n\nThen run:\n  gemini auth"
+	      );
+	    } else {
+	      console.error(
+	        "Error: gemini CLI check failed.\nEnsure gemini is installed and on your PATH."
+	      );
+	    }
+	    process.exit(1);
+	  }
+	}
+	function invoke(commandFile, userPrompt, opts) {
+	  const o = opts || {};
+	  if (o.dryRun) {
+	    const dryArgs = ["-p"];
+	    if (o.model) dryArgs.push("--model", o.model);
+	    dryArgs.push(commandFile ? "<system>" + commandFile + "</system> " + (userPrompt || "run") : userPrompt || "run");
+	    console.log("Would invoke: gemini " + dryArgs.join(" "));
+	    return Promise.resolve({ exitCode: 0, output: "" });
+	  }
+	  let effectivePrompt = userPrompt || "run";
+	  if (commandFile) {
+	    const fileContents = fs.readFileSync(commandFile, "utf-8");
+	    effectivePrompt = "<system>\n" + fileContents + "\n</system>\n\n" + effectivePrompt;
+	  }
+	  const args = ["-p"];
+	  if (o.model) {
+	    args.push("--model", o.model);
+	  }
+	  args.push(effectivePrompt);
+	  return new Promise((resolve, reject) => {
+	    const stdio = o.quiet ? ["pipe", "pipe", "pipe"] : ["inherit", "inherit", "inherit"];
+	    const child = spawn("gemini", args, { stdio });
+	    let output = "";
+	    if (o.quiet) {
+	      child.stdout.on("data", function(chunk) {
+	        output += chunk.toString();
+	      });
+	      child.stderr.on("data", function(chunk) {
+	        output += chunk.toString();
+	      });
+	    }
+	    child.on("error", function(err) {
+	      if (err.code === "ENOENT") {
+	        reject(new Error("gemini CLI not found. Install with: npm install -g @google/gemini-cli"));
+	      } else {
+	        reject(err);
+	      }
+	    });
+	    child.on("close", function(code) {
+	      resolve({ exitCode: code || 0, output });
+	    });
+	  });
+	}
+	providerGemini = { PROVIDER_ID, assertAvailable, invoke, getCommandsDir };
+	return providerGemini;
+}
+
+var providerOpencode;
+var hasRequiredProviderOpencode;
+
+function requireProviderOpencode () {
+	if (hasRequiredProviderOpencode) return providerOpencode;
+	hasRequiredProviderOpencode = 1;
+	const { execSync, spawn } = require$$0;
+	const path = require$$1;
+	const fs = require$$2;
+	const os = require$$3;
+	const PROVIDER_ID = "opencode";
+	function getCommandsDir() {
+	  const dir = path.join(os.homedir(), ".opencode", "commands", "mgw");
+	  if (!fs.existsSync(dir)) {
+	    throw new Error(
+	      "Commands directory not found at: " + dir + "\nRun: node bin/mgw-install.cjs --provider opencode\n(or reinstall the mgw package to trigger postinstall)"
+	    );
+	  }
+	  return dir;
+	}
+	function assertAvailable() {
+	  try {
+	    execSync("opencode --version", {
+	      encoding: "utf-8",
+	      stdio: ["pipe", "pipe", "pipe"]
+	    });
+	  } catch (err) {
+	    if (err.code === "ENOENT") {
+	      console.error(
+	        "Error: opencode CLI is not installed.\n\nInstall it with:\n  npm install -g opencode-ai\n\n(or see https://opencode.ai for installation instructions)"
+	      );
+	    } else {
+	      console.error(
+	        "Error: opencode CLI check failed.\nEnsure opencode is installed and on your PATH."
+	      );
+	    }
+	    process.exit(1);
+	  }
+	}
+	function invoke(commandFile, userPrompt, opts) {
+	  const o = opts || {};
+	  const args = ["run"];
+	  if (commandFile) {
+	    args.push("--system-prompt", commandFile);
+	  }
+	  if (o.model) {
+	    args.push("--model", o.model);
+	  }
+	  args.push(userPrompt || "run");
+	  if (o.dryRun) {
+	    console.log("Would invoke: opencode " + args.join(" "));
+	    return Promise.resolve({ exitCode: 0, output: "" });
+	  }
+	  return new Promise(function(resolve, reject) {
+	    const stdio = o.quiet ? ["pipe", "pipe", "pipe"] : ["inherit", "inherit", "inherit"];
+	    const child = spawn("opencode", args, { stdio });
+	    let output = "";
+	    if (o.quiet) {
+	      child.stdout.on("data", function(chunk) {
+	        output += chunk.toString();
+	      });
+	      child.stderr.on("data", function(chunk) {
+	        output += chunk.toString();
+	      });
+	    }
+	    child.on("error", function(err) {
+	      if (err.code === "ENOENT") {
+	        reject(new Error("opencode CLI not found. See https://opencode.ai for installation instructions."));
+	      } else {
+	        reject(err);
+	      }
+	    });
+	    child.on("close", function(code) {
+	      resolve({ exitCode: code || 0, output });
+	    });
+	  });
+	}
+	providerOpencode = { PROVIDER_ID, assertAvailable, invoke, getCommandsDir };
+	return providerOpencode;
+}
+
+var providerManager;
+var hasRequiredProviderManager;
+
+function requireProviderManager () {
+	if (hasRequiredProviderManager) return providerManager;
+	hasRequiredProviderManager = 1;
+	const registry = {
+	  claude: requireProviderClaude(),
+	  gemini: requireProviderGemini(),
+	  opencode: requireProviderOpencode()
 	};
-	return claude;
+	function getProvider(providerId) {
+	  const id = providerId || "claude";
+	  const provider = registry[id];
+	  if (!provider) {
+	    const available = Object.keys(registry).join(", ");
+	    throw new Error(`Unknown provider: "${id}". Available: ${available}`);
+	  }
+	  return provider;
+	}
+	function listProviders() {
+	  return Object.keys(registry);
+	}
+	providerManager = { ProviderManager: { getProvider, listProviders } };
+	return providerManager;
 }
 
 var spinner;
@@ -1187,7 +1381,7 @@ function requireLogger () {
 	if (hasRequiredLogger) return logger;
 	hasRequiredLogger = 1;
 	const path = require$$1;
-	const fs = require$$0;
+	const fs = require$$2;
 	function getLogDir(repoRoot) {
 	  const root = repoRoot || process.cwd();
 	  const logDir = path.join(root, ".mgw", "logs");
@@ -1807,7 +2001,7 @@ var hasRequiredKeyboard;
 function requireKeyboard () {
 	if (hasRequiredKeyboard) return keyboard;
 	hasRequiredKeyboard = 1;
-	const { EventEmitter } = require$$0$2;
+	const { EventEmitter } = require$$0$1;
 	const DEFAULT_BINDINGS = {
 	  // Scroll
 	  "j": "scroll-down",
@@ -2426,11 +2620,12 @@ function requireTui () {
 }
 
 exports.getDefaultExportFromCjs = getDefaultExportFromCjs;
-exports.requireClaude = requireClaude;
 exports.requireErrors = requireErrors;
 exports.requireGithub = requireGithub;
 exports.requireLogger = requireLogger;
 exports.requireOutput = requireOutput;
+exports.requireProviderClaude = requireProviderClaude;
+exports.requireProviderManager = requireProviderManager;
 exports.requireRetry = requireRetry;
 exports.requireSpinner = requireSpinner;
 exports.requireState = requireState;