@snipcodeit/mgw 0.2.2 → 0.3.0

package/dist/lib/index.cjs

@@ -1,12 +1,150 @@
 'use strict';
 
-var index$1 = require('../index-BiwU0uWA.cjs');
+var index$1 = require('../index-s7v-ifd0.cjs');
 var require$$0 = require('child_process');
 var require$$1 = require('path');
 var require$$2 = require('os');
 var require$$0$1 = require('fs');
 require('events');
 
+var pipeline;
+var hasRequiredPipeline;
+
+function requirePipeline () {
+	if (hasRequiredPipeline) return pipeline;
+	hasRequiredPipeline = 1;
+	const STAGES = {
+	  NEW: "new",
+	  TRIAGED: "triaged",
+	  NEEDS_INFO: "needs-info",
+	  NEEDS_SECURITY_REVIEW: "needs-security-review",
+	  DISCUSSING: "discussing",
+	  APPROVED: "approved",
+	  PLANNING: "planning",
+	  DIAGNOSING: "diagnosing",
+	  EXECUTING: "executing",
+	  VERIFYING: "verifying",
+	  PR_CREATED: "pr-created",
+	  DONE: "done",
+	  FAILED: "failed",
+	  BLOCKED: "blocked"
+	};
+	const STAGE_SET = new Set(Object.values(STAGES));
+	const VALID_TRANSITIONS = {
+	  [STAGES.NEW]: [STAGES.TRIAGED],
+	  [STAGES.TRIAGED]: [STAGES.NEEDS_INFO, STAGES.NEEDS_SECURITY_REVIEW, STAGES.DISCUSSING, STAGES.APPROVED, STAGES.PLANNING, STAGES.DIAGNOSING],
+	  [STAGES.NEEDS_INFO]: [STAGES.TRIAGED],
+	  [STAGES.NEEDS_SECURITY_REVIEW]: [STAGES.TRIAGED, STAGES.APPROVED],
+	  [STAGES.DISCUSSING]: [STAGES.TRIAGED, STAGES.APPROVED],
+	  [STAGES.APPROVED]: [STAGES.PLANNING],
+	  [STAGES.PLANNING]: [STAGES.EXECUTING],
+	  [STAGES.DIAGNOSING]: [STAGES.PLANNING],
+	  [STAGES.EXECUTING]: [STAGES.VERIFYING],
+	  [STAGES.VERIFYING]: [STAGES.PR_CREATED, STAGES.EXECUTING],
+	  [STAGES.PR_CREATED]: [STAGES.DONE],
+	  [STAGES.DONE]: [],
+	  [STAGES.FAILED]: [STAGES.NEW, STAGES.TRIAGED, STAGES.PLANNING, STAGES.EXECUTING],
+	  [STAGES.BLOCKED]: [STAGES.NEW, STAGES.TRIAGED, STAGES.PLANNING, STAGES.EXECUTING]
+	};
+	for (const stage of Object.keys(VALID_TRANSITIONS)) {
+	  if (stage !== STAGES.DONE && stage !== STAGES.FAILED && stage !== STAGES.BLOCKED) {
+	    VALID_TRANSITIONS[stage].push(STAGES.FAILED, STAGES.BLOCKED);
+	  }
+	}
+	const STAGE_ICONS = {
+	  [STAGES.NEW]: "\u25CB",
+	  [STAGES.TRIAGED]: "\u25C7",
+	  [STAGES.NEEDS_INFO]: "?",
+	  [STAGES.NEEDS_SECURITY_REVIEW]: "\u2691",
+	  [STAGES.DISCUSSING]: "\u{1F4AC}",
+	  [STAGES.APPROVED]: "\u2714",
+	  [STAGES.PLANNING]: "\u25C6",
+	  [STAGES.DIAGNOSING]: "\u{1F50D}",
+	  [STAGES.EXECUTING]: "\u25C6",
+	  [STAGES.VERIFYING]: "\u25C6",
+	  [STAGES.PR_CREATED]: "\u2713",
+	  [STAGES.DONE]: "\u2713",
+	  [STAGES.FAILED]: "\u2717",
+	  [STAGES.BLOCKED]: "\u2298"
+	};
+	const STAGE_LABELS = {
+	  [STAGES.NEW]: "New",
+	  [STAGES.TRIAGED]: "Triaged",
+	  [STAGES.NEEDS_INFO]: "Needs Info",
+	  [STAGES.NEEDS_SECURITY_REVIEW]: "Needs Security Review",
+	  [STAGES.DISCUSSING]: "Discussing",
+	  [STAGES.APPROVED]: "Approved",
+	  [STAGES.PLANNING]: "Planning",
+	  [STAGES.DIAGNOSING]: "Diagnosing",
+	  [STAGES.EXECUTING]: "Executing",
+	  [STAGES.VERIFYING]: "Verifying",
+	  [STAGES.PR_CREATED]: "PR Created",
+	  [STAGES.DONE]: "Done",
+	  [STAGES.FAILED]: "Failed",
+	  [STAGES.BLOCKED]: "Blocked"
+	};
+	function isValidStage(stage) {
+	  return STAGE_SET.has(stage);
+	}
+	function isValidTransition(from, to) {
+	  if (!isValidStage(from) || !isValidStage(to)) return false;
+	  const allowed = VALID_TRANSITIONS[from];
+	  return Array.isArray(allowed) && allowed.includes(to);
+	}
+	const _hooks = [];
+	function onTransition(fn) {
+	  _hooks.push(fn);
+	  return () => {
+	    const idx = _hooks.indexOf(fn);
+	    if (idx !== -1) _hooks.splice(idx, 1);
+	  };
+	}
+	function transitionStage(issueState, newStage, context) {
+	  const currentStage = issueState && issueState.pipeline_stage || STAGES.NEW;
+	  if (!isValidStage(newStage)) {
+	    throw new Error(`Invalid target stage: "${newStage}"`);
+	  }
+	  if (currentStage === newStage) {
+	    throw new Error(`Already at stage "${newStage}" \u2014 self-transitions are not allowed`);
+	  }
+	  if (!isValidTransition(currentStage, newStage)) {
+	    throw new Error(
+	      `Invalid transition: "${currentStage}" \u2192 "${newStage}". Allowed targets: [${(VALID_TRANSITIONS[currentStage] || []).join(", ")}]`
+	    );
+	  }
+	  const newState = Object.assign({}, issueState, {
+	    pipeline_stage: newStage,
+	    last_transition: (/* @__PURE__ */ new Date()).toISOString(),
+	    previous_stage: currentStage
+	  });
+	  const ctx = context || {};
+	  for (const hook of _hooks) {
+	    try {
+	      hook(currentStage, newStage, ctx);
+	    } catch (err) {
+	      process.stderr.write(`[pipeline] hook error: ${err.message}
+`);
+	    }
+	  }
+	  return newState;
+	}
+	function clearHooks() {
+	  _hooks.length = 0;
+	}
+	pipeline = {
+	  STAGES,
+	  VALID_TRANSITIONS,
+	  STAGE_ICONS,
+	  STAGE_LABELS,
+	  isValidStage,
+	  isValidTransition,
+	  transitionStage,
+	  onTransition,
+	  clearHooks
+	};
+	return pipeline;
+}
+
 var gsdAdapter;
 var hasRequiredGsdAdapter;
 
@@ -17,6 +155,8 @@ function requireGsdAdapter () {
 	const path = require$$1;
 	const os = require$$2;
 	const fs = require$$0$1;
+	const { TimeoutError, GsdToolError } = index$1.requireErrors();
+	const { STAGES } = requirePipeline();
 	function getGsdToolsPath() {
 	  const standard = path.join(
 	    os.homedir(),
@@ -33,6 +173,7 @@ function requireGsdAdapter () {
 Ensure the get-shit-done framework is installed at ~/.claude/get-shit-done/`
 	  );
 	}
+	const GSD_TIMEOUT_MS = 15e3;
 	function invokeGsdTool(command, args) {
 	  const toolPath = getGsdToolsPath();
 	  const argsStr = Array.isArray(args) ? args.map((a) => JSON.stringify(String(a))).join(" ") : "";
@@ -41,13 +182,21 @@ Ensure the get-shit-done framework is installed at ~/.claude/get-shit-done/`
 	  try {
 	    raw = execSync(cmd, {
 	      encoding: "utf-8",
-	      stdio: ["pipe", "pipe", "pipe"]
+	      stdio: ["pipe", "pipe", "pipe"],
+	      timeout: GSD_TIMEOUT_MS
 	    }).trim();
 	  } catch (err) {
+	    if (err.killed) {
+	      throw new TimeoutError(
+	        `GSD tool timed out after ${GSD_TIMEOUT_MS / 1e3}s: ${command}`,
+	        { timeoutMs: GSD_TIMEOUT_MS, operation: `gsd-tools ${command}` }
+	      );
+	    }
 	    const stderr = err.stderr ? err.stderr.trim() : "";
-	    throw new Error(
+	    throw new GsdToolError(
 	      `GSD tool command failed: ${command}
-` + (stderr ? `stderr: ${stderr}` : `exit code: ${err.status}`)
+` + (stderr ? `stderr: ${stderr}` : `exit code: ${err.status}`),
+	      { command, cause: err }
 	    );
 	  }
 	  if (!raw) return null;
@@ -89,13 +238,13 @@ Ensure the get-shit-done framework is installed at ~/.claude/get-shit-done/`
 	  if (/gsd-route:diagnose|needs-diagnosis/.test(labelStr)) {
 	    return "diagnose";
 	  }
-	  if (stage === "diagnosing") {
+	  if (stage === STAGES.DIAGNOSING) {
 	    return "diagnose";
 	  }
-	  if (stage === "executing") {
+	  if (stage === STAGES.EXECUTING) {
 	    return "execute-only";
 	  }
-	  if (stage === "verifying") {
+	  if (stage === STAGES.VERIFYING) {
 	    return "verify-only";
 	  }
 	  if (projectState && projectState.milestones) ;
@@ -344,15 +493,15 @@ Checked: ` + path.join(__dirname, "..", "templates") + "\nChecked: " + path.join
 		    const nextMatch = nextSectionMatch.exec(content);
 		    const sectionEnd = nextMatch ? nextMatch.index : content.length;
 		    const sectionText = content.slice(sectionStart, sectionEnd);
-		    const goalMatch = sectionText.match(/\*\*Goal[:\*]*\*?\*?[:\s]+([^\n]+)/);
+		    const goalMatch = sectionText.match(/\*\*Goal[:*]*\*?\*?[:\s]+([^\n]+)/);
 		    const goal = goalMatch ? goalMatch[1].trim().replace(/\*+$/, "") : "";
-		    const reqMatch = sectionText.match(/\*\*Requirements?[:\*]*\*?\*?[:\s]+([\s\S]*?)(?=\n\*\*|\n###|$)/);
+		    const reqMatch = sectionText.match(/\*\*Requirements?[:*]*\*?\*?[:\s]+([\s\S]*?)(?=\n\*\*|\n###|$)/);
 		    let requirements = [];
 		    if (reqMatch) {
 		      const reqText = reqMatch[1].trim();
 		      requirements = reqText.split(/[,\n]+/).map((r) => r.trim().replace(/^[-*\s]+/, "").trim()).filter((r) => r.length > 0);
 		    }
-		    const scMatch = sectionText.match(/\*\*Success Criteria[:\*]*\*?\*?[:\s]+([\s\S]*?)(?=\n\*\*|\n###|$)/);
+		    const scMatch = sectionText.match(/\*\*Success Criteria[:*]*\*?\*?[:\s]+([\s\S]*?)(?=\n\*\*|\n###|$)/);
 		    let success_criteria = [];
 		    if (scMatch) {
 		      const scText = scMatch[1];
@@ -477,131 +626,14 @@ function requireTemplates () {
 	return templates;
 }
 
-var retry;
-var hasRequiredRetry;
-
-function requireRetry () {
-	if (hasRequiredRetry) return retry;
-	hasRequiredRetry = 1;
-	const MAX_RETRIES = 3;
-	const BACKOFF_BASE_MS = 5e3;
-	const BACKOFF_MAX_MS = 3e5;
-	const TRANSIENT_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
-	const TRANSIENT_MESSAGE_PATTERNS = [
-	  "network timeout",
-	  "econnreset",
-	  "econnrefused",
-	  "etimedout",
-	  "socket hang up",
-	  "worktree lock",
-	  "model overload",
-	  "rate limit",
-	  "too many requests",
-	  "service unavailable",
-	  "bad gateway",
-	  "gateway timeout"
-	];
-	const NEEDS_INFO_MESSAGE_PATTERNS = [
-	  "ambiguous",
-	  "missing required field",
-	  "contradictory requirements",
-	  "issue body"
-	];
-	function classifyFailure(error) {
-	  if (!error || typeof error !== "object") {
-	    return { class: "permanent", reason: "no error object provided" };
-	  }
-	  const status = error.status;
-	  const message = (error.message || "").toLowerCase();
-	  const code = (error.code || "").toLowerCase();
-	  if (typeof status === "number") {
-	    if (status === 429) {
-	      return { class: "transient", reason: "rate limit (HTTP 429)" };
-	    }
-	    if (TRANSIENT_STATUS_CODES.has(status)) {
-	      return { class: "transient", reason: `server error (HTTP ${status})` };
-	    }
-	    if (status === 403) {
-	      return { class: "permanent", reason: "forbidden (HTTP 403 \u2014 non-rate-limit)" };
-	    }
-	    if (status >= 400 && status < 500) {
-	      return { class: "permanent", reason: `client error (HTTP ${status})` };
-	    }
-	  }
-	  if (code) {
-	    const networkCodes = /* @__PURE__ */ new Set([
-	      "econnreset",
-	      "econnrefused",
-	      "etimedout",
-	      "enotfound",
-	      "epipe"
-	    ]);
-	    if (networkCodes.has(code)) {
-	      return { class: "transient", reason: `network error (${code.toUpperCase()})` };
-	    }
-	    if (code === "enoent") {
-	      return { class: "permanent", reason: "file not found (ENOENT) \u2014 GSD tools may be missing" };
-	    }
-	  }
-	  for (const pattern of TRANSIENT_MESSAGE_PATTERNS) {
-	    if (message.includes(pattern)) {
-	      return { class: "transient", reason: `transient condition detected: "${pattern}"` };
-	    }
-	  }
-	  for (const pattern of NEEDS_INFO_MESSAGE_PATTERNS) {
-	    if (message.includes(pattern)) {
-	      return { class: "needs-info", reason: `issue requires clarification: "${pattern}"` };
-	    }
-	  }
-	  return {
-	    class: "permanent",
-	    reason: "unknown error \u2014 classified as permanent to prevent runaway retries"
-	  };
-	}
-	function canRetry(issueState) {
-	  if (!issueState || typeof issueState !== "object") return false;
-	  if (issueState.dead_letter === true) return false;
-	  const count = typeof issueState.retry_count === "number" ? issueState.retry_count : 0;
-	  return count < MAX_RETRIES;
-	}
-	function incrementRetry(issueState) {
-	  const current = typeof issueState.retry_count === "number" ? issueState.retry_count : 0;
-	  return Object.assign({}, issueState, { retry_count: current + 1 });
-	}
-	function resetRetryState(issueState) {
-	  return Object.assign({}, issueState, {
-	    retry_count: 0,
-	    last_failure_class: null,
-	    dead_letter: false
-	  });
-	}
-	function getBackoffMs(retryCount) {
-	  const count = Math.max(0, Math.floor(retryCount));
-	  const base = Math.min(BACKOFF_MAX_MS, BACKOFF_BASE_MS * Math.pow(2, count));
-	  return Math.floor(Math.random() * (base + 1));
-	}
-	retry = {
-	  // Constants
-	  MAX_RETRIES,
-	  BACKOFF_BASE_MS,
-	  BACKOFF_MAX_MS,
-	  // Core functions
-	  classifyFailure,
-	  canRetry,
-	  incrementRetry,
-	  resetRetryState,
-	  getBackoffMs
-	};
-	return retry;
-}
-
 var progress;
 var hasRequiredProgress;
 
 function requireProgress () {
 	if (hasRequiredProgress) return progress;
 	hasRequiredProgress = 1;
-	const { IS_TTY, IS_CI, USE_COLOR } = index$1.requireOutput();
+	const { USE_COLOR } = index$1.requireOutput();
+	const { STAGES } = requirePipeline();
 	const SUPPORTS_COLOR = USE_COLOR;
 	const C = {
 	  reset: "\x1B[0m",
@@ -646,16 +678,16 @@ function requireProgress () {
 	}
 	function stageIcon(stage) {
 	  switch (stage) {
-	    case "done":
-	    case "pr-created":
+	    case STAGES.DONE:
+	    case STAGES.PR_CREATED:
 	      return { icon: "\u2713", colored: col(C.green, "\u2713") };
-	    case "executing":
-	    case "planning":
-	    case "verifying":
+	    case STAGES.EXECUTING:
+	    case STAGES.PLANNING:
+	    case STAGES.VERIFYING:
 	      return { icon: "\u25C6", colored: col(C.blue, "\u25C6") };
-	    case "failed":
+	    case STAGES.FAILED:
 	      return { icon: "\u2717", colored: col(C.red, "\u2717") };
-	    case "blocked":
+	    case STAGES.BLOCKED:
 	      return { icon: "\u2298", colored: col(C.yellow, "\u2298") };
 	    default:
 	      return { icon: "\u25CB", colored: col(C.dim, "\u25CB") };
@@ -673,8 +705,8 @@ ${header}
 `);
 	  if (issues && issues.length > 0) {
 	    const parts = issues.map(({ number, pipeline_stage }) => {
-	      const s = number === currentIssue && pipeline_stage !== "done" ? "executing" : pipeline_stage || "new";
-	      const { colored, icon } = stageIcon(s);
+	      const s = number === currentIssue && pipeline_stage !== STAGES.DONE ? STAGES.EXECUTING : pipeline_stage || STAGES.NEW;
+	      const { colored } = stageIcon(s);
 	      const numStr = SUPPORTS_COLOR ? `${C.dim}#${number}${C.reset}` : `#${number}`;
 	      return `${numStr}${colored}`;
 	    });
@@ -698,7 +730,7 @@ var hasRequiredLib;
 function requireLib () {
 	if (hasRequiredLib) return lib;
 	hasRequiredLib = 1;
-	lib = {
+	const _exports = {
 	  ...index$1.requireState(),
 	  ...index$1.requireGithub(),
 	  ...requireGsd(),
@@ -706,11 +738,23 @@ function requireLib () {
 	  ...requireTemplates(),
 	  ...index$1.requireOutput(),
 	  ...index$1.requireClaude(),
-	  ...requireRetry(),
+	  ...index$1.requireRetry(),
 	  ...index$1.requireSpinner(),
 	  ...requireProgress(),
-	  ...index$1.requireTui()
+	  ...requirePipeline(),
+	  ...index$1.requireErrors(),
+	  ...index$1.requireLogger()
 	};
+	Object.defineProperty(_exports, "createIssuesBrowser", {
+	  configurable: true,
+	  enumerable: true,
+	  get() {
+	    const value = index$1.requireTui().createIssuesBrowser;
+	    Object.defineProperty(_exports, "createIssuesBrowser", { value, enumerable: true });
+	    return value;
+	  }
+	});
+	lib = _exports;
 	return lib;
 }
 
@@ -718,4 +762,3 @@ var libExports = requireLib();
 var index = /*@__PURE__*/index$1.getDefaultExportFromCjs(libExports);
 
 module.exports = index;
-0&&(module.exports={getMgwDir,getActiveDir,getCompletedDir,loadProjectState,writeProjectState,loadActiveIssue,mergeProjectState,migrateProjectState,resolveActiveMilestoneIndex,getRepo,getIssue,listIssues,getMilestone,getRateLimit,closeMilestone,createRelease,getProjectNodeId,findExistingBoard,getProjectFields,createProject,addItemToProject,postMilestoneStartAnnouncement,getGsdToolsPath,invokeGsdTool,getTimestamp,generateSlug,resolveModel,historyDigest,roadmapAnalyze,selectGsdRoute,getGsdState,validate,getSchema,VALID_GSD_ROUTES,IS_TTY,IS_CI,USE_COLOR,COLORS,colorize,statusLine,log,error,verbose,debug,formatJson,assertClaudeAvailable,invokeClaude,getCommandsDir,MAX_RETRIES,BACKOFF_BASE_MS,BACKOFF_MAX_MS,classifyFailure,canRetry,incrementRetry,resetRetryState,getBackoffMs,createSpinner,withSpinner,SUPPORTS_SPINNER,renderProgressBar,printMilestoneProgress,stageIcon,SUPPORTS_COLOR,createIssuesBrowser});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snipcodeit/mgw",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "GitHub-native issue-to-PR automation for Claude Code, powered by Get Shit Done",
   "bin": {
     "mgw": "./dist/bin/mgw.cjs"
@@ -16,7 +16,8 @@
   "scripts": {
     "build": "pkgroll --clean-dist --src .",
     "dev": "pkgroll --watch --src .",
-    "test": "node --test 'test/**/*.test.cjs'",
+    "test": "node --test test/*.test.cjs",
+    "lint": "eslint lib/ bin/ test/",
     "prepublishOnly": "npm run build",
     "completions": "node bin/generate-completions.cjs",
     "postinstall": "node ./bin/mgw-install.cjs"
@@ -28,6 +29,8 @@
     "neo-blessed": "^0.2.0"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.0.2",
     "pkgroll": "^2.26.3"
   },
   "engines": {