nodebench-mcp 2.25.0 → 2.26.0

package/dist/tools/sessionMemoryTools.js

@@ -55,12 +55,16 @@ export const sessionMemoryTools = [
                     items: { type: "string" },
                     description: "Tags for searchability (e.g. ['auth', 'jwt', 'security'])",
                 },
+                citedFrom: {
+                    type: "string",
+                    description: "Quote or paraphrase the specific part of the user's original request this note fulfills. Enables completion traceability — links deliverables back to asks.",
+                },
             },
             required: ["title", "content"],
         },
         handler: async (args) => {
             ensureNotesDir();
-            const { title, content, category = "finding", tags = [], } = args;
+            const { title, content, category = "finding", tags = [], citedFrom, } = args;
             const now = new Date();
             const dateStr = now.toISOString().slice(0, 10);
             const timeStr = now.toISOString().slice(11, 19).replace(/:/g, "");
@@ -76,6 +80,7 @@ export const sessionMemoryTools = [
                 `**Category:** ${category}`,
                 `**Date:** ${now.toISOString()}`,
                 tags.length > 0 ? `**Tags:** ${tags.join(", ")}` : "",
+                citedFrom ? `**Cited From:** ${citedFrom}` : "",
                 "",
                 "---",
                 "",
@@ -221,11 +226,15 @@ export const sessionMemoryTools = [
                     type: "boolean",
                     description: "Include recent relevant learnings (default: true)",
                 },
+                originalRequest: {
+                    type: "string",
+                    description: "The original user request verbatim or paraphrased. Returned in context to anchor traceability between asks and deliverables.",
+                },
             },
             required: [],
         },
         handler: async (args) => {
-            const { taskDescription = "", includeNotes = true, includeGaps = true, includeLearnings = true, } = args;
+            const { taskDescription = "", includeNotes = true, includeGaps = true, includeLearnings = true, originalRequest, } = args;
             const db = getDb();
             const context = {};
             // 1. Active verification cycle
@@ -329,6 +338,9 @@ export const sessionMemoryTools = [
             catch {
                 /* table may not exist yet */
             }
+            if (originalRequest) {
+                context.originalRequest = originalRequest;
+            }
             return {
                 taskDescription: taskDescription ||
                     "(Not specified — re-state your original goal to anchor attention)",

package/dist/tools/sessionMemoryTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionMemoryTools.js","sourceRoot":"","sources":["../../src/tools/sessionMemoryTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AAEjE,SAAS,cAAc;IACrB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,4EAA4E;IAC5E;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,6OAA6O;QAC/O,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,mGAAmG;iBACtG;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,oIAAoI;iBACvI;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACJ,SAAS;wBACT,UAAU;wBACV,UAAU;wBACV,SAAS;wBACT,UAAU;wBACV,cAAc;wBACd,WAAW;qBACZ;oBACD,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,2DAA2D;iBAC9D;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;SAC/B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,EAAE,CAAC;YACjB,MAAM,EACJ,KAAK,EACL,OAAO,EACP,QAAQ,GAAG,SAAS,EACpB,IAAI,GAAG,EAAE,GACV,GAAG,IAAI,CAAC;YACT,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClE,MAAM,SAAS,GAAG,KAAK;iBACpB,WAAW,EAAE;iBACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;iBAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChB,MAAM,QAAQ,GAAG,GAAG,OAAO,IAAI,OAAO,IAAI,SAAS,KAAK,CAAC;YACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAEhD,MAAM,QAAQ,GAAG;gBACf,KAAK,KAAK,EAAE;gBACZ,EAAE;gBACF,iBAAiB,QAAQ,EAAE;gBAC3B,aAAa,GAAG,CAAC,WAAW,EAAE,EAAE;gBAChC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;gBACrD,EAAE;gBACF,KAAK;gBACL,EAAE;gBACF,OAAO;gBACP,EAAE;aACH;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAE9C,kDAAkD;YAClD,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;gBACnB,EAAE,CAAC,OAAO,CACR;sDAC4C,CAC7C,CAAC,GAAG,CACH,KAAK,CAAC,MAAM,CAAC,EACb,gBAAgB,SAAS,EAAE,EAC3B,kBAAkB,KAAK,OAAO,OAAO,EAAE,EACvC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,EACvF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EACpB,IAAI,CACL,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,kCAAkC;YACpC,CAAC;YAED,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,QAAQ;gBACR,QAAQ;gBACR,KAAK;gBACL,QAAQ;gBACR,GAAG,EAAE,2HAA2H;aACjI,CAAC;QACJ,CAAC;KACF;IAED,4EAA4E;IAC5E;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,sMAAsM;QACxM,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,uEAAuE;iBAC1E;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACJ,SAAS;wBACT,UAAU;wBACV,UAAU;wBACV,SAAS;wBACT,UAAU;wBACV,cAAc;wBACd,WAAW;qBACZ;oBACD,WAAW,EAAE,oCAAoC;iBAClD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yDAAyD;iBAC5D;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;iBACjD;aACF;YACD,QAAQ,EAAE,EAAE;SACb;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,cAAc,EAAE,CAAC;YACjB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;YAErD,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAEzE,qEAAqE;YACrE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YAEzC,iBAAiB;YACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC3B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YACxD,CAAC;iBAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACjB,iBAAiB;gBACjB,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YACzD,CAAC;YAED,uCAAuC;YACvC,MAAM,KAAK,GAMN,EAAE,CAAC;YAER,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;oBAAE,MAAM;gBAEjC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBAErE,iCAAiC;gBACjC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;gBAChE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBAExD,MAAM,YAAY,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;gBACrD,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;gBAC1C,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAEtC,kBAAkB;gBAClB,IAAI,QAAQ,IAAI,YAAY,KAAK,QAAQ;oBAAE,SAAS;gBAEpD,iBAAiB;gBACjB,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBACnE,SAAS;gBAEX,KAAK,CAAC,IAAI,CAAC;oBACT,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,SAAS;oBAChB,QAAQ,EAAE,YAAY;oBACtB,OAAO;oBACP,IAAI,EAAE,QAAQ;iBACf,CAAC,CAAC;YACL,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,KAAK,CAAC,MAAM;gBACvB,UAAU,EAAE,KAAK,CAAC,MAAM;gBACxB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBAChC,WAAW,EAAE,CAAC,CAAC,OAAO;iBACvB,CAAC,CAAC;gBACH,GAAG,EACD,KAAK,CAAC,MAAM,KAAK,CAAC;oBAChB,CAAC,CAAC,gFAAgF;oBAClF,CAAC,CAAC,gEAAgE;aACvE,CAAC;QACJ,CAAC;KACF;IAED,4EAA4E;IAC5E;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,0VAA0V;QAC5V,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,mFAAmF;iBACtF;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,gEAAgE;iBACnE;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,gDAAgD;iBACnD;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,mDAAmD;iBACtD;aACF;YACD,QAAQ,EAAE,EAAE;SACb;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,EACJ,eAAe,GAAG,EAAE,EACpB,YAAY,GAAG,IAAI,EACnB,WAAW,GAAG,IAAI,EAClB,gBAAgB,GAAG,IAAI,GACxB,GAAG,IAAI,CAAC;YACT,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;YACnB,MAAM,OAAO,GAA4B,EAAE,CAAC;YAE5C,+BAA+B;YAC/B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,EAAE;qBACnB,OAAO,CACN,4FAA4F,CAC7F;qBACA,GAAG,EAAS,CAAC;gBAChB,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,MAAM,GAAG,EAAE;yBACd,OAAO,CACN,yFAAyF,CAC1F;yBACA,GAAG,CAAC,WAAW,CAAC,EAAE,CAAU,CAAC;oBAChC,OAAO,CAAC,WAAW,GAAG;wBACpB,EAAE,EAAE,WAAW,CAAC,EAAE;wBAClB,KAAK,EAAE,WAAW,CAAC,KAAK;wBACxB,YAAY,EAAE,WAAW,CAAC,aAAa;wBACvC,MAAM,EAAE,WAAW,CAAC,MAAM;wBAC1B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;4BAC9B,KAAK,EAAE,CAAC,CAAC,KAAK;4BACd,MAAM,EAAE,CAAC,CAAC,MAAM;4BAChB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;yBAClC,CAAC,CAAC;qBACJ,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;YAED,eAAe;YACf,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,EAAE;yBACZ,OAAO,CACN,oLAAoL,CACrL;yBACA,GAAG,EAAW,CAAC;oBAClB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACpB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;4BACvC,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;4BACzC,QAAQ,EAAE,CAAC,CAAC,QAAQ;yBACrB,CAAC,CAAC,CAAC;oBACN,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,6BAA6B;gBAC/B,CAAC;YACH,CAAC;YAED,sBAAsB;YACtB,IAAI,gBAAgB,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,EAAE;yBACjB,OAAO,CACN,+EAA+E,CAChF;yBACA,GAAG,EAAW,CAAC;oBAClB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;4BACnD,GAAG,EAAE,CAAC,CAAC,GAAG;4BACV,QAAQ,EAAE,CAAC,CAAC,QAAQ;4BACpB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;yBAClC,CAAC,CAAC,CAAC;oBACN,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,6BAA6B;gBAC/B,CAAC;YACH,CAAC;YAED,2BAA2B;YAC3B,IAAI,YAAY,EAAE,CAAC;gBACjB,cAAc,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpD,MAAM,KAAK,GAAG,EAAE;qBACb,WAAW,CAAC,SAAS,CAAC;qBACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;qBACvD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;qBAClC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAEf,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;wBACnC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,EACvB,OAAO,CACR,CAAC;wBACF,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;wBAC9C,OAAO;4BACL,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;4BAC3B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;yBAC/B,CAAC;oBACJ,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,EAAE;qBACb,OAAO,CACN,4MAA4M,CAC7M;qBACA,GAAG,EAAS,CAAC;gBAChB,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,CAAC,YAAY,GAAG;wBACrB,cAAc,EAAE,KAAK,CAAC,KAAK;wBAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,gBAAgB,EACd,KAAK,CAAC,KAAK,GAAG,EAAE;4BACd,CAAC,CAAC,+EAA+E;4BACjF,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE;gCAChB,CAAC,CAAC,+DAA+D;gCACjE,CAAC,CAAC,uCAAuC;qBAChD,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;YAED,OAAO;gBACL,eAAe,EACb,eAAe;oBACf,mEAAmE;gBACrE,OAAO;gBACP,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,SAAS,EACP,iKAAiK;gBACnK,SAAS,EAAE;oBACT,iDAAiD;oBACjD,2CAA2C;oBAC3C,+CAA+C;oBAC/C,4CAA4C;iBAC7C;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}
+{"version":3,"file":"sessionMemoryTools.js","sourceRoot":"","sources":["../../src/tools/sessionMemoryTools.ts"],"names":[],"mappings":"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"}

package/dist/tools/toolRegistry.d.ts

@@ -12,13 +12,8 @@
 export interface ToolQuickRef {
     /** 1-2 sentence guidance on what to do after calling this tool */
     nextAction: string;
-    /** Tools commonly used after this one (workflow-sequential adjacency) */
+    /** Tools commonly used after this one */
     nextTools: string[];
-    /** Conceptually related tools — same problem domain but different workflow paths.
-     *  Unlike nextTools (sequential: "do X then Y"), relatedTools is associative:
-     *  "if you're doing X, you might also want Y". Auto-derived from category siblings,
-     *  domain clusters, and tag overlap. Enables multi-hop graph traversal. */
-    relatedTools?: string[];
     /** Which methodology to consult for full guidance */
     methodology?: string;
     /** Short tip for effective use */
@@ -38,9 +33,6 @@ export interface ToolRegistryEntry {
 export declare const TOOL_REGISTRY: Map<string, ToolRegistryEntry>;
 /** All registry entries as array */
 export declare const ALL_REGISTRY_ENTRIES: ToolRegistryEntry[];
-export declare function _setDomainClustersRef(clusters: Record<string, string[]>): void;
-/** Populate relatedTools for all registry entries. Called once at module load after DOMAIN_CLUSTERS exists. */
-export declare function _populateRelatedTools(): void;
 /** Get quick ref for a tool, with fallback for unregistered tools */
 export declare function getQuickRef(toolName: string): ToolQuickRef | null;
 /** Get all tools in a category */
@@ -59,10 +51,6 @@ export interface SearchResult {
     quickRef: ToolQuickRef;
     phase: string;
     tags: string[];
-    /** Depth at which this result was found (0 = direct match, 1+ = expansion hop) */
-    depth?: number;
-    /** Tools that led to this result being included via relatedTools expansion */
-    expandedFrom?: string[];
 }
 export type SearchMode = "hybrid" | "fuzzy" | "regex" | "prefix" | "semantic" | "exact" | "dense" | "embedding";
 /** Tokenize text into lowercase words (alpha + underscore only) */
@@ -120,8 +108,6 @@ export declare function hybridSearch(query: string, tools: Array<{
     /** If true, search ALL_REGISTRY_ENTRIES (full 175-tool registry) regardless of loaded preset.
      *  Needed for dynamic loading: discover_tools must find unloaded tools to suggest load_toolset. */
     searchFullRegistry?: boolean;
-    /** Number of results to skip for cursor-based pagination. Default: 0. */
-    offset?: number;
     /** Ablation flags: disable individual strategies to measure their contribution */
     ablation?: {
         disableSynonyms?: boolean;

package/dist/tools/toolRegistry.js

@@ -2073,14 +2073,14 @@ const REGISTRY_ENTRIES = [
     {
         name: "ingest_dive_screenshots",
         category: "ui_ux_dive",
-        tags: ["ui", "screenshot", "ingest", "import", "bulk", "png", "jpg", "gallery", "dive", "disk", "file"],
+        tags: ["ui", "screenshot", "ingest", "import", "bulk", "disk", "gallery", "dive", "png", "jpg"],
         quickRef: {
-            nextAction: "Screenshots ingested into session DB. View them in the dashboard gallery or reference in dive_changelog entries.",
-            nextTools: ["dive_changelog", "get_dive_report", "open_dive_dashboard"],
+            nextAction: "Screenshots ingested into dive session. View them in the dashboard or use dive_screenshot to capture new ones.",
+            nextTools: ["dive_screenshot", "tag_ui_bug", "end_component_flow", "get_dive_tree"],
             methodology: "agentic_vision",
-            tip: "Use after external Playwright MCP captures screenshots to disk. Scans directory recursively, base64-encodes, and inserts into the session DB for dashboard display.",
+            tip: "Scans a directory for PNG/JPG files and bulk-imports them into a dive session's screenshot gallery. Use after external Playwright captures.",
         },
-        phase: "utility",
+        phase: "test",
     },
     // ═══════════════════════════════════════════
     // UI/UX DIVE V2 — Deep interaction testing,
@@ -2266,7 +2266,7 @@ const REGISTRY_ENTRIES = [
     {
         name: "register_skill",
         category: "skill_update",
-        tags: ["skill", "rule", "register", "source", "hash", "frontmatter", "provenance", "memory", "agents-md", "cursor", "windsurf", "update", "reexamine", "related_"],
+        tags: ["skill", "rule", "register", "source", "hash", "frontmatter", "provenance", "memory", "agents-md", "cursor", "windsurf", "update"],
         quickRef: {
             nextAction: "Skill registered. Use check_skill_freshness periodically to detect when source files change.",
             nextTools: ["check_skill_freshness", "list_skills"],
@@ -2312,28 +2312,6 @@ const REGISTRY_ENTRIES = [
         phase: "utility",
     },
     // ═══════════════════════════════════════════
-    // RE-EXAMINE 11/10 — Fresh-eyes quality pass
-    // Modular rules: reexamine_process → a11y,
-    // resilience, polish, keyboard, performance
-    // Cross-ref via related_ frontmatter hops
-    // ═══════════════════════════════════════════
-    // NOTE: These are not MCP tools — they are rule
-    // files in .cursor/rules/ and .windsurf/rules/.
-    // The skill_update tools above (register_skill,
-    // check_skill_freshness) track their freshness.
-    // The related_ field in each rule's frontmatter
-    // enables one-hop and two-hop cross-referencing:
-    //
-    //   reexamine_process
-    //     └─ related_: [a11y, resilience, polish, keyboard, performance]
-    //          └─ reexamine_a11y.related_: [keyboard, polish, process]
-    //          └─ reexamine_resilience.related_: [performance, process, polish]
-    //          └─ reexamine_polish.related_: [a11y, performance, process]
-    //          └─ reexamine_keyboard.related_: [a11y, process]
-    //          └─ reexamine_performance.related_: [resilience, polish, process]
-    //
-    // Two-hop example: process → a11y → keyboard (discovers keyboard via a11y)
-    // ═══════════════════════════════════════════
     // MCP BRIDGE — Connect external MCP servers
     // ═══════════════════════════════════════════
     {
@@ -2432,43 +2410,55 @@ const REGISTRY_ENTRIES = [
         phase: "implement",
     },
     // ═══════════════════════════════════════════
-    // PR REPORT — Visual PR creation from dives
+    // QA ORCHESTRATION — Overstory multi-agent QA
     // ═══════════════════════════════════════════
     {
-        name: "generate_pr_report",
-        category: "pr_report",
-        tags: ["pr", "pull-request", "report", "markdown", "visual", "screenshot", "before-after", "timeline", "changelog", "dive", "github", "review", "evidence"],
+        name: "overstory_fleet_status",
+        category: "qa_orchestration",
+        tags: ["overstory", "agent", "fleet", "status", "health", "multi-agent", "orchestration", "qa", "dogfood", "worktree"],
         quickRef: {
-            nextAction: "PR report generated. Use the markdown with `gh pr create --body-file` or call create_visual_pr for end-to-end PR creation.",
-            nextTools: ["create_visual_pr", "export_pr_screenshots", "review_pr_checklist"],
-            methodology: "agentic_vision",
-            tip: "Pass asset_dir to export screenshots as PNGs that can be committed alongside the PR.",
+            nextAction: "Review agent states. If agents are idle, run dogfood:overstory to start a QA session.",
+            nextTools: ["overstory_qa_summary", "overstory_mail_log", "run_visual_qa_suite"],
+            methodology: "ai_flywheel",
+            tip: "Reads .overstory/agent-manifest.json and overstory.db. Shows configured agents, capabilities, gate policy, and live agent health.",
         },
-        phase: "ship",
+        phase: "utility",
     },
     {
-        name: "export_pr_screenshots",
-        category: "pr_report",
-        tags: ["pr", "screenshot", "export", "png", "before-after", "visual", "evidence", "assets", "commit", "dive", "changelog", "fix"],
+        name: "overstory_qa_summary",
+        category: "qa_orchestration",
+        tags: ["overstory", "qa", "gate", "summary", "stability", "grade", "ssim", "triage", "p0", "p1", "dogfood"],
         quickRef: {
-            nextAction: "Screenshots exported. Stage and commit them, then use generate_pr_report or create_visual_pr to reference them in the PR body.",
-            nextTools: ["generate_pr_report", "create_visual_pr"],
-            methodology: "agentic_vision",
-            tip: "Naming convention: {index}-{type}-before.png / after.png. Commit these with your branch.",
+            nextAction: "If gate fails, check failing routes and fix p0/p1 issues. If gate passes, proceed to merge.",
+            nextTools: ["overstory_mail_log", "overstory_fleet_status", "run_visual_qa_suite", "burst_capture"],
+            methodology: "ai_flywheel",
+            tip: "Aggregates SSIM stability grades from visual_qa_runs and Gemini QA triage from Overstory mail. Returns gate pass/fail verdict.",
         },
-        phase: "ship",
+        phase: "verify",
     },
     {
-        name: "create_visual_pr",
-        category: "pr_report",
-        tags: ["pr", "pull-request", "create", "github", "gh", "visual", "screenshot", "end-to-end", "push", "merge", "review", "dive", "timeline", "evidence"],
+        name: "overstory_mail_log",
+        category: "qa_orchestration",
+        tags: ["overstory", "mail", "log", "message", "route", "triage", "dispatch", "agent", "coordination"],
         quickRef: {
-            nextAction: "PR created! Share the URL with reviewers. The PR body contains visual evidence and dashboard links for interactive browsing.",
-            nextTools: ["review_pr_checklist", "enforce_merge_gate"],
-            methodology: "agentic_vision",
-            tip: "Set draft:true for WIP PRs. Combines export_pr_screenshots + generate_pr_report + gh pr create in one call.",
+            nextAction: "Review messages to understand QA session state. Filter by type or agent for focused view.",
+            nextTools: ["overstory_qa_summary", "overstory_fleet_status", "overstory_merge_queue"],
+            methodology: "ai_flywheel",
+            tip: "Supports type_filter (result/dispatch/worker_done/escalation) and agent_filter. Shows structured mail payloads from the QA agent fleet.",
         },
-        phase: "ship",
+        phase: "utility",
+    },
+    {
+        name: "overstory_merge_queue",
+        category: "qa_orchestration",
+        tags: ["overstory", "merge", "queue", "branch", "conflict", "gate", "builder", "qa", "resolution"],
+        quickRef: {
+            nextAction: "If branches are blocked, check QA gate failures. If pending, trigger merge with overstory merge --all.",
+            nextTools: ["overstory_qa_summary", "overstory_mail_log", "overstory_fleet_status"],
+            methodology: "ai_flywheel",
+            tip: "Shows FIFO merge queue with conflict resolution tiers. Use include_completed:true to see merge history.",
+        },
+        phase: "utility",
     },
 ];
 // ── Exported lookup structures ───────────────────────────────────────────
@@ -2476,110 +2466,6 @@ const REGISTRY_ENTRIES = [
 export const TOOL_REGISTRY = new Map(REGISTRY_ENTRIES.map((e) => [e.name, e]));
 /** All registry entries as array */
 export const ALL_REGISTRY_ENTRIES = REGISTRY_ENTRIES;
-// ── Auto-derive relatedTools for entries that don't have manual overrides ──
-// Uses 3 signals: same-category siblings, DOMAIN_CLUSTERS neighbors, tag overlap.
-// Must run after REGISTRY_ENTRIES is fully built. Forward-reference to DOMAIN_CLUSTERS
-// is fine because this runs at module load time (DOMAIN_CLUSTERS is defined below).
-/** Late-init: populated by _populateRelatedTools() at bottom of file */
-let _domainClusters = null;
-export function _setDomainClustersRef(clusters) {
-    _domainClusters = clusters;
-}
-function computeRelatedTools(entry) {
-    // If manually specified, use that
-    if (entry.quickRef.relatedTools && entry.quickRef.relatedTools.length > 0) {
-        return entry.quickRef.relatedTools;
-    }
-    const related = new Set();
-    const nextToolsSet = new Set(entry.quickRef.nextTools);
-    // 1. Same-category siblings (excluding self and nextTools), up to 3
-    let sibCount = 0;
-    for (const e of REGISTRY_ENTRIES) {
-        if (sibCount >= 3)
-            break;
-        if (e.category === entry.category && e.name !== entry.name && !nextToolsSet.has(e.name)) {
-            related.add(e.name);
-            sibCount++;
-        }
-    }
-    // 2. DOMAIN_CLUSTERS neighbors: tools from related categories, up to 2
-    if (_domainClusters) {
-        let clusterCount = 0;
-        for (const cluster of Object.values(_domainClusters)) {
-            if (clusterCount >= 2)
-                break;
-            if (cluster.includes(entry.category)) {
-                for (const neighborCat of cluster) {
-                    if (clusterCount >= 2)
-                        break;
-                    if (neighborCat === entry.category)
-                        continue;
-                    for (const e of REGISTRY_ENTRIES) {
-                        if (e.category === neighborCat && !nextToolsSet.has(e.name) && !related.has(e.name)) {
-                            related.add(e.name);
-                            clusterCount++;
-                            break; // one tool per neighbor category
-                        }
-                    }
-                }
-            }
-        }
-    }
-    // 3. Tag overlap: tools sharing 2+ tags (not in nextTools or already related), up to 2
-    const myTags = new Set(entry.tags);
-    let tagCount = 0;
-    for (const other of REGISTRY_ENTRIES) {
-        if (tagCount >= 2)
-            break;
-        if (other.name === entry.name || nextToolsSet.has(other.name) || related.has(other.name))
-            continue;
-        let overlap = 0;
-        for (const t of other.tags) {
-            if (myTags.has(t))
-                overlap++;
-            if (overlap >= 2)
-                break;
-        }
-        if (overlap >= 2) {
-            related.add(other.name);
-            tagCount++;
-        }
-    }
-    // 4. Fallback: if still empty (small category, all siblings in nextTools), accept 1-tag overlap
-    if (related.size === 0) {
-        for (const other of REGISTRY_ENTRIES) {
-            if (related.size >= 3)
-                break;
-            if (other.name === entry.name || nextToolsSet.has(other.name))
-                continue;
-            const hasTagOverlap = other.tags.some((t) => myTags.has(t));
-            if (hasTagOverlap) {
-                related.add(other.name);
-            }
-        }
-    }
-    // 5. Last resort: if STILL empty, pick tools from the same phase (workflow adjacency)
-    if (related.size === 0) {
-        for (const other of REGISTRY_ENTRIES) {
-            if (related.size >= 3)
-                break;
-            if (other.name === entry.name || nextToolsSet.has(other.name))
-                continue;
-            if (other.phase === entry.phase) {
-                related.add(other.name);
-            }
-        }
-    }
-    return [...related].slice(0, 7); // hard cap at 7
-}
-/** Populate relatedTools for all registry entries. Called once at module load after DOMAIN_CLUSTERS exists. */
-export function _populateRelatedTools() {
-    for (const entry of REGISTRY_ENTRIES) {
-        if (!entry.quickRef.relatedTools || entry.quickRef.relatedTools.length === 0) {
-            entry.quickRef.relatedTools = computeRelatedTools(entry);
-        }
-    }
-}
 /** Get quick ref for a tool, with fallback for unregistered tools */
 export function getQuickRef(toolName) {
     return TOOL_REGISTRY.get(toolName)?.quickRef ?? null;
@@ -2631,7 +2517,7 @@ const CATEGORY_COMPLEXITY = {
     email: "medium",
     rss: "low",
     architect: "low",
-    pr_report: "medium",
+    qa_orchestration: "low",
 };
 /** Per-tool complexity overrides (when category default is wrong) */
 const TOOL_COMPLEXITY_OVERRIDES = {
@@ -2910,9 +2796,6 @@ const DOMAIN_CLUSTERS = {
     writing: ["research_writing", "documentation"],
     measurement: ["eval", "benchmark", "self_eval"],
 };
-// Wire up domain clusters and auto-populate relatedTools for all registry entries
-_setDomainClustersRef(DOMAIN_CLUSTERS);
-_populateRelatedTools();
 // ── Execution trace edges — co-occurrence mining from tool_call_log ────────
 // Based on Agent-as-a-Graph (arxiv:2511.18194): execution trace edges
 // mine sequential co-occurrence patterns to discover implicit tool relationships.
@@ -2953,36 +2836,17 @@ export function _setDbAccessor(accessor) {
  *
  * Approach: for each session, pull the ordered tool sequence, then count
  * pairs within a sliding window of 5 calls. O(n) per session, no self-join.
- *
- * When transitive=true, infer A→C via A→B + B→C (two-hop co-occurrence).
- * Extended cap of 15 edges/tool (vs 10 for direct-only).
  */
-let _transitiveCooccurrenceCache = null;
-let _transitiveCooccurrenceCacheTime = 0;
-function getCooccurrenceEdges(options) {
-    const transitive = options?.transitive ?? false;
+function getCooccurrenceEdges() {
     const now = Date.now();
-    // Check appropriate cache
-    if (transitive) {
-        if (_transitiveCooccurrenceCache && now - _transitiveCooccurrenceCacheTime < COOCCURRENCE_TTL_MS) {
-            return _transitiveCooccurrenceCache;
-        }
-    }
-    else {
-        if (_cooccurrenceCache && now - _cooccurrenceCacheTime < COOCCURRENCE_TTL_MS) {
-            return _cooccurrenceCache;
-        }
+    if (_cooccurrenceCache && now - _cooccurrenceCacheTime < COOCCURRENCE_TTL_MS) {
+        return _cooccurrenceCache;
     }
-    // Build direct edges first (always needed)
-    const directEdges = new Map();
+    const edges = new Map();
     if (!_dbAccessor) {
-        _cooccurrenceCache = directEdges;
+        _cooccurrenceCache = edges;
         _cooccurrenceCacheTime = now;
-        if (transitive) {
-            _transitiveCooccurrenceCache = directEdges;
-            _transitiveCooccurrenceCacheTime = now;
-        }
-        return directEdges;
+        return edges;
     }
     try {
         const db = _dbAccessor();
@@ -3023,51 +2887,24 @@ function getCooccurrenceEdges(options) {
             .sort((a, b) => b[1] - a[1]);
         for (const [key] of sorted) {
             const [toolA, toolB] = key.split("\0");
-            const list = directEdges.get(toolA) ?? [];
+            const list = edges.get(toolA) ?? [];
             if (list.length < 10) {
                 list.push(toolB);
-                directEdges.set(toolA, list);
+                edges.set(toolA, list);
             }
         }
     }
     catch {
         // No DB or table not yet created — return empty (graceful degradation)
     }
-    // Cache direct edges
-    _cooccurrenceCache = directEdges;
+    _cooccurrenceCache = edges;
     _cooccurrenceCacheTime = now;
-    if (!transitive)
-        return directEdges;
-    // Transitive inference: A→B and B→C ⟹ A→C (two-hop)
-    const transitiveEdges = new Map([...directEdges.entries()].map(([k, v]) => [k, [...v]]));
-    for (const [toolA, directNeighbors] of directEdges) {
-        const existingSet = new Set(directNeighbors);
-        existingSet.add(toolA); // avoid self-loops
-        for (const toolB of directNeighbors) {
-            const bNeighbors = directEdges.get(toolB);
-            if (!bNeighbors)
-                continue;
-            const list = transitiveEdges.get(toolA);
-            for (const toolC of bNeighbors) {
-                if (existingSet.has(toolC))
-                    continue;
-                if (list.length >= 15)
-                    break; // extended cap for transitive
-                list.push(toolC);
-                existingSet.add(toolC);
-            }
-        }
-    }
-    _transitiveCooccurrenceCache = transitiveEdges;
-    _transitiveCooccurrenceCacheTime = now;
-    return transitiveEdges;
+    return edges;
 }
 /** Reset co-occurrence cache — for testing only. */
 export function _resetCooccurrenceCache() {
     _cooccurrenceCache = null;
     _cooccurrenceCacheTime = 0;
-    _transitiveCooccurrenceCache = null;
-    _transitiveCooccurrenceCacheTime = 0;
 }
 /** Inject co-occurrence edges directly — for testing only. */
 export function _setCooccurrenceForTesting(edges) {
@@ -3459,8 +3296,7 @@ export function hybridSearch(query, tools, options) {
         });
     }
     results.sort((a, b) => b.score - a.score);
-    const offset = options?.offset ?? 0;
-    return results.slice(offset, offset + limit);
+    return results.slice(0, limit);
 }
 /** Available search modes for discover_tools */
 export const SEARCH_MODES = ["hybrid", "fuzzy", "regex", "prefix", "semantic", "exact", "dense", "embedding"];
@@ -3482,6 +3318,7 @@ export const WORKFLOW_CHAINS = {
             { tool: "run_mandatory_flywheel", action: "6-step final verification" },
             { tool: "record_learning", action: "Capture what you learned" },
             { tool: "promote_to_eval", action: "Feed into eval batch" },
+            { tool: "save_session_note", action: "Save traceability note — cite original request, summarize what was delivered" },
         ],
     },
     fix_bug: {
@@ -3494,6 +3331,7 @@ export const WORKFLOW_CHAINS = {
             { tool: "log_test_result", action: "Record regression test" },
             { tool: "run_mandatory_flywheel", action: "6-step verification" },
             { tool: "record_learning", action: "Record the gotcha/pattern" },
+            { tool: "save_session_note", action: "Save traceability note — cite original request, record root cause and fix" },
         ],
     },
     ui_change: {
@@ -3507,6 +3345,7 @@ export const WORKFLOW_CHAINS = {
             { tool: "run_quality_gate", action: "Run ui_ux_qa gate" },
             { tool: "run_mandatory_flywheel", action: "Final verification" },
             { tool: "record_learning", action: "Record UI patterns" },
+            { tool: "save_session_note", action: "Save traceability note — cite original request, record visual evidence path" },
         ],
     },
     parallel_project: {
@@ -3824,16 +3663,51 @@ export const WORKFLOW_CHAINS = {
             { tool: "save_session_note", action: "Log sent emails so you have an audit trail that survives compaction" },
         ],
     },
-    pr_creation: {
-        name: "Visual PR Creation",
-        description: "Create a PR with visual evidence from a UI Dive session — screenshots, timeline, bug fixes, past session links",
+    webmcp_discovery: {
+        name: "WebMCP Origin Discovery",
+        description: "Connect to a WebMCP-enabled origin, discover its tools, and invoke them from the agent",
+        steps: [
+            { tool: "connect_webmcp_origin", action: "Connect to the target origin URL and establish a WebMCP session" },
+            { tool: "list_webmcp_tools", action: "List all tools exposed by the origin with schemas and annotations" },
+            { tool: "call_webmcp_tool", action: "Invoke a specific tool on the remote origin with arguments" },
+            { tool: "disconnect_webmcp_origin", action: "Clean up the WebMCP session when done" },
+        ],
+    },
+    batch_autopilot: {
+        name: "Batch Autopilot Run",
+        description: "Set up an operator profile and run a batch autopilot session for autonomous agent tasks",
+        steps: [
+            { tool: "setup_operator_profile", action: "Create or update USER.md and operator profile for autopilot context" },
+            { tool: "get_autopilot_status", action: "Check current autopilot readiness, profile completeness, and last run status" },
+            { tool: "trigger_batch_run", action: "Start a batch autopilot run using the operator profile as context" },
+            { tool: "get_batch_run_history", action: "Review history of past batch runs, outcomes, and timing" },
+            { tool: "sync_operator_profile", action: "Sync operator profile state from disk after manual edits" },
+        ],
+    },
+    daily_review: {
+        name: "Daily Brief Review",
+        description: "Pull the latest daily brief, review narrative threads, check ops dashboard, and sync to local storage",
+        steps: [
+            { tool: "sync_daily_brief", action: "Pull today's brief and narrative from Convex into local SQLite" },
+            { tool: "get_daily_brief_summary", action: "Get the full brief summary with key signals and insights" },
+            { tool: "get_narrative_status", action: "Check narrative thread status — dominant story, under-reported angle, evidence scores" },
+            { tool: "get_ops_dashboard", action: "Review pipeline health: posting status, tool usage, active workflows" },
+            { tool: "open_local_dashboard", action: "Open the local HTML dashboard in the browser for visual review" },
+        ],
+    },
+    gemini_qa: {
+        name: "Gemini Vision QA Loop",
+        description: "Automated UI/UX quality gate — capture screenshots (dark/light × desktop/mobile), send to Gemini Flash for Jony Ive product design review, fix issues, loop until 100/100",
         steps: [
-            { tool: "get_dive_report", action: "Review the dive findings and health score before creating PR" },
-            { tool: "export_pr_screenshots", action: "Export before/after screenshot pairs to a directory for committing" },
-            { tool: "generate_pr_report", action: "Generate rich markdown PR body with visual evidence, timeline, and past session links" },
-            { tool: "create_visual_pr", action: "End-to-end PR creation: exports assets, generates markdown, pushes branch, creates GitHub PR" },
-            { tool: "review_pr_checklist", action: "Validate the PR against the checklist (title, description, tests, verification)" },
-            { tool: "enforce_merge_gate", action: "Pre-merge validation — git state, quality gates, verification cycles" },
+            { tool: "check_mcp_setup", action: "Verify Gemini API key (GOOGLE_AI_KEY) and vision domain are ready" },
+            { tool: "start_verification_cycle", action: "Open a verification cycle titled 'Gemini QA Loop' to track progress" },
+            { tool: "save_session_note", action: "Shell: `npx vite build` then `npx playwright test tests/e2e/full-ui-dogfood.spec.ts --project=chromium --workers=1` — capture 4-variant screenshots" },
+            { tool: "save_session_note", action: "Shell: `npm run dogfood:publish` — copy screenshots to public/dogfood/ with variant metadata manifest" },
+            { tool: "save_session_note", action: "Shell: `npx vite build && node scripts/ui/runDogfoodGeminiQa.mjs` — rebuild, launch preview, trigger Gemini QA" },
+            { tool: "log_test_result", action: "Log QA score from public/dogfood/qa-results.json — formula: 100 - P1×6 - P2×2 - P3×1" },
+            { tool: "save_session_note", action: "Fix P1 issues (6pts each) then P2 (2pts) then P3 (1pt) — root-cause each before fixing" },
+            { tool: "get_overstory_qa_gate", action: "Check QA gate for per-route stability grades and issue counts" },
+            { tool: "record_learning", action: "Record QA trajectory and Gemini finding patterns for regression tracking" },
         ],
     },
 };