funifier-mcp 0.1.0

package/dist/mcp/tools/logs.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ApiHolder } from "../api-holder";
+export declare function registerLogsTool(server: McpServer, apiHolder: ApiHolder): void;
+//# sourceMappingURL=logs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/logs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QAkDvE"}

package/dist/mcp/tools/logs.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLogsTool = registerLogsTool;
+const zod_1 = require("zod");
+function registerLogsTool(server, apiHolder) {
+    server.tool("funifier_logs", "Get execution logs for a Funifier resource (trigger or scheduler)", {
+        type: zod_1.z
+            .enum(["trigger", "scheduler"])
+            .describe("The resource type to get logs for"),
+        id: zod_1.z.string().describe("The resource ID"),
+    }, async ({ type, id }) => {
+        try {
+            const api = apiHolder.requireClient();
+            let logs;
+            switch (type) {
+                case "trigger":
+                    logs = await api.getTriggerLogs(id);
+                    break;
+                case "scheduler":
+                    logs = await api.getSchedulerLogs(id);
+                    break;
+                default:
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Logs are not supported for type: ${type}. Supported types: trigger, scheduler`,
+                            },
+                        ],
+                        isError: true,
+                    };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(logs, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting logs for ${type} ${id}: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=logs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/mcp/tools/logs.ts"],"names":[],"mappings":";;AAIA,4CAkDC;AAtDD,6BAAwB;AAIxB,SAAgB,gBAAgB,CAAC,MAAiB,EAAE,SAAoB;IACtE,MAAM,CAAC,IAAI,CACT,eAAe,EACf,mEAAmE,EACnE;QACE,IAAI,EAAE,OAAC;aACJ,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;aAC9B,QAAQ,CAAC,mCAAmC,CAAC;QAChD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KAC3C,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC;YACtC,IAAI,IAAS,CAAC;YAEd,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,SAAS;oBACZ,IAAI,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;oBACpC,MAAM;gBACR,KAAK,WAAW;oBACd,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;oBACtC,MAAM;gBACR;oBACE,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,oCAAoC,IAAI,uCAAuC;6BACtF;yBACF;wBACD,OAAO,EAAE,IAAI;qBACd,CAAC;YACN,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,0BAA0B,IAAI,IAAI,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE;qBAC/D;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/save.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ApiHolder } from "../api-holder";
+export declare function registerSaveTool(server: McpServer, apiHolder: ApiHolder): void;
+//# sourceMappingURL=save.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/save.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAoE1C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QA2CvE"}

package/dist/mcp/tools/save.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSaveTool = registerSaveTool;
+const zod_1 = require("zod");
+const _fetch_current_1 = require("./_fetch-current");
+const _merge_1 = require("./_merge");
+const RESOURCE_TYPES = [
+    "trigger",
+    "scheduler",
+    "aggregate",
+    "websocket",
+    "widget",
+    "custom-page",
+    "public-endpoint",
+    "challenge-aggregate",
+    "auth-module",
+    "ai-knowledge",
+    "action",
+    "challenge",
+    "point",
+    "level",
+    "leaderboard",
+    "quiz",
+    "virtual-good-catalog",
+    "virtual-good-item",
+];
+async function dispatchSave(api, type, data) {
+    switch (type) {
+        case "trigger":
+            return await api.saveTrigger(data);
+        case "scheduler":
+            return await api.saveScheduler(data);
+        case "aggregate":
+            return await api.saveAggregate(data);
+        case "websocket":
+            return await api.saveWebsocket(data, !data._id);
+        case "widget":
+            return await api.saveWidget(data);
+        case "custom-page":
+            return await api.saveCustomPage(data);
+        case "public-endpoint":
+            return await api.savePublicEndpoint(data);
+        case "challenge-aggregate":
+            return await api.saveChallengeAggregate(data);
+        case "auth-module":
+            return await api.saveAuthModule(data, !data._id);
+        case "ai-knowledge":
+            return await api.saveAiKnowledge(data);
+        case "action":
+            return await api.saveAction(data);
+        case "challenge":
+            return await api.saveChallenge(data);
+        case "point":
+            return await api.savePoint(data);
+        case "level":
+            return await api.saveLevel(data);
+        case "leaderboard":
+            return await api.saveLeaderboard(data);
+        case "quiz":
+            return await api.saveQuiz(data);
+        case "virtual-good-catalog":
+            return await api.saveVirtualGoodCatalog(data);
+        case "virtual-good-item":
+            return await api.saveVirtualGoodItem(data);
+        default:
+            throw new Error(`Unknown resource type: ${type}`);
+    }
+}
+function registerSaveTool(server, apiHolder) {
+    server.tool("funifier_save", "Create or update a Funifier resource. On update (when `_id` is present in the payload), the current resource is fetched and any fields missing from the payload are preserved — you only need to send the fields you want to change. To clear a field, send it explicitly as `null`. Array and object fields are replaced wholesale when present in the payload.", {
+        type: zod_1.z.enum(RESOURCE_TYPES).describe("The resource type"),
+        payload: zod_1.z.string().describe("JSON string of the resource payload. On update, send only the fields you want to change (plus `_id`)."),
+    }, async ({ type, payload }) => {
+        try {
+            const api = apiHolder.requireClient();
+            const data = JSON.parse(payload);
+            let toSave = data;
+            if (data._id) {
+                const current = await (0, _fetch_current_1.fetchCurrentById)(api, type, data._id);
+                if (!current) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Cannot update ${type} ${data._id}: resource not found`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                toSave = (0, _merge_1.mergeResource)(current, data);
+            }
+            const result = await dispatchSave(api, type, toSave);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error saving ${type}: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=save.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../src/mcp/tools/save.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/save.test.d.ts

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

package/dist/mcp/tools/save.test.d.ts.map

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

package/dist/mcp/tools/save.test.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const _merge_1 = require("./_merge");
+(0, vitest_1.describe)("mergeResource", () => {
+    (0, vitest_1.it)("preserves fields present in current but missing from payload", () => {
+        const current = { _id: "a", title: "Old", display: true, html: "<p/>" };
+        const payload = { _id: "a", title: "New" };
+        (0, vitest_1.expect)((0, _merge_1.mergeResource)(current, payload)).toEqual({
+            _id: "a",
+            title: "New",
+            display: true,
+            html: "<p/>",
+        });
+    });
+    (0, vitest_1.it)("lets payload override with null to unset a field", () => {
+        const current = { _id: "a", icon: "star.png", title: "T" };
+        const payload = { _id: "a", icon: null };
+        (0, vitest_1.expect)((0, _merge_1.mergeResource)(current, payload)).toEqual({
+            _id: "a",
+            icon: null,
+            title: "T",
+        });
+    });
+    (0, vitest_1.it)("replaces arrays wholesale when present in payload", () => {
+        const current = { _id: "a", rules: [{ id: 1 }, { id: 2 }] };
+        const payload = { _id: "a", rules: [{ id: 3 }] };
+        (0, vitest_1.expect)((0, _merge_1.mergeResource)(current, payload)).toEqual({
+            _id: "a",
+            rules: [{ id: 3 }],
+        });
+    });
+    (0, vitest_1.it)("replaces nested objects wholesale when present in payload", () => {
+        const current = { _id: "a", action: { type: "add", value: 10 } };
+        const payload = { _id: "a", action: { type: "sub" } };
+        (0, vitest_1.expect)((0, _merge_1.mergeResource)(current, payload)).toEqual({
+            _id: "a",
+            action: { type: "sub" },
+        });
+    });
+    (0, vitest_1.it)("carries created and updated over from current", () => {
+        const current = { _id: "a", created: 1, updated: 2, title: "T" };
+        const payload = { _id: "a", title: "U" };
+        const merged = (0, _merge_1.mergeResource)(current, payload);
+        (0, vitest_1.expect)(merged.created).toBe(1);
+        (0, vitest_1.expect)(merged.updated).toBe(2);
+    });
+});
+const _fetch_current_1 = require("./_fetch-current");
+function makeFakeApi(overrides = {}) {
+    const listed = {
+        listCustomPages: [{ _id: "cp1", title: "Page One" }],
+        listTriggers: [{ _id: "t1", name: "Trig" }],
+        ...overrides,
+    };
+    const api = {};
+    for (const key of Object.keys(listed)) {
+        api[key] = async () => listed[key];
+    }
+    return api;
+}
+(0, vitest_1.describe)("fetchCurrentById", () => {
+    (0, vitest_1.it)("finds a custom-page by _id", async () => {
+        const api = makeFakeApi();
+        const result = await (0, _fetch_current_1.fetchCurrentById)(api, "custom-page", "cp1");
+        (0, vitest_1.expect)(result).toEqual({ _id: "cp1", title: "Page One" });
+    });
+    (0, vitest_1.it)("finds a trigger by _id", async () => {
+        const api = makeFakeApi();
+        const result = await (0, _fetch_current_1.fetchCurrentById)(api, "trigger", "t1");
+        (0, vitest_1.expect)(result).toEqual({ _id: "t1", name: "Trig" });
+    });
+    (0, vitest_1.it)("returns null when the resource is not found", async () => {
+        const api = makeFakeApi();
+        const result = await (0, _fetch_current_1.fetchCurrentById)(api, "custom-page", "missing");
+        (0, vitest_1.expect)(result).toBeNull();
+    });
+    (0, vitest_1.it)("returns null when the list is empty", async () => {
+        const api = makeFakeApi({ listCustomPages: [] });
+        const result = await (0, _fetch_current_1.fetchCurrentById)(api, "custom-page", "cp1");
+        (0, vitest_1.expect)(result).toBeNull();
+    });
+    (0, vitest_1.it)("throws on unknown resource type", async () => {
+        const api = makeFakeApi();
+        await (0, vitest_1.expect)((0, _fetch_current_1.fetchCurrentById)(api, "nonsense", "x")).rejects.toThrow(/unknown resource type/i);
+    });
+});
+const save_1 = require("./save");
+function makeHarness(fakeApi) {
+    const handlers = {};
+    const server = {
+        tool: (name, _desc, _schema, handler) => {
+            handlers[name] = handler;
+        },
+    };
+    const apiHolder = { requireClient: () => fakeApi };
+    (0, save_1.registerSaveTool)(server, apiHolder);
+    return async (type, payload) => handlers["funifier_save"]({ type, payload: JSON.stringify(payload) });
+}
+(0, vitest_1.describe)("funifier_save auto-merge", () => {
+    (0, vitest_1.it)("create path: no _id, dispatches payload unchanged and does not list", async () => {
+        const calls = [];
+        const fakeApi = {
+            listCustomPages: async () => {
+                calls.push("list");
+                return [];
+            },
+            saveCustomPage: async (data) => {
+                calls.push("save");
+                return data;
+            },
+        };
+        const invoke = makeHarness(fakeApi);
+        const payload = { title: "New", slug: "n", html: "", script: "", folder: "", display: true };
+        const result = await invoke("custom-page", payload);
+        (0, vitest_1.expect)(calls).toEqual(["save"]);
+        (0, vitest_1.expect)(result.isError).toBeUndefined();
+        const saved = JSON.parse(result.content[0].text);
+        (0, vitest_1.expect)(saved).toEqual(payload);
+    });
+    (0, vitest_1.it)("update path: partial payload merges with current before saving", async () => {
+        const current = {
+            _id: "cp1",
+            title: "Old",
+            slug: "old-slug",
+            html: "<big-html/>",
+            script: "console.log(1)",
+            folder: "root",
+            display: true,
+        };
+        let savedArg = null;
+        const fakeApi = {
+            listCustomPages: async () => [current],
+            saveCustomPage: async (data) => {
+                savedArg = data;
+                return data;
+            },
+        };
+        const invoke = makeHarness(fakeApi);
+        const result = await invoke("custom-page", { _id: "cp1", title: "New" });
+        (0, vitest_1.expect)(result.isError).toBeUndefined();
+        (0, vitest_1.expect)(savedArg).toEqual({
+            _id: "cp1",
+            title: "New",
+            slug: "old-slug",
+            html: "<big-html/>",
+            script: "console.log(1)",
+            folder: "root",
+            display: true,
+        });
+    });
+    (0, vitest_1.it)("update path: explicit null in payload clears the field", async () => {
+        const current = { _id: "cp1", title: "T", icon: "old.png" };
+        let savedArg = null;
+        const fakeApi = {
+            listCustomPages: async () => [current],
+            saveCustomPage: async (data) => {
+                savedArg = data;
+                return data;
+            },
+        };
+        const invoke = makeHarness(fakeApi);
+        await invoke("custom-page", { _id: "cp1", icon: null });
+        (0, vitest_1.expect)(savedArg.icon).toBeNull();
+        (0, vitest_1.expect)(savedArg.title).toBe("T");
+    });
+    (0, vitest_1.it)("update path: _id not found returns isError and does not save", async () => {
+        let saveCalled = false;
+        const fakeApi = {
+            listCustomPages: async () => [{ _id: "other", title: "x" }],
+            saveCustomPage: async () => {
+                saveCalled = true;
+                return {};
+            },
+        };
+        const invoke = makeHarness(fakeApi);
+        const result = await invoke("custom-page", { _id: "cp1", title: "New" });
+        (0, vitest_1.expect)(result.isError).toBe(true);
+        (0, vitest_1.expect)(result.content[0].text).toMatch(/not found/i);
+        (0, vitest_1.expect)(saveCalled).toBe(false);
+    });
+    (0, vitest_1.it)("update path: nested array is replaced wholesale", async () => {
+        const current = { _id: "ch1", name: "C", rules: [{ id: "a" }, { id: "b" }] };
+        let savedArg = null;
+        const fakeApi = {
+            listChallenges: async () => [current],
+            saveChallenge: async (data) => {
+                savedArg = data;
+                return data;
+            },
+        };
+        const invoke = makeHarness(fakeApi);
+        await invoke("challenge", { _id: "ch1", rules: [{ id: "c" }] });
+        (0, vitest_1.expect)(savedArg.rules).toEqual([{ id: "c" }]);
+        (0, vitest_1.expect)(savedArg.name).toBe("C");
+    });
+});
+//# sourceMappingURL=save.test.js.map

package/dist/mcp/tools/save.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.test.js","sourceRoot":"","sources":["../../../src/mcp/tools/save.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "funifier-mcp",
+  "version": "0.1.0",
+  "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",
+  "bin": {
+    "funifier-mcp": "dist/mcp/index.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "doc",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/funifierinc/funifier-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/funifierinc/funifier-mcp/issues"
+  },
+  "homepage": "https://github.com/funifierinc/funifier-mcp#readme",
+  "author": "Funifier",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "bundle": "npm run build && esbuild dist/mcp/index.js --bundle --outfile=dist/mcp/bundle.js --format=cjs --platform=node --minify",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run bundle",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "build:skills": "tsx scripts/build-skills.ts",
+    "build:skills:force": "tsx scripts/build-skills.ts --force",
+    "search:docs": "tsx scripts/search-docs.ts"
+  },
+  "keywords": [
+    "funifier",
+    "gamification",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "api-client"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "esbuild": "^0.20.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/skills/funifier-create-action/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: funifier-create-action
+description: Create a Funifier action — define trackable player behaviors with attributes
+---
+
+# funifier-create-action
+
+Create a Funifier action — define trackable player behaviors with attributes
+
+## Persona e Qualidade de Código
+
+A partir de agora, atue como um **desenvolvedor de software sênior altamente experiente**, especializado em **geração de código limpo, legível e de fácil manutenção**. Suas soluções devem seguir rigorosamente as **boas práticas da indústria**, **padrões de projeto** e **arquiteturas modernas**, sempre **evitando overengineering**.
+
+### Ao lidar com qualquer código — seja refatorando ou criando do zero — siga este processo:
+
+1. **Analise cuidadosamente o problema ou o código existente.**
+2. **Raciocine passo a passo** antes de escrever qualquer linha de código.
+3. **Identifique problemas (em caso de refatoração) ou requisitos (em caso de código novo).**
+4. **Defina prioridades e estratégias com base em princípios sólidos de engenharia.**
+5. **Justifique tecnicamente cada decisão**, com base em fundamentos como:
+   - **SOLID**
+   - **DRY (Don't Repeat Yourself)**
+   - **KISS (Keep It Simple, Stupid)**
+   - **YAGNI (You Aren't Gonna Need It)**
+
+Só então prossiga com a implementação.
+
+> **Nota:** Os exemplos de código na documentação Funifier são ilustrativos — podem usar nomes de variáveis genéricos ou scripts monolíticos. Sempre melhore-os: use nomes descritivos, extraia métodos especializados para lógicas complexas e mantenha cada função com responsabilidade única.
+
+---
+
+## Before starting — find relevant docs
+
+Run lexical search to load only what you need:
+
+```bash
+npx tsx scripts/search-docs.ts "action track player behavior attributes log event" --skill funifier-create-action
+```
+
+Read only files returned with score > 0.5 (this threshold is printed in the search output).
+
+## Primary docs for this skill
+
+If search returns insufficient results, read directly:
+
+- `datasource-funifier-docs/knowledge/modules/action.md`
+- `datasource-funifier-docs/knowledge/modules/action-log.md`
+
+## Steps
+
+### 1. Understand the requirement
+
+Ask the user what they want to create or accomplish. Gather:
+- The name/title
+- The purpose and behavior
+- Any specific configuration or constraints
+
+### 2. Search for relevant documentation
+
+Run the lexical search (command shown above) and read the returned files.
+
+### 3. Check existing resources (if MCP available)
+
+Use `funifier_list` with the relevant type and a `search` parameter to see
+if a similar resource already exists. Never list all resources without a search term.
+
+### 4. Design and confirm
+
+Based on the docs, outline the configuration to the user and confirm before saving.
+
+### 5. Create or update
+
+Use `funifier_save` with the appropriate type and a JSON payload to create or
+update the resource. If MCP is unavailable, show the complete JSON for manual use.
+
+### 6. Validate
+
+Use `funifier_logs` (for triggers/schedulers) or `funifier_get` to confirm
+the resource was saved correctly and executed without errors.
+
+## MCP
+
+If Funifier MCP tools are available (`funifier_list`, `funifier_save`, `funifier_get`, `funifier_logs`):
+- Use MCP for live server data
+- Use docs for correct patterns and syntax
+- Never learn patterns from existing live resources — docs are authoritative

package/skills/funifier-create-aggregate/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: funifier-create-aggregate
+description: Create a Funifier prepared aggregate — guided workflow for building MongoDB aggregate pipelines for reports and dashboards
+---
+
+# funifier-create-aggregate
+
+Create a Funifier prepared aggregate — guided workflow for building MongoDB aggregate pipelines for reports and dashboards
+
+## Persona e Qualidade de Código
+
+A partir de agora, atue como um **desenvolvedor de software sênior altamente experiente**, especializado em **geração de código limpo, legível e de fácil manutenção**. Suas soluções devem seguir rigorosamente as **boas práticas da indústria**, **padrões de projeto** e **arquiteturas modernas**, sempre **evitando overengineering**.
+
+### Ao lidar com qualquer código — seja refatorando ou criando do zero — siga este processo:
+
+1. **Analise cuidadosamente o problema ou o código existente.**
+2. **Raciocine passo a passo** antes de escrever qualquer linha de código.
+3. **Identifique problemas (em caso de refatoração) ou requisitos (em caso de código novo).**
+4. **Defina prioridades e estratégias com base em princípios sólidos de engenharia.**
+5. **Justifique tecnicamente cada decisão**, com base em fundamentos como:
+   - **SOLID**
+   - **DRY (Don't Repeat Yourself)**
+   - **KISS (Keep It Simple, Stupid)**
+   - **YAGNI (You Aren't Gonna Need It)**
+
+Só então prossiga com a implementação.
+
+> **Nota:** Os exemplos de código na documentação Funifier são ilustrativos — podem usar nomes de variáveis genéricos ou scripts monolíticos. Sempre melhore-os: use nomes descritivos, extraia métodos especializados para lógicas complexas e mantenha cada função com responsabilidade única.
+
+---
+
+## Before starting — find relevant docs
+
+Run lexical search to load only what you need:
+
+```bash
+npx tsx scripts/search-docs.ts "aggregate mongodb pipeline report dashboard query prepared" --skill funifier-create-aggregate
+```
+
+Read only files returned with score > 0.5 (this threshold is printed in the search output).
+
+## Primary docs for this skill
+
+If search returns insufficient results, read directly:
+
+- `datasource-funifier-docs/knowledge/guides/aggregates.md`
+- `datasource-funifier-docs/knowledge/guides/database-access.md`
+- `datasource-funifier-docs/knowledge/modules/database.md`
+
+## Steps
+
+### 1. Understand the requirement
+
+Ask the user what they want to create or accomplish. Gather:
+- The name/title
+- The purpose and behavior
+- Any specific configuration or constraints
+
+### 2. Search for relevant documentation
+
+Run the lexical search (command shown above) and read the returned files.
+
+### 3. Check existing resources (if MCP available)
+
+Use `funifier_list` with the relevant type and a `search` parameter to see
+if a similar resource already exists. Never list all resources without a search term.
+
+### 4. Design and confirm
+
+Based on the docs, outline the configuration to the user and confirm before saving.
+
+### 5. Create or update
+
+Use `funifier_save` with the appropriate type and a JSON payload to create or
+update the resource. If MCP is unavailable, show the complete JSON for manual use.
+
+### 6. Validate
+
+Use `funifier_logs` (for triggers/schedulers) or `funifier_get` to confirm
+the resource was saved correctly and executed without errors.
+
+## MCP
+
+If Funifier MCP tools are available (`funifier_list`, `funifier_save`, `funifier_get`, `funifier_logs`):
+- Use MCP for live server data
+- Use docs for correct patterns and syntax
+- Never learn patterns from existing live resources — docs are authoritative