funifier-mcp 0.2.25 → 0.2.27

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

@@ -1,127 +0,0 @@
----
-name: funifier-create-scheduler
-description: Create a Funifier scheduler — guided workflow from naming and cron expression to Groovy code generation
----
-
-# funifier-create-scheduler
-
-Create a Funifier scheduler — guided workflow from naming and cron expression to Groovy code generation
-
-## 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.
-
----
-
-## Formato do payload (obrigatório)
-
-Funifier armazena código como **strings JSON escapadas**. Ao montar o payload do `funifier_save`:
-
-- **Quebra de linha** → `\n` (nunca newline literal dentro da string)
-- **Aspas duplas** dentro do código → `\"`
-- **Backslash** → `\\` (regex `\b` vira `\\b`; dentro de Groovy com string-building pode exigir `\\\\b`)
-- **Tab** → `\t` (se usar)
-- **Pipelines de aggregate** vão como **string JSON** (não objeto aninhado) — serialize o array inteiro
-
-A regra prática: monte o objeto em JavaScript normalmente e passe por `JSON.stringify` — o MCP faz isso automaticamente quando você entrega o payload como JSON. **Nunca** cole código multilinha cru no meio do JSON.
-
-### Exemplo 1 — custom-page (html + angularjs script)
-
-```json
-{
-  "title": "Ciclos",
-  "slug": "studio/custom/ciclos",
-  "html": "<div class=\"row\">\n  <div class=\"col-md-12\">\n    <h2>Ciclos</h2>\n  </div>\n</div>\n",
-  "script": "$scope.all = [];\n$scope.loading = false;\n\n$scope.list = function () {\n  $scope.loading = true;\n};\n$scope.list();\n"
-}
-```
-
-### Exemplo 2 — aggregate preparado (pipeline JSON + script Groovy)
-
-```json
-{
-  "_id": "extrato",
-  "title": "Extrato de Pontos",
-  "collection": "extrato",
-  "aggregate": "[\n  {\n    \"$match\": { \"player\": \"$param:player\" }\n  },\n  {\n    \"$sort\": { \"time\": -1 }\n  }\n]",
-  "script": "void prepare(aggregations, params) {\n    if (context.get(\"player\") != null) {\n        params.put(\"player\", context.get(\"player\"));\n    } else {\n        params.put(\"player\", \"NAO_EXISTE\");\n    }\n}\n"
-}
-```
-
-Note que `aggregate` é uma **string** contendo JSON serializado (com `\n` e `\"` escapados), **não** um array nativo. Mesma regra vale para `script` em triggers/schedulers/aggregates e `html`/`script` em custom-pages.
-
----
-
-## Before starting — find relevant docs
-
-Run lexical search to load only what you need:
-
-```bash
-npx funifier-mcp search "scheduler cron groovy java scheduled job periodic" --skill funifier-create-scheduler
-```
-
-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/scheduler.md`
-- `datasource-funifier-docs/knowledge/guides/java-managers.md`
-- `datasource-funifier-docs/knowledge/guides/java-libraries.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
-- **For any new Funifier task, check `/funifier-index` first** — there may be a skill with the correct enums, examples, and workflow already defined

package/skills/funifier-create-virtual-good/SKILL.md

@@ -1,87 +0,0 @@
----
-name: funifier-create-virtual-good
-description: Create a Funifier virtual good — catalog items players can purchase with points
----
-
-# funifier-create-virtual-good
-
-Create a Funifier virtual good — catalog items players can purchase with points
-
-## 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 funifier-mcp search "virtual good item catalog store purchase marketplace shop" --skill funifier-create-virtual-good
-```
-
-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/virtual-good.md`
-- `datasource-funifier-docs/knowledge/modules/point.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
-- **For any new Funifier task, check `/funifier-index` first** — there may be a skill with the correct enums, examples, and workflow already defined

package/skills/funifier-debug/SKILL.md

@@ -1,92 +0,0 @@
----
-name: funifier-debug
-description: Debug a Funifier resource — systematic diagnosis of triggers, schedulers, aggregates, and other Funifier components
----
-
-# funifier-debug
-
-Debug a Funifier resource — systematic diagnosis of triggers, schedulers, aggregates, and other Funifier components
-
-## 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 funifier-mcp search "debug error log exception timeout groovy stack trace fix" --skill funifier-debug
-```
-
-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/java-libraries.md`
-- `datasource-funifier-docs/knowledge/modules/trigger.md`
-- `datasource-funifier-docs/knowledge/guides/triggers-guide.md`
-- `datasource-funifier-docs/knowledge/guides/trigger-examples.md`
-- `datasource-funifier-docs/knowledge/modules/scheduler.md`
-- `datasource-funifier-docs/knowledge/guides/aggregates.md`
-- `datasource-funifier-docs/knowledge/modules/public.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
-- **For any new Funifier task, check `/funifier-index` first** — there may be a skill with the correct enums, examples, and workflow already defined

package/skills/funifier-help/SKILL.md

@@ -1,86 +0,0 @@
----
-name: funifier-help
-description: Get help with Funifier — routes to the right documentation or skill based on your question
----
-
-# funifier-help
-
-Get help with Funifier — routes to the right documentation or skill based on your question
-
-## 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 funifier-mcp search "help documentation guide module question how what funifier" --skill funifier-help
-```
-
-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/index.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
-- **For any new Funifier task, check `/funifier-index` first** — there may be a skill with the correct enums, examples, and workflow already defined

package/skills/funifier-implement-frontend/SKILL.md

@@ -1,90 +0,0 @@
----
-name: funifier-implement-frontend
-description: Implement frontend code that consumes the Funifier API — authentication, data fetching, and aggregate consumption
----
-
-# funifier-implement-frontend
-
-Implement frontend code that consumes the Funifier API — authentication, data fetching, and aggregate consumption
-
-## 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 funifier-mcp search "frontend api authentication fetch jwt token javascript react angular" --skill funifier-implement-frontend
-```
-
-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/auth.md`
-- `datasource-funifier-docs/knowledge/guides/aggregates.md`
-- `datasource-funifier-docs/knowledge/guides/database-access.md`
-- `datasource-funifier-docs/knowledge/modules/patterns.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
-- **For any new Funifier task, check `/funifier-index` first** — there may be a skill with the correct enums, examples, and workflow already defined

package/skills/funifier-index/SKILL.md

@@ -1,58 +0,0 @@
----
-name: funifier-index
-description: >
-  REQUIRED before any funifier_* MCP tool call — check this index first to find the matching skill.
-  Routes to the right skill for creating actions, challenges, points, leaderboards, triggers, schedulers, aggregates, quizzes, virtual goods, custom pages, and frontend implementation.
----
-
-# Funifier Index
-
-## ⚠ Rule
-
-**Before using any `funifier_*` MCP tool, check this list first.**
-If a skill matches the task, invoke it — skills contain the correct field values, enum tables, and examples that prevent common errors.
-Only proceed directly with MCP tools when no skill matches.
-
-## Usage
-
-1. Identify what the user wants to do
-2. Find the matching skill in the table below and invoke it
-3. For general questions with no matching skill, run lexical search:
-
-```bash
-npx funifier-mcp search "<user question>"
-```
-
-## Available Skills
-
-| Skill | When to use |
-|-------|-------------|
-| `/funifier-create-trigger` | Create a Funifier trigger — guided workflow from entity/event selection to Groovy code generation |
-| `/funifier-create-scheduler` | Create a Funifier scheduler — guided workflow from naming and cron expression to Groovy code generation |
-| `/funifier-create-aggregate` | Create a Funifier prepared aggregate — guided workflow for building MongoDB aggregate pipelines for reports and dashboards |
-| `/funifier-create-challenge` | Create a Funifier challenge — missions with action rules and point rewards |
-| `/funifier-create-action` | Create a Funifier action — define trackable player behaviors with attributes |
-| `/funifier-create-point` | Create a Funifier point category — XP, coins, or custom metrics |
-| `/funifier-create-level` | Create Funifier levels — progression system based on accumulated points |
-| `/funifier-create-leaderboard` | Create a Funifier leaderboard — rankings by points, actions, or attributes |
-| `/funifier-create-quiz` | Create a Funifier quiz — questionnaires with multiple-choice questions |
-| `/funifier-create-virtual-good` | Create a Funifier virtual good — catalog items players can purchase with points |
-| `/funifier-create-custom-page` | Create a Funifier Studio custom page — guided workflow for building admin dashboards, CRUDs, reports, and KPI pages using AngularJS + Bootstrap |
-| `/funifier-implement-frontend` | Implement frontend code that consumes the Funifier API — authentication, data fetching, and aggregate consumption |
-| `/funifier-debug` | Debug a Funifier resource — systematic diagnosis of triggers, schedulers, aggregates, and other Funifier components |
-| `/funifier-help` | Get help with Funifier — routes to the right documentation or skill based on your question |
-
-## Documented Modules
-
-| Module | Description |
-|--------|-------------|
-| Auth | Login de jogadores, geração de tokens JWT, autenticação via API |
-| Player | Cadastro e gestão de utilizadores da aplicação |
-| Database | CRUD em qualquer coleção, queries MongoDB, aggregates |
-| Custom Object | Criar tabelas/coleções próprias (sufixo ) para dados de negócio |
-| Upload | Upload de imagens e ficheiros (avatar, documentos, etc.) |
-| Trigger | Escrever funções Java que executam no servidor quando eventos acontecem |
-| Scheduler | Agendar tarefas automáticas (cron jobs, rotinas periódicas) |
-| Public Endpoint | Criar APIs REST customizadas acessíveis sem autenticação |
-| Webhook | Enviar dados para sistemas externos quando eventos acontecem |
-| Patterns | Design patterns de implementação (signup, etc.) baseados em experiência real |