@defend-tech/opencode-optima 0.1.82 → 0.1.84

package/dist/index.js

@@ -108,17 +108,17 @@ var require_visit = __commonJS({
     visit.BREAK = BREAK;
     visit.SKIP = SKIP;
     visit.REMOVE = REMOVE;
-    function visit_(key, node, visitor, path19) {
-      const ctrl = callVisitor(key, node, visitor, path19);
+    function visit_(key, node, visitor, path21) {
+      const ctrl = callVisitor(key, node, visitor, path21);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path19, ctrl);
-        return visit_(key, ctrl, visitor, path19);
+        replaceNode(key, path21, ctrl);
+        return visit_(key, ctrl, visitor, path21);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node)) {
-          path19 = Object.freeze(path19.concat(node));
+          path21 = Object.freeze(path21.concat(node));
           for (let i = 0; i < node.items.length; ++i) {
-            const ci = visit_(i, node.items[i], visitor, path19);
+            const ci = visit_(i, node.items[i], visitor, path21);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -129,13 +129,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node)) {
-          path19 = Object.freeze(path19.concat(node));
-          const ck = visit_("key", node.key, visitor, path19);
+          path21 = Object.freeze(path21.concat(node));
+          const ck = visit_("key", node.key, visitor, path21);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node.key = null;
-          const cv = visit_("value", node.value, visitor, path19);
+          const cv = visit_("value", node.value, visitor, path21);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -156,17 +156,17 @@ var require_visit = __commonJS({
     visitAsync.BREAK = BREAK;
     visitAsync.SKIP = SKIP;
     visitAsync.REMOVE = REMOVE;
-    async function visitAsync_(key, node, visitor, path19) {
-      const ctrl = await callVisitor(key, node, visitor, path19);
+    async function visitAsync_(key, node, visitor, path21) {
+      const ctrl = await callVisitor(key, node, visitor, path21);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path19, ctrl);
-        return visitAsync_(key, ctrl, visitor, path19);
+        replaceNode(key, path21, ctrl);
+        return visitAsync_(key, ctrl, visitor, path21);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node)) {
-          path19 = Object.freeze(path19.concat(node));
+          path21 = Object.freeze(path21.concat(node));
           for (let i = 0; i < node.items.length; ++i) {
-            const ci = await visitAsync_(i, node.items[i], visitor, path19);
+            const ci = await visitAsync_(i, node.items[i], visitor, path21);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -177,13 +177,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node)) {
-          path19 = Object.freeze(path19.concat(node));
-          const ck = await visitAsync_("key", node.key, visitor, path19);
+          path21 = Object.freeze(path21.concat(node));
+          const ck = await visitAsync_("key", node.key, visitor, path21);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node.key = null;
-          const cv = await visitAsync_("value", node.value, visitor, path19);
+          const cv = await visitAsync_("value", node.value, visitor, path21);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -210,23 +210,23 @@ var require_visit = __commonJS({
       }
       return visitor;
     }
-    function callVisitor(key, node, visitor, path19) {
+    function callVisitor(key, node, visitor, path21) {
       if (typeof visitor === "function")
-        return visitor(key, node, path19);
+        return visitor(key, node, path21);
       if (identity.isMap(node))
-        return visitor.Map?.(key, node, path19);
+        return visitor.Map?.(key, node, path21);
       if (identity.isSeq(node))
-        return visitor.Seq?.(key, node, path19);
+        return visitor.Seq?.(key, node, path21);
       if (identity.isPair(node))
-        return visitor.Pair?.(key, node, path19);
+        return visitor.Pair?.(key, node, path21);
       if (identity.isScalar(node))
-        return visitor.Scalar?.(key, node, path19);
+        return visitor.Scalar?.(key, node, path21);
       if (identity.isAlias(node))
-        return visitor.Alias?.(key, node, path19);
+        return visitor.Alias?.(key, node, path21);
       return void 0;
     }
-    function replaceNode(key, path19, node) {
-      const parent = path19[path19.length - 1];
+    function replaceNode(key, path21, node) {
+      const parent = path21[path21.length - 1];
       if (identity.isCollection(parent)) {
         parent.items[key] = node;
       } else if (identity.isPair(parent)) {
@@ -834,10 +834,10 @@ var require_Collection = __commonJS({
     var createNode = require_createNode();
     var identity = require_identity();
     var Node = require_Node();
-    function collectionFromPath(schema, path19, value) {
+    function collectionFromPath(schema, path21, value) {
       let v = value;
-      for (let i = path19.length - 1; i >= 0; --i) {
-        const k = path19[i];
+      for (let i = path21.length - 1; i >= 0; --i) {
+        const k = path21[i];
         if (typeof k === "number" && Number.isInteger(k) && k >= 0) {
           const a = [];
           a[k] = v;
@@ -856,7 +856,7 @@ var require_Collection = __commonJS({
         sourceObjects: /* @__PURE__ */ new Map()
       });
     }
-    var isEmptyPath = (path19) => path19 == null || typeof path19 === "object" && !!path19[Symbol.iterator]().next().done;
+    var isEmptyPath = (path21) => path21 == null || typeof path21 === "object" && !!path21[Symbol.iterator]().next().done;
     var Collection = class extends Node.NodeBase {
       constructor(type, schema) {
         super(type);
@@ -886,11 +886,11 @@ var require_Collection = __commonJS({
        * be a Pair instance or a `{ key, value }` object, which may not have a key
        * that already exists in the map.
        */
-      addIn(path19, value) {
-        if (isEmptyPath(path19))
+      addIn(path21, value) {
+        if (isEmptyPath(path21))
           this.add(value);
         else {
-          const [key, ...rest] = path19;
+          const [key, ...rest] = path21;
           const node = this.get(key, true);
           if (identity.isCollection(node))
             node.addIn(rest, value);
@@ -904,8 +904,8 @@ var require_Collection = __commonJS({
        * Removes a value from the collection.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path19) {
-        const [key, ...rest] = path19;
+      deleteIn(path21) {
+        const [key, ...rest] = path21;
         if (rest.length === 0)
           return this.delete(key);
         const node = this.get(key, true);
@@ -919,8 +919,8 @@ var require_Collection = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path19, keepScalar) {
-        const [key, ...rest] = path19;
+      getIn(path21, keepScalar) {
+        const [key, ...rest] = path21;
         const node = this.get(key, true);
         if (rest.length === 0)
           return !keepScalar && identity.isScalar(node) ? node.value : node;
@@ -938,8 +938,8 @@ var require_Collection = __commonJS({
       /**
        * Checks if the collection includes a value with the key `key`.
        */
-      hasIn(path19) {
-        const [key, ...rest] = path19;
+      hasIn(path21) {
+        const [key, ...rest] = path21;
         if (rest.length === 0)
           return this.has(key);
         const node = this.get(key, true);
@@ -949,8 +949,8 @@ var require_Collection = __commonJS({
        * Sets a value in this collection. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path19, value) {
-        const [key, ...rest] = path19;
+      setIn(path21, value) {
+        const [key, ...rest] = path21;
         if (rest.length === 0) {
           this.set(key, value);
         } else {
@@ -3454,9 +3454,9 @@ var require_Document = __commonJS({
           this.contents.add(value);
       }
       /** Adds a value to the document. */
-      addIn(path19, value) {
+      addIn(path21, value) {
         if (assertCollection(this.contents))
-          this.contents.addIn(path19, value);
+          this.contents.addIn(path21, value);
       }
       /**
        * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
@@ -3531,14 +3531,14 @@ var require_Document = __commonJS({
        * Removes a value from the document.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path19) {
-        if (Collection.isEmptyPath(path19)) {
+      deleteIn(path21) {
+        if (Collection.isEmptyPath(path21)) {
           if (this.contents == null)
             return false;
           this.contents = null;
           return true;
         }
-        return assertCollection(this.contents) ? this.contents.deleteIn(path19) : false;
+        return assertCollection(this.contents) ? this.contents.deleteIn(path21) : false;
       }
       /**
        * Returns item at `key`, or `undefined` if not found. By default unwraps
@@ -3553,10 +3553,10 @@ var require_Document = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path19, keepScalar) {
-        if (Collection.isEmptyPath(path19))
+      getIn(path21, keepScalar) {
+        if (Collection.isEmptyPath(path21))
           return !keepScalar && identity.isScalar(this.contents) ? this.contents.value : this.contents;
-        return identity.isCollection(this.contents) ? this.contents.getIn(path19, keepScalar) : void 0;
+        return identity.isCollection(this.contents) ? this.contents.getIn(path21, keepScalar) : void 0;
       }
       /**
        * Checks if the document includes a value with the key `key`.
@@ -3567,10 +3567,10 @@ var require_Document = __commonJS({
       /**
        * Checks if the document includes a value at `path`.
        */
-      hasIn(path19) {
-        if (Collection.isEmptyPath(path19))
+      hasIn(path21) {
+        if (Collection.isEmptyPath(path21))
           return this.contents !== void 0;
-        return identity.isCollection(this.contents) ? this.contents.hasIn(path19) : false;
+        return identity.isCollection(this.contents) ? this.contents.hasIn(path21) : false;
       }
       /**
        * Sets a value in this document. For `!!set`, `value` needs to be a
@@ -3587,13 +3587,13 @@ var require_Document = __commonJS({
        * Sets a value in this document. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path19, value) {
-        if (Collection.isEmptyPath(path19)) {
+      setIn(path21, value) {
+        if (Collection.isEmptyPath(path21)) {
           this.contents = value;
         } else if (this.contents == null) {
-          this.contents = Collection.collectionFromPath(this.schema, Array.from(path19), value);
+          this.contents = Collection.collectionFromPath(this.schema, Array.from(path21), value);
         } else if (assertCollection(this.contents)) {
-          this.contents.setIn(path19, value);
+          this.contents.setIn(path21, value);
         }
       }
       /**
@@ -5545,9 +5545,9 @@ var require_cst_visit = __commonJS({
     visit.BREAK = BREAK;
     visit.SKIP = SKIP;
     visit.REMOVE = REMOVE;
-    visit.itemAtPath = (cst, path19) => {
+    visit.itemAtPath = (cst, path21) => {
       let item = cst;
-      for (const [field, index] of path19) {
+      for (const [field, index] of path21) {
         const tok = item?.[field];
         if (tok && "items" in tok) {
           item = tok.items[index];
@@ -5556,23 +5556,23 @@ var require_cst_visit = __commonJS({
       }
       return item;
     };
-    visit.parentCollection = (cst, path19) => {
-      const parent = visit.itemAtPath(cst, path19.slice(0, -1));
-      const field = path19[path19.length - 1][0];
+    visit.parentCollection = (cst, path21) => {
+      const parent = visit.itemAtPath(cst, path21.slice(0, -1));
+      const field = path21[path21.length - 1][0];
       const coll = parent?.[field];
       if (coll && "items" in coll)
         return coll;
       throw new Error("Parent collection not found");
     };
-    function _visit(path19, item, visitor) {
-      let ctrl = visitor(item, path19);
+    function _visit(path21, item, visitor) {
+      let ctrl = visitor(item, path21);
       if (typeof ctrl === "symbol")
         return ctrl;
       for (const field of ["key", "value"]) {
         const token = item[field];
         if (token && "items" in token) {
           for (let i = 0; i < token.items.length; ++i) {
-            const ci = _visit(Object.freeze(path19.concat([[field, i]])), token.items[i], visitor);
+            const ci = _visit(Object.freeze(path21.concat([[field, i]])), token.items[i], visitor);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -5583,10 +5583,10 @@ var require_cst_visit = __commonJS({
             }
           }
           if (typeof ctrl === "function" && field === "key")
-            ctrl = ctrl(item, path19);
+            ctrl = ctrl(item, path21);
         }
       }
-      return typeof ctrl === "function" ? ctrl(item, path19) : ctrl;
+      return typeof ctrl === "function" ? ctrl(item, path21) : ctrl;
     }
     exports.visit = visit;
   }
@@ -6871,14 +6871,14 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs18 = this.flowScalar(this.type);
+              const fs20 = this.flowScalar(this.type);
               if (atNextItem || it.value) {
-                map.items.push({ start, key: fs18, sep: [] });
+                map.items.push({ start, key: fs20, sep: [] });
                 this.onKeyLine = true;
               } else if (it.sep) {
-                this.stack.push(fs18);
+                this.stack.push(fs20);
               } else {
-                Object.assign(it, { key: fs18, sep: [] });
+                Object.assign(it, { key: fs20, sep: [] });
                 this.onKeyLine = true;
               }
               return;
@@ -7006,13 +7006,13 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs18 = this.flowScalar(this.type);
+              const fs20 = this.flowScalar(this.type);
               if (!it || it.value)
-                fc.items.push({ start: [], key: fs18, sep: [] });
+                fc.items.push({ start: [], key: fs20, sep: [] });
               else if (it.sep)
-                this.stack.push(fs18);
+                this.stack.push(fs20);
               else
-                Object.assign(it, { key: fs18, sep: [] });
+                Object.assign(it, { key: fs20, sep: [] });
               return;
             }
             case "flow-map-end":
@@ -7550,17 +7550,17 @@ var require_ignore = __commonJS({
     var throwError = (message, Ctor) => {
       throw new Ctor(message);
     };
-    var checkPath = (path19, originalPath, doThrow) => {
-      if (!isString(path19)) {
+    var checkPath = (path21, originalPath, doThrow) => {
+      if (!isString(path21)) {
         return doThrow(
           `path must be a string, but got \`${originalPath}\``,
           TypeError
         );
       }
-      if (!path19) {
+      if (!path21) {
         return doThrow(`path must not be empty`, TypeError);
       }
-      if (checkPath.isNotRelative(path19)) {
+      if (checkPath.isNotRelative(path21)) {
         const r = "`path.relative()`d";
         return doThrow(
           `path should be a ${r} string, but got "${originalPath}"`,
@@ -7569,7 +7569,7 @@ var require_ignore = __commonJS({
       }
       return true;
     };
-    var isNotRelative = (path19) => REGEX_TEST_INVALID_PATH.test(path19);
+    var isNotRelative = (path21) => REGEX_TEST_INVALID_PATH.test(path21);
     checkPath.isNotRelative = isNotRelative;
     checkPath.convert = (p) => p;
     var Ignore = class {
@@ -7628,7 +7628,7 @@ var require_ignore = __commonJS({
       //   setting `checkUnignored` to `false` could reduce additional
       //   path matching.
       // @returns {TestResult} true if a file is ignored
-      _testOne(path19, checkUnignored) {
+      _testOne(path21, checkUnignored) {
         let ignored = false;
         let unignored = false;
         this._rules.forEach((rule) => {
@@ -7636,7 +7636,7 @@ var require_ignore = __commonJS({
           if (unignored === negative && ignored !== unignored || negative && !ignored && !unignored && !checkUnignored) {
             return;
           }
-          const matched = rule.regex.test(path19);
+          const matched = rule.regex.test(path21);
           if (matched) {
             ignored = !negative;
             unignored = negative;
@@ -7649,24 +7649,24 @@ var require_ignore = __commonJS({
       }
       // @returns {TestResult}
       _test(originalPath, cache, checkUnignored, slices) {
-        const path19 = originalPath && checkPath.convert(originalPath);
+        const path21 = originalPath && checkPath.convert(originalPath);
         checkPath(
-          path19,
+          path21,
           originalPath,
           this._allowRelativePaths ? RETURN_FALSE : throwError
         );
-        return this._t(path19, cache, checkUnignored, slices);
+        return this._t(path21, cache, checkUnignored, slices);
       }
-      _t(path19, cache, checkUnignored, slices) {
-        if (path19 in cache) {
-          return cache[path19];
+      _t(path21, cache, checkUnignored, slices) {
+        if (path21 in cache) {
+          return cache[path21];
         }
         if (!slices) {
-          slices = path19.split(SLASH);
+          slices = path21.split(SLASH);
         }
         slices.pop();
         if (!slices.length) {
-          return cache[path19] = this._testOne(path19, checkUnignored);
+          return cache[path21] = this._testOne(path21, checkUnignored);
         }
         const parent = this._t(
           slices.join(SLASH) + SLASH,
@@ -7674,24 +7674,24 @@ var require_ignore = __commonJS({
           checkUnignored,
           slices
         );
-        return cache[path19] = parent.ignored ? parent : this._testOne(path19, checkUnignored);
+        return cache[path21] = parent.ignored ? parent : this._testOne(path21, checkUnignored);
       }
-      ignores(path19) {
-        return this._test(path19, this._ignoreCache, false).ignored;
+      ignores(path21) {
+        return this._test(path21, this._ignoreCache, false).ignored;
       }
       createFilter() {
-        return (path19) => !this.ignores(path19);
+        return (path21) => !this.ignores(path21);
       }
       filter(paths) {
         return makeArray(paths).filter(this.createFilter());
       }
       // @returns {TestResult}
-      test(path19) {
-        return this._test(path19, this._testCache, true);
+      test(path21) {
+        return this._test(path21, this._testCache, true);
       }
     };
     var factory = (options) => new Ignore(options);
-    var isPathValid = (path19) => checkPath(path19 && checkPath.convert(path19), path19, RETURN_FALSE);
+    var isPathValid = (path21) => checkPath(path21 && checkPath.convert(path21), path21, RETURN_FALSE);
     factory.isPathValid = isPathValid;
     factory.default = factory;
     module.exports = factory;
@@ -7702,16 +7702,16 @@ var require_ignore = __commonJS({
       const makePosix = (str) => /^\\\\\?\\/.test(str) || /["<>|\u0000-\u001F]+/u.test(str) ? str : str.replace(/\\/g, "/");
       checkPath.convert = makePosix;
       const REGIX_IS_WINDOWS_PATH_ABSOLUTE = /^[a-z]:\//i;
-      checkPath.isNotRelative = (path19) => REGIX_IS_WINDOWS_PATH_ABSOLUTE.test(path19) || isNotRelative(path19);
+      checkPath.isNotRelative = (path21) => REGIX_IS_WINDOWS_PATH_ABSOLUTE.test(path21) || isNotRelative(path21);
     }
   }
 });
 
 // src/plugin.js
-import fs17 from "node:fs";
+import fs19 from "node:fs";
 var import_yaml6 = __toESM(require_dist(), 1);
 var import_ignore3 = __toESM(require_ignore(), 1);
-import path18 from "node:path";
+import path20 from "node:path";
 import { tool } from "@opencode-ai/plugin/tool";
 
 // src/agents.js
@@ -9955,8 +9955,8 @@ function clickUpWebhookLogPath(worktree) {
   return path7.join(optimaRuntimeDir(worktree), "clickup-webhook.log.jsonl");
 }
 function clickUpWebhookAuditLogDir() {
-  const dataHome = process.env.XDG_DATA_HOME && path7.isAbsolute(process.env.XDG_DATA_HOME) ? process.env.XDG_DATA_HOME : path7.join(os2.homedir(), ".local", "share", "opencode");
-  return path7.join(dataHome, "opencode-optima");
+  const dataHome2 = process.env.XDG_DATA_HOME && path7.isAbsolute(process.env.XDG_DATA_HOME) ? process.env.XDG_DATA_HOME : path7.join(os2.homedir(), ".local", "share", "opencode");
+  return path7.join(dataHome2, "opencode-optima");
 }
 function clickUpWebhookAuditLogPath(at = /* @__PURE__ */ new Date(), logDir = clickUpWebhookAuditLogDir()) {
   return path7.join(logDir, `clickup-webhook-${at.toISOString().slice(0, 10)}.jsonl`);
@@ -11746,13 +11746,19 @@ var activeClickUpTaskRoutes = /* @__PURE__ */ new Map();
 var CLICKUP_HUMAN_HANDOFF_TEXT_PATTERNS = [
   /\bhuman validation requested\b/i,
   /\bhuman validation\/approval\b/i,
+  /\bvalidation handoff\b/i,
+  /\bplease validate\b/i,
+  /\bfinal validation\b/i,
   /\bplease review pr\b/i,
   /\bapprove or request changes\b/i,
+  /\bremaining QA\b/i,
   /\bexternal blocker\b/i,
   /\bowner routing\b/i,
   /\bpo action needed\b/i,
   /\brouted to PO\b/i,
   /\bauthenticated Chrome session\b/i,
+  /\bauthenticated extension session\b/i,
+  /\bbrowser-level\b/i,
   /\bbrowser-real\b/i,
   /\bAgent Jake\b/i,
   /\bCDP\s+9222\b/i,
@@ -13493,11 +13499,392 @@ function createGitHubApiClient(config = {}, fetchImpl = globalThis.fetch) {
   };
 }
 
+// src/qa/chrome.js
+import fs16 from "node:fs";
+import os6 from "node:os";
+import path17 from "node:path";
+
+// src/qa/queue.js
+import fs15 from "node:fs";
+import os5 from "node:os";
+import path16 from "node:path";
+var DEFAULT_QA_LEASE_MS = 5 * 60 * 1e3;
+var DEFAULT_QA_PROVIDER = "chatgpt";
+function dataHome() {
+  return process.env.XDG_DATA_HOME && path16.isAbsolute(process.env.XDG_DATA_HOME) ? process.env.XDG_DATA_HOME : path16.join(os5.homedir(), ".local", "share", "opencode");
+}
+function qaRuntimeDir() {
+  return path16.join(dataHome(), "opencode-optima", "qa");
+}
+function normalizeQaProvider(provider = DEFAULT_QA_PROVIDER) {
+  const normalized = String(provider || DEFAULT_QA_PROVIDER).trim().toLowerCase().replace(/[^a-z0-9_-]+/g, "-");
+  return normalized || DEFAULT_QA_PROVIDER;
+}
+function qaQueueStatePath(provider = DEFAULT_QA_PROVIDER) {
+  return path16.join(qaRuntimeDir(), `${normalizeQaProvider(provider)}-queue.json`);
+}
+function nowIso(now = /* @__PURE__ */ new Date()) {
+  return now instanceof Date ? now.toISOString() : new Date(now).toISOString();
+}
+function normalizeClickUpTaskId(value = "") {
+  return String(value || "").trim();
+}
+function emptyQaQueueState(provider = DEFAULT_QA_PROVIDER) {
+  return {
+    provider: normalizeQaProvider(provider),
+    active: null,
+    queue: [],
+    history: []
+  };
+}
+function readQaQueueState(provider = DEFAULT_QA_PROVIDER, statePath = qaQueueStatePath(provider)) {
+  try {
+    const raw = fs15.readFileSync(statePath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!isPlainObject(parsed)) return emptyQaQueueState(provider);
+    return {
+      ...emptyQaQueueState(provider),
+      ...parsed,
+      provider: normalizeQaProvider(parsed.provider || provider),
+      queue: Array.isArray(parsed.queue) ? parsed.queue.filter(isPlainObject) : [],
+      history: Array.isArray(parsed.history) ? parsed.history.filter(isPlainObject).slice(-50) : []
+    };
+  } catch {
+    return emptyQaQueueState(provider);
+  }
+}
+function writeQaQueueState(state, statePath = qaQueueStatePath(state?.provider)) {
+  const normalized = {
+    ...emptyQaQueueState(state?.provider),
+    ...state,
+    provider: normalizeQaProvider(state?.provider),
+    queue: Array.isArray(state?.queue) ? state.queue.filter(isPlainObject) : [],
+    history: Array.isArray(state?.history) ? state.history.filter(isPlainObject).slice(-50) : []
+  };
+  fs15.mkdirSync(path16.dirname(statePath), { recursive: true });
+  fs15.writeFileSync(statePath, `${JSON.stringify(normalized, null, 2)}
+`, { mode: 384 });
+  return normalized;
+}
+function activeExpired(active, nowMs, leaseMs) {
+  if (!active?.clickupTaskId) return false;
+  const last = Date.parse(active.lastActivityAt || active.grantedAt || "");
+  return Number.isFinite(last) && nowMs - last > leaseMs;
+}
+function queuedIndex(state, clickupTaskId) {
+  return state.queue.findIndex((entry) => entry.clickupTaskId === clickupTaskId);
+}
+function queueEntry({ clickupTaskId, sessionId = "", worktree = "", reason = "", now = /* @__PURE__ */ new Date() } = {}) {
+  return {
+    clickupTaskId,
+    sessionId: String(sessionId || "").trim(),
+    worktree: String(worktree || "").trim(),
+    reason: String(reason || "").trim(),
+    queuedAt: nowIso(now),
+    lastRequestAt: nowIso(now)
+  };
+}
+function activeEntry({ provider, clickupTaskId, sessionId = "", worktree = "", leaseMs = DEFAULT_QA_LEASE_MS, now = /* @__PURE__ */ new Date() } = {}) {
+  return {
+    provider: normalizeQaProvider(provider),
+    clickupTaskId,
+    sessionId: String(sessionId || "").trim(),
+    worktree: String(worktree || "").trim(),
+    grantedAt: nowIso(now),
+    lastActivityAt: nowIso(now),
+    leaseMs
+  };
+}
+function releaseExpiredQaSlot(state, { now = /* @__PURE__ */ new Date(), leaseMs = DEFAULT_QA_LEASE_MS } = {}) {
+  const normalized = { ...emptyQaQueueState(state?.provider), ...state, queue: Array.isArray(state?.queue) ? [...state.queue] : [] };
+  if (!activeExpired(normalized.active, now.getTime(), leaseMs)) return { state: normalized, expired: null, promoted: null };
+  const expired = normalized.active;
+  normalized.history = [...normalized.history || [], { action: "expired", clickupTaskId: expired.clickupTaskId, at: nowIso(now) }].slice(-50);
+  normalized.active = null;
+  const promoted = normalized.queue.shift() || null;
+  if (promoted) {
+    normalized.active = activeEntry({ ...promoted, provider: normalized.provider, leaseMs, now });
+    normalized.history = [...normalized.history || [], { action: "promoted", clickupTaskId: promoted.clickupTaskId, at: nowIso(now), reason: "expired_previous_slot" }].slice(-50);
+  }
+  return { state: normalized, expired, promoted };
+}
+function requestQaSlot(state, { clickupTaskId, sessionId = "", worktree = "", reason = "", now = /* @__PURE__ */ new Date(), leaseMs = DEFAULT_QA_LEASE_MS } = {}) {
+  const taskId = normalizeClickUpTaskId(clickupTaskId);
+  if (!taskId) return { state, ok: false, action: "invalid", reason: "clickup_task_id_required" };
+  let next = { ...emptyQaQueueState(state?.provider), ...state, queue: Array.isArray(state?.queue) ? [...state.queue] : [] };
+  const expiredResult = releaseExpiredQaSlot(next, { now, leaseMs });
+  next = expiredResult.state;
+  if (!next.active) {
+    next.active = activeEntry({ provider: next.provider, clickupTaskId: taskId, sessionId, worktree, leaseMs, now });
+    next.queue = next.queue.filter((entry) => entry.clickupTaskId !== taskId);
+    next.history = [...next.history || [], { action: "granted", clickupTaskId: taskId, at: nowIso(now) }].slice(-50);
+    return { state: next, ok: true, action: "granted", active: next.active, expired: expiredResult.expired, promoted: expiredResult.promoted };
+  }
+  if (next.active.clickupTaskId === taskId) {
+    next.active = { ...next.active, sessionId: sessionId || next.active.sessionId || "", worktree: worktree || next.active.worktree || "", lastActivityAt: nowIso(now), leaseMs };
+    next.history = [...next.history || [], { action: "renewed", clickupTaskId: taskId, at: nowIso(now) }].slice(-50);
+    return { state: next, ok: true, action: "granted_existing", active: next.active, expired: expiredResult.expired, promoted: expiredResult.promoted };
+  }
+  const index = queuedIndex(next, taskId);
+  if (index >= 0) {
+    next.queue[index] = { ...next.queue[index], sessionId: sessionId || next.queue[index].sessionId || "", worktree: worktree || next.queue[index].worktree || "", reason: reason || next.queue[index].reason || "", lastRequestAt: nowIso(now) };
+  } else {
+    next.queue.push(queueEntry({ clickupTaskId: taskId, sessionId, worktree, reason, now }));
+  }
+  return {
+    state: next,
+    ok: false,
+    action: "queued",
+    active: next.active,
+    position: queuedIndex(next, taskId) + 1,
+    expired: expiredResult.expired,
+    promoted: expiredResult.promoted
+  };
+}
+function touchQaSlot(state, { clickupTaskId, now = /* @__PURE__ */ new Date(), leaseMs = DEFAULT_QA_LEASE_MS } = {}) {
+  const taskId = normalizeClickUpTaskId(clickupTaskId);
+  let next = { ...emptyQaQueueState(state?.provider), ...state, queue: Array.isArray(state?.queue) ? [...state.queue] : [] };
+  const expiredResult = releaseExpiredQaSlot(next, { now, leaseMs });
+  next = expiredResult.state;
+  if (!next.active || next.active.clickupTaskId !== taskId) return { state: next, ok: false, action: "not_active_holder", active: next.active, expired: expiredResult.expired, promoted: expiredResult.promoted };
+  next.active = { ...next.active, lastActivityAt: nowIso(now), leaseMs };
+  return { state: next, ok: true, action: "touched", active: next.active, expired: expiredResult.expired, promoted: expiredResult.promoted };
+}
+function finishQaSlot(state, { clickupTaskId, now = /* @__PURE__ */ new Date(), leaseMs = DEFAULT_QA_LEASE_MS } = {}) {
+  const taskId = normalizeClickUpTaskId(clickupTaskId);
+  let next = { ...emptyQaQueueState(state?.provider), ...state, queue: Array.isArray(state?.queue) ? [...state.queue] : [] };
+  const expiredResult = releaseExpiredQaSlot(next, { now, leaseMs });
+  next = expiredResult.state;
+  if (!next.active || next.active.clickupTaskId !== taskId) return { state: next, ok: false, action: "not_active_holder", active: next.active, expired: expiredResult.expired, promoted: expiredResult.promoted };
+  const released = next.active;
+  next.active = null;
+  next.history = [...next.history || [], { action: "finished", clickupTaskId: taskId, at: nowIso(now) }].slice(-50);
+  const promoted = next.queue.shift() || null;
+  if (promoted) {
+    next.active = activeEntry({ ...promoted, provider: next.provider, leaseMs, now });
+    next.history = [...next.history || [], { action: "promoted", clickupTaskId: promoted.clickupTaskId, at: nowIso(now), reason: "previous_finished" }].slice(-50);
+  }
+  return { state: next, ok: true, action: "finished", released, promoted };
+}
+
+// src/qa/chrome.js
+var DEFAULT_QA_CDP_URL = "http://127.0.0.1:9222";
+function providerDir(provider = DEFAULT_QA_PROVIDER) {
+  return path17.join(qaRuntimeDir(), normalizeQaProvider(provider));
+}
+function defaultQaExtensionStageDir(provider = DEFAULT_QA_PROVIDER) {
+  return path17.join(providerDir(provider), "extension-under-test");
+}
+function defaultQaArtifactsDir(provider = DEFAULT_QA_PROVIDER, clickupTaskId = "unknown") {
+  return path17.join(providerDir(provider), "artifacts", String(clickupTaskId || "unknown"));
+}
+function normalizeCdpUrl(value = "") {
+  return String(value || process.env.OPTIMA_QA_CHROME_CDP_URL || DEFAULT_QA_CDP_URL).trim() || DEFAULT_QA_CDP_URL;
+}
+async function loadPlaywrightChromium() {
+  try {
+    const mod = await import("playwright-core");
+    return mod.chromium;
+  } catch (error) {
+    throw new Error(`playwright-core is required for Optima QA browser tools: ${error.message}`);
+  }
+}
+function qaWindowName(clickupTaskId) {
+  return `optima-qa:${String(clickupTaskId || "").trim()}`;
+}
+async function safePageWindowName(page) {
+  try {
+    return await page.evaluate(() => window.name || "");
+  } catch {
+    return "";
+  }
+}
+async function findQaPage(context, clickupTaskId) {
+  const expected = qaWindowName(clickupTaskId);
+  const pages = context.pages();
+  for (let index = 1; index < pages.length; index += 1) {
+    const page = pages[index];
+    if (await safePageWindowName(page) === expected) return page;
+  }
+  return null;
+}
+async function ensurePersistentTab(context, url = "https://chatgpt.com/") {
+  const pages = context.pages();
+  if (pages[0]) return pages[0];
+  const page = await context.newPage();
+  await page.goto(url, { waitUntil: "domcontentloaded", timeout: 3e4 }).catch(() => {
+  });
+  return page;
+}
+async function ensureQaPage(context, { clickupTaskId, startUrl = "https://chatgpt.com/" } = {}) {
+  await ensurePersistentTab(context, startUrl);
+  const existing = await findQaPage(context, clickupTaskId);
+  if (existing) return existing;
+  const page = await context.newPage();
+  await page.goto(startUrl, { waitUntil: "domcontentloaded", timeout: 3e4 }).catch(() => {
+  });
+  await page.evaluate((name) => {
+    window.name = name;
+  }, qaWindowName(clickupTaskId)).catch(() => {
+  });
+  return page;
+}
+function copyExtensionSource(sourcePath, stageDir) {
+  const source = String(sourcePath || "").trim();
+  if (!source) return { ok: true, skipped: true, reason: "extension_path_not_provided", stageDir };
+  const resolved = path17.resolve(source.replace(/^~(?=$|\/)/, os6.homedir()));
+  if (!fs16.existsSync(resolved)) return { ok: false, error: `extension_path_not_found: ${resolved}`, stageDir };
+  fs16.rmSync(stageDir, { recursive: true, force: true });
+  fs16.mkdirSync(path17.dirname(stageDir), { recursive: true });
+  fs16.cpSync(resolved, stageDir, {
+    recursive: true,
+    filter: (src) => !/[/\\](node_modules|\.git|dist|build|test-results)([/\\]|$)/.test(src)
+  });
+  return { ok: true, source: resolved, stageDir };
+}
+function extensionIdFromWorkerUrl(url = "") {
+  const match = String(url || "").match(/^chrome-extension:\/\/([^/]+)/);
+  return match?.[1] || "";
+}
+async function findExtensionWorker(context, extensionId = "") {
+  const workers = context.serviceWorkers ? context.serviceWorkers() : [];
+  const normalized = String(extensionId || "").trim();
+  if (normalized) return workers.find((worker) => worker.url().startsWith(`chrome-extension://${normalized}/`)) || null;
+  return workers.find((worker) => String(worker.url()).startsWith("chrome-extension://")) || null;
+}
+async function resetExtensionState(context, { extensionId = "" } = {}) {
+  const worker = await findExtensionWorker(context, extensionId);
+  if (!worker) return { ok: false, error: "extension_service_worker_not_found" };
+  const id = extensionIdFromWorkerUrl(worker.url());
+  const result = await worker.evaluate(async () => {
+    const deletedCaches = [];
+    const deletedDbs = [];
+    if (globalThis.chrome?.storage?.local) await chrome.storage.local.clear();
+    if (globalThis.chrome?.storage?.session?.clear) await chrome.storage.session.clear();
+    if (globalThis.chrome?.storage?.sync) await chrome.storage.sync.clear();
+    if (globalThis.caches?.keys) {
+      for (const name of await caches.keys()) {
+        await caches.delete(name);
+        deletedCaches.push(name);
+      }
+    }
+    if (globalThis.indexedDB?.databases) {
+      for (const db of await indexedDB.databases()) {
+        if (db.name) {
+          indexedDB.deleteDatabase(db.name);
+          deletedDbs.push(db.name);
+        }
+      }
+    }
+    return { ok: true, deletedCaches, deletedDbs };
+  });
+  return { extensionId: id, ...result };
+}
+async function reloadExtension(context, { extensionId = "" } = {}) {
+  const worker = await findExtensionWorker(context, extensionId);
+  if (!worker) return { ok: false, error: "extension_service_worker_not_found" };
+  const id = extensionIdFromWorkerUrl(worker.url());
+  await worker.evaluate(() => chrome.runtime.reload()).catch(() => {
+  });
+  return { ok: true, extensionId: id };
+}
+async function summarizeBrowser(context, { clickupTaskId = "" } = {}) {
+  const pages = context.pages();
+  const pageSummaries = [];
+  for (let index = 0; index < pages.length; index += 1) {
+    const page = pages[index];
+    pageSummaries.push({
+      index,
+      role: index === 0 ? "persistent_session_tab" : await safePageWindowName(page) === qaWindowName(clickupTaskId) ? "qa_task_tab" : "other",
+      url: page.url(),
+      title: await page.title().catch(() => "")
+    });
+  }
+  const workers = context.serviceWorkers ? context.serviceWorkers().map((worker) => worker.url()) : [];
+  return { pages: pageSummaries, serviceWorkers: workers };
+}
+function parseQaCommand(commandJson = "") {
+  if (!String(commandJson || "").trim()) return { action: "status" };
+  try {
+    const parsed = JSON.parse(commandJson);
+    return parsed && typeof parsed === "object" ? parsed : { action: "invalid", error: "command_json_must_be_object" };
+  } catch (error) {
+    return { action: "script", script: String(commandJson || "") };
+  }
+}
+async function runQaCommandOnPage(page, context, browser, command, { artifactsDir }) {
+  const action = String(command.action || "status").trim().toLowerCase();
+  if (action === "status") return { ok: true, page: { url: page.url(), title: await page.title().catch(() => "") } };
+  if (action === "goto") {
+    await page.goto(String(command.url || "https://chatgpt.com/"), { waitUntil: command.wait_until || "domcontentloaded", timeout: Number(command.timeout_ms || 3e4) });
+    return { ok: true, url: page.url(), title: await page.title().catch(() => "") };
+  }
+  if (action === "evaluate") {
+    const result = await page.evaluate(String(command.expression || "() => null"));
+    return { ok: true, result };
+  }
+  if (action === "screenshot") {
+    const name = String(command.name || `screenshot-${Date.now()}.png`).replace(/[^a-zA-Z0-9._-]+/g, "-");
+    const outPath = path17.join(artifactsDir, name);
+    fs16.mkdirSync(path17.dirname(outPath), { recursive: true });
+    await page.screenshot({ path: outPath, fullPage: command.full_page !== false });
+    return { ok: true, path: outPath };
+  }
+  if (action === "set_input_files") {
+    const selector = String(command.selector || "input[type=file]");
+    await page.setInputFiles(selector, command.files);
+    return { ok: true, selector };
+  }
+  if (action === "script") {
+    const script = String(command.script || "");
+    if (!script.trim()) return { ok: false, error: "script_required" };
+    const fn = new Function("page", "context", "browser", "artifactsDir", `return (async () => {
+${script}
+})()`);
+    const result = await fn(page, context, browser, artifactsDir);
+    return { ok: true, result };
+  }
+  return { ok: false, error: `unsupported_qa_command_action: ${action}` };
+}
+async function withQaBrowser({ provider = DEFAULT_QA_PROVIDER, cdpUrl = "", clickupTaskId = "", startUrl = "https://chatgpt.com/" } = {}, callback) {
+  const chromium = await loadPlaywrightChromium();
+  const browser = await chromium.connectOverCDP(normalizeCdpUrl(cdpUrl));
+  try {
+    const context = browser.contexts()[0] || await browser.newContext();
+    const page = clickupTaskId ? await ensureQaPage(context, { clickupTaskId, startUrl }) : null;
+    return await callback({ browser, context, page });
+  } finally {
+    await browser.close().catch(() => {
+    });
+  }
+}
+async function qaBrowserStatus(options = {}) {
+  return withQaBrowser(options, async ({ context }) => ({ ok: true, ...await summarizeBrowser(context, { clickupTaskId: options.clickupTaskId }) })).catch((error) => ({ ok: false, error: error.message, cdpUrl: normalizeCdpUrl(options.cdpUrl) }));
+}
+async function qaPrepareExtension({ provider = DEFAULT_QA_PROVIDER, cdpUrl = "", extensionPath = "", extensionId = "", reset = true, reload = true } = {}) {
+  const stageDir = defaultQaExtensionStageDir(provider);
+  const sync = copyExtensionSource(extensionPath, stageDir);
+  const browserResult = await withQaBrowser({ provider, cdpUrl }, async ({ context }) => {
+    const resetResult = reset ? await resetExtensionState(context, { extensionId }).catch((error) => ({ ok: false, error: error.message })) : { ok: true, skipped: true };
+    const reloadResult = reload ? await reloadExtension(context, { extensionId }).catch((error) => ({ ok: false, error: error.message })) : { ok: true, skipped: true };
+    return { reset: resetResult, reload: reloadResult, browser: await summarizeBrowser(context) };
+  }).catch((error) => ({ ok: false, error: error.message }));
+  return { sync, ...browserResult };
+}
+async function qaRunChromeCommand({ provider = DEFAULT_QA_PROVIDER, cdpUrl = "", clickupTaskId = "", commandJson = "", startUrl = "https://chatgpt.com/" } = {}) {
+  const command = parseQaCommand(commandJson);
+  const artifactsDir = defaultQaArtifactsDir(provider, clickupTaskId);
+  return withQaBrowser({ provider, cdpUrl, clickupTaskId, startUrl }, async ({ browser, context, page }) => {
+    const result = await runQaCommandOnPage(page, context, browser, command, { artifactsDir });
+    return { ok: result.ok !== false, command: command.action || "script", tab: { windowName: qaWindowName(clickupTaskId), url: page.url(), title: await page.title().catch(() => "") }, artifactsDir, result };
+  });
+}
+
 // src/repair.js
 var import_yaml4 = __toESM(require_dist(), 1);
 var import_ignore = __toESM(require_ignore(), 1);
-import fs15 from "node:fs";
-import path16 from "node:path";
+import fs17 from "node:fs";
+import path18 from "node:path";
 var CODEMAP_SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([
   ".js",
   ".ts",
@@ -13535,10 +13922,10 @@ var LEGACY_OPERATIONAL_ROOTS = /* @__PURE__ */ new Set([
 ]);
 var OPTIMA_OPERATIONAL_FOLDERS = [".optima", "templates", "dist"];
 function relPath(worktree, targetPath) {
-  return path16.relative(worktree, targetPath).split(path16.sep).join("/") || ".";
+  return path18.relative(worktree, targetPath).split(path18.sep).join("/") || ".";
 }
 function normalizeCodemapRelPath(relPathValue) {
-  return path16.normalize(relPathValue).replace(/\\/g, "/").replace(/\/$/, "");
+  return path18.normalize(relPathValue).replace(/\\/g, "/").replace(/\/$/, "");
 }
 function firstPathSegment(relPathValue) {
   return normalizeCodemapRelPath(relPathValue).split("/").filter(Boolean)[0] || "";
@@ -13557,8 +13944,8 @@ function isHiddenTree(relPathValue) {
 function loadGitIgnoreMatcher(worktree) {
   const ig = (0, import_ignore.default)();
   ig.add(".git");
-  const gitignorePath = path16.join(worktree, ".gitignore");
-  if (fs15.existsSync(gitignorePath)) ig.add(fs15.readFileSync(gitignorePath, "utf8"));
+  const gitignorePath = path18.join(worktree, ".gitignore");
+  if (fs17.existsSync(gitignorePath)) ig.add(fs17.readFileSync(gitignorePath, "utf8"));
   return ig;
 }
 function codemapSectionEntries(value) {
@@ -13577,7 +13964,7 @@ function codemapIndexedPaths(map) {
 }
 function readCodemap(filePath, unresolved, worktree) {
   try {
-    const parsed = import_yaml4.default.parse(fs15.readFileSync(filePath, "utf8"));
+    const parsed = import_yaml4.default.parse(fs17.readFileSync(filePath, "utf8"));
     if (!parsed || typeof parsed !== "object") {
       unresolved.push({ category: "codemap", path: relPath(worktree, filePath), message: "CodeMap is empty or invalid; manual repair required." });
       return null;
@@ -13589,42 +13976,42 @@ function readCodemap(filePath, unresolved, worktree) {
   }
 }
 function writeCodemap(filePath, map) {
-  fs15.writeFileSync(filePath, import_yaml4.default.stringify(map), "utf8");
+  fs17.writeFileSync(filePath, import_yaml4.default.stringify(map), "utf8");
 }
 function isIgnoredPath(ig, relativePath) {
   const normalized = normalizeCodemapRelPath(relativePath);
   return Boolean(normalized) && ig.ignores(normalized);
 }
 function hasImmediateSourceFile(dirPath, ig, worktree) {
-  if (!fs15.existsSync(dirPath)) return false;
-  for (const item of fs15.readdirSync(dirPath, { withFileTypes: true })) {
-    const childPath = path16.join(dirPath, item.name);
-    const relative = path16.relative(worktree, childPath);
+  if (!fs17.existsSync(dirPath)) return false;
+  for (const item of fs17.readdirSync(dirPath, { withFileTypes: true })) {
+    const childPath = path18.join(dirPath, item.name);
+    const relative = path18.relative(worktree, childPath);
     if (isIgnoredPath(ig, relative) || isOperationalRelPath(relative)) continue;
-    if (item.isFile() && CODEMAP_SOURCE_EXTENSIONS.has(path16.extname(item.name))) return true;
+    if (item.isFile() && CODEMAP_SOURCE_EXTENSIONS.has(path18.extname(item.name))) return true;
   }
   return false;
 }
 function containsSource(dirPath, ig, worktree) {
-  if (!fs15.existsSync(dirPath)) return false;
-  const dirRelPath = path16.relative(worktree, dirPath);
+  if (!fs17.existsSync(dirPath)) return false;
+  const dirRelPath = path18.relative(worktree, dirPath);
   if (isOperationalRelPath(dirRelPath) || isHiddenTree(dirRelPath)) return false;
-  for (const item of fs15.readdirSync(dirPath, { withFileTypes: true })) {
-    const childPath = path16.join(dirPath, item.name);
-    const relative = path16.relative(worktree, childPath);
+  for (const item of fs17.readdirSync(dirPath, { withFileTypes: true })) {
+    const childPath = path18.join(dirPath, item.name);
+    const relative = path18.relative(worktree, childPath);
     if (isIgnoredPath(ig, relative) || isOperationalRelPath(relative) || isHiddenTree(relative)) continue;
-    if (item.isFile() && CODEMAP_SOURCE_EXTENSIONS.has(path16.extname(item.name))) return true;
+    if (item.isFile() && CODEMAP_SOURCE_EXTENSIONS.has(path18.extname(item.name))) return true;
     if (item.isDirectory() && containsSource(childPath, ig, worktree)) return true;
   }
   return false;
 }
 function createModuleCodemap(dirPath, worktree, deps) {
-  const entries = fs15.readdirSync(dirPath, { withFileTypes: true });
+  const entries = fs17.readdirSync(dirPath, { withFileTypes: true });
   const entrypoints = [];
   const internals = [];
-  const relToRoot = path16.relative(dirPath, deps.optimaCodemapPath(worktree)).split(path16.sep).join("/");
+  const relToRoot = path18.relative(dirPath, deps.optimaCodemapPath(worktree)).split(path18.sep).join("/");
   for (const item of entries) {
-    if (!item.isFile() || item.name === "codemap.yml" || !CODEMAP_SOURCE_EXTENSIONS.has(path16.extname(item.name))) continue;
+    if (!item.isFile() || item.name === "codemap.yml" || !CODEMAP_SOURCE_EXTENSIONS.has(path18.extname(item.name))) continue;
     const bucket = /^index\.(js|ts|tsx|jsx)$|^main\.(js|ts|tsx|jsx|py|go|rs|java)$/.test(item.name) ? entrypoints : internals;
     bucket.push({ path: item.name });
   }
@@ -13637,7 +14024,7 @@ function repairSingleCodemap(codemapPath, worktree, apply, registerAction, unres
   const map = readCodemap(codemapPath, unresolved, worktree);
   if (!map) return;
   const isRootMap = codemapPath === deps.optimaCodemapPath(worktree);
-  const mapDir = path16.dirname(codemapPath);
+  const mapDir = path18.dirname(codemapPath);
   const pathBase = isRootMap ? worktree : mapDir;
   let changed = false;
   for (const section of ["modules", "entrypoints", "sources_of_truth", "links", "internals"]) {
@@ -13648,13 +14035,13 @@ function repairSingleCodemap(codemapPath, worktree, apply, registerAction, unres
     }
     const nextEntries = [];
     for (const entry of originalEntries) {
-      if (!entry?.path || entry.path.startsWith("http://") || entry.path.startsWith("https://") || path16.isAbsolute(entry.path)) {
+      if (!entry?.path || entry.path.startsWith("http://") || entry.path.startsWith("https://") || path18.isAbsolute(entry.path)) {
         nextEntries.push(entry);
         continue;
       }
       const normalizedPath = normalizeCodemapRelPath(entry.path);
-      const absPath = path16.join(pathBase, normalizedPath);
-      if (!fs15.existsSync(absPath)) {
+      const absPath = path18.join(pathBase, normalizedPath);
+      if (!fs17.existsSync(absPath)) {
         registerAction({ category: "codemap", action: apply ? "removed" : "would_remove", path: relPath(worktree, codemapPath), detail: `Remove broken ${section.slice(0, -1)} reference '${entry.path}'.` });
         changed = true;
         continue;
@@ -13663,8 +14050,8 @@ function repairSingleCodemap(codemapPath, worktree, apply, registerAction, unres
       const maxParts = isRootMap ? 2 : 1;
       if (parts.length > maxParts) {
         const localPath = isRootMap ? parts.slice(0, 2).join("/") : parts[0];
-        const localAbs = path16.join(pathBase, localPath);
-        if (fs15.existsSync(localAbs)) {
+        const localAbs = path18.join(pathBase, localPath);
+        if (fs17.existsSync(localAbs)) {
           nextEntries.push({ ...entry, path: localPath });
           changed = true;
           registerAction({ category: "codemap", action: apply ? "updated" : "would_update", path: relPath(worktree, codemapPath), detail: `Shorten '${entry.path}' to local path '${localPath}'.` });
@@ -13678,11 +14065,11 @@ function repairSingleCodemap(codemapPath, worktree, apply, registerAction, unres
     }
     if (Array.isArray(map[section])) map[section] = nextEntries;
   }
-  if (map.scope === "module" && !isOperationalRelPath(path16.relative(worktree, mapDir))) {
+  if (map.scope === "module" && !isOperationalRelPath(path18.relative(worktree, mapDir))) {
     const indexed = codemapIndexedPaths(map);
     const internals = Array.isArray(map.internals) ? map.internals : [];
-    for (const item of fs15.readdirSync(mapDir, { withFileTypes: true })) {
-      if (!item.isFile() || item.name === "codemap.yml" || !CODEMAP_SOURCE_EXTENSIONS.has(path16.extname(item.name))) continue;
+    for (const item of fs17.readdirSync(mapDir, { withFileTypes: true })) {
+      if (!item.isFile() || item.name === "codemap.yml" || !CODEMAP_SOURCE_EXTENSIONS.has(path18.extname(item.name))) continue;
       if (indexed.has(item.name)) continue;
       internals.push({ path: item.name });
       indexed.add(item.name);
@@ -13696,13 +14083,13 @@ function repairSingleCodemap(codemapPath, worktree, apply, registerAction, unres
 function repairCodemaps(worktree, apply, actions, unresolved, deps) {
   const ig = loadGitIgnoreMatcher(worktree);
   const rootCodemapPath = deps.optimaCodemapPath(worktree);
-  const rootCodemapMissing = !fs15.existsSync(rootCodemapPath);
+  const rootCodemapMissing = !fs17.existsSync(rootCodemapPath);
   if (rootCodemapMissing) {
     actions.push({ category: "codemap", action: apply ? "created" : "would_create", path: ".optima/codemap.yml", detail: "Create missing root CodeMap from template." });
     if (apply) deps.scaffoldOptimaRootCodemap(worktree);
   }
-  if (fs15.existsSync(rootCodemapPath)) repairSingleCodemap(rootCodemapPath, worktree, apply, (action) => actions.push(action), unresolved, deps);
-  const rootMap = fs15.existsSync(rootCodemapPath) ? readCodemap(rootCodemapPath, unresolved, worktree) : null;
+  if (fs17.existsSync(rootCodemapPath)) repairSingleCodemap(rootCodemapPath, worktree, apply, (action) => actions.push(action), unresolved, deps);
+  const rootMap = fs17.existsSync(rootCodemapPath) ? readCodemap(rootCodemapPath, unresolved, worktree) : null;
   let rootChanged = false;
   const rootModulesRepairable = rootMap && (rootMap.modules === void 0 || Array.isArray(rootMap.modules));
   if (rootMap) {
@@ -13714,10 +14101,10 @@ function repairCodemaps(worktree, apply, actions, unresolved, deps) {
     }
   }
   function walk(dirPath) {
-    const relative = path16.relative(worktree, dirPath);
+    const relative = path18.relative(worktree, dirPath);
     if (relative && (isIgnoredPath(ig, relative) || isOperationalRelPath(relative) || isHiddenTree(relative))) return;
-    const codemapPath = path16.join(dirPath, "codemap.yml");
-    const hasCodemap = fs15.existsSync(codemapPath);
+    const codemapPath = path18.join(dirPath, "codemap.yml");
+    const hasCodemap = fs17.existsSync(codemapPath);
     const sourceDir = relative && containsSource(dirPath, ig, worktree);
     if (sourceDir && !hasCodemap && dirPath !== worktree) {
       if (hasImmediateSourceFile(dirPath, ig, worktree)) {
@@ -13736,19 +14123,19 @@ function repairCodemaps(worktree, apply, actions, unresolved, deps) {
         actions.push({ category: "codemap", action: apply ? "updated" : "would_update", path: ".optima/codemap.yml", detail: `Register top-level source module '${normalizeCodemapRelPath(relative)}'.` });
       }
     }
-    if (fs15.existsSync(codemapPath) && codemapPath !== rootCodemapPath) repairSingleCodemap(codemapPath, worktree, apply, (action) => actions.push(action), unresolved, deps);
-    for (const item of fs15.readdirSync(dirPath, { withFileTypes: true })) {
-      if (item.isDirectory()) walk(path16.join(dirPath, item.name));
+    if (fs17.existsSync(codemapPath) && codemapPath !== rootCodemapPath) repairSingleCodemap(codemapPath, worktree, apply, (action) => actions.push(action), unresolved, deps);
+    for (const item of fs17.readdirSync(dirPath, { withFileTypes: true })) {
+      if (item.isDirectory()) walk(path18.join(dirPath, item.name));
     }
   }
-  if (fs15.existsSync(worktree)) walk(worktree);
+  if (fs17.existsSync(worktree)) walk(worktree);
   if (rootMap && rootChanged && apply) writeCodemap(rootCodemapPath, rootMap);
 }
 function walkMarkdownFiles(dirPath) {
-  if (!fs15.existsSync(dirPath)) return [];
+  if (!fs17.existsSync(dirPath)) return [];
   const files = [];
-  for (const entry of fs15.readdirSync(dirPath, { withFileTypes: true })) {
-    const entryPath = path16.join(dirPath, entry.name);
+  for (const entry of fs17.readdirSync(dirPath, { withFileTypes: true })) {
+    const entryPath = path18.join(dirPath, entry.name);
     if (entry.isDirectory()) {
       files.push(...walkMarkdownFiles(entryPath));
     } else if (entry.isFile() && entry.name.endsWith(".md")) {
@@ -13787,7 +14174,7 @@ function rewriteOptimaMarkdownReferences(content, evidenceBasePath = null) {
 }
 function optimaEvidenceBaseForFile(worktree, filePath, deps) {
   const evidenceRoot = deps.optimaEvidencesDir(worktree);
-  const relative = path16.relative(evidenceRoot, filePath).split(path16.sep).join("/");
+  const relative = path18.relative(evidenceRoot, filePath).split(path18.sep).join("/");
   const [taskId] = relative.split("/");
   if (!taskId || taskId === ".." || relative.startsWith("../")) return null;
   return `.optima/evidences/${taskId}`;
@@ -13800,11 +14187,11 @@ function normalizeOptimaMarkdownReferences(worktree, deps) {
   ];
   const changed = [];
   for (const filePath of scanRoots.flatMap(walkMarkdownFiles)) {
-    const raw = fs15.readFileSync(filePath, "utf8");
-    const evidenceBasePath = filePath.startsWith(deps.optimaEvidencesDir(worktree) + path16.sep) ? optimaEvidenceBaseForFile(worktree, filePath, deps) : null;
+    const raw = fs17.readFileSync(filePath, "utf8");
+    const evidenceBasePath = filePath.startsWith(deps.optimaEvidencesDir(worktree) + path18.sep) ? optimaEvidenceBaseForFile(worktree, filePath, deps) : null;
     const rewritten = rewriteOptimaMarkdownReferences(raw, evidenceBasePath);
     if (rewritten !== raw) {
-      fs15.writeFileSync(filePath, rewritten, "utf8");
+      fs17.writeFileSync(filePath, rewritten, "utf8");
       changed.push(relPath(worktree, filePath));
     }
   }
@@ -13812,8 +14199,8 @@ function normalizeOptimaMarkdownReferences(worktree, deps) {
 }
 function missingOptimaGitignoreRules(worktree, deps) {
   if (!deps.isGitRepository(worktree)) return [];
-  const gitignorePath = path16.join(worktree, ".gitignore");
-  const existing = fs15.existsSync(gitignorePath) ? fs15.readFileSync(gitignorePath, "utf8") : "";
+  const gitignorePath = path18.join(worktree, ".gitignore");
+  const existing = fs17.existsSync(gitignorePath) ? fs17.readFileSync(gitignorePath, "utf8") : "";
   const existingRules = new Set(existing.split(/\r?\n/).map((line) => line.trim()).filter(Boolean));
   return deps.optimaGitignoreRules.filter((rule) => !existingRules.has(rule));
 }
@@ -13830,11 +14217,11 @@ function planOptimaRepair(worktree, args = {}, deps) {
   const apply = mode === "apply";
   const actions = [];
   const unresolved = [];
-  const hadOptima = fs15.existsSync(deps.optimaDir(worktree));
+  const hadOptima = fs17.existsSync(deps.optimaDir(worktree));
   const missingGitignoreRules = missingOptimaGitignoreRules(worktree, deps);
   const markdownBefore = apply ? [] : walkMarkdownFiles(deps.optimaDir(worktree)).filter((filePath) => {
-    const raw = fs15.readFileSync(filePath, "utf8");
-    const evidenceBasePath = filePath.startsWith(deps.optimaEvidencesDir(worktree) + path16.sep) ? optimaEvidenceBaseForFile(worktree, filePath, deps) : null;
+    const raw = fs17.readFileSync(filePath, "utf8");
+    const evidenceBasePath = filePath.startsWith(deps.optimaEvidencesDir(worktree) + path18.sep) ? optimaEvidenceBaseForFile(worktree, filePath, deps) : null;
     return rewriteOptimaMarkdownReferences(raw, evidenceBasePath) !== raw;
   }).map((filePath) => relPath(worktree, filePath));
   if (!hadOptima) pushRepairAction(actions, "operational", apply ? "created" : "would_create", ".optima/", "Create Optima operational root.");
@@ -13843,31 +14230,31 @@ function planOptimaRepair(worktree, args = {}, deps) {
     [".staticeng/", deps.legacyStaticEngDir(worktree)],
     [".nomadwork/", deps.legacyNomadworkDir(worktree)],
     [".nomadworks/", deps.legacyNomadworksDir(worktree)],
-    ["tasks/", path16.join(worktree, "tasks")],
-    ["evidences/", path16.join(worktree, "evidences")],
-    ["docs/scrs/", path16.join(worktree, "docs", "scrs")],
-    ["codemap.yml", path16.join(worktree, "codemap.yml")],
-    ["codemap.yaml", path16.join(worktree, "codemap.yaml")]
+    ["tasks/", path18.join(worktree, "tasks")],
+    ["evidences/", path18.join(worktree, "evidences")],
+    ["docs/scrs/", path18.join(worktree, "docs", "scrs")],
+    ["codemap.yml", path18.join(worktree, "codemap.yml")],
+    ["codemap.yaml", path18.join(worktree, "codemap.yaml")]
   ];
-  if (!deps.isOptimaPluginPackageWorktree(worktree)) legacySources.push(["policies/", path16.join(worktree, "policies")]);
+  if (!deps.isOptimaPluginPackageWorktree(worktree)) legacySources.push(["policies/", path18.join(worktree, "policies")]);
   for (const [display, sourcePath] of legacySources) {
-    if (fs15.existsSync(sourcePath)) pushRepairAction(actions, "legacy", apply ? "migrated" : "would_migrate", display, "Move or merge legacy/root Optima artifact into .optima using preservation safeguards.");
+    if (fs17.existsSync(sourcePath)) pushRepairAction(actions, "legacy", apply ? "migrated" : "would_migrate", display, "Move or merge legacy/root Optima artifact into .optima using preservation safeguards.");
   }
   if (apply) deps.migrateLegacyOptimaLayout(worktree);
-  const configMissing = !fs15.existsSync(deps.repoConfigPath(worktree));
+  const configMissing = !fs17.existsSync(deps.repoConfigPath(worktree));
   if (configMissing) pushRepairAction(actions, "config", apply ? "created" : "would_create", ".optima/.config/optima.yaml", "Create missing local Optima config from template.");
   if (apply) deps.scaffoldOptimaConfig(worktree, args.team_mode || "full");
   const requiredFiles = [
-    [path16.join(deps.optimaTasksDir(worktree), "current.md"), "registry", ".optima/tasks/current.md", deps.currentTasksRegistryContent()],
-    [path16.join(deps.optimaTasksDir(worktree), "done.md"), "registry", ".optima/tasks/done.md", deps.doneTasksRegistryContent()],
-    [path16.join(deps.optimaScrsDir(worktree), "current.md"), "registry", ".optima/docs/scrs/current.md", deps.currentScrRegistryContent()],
-    [path16.join(deps.optimaScrsDir(worktree), "done.md"), "registry", ".optima/docs/scrs/done.md", deps.doneScrRegistryContent()],
-    [path16.join(deps.optimaTasksDir(worktree), "task-template.md"), "template", ".optima/tasks/task-template.md", deps.taskTemplateContent()],
-    [path16.join(deps.optimaTasksDir(worktree), "subtask-template.md"), "template", ".optima/tasks/subtask-template.md", deps.subtaskTemplateContent()],
-    [path16.join(deps.repoPoliciesDir(worktree), "README.md"), "policy", ".optima/policies/README.md", deps.repoLocalPoliciesReadme]
+    [path18.join(deps.optimaTasksDir(worktree), "current.md"), "registry", ".optima/tasks/current.md", deps.currentTasksRegistryContent()],
+    [path18.join(deps.optimaTasksDir(worktree), "done.md"), "registry", ".optima/tasks/done.md", deps.doneTasksRegistryContent()],
+    [path18.join(deps.optimaScrsDir(worktree), "current.md"), "registry", ".optima/docs/scrs/current.md", deps.currentScrRegistryContent()],
+    [path18.join(deps.optimaScrsDir(worktree), "done.md"), "registry", ".optima/docs/scrs/done.md", deps.doneScrRegistryContent()],
+    [path18.join(deps.optimaTasksDir(worktree), "task-template.md"), "template", ".optima/tasks/task-template.md", deps.taskTemplateContent()],
+    [path18.join(deps.optimaTasksDir(worktree), "subtask-template.md"), "template", ".optima/tasks/subtask-template.md", deps.subtaskTemplateContent()],
+    [path18.join(deps.repoPoliciesDir(worktree), "README.md"), "policy", ".optima/policies/README.md", deps.repoLocalPoliciesReadme]
   ];
   for (const [filePath, category, displayPath, content] of requiredFiles) {
-    if (!fs15.existsSync(filePath)) {
+    if (!fs17.existsSync(filePath)) {
       pushRepairAction(actions, category, apply ? "created" : "would_create", displayPath, "Create missing Optima scaffold file without overwriting existing content.");
       if (apply) deps.ensureFileIfMissing(filePath, content);
     }
@@ -13921,18 +14308,18 @@ function formatRepairResult(plan, validationResult = null, formatValidationResul
 // src/validate_logic.js
 var import_yaml5 = __toESM(require_dist(), 1);
 var import_ignore2 = __toESM(require_ignore(), 1);
-import fs16 from "node:fs";
-import path17 from "node:path";
+import fs18 from "node:fs";
+import path19 from "node:path";
 async function optima_validate_logic(worktree) {
-  const rootCodemapPath = path17.join(worktree, ".optima", "codemap.yml");
-  if (!fs16.existsSync(rootCodemapPath)) return { ok: false, errors: [".optima/codemap.yml not found."], warnings: [] };
+  const rootCodemapPath = path19.join(worktree, ".optima", "codemap.yml");
+  if (!fs18.existsSync(rootCodemapPath)) return { ok: false, errors: [".optima/codemap.yml not found."], warnings: [] };
   const errors = [];
   const warnings = [];
   const ig = (0, import_ignore2.default)();
   ig.add(".git");
-  const gitignorePath = path17.join(worktree, ".gitignore");
-  if (fs16.existsSync(gitignorePath)) {
-    ig.add(fs16.readFileSync(gitignorePath, "utf8"));
+  const gitignorePath = path19.join(worktree, ".gitignore");
+  if (fs18.existsSync(gitignorePath)) {
+    ig.add(fs18.readFileSync(gitignorePath, "utf8"));
   }
   const sourceExtensions = [
     ".js",
@@ -13972,30 +14359,30 @@ async function optima_validate_logic(worktree) {
   const operationalFolders = [".optima", "templates", "dist"];
   const isHiddenTree2 = (relPath2) => {
     if (!relPath2) return false;
-    return relPath2.split(path17.sep).some((part) => part.startsWith("."));
+    return relPath2.split(path19.sep).some((part) => part.startsWith("."));
   };
-  const firstPathSegment2 = (relPath2) => relPath2.split(path17.sep).filter(Boolean)[0] || "";
+  const firstPathSegment2 = (relPath2) => relPath2.split(path19.sep).filter(Boolean)[0] || "";
   const isOperationalRelPath2 = (relPath2) => {
     if (!relPath2) return false;
     const firstSegment = firstPathSegment2(relPath2);
     if (legacyOperationalRoots.has(firstSegment)) return true;
-    return operationalFolders.some((f) => relPath2 === f || relPath2.startsWith(f + path17.sep));
+    return operationalFolders.some((f) => relPath2 === f || relPath2.startsWith(f + path19.sep));
   };
   const getSectionEntries = (value) => {
     if (Array.isArray(value)) return value;
     if (value && typeof value === "object") return Object.values(value);
     return [];
   };
-  const normalizeRelativePath = (relPath2) => path17.normalize(relPath2).replace(/\\/g, "/").replace(/\/$/, "");
+  const normalizeRelativePath = (relPath2) => path19.normalize(relPath2).replace(/\\/g, "/").replace(/\/$/, "");
   const isSourceDir = (dirPath) => {
-    const dirRelPath = path17.relative(worktree, dirPath);
+    const dirRelPath = path19.relative(worktree, dirPath);
     if (isOperationalRelPath2(dirRelPath)) return false;
-    const items = fs16.readdirSync(dirPath, { withFileTypes: true });
+    const items = fs18.readdirSync(dirPath, { withFileTypes: true });
     for (const item of items) {
-      const childPath = path17.join(dirPath, item.name);
-      const relPath2 = path17.relative(worktree, childPath);
+      const childPath = path19.join(dirPath, item.name);
+      const relPath2 = path19.relative(worktree, childPath);
       if (ig.ignores(relPath2) || isOperationalRelPath2(relPath2)) continue;
-      if (item.isFile() && sourceExtensions.includes(path17.extname(item.name))) return true;
+      if (item.isFile() && sourceExtensions.includes(path19.extname(item.name))) return true;
       if (item.isDirectory()) {
         if (isSourceDir(childPath)) return true;
       }
@@ -14003,7 +14390,7 @@ async function optima_validate_logic(worktree) {
     return false;
   };
   function validateMap(filePath) {
-    const content = fs16.readFileSync(filePath, "utf8");
+    const content = fs18.readFileSync(filePath, "utf8");
     let map;
     try {
       map = import_yaml5.default.parse(content);
@@ -14015,32 +14402,32 @@ async function optima_validate_logic(worktree) {
       errors.push(`${filePath}: Invalid YAML.`);
       return;
     }
-    const dir = path17.dirname(filePath);
+    const dir = path19.dirname(filePath);
     const pathBase = filePath === rootCodemapPath ? worktree : dir;
     const indexedPaths = /* @__PURE__ */ new Set();
     const sectionsToVerify = ["modules", "entrypoints", "sources_of_truth", "links", "internals"];
     for (const section of sectionsToVerify) {
       for (const item of getSectionEntries(map[section])) {
         if (item?.path) {
-          indexedPaths.add(path17.normalize(item.path));
+          indexedPaths.add(path19.normalize(item.path));
           if (section === "links" && (item.path.startsWith("http://") || item.path.startsWith("https://"))) {
             continue;
           }
-          const absPath = path17.isAbsolute(item.path) ? item.path : path17.join(pathBase, item.path);
-          if (!fs16.existsSync(absPath)) {
+          const absPath = path19.isAbsolute(item.path) ? item.path : path19.join(pathBase, item.path);
+          if (!fs18.existsSync(absPath)) {
             errors.push(`${filePath}: ${section.slice(0, -1)} path does not exist: ${item.path}`);
           }
         }
       }
     }
-    const relDir = path17.relative(worktree, dir);
+    const relDir = path19.relative(worktree, dir);
     const isOperational = isOperationalRelPath2(relDir);
     if (map.scope === "module" && !isOperational) {
-      const items = fs16.readdirSync(dir, { withFileTypes: true });
+      const items = fs18.readdirSync(dir, { withFileTypes: true });
       for (const item of items) {
-        if (item.isFile() && sourceExtensions.includes(path17.extname(item.name))) {
+        if (item.isFile() && sourceExtensions.includes(path19.extname(item.name))) {
           if (item.name === "codemap.yml") continue;
-          if (!indexedPaths.has(path17.normalize(item.name))) {
+          if (!indexedPaths.has(path19.normalize(item.name))) {
             errors.push(`${filePath}: Unindexed source file found: '${item.name}'. Every source file must be categorized in a section (e.g., 'internals').`);
           }
         }
@@ -14050,7 +14437,7 @@ async function optima_validate_logic(worktree) {
     for (const key of pathKeys) {
       for (const entry of getSectionEntries(map[key])) {
         if (!entry?.path || entry.path.startsWith("http://") || entry.path.startsWith("https://")) continue;
-        if (path17.isAbsolute(entry.path)) continue;
+        if (path19.isAbsolute(entry.path)) continue;
         const normalizedPath = normalizeRelativePath(entry.path);
         if (!normalizedPath || normalizedPath === ".") continue;
         const parts = normalizedPath.split("/").filter((p) => p && p !== ".");
@@ -14062,18 +14449,18 @@ async function optima_validate_logic(worktree) {
     }
   }
   const walk = (dir) => {
-    const relDir = path17.relative(worktree, dir);
+    const relDir = path19.relative(worktree, dir);
     if (relDir && ig.ignores(relDir)) return;
     if (isOperationalRelPath2(relDir)) return;
     if (isHiddenTree2(relDir)) return;
-    const hasCodemap = fs16.existsSync(path17.join(dir, "codemap.yml"));
-    const items = fs16.readdirSync(dir, { withFileTypes: true });
-    if (!relDir.startsWith(path17.join(".optima", "tasks", "done"))) {
+    const hasCodemap = fs18.existsSync(path19.join(dir, "codemap.yml"));
+    const items = fs18.readdirSync(dir, { withFileTypes: true });
+    if (!relDir.startsWith(path19.join(".optima", "tasks", "done"))) {
       for (const item of items) {
         if (item.isFile() && item.name.endsWith(".md")) {
-          const content = fs16.readFileSync(path17.join(dir, item.name), "utf8");
+          const content = fs18.readFileSync(path19.join(dir, item.name), "utf8");
           if (content.includes("[To be defined]") || content.includes("[Insert ")) {
-            const relFilePath = path17.join(relDir, item.name);
+            const relFilePath = path19.join(relDir, item.name);
             errors.push(`Documentation Placeholder found: '${relFilePath}' still contains [To be defined] or [Insert ...] placeholders.`);
           }
         }
@@ -14083,9 +14470,9 @@ async function optima_validate_logic(worktree) {
     if (relDir !== "" && !hasCodemap && isSourceDir(dir) && !isOperational) {
       errors.push(`Missing CodeMap: Directory '${relDir}' contains source but has no codemap.yml.`);
     }
-    if (hasCodemap) validateMap(path17.join(dir, "codemap.yml"));
+    if (hasCodemap) validateMap(path19.join(dir, "codemap.yml"));
     for (const item of items) {
-      if (item.isDirectory()) walk(path17.join(dir, item.name));
+      if (item.isDirectory()) walk(path19.join(dir, item.name));
     }
   };
   validateMap(rootCodemapPath);
@@ -14099,12 +14486,13 @@ async function optima_validate_logic(worktree) {
 
 // src/plugin.js
 var activeWorkflows = /* @__PURE__ */ new Map();
+var activeQaQueueSchedulers = /* @__PURE__ */ new Map();
 function normalizeWorkflowTaskPath(taskPath) {
   if (typeof taskPath !== "string") return { ok: false, message: "Error: task_path is required." };
   const trimmed = taskPath.trim();
   if (!trimmed) return { ok: false, message: "Error: task_path is required." };
   const normalized = trimmed.replace(/\\/g, "/");
-  if (path18.isAbsolute(trimmed)) return { ok: true, taskPath: trimmed };
+  if (path20.isAbsolute(trimmed)) return { ok: true, taskPath: trimmed };
   if (normalized === "tasks" || normalized.startsWith("tasks/")) {
     return {
       ok: false,
@@ -14121,10 +14509,10 @@ function normalizeWorkflowTaskPath(taskPath) {
 }
 function readTaskMetadata(taskPath, worktree) {
   if (!taskPath) return {};
-  const absoluteTaskPath = path18.isAbsolute(taskPath) ? taskPath : path18.join(worktree, taskPath);
-  if (!fs17.existsSync(absoluteTaskPath)) return {};
+  const absoluteTaskPath = path20.isAbsolute(taskPath) ? taskPath : path20.join(worktree, taskPath);
+  if (!fs19.existsSync(absoluteTaskPath)) return {};
   try {
-    const raw = fs17.readFileSync(absoluteTaskPath, "utf8");
+    const raw = fs19.readFileSync(absoluteTaskPath, "utf8");
     const { data } = parseFrontmatter(raw);
     return {
       complexity: typeof data.complexity === "string" ? data.complexity.trim().toLowerCase() : void 0,
@@ -14147,15 +14535,15 @@ function hasActiveImplementationWorkflow() {
 function resolveSessionToolDirectory({ requestedDirectory, context, pluginWorktree, clickUpWebhookValidation } = {}) {
   const safe = safeWorktreeOrFailure(context, pluginWorktree);
   if (!safe.ok) return { ok: false, error: safe.message };
-  const requested = String(requestedDirectory || "").trim() ? path18.resolve(safe.worktree, String(requestedDirectory).trim()) : safe.worktree;
+  const requested = String(requestedDirectory || "").trim() ? path20.resolve(safe.worktree, String(requestedDirectory).trim()) : safe.worktree;
   if (!isSafeWritableDirectory(requested)) return { ok: false, error: `Directory is not a safe writable directory: ${requested}` };
   if (isSameOrNestedPath(requested, safe.worktree)) return { ok: true, directory: requested, safeWorktree: safe.worktree, scope: "context_worktree" };
   const clickUpBasePath = clickUpWebhookValidation?.complete === true && clickUpWebhookValidation?.ok !== false ? clickUpWebhookValidation.config?.basePath : "";
   if (clickUpBasePath && isSameOrNestedPath(requested, clickUpBasePath)) {
-    return { ok: true, directory: requested, safeWorktree: safe.worktree, scope: "clickup_base_path", clickupBasePath: path18.resolve(clickUpBasePath) };
+    return { ok: true, directory: requested, safeWorktree: safe.worktree, scope: "clickup_base_path", clickupBasePath: path20.resolve(clickUpBasePath) };
   }
   if (clickUpBasePath && isClickUpDerivedWorktreeSibling(requested, clickUpBasePath)) {
-    return { ok: true, directory: requested, safeWorktree: safe.worktree, scope: "clickup_derived_worktree", clickupBasePath: path18.resolve(clickUpBasePath) };
+    return { ok: true, directory: requested, safeWorktree: safe.worktree, scope: "clickup_derived_worktree", clickupBasePath: path20.resolve(clickUpBasePath) };
   }
   return {
     ok: false,
@@ -14170,9 +14558,9 @@ async function OptimaPlugin(input = {}, pluginOptions = {}) {
   const configPath = resolveConfigPath(worktree);
   const discussionRegistry = loadDiscussionRegistry(worktree);
   let repoCfg = { agents: {}, defaults: {}, features: {} };
-  if (fs17.existsSync(configPath)) {
+  if (fs19.existsSync(configPath)) {
     try {
-      repoCfg = import_yaml6.default.parse(fs17.readFileSync(configPath, "utf8")) || repoCfg;
+      repoCfg = import_yaml6.default.parse(fs19.readFileSync(configPath, "utf8")) || repoCfg;
     } catch (e) {
       console.error(`[Optima] Failed to parse config at ${configPath}:`, e);
     }
@@ -14333,6 +14721,134 @@ Evidencia: ${evidencePath}` : ""
       applied
     };
   };
+  const qaLeaseMs = Number(repoCfg.qa?.lease_ms || repoCfg.qa?.leaseMs || DEFAULT_QA_LEASE_MS) || DEFAULT_QA_LEASE_MS;
+  const qaProvider = String(repoCfg.qa?.provider || DEFAULT_QA_PROVIDER);
+  const qaCdpUrl = String(repoCfg.qa?.cdp_url || repoCfg.qa?.cdpUrl || process.env.OPTIMA_QA_CHROME_CDP_URL || "").trim();
+  const qaTaskMetadata = async (taskId) => {
+    if (!taskId || typeof runtimeClickUpClient?.getTask !== "function") return { task: null, metadata: {} };
+    const task = await runtimeClickUpClient.getTask(taskId);
+    const metadata = normalizeAgentMetadataJson(clickUpTaskAgentMetadata(task, clickUpWebhookValidation.config?.routing?.metadataFieldId));
+    return { task, metadata };
+  };
+  const qaSessionFromMetadata = (metadata = {}) => {
+    return metadata.optima?.sessions?.product_manager || metadata.task?.product_manager || metadata.sessions?.product_manager || "";
+  };
+  const qaWorktreeFromMetadata = (metadata = {}) => {
+    return metadata.task?.worktree || metadata.worktree || "";
+  };
+  const applyQaQueuedClickUpState = async (taskId) => {
+    const applied = [];
+    const errors = [];
+    const pmId = String(clickUpWebhookValidation.config?.routing?.productManagerAssigneeId || "").trim();
+    if (!taskId || !clickUpWebhookValidation.complete || !runtimeClickUpClient) return { applied, errors };
+    if (runtimeClickUpClient.updateTaskStatus) {
+      try {
+        await runtimeClickUpClient.updateTaskStatus({ taskId, status: "waiting QA slot" });
+        applied.push("status:waiting QA slot");
+      } catch (error) {
+        errors.push(`status:${error.message}`);
+      }
+    }
+    if (pmId && runtimeClickUpClient.updateTaskAssignees) {
+      try {
+        await runtimeClickUpClient.updateTaskAssignees({ taskId, remove: [pmId] });
+        applied.push("remove_product_manager");
+      } catch (error) {
+        errors.push(`assignees:${error.message}`);
+      }
+    }
+    return { applied, errors };
+  };
+  const wakePromotedQaTask = async (entry, { provider = qaProvider, reason = "qa_slot_available" } = {}) => {
+    const taskId = String(entry?.clickupTaskId || "").trim();
+    const applied = [];
+    const errors = [];
+    if (!taskId || !clickUpWebhookValidation.complete) return { ok: false, reason: "missing_task_or_clickup_config" };
+    const pmId = String(clickUpWebhookValidation.config?.routing?.productManagerAssigneeId || "").trim();
+    const humanIds = Object.values(clickUpWebhookValidation.config?.routing?.humanRoleClickUpIds || {}).map((id) => String(id || "").trim()).filter(Boolean);
+    try {
+      if (runtimeClickUpClient.updateTaskStatus) {
+        await runtimeClickUpClient.updateTaskStatus({ taskId, status: "in progress" });
+        applied.push("status:in progress");
+      }
+    } catch (error) {
+      errors.push(`status:${error.message}`);
+    }
+    try {
+      if (pmId && runtimeClickUpClient.updateTaskAssignees) {
+        await runtimeClickUpClient.updateTaskAssignees({ taskId, add: [pmId], remove: humanIds });
+        applied.push("assign_product_manager");
+      }
+    } catch (error) {
+      errors.push(`assignees:${error.message}`);
+    }
+    let metadata = {};
+    try {
+      metadata = (await qaTaskMetadata(taskId)).metadata;
+    } catch (error) {
+      errors.push(`metadata:${error.message}`);
+    }
+    const sessionId = entry.sessionId || qaSessionFromMetadata(metadata);
+    const directory = entry.worktree || qaWorktreeFromMetadata(metadata);
+    if (sessionId && input.client && typeof sendOpenCodeSessionEvent === "function") {
+      try {
+        const prompt = [
+          `[Optima QA Slot Granted]`,
+          `Provider: ${provider}`,
+          `ClickUp task: ${taskId}`,
+          `Reason: ${reason}`,
+          "",
+          "Ya tienes plaza exclusiva para usar el Chrome QA. Debes llamar a `optima_qa_chrome_command` en menos de 5 minutos para conservar la plaza.",
+          "Puedes conservarla mientras hagas al menos una llamada QA cada 5 minutos.",
+          "Cuando termines, llama obligatoriamente a `optima_qa_finish` para resetear la extensi\xF3n y liberar la cola.",
+          "La pesta\xF1a 0 es intocable: usa \xFAnicamente la pesta\xF1a QA que Optima crea para esta tarea."
+        ].join("\n");
+        await sendOpenCodeSessionEvent(input.client, {
+          sessionId,
+          agent: clickUpWebhookValidation.config.routing?.targetAgent || "workflow_product_manager",
+          text: prompt,
+          directory,
+          opencodeBaseUrl: clickUpWebhookValidation.config.opencode?.baseUrl,
+          fetchImpl: input.fetch,
+          directDelivery: "steer"
+        });
+        applied.push("session_prompt");
+      } catch (error) {
+        errors.push(`session_prompt:${error.message}`);
+      }
+    } else {
+      errors.push("session_prompt:missing_session_or_client");
+    }
+    return { ok: errors.length === 0, taskId, sessionId, directory, applied, errors };
+  };
+  const persistQaState = async (provider, state, transitions = {}) => {
+    const written = writeQaQueueState(state, qaQueueStatePath(provider));
+    const notifications = [];
+    const promoted = transitions.promoted || null;
+    if (promoted?.clickupTaskId) notifications.push(await wakePromotedQaTask(promoted, { provider, reason: transitions.reason || "qa_slot_available" }));
+    return { state: written, notifications };
+  };
+  const scheduleQaQueueReaper = () => {
+    if (input.startQaQueueScheduler === false) return;
+    const provider = qaProvider || DEFAULT_QA_PROVIDER;
+    const schedulerKey = `${provider}:${clickUpWebhookValidation.config?.basePath || worktree}`;
+    if (activeQaQueueSchedulers.has(schedulerKey)) return;
+    const interval = setInterval(async () => {
+      try {
+        const statePath = qaQueueStatePath(provider);
+        const current = readQaQueueState(provider, statePath);
+        const result = releaseExpiredQaSlot(current, { leaseMs: qaLeaseMs });
+        if (result.expired || result.promoted) {
+          await persistQaState(provider, result.state, { promoted: result.promoted, reason: result.expired ? "previous_slot_expired" : "qa_slot_available" });
+        }
+      } catch (error) {
+        appendClickUpWebhookLocalLog(worktree, { type: "qa_queue_reaper_failed", provider, message: error.message });
+      }
+    }, Math.min(6e4, Math.max(1e4, Math.floor(qaLeaseMs / 5))));
+    interval.unref?.();
+    activeQaQueueSchedulers.set(schedulerKey, interval);
+  };
+  scheduleQaQueueReaper();
   const tools = {
     optima_init: tool({
       description: "Initialize the Optima workflow and CodeMap in the current repository",
@@ -14349,10 +14865,10 @@ Evidencia: ${evidencePath}` : ""
         }
         migrateLegacyOptimaLayout(toolWorktree);
         const cfgDir = optimaConfigDir(toolWorktree);
-        if (!fs17.existsSync(cfgDir)) fs17.mkdirSync(cfgDir, { recursive: true });
-        const optimaTmplPath = path18.join(TEMPLATES_DIR, "optima.yaml.template");
-        const codemapTmplPath = path18.join(TEMPLATES_DIR, "codemap.yml.template");
-        if (!fs17.existsSync(optimaTmplPath) || !fs17.existsSync(codemapTmplPath)) {
+        if (!fs19.existsSync(cfgDir)) fs19.mkdirSync(cfgDir, { recursive: true });
+        const optimaTmplPath = path20.join(TEMPLATES_DIR, "optima.yaml.template");
+        const codemapTmplPath = path20.join(TEMPLATES_DIR, "codemap.yml.template");
+        if (!fs19.existsSync(optimaTmplPath) || !fs19.existsSync(codemapTmplPath)) {
           return "Error: Initialization templates not found in plugin.";
         }
         scaffoldOptimaConfig(toolWorktree, requestedTeamMode);
@@ -14473,14 +14989,14 @@ Restart or reload OpenCode manually if the newly scaffolded config or agents are
       async execute(args, context) {
         const safe = safeWorktreeOrFailure(context, worktree);
         if (!safe.ok) return safe.message;
-        const summaryPath = path18.resolve(safe.worktree, args.summary_path || "");
-        if (!fs17.existsSync(summaryPath)) return `FAIL: summary_path not found: ${summaryPath}`;
-        const taskPath = args.task_path ? path18.resolve(safe.worktree, args.task_path) : "";
+        const summaryPath = path20.resolve(safe.worktree, args.summary_path || "");
+        if (!fs19.existsSync(summaryPath)) return `FAIL: summary_path not found: ${summaryPath}`;
+        const taskPath = args.task_path ? path20.resolve(safe.worktree, args.task_path) : "";
         const payload = buildClickUpSummaryPayload({
-          summaryMarkdown: fs17.readFileSync(summaryPath, "utf8"),
-          summaryPath: path18.relative(safe.worktree, summaryPath),
-          taskMarkdown: taskPath && fs17.existsSync(taskPath) ? fs17.readFileSync(taskPath, "utf8") : "",
-          taskPath: taskPath ? path18.relative(safe.worktree, taskPath) : "",
+          summaryMarkdown: fs19.readFileSync(summaryPath, "utf8"),
+          summaryPath: path20.relative(safe.worktree, summaryPath),
+          taskMarkdown: taskPath && fs19.existsSync(taskPath) ? fs19.readFileSync(taskPath, "utf8") : "",
+          taskPath: taskPath ? path20.relative(safe.worktree, taskPath) : "",
           branch: args.branch,
           worktree: args.worktree,
           pr: args.pr
@@ -14573,6 +15089,116 @@ Restart or reload OpenCode manually if the newly scaffolded config or agents are
         }
       }
     }),
+    optima_qa_browser_status: tool({
+      description: "Inspect the shared Optima QA browser and queue state for a provider such as chatgpt.",
+      args: {
+        provider: tool.schema.string().optional().describe("QA provider. Defaults to chatgpt."),
+        clickup_task_id: tool.schema.string().optional().describe("Optional ClickUp task id to identify its QA tab."),
+        cdp_url: tool.schema.string().optional().describe("Optional Chrome DevTools URL. Defaults to configured QA URL or http://127.0.0.1:9222.")
+      },
+      async execute(args = {}) {
+        const provider = String(args.provider || qaProvider || DEFAULT_QA_PROVIDER);
+        const state = readQaQueueState(provider);
+        const browser = await qaBrowserStatus({ provider, cdpUrl: args.cdp_url || qaCdpUrl, clickupTaskId: args.clickup_task_id || "" });
+        return JSON.stringify({ ok: browser.ok !== false, provider, leaseMs: qaLeaseMs, queue: state, browser }, null, 2);
+      }
+    }),
+    optima_qa_request_slot: tool({
+      description: "Request the exclusive QA browser slot for a ClickUp task. If busy, Optima queues the task, marks it waiting QA slot, and removes Product Manager assignment.",
+      args: {
+        clickup_task_id: tool.schema.string().describe("ClickUp task id requesting the QA slot"),
+        provider: tool.schema.string().optional().describe("QA provider. Defaults to chatgpt."),
+        session_id: tool.schema.string().optional().describe("Optional OpenCode session id to wake when the slot is granted later"),
+        worktree: tool.schema.string().optional().describe("Optional task worktree/directory for session wakeups"),
+        reason: tool.schema.string().optional().describe("Short reason/scenario for requesting the QA slot")
+      },
+      async execute(args = {}) {
+        const provider = String(args.provider || qaProvider || DEFAULT_QA_PROVIDER);
+        const pathToState = qaQueueStatePath(provider);
+        const current = readQaQueueState(provider, pathToState);
+        const result = requestQaSlot(current, {
+          clickupTaskId: args.clickup_task_id,
+          sessionId: args.session_id,
+          worktree: args.worktree,
+          reason: args.reason,
+          leaseMs: qaLeaseMs
+        });
+        let queuedClickUp = null;
+        if (result.action === "queued") queuedClickUp = await applyQaQueuedClickUpState(args.clickup_task_id);
+        const persisted = await persistQaState(provider, result.state, { promoted: result.promoted, reason: result.expired ? "previous_slot_expired" : "qa_slot_available" });
+        const guidance = result.ok ? "QA slot granted. Use optima_qa_chrome_command within 5 minutes and then at least once every 5 minutes. Use optima_qa_finish when done." : "QA slot busy. Task has been queued; stop work on QA, wait for Optima to reassign/wake the session when your slot is granted.";
+        return JSON.stringify({ ...result, state: persisted.state, notifications: persisted.notifications, queuedClickUp, guidance }, null, 2);
+      }
+    }),
+    optima_qa_chrome_command: tool({
+      description: "Run one flexible Playwright/CDP command against the shared QA Chrome for the active ClickUp task. The persistent tab 0 is never used; Optima creates/reuses a task QA tab.",
+      args: {
+        clickup_task_id: tool.schema.string().describe("ClickUp task id that currently owns the QA slot"),
+        provider: tool.schema.string().optional().describe("QA provider. Defaults to chatgpt."),
+        command_json: tool.schema.string().describe("JSON command object, or raw async JS script. Actions: status, goto, evaluate, screenshot, set_input_files, script."),
+        cdp_url: tool.schema.string().optional().describe("Optional Chrome DevTools URL"),
+        start_url: tool.schema.string().optional().describe("Initial URL for a new QA tab. Defaults to https://chatgpt.com/")
+      },
+      async execute(args = {}) {
+        const provider = String(args.provider || qaProvider || DEFAULT_QA_PROVIDER);
+        const pathToState = qaQueueStatePath(provider);
+        const current = readQaQueueState(provider, pathToState);
+        const touched = touchQaSlot(current, { clickupTaskId: args.clickup_task_id, leaseMs: qaLeaseMs });
+        const persisted = await persistQaState(provider, touched.state, { promoted: touched.promoted, reason: touched.expired ? "previous_slot_expired" : "qa_slot_available" });
+        if (!touched.ok) {
+          return JSON.stringify({
+            ok: false,
+            action: touched.action,
+            active: persisted.state.active,
+            queue: persisted.state.queue,
+            notifications: persisted.notifications,
+            guidance: "You do not own the QA slot. Call optima_qa_request_slot and stop if queued."
+          }, null, 2);
+        }
+        try {
+          const result = await qaRunChromeCommand({
+            provider,
+            cdpUrl: args.cdp_url || qaCdpUrl,
+            clickupTaskId: args.clickup_task_id,
+            commandJson: args.command_json,
+            startUrl: args.start_url || "https://chatgpt.com/"
+          });
+          return JSON.stringify({ ok: true, lease: persisted.state.active, notifications: persisted.notifications, chrome: result }, null, 2);
+        } catch (error) {
+          return JSON.stringify({ ok: false, error: error.message, lease: persisted.state.active, notifications: persisted.notifications }, null, 2);
+        }
+      }
+    }),
+    optima_qa_finish: tool({
+      description: "Finish the active QA browser slot, reset/reload the extension, release the slot, and wake the next queued ClickUp task if any.",
+      args: {
+        clickup_task_id: tool.schema.string().describe("ClickUp task id finishing QA"),
+        provider: tool.schema.string().optional().describe("QA provider. Defaults to chatgpt."),
+        cdp_url: tool.schema.string().optional().describe("Optional Chrome DevTools URL"),
+        extension_path: tool.schema.string().optional().describe("Optional extension path to sync into the stable QA extension-under-test directory before reset/reload"),
+        extension_id: tool.schema.string().optional().describe("Optional Chrome extension id when multiple extension service workers exist"),
+        reset_extension: tool.schema.boolean().optional().describe("Defaults true. Clear extension storage/caches/IndexedDB."),
+        reload_extension: tool.schema.boolean().optional().describe("Defaults true. Reload the extension service worker after reset.")
+      },
+      async execute(args = {}) {
+        const provider = String(args.provider || qaProvider || DEFAULT_QA_PROVIDER);
+        const reset = args.reset_extension !== false;
+        const reload = args.reload_extension !== false;
+        const extension = await qaPrepareExtension({
+          provider,
+          cdpUrl: args.cdp_url || qaCdpUrl,
+          extensionPath: args.extension_path || "",
+          extensionId: args.extension_id || "",
+          reset,
+          reload
+        }).catch((error) => ({ ok: false, error: error.message }));
+        const pathToState = qaQueueStatePath(provider);
+        const current = readQaQueueState(provider, pathToState);
+        const result = finishQaSlot(current, { clickupTaskId: args.clickup_task_id, leaseMs: qaLeaseMs });
+        const persisted = await persistQaState(provider, result.state, { promoted: result.promoted, reason: "previous_finished" });
+        return JSON.stringify({ ...result, state: persisted.state, notifications: persisted.notifications, extension }, null, 2);
+      }
+    }),
     optima_clickup_create_subtasks: tool({
       description: "Generate dry-run ClickUp subtask creation payloads from a strict Markdown ## Subtasks section",
       args: {
@@ -14585,12 +15211,12 @@ Restart or reload OpenCode manually if the newly scaffolded config or agents are
       async execute(args, context) {
         const safe = safeWorktreeOrFailure(context, worktree);
         if (!safe.ok) return safe.message;
-        const markdownPath = path18.resolve(safe.worktree, args.markdown_path || "");
-        if (!fs17.existsSync(markdownPath)) return `FAIL: markdown_path not found: ${markdownPath}`;
+        const markdownPath = path20.resolve(safe.worktree, args.markdown_path || "");
+        if (!fs19.existsSync(markdownPath)) return `FAIL: markdown_path not found: ${markdownPath}`;
         const payload = buildClickUpCreateSubtasksPayload({
           parentTaskId: args.parent_task_id,
-          markdown: fs17.readFileSync(markdownPath, "utf8"),
-          sourcePath: path18.relative(safe.worktree, markdownPath),
+          markdown: fs19.readFileSync(markdownPath, "utf8"),
+          sourcePath: path20.relative(safe.worktree, markdownPath),
           parentBranch: args.parent_branch,
           parentTaskType: args.parent_task_type || "Tarea",
           apply: String(args.apply || "").toLowerCase() === "true"
@@ -14960,7 +15586,7 @@ Backfilled messages: ${backfilled}`;
         if (!existing) {
           return "FAIL: No active discussion exists for this session.";
         }
-        const discussionPath = path18.join(toolWorktree, existing.transcriptPath);
+        const discussionPath = path20.join(toolWorktree, existing.transcriptPath);
         setDiscussionStatus(discussionPath, "summarizing");
         existing.status = "summarizing";
         saveDiscussionRegistry(toolWorktree, toolRegistry);
@@ -15012,7 +15638,7 @@ Reason: ${err.message}`;
         try {
           const sessionResult = await client.session.create({
             query: { directory: workflowDirectory },
-            body: { title: `Workflow Run: ${path18.basename(workflowTaskPath)}` }
+            body: { title: `Workflow Run: ${path20.basename(workflowTaskPath)}` }
           });
           const sessionId = sessionResult.data.id;
           activeWorkflows.set(sessionId, { pmaSessionId, taskPath: workflowTaskPath, track: workflowTrack, directory: workflowDirectory });