@girardmedia/bootspring 3.0.0 → 3.2.0

package/dist/mcp-server.js

@@ -33,9 +33,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// ../../node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.8_tsx@4.21.0_typescript@5.9.3_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.14_tsx@4.21.0_typescript@5.9.3_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js
 var init_cjs_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.8_tsx@4.21.0_typescript@5.9.3_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js"() {
+  "../../node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.14_tsx@4.21.0_typescript@5.9.3_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
   }
 });
@@ -26434,13 +26434,16 @@ var require_data = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/fast-uri@3.1.0/node_modules/fast-uri/lib/utils.js
+// ../../node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/utils.js
 var require_utils = __commonJS({
-  "../../node_modules/.pnpm/fast-uri@3.1.0/node_modules/fast-uri/lib/utils.js"(exports2, module2) {
+  "../../node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/utils.js"(exports2, module2) {
     "use strict";
     init_cjs_shims();
     var isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu);
     var isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
+    var isHexPair = RegExp.prototype.test.bind(/^[\da-f]{2}$/iu);
+    var isUnreserved = RegExp.prototype.test.bind(/^[\da-z\-._~]$/iu);
+    var isPathCharacter = RegExp.prototype.test.bind(/^[\da-z\-._~!$&'()*+,;=:@/]$/iu);
     function stringArrayToHexStripped(input) {
       let acc = "";
       let code = 0;
@@ -26633,27 +26636,77 @@ var require_utils = __commonJS({
       }
       return output.join("");
     }
-    function normalizeComponentEncoding(component, esc) {
-      const func = esc !== true ? escape : unescape;
-      if (component.scheme !== void 0) {
-        component.scheme = func(component.scheme);
-      }
-      if (component.userinfo !== void 0) {
-        component.userinfo = func(component.userinfo);
-      }
-      if (component.host !== void 0) {
-        component.host = func(component.host);
+    var HOST_DELIMS = { "@": "%40", "/": "%2F", "?": "%3F", "#": "%23", ":": "%3A" };
+    var HOST_DELIM_RE = /[@/?#:]/g;
+    var HOST_DELIM_NO_COLON_RE = /[@/?#]/g;
+    function reescapeHostDelimiters(host, isIP) {
+      const re = isIP ? HOST_DELIM_NO_COLON_RE : HOST_DELIM_RE;
+      re.lastIndex = 0;
+      return host.replace(re, (ch) => HOST_DELIMS[ch]);
+    }
+    function normalizePercentEncoding(input, decodeUnreserved = false) {
+      if (input.indexOf("%") === -1) {
+        return input;
       }
-      if (component.path !== void 0) {
-        component.path = func(component.path);
+      let output = "";
+      for (let i = 0; i < input.length; i++) {
+        if (input[i] === "%" && i + 2 < input.length) {
+          const hex = input.slice(i + 1, i + 3);
+          if (isHexPair(hex)) {
+            const normalizedHex = hex.toUpperCase();
+            const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+            if (decodeUnreserved && isUnreserved(decoded)) {
+              output += decoded;
+            } else {
+              output += "%" + normalizedHex;
+            }
+            i += 2;
+            continue;
+          }
+        }
+        output += input[i];
       }
-      if (component.query !== void 0) {
-        component.query = func(component.query);
+      return output;
+    }
+    function normalizePathEncoding(input) {
+      let output = "";
+      for (let i = 0; i < input.length; i++) {
+        if (input[i] === "%" && i + 2 < input.length) {
+          const hex = input.slice(i + 1, i + 3);
+          if (isHexPair(hex)) {
+            const normalizedHex = hex.toUpperCase();
+            const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+            if (decoded !== "." && isUnreserved(decoded)) {
+              output += decoded;
+            } else {
+              output += "%" + normalizedHex;
+            }
+            i += 2;
+            continue;
+          }
+        }
+        if (isPathCharacter(input[i])) {
+          output += input[i];
+        } else {
+          output += escape(input[i]);
+        }
       }
-      if (component.fragment !== void 0) {
-        component.fragment = func(component.fragment);
+      return output;
+    }
+    function escapePreservingEscapes(input) {
+      let output = "";
+      for (let i = 0; i < input.length; i++) {
+        if (input[i] === "%" && i + 2 < input.length) {
+          const hex = input.slice(i + 1, i + 3);
+          if (isHexPair(hex)) {
+            output += "%" + hex.toUpperCase();
+            i += 2;
+            continue;
+          }
+        }
+        output += escape(input[i]);
       }
-      return component;
+      return output;
     }
     function recomposeAuthority(component) {
       const uriTokens = [];
@@ -26668,7 +26721,7 @@ var require_utils = __commonJS({
           if (ipV6res.isIPV6 === true) {
             host = `[${ipV6res.escapedHost}]`;
           } else {
-            host = component.host;
+            host = reescapeHostDelimiters(host, false);
           }
         }
         uriTokens.push(host);
@@ -26682,7 +26735,10 @@ var require_utils = __commonJS({
     module2.exports = {
       nonSimpleDomain,
       recomposeAuthority,
-      normalizeComponentEncoding,
+      reescapeHostDelimiters,
+      normalizePercentEncoding,
+      normalizePathEncoding,
+      escapePreservingEscapes,
       removeDotSegments,
       isIPv4,
       isUUID,
@@ -26692,9 +26748,9 @@ var require_utils = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/fast-uri@3.1.0/node_modules/fast-uri/lib/schemes.js
+// ../../node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/schemes.js
 var require_schemes = __commonJS({
-  "../../node_modules/.pnpm/fast-uri@3.1.0/node_modules/fast-uri/lib/schemes.js"(exports2, module2) {
+  "../../node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/schemes.js"(exports2, module2) {
     "use strict";
     init_cjs_shims();
     var { isUUID } = require_utils();
@@ -26903,17 +26959,17 @@ var require_schemes = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/fast-uri@3.1.0/node_modules/fast-uri/index.js
+// ../../node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/index.js
 var require_fast_uri = __commonJS({
-  "../../node_modules/.pnpm/fast-uri@3.1.0/node_modules/fast-uri/index.js"(exports2, module2) {
+  "../../node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/index.js"(exports2, module2) {
     "use strict";
     init_cjs_shims();
-    var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizeComponentEncoding, isIPv4, nonSimpleDomain } = require_utils();
+    var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizePercentEncoding, normalizePathEncoding, escapePreservingEscapes, reescapeHostDelimiters, isIPv4, nonSimpleDomain } = require_utils();
     var { SCHEMES, getSchemeHandler } = require_schemes();
     function normalize(uri, options) {
       if (typeof uri === "string") {
         uri = /** @type {T} */
-        serialize(parse(uri, options), options);
+        normalizeString(uri, options);
       } else if (typeof uri === "object") {
         uri = /** @type {T} */
         parse(serialize(uri, options), options);
@@ -26980,19 +27036,9 @@ var require_fast_uri = __commonJS({
       return target;
     }
     function equal(uriA, uriB, options) {
-      if (typeof uriA === "string") {
-        uriA = unescape(uriA);
-        uriA = serialize(normalizeComponentEncoding(parse(uriA, options), true), { ...options, skipEscape: true });
-      } else if (typeof uriA === "object") {
-        uriA = serialize(normalizeComponentEncoding(uriA, true), { ...options, skipEscape: true });
-      }
-      if (typeof uriB === "string") {
-        uriB = unescape(uriB);
-        uriB = serialize(normalizeComponentEncoding(parse(uriB, options), true), { ...options, skipEscape: true });
-      } else if (typeof uriB === "object") {
-        uriB = serialize(normalizeComponentEncoding(uriB, true), { ...options, skipEscape: true });
-      }
-      return uriA.toLowerCase() === uriB.toLowerCase();
+      const normalizedA = normalizeComparableURI(uriA, options);
+      const normalizedB = normalizeComparableURI(uriB, options);
+      return normalizedA !== void 0 && normalizedB !== void 0 && normalizedA.toLowerCase() === normalizedB.toLowerCase();
     }
     function serialize(cmpts, opts) {
       const component = {
@@ -27017,12 +27063,12 @@ var require_fast_uri = __commonJS({
       if (schemeHandler && schemeHandler.serialize) schemeHandler.serialize(component, options);
       if (component.path !== void 0) {
         if (!options.skipEscape) {
-          component.path = escape(component.path);
+          component.path = escapePreservingEscapes(component.path);
           if (component.scheme !== void 0) {
             component.path = component.path.split("%3A").join(":");
           }
         } else {
-          component.path = unescape(component.path);
+          component.path = normalizePercentEncoding(component.path);
         }
       }
       if (options.reference !== "suffix" && component.scheme) {
@@ -27057,7 +27103,16 @@ var require_fast_uri = __commonJS({
       return uriTokens.join("");
     }
     var URI_PARSE = /^(?:([^#/:?]+):)?(?:\/\/((?:([^#/?@]*)@)?(\[[^#/?\]]+\]|[^#/:?]*)(?::(\d*))?))?([^#?]*)(?:\?([^#]*))?(?:#((?:.|[\n\r])*))?/u;
-    function parse(uri, opts) {
+    function getParseError(parsed, matches) {
+      if (matches[2] !== void 0 && parsed.path && parsed.path[0] !== "/") {
+        return 'URI path must start with "/" when authority is present.';
+      }
+      if (typeof parsed.port === "number" && (parsed.port < 0 || parsed.port > 65535)) {
+        return "URI port is malformed.";
+      }
+      return void 0;
+    }
+    function parseWithStatus(uri, opts) {
       const options = Object.assign({}, opts);
       const parsed = {
         scheme: void 0,
@@ -27068,6 +27123,7 @@ var require_fast_uri = __commonJS({
         query: void 0,
         fragment: void 0
       };
+      let malformedAuthorityOrPort = false;
       let isIP = false;
       if (options.reference === "suffix") {
         if (options.scheme) {
@@ -27088,6 +27144,11 @@ var require_fast_uri = __commonJS({
         if (isNaN(parsed.port)) {
           parsed.port = matches[5];
         }
+        const parseError = getParseError(parsed, matches);
+        if (parseError !== void 0) {
+          parsed.error = parsed.error || parseError;
+          malformedAuthorityOrPort = true;
+        }
         if (parsed.host) {
           const ipv4result = isIPv4(parsed.host);
           if (ipv4result === false) {
@@ -27126,14 +27187,18 @@ var require_fast_uri = __commonJS({
               parsed.scheme = unescape(parsed.scheme);
             }
             if (parsed.host !== void 0) {
-              parsed.host = unescape(parsed.host);
+              parsed.host = reescapeHostDelimiters(unescape(parsed.host), isIP);
             }
           }
           if (parsed.path) {
-            parsed.path = escape(unescape(parsed.path));
+            parsed.path = normalizePathEncoding(parsed.path);
           }
           if (parsed.fragment) {
-            parsed.fragment = encodeURI(decodeURIComponent(parsed.fragment));
+            try {
+              parsed.fragment = encodeURI(decodeURIComponent(parsed.fragment));
+            } catch {
+              parsed.error = parsed.error || "URI malformed";
+            }
           }
         }
         if (schemeHandler && schemeHandler.parse) {
@@ -27142,7 +27207,29 @@ var require_fast_uri = __commonJS({
       } else {
         parsed.error = parsed.error || "URI can not be parsed.";
       }
-      return parsed;
+      return { parsed, malformedAuthorityOrPort };
+    }
+    function parse(uri, opts) {
+      return parseWithStatus(uri, opts).parsed;
+    }
+    function normalizeString(uri, opts) {
+      return normalizeStringWithStatus(uri, opts).normalized;
+    }
+    function normalizeStringWithStatus(uri, opts) {
+      const { parsed, malformedAuthorityOrPort } = parseWithStatus(uri, opts);
+      return {
+        normalized: malformedAuthorityOrPort ? uri : serialize(parsed, opts),
+        malformedAuthorityOrPort
+      };
+    }
+    function normalizeComparableURI(uri, opts) {
+      if (typeof uri === "string") {
+        const { normalized, malformedAuthorityOrPort } = normalizeStringWithStatus(uri, opts);
+        return malformedAuthorityOrPort ? void 0 : normalized;
+      }
+      if (typeof uri === "object") {
+        return serialize(uri, opts);
+      }
     }
     var fastUri = {
       SCHEMES,
@@ -31377,7 +31464,7 @@ var init_release = __esm({
   "../../packages/shared/src/release.ts"() {
     "use strict";
     init_cjs_shims();
-    BOOTSPRING_VERSION = "3.0.0";
+    BOOTSPRING_VERSION = "3.2.0";
     BOOTSPRING_PACKAGE_NAME = "@girardmedia/bootspring";
   }
 });
@@ -47601,7 +47688,7 @@ var require_dist2 = __commonJS({
     ));
     var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
     var init_cjs_shims2 = __esm2({
-      "../../node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.8_tsx@4.21.0_typescript@5.9.3_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js"() {
+      "../../node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.14_tsx@4.21.0_typescript@5.9.3_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js"() {
         "use strict";
       }
     });
@@ -52278,7 +52365,7 @@ var require_package = __commonJS({
   "../../../package.json"(exports2, module2) {
     module2.exports = {
       name: "bootspring-workspace",
-      version: "3.0.0",
+      version: "3.2.0",
       private: true,
       description: "Workspace tooling for the Bootspring monorepo",
       keywords: [
@@ -52382,8 +52469,10 @@ var require_package = __commonJS({
           ajv: "^8.12.0"
         },
         minimatch: "^10.2.1",
-        hono: "4.12.14",
-        "@hono/node-server": "1.19.10",
+        hono: "4.12.18",
+        "@hono/node-server": "1.19.13",
+        axios: ">=1.16.0",
+        "simple-git": ">=3.36.0",
         "express-rate-limit": "^8.2.2",
         "path-to-regexp@<0.1.13": "0.1.13",
         "path-to-regexp@>=8.0.0 <8.4.0": "8.4.0",
@@ -52414,6 +52503,15 @@ var core = require_dist2();
 var api2 = core.api;
 var auth2 = core.auth;
 var VERSION = require_package().version;
+var BUILD_PROGRESS_ARTIFACT = "planning/BUILD_PROGRESS.md";
+var VISIBLE_WORK_CHECKPOINTS = [
+  "Announce the active task and intended checkpoints in the chat or terminal.",
+  "Inspect the relevant files and summarize what changed before editing.",
+  "Patch the implementation and keep unrelated files untouched.",
+  "Add or update focused tests when the task changes behavior.",
+  "Run the relevant verification commands and report pass/fail output.",
+  "Update the build state with action=done only after verification."
+];
 function getProjectRoot() {
   return process.cwd();
 }
@@ -52486,9 +52584,164 @@ function formatBuildTask(task) {
     phase: task.phase,
     source: task.source,
     sourceSection: task.sourceSection,
-    acceptanceCriteria: task.acceptanceCriteria || []
+    acceptanceCriteria: task.acceptanceCriteria || [],
+    dependencies: task.dependencies || []
+  };
+}
+function renderVisibleProgressBar(percent, width = 30) {
+  const clamped = Math.max(0, Math.min(100, Math.round(percent || 0)));
+  const filled = Math.round(clamped / 100 * width);
+  return `[${"#".repeat(filled)}${".".repeat(width - filled)}] ${clamped}%`;
+}
+function writeVisibleProgressArtifact(task, stats, event) {
+  const fs3 = require("fs");
+  const path3 = require("path");
+  const artifactPath = path3.join(getProjectRoot(), BUILD_PROGRESS_ARTIFACT);
+  const progress = {
+    completed: stats?.completed || 0,
+    pending: stats?.pending || 0,
+    inProgress: stats?.inProgress || 0,
+    total: stats?.total || 0,
+    percent: stats?.percent || 0
+  };
+  const taskData = formatBuildTask(task);
+  fs3.mkdirSync(path3.dirname(artifactPath), { recursive: true });
+  fs3.writeFileSync(artifactPath, [
+    "# Build Progress",
+    "",
+    `Updated: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    `Event: ${event}`,
+    `Overall: ${progress.completed}/${progress.total} ${renderVisibleProgressBar(progress.percent)}`,
+    "",
+    "## Active Task",
+    "",
+    taskData ? [
+      `- ID: ${taskData.id}`,
+      `- Title: ${taskData.title}`,
+      `- Phase: ${taskData.phase || "Unknown"}`,
+      taskData.description ? `- Description: ${taskData.description}` : null,
+      taskData.dependencies?.length ? `- Dependencies: ${taskData.dependencies.join(", ")}` : null
+    ].filter(Boolean).join("\n") : "No active or pending task.",
+    "",
+    "## Acceptance Criteria",
+    "",
+    taskData?.acceptanceCriteria?.length ? taskData.acceptanceCriteria.map((item) => `- [ ] ${item}`).join("\n") : "- [ ] No task-specific acceptance criteria recorded.",
+    "",
+    "## Visible Work Contract",
+    "",
+    VISIBLE_WORK_CHECKPOINTS.map((item) => `- [ ] ${item}`).join("\n"),
+    "",
+    "## Host Notes",
+    "",
+    "- Claude Code and Codex CLI can stream terminal output directly.",
+    "- Codex Desktop, Claude Desktop, and other MCP hosts should keep a visible plan/checklist updated while the terminal is hidden.",
+    "- Update this file after inspection, edits, verification, and completion so the workspace has a durable progress surface.",
+    ""
+  ].join("\n"));
+  return BUILD_PROGRESS_ARTIFACT;
+}
+function buildVisibilityContract(task, stats, event) {
+  const artifact = writeVisibleProgressArtifact(task, stats, event);
+  return {
+    artifact,
+    checkpoints: VISIBLE_WORK_CHECKPOINTS,
+    hostInstructions: [
+      "Immediately show the active task and a short visible checklist to the user.",
+      "Post visible updates after inspection, implementation, verification, and completion.",
+      `Keep ${artifact} current when the host hides terminal output.`
+    ]
   };
 }
+function autoCommitTask(taskId, taskTitle) {
+  try {
+    const { execSync } = require("child_process");
+    const cwd = getProjectRoot();
+    const status = execSync("git status --porcelain", { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    if (!status) return { committed: false, reason: "no_changes" };
+    execSync("git add -A", { cwd, stdio: ["ignore", "ignore", "ignore"] });
+    const msg = `feat(${taskId}): ${taskTitle}`;
+    execSync(`git commit -m ${JSON.stringify(msg)}`, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+    return { committed: true, message: msg };
+  } catch (e) {
+    return { committed: false, reason: "git_error", error: String(e?.message || e).slice(0, 200) };
+  }
+}
+function verifyQuality() {
+  try {
+    const { execSync } = require("child_process");
+    const cwd = getProjectRoot();
+    const fs3 = require("fs");
+    const path3 = require("path");
+    const pkgPath = path3.join(cwd, "package.json");
+    if (!fs3.existsSync(pkgPath)) return { verified: true, skipped: true };
+    const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
+    const hasTest = pkg.scripts?.test;
+    const hasTypecheck = pkg.scripts?.typecheck;
+    const results = { verified: true, checks: [] };
+    if (hasTypecheck) {
+      try {
+        execSync("npm run typecheck 2>&1", { cwd, encoding: "utf8", timeout: 6e4, stdio: ["ignore", "pipe", "pipe"] });
+        results.checks.push({ name: "typecheck", passed: true });
+      } catch (e) {
+        results.checks.push({ name: "typecheck", passed: false, error: String(e?.stdout || e?.message || "").slice(0, 500) });
+        results.verified = false;
+      }
+    }
+    if (hasTest && pkg.devDependencies?.vitest) {
+      try {
+        const changed = execSync("git diff --name-only HEAD 2>/dev/null || true", { cwd, encoding: "utf8" }).trim();
+        const testFiles = changed.split("\n").filter((f) => f.match(/\.(test|spec)\.(ts|js|tsx|jsx)$/));
+        if (testFiles.length > 0) {
+          execSync(`npx vitest run ${testFiles.join(" ")} 2>&1`, { cwd, encoding: "utf8", timeout: 12e4, stdio: ["ignore", "pipe", "pipe"] });
+          results.checks.push({ name: "tests", passed: true, files: testFiles.length });
+        } else {
+          results.checks.push({ name: "tests", passed: true, skipped: true, reason: "no_changed_test_files" });
+        }
+      } catch (e) {
+        results.checks.push({ name: "tests", passed: false, error: String(e?.stdout || e?.message || "").slice(0, 500) });
+        results.verified = false;
+      }
+    }
+    return results;
+  } catch {
+    return { verified: true, skipped: true };
+  }
+}
+function loadHandoff() {
+  const fs3 = require("fs");
+  const path3 = require("path");
+  const handoffPath = path3.join(getProjectRoot(), "planning", ".handoff.json");
+  if (!fs3.existsSync(handoffPath)) return null;
+  try {
+    return JSON.parse(fs3.readFileSync(handoffPath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function saveHandoff(data) {
+  const fs3 = require("fs");
+  const path3 = require("path");
+  const planDir = path3.join(getProjectRoot(), "planning");
+  if (!fs3.existsSync(planDir)) fs3.mkdirSync(planDir, { recursive: true });
+  fs3.writeFileSync(path3.join(planDir, ".handoff.json"), JSON.stringify(data, null, 2));
+}
+function getBatchTasks(state, count) {
+  const q = state?.implementationQueue || [];
+  const pending = [];
+  for (const task of q) {
+    if (task.status !== "pending") continue;
+    if (task.dependencies?.length > 0) {
+      const allDone = task.dependencies.every((depId) => {
+        const dep = q.find((t) => t.id === depId);
+        return dep && dep.status === "completed";
+      });
+      if (!allDone) continue;
+    }
+    pending.push(task);
+    if (pending.length >= count) break;
+  }
+  return pending;
+}
 async function executeLocalBuild(args) {
   const action = args?.action || "status";
   const state = loadBuildState();
@@ -52505,6 +52758,7 @@ async function executeLocalBuild(args) {
         status: state.status,
         progress: { completed: stats.completed, pending: stats.pending, inProgress: stats.inProgress, total: stats.total, percent: stats.percent },
         currentTask: currentTask ? { id: currentTask.id, title: currentTask.title } : null,
+        visibility: buildVisibilityContract(currentTask, stats, "status"),
         nextAction: currentTask ? "Complete the current task, then use action=done" : "Use action=next to get the next task"
       }, null, 2) }] };
     }
@@ -52518,6 +52772,7 @@ async function executeLocalBuild(args) {
           message: "Task already in progress",
           state: "in_progress",
           task: formatBuildTask(inProgress),
+          visibility: buildVisibilityContract(inProgress, buildGetStats(state), "already_in_progress"),
           hint: "Complete this task with action=done, or use action=skip to skip it"
         }, null, 2) }] };
       }
@@ -52534,6 +52789,7 @@ async function executeLocalBuild(args) {
         state: "task_ready",
         file: "planning/TODO.md",
         progress: { completed: stats.completed, total: stats.total, percent: stats.percent },
+        visibility: buildVisibilityContract(nextTask, stats, "task_ready"),
         instructions: [
           `Find ${nextTask.id} in planning/TODO.md for full details`,
           "Implement the task in the codebase",
@@ -52554,6 +52810,7 @@ async function executeLocalBuild(args) {
       }
       return { content: [{ type: "text", text: JSON.stringify({
         task: formatBuildTask(currentTask),
+        visibility: buildVisibilityContract(currentTask, buildGetStats(state), "current"),
         instructions: ["Implement this task in the codebase", "Run quality checks (lint, test)", "Commit your changes", "Use action=done to mark complete"]
       }, null, 2) }] };
     }
@@ -52565,6 +52822,8 @@ async function executeLocalBuild(args) {
       if (!inProgress) {
         return { content: [{ type: "text", text: JSON.stringify({ error: "No task currently in progress", hint: "Use action=next to get a task first" }, null, 2) }] };
       }
+      const quality = args?.verify !== false ? verifyQuality() : { verified: true, skipped: true };
+      const commitResult = args?.autoCommit !== false ? autoCommitTask(inProgress.id, inProgress.title) : { committed: false, reason: "disabled" };
       buildUpdateTaskStatus(state, inProgress.id, "completed");
       const nextTask = buildGetNextTask(state);
       if (nextTask) {
@@ -52574,10 +52833,14 @@ async function executeLocalBuild(args) {
       const stats = buildGetStats(state);
       return { content: [{ type: "text", text: JSON.stringify({
         completed: { id: inProgress.id, title: inProgress.title },
+        commit: commitResult,
+        quality,
         progress: { completed: stats.completed, total: stats.total, percent: stats.percent },
         nextTask: nextTask ? { ...formatBuildTask(nextTask), file: "planning/TODO.md" } : null,
         allComplete: !nextTask,
-        message: nextTask ? `Complete! Next: implement ${nextTask.id} \u2014 ${nextTask.title}` : "Build complete! All tasks finished."
+        state: nextTask ? "advanced" : "all_complete",
+        visibility: buildVisibilityContract(nextTask, stats, nextTask ? "advanced" : "all_complete"),
+        message: nextTask ? `Done! Committed ${inProgress.id}. Next: ${nextTask.id} \u2014 ${nextTask.title}` : "Build complete! All tasks finished."
       }, null, 2) }] };
     }
     case "skip": {
@@ -52597,6 +52860,7 @@ async function executeLocalBuild(args) {
       return { content: [{ type: "text", text: JSON.stringify({
         skipped: { id: inProgress.id, title: inProgress.title, reason: args?.reason || "Skipped" },
         nextTask: nextTask ? formatBuildTask(nextTask) : null,
+        visibility: buildVisibilityContract(nextTask, buildGetStats(state), nextTask ? "skipped_next_ready" : "skipped_all_done"),
         message: nextTask ? `Skipped. Next: ${nextTask.title}` : "No more tasks available"
       }, null, 2) }] };
     }
@@ -52622,13 +52886,14 @@ async function executeLocalBuild(args) {
               const nextTask2 = buildGetNextTask(state);
               if (nextTask2) buildUpdateTaskStatus(state, nextTask2.id, "in_progress");
               saveBuildState(state);
-              const stats = buildGetStats(state);
+              const stats2 = buildGetStats(state);
               return { content: [{ type: "text", text: JSON.stringify({
                 state: nextTask2 ? "advanced" : "all_complete",
                 autoCompleted: true,
                 completed: { id: activeTask.id, title: activeTask.title },
                 nextTask: nextTask2 ? formatBuildTask(nextTask2) : null,
-                progress: { completed: stats.completed, total: stats.total, percent: stats.percent }
+                progress: { completed: stats2.completed, total: stats2.total, percent: stats2.percent },
+                visibility: buildVisibilityContract(nextTask2, stats2, nextTask2 ? "advanced" : "all_complete")
               }, null, 2) }] };
             }
           } catch {
@@ -52637,20 +52902,23 @@ async function executeLocalBuild(args) {
         return { content: [{ type: "text", text: JSON.stringify({
           state: "in_progress",
           task: formatBuildTask(activeTask),
+          visibility: buildVisibilityContract(activeTask, buildGetStats(state), "in_progress"),
           hint: "Finish implementation and use action=done, or call action=advance with autoDone=true after commit"
         }, null, 2) }] };
       }
       const nextTask = buildGetNextTask(state);
       if (!nextTask) {
-        const stats = buildGetStats(state);
-        return { content: [{ type: "text", text: JSON.stringify({ state: "all_complete", message: "All tasks complete!", progress: { completed: stats.completed, total: stats.total, percent: stats.percent } }, null, 2) }] };
+        const stats2 = buildGetStats(state);
+        return { content: [{ type: "text", text: JSON.stringify({ state: "all_complete", message: "All tasks complete!", progress: { completed: stats2.completed, total: stats2.total, percent: stats2.percent }, visibility: buildVisibilityContract(null, stats2, "all_complete") }, null, 2) }] };
       }
       buildUpdateTaskStatus(state, nextTask.id, "in_progress");
       saveBuildState(state);
+      const stats = buildGetStats(state);
       return { content: [{ type: "text", text: JSON.stringify({
         state: "task_ready",
         task: formatBuildTask(nextTask),
         file: "planning/TODO.md",
+        visibility: buildVisibilityContract(nextTask, stats, "task_ready"),
         hint: "Implement task, then call action=advance (or action=done) to continue loop"
       }, null, 2) }] };
     }
@@ -52799,8 +53067,66 @@ async function executeLocalBuild(args) {
         message: marked.length > 0 ? `Marked ${marked.length} task${marked.length === 1 ? "" : "s"} as completed from git history` : `Scanned ${lines.length} commits, found ${foundIds.size} bs-IDs, but none matched pending/in-progress tasks`
       }, null, 2) }] };
     }
+    case "handoff": {
+      if (args?.save) {
+        const handoffData = {
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          lastTaskId: args.lastTaskId || null,
+          inProgressTask: state ? (state.implementationQueue || []).find((t) => t.status === "in_progress")?.id || null : null,
+          filesModified: args.filesModified || [],
+          notes: args.notes || "",
+          blockers: args.blockers || [],
+          progress: state ? buildGetStats(state) : null
+        };
+        saveHandoff(handoffData);
+        return { content: [{ type: "text", text: JSON.stringify({
+          saved: true,
+          handoff: handoffData,
+          message: "Session handoff saved. Next session will pick up from here."
+        }, null, 2) }] };
+      }
+      const handoff = loadHandoff();
+      if (!handoff) {
+        return { content: [{ type: "text", text: JSON.stringify({
+          hasHandoff: false,
+          message: "No previous session handoff found. Start fresh with action=next."
+        }, null, 2) }] };
+      }
+      const currentState = state ? buildGetStats(state) : null;
+      return { content: [{ type: "text", text: JSON.stringify({
+        hasHandoff: true,
+        handoff,
+        currentProgress: currentState,
+        message: `Previous session left off at ${handoff.inProgressTask || handoff.lastTaskId || "unknown"}. ${handoff.notes || "No notes."}`,
+        suggestedAction: handoff.inProgressTask ? "action=current to see the in-progress task" : "action=next to continue"
+      }, null, 2) }] };
+    }
+    case "batch": {
+      if (!state) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: "No build state found" }, null, 2) }] };
+      }
+      const count = Math.min(Math.max(args?.count || 5, 1), 10);
+      const batchTasks = getBatchTasks(state, count);
+      if (batchTasks.length === 0) {
+        const stats = buildGetStats(state);
+        return { content: [{ type: "text", text: JSON.stringify({
+          message: "No eligible pending tasks",
+          progress: stats
+        }, null, 2) }] };
+      }
+      return { content: [{ type: "text", text: JSON.stringify({
+        batch: batchTasks.map(formatBuildTask),
+        count: batchTasks.length,
+        instructions: [
+          "Implement all tasks in this batch",
+          "For each completed task, call action=done",
+          "Tasks are ordered by dependency \u2014 complete them in order",
+          "If stuck on one, call action=skip and continue with the next"
+        ]
+      }, null, 2) }] };
+    }
     default:
-      return { content: [{ type: "text", text: JSON.stringify({ error: `Unknown action: ${action}`, validActions: ["next", "current", "done", "skip", "status", "list", "init", "sync", "advance", "scan"] }, null, 2) }] };
+      return { content: [{ type: "text", text: JSON.stringify({ error: `Unknown action: ${action}`, validActions: ["next", "current", "done", "skip", "status", "list", "init", "sync", "advance", "scan", "handoff", "batch"] }, null, 2) }] };
   }
 }
 async function executeLocalSeed(args) {
@@ -53058,13 +53384,31 @@ var FALLBACK_TOOLS = [
   },
   {
     name: "bootspring_build",
-    description: "Autonomous build system. Get tasks, mark complete, check progress. Use action=next to get next task, action=done to mark complete, action=status for progress.",
+    description: `Autonomous build loop. Manages task queue with auto-commit and quality verification.
+
+Core loop: next -> implement -> done -> (auto-advances to next task)
+- action=done auto-commits with conventional message and returns next task
+- action=batch returns multiple tasks for efficient batch execution
+- action=handoff saves/loads session state for cross-session continuity
+- Dependencies are checked automatically \u2014 blocked tasks are skipped`,
     inputSchema: {
       type: "object",
       properties: {
-        action: { type: "string", enum: ["next", "current", "done", "skip", "status", "list", "init", "sync", "advance", "scan"] },
-        reason: { type: "string" },
-        autoDone: { type: "boolean" }
+        action: {
+          type: "string",
+          enum: ["next", "current", "done", "skip", "status", "list", "init", "sync", "advance", "scan", "handoff", "batch"],
+          description: "next: get next task | done: mark complete + auto-commit + return next | batch: get N tasks | handoff: save/load session state | advance: autonomous state machine"
+        },
+        reason: { type: "string", description: "Reason for skipping (action=skip)" },
+        autoDone: { type: "boolean", description: "Auto-complete if git is clean (action=advance)" },
+        autoCommit: { type: "boolean", description: "Auto-commit on done (default: true)" },
+        verify: { type: "boolean", description: "Run quality checks before done (default: true)" },
+        count: { type: "number", description: "Number of tasks to return (action=batch, max 10)" },
+        save: { type: "boolean", description: "Save handoff state (action=handoff)" },
+        notes: { type: "string", description: "Handoff notes for next session (action=handoff save)" },
+        filesModified: { type: "array", items: { type: "string" }, description: "Files modified this session (action=handoff save)" },
+        blockers: { type: "array", items: { type: "string" }, description: "Unresolved blockers (action=handoff save)" },
+        lastTaskId: { type: "string", description: "Last completed task ID (action=handoff save)" }
       },
       required: ["action"]
     }