funifier-mcp 0.2.28 → 0.3.1

package/dist/mcp/tools/search-docs.test.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const search_docs_1 = require("./search-docs");
+const lexical_1 = require("../../core/lexical");
+// Package-style layout: docsPath is the knowledge/ dir; the index sits one level up,
+// exactly where the tool resolves it (path.join(docsPath, "..", ".search-index.json")).
+let root;
+let docsPath;
+function invokeWith(dp) {
+    const handlers = {};
+    const server = {
+        registerTool: (name, _config, handler) => {
+            handlers[name] = handler;
+        },
+    };
+    (0, search_docs_1.registerSearchDocsTool)(server, dp);
+    return (args) => handlers["funifier_search_docs"](args);
+}
+(0, vitest_1.beforeAll)(() => {
+    root = fs.mkdtempSync(path.join(os.tmpdir(), "funifier-searchdocs-"));
+    docsPath = path.join(root, "knowledge");
+    fs.mkdirSync(docsPath, { recursive: true });
+    // Index keys carry the knowledge/ prefix, like the real build output, so the
+    // tool's strip of `^knowledge/` and `.md` is exercised.
+    const files = new Map([
+        [
+            "knowledge/modules/trigger.md",
+            "# Trigger\n\n## Groovy event\n\nTrigger fires on before_win events with a groovy script.",
+        ],
+        ["knowledge/modules/quiz.md", "# Quiz\n\nQuestions and answers for players."],
+    ]);
+    fs.writeFileSync(path.join(root, ".search-index.json"), JSON.stringify((0, lexical_1.buildIndex)(files)));
+});
+(0, vitest_1.afterAll)(() => {
+    fs.rmSync(root, { recursive: true, force: true });
+});
+(0, vitest_1.describe)("funifier_search_docs", () => {
+    (0, vitest_1.it)("loads the index next to docsPath and ranks matching docs", () => {
+        const result = invokeWith(docsPath)({ query: "trigger groovy event before_win" });
+        (0, vitest_1.expect)(result.isError).toBeUndefined();
+        (0, vitest_1.expect)(result.content[0].text).toContain("modules/trigger");
+    });
+    (0, vitest_1.it)("returns paths stripped of knowledge/ and .md, pointing at funifier_read_doc (not a resource URI)", () => {
+        const text = invokeWith(docsPath)({ query: "trigger groovy event before_win" }).content[0].text;
+        (0, vitest_1.expect)(text).toContain("funifier_read_doc path=");
+        (0, vitest_1.expect)(text).not.toContain("funifier://docs/");
+        (0, vitest_1.expect)(text).not.toContain("knowledge/");
+        (0, vitest_1.expect)(text).not.toContain(".md");
+    });
+    (0, vitest_1.it)("returns isError when the search index is missing", () => {
+        const emptyRoot = fs.mkdtempSync(path.join(os.tmpdir(), "funifier-noindex-"));
+        const result = invokeWith(path.join(emptyRoot, "knowledge"))({ query: "trigger" });
+        (0, vitest_1.expect)(result.isError).toBe(true);
+        (0, vitest_1.expect)(result.content[0].text).toContain("index not found");
+        fs.rmSync(emptyRoot, { recursive: true, force: true });
+    });
+    (0, vitest_1.it)("reports no matches for an unrelated query", () => {
+        const result = invokeWith(docsPath)({ query: "zzzznonexistentterm" });
+        (0, vitest_1.expect)(result.isError).toBeUndefined();
+        (0, vitest_1.expect)(result.content[0].text).toContain("No documentation found");
+    });
+});
+//# sourceMappingURL=search-docs.test.js.map

package/dist/mcp/tools/search-docs.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "funifier-mcp",
-  "version": "0.2.28",
+  "version": "0.3.1",
   "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/funifier/SKILL.md

@@ -21,11 +21,13 @@ Only proceed directly with MCP tools when no row matches.
 3. Read the file listed in the Reference column
 4. Follow the workflow in that file
 
-For general questions with no matching task, run lexical search:
+For general questions with no matching task, search the docs with the MCP tool:
 
-```bash
-npx funifier-mcp search "<user question>"
 ```
+funifier_search_docs "<user question>"
+```
+
+Then read a result with `funifier_read_doc path=<path>`.
 
 ## Routing Table
 

package/skills/funifier/references/configure-security.md

@@ -6,19 +6,19 @@ Configure Funifier security settings — roles, scopes, app tokens, and auth par
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "security role scope token auth app permission basic bearer access-control" --skill funifier-configure-security
+```
+funifier_search_docs "security role scope token auth app permission basic bearer access-control"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/security.md`
+- `funifier_read_doc path=modules/security`
 
 ## Steps
 
@@ -54,7 +54,7 @@ Authorization: Bearer <studio_token>
 ### 2. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/security.md
+funifier_read_doc path=modules/security
 ```
 
 ### 3. Definir roles e apps

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

@@ -6,20 +6,20 @@ Create a Funifier action — define trackable player behaviors with attributes
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "action track player behavior attributes log event" --skill funifier-create-action
+```
+funifier_search_docs "action track player behavior attributes log event"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/action.md`
-- `datasource-funifier-docs/knowledge/modules/action-log.md`
+- `funifier_read_doc path=modules/action`
+- `funifier_read_doc path=modules/action-log`
 
 ## Steps
 

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

@@ -45,21 +45,21 @@ Note que `aggregate` é uma **string** contendo JSON serializado (com `\n` e `\"
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "aggregate mongodb pipeline report dashboard query prepared" --skill funifier-create-aggregate
+```
+funifier_search_docs "aggregate mongodb pipeline report dashboard query prepared"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/guides/aggregates.md`
-- `datasource-funifier-docs/knowledge/guides/database-access.md`
-- `datasource-funifier-docs/knowledge/modules/database.md`
+- `funifier_read_doc path=guides/aggregates`
+- `funifier_read_doc path=guides/database-access`
+- `funifier_read_doc path=modules/database`
 
 ## Steps
 

package/skills/funifier/references/create-challenge.md

@@ -6,21 +6,21 @@ Create a Funifier challenge — missions with action rules and point rewards
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "challenge mission reward rules action points gamification" --skill funifier-create-challenge
+```
+funifier_search_docs "challenge mission reward rules action points gamification"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/challenge.md`
-- `datasource-funifier-docs/knowledge/modules/action.md`
-- `datasource-funifier-docs/knowledge/modules/point.md`
+- `funifier_read_doc path=modules/challenge`
+- `funifier_read_doc path=modules/action`
+- `funifier_read_doc path=modules/point`
 
 ## Steps
 

package/skills/funifier/references/create-competition.md

@@ -6,19 +6,19 @@ Create a Funifier competition — timed ranking contests with player enrollment,
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "competition contest ranking tournament enrollment rewards position gt26" --skill funifier-create-competition
+```
+funifier_search_docs "competition contest ranking tournament enrollment rewards position gt26"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/competition.md`
+- `funifier_read_doc path=modules/competition`
 
 ## Steps
 

package/skills/funifier/references/create-crossword.md

@@ -542,7 +542,7 @@ funifier_list type=crossword search=<titulo>
 ### 2. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/crossword.md
+funifier_read_doc path=modules/crossword
 ```
 
 ### 3. Criar o crossword

package/skills/funifier/references/create-custom-object.md

@@ -6,20 +6,20 @@ Create and manage Funifier custom objects — domain-specific collections with t
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "custom object collection database crud __c domain entity business" --skill funifier-create-custom-object
+```
+funifier_search_docs "custom object collection database crud __c domain entity business"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/custom-object.md`
-- `datasource-funifier-docs/knowledge/modules/database.md`
+- `funifier_read_doc path=modules/custom-object`
+- `funifier_read_doc path=modules/database`
 
 ## Steps
 

package/skills/funifier/references/create-custom-page.md

@@ -45,21 +45,21 @@ Note que `aggregate` é uma **string** contendo JSON serializado (com `\n` e `\"
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "custom page studio dashboard angularjs bootstrap admin crud kpi" --skill funifier-create-custom-page
+```
+funifier_search_docs "custom page studio dashboard angularjs bootstrap admin crud kpi"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/studio-page.md`
-- `datasource-funifier-docs/knowledge/guides/aggregates.md`
-- `datasource-funifier-docs/knowledge/modules/auth.md`
+- `funifier_read_doc path=modules/studio-page`
+- `funifier_read_doc path=guides/aggregates`
+- `funifier_read_doc path=modules/auth`
 
 ## Steps
 

package/skills/funifier/references/create-folder.md

@@ -6,19 +6,19 @@ Create a Funifier learning trail (folder) — hierarchical courses with content
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "folder trail course learning progress content hierarchy unlock training lms" --skill funifier-create-folder
+```
+funifier_search_docs "folder trail course learning progress content hierarchy unlock training lms"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/folder.md`
+- `funifier_read_doc path=modules/folder`
 
 ## Steps
 

package/skills/funifier/references/create-lastmile.md

@@ -616,7 +616,7 @@ funifier_list type=lastmile search=<descricao>
 ### 3. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/lastmile.md
+funifier_read_doc path=modules/lastmile
 ```
 
 ### 4. Criar o lastmile

package/skills/funifier/references/create-leaderboard.md

@@ -6,21 +6,21 @@ Create a Funifier leaderboard — rankings by points, actions, or attributes
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "leaderboard ranking score top players classification board" --skill funifier-create-leaderboard
+```
+funifier_search_docs "leaderboard ranking score top players classification board"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/leaderboard.md`
-- `datasource-funifier-docs/knowledge/modules/point.md`
-- `datasource-funifier-docs/knowledge/modules/action.md`
+- `funifier_read_doc path=modules/leaderboard`
+- `funifier_read_doc path=modules/point`
+- `funifier_read_doc path=modules/action`
 
 ## Steps
 

package/skills/funifier/references/create-level.md

@@ -6,20 +6,20 @@ Create Funifier levels — progression system based on accumulated points
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "level progression rank tier xp points unlock" --skill funifier-create-level
+```
+funifier_search_docs "level progression rank tier xp points unlock"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/level.md`
-- `datasource-funifier-docs/knowledge/modules/point.md`
+- `funifier_read_doc path=modules/level`
+- `funifier_read_doc path=modules/point`
 
 ## Steps
 

package/skills/funifier/references/create-notification.md

@@ -6,19 +6,19 @@ Create a Funifier notification — standalone automated player feedback messages
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "notification message push feedback alert player event" --skill funifier-create-notification
+```
+funifier_search_docs "notification message push feedback alert player event"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/notification.md`
+- `funifier_read_doc path=modules/notification`
 
 ## Steps
 
@@ -44,7 +44,7 @@ funifier_list type=notification search=<descricao>
 ### 2. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/notification.md
+funifier_read_doc path=modules/notification
 ```
 
 ### 3. Criar a notificação

package/skills/funifier/references/create-point.md

@@ -6,20 +6,20 @@ Create a Funifier point category — XP, coins, or custom metrics
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "point xp coin currency score metric category" --skill funifier-create-point
+```
+funifier_search_docs "point xp coin currency score metric category"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/point.md`
-- `datasource-funifier-docs/knowledge/modules/achievement.md`
+- `funifier_read_doc path=modules/point`
+- `funifier_read_doc path=modules/achievement`
 
 ## Steps
 

package/skills/funifier/references/create-quiz.md

@@ -6,20 +6,20 @@ Create a Funifier quiz — questionnaires with multiple-choice questions
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "quiz question answer questionnaire multiple choice survey" --skill funifier-create-quiz
+```
+funifier_search_docs "quiz question answer questionnaire multiple choice survey"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/quiz.md`
-- `datasource-funifier-docs/knowledge/modules/question.md`
+- `funifier_read_doc path=modules/quiz`
+- `funifier_read_doc path=modules/question`
 
 ## Steps
 

package/skills/funifier/references/create-scheduler.md

@@ -45,21 +45,21 @@ Note que `aggregate` é uma **string** contendo JSON serializado (com `\n` e `\"
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "scheduler cron groovy java scheduled job periodic" --skill funifier-create-scheduler
+```
+funifier_search_docs "scheduler cron groovy java scheduled job periodic"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/scheduler.md`
-- `datasource-funifier-docs/knowledge/guides/java-managers.md`
-- `datasource-funifier-docs/knowledge/guides/java-libraries.md`
+- `funifier_read_doc path=modules/scheduler`
+- `funifier_read_doc path=guides/java-managers`
+- `funifier_read_doc path=guides/java-libraries`
 
 ## Steps
 
@@ -112,8 +112,8 @@ void execute() {
 ```
 
 > Leituras obrigatórias para Groovy avançado:
-> - `datasource-funifier-docs/knowledge/guides/java-managers.md`
-> - `datasource-funifier-docs/knowledge/guides/java-libraries.md`
+> - `funifier_read_doc path=guides/java-managers`
+> - `funifier_read_doc path=guides/java-libraries`
 
 ### 4. Montar e salvar o payload
 

package/skills/funifier/references/create-story.md

@@ -603,7 +603,7 @@ funifier_list type=story search=<titulo>
 ### 2. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/story.md
+funifier_read_doc path=modules/story
 ```
 
 ### 3. Criar a história

package/skills/funifier/references/create-swap.md

@@ -6,19 +6,19 @@ Create a Funifier swap — player-to-player trade offers for items or points wit
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "swap trade exchange offer counter-offer peer social marketplace" --skill funifier-create-swap
+```
+funifier_search_docs "swap trade exchange offer counter-offer peer social marketplace"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/swap.md`
+- `funifier_read_doc path=modules/swap`
 
 ## Steps