funifier-mcp 0.2.27 → 0.2.28

package/dist/mcp/check-update.d.ts

@@ -1,2 +1,7 @@
+declare function isOutdated(current: string, latest: string): boolean;
+export declare function setUpdateNotice(notice: string): void;
+/** Returns the pending update notice once, then clears it (show only once per session). */
+export declare function consumeUpdateNotice(): string | null;
 export declare function checkForUpdate(): Promise<void>;
+export { isOutdated };
 //# sourceMappingURL=check-update.d.ts.map

package/dist/mcp/check-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-update.d.ts","sourceRoot":"","sources":["../../src/mcp/check-update.ts"],"names":[],"mappings":"AAaA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BpD"}
+{"version":3,"file":"check-update.d.ts","sourceRoot":"","sources":["../../src/mcp/check-update.ts"],"names":[],"mappings":"AAAA,iBAAS,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAW5D;AAMD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAInD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBpD;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/mcp/check-update.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUpdateNotice = setUpdateNotice;
+exports.consumeUpdateNotice = consumeUpdateNotice;
 exports.checkForUpdate = checkForUpdate;
+exports.isOutdated = isOutdated;
 function isOutdated(current, latest) {
     const toTuple = (v) => v
         .replace(/[^0-9.]/g, "")
@@ -14,6 +17,18 @@ function isOutdated(current, latest) {
         return lMin > cMin;
     return lPatch > cPatch;
 }
+// Set when an update is detected; surfaced once on the next tool result so the
+// user actually sees it (stdio MCP stderr is hidden from chat by most clients).
+let pendingNotice = null;
+function setUpdateNotice(notice) {
+    pendingNotice = notice;
+}
+/** Returns the pending update notice once, then clears it (show only once per session). */
+function consumeUpdateNotice() {
+    const notice = pendingNotice;
+    pendingNotice = null;
+    return notice;
+}
 async function checkForUpdate() {
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     const { version: current } = require("../../package.json");
@@ -30,15 +45,11 @@ async function checkForUpdate() {
     catch {
         return;
     }
-    if (isOutdated(current, latest)) {
-        console.error([
-            "",
-            "┌─────────────────────────────────────────────────────────┐",
-            `│  Funifier MCP update available: ${current} → ${latest}`,
-            "│  Run: npx funifier-mcp@latest init                      │",
-            "└─────────────────────────────────────────────────────────┘",
-            "",
-        ].join("\n"));
-    }
+    if (!isOutdated(current, latest))
+        return;
+    const notice = `⬆ funifier-mcp update available: ${current} → ${latest}. Run: npx funifier-mcp@latest init`;
+    setUpdateNotice(notice);
+    // Fallback for clients/power users that surface server stderr.
+    console.error(notice);
 }
 //# sourceMappingURL=check-update.js.map

package/dist/mcp/check-update.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-update.js","sourceRoot":"","sources":["../../src/mcp/check-update.ts"],"names":[],"mappings":";;AAaA,wCA4BC;AAzCD,SAAS,UAAU,CAAC,OAAe,EAAE,MAAc;IACjD,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAC5B,CAAC;SACE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IACtC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IACtC,OAAO,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC;AAEM,KAAK,UAAU,cAAc;IAClC,8DAA8D;IAC9D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;IAElF,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,gDAAgD,EAAE;YACxE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO;QACpB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAC;QACvD,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CACX;YACE,EAAE;YACF,6DAA6D;YAC7D,qCAAqC,OAAO,MAAM,MAAM,EAAE;YAC1D,6DAA6D;YAC7D,6DAA6D;YAC7D,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"check-update.js","sourceRoot":"","sources":["../../src/mcp/check-update.ts"],"names":[],"mappings":";;AAiBA,0CAEC;AAGD,kDAIC;AAED,wCAsBC;AAEQ,gCAAU;AApDnB,SAAS,UAAU,CAAC,OAAe,EAAE,MAAc;IACjD,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAC5B,CAAC;SACE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IACtC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IACtC,OAAO,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC;AAED,+EAA+E;AAC/E,gFAAgF;AAChF,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC,SAAgB,eAAe,CAAC,MAAc;IAC5C,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC;AAED,2FAA2F;AAC3F,SAAgB,mBAAmB;IACjC,MAAM,MAAM,GAAG,aAAa,CAAC;IAC7B,aAAa,GAAG,IAAI,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,KAAK,UAAU,cAAc;IAClC,8DAA8D;IAC9D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;IAElF,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,gDAAgD,EAAE;YACxE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO;QACpB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAC;QACvD,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;QAAE,OAAO;IAEzC,MAAM,MAAM,GAAG,oCAAoC,OAAO,MAAM,MAAM,qCAAqC,CAAC;IAC5G,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,+DAA+D;IAC/D,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC"}

package/dist/mcp/check-update.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=check-update.test.d.ts.map

package/dist/mcp/check-update.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-update.test.d.ts","sourceRoot":"","sources":["../../src/mcp/check-update.test.ts"],"names":[],"mappings":""}

package/dist/mcp/check-update.test.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const check_update_1 = require("./check-update");
+(0, vitest_1.describe)("isOutdated", () => {
+    (0, vitest_1.it)("detects newer major/minor/patch", () => {
+        (0, vitest_1.expect)((0, check_update_1.isOutdated)("1.0.0", "2.0.0")).toBe(true);
+        (0, vitest_1.expect)((0, check_update_1.isOutdated)("1.2.0", "1.3.0")).toBe(true);
+        (0, vitest_1.expect)((0, check_update_1.isOutdated)("1.2.3", "1.2.4")).toBe(true);
+    });
+    (0, vitest_1.it)("returns false when current is equal or ahead", () => {
+        (0, vitest_1.expect)((0, check_update_1.isOutdated)("1.2.3", "1.2.3")).toBe(false);
+        (0, vitest_1.expect)((0, check_update_1.isOutdated)("2.0.0", "1.9.9")).toBe(false);
+        (0, vitest_1.expect)((0, check_update_1.isOutdated)("1.3.0", "1.2.9")).toBe(false);
+    });
+    (0, vitest_1.it)("ignores non-numeric prefixes like ^ or v", () => {
+        (0, vitest_1.expect)((0, check_update_1.isOutdated)("0.2.27", "v0.3.0")).toBe(true);
+    });
+});
+(0, vitest_1.describe)("update notice", () => {
+    (0, vitest_1.beforeEach)(() => {
+        (0, check_update_1.consumeUpdateNotice)(); // clear any leftover state
+    });
+    (0, vitest_1.it)("returns null when no notice is pending", () => {
+        (0, vitest_1.expect)((0, check_update_1.consumeUpdateNotice)()).toBeNull();
+    });
+    (0, vitest_1.it)("returns the notice once, then clears it", () => {
+        (0, check_update_1.setUpdateNotice)("update me");
+        (0, vitest_1.expect)((0, check_update_1.consumeUpdateNotice)()).toBe("update me");
+        (0, vitest_1.expect)((0, check_update_1.consumeUpdateNotice)()).toBeNull();
+    });
+});
+//# sourceMappingURL=check-update.test.js.map

package/dist/mcp/check-update.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-update.test.js","sourceRoot":"","sources":["../../src/mcp/check-update.test.ts"],"names":[],"mappings":";;AAAA,mCAA0D;AAC1D,iDAAkF;AAElF,IAAA,iBAAQ,EAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAA,WAAE,EAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,IAAA,eAAM,EAAC,IAAA,yBAAU,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAA,eAAM,EAAC,IAAA,yBAAU,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAA,eAAM,EAAC,IAAA,yBAAU,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,IAAA,eAAM,EAAC,IAAA,yBAAU,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAA,eAAM,EAAC,IAAA,yBAAU,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAA,eAAM,EAAC,IAAA,yBAAU,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,IAAA,eAAM,EAAC,IAAA,yBAAU,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,IAAA,kCAAmB,GAAE,CAAC,CAAC,2BAA2B;IACpD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,IAAA,eAAM,EAAC,IAAA,kCAAmB,GAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,IAAA,8BAAe,EAAC,WAAW,CAAC,CAAC;QAC7B,IAAA,eAAM,EAAC,IAAA,kCAAmB,GAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChD,IAAA,eAAM,EAAC,IAAA,kCAAmB,GAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/mcp/prompts/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts/templates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QA6FhD"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts/templates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAsIhD"}

package/dist/mcp/prompts/templates.js

@@ -55,6 +55,41 @@ function registerPrompts(server) {
             ],
         };
     });
+    server.prompt("map_instance", "Map, document and audit an existing Funifier instance (read-only) into docs/funifier/, including a Mermaid architecture map", {
+        focus: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional focus area, e.g. 'triggers' or 'mechanics'. Omit to map the whole instance."),
+    }, ({ focus }) => {
+        const scope = focus
+            ? `Focus the deep mapping on: ${focus}. Still inventory and count the other categories, but keep their docs at a high level.`
+            : "Map the full instance.";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: [
+                            "I want to map and document this EXISTING Funifier instance. This is a READ-ONLY audit — never create, edit or delete anything.",
+                            scope,
+                            "",
+                            "If the `acquire-funifier-knowledge` skill is available, follow it for the full contract. Otherwise, follow these steps:",
+                            "1. Confirm the MCP connection (e.g. funifier_database action=collections) and record the instance URL/name and today's date.",
+                            "2. Inventory every listable type with funifier_list (trigger, scheduler, action, challenge, point, level, leaderboard, quiz, virtual-good-catalog/item, public-endpoint, custom-page, widget, websocket, aggregate, challenge-aggregate, auth-module, ai-knowledge), and use funifier_database action=collections to find off-enum elements (webhooks, notifications, competitions, player, team).",
+                            "3. For objects that need detail, use funifier_get mode=read to extract rules, conditions and actions.",
+                            "4. Cross-link the objects: which trigger feeds which point/challenge, which scheduler calls which endpoint, which actions satisfy each challenge, which leaderboards use which points.",
+                            "5. From those (and ONLY those) relationships, build a Mermaid architecture map — 'what fires/awards/feeds/calls what' — and put it in OVERVIEW.md. Every edge must trace to a real configured field; never draw a speculative edge — use a dashed `-.->` marked [ASK USER] when unsure. Collapse any category with >8 objects into a single node annotated with its count.",
+                            "6. Write the documentation set under docs/funifier/ (OVERVIEW, GAME_MECHANICS, TRIGGERS, SCHEDULERS, CUSTOM_ENDPOINTS, CUSTOM_PAGES, LEADERBOARDS, PLAYER_MODEL, INTEGRATIONS, TECHNIQUES_AND_PATTERNS, CONCERNS). Every claim points to an object ID; no section left empty.",
+                            "7. Finish with a summary of counts, where each doc lives, and a numbered list of [ASK USER] items to resolve.",
+                            "",
+                            "Use only read-only tools: funifier_list, funifier_get (mode=read), funifier_logs, funifier_database (query/aggregate/collections only), funifier_folder (inside/breadcrumb only). Never use funifier_save, funifier_delete, funifier_execute, database insert/update/delete/bulk, or folder progress.",
+                        ].join("\n"),
+                    },
+                },
+            ],
+        };
+    });
     server.prompt("implement_frontend", "Implement frontend code using Funifier aggregates", async () => {
         return {
             messages: [

package/dist/mcp/prompts/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/mcp/prompts/templates.ts"],"names":[],"mappings":";;AAGA,0CA6FC;AAhGD,6BAAwB;AAGxB,SAAgB,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,MAAM,CACX,iBAAiB,EACjB,0DAA0D,EAC1D;QACE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;KAC/F,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QACX,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,mCAAmC,IAAI,GAAG;4BAC1C,EAAE;4BACF,oBAAoB;4BACpB,iFAAiF,IAAI,GAAG;4BACxF,0CAA0C,IAAI,0BAA0B;4BACxE,qEAAqE;4BACrE,kEAAkE,IAAI,EAAE;4BACxE,EAAE;4BACF,2DAA2D,IAAI,aAAa;yBAC7E,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,sDAAsD,EACtD;QACE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QACzE,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KACpD,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,oCAAoC,IAAI,aAAa,EAAE,IAAI;4BAC3D,EAAE;4BACF,oBAAoB;4BACpB,yCAAyC,IAAI,yBAAyB;4BACtE,kEAAkE;4BAClE,oGAAoG;4BACpG,gFAAgF;4BAChF,iDAAiD;4BACjD,EAAE;4BACF,yBAAyB,IAAI,wBAAwB;yBACtD,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,oBAAoB,EACpB,mDAAmD,EACnD,KAAK,IAAI,EAAE;QACT,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,uEAAuE;4BACvE,EAAE;4BACF,oBAAoB;4BACpB,+EAA+E;4BAC/E,+DAA+D;4BAC/D,kEAAkE;4BAClE,wEAAwE;4BACxE,gDAAgD;4BAChD,EAAE;4BACF,+EAA+E;yBAChF,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/mcp/prompts/templates.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAY1C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAWtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAoC1C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QActF"}

package/dist/mcp/tools/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerTools = registerTools;
+const check_update_1 = require("../check-update");
 const connect_1 = require("./connect");
 const list_1 = require("./list");
 const get_1 = require("./get");
@@ -11,7 +12,31 @@ const logs_1 = require("./logs");
 const database_1 = require("./database");
 const folder_1 = require("./folder");
 const search_docs_1 = require("./search-docs");
+/**
+ * Wraps every tool handler so a pending update notice is prepended to the first
+ * tool result of the session. Tool results are the only channel the user reliably
+ * sees in a stdio MCP client. The handler is always the last argument.
+ */
+function decorateWithUpdateNotice(server) {
+    const original = server.registerTool.bind(server);
+    server.registerTool = ((...args) => {
+        const handler = args[args.length - 1];
+        if (typeof handler === "function") {
+            args[args.length - 1] = async (...handlerArgs) => {
+                const result = await handler(...handlerArgs);
+                const notice = (0, check_update_1.consumeUpdateNotice)();
+                if (notice && result && Array.isArray(result.content)) {
+                    result.content.unshift({ type: "text", text: notice });
+                }
+                return result;
+            };
+        }
+        return original(...args);
+    });
+}
 function registerTools(server, apiHolder, docsPath) {
+    // Must run before the tools below register, so their handlers get wrapped.
+    decorateWithUpdateNotice(server);
     (0, connect_1.registerConnectTool)(server, apiHolder);
     (0, list_1.registerListTool)(server, apiHolder);
     (0, get_1.registerGetTool)(server, apiHolder);

package/dist/mcp/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":";;AAaA,sCAWC;AAtBD,uCAAgD;AAChD,iCAA0C;AAC1C,+BAAwC;AACxC,iCAA0C;AAC1C,qCAA8C;AAC9C,uCAAgD;AAChD,iCAA0C;AAC1C,yCAAkD;AAClD,qCAA8C;AAC9C,+CAAuD;AAEvD,SAAgB,aAAa,CAAC,MAAiB,EAAE,SAAoB,EAAE,QAAgB;IACrF,IAAA,6BAAmB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,IAAA,uBAAgB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,IAAA,qBAAe,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,IAAA,uBAAgB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,IAAA,2BAAkB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,IAAA,6BAAmB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,IAAA,uBAAgB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,IAAA,+BAAoB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,IAAA,2BAAkB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,IAAA,oCAAsB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":";;AAqCA,sCAcC;AAjDD,kDAAsD;AACtD,uCAAgD;AAChD,iCAA0C;AAC1C,+BAAwC;AACxC,iCAA0C;AAC1C,qCAA8C;AAC9C,uCAAgD;AAChD,iCAA0C;AAC1C,yCAAkD;AAClD,qCAA8C;AAC9C,+CAAuD;AAEvD;;;;GAIG;AACH,SAAS,wBAAwB,CAAC,MAAiB;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAA4B,CAAC;IAC7E,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,WAAkB,EAAE,EAAE;gBACtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;gBAC7C,MAAM,MAAM,GAAG,IAAA,kCAAmB,GAAE,CAAC;gBACrC,IAAI,MAAM,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;oBACtD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBACzD,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3B,CAAC,CAA+B,CAAC;AACnC,CAAC;AAED,SAAgB,aAAa,CAAC,MAAiB,EAAE,SAAoB,EAAE,QAAgB;IACrF,2EAA2E;IAC3E,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAEjC,IAAA,6BAAmB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,IAAA,uBAAgB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,IAAA,qBAAe,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,IAAA,uBAAgB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,IAAA,2BAAkB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,IAAA,6BAAmB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,IAAA,uBAAgB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,IAAA,+BAAoB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,IAAA,2BAAkB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,IAAA,oCAAsB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "funifier-mcp",
-  "version": "0.2.27",
+  "version": "0.2.28",
   "description": "Funifier AI toolkit — MCP server, API client, and Claude Code skills for the Funifier gamification platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/acquire-funifier-knowledge/SKILL.md

@@ -27,7 +27,7 @@ Produza esta estrutura em `docs/funifier/`. **Nenhum arquivo pode ficar vazio**
 
 | Arquivo | Conteúdo |
 |---------|----------|
-| `OVERVIEW.md` | Identificação da instância, contagens agregadas por categoria, data do snapshot, escopo do mapeamento |
+| `OVERVIEW.md` | Identificação da instância, contagens agregadas por categoria, data do snapshot, escopo do mapeamento e o **mapa de arquitetura em Mermaid** (o que dispara/premia/alimenta/chama o quê) |
 | `GAME_MECHANICS.md` | Pontos, níveis, achievements/badges, challenges, missions, quizzes, virtual goods — com IDs, regras de atribuição e condições |
 | `TRIGGERS.md` | Todos os triggers: nome, ID, entidade/evento de origem, condições, ações, status |
 | `SCHEDULERS.md` | Cron jobs: nome, expressão cron, ação, próxima/última execução conhecida, status |
@@ -82,7 +82,7 @@ Avance pelas fases em ordem. As fases 1 e 6 são sempre completas (mesmo em Modo
 1. **Validar conexão e identificar a instância.** Confirme que o MCP responde (uma chamada `funifier_database action=collections` ou um `funifier_list type=trigger limit=1` serve). Registre serverUrl/nome da conexão e a data do snapshot para o `OVERVIEW.md`.
 2. **Inventário bruto.** Para cada um dos 18 tipos, rode `funifier_list` e registre os IDs e nomes. Rode `funifier_database action=collections` para descobrir coleções que revelam elementos fora do enum (webhooks, notifications, competitions, custom `__c`, player, team). Consulte `references/funifier-inventory-checklist.md` para a lista de perguntas por categoria.
 3. **Detalhamento.** Para cada objeto que precisa de detalhe, rode `funifier_get mode=read` e extraia as regras, condições e ações. Amostre coleções relevantes com `funifier_database action=query` (limit pequeno) para entender o modelo de player/team.
-4. **Análise cruzada.** Relacione objetos: qual `trigger` alimenta qual `point`/`challenge`; qual `scheduler` chama qual `public-endpoint`; quais `action`s satisfazem as regras de cada `challenge`; quais `leaderboard`s usam quais `point`s. Anote as relações para `CONCERNS.md` e `TECHNIQUES_AND_PATTERNS.md`.
+4. **Análise cruzada e diagrama de arquitetura.** Relacione objetos: qual `trigger` alimenta qual `point`/`challenge`; qual `scheduler` chama qual `public-endpoint`; quais `action`s satisfazem as regras de cada `challenge`; quais `leaderboard`s usam quais `point`s. Anote as relações para `CONCERNS.md` e `TECHNIQUES_AND_PATTERNS.md`. Com essas relações já mapeadas (e **somente** com elas), monte o **mapa de arquitetura em Mermaid** e escreva-o na seção própria do `OVERVIEW.md` — siga as convenções em "Diagrama de arquitetura (Mermaid)" abaixo.
 5. **Inferência de técnicas de jogos.** Classifique as técnicas observadas usando `references/game-techniques-taxonomy.md`. Cada técnica DEVE ser ligada aos IDs concretos que a implementam. Sem objeto que a sustente, não afirme a técnica.
 6. **Validação.** Verifique: (a) cada claim aponta para um ID/objeto; (b) nenhuma seção obrigatória está vazia; (c) todo nome de ferramenta usado existe; (d) nenhum tipo inventado. Veja a checklist no fim deste arquivo.
 7. **Apresentar.** Mostre um sumário (contagens + onde está cada doc) e uma lista numerada de itens `[ASK USER]` e divergências encontradas, para o usuário resolver.
@@ -95,6 +95,26 @@ Avance pelas fases em ordem. As fases 1 e 6 são sempre completas (mesmo em Modo
 - **Nunca infira comportamento sem um objeto que o sustente.** "Provavelmente dispara X" é proibido; cite a config do trigger e o evento exato.
 - **Toda seção termina com um bloco `## Evidence`** listando os IDs consultados e as chamadas MCP que produziram o conteúdo (ex.: `funifier_list type=trigger`, `funifier_get type=challenge id=...`).
 
+## Diagrama de arquitetura (Mermaid)
+
+O `OVERVIEW.md` carrega um **mapa de arquitetura** em Mermaid: a visão macro de "o que dispara, premia, alimenta e chama o quê". Ele é a *visualização* das relações já levantadas na Fase 4 — nunca uma fonte nova de verdade.
+
+**Regras duras:**
+
+1. **Toda aresta corresponde a um campo configurado num objeto real.** A origem é o `entity`/`event` de um `trigger`, a recompensa de um `challenge`, a métrica de um `leaderboard`, o preço de um `virtual-good-item`, etc. Sem campo que a sustente, a aresta não existe.
+2. **Toda aresta é rastreável no doc da categoria.** Cada relação desenhada DEVE também aparecer como fato no doc correspondente (`TRIGGERS.md`, `GAME_MECHANICS.md`, `LEADERBOARDS.md`, ...). O diagrama não afirma nada que os docs não afirmem.
+3. **Relação incerta = aresta tracejada `-.->` rotulada `[ASK USER]`.** Nunca desenhe uma aresta sólida "provável" (mesmo princípio do anti-padrão "provavelmente dispara X").
+4. **Legibilidade > completude.** Se uma categoria tem **mais de 8 objetos**, não desenhe um nó por objeto: colapse a categoria num único nó anotado com a contagem (ex.: `challenges["challenges (×24)"]`) e desenhe só os fluxos principais. O mapa do `OVERVIEW.md` é macro; diagramas detalhados por área só quando o usuário pedir.
+
+**Convenções de sintaxe (para o Mermaid não quebrar):**
+
+- Use `flowchart LR`. Agrupe os nós em `subgraph`s por camada: `Ações & Eventos`, `Automação` (`trigger`/`scheduler`), `Mecânicas` (`challenge`/`quiz`/`level`/trilhas), `Recompensas` (`point`/`virtual-good`), `Visualização` (`leaderboard`/`aggregate`/`custom-page`/`widget`), `Integrações` (`public-endpoint`/`webhook`/`websocket`/`auth-module`).
+- **IDs de nó**: apenas `[A-Za-z0-9_]`. Derive do nome substituindo qualquer outro caractere por `_`. Rótulo sempre entre aspas duplas, com nome + tipo: `tr_login["login_trigger · trigger"]`.
+- **Verbos das arestas** (use só estes, sempre rotulados): `dispara` (trigger/scheduler → ação/endpoint), `premia` (challenge/quiz → point/virtual-good), `alimenta` (point → leaderboard; action → challenge), `exige` (level → point; item → preço), `lê` (aggregate → coleção; page/widget → aggregate/leaderboard), `chama` (frontend/page → public-endpoint; trigger → webhook externo).
+- Uma instrução por linha; nunca use parênteses em rótulos sem aspas.
+
+O esqueleto pronto para preencher está em `assets/templates/OVERVIEW.md` — substitua os `{{...}}` pelos objetos reais e remova as arestas que não tiverem relação comprovada.
+
 ## Modo Foco (Focus Area Mode)
 
 Se o usuário pedir foco ("só triggers", "mecânicas e técnicas apenas"):
@@ -102,6 +122,7 @@ Se o usuário pedir foco ("só triggers", "mecânicas e técnicas apenas"):
 - A **Fase 1** (validar/identificar) roda sempre, completa.
 - Os documentos do foco são preenchidos **completos**.
 - Os demais documentos obrigatórios **existem**, com suas seções presentes mas marcadas `[TODO]` (e uma nota indicando que ficaram fora do escopo desta execução).
+- O **mapa de arquitetura** no `OVERVIEW.md` é sempre gerado; seu escopo reflete o foco — categorias fora do foco aparecem colapsadas num único nó com a contagem.
 - A **Fase 6** (validação) roda em **todos** os documentos.
 
 ## Anti-padrões
@@ -114,6 +135,7 @@ Se o usuário pedir foco ("só triggers", "mecânicas e técnicas apenas"):
 | Confundir achievement com challenge ou mission | Respeitar a tipagem do Funifier; cada categoria no seu doc |
 | Inventar um tipo (ex.: tratar "webhook" como `funifier_list type=webhook`) | Usar só os 18 tipos reais; inferir o resto de coleções e ações |
 | Modificar a instância para "testar" um comportamento | Apenas ler; nunca `save`/`delete`/`execute`/`insert`/`update` |
+| Desenhar uma aresta "provável" no diagrama Mermaid | Só desenhar arestas com um campo de objeto que as sustente; incertezas viram `-.->` `[ASK USER]` |
 
 ## Quando ler cada arquivo de referência
 
@@ -128,5 +150,6 @@ Se o usuário pedir foco ("só triggers", "mecânicas e técnicas apenas"):
 - [ ] Todo objeto com status conhecido tem o status registrado.
 - [ ] Nenhum tipo inventado — só os 18 tipos reais + coleções via `funifier_database`.
 - [ ] Cada documento termina com um bloco `## Evidence`.
+- [ ] O `OVERVIEW.md` contém o mapa de arquitetura em Mermaid; cada aresta tem um campo de objeto que a sustenta e o mesmo fato aparece no doc da categoria. Incertezas são `-.->` `[ASK USER]`, não arestas sólidas.
 - [ ] Itens dependentes de intenção estão marcados `[ASK USER]`, não adivinhados.
 - [ ] Nenhuma ferramenta de escrita foi usada (`save`/`delete`/`execute`/`insert`/`update`/`bulk`/`folder progress`).

package/skills/acquire-funifier-knowledge/assets/templates/OVERVIEW.md

@@ -38,6 +38,44 @@ Contagem por tipo listável (preencha 0 quando não houver — não omita):
 |----------|---------|-------------|
 | {{webhook/notification/competition/...}} | {{collection}} | {{n}} |
 
+### Mapa de Arquitetura
+
+Visão macro de "o que dispara/premia/alimenta/chama o quê". **Regras:** toda aresta vem de um campo real (trigger `entity`/`event`, recompensa de challenge, métrica de leaderboard, preço de virtual-good...) e o mesmo fato aparece no doc da categoria; relação incerta = `-.->` `[ASK USER]`; categoria com >8 objetos = um único nó com a contagem (`challenges["challenges (×24)"]`). Verbos permitidos: `dispara`, `premia`, `alimenta`, `exige`, `lê`, `chama`. Substitua os `{{...}}` por IDs de nó saneados (`[A-Za-z0-9_]`) e remova as arestas sem relação comprovada.
+
+```mermaid
+flowchart LR
+  subgraph Acoes["Ações & Eventos"]
+    {{act_id}}["{{nome}} · action"]
+  end
+  subgraph Automacao["Automação"]
+    {{trigger_id}}["{{nome}} · trigger"]
+    {{scheduler_id}}["{{nome}} · scheduler"]
+  end
+  subgraph Mecanicas["Mecânicas"]
+    {{challenge_id}}["{{nome}} · challenge"]
+    {{level_id}}["{{nome}} · level"]
+  end
+  subgraph Recompensas["Recompensas"]
+    {{point_id}}["{{nome}} · point"]
+    {{vg_id}}["{{nome}} · virtual-good"]
+  end
+  subgraph Visualizacao["Visualização"]
+    {{leaderboard_id}}["{{nome}} · leaderboard"]
+    {{aggregate_id}}["{{nome}} · aggregate"]
+  end
+  subgraph Integracoes["Integrações"]
+    {{endpoint_id}}["{{nome}} · public-endpoint"]
+  end
+
+  {{act_id}} -->|alimenta| {{challenge_id}}
+  {{trigger_id}} -->|premia| {{point_id}}
+  {{challenge_id}} -->|premia| {{vg_id}}
+  {{point_id}} -->|alimenta| {{leaderboard_id}}
+  {{level_id}} -->|exige| {{point_id}}
+  {{aggregate_id}} -->|lê| {{point_id}}
+  {{scheduler_id}} -.->|chama [ASK USER]| {{endpoint_id}}
+```
+
 ## Extended (Opcional)
 - Versão/plano da instância, se conhecido.
 - Principais áreas funcionais identificadas (resumo de 2-3 linhas).
@@ -45,3 +83,4 @@ Contagem por tipo listável (preencha 0 quando não houver — não omita):
 ## Evidence
 - `funifier_list type=<cada um dos 18 tipos>`
 - `funifier_database action=collections`
+- Mapa de arquitetura: cada aresta é evidenciada pelo objeto/campo que a sustenta, documentado no doc da categoria correspondente ({{ex.: TRIGGERS.md #id, GAME_MECHANICS.md #id}}).