@pruddiman/dispatch 1.3.1 → 1.4.0

package/dist/cli.js

@@ -422,7 +422,7 @@ var init_opencode = __esm({
 
 // src/helpers/timeout.ts
 function withTimeout(promise, ms, label) {
-  const p = new Promise((resolve4, reject) => {
+  const p = new Promise((resolve5, reject) => {
     let settled = false;
     const timer = setTimeout(() => {
       if (settled) return;
@@ -434,7 +434,7 @@ function withTimeout(promise, ms, label) {
         if (settled) return;
         settled = true;
         clearTimeout(timer);
-        resolve4(value);
+        resolve5(value);
       },
       (err) => {
         if (settled) return;
@@ -542,9 +542,9 @@ async function boot2(opts) {
         let unsubErr;
         try {
           await withTimeout(
-            new Promise((resolve4, reject) => {
+            new Promise((resolve5, reject) => {
               unsubIdle = session.on("session.idle", () => {
-                resolve4();
+                resolve5();
               });
               unsubErr = session.on("session.error", (event) => {
                 reject(new Error(`Copilot session error: ${event.data.message}`));
@@ -761,18 +761,20 @@ import { promisify as promisify6 } from "util";
 async function checkProviderInstalled(name) {
   try {
     await exec6(PROVIDER_BINARIES[name], ["--version"], {
-      shell: process.platform === "win32"
+      shell: process.platform === "win32",
+      timeout: DETECTION_TIMEOUT_MS
     });
     return true;
   } catch {
     return false;
   }
 }
-var exec6, PROVIDER_BINARIES;
+var exec6, DETECTION_TIMEOUT_MS, PROVIDER_BINARIES;
 var init_detect = __esm({
   "src/providers/detect.ts"() {
     "use strict";
     exec6 = promisify6(execFile6);
+    DETECTION_TIMEOUT_MS = 5e3;
     PROVIDER_BINARIES = {
       opencode: "opencode",
       copilot: "copilot",
@@ -826,6 +828,35 @@ var init_providers = __esm({
   }
 });
 
+// src/helpers/environment.ts
+function getEnvironmentInfo() {
+  const platform = process.platform;
+  switch (platform) {
+    case "win32":
+      return { platform, os: "Windows", shell: "cmd.exe/PowerShell" };
+    case "darwin":
+      return { platform, os: "macOS", shell: "zsh/bash" };
+    default:
+      return { platform, os: "Linux", shell: "bash" };
+  }
+}
+function formatEnvironmentPrompt() {
+  const env = getEnvironmentInfo();
+  return [
+    `## Environment`,
+    `- **Operating System:** ${env.os}`,
+    `- **Default Shell:** ${env.shell}`,
+    `- Always run commands directly in the shell. Do NOT write intermediate scripts (e.g. .bat, .ps1, .py files) unless the task explicitly requires creating a script.`
+  ].join("\n");
+}
+var getEnvironmentBlock;
+var init_environment = __esm({
+  "src/helpers/environment.ts"() {
+    "use strict";
+    getEnvironmentBlock = formatEnvironmentPrompt;
+  }
+});
+
 // src/helpers/cleanup.ts
 function registerCleanup(fn) {
   cleanups.push(fn);
@@ -880,15 +911,15 @@ async function detectTestCommand(cwd) {
   }
 }
 function runTestCommand(command, cwd) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const [cmd, ...args] = command.split(" ");
     execFileCb(
       cmd,
       args,
-      { cwd, maxBuffer: 10 * 1024 * 1024 },
+      { cwd, maxBuffer: 10 * 1024 * 1024, shell: process.platform === "win32" },
       (error, stdout, stderr) => {
         const exitCode = error && "code" in error ? error.code ?? 1 : error ? 1 : 0;
-        resolve4({ exitCode, stdout, stderr, command });
+        resolve5({ exitCode, stdout, stderr, command });
       }
     );
   });
@@ -902,6 +933,8 @@ function buildFixTestsPrompt(testResult, cwd) {
     `**Test command:** ${testResult.command}`,
     `**Exit code:** ${testResult.exitCode}`,
     ``,
+    formatEnvironmentPrompt(),
+    ``,
     `## Test Output`,
     ``,
     "```",
@@ -1003,11 +1036,12 @@ var init_fix_tests_pipeline = __esm({
     init_cleanup();
     init_logger();
     init_file_logger();
+    init_environment();
   }
 });
 
 // src/cli.ts
-import { resolve as resolve3, join as join12 } from "path";
+import { resolve as resolve4, join as join12 } from "path";
 import { Command, Option, CommanderError } from "commander";
 
 // src/spec-generator.ts
@@ -1054,11 +1088,11 @@ function isValidBranchName(name) {
 // src/datasources/github.ts
 var exec = promisify(execFile);
 async function git(args, cwd) {
-  const { stdout } = await exec("git", args, { cwd });
+  const { stdout } = await exec("git", args, { cwd, shell: process.platform === "win32" });
   return stdout;
 }
 async function gh(args, cwd) {
-  const { stdout } = await exec("gh", args, { cwd });
+  const { stdout } = await exec("gh", args, { cwd, shell: process.platform === "win32" });
   return stdout;
 }
 function buildBranchName(issueNumber, title, username = "unknown") {
@@ -1104,7 +1138,7 @@ var datasource = {
         "--json",
         "number,title,body,labels,state,url"
       ],
-      { cwd }
+      { cwd, shell: process.platform === "win32" }
     );
     let issues;
     try {
@@ -1136,7 +1170,7 @@ var datasource = {
         "--json",
         "number,title,body,labels,state,url,comments"
       ],
-      { cwd }
+      { cwd, shell: process.platform === "win32" }
     );
     let issue;
     try {
@@ -1164,18 +1198,18 @@ var datasource = {
   },
   async update(issueId, title, body, opts = {}) {
     const cwd = opts.cwd || process.cwd();
-    await exec("gh", ["issue", "edit", issueId, "--title", title, "--body", body], { cwd });
+    await exec("gh", ["issue", "edit", issueId, "--title", title, "--body", body], { cwd, shell: process.platform === "win32" });
   },
   async close(issueId, opts = {}) {
     const cwd = opts.cwd || process.cwd();
-    await exec("gh", ["issue", "close", issueId], { cwd });
+    await exec("gh", ["issue", "close", issueId], { cwd, shell: process.platform === "win32" });
   },
   async create(title, body, opts = {}) {
     const cwd = opts.cwd || process.cwd();
     const { stdout } = await exec(
       "gh",
       ["issue", "create", "--title", title, "--body", body],
-      { cwd }
+      { cwd, shell: process.platform === "win32" }
     );
     const url = stdout.trim();
     const match = url.match(/\/issues\/(\d+)$/);
@@ -1271,6 +1305,7 @@ import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
 init_logger();
 var exec2 = promisify2(execFile2);
+var doneStateCache = /* @__PURE__ */ new Map();
 function mapWorkItemToIssueDetails(item, id, comments, defaults) {
   const fields = item.fields ?? {};
   return {
@@ -1296,7 +1331,8 @@ async function detectWorkItemType(opts = {}) {
     if (opts.project) args.push("--project", opts.project);
     if (opts.org) args.push("--org", opts.org);
     const { stdout } = await exec2("az", args, {
-      cwd: opts.cwd || process.cwd()
+      cwd: opts.cwd || process.cwd(),
+      shell: process.platform === "win32"
     });
     const types = JSON.parse(stdout);
     if (!Array.isArray(types) || types.length === 0) return null;
@@ -1310,6 +1346,48 @@ async function detectWorkItemType(opts = {}) {
     return null;
   }
 }
+async function detectDoneState(workItemType, opts = {}) {
+  const cacheKey = `${opts.org ?? ""}|${opts.project ?? ""}|${workItemType}`;
+  const cached = doneStateCache.get(cacheKey);
+  if (cached) return cached;
+  try {
+    const args = [
+      "boards",
+      "work-item",
+      "type",
+      "state",
+      "list",
+      "--type",
+      workItemType,
+      "--output",
+      "json"
+    ];
+    if (opts.project) args.push("--project", opts.project);
+    if (opts.org) args.push("--org", opts.org);
+    const { stdout } = await exec2("az", args, {
+      cwd: opts.cwd || process.cwd(),
+      shell: process.platform === "win32"
+    });
+    const states = JSON.parse(stdout);
+    if (Array.isArray(states)) {
+      const completed = states.find((s) => s.category === "Completed");
+      if (completed) {
+        doneStateCache.set(cacheKey, completed.name);
+        return completed.name;
+      }
+      const names = states.map((s) => s.name);
+      const fallbacks = ["Done", "Closed", "Resolved", "Completed"];
+      for (const f of fallbacks) {
+        if (names.includes(f)) {
+          doneStateCache.set(cacheKey, f);
+          return f;
+        }
+      }
+    }
+  } catch {
+  }
+  return "Closed";
+}
 var datasource2 = {
   name: "azdevops",
   supportsGit() {
@@ -1318,6 +1396,7 @@ var datasource2 = {
   async list(opts = {}) {
     const conditions = [
       "[System.State] <> 'Closed'",
+      "[System.State] <> 'Done'",
       "[System.State] <> 'Removed'"
     ];
     if (opts.iteration) {
@@ -1340,7 +1419,8 @@ var datasource2 = {
     if (opts.org) args.push("--org", opts.org);
     if (opts.project) args.push("--project", opts.project);
     const { stdout } = await exec2("az", args, {
-      cwd: opts.cwd || process.cwd()
+      cwd: opts.cwd || process.cwd(),
+      shell: process.platform === "win32"
     });
     let data;
     try {
@@ -1364,7 +1444,8 @@ var datasource2 = {
       if (opts.org) batchArgs.push("--org", opts.org);
       if (opts.project) batchArgs.push("--project", opts.project);
       const { stdout: batchStdout } = await exec2("az", batchArgs, {
-        cwd: opts.cwd || process.cwd()
+        cwd: opts.cwd || process.cwd(),
+        shell: process.platform === "win32"
       });
       let batchItems;
       try {
@@ -1410,7 +1491,8 @@ var datasource2 = {
       args.push("--project", opts.project);
     }
     const { stdout } = await exec2("az", args, {
-      cwd: opts.cwd || process.cwd()
+      cwd: opts.cwd || process.cwd(),
+      shell: process.platform === "win32"
     });
     let item;
     try {
@@ -1435,9 +1517,34 @@ var datasource2 = {
     ];
     if (opts.org) args.push("--org", opts.org);
     if (opts.project) args.push("--project", opts.project);
-    await exec2("az", args, { cwd: opts.cwd || process.cwd() });
+    await exec2("az", args, { cwd: opts.cwd || process.cwd(), shell: process.platform === "win32" });
   },
   async close(issueId, opts = {}) {
+    let workItemType = opts.workItemType;
+    if (!workItemType) {
+      const showArgs = [
+        "boards",
+        "work-item",
+        "show",
+        "--id",
+        issueId,
+        "--output",
+        "json"
+      ];
+      if (opts.org) showArgs.push("--org", opts.org);
+      if (opts.project) showArgs.push("--project", opts.project);
+      const { stdout } = await exec2("az", showArgs, {
+        cwd: opts.cwd || process.cwd(),
+        shell: process.platform === "win32"
+      });
+      try {
+        const item = JSON.parse(stdout);
+        workItemType = item.fields?.["System.WorkItemType"] ?? void 0;
+      } catch {
+        workItemType = void 0;
+      }
+    }
+    const state = workItemType ? await detectDoneState(workItemType, opts) : "Closed";
     const args = [
       "boards",
       "work-item",
@@ -1445,11 +1552,11 @@ var datasource2 = {
       "--id",
       issueId,
       "--state",
-      "Closed"
+      state
     ];
     if (opts.org) args.push("--org", opts.org);
     if (opts.project) args.push("--project", opts.project);
-    await exec2("az", args, { cwd: opts.cwd || process.cwd() });
+    await exec2("az", args, { cwd: opts.cwd || process.cwd(), shell: process.platform === "win32" });
   },
   async create(title, body, opts = {}) {
     const workItemType = opts.workItemType ?? await detectWorkItemType(opts);
@@ -1474,7 +1581,8 @@ var datasource2 = {
     if (opts.org) args.push("--org", opts.org);
     if (opts.project) args.push("--project", opts.project);
     const { stdout } = await exec2("az", args, {
-      cwd: opts.cwd || process.cwd()
+      cwd: opts.cwd || process.cwd(),
+      shell: process.platform === "win32"
     });
     let item;
     try {
@@ -1491,7 +1599,7 @@ var datasource2 = {
   },
   async getDefaultBranch(opts) {
     try {
-      const { stdout } = await exec2("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], { cwd: opts.cwd });
+      const { stdout } = await exec2("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], { cwd: opts.cwd, shell: process.platform === "win32" });
       const parts = stdout.trim().split("/");
       const branch = parts[parts.length - 1];
       if (!isValidBranchName(branch)) {
@@ -1503,7 +1611,7 @@ var datasource2 = {
         throw err;
       }
       try {
-        await exec2("git", ["rev-parse", "--verify", "main"], { cwd: opts.cwd });
+        await exec2("git", ["rev-parse", "--verify", "main"], { cwd: opts.cwd, shell: process.platform === "win32" });
         return "main";
       } catch {
         return "master";
@@ -1512,19 +1620,19 @@ var datasource2 = {
   },
   async getUsername(opts) {
     try {
-      const { stdout } = await exec2("git", ["config", "user.name"], { cwd: opts.cwd });
+      const { stdout } = await exec2("git", ["config", "user.name"], { cwd: opts.cwd, shell: process.platform === "win32" });
       const name = slugify(stdout.trim());
       if (name) return name;
     } catch {
     }
     try {
-      const { stdout } = await exec2("az", ["account", "show", "--query", "user.name", "-o", "tsv"], { cwd: opts.cwd });
+      const { stdout } = await exec2("az", ["account", "show", "--query", "user.name", "-o", "tsv"], { cwd: opts.cwd, shell: process.platform === "win32" });
       const name = slugify(stdout.trim());
       if (name) return name;
     } catch {
     }
     try {
-      const { stdout } = await exec2("az", ["account", "show", "--query", "user.principalName", "-o", "tsv"], { cwd: opts.cwd });
+      const { stdout } = await exec2("az", ["account", "show", "--query", "user.principalName", "-o", "tsv"], { cwd: opts.cwd, shell: process.platform === "win32" });
       const principal = stdout.trim();
       const prefix = principal.split("@")[0];
       const name = slugify(prefix);
@@ -1546,29 +1654,29 @@ var datasource2 = {
       throw new InvalidBranchNameError(branchName);
     }
     try {
-      await exec2("git", ["checkout", "-b", branchName], { cwd: opts.cwd });
+      await exec2("git", ["checkout", "-b", branchName], { cwd: opts.cwd, shell: process.platform === "win32" });
     } catch (err) {
       const message = log.extractMessage(err);
       if (message.includes("already exists")) {
-        await exec2("git", ["checkout", branchName], { cwd: opts.cwd });
+        await exec2("git", ["checkout", branchName], { cwd: opts.cwd, shell: process.platform === "win32" });
       } else {
         throw err;
       }
     }
   },
   async switchBranch(branchName, opts) {
-    await exec2("git", ["checkout", branchName], { cwd: opts.cwd });
+    await exec2("git", ["checkout", branchName], { cwd: opts.cwd, shell: process.platform === "win32" });
   },
   async pushBranch(branchName, opts) {
-    await exec2("git", ["push", "--set-upstream", "origin", branchName], { cwd: opts.cwd });
+    await exec2("git", ["push", "--set-upstream", "origin", branchName], { cwd: opts.cwd, shell: process.platform === "win32" });
   },
   async commitAllChanges(message, opts) {
-    await exec2("git", ["add", "-A"], { cwd: opts.cwd });
-    const { stdout } = await exec2("git", ["diff", "--cached", "--stat"], { cwd: opts.cwd });
+    await exec2("git", ["add", "-A"], { cwd: opts.cwd, shell: process.platform === "win32" });
+    const { stdout } = await exec2("git", ["diff", "--cached", "--stat"], { cwd: opts.cwd, shell: process.platform === "win32" });
     if (!stdout.trim()) {
       return;
     }
-    await exec2("git", ["commit", "-m", message], { cwd: opts.cwd });
+    await exec2("git", ["commit", "-m", message], { cwd: opts.cwd, shell: process.platform === "win32" });
   },
   async createPullRequest(branchName, issueNumber, title, body, opts) {
     try {
@@ -1589,7 +1697,7 @@ var datasource2 = {
           "--output",
           "json"
         ],
-        { cwd: opts.cwd }
+        { cwd: opts.cwd, shell: process.platform === "win32" }
       );
       let pr;
       try {
@@ -1614,7 +1722,7 @@ var datasource2 = {
             "--output",
             "json"
           ],
-          { cwd: opts.cwd }
+          { cwd: opts.cwd, shell: process.platform === "win32" }
         );
         let prs;
         try {
@@ -1650,7 +1758,8 @@ async function fetchComments(workItemId, opts) {
       args.push("--project", opts.project);
     }
     const { stdout } = await exec2("az", args, {
-      cwd: opts.cwd || process.cwd()
+      cwd: opts.cwd || process.cwd(),
+      shell: process.platform === "win32"
     });
     const data = JSON.parse(stdout);
     if (data.comments && Array.isArray(data.comments)) {
@@ -1670,8 +1779,9 @@ async function fetchComments(workItemId, opts) {
 // src/datasources/md.ts
 import { execFile as execFile3 } from "child_process";
 import { readFile, writeFile, readdir, mkdir, rename } from "fs/promises";
-import { join as join2, parse as parsePath } from "path";
+import { basename, dirname as dirname2, isAbsolute, join as join2, parse as parsePath, resolve } from "path";
 import { promisify as promisify3 } from "util";
+import { glob } from "glob";
 
 // src/helpers/errors.ts
 var UnsupportedOperationError = class extends Error {
@@ -1692,6 +1802,15 @@ function resolveDir(opts) {
   const cwd = opts?.cwd ?? process.cwd();
   return join2(cwd, DEFAULT_DIR);
 }
+function resolveFilePath(issueId, opts) {
+  const filename = issueId.endsWith(".md") ? issueId : `${issueId}.md`;
+  if (isAbsolute(filename)) return filename;
+  if (/[/\\]/.test(filename)) {
+    const cwd = opts?.cwd ?? process.cwd();
+    return resolve(cwd, filename);
+  }
+  return join2(resolveDir(opts), filename);
+}
 function extractTitle(content, filename) {
   const match = content.match(/^#\s+(.+)$/m);
   if (match) return match[1].trim();
@@ -1726,6 +1845,19 @@ var datasource3 = {
     return false;
   },
   async list(opts) {
+    if (opts?.pattern) {
+      const cwd = opts.cwd ?? process.cwd();
+      const files = await glob(opts.pattern, { cwd, absolute: true });
+      const mdFiles2 = files.filter((f) => f.endsWith(".md")).sort();
+      const results2 = [];
+      for (const filePath of mdFiles2) {
+        const content = await readFile(filePath, "utf-8");
+        const filename = basename(filePath);
+        const dir2 = dirname2(filePath);
+        results2.push(toIssueDetails(filename, content, dir2));
+      }
+      return results2;
+    }
     const dir = resolveDir(opts);
     let entries;
     try {
@@ -1743,23 +1875,20 @@ var datasource3 = {
     return results;
   },
   async fetch(issueId, opts) {
-    const dir = resolveDir(opts);
-    const filename = issueId.endsWith(".md") ? issueId : `${issueId}.md`;
-    const filePath = join2(dir, filename);
+    const filePath = resolveFilePath(issueId, opts);
     const content = await readFile(filePath, "utf-8");
+    const filename = basename(filePath);
+    const dir = dirname2(filePath);
     return toIssueDetails(filename, content, dir);
   },
   async update(issueId, _title, body, opts) {
-    const dir = resolveDir(opts);
-    const filename = issueId.endsWith(".md") ? issueId : `${issueId}.md`;
-    const filePath = join2(dir, filename);
+    const filePath = resolveFilePath(issueId, opts);
     await writeFile(filePath, body, "utf-8");
   },
   async close(issueId, opts) {
-    const dir = resolveDir(opts);
-    const filename = issueId.endsWith(".md") ? issueId : `${issueId}.md`;
-    const filePath = join2(dir, filename);
-    const archiveDir = join2(dir, "archive");
+    const filePath = resolveFilePath(issueId, opts);
+    const filename = basename(filePath);
+    const archiveDir = join2(dirname2(filePath), "archive");
     await mkdir(archiveDir, { recursive: true });
     await rename(filePath, join2(archiveDir, filename));
   },
@@ -1776,7 +1905,7 @@ var datasource3 = {
   },
   async getUsername(opts) {
     try {
-      const { stdout } = await exec3("git", ["config", "user.name"], { cwd: opts.cwd });
+      const { stdout } = await exec3("git", ["config", "user.name"], { cwd: opts.cwd, shell: process.platform === "win32" });
       const name = stdout.trim();
       if (!name) return "local";
       return slugify(name);
@@ -1825,7 +1954,8 @@ function getDatasource(name) {
 async function getGitRemoteUrl(cwd) {
   try {
     const { stdout } = await exec4("git", ["remote", "get-url", "origin"], {
-      cwd
+      cwd,
+      shell: process.platform === "win32"
     });
     return stdout.trim() || null;
   } catch {
@@ -2100,7 +2230,7 @@ import { constants } from "fs";
 // src/config.ts
 init_providers();
 import { readFile as readFile3, writeFile as writeFile3, mkdir as mkdir2 } from "fs/promises";
-import { join as join4, dirname as dirname2 } from "path";
+import { join as join4, dirname as dirname3 } from "path";
 
 // src/config-prompts.ts
 init_logger();
@@ -2291,7 +2421,7 @@ async function loadConfig(configDir) {
 }
 async function saveConfig(config, configDir) {
   const configPath = getConfigPath(configDir);
-  await mkdir2(dirname2(configPath), { recursive: true });
+  await mkdir2(dirname3(configPath), { recursive: true });
   await writeFile3(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
 }
 async function handleConfigCommand(_argv, configDir) {
@@ -2366,15 +2496,16 @@ async function resolveCliConfig(args) {
 // src/orchestrator/spec-pipeline.ts
 import { join as join7 } from "path";
 import { mkdir as mkdir4, readFile as readFile5, rename as rename2, unlink as unlink2 } from "fs/promises";
-import { glob } from "glob";
+import { glob as glob2 } from "glob";
 init_providers();
 
 // src/agents/spec.ts
 import { mkdir as mkdir3, readFile as readFile4, writeFile as writeFile4, unlink } from "fs/promises";
-import { join as join6, resolve, sep } from "path";
+import { join as join6, resolve as resolve2, sep } from "path";
 import { randomUUID as randomUUID3 } from "crypto";
 init_logger();
 init_file_logger();
+init_environment();
 async function boot5(opts) {
   const { provider } = opts;
   if (!provider) {
@@ -2386,8 +2517,8 @@ async function boot5(opts) {
       const { issue, filePath, fileContent, inlineText, cwd: workingDir, outputPath } = genOpts;
       const startTime = Date.now();
       try {
-        const resolvedCwd = resolve(workingDir);
-        const resolvedOutput = resolve(outputPath);
+        const resolvedCwd = resolve2(workingDir);
+        const resolvedOutput = resolve2(outputPath);
         if (resolvedOutput !== resolvedCwd && !resolvedOutput.startsWith(resolvedCwd + sep)) {
           return {
             data: null,
@@ -2564,6 +2695,8 @@ function buildCommonSpecInstructions(params) {
     ``,
     `\`${cwd}\``,
     ``,
+    formatEnvironmentPrompt(),
+    ``,
     `## Instructions`,
     ``,
     `1. **Explore the codebase** \u2014 read relevant files, search for symbols, understand the project structure, language, frameworks, conventions, and patterns. Identify the tech stack (languages, package managers, frameworks, test runners) so your spec aligns with the project's actual standards.`,
@@ -2814,7 +2947,7 @@ function buildInlineTextItem(issues, outputDir) {
   return [{ id: filepath, details }];
 }
 async function resolveFileItems(issues, specCwd, concurrency) {
-  const files = await glob(issues, { cwd: specCwd, absolute: true });
+  const files = await glob2(issues, { cwd: specCwd, absolute: true });
   if (files.length === 0) {
     log.error(`No files matched the pattern "${Array.isArray(issues) ? issues.join(", ") : issues}".`);
     return null;
@@ -3136,6 +3269,7 @@ async function runSpecPipeline(opts) {
 import { execFile as execFile9 } from "child_process";
 import { promisify as promisify9 } from "util";
 import { readFile as readFile7 } from "fs/promises";
+import { glob as glob3 } from "glob";
 
 // src/parser.ts
 import { readFile as readFile6, writeFile as writeFile5 } from "fs/promises";
@@ -3237,6 +3371,7 @@ function groupTasksByMode(tasks) {
 // src/agents/planner.ts
 init_logger();
 init_file_logger();
+init_environment();
 async function boot6(opts) {
   const { provider, cwd } = opts;
   if (!provider) {
@@ -3307,6 +3442,10 @@ function buildPlannerPrompt(task, cwd, fileContext, worktreeRoot) {
       `- All relative paths must resolve within the worktree root above.`
     );
   }
+  sections.push(
+    ``,
+    formatEnvironmentPrompt()
+  );
   sections.push(
     ``,
     `## Instructions`,
@@ -3343,6 +3482,7 @@ function buildPlannerPrompt(task, cwd, fileContext, worktreeRoot) {
 // src/dispatcher.ts
 init_logger();
 init_file_logger();
+init_environment();
 async function dispatchTask(instance, task, cwd, plan, worktreeRoot) {
   try {
     log.debug(`Dispatching task: ${task.file}:${task.line} \u2014 ${task.text.slice(0, 80)}`);
@@ -3375,6 +3515,8 @@ function buildPrompt(task, cwd, worktreeRoot) {
     `**Source file:** ${task.file}`,
     `**Task (line ${task.line}):** ${task.text}`,
     ``,
+    getEnvironmentBlock(),
+    ``,
     `Instructions:`,
     `- Complete ONLY this specific task \u2014 do not work on other tasks.`,
     `- Make the minimal, correct changes needed.`,
@@ -3392,6 +3534,8 @@ function buildPlannedPrompt(task, cwd, plan, worktreeRoot) {
     `**Source file:** ${task.file}`,
     `**Task (line ${task.line}):** ${task.text}`,
     ``,
+    getEnvironmentBlock(),
+    ``,
     `---`,
     ``,
     `## Execution Plan`,
@@ -3466,8 +3610,9 @@ ${err.stack}` : ""}`);
 // src/agents/commit.ts
 init_logger();
 init_file_logger();
+init_environment();
 import { mkdir as mkdir5, writeFile as writeFile6 } from "fs/promises";
-import { join as join8, resolve as resolve2 } from "path";
+import { join as join8, resolve as resolve3 } from "path";
 import { randomUUID as randomUUID4 } from "crypto";
 async function boot8(opts) {
   const { provider } = opts;
@@ -3480,7 +3625,7 @@ async function boot8(opts) {
     name: "commit",
     async generate(genOpts) {
       try {
-        const resolvedCwd = resolve2(genOpts.cwd);
+        const resolvedCwd = resolve3(genOpts.cwd);
         const tmpDir = join8(resolvedCwd, ".dispatch", "tmp");
         await mkdir5(tmpDir, { recursive: true });
         const tmpFilename = `commit-${randomUUID4()}.md`;
@@ -3542,6 +3687,8 @@ function buildCommitPrompt(opts) {
   const sections = [
     `You are a **commit message agent**. Your job is to analyze the git diff below and generate a meaningful, conventional-commit-compliant commit message, a PR title, and a PR description.`,
     ``,
+    formatEnvironmentPrompt(),
+    ``,
     `## Conventional Commit Guidelines`,
     ``,
     `Follow the Conventional Commits specification (https://www.conventionalcommits.org/):`,
@@ -3663,7 +3810,7 @@ init_logger();
 init_cleanup();
 
 // src/helpers/worktree.ts
-import { join as join9, basename } from "path";
+import { join as join9, basename as basename2 } from "path";
 import { execFile as execFile7 } from "child_process";
 import { promisify as promisify7 } from "util";
 import { randomUUID as randomUUID5 } from "crypto";
@@ -3671,11 +3818,11 @@ init_logger();
 var exec7 = promisify7(execFile7);
 var WORKTREE_DIR = ".dispatch/worktrees";
 async function git2(args, cwd) {
-  const { stdout } = await exec7("git", args, { cwd });
+  const { stdout } = await exec7("git", args, { cwd, shell: process.platform === "win32" });
   return stdout;
 }
 function worktreeName(issueFilename) {
-  const base = basename(issueFilename);
+  const base = basename2(issueFilename);
   const withoutExt = base.replace(/\.md$/i, "");
   const match = withoutExt.match(/^(\d+)/);
   return match ? `issue-${match[1]}` : slugify(withoutExt);
@@ -3983,14 +4130,14 @@ init_providers();
 
 // src/orchestrator/datasource-helpers.ts
 init_logger();
-import { basename as basename2, join as join10 } from "path";
+import { basename as basename3, join as join10 } from "path";
 import { mkdtemp, writeFile as writeFile7 } from "fs/promises";
 import { tmpdir } from "os";
 import { execFile as execFile8 } from "child_process";
 import { promisify as promisify8 } from "util";
 var exec8 = promisify8(execFile8);
 function parseIssueFilename(filePath) {
-  const filename = basename2(filePath);
+  const filename = basename3(filePath);
   const match = /^(\d+)-(.+)\.md$/.exec(filename);
   if (!match) return null;
   return { issueId: match[1], slug: match[2] };
@@ -4005,7 +4152,8 @@ async function fetchItemsById(issueIds, datasource4, fetchOpts) {
       const item = await datasource4.fetch(id, fetchOpts);
       items.push(item);
     } catch (err) {
-      log.warn(`Could not fetch issue #${id}: ${log.formatErrorChain(err)}`);
+      const prefix = id.includes("/") || id.includes("\\") || id.endsWith(".md") ? "" : "#";
+      log.warn(`Could not fetch issue ${prefix}${id}: ${log.formatErrorChain(err)}`);
     }
   }
   return items;
@@ -4023,8 +4171,8 @@ async function writeItemsToTempDir(items) {
     issueDetailsByFile.set(filepath, item);
   }
   files.sort((a, b) => {
-    const numA = parseInt(basename2(a).match(/^(\d+)/)?.[1] ?? "0", 10);
-    const numB = parseInt(basename2(b).match(/^(\d+)/)?.[1] ?? "0", 10);
+    const numA = parseInt(basename3(a).match(/^(\d+)/)?.[1] ?? "0", 10);
+    const numB = parseInt(basename3(b).match(/^(\d+)/)?.[1] ?? "0", 10);
     if (numA !== numB) return numA - numB;
     return a.localeCompare(b);
   });
@@ -4035,7 +4183,7 @@ async function getCommitSummaries(defaultBranch, cwd) {
     const { stdout } = await exec8(
       "git",
       ["log", `${defaultBranch}..HEAD`, "--pretty=format:%s"],
-      { cwd }
+      { cwd, shell: process.platform === "win32" }
     );
     return stdout.trim().split("\n").filter(Boolean);
   } catch {
@@ -4047,7 +4195,7 @@ async function getBranchDiff(defaultBranch, cwd) {
     const { stdout } = await exec8(
       "git",
       ["diff", `${defaultBranch}..HEAD`],
-      { cwd, maxBuffer: 10 * 1024 * 1024 }
+      { cwd, maxBuffer: 10 * 1024 * 1024, shell: process.platform === "win32" }
     );
     return stdout;
   } catch {
@@ -4058,11 +4206,11 @@ async function squashBranchCommits(defaultBranch, message, cwd) {
   const { stdout } = await exec8(
     "git",
     ["merge-base", defaultBranch, "HEAD"],
-    { cwd }
+    { cwd, shell: process.platform === "win32" }
   );
   const mergeBase = stdout.trim();
-  await exec8("git", ["reset", "--soft", mergeBase], { cwd });
-  await exec8("git", ["commit", "-m", message], { cwd });
+  await exec8("git", ["reset", "--soft", mergeBase], { cwd, shell: process.platform === "win32" });
+  await exec8("git", ["commit", "-m", message], { cwd, shell: process.platform === "win32" });
 }
 async function buildPrBody(details, tasks, results, defaultBranch, datasourceName, cwd) {
   const sections = [];
@@ -4158,6 +4306,34 @@ init_timeout();
 import chalk7 from "chalk";
 init_file_logger();
 var exec9 = promisify9(execFile9);
+async function resolveGlobItems(patterns, cwd) {
+  const files = await glob3(patterns, { cwd, absolute: true });
+  if (files.length === 0) {
+    log.warn(`No files matched the pattern(s): ${patterns.join(", ")}`);
+    return [];
+  }
+  log.info(`Matched ${files.length} file(s) from glob pattern(s)`);
+  const items = [];
+  for (const filePath of files) {
+    try {
+      const content = await readFile7(filePath, "utf-8");
+      const title = extractTitle(content, filePath);
+      items.push({
+        number: filePath,
+        title,
+        body: content,
+        labels: [],
+        state: "open",
+        url: filePath,
+        comments: [],
+        acceptanceCriteria: ""
+      });
+    } catch (err) {
+      log.warn(`Could not read file ${filePath}: ${log.formatErrorChain(err)}`);
+    }
+  }
+  return items;
+}
 var DEFAULT_PLAN_TIMEOUT_MIN = 10;
 var DEFAULT_PLAN_RETRIES = 1;
 async function runDispatchPipeline(opts, cwd) {
@@ -4223,7 +4399,14 @@ async function runDispatchPipeline(opts, cwd) {
     }
     const datasource4 = getDatasource(source);
     const fetchOpts = { cwd, org, project, workItemType, iteration, area };
-    const items = issueIds.length > 0 ? await fetchItemsById(issueIds, datasource4, fetchOpts) : await datasource4.list(fetchOpts);
+    let items;
+    if (issueIds.length > 0 && source === "md" && issueIds.some((id) => isGlobOrFilePath(id))) {
+      items = await resolveGlobItems(issueIds, cwd);
+    } else if (issueIds.length > 0) {
+      items = await fetchItemsById(issueIds, datasource4, fetchOpts);
+    } else {
+      items = await datasource4.list(fetchOpts);
+    }
     if (items.length === 0) {
       tui.state.phase = "done";
       tui.stop();
@@ -4295,12 +4478,32 @@ async function runDispatchPipeline(opts, cwd) {
     let featureBranchName;
     let featureDefaultBranch;
     if (feature) {
+      if (typeof feature === "string") {
+        if (!isValidBranchName(feature)) {
+          log.error(`Invalid feature branch name: "${feature}"`);
+          tui.state.phase = "done";
+          tui.stop();
+          return { total: allTasks.length, completed: 0, failed: allTasks.length, skipped: 0, results: [] };
+        }
+        featureBranchName = feature.includes("/") ? feature : `dispatch/${feature}`;
+      } else {
+        featureBranchName = generateFeatureBranchName();
+      }
       try {
         featureDefaultBranch = await datasource4.getDefaultBranch(lifecycleOpts);
         await datasource4.switchBranch(featureDefaultBranch, lifecycleOpts);
-        featureBranchName = generateFeatureBranchName();
-        await datasource4.createAndSwitchBranch(featureBranchName, lifecycleOpts);
-        log.debug(`Created feature branch ${featureBranchName} from ${featureDefaultBranch}`);
+        try {
+          await datasource4.createAndSwitchBranch(featureBranchName, lifecycleOpts);
+          log.debug(`Created feature branch ${featureBranchName} from ${featureDefaultBranch}`);
+        } catch (createErr) {
+          const message = log.extractMessage(createErr);
+          if (message.includes("already exists")) {
+            await datasource4.switchBranch(featureBranchName, lifecycleOpts);
+            log.debug(`Switched to existing feature branch ${featureBranchName}`);
+          } else {
+            throw createErr;
+          }
+        }
         registerCleanup(async () => {
           try {
             await datasource4.switchBranch(featureDefaultBranch, lifecycleOpts);
@@ -4492,12 +4695,18 @@ ${err.stack}` : ""}`);
                   fileLogger?.info(`Execution completed successfully (${Date.now() - startTime}ms)`);
                   try {
                     const parsed = parseIssueFilename(task.file);
+                    const updatedContent = await readFile7(task.file, "utf-8");
                     if (parsed) {
-                      const updatedContent = await readFile7(task.file, "utf-8");
                       const issueDetails = issueDetailsByFile.get(task.file);
                       const title = issueDetails?.title ?? parsed.slug;
                       await datasource4.update(parsed.issueId, title, updatedContent, fetchOpts);
                       log.success(`Synced task completion to issue #${parsed.issueId}`);
+                    } else {
+                      const issueDetails = issueDetailsByFile.get(task.file);
+                      if (issueDetails) {
+                        await datasource4.update(issueDetails.number, issueDetails.title, updatedContent, fetchOpts);
+                        log.success(`Synced task completion to issue #${issueDetails.number}`);
+                      }
                     }
                   } catch (err) {
                     log.warn(`Could not sync task completion to datasource: ${log.formatErrorChain(err)}`);
@@ -4584,13 +4793,13 @@ ${err.stack}` : ""}`);
             }
             try {
               await datasource4.switchBranch(featureBranchName, lifecycleOpts);
-              await exec9("git", ["merge", branchName, "--no-ff", "-m", `merge: issue #${details.number}`], { cwd });
+              await exec9("git", ["merge", branchName, "--no-ff", "-m", `merge: issue #${details.number}`], { cwd, shell: process.platform === "win32" });
               log.debug(`Merged ${branchName} into ${featureBranchName}`);
             } catch (err) {
               const mergeError = `Could not merge ${branchName} into feature branch: ${log.formatErrorChain(err)}`;
               log.warn(mergeError);
               try {
-                await exec9("git", ["merge", "--abort"], { cwd });
+                await exec9("git", ["merge", "--abort"], { cwd, shell: process.platform === "win32" });
               } catch {
               }
               for (const task of fileTasks) {
@@ -4608,7 +4817,7 @@ ${err.stack}` : ""}`);
               return;
             }
             try {
-              await exec9("git", ["branch", "-d", branchName], { cwd });
+              await exec9("git", ["branch", "-d", branchName], { cwd, shell: process.platform === "win32" });
               log.debug(`Deleted local branch ${branchName}`);
             } catch (err) {
               log.warn(`Could not delete local branch ${branchName}: ${log.formatErrorChain(err)}`);
@@ -4764,13 +4973,20 @@ async function dryRunMode(issueIds, cwd, source, org, project, workItemType, ite
     username = await datasource4.getUsername(lifecycleOpts);
   } catch {
   }
-  const items = issueIds.length > 0 ? await fetchItemsById(issueIds, datasource4, fetchOpts) : await datasource4.list(fetchOpts);
+  let items;
+  if (issueIds.length > 0 && source === "md" && issueIds.some((id) => isGlobOrFilePath(id))) {
+    items = await resolveGlobItems(issueIds, cwd);
+  } else if (issueIds.length > 0) {
+    items = await fetchItemsById(issueIds, datasource4, fetchOpts);
+  } else {
+    items = await datasource4.list(fetchOpts);
+  }
   if (items.length === 0) {
     const label = issueIds.length > 0 ? `issue(s) ${issueIds.join(", ")}` : `datasource: ${source}`;
     log.warn("No work items found from " + label);
     return { total: 0, completed: 0, failed: 0, skipped: 0, results: [] };
   }
-  const { files } = await writeItemsToTempDir(items);
+  const { files, issueDetailsByFile } = await writeItemsToTempDir(items);
   const taskFiles = [];
   for (const file of files) {
     const tf = await parseTaskFile(file);
@@ -4787,7 +5003,7 @@ async function dryRunMode(issueIds, cwd, source, org, project, workItemType, ite
 `);
   for (const task of allTasks) {
     const parsed = parseIssueFilename(task.file);
-    const details = parsed ? items.find((item) => item.number === parsed.issueId) : void 0;
+    const details = parsed ? items.find((item) => item.number === parsed.issueId) : issueDetailsByFile.get(task.file);
     const branchInfo = details ? ` [branch: ${datasource4.buildBranchName(details.number, details.title, username)}]` : "";
     log.task(allTasks.indexOf(task), allTasks.length, `${task.file}:${task.line} \u2014 ${task.text}${branchInfo}`);
   }
@@ -4960,7 +5176,7 @@ var HELP = `
     --no-plan              Skip the planner agent, dispatch directly
     --no-branch            Skip branch creation, push, and PR lifecycle
     --no-worktree          Skip git worktree isolation for parallel issues
-    --feature              Group issues into a single feature branch and PR
+    --feature [name]       Group issues into a single feature branch and PR
     --force              Ignore prior run state and re-run all tasks
     --concurrency <n>      Max parallel dispatches (default: min(cpus, freeMB/500), max: ${MAX_CONCURRENCY})
     --provider <name>      Agent backend: ${PROVIDER_NAMES.join(", ")} (default: opencode)
@@ -5006,6 +5222,8 @@ var HELP = `
     dispatch --respec "specs/*.md"
     dispatch --spec "add dark mode toggle to settings page"
     dispatch --spec "feature A should do x" --provider copilot
+    dispatch --feature
+    dispatch --feature my-feature
     dispatch config
 `.trimStart();
 function parseArgs(argv) {
@@ -5015,7 +5233,7 @@ function parseArgs(argv) {
     },
     writeErr: () => {
     }
-  }).helpOption(false).argument("[issueIds...]").option("-h, --help", "Show help").option("-v, --version", "Show version").option("--dry-run", "List tasks without dispatching").option("--no-plan", "Skip the planner agent").option("--no-branch", "Skip branch creation").option("--no-worktree", "Skip git worktree isolation").option("--feature", "Group issues into a single feature branch").option("--force", "Ignore prior run state").option("--verbose", "Show detailed debug output").option("--fix-tests", "Run tests and fix failures").option("--spec <values...>", "Spec mode: issue numbers, glob, or text").option("--respec [values...]", "Regenerate specs").addOption(
+  }).helpOption(false).argument("[issueIds...]").option("-h, --help", "Show help").option("-v, --version", "Show version").option("--dry-run", "List tasks without dispatching").option("--no-plan", "Skip the planner agent").option("--no-branch", "Skip branch creation").option("--no-worktree", "Skip git worktree isolation").option("--feature [name]", "Group issues into a single feature branch").option("--force", "Ignore prior run state").option("--verbose", "Show detailed debug output").option("--fix-tests", "Run tests and fix failures").option("--spec <values...>", "Spec mode: issue numbers, glob, or text").option("--respec [values...]", "Regenerate specs").addOption(
     new Option("--provider <name>", "Agent backend").choices(PROVIDER_NAMES)
   ).addOption(
     new Option("--source <name>", "Issue source").choices(
@@ -5063,7 +5281,7 @@ function parseArgs(argv) {
       if (isNaN(n) || n <= 0) throw new CommanderError(1, "commander.invalidArgument", "--test-timeout must be a positive number (minutes)");
       return n;
     }
-  ).option("--cwd <dir>", "Working directory", (val) => resolve3(val)).option("--output-dir <dir>", "Output directory", (val) => resolve3(val)).option("--org <url>", "Azure DevOps organization URL").option("--project <name>", "Azure DevOps project name").option("--server-url <url>", "Provider server URL");
+  ).option("--cwd <dir>", "Working directory", (val) => resolve4(val)).option("--output-dir <dir>", "Output directory", (val) => resolve4(val)).option("--org <url>", "Azure DevOps organization URL").option("--project <name>", "Azure DevOps project name").option("--server-url <url>", "Provider server URL");
   try {
     program.parse(argv, { from: "user" });
   } catch (err) {
@@ -5098,7 +5316,7 @@ function parseArgs(argv) {
     }
   }
   if (opts.fixTests) args.fixTests = true;
-  if (opts.feature) args.feature = true;
+  if (opts.feature) args.feature = opts.feature;
   if (opts.source !== void 0) args.issueSource = opts.source;
   if (opts.concurrency !== void 0) args.concurrency = opts.concurrency;
   if (opts.serverUrl !== void 0) args.serverUrl = opts.serverUrl;
@@ -5148,7 +5366,7 @@ async function main() {
   if (rawArgv[0] === "config") {
     const configProgram = new Command("dispatch-config").exitOverride().configureOutput({ writeOut: () => {
     }, writeErr: () => {
-    } }).helpOption(false).allowUnknownOption(true).allowExcessArguments(true).option("--cwd <dir>", "Working directory", (v) => resolve3(v));
+    } }).helpOption(false).allowUnknownOption(true).allowExcessArguments(true).option("--cwd <dir>", "Working directory", (v) => resolve4(v));
     try {
       configProgram.parse(rawArgv.slice(1), { from: "user" });
     } catch (err) {
@@ -5179,7 +5397,7 @@ async function main() {
     process.exit(0);
   }
   if (args.version) {
-    console.log(`dispatch v${"1.3.1"}`);
+    console.log(`dispatch v${"1.4.0"}`);
     process.exit(0);
   }
   const orchestrator = await boot9({ cwd: args.cwd });