funifier-mcp 0.2.25 → 0.2.27

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

@@ -0,0 +1,75 @@
+# funifier-create-notification
+
+Create a Funifier notification — standalone automated player feedback messages for game events; use when managing notification records directly via API, not when configuring notifications inline within challenge or competition payloads
+
+---
+
+## Before starting — find relevant docs
+
+Run lexical search to load only what you need:
+
+```bash
+npx funifier-mcp search "notification message push feedback alert player event" --skill funifier-create-notification
+```
+
+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/notification.md`
+
+## Steps
+
+### Sobre Notifications
+
+Notificações em Funifier são geralmente configuradas **inline** nos módulos que as disparam (challenge `notifications[]`, competition `notifications[]`). A skill `funifier-create-notification` é para gerenciar registros standalone de notificação via API.
+
+**Campos principais:**
+- `event`: `0`=On Win, `1`=On Create, `2`=On Change
+- `scope`: `0`=Private (jogador), `1`=Newsfeed, `99`=Custom
+- `content`: template com variáveis (ex: `"{{player.name}} completed {{item.name}}"`)
+
+---
+
+## Steps
+
+### 1. Verificar se já existe
+
+```
+funifier_list type=notification search=<descricao>
+```
+
+### 2. Ler a documentação do módulo
+
+```
+datasource-funifier-docs/knowledge/modules/notification.md
+```
+
+### 3. Criar a notificação
+
+```json
+{
+  "event": 0,
+  "type": 0,
+  "scope": 0,
+  "content": "{{player.name}} earned {{item.name}}!"
+}
+```
+
+```
+funifier_save type=notification payload=<json>
+```
+
+### 4. Associar ao módulo correto
+
+Notificações standalone geralmente são referenciadas em challenges, competitions ou outros módulos via o campo `notifications`. Verifique o payload do módulo destino.
+
+### 5. Validar
+
+```
+funifier_list type=notification
+```
+
+Dispare o evento correspondente e verifique se a notificação é entregue.

package/skills/{funifier-create-point/SKILL.md → funifier/references/create-point.md}

@@ -1,32 +1,7 @@
----
-name: funifier-create-point
-description: Create a Funifier point category — XP, coins, or custom metrics
----
-
 # funifier-create-point
 
 Create a Funifier point category — XP, coins, or custom metrics
 
-## 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
@@ -118,11 +93,3 @@ funifier_list type=point search=<_id>
 ```
 
 Do NOT use `funifier_logs` — that is only for triggers and schedulers.
-
-## 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/references/create-quiz.md

@@ -0,0 +1,98 @@
+# funifier-create-quiz
+
+Create a Funifier quiz — questionnaires with multiple-choice questions
+
+---
+
+## Before starting — find relevant docs
+
+Run lexical search to load only what you need:
+
+```bash
+npx funifier-mcp search "quiz question answer questionnaire multiple choice survey" --skill funifier-create-quiz
+```
+
+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/quiz.md`
+- `datasource-funifier-docs/knowledge/modules/question.md`
+
+## Steps
+
+### Quiz flow — two-stage creation + five-stage player flow
+
+**Admin creates:** Quiz → Questions
+**Player flow:** Start → Answer → Finish (grade calculated on finish)
+
+---
+
+## Steps
+
+### 1. Verificar se já existe
+
+```
+funifier_list type=quiz search=<titulo>
+```
+
+### 2. Criar o Quiz
+
+```json
+{
+  "title": "Product Knowledge Test",
+  "description": "Test your knowledge about our products.",
+  "grade": 10,
+  "shuffle": false,
+  "showGradeBeforeFinish": false,
+  "questionNumbering": "uppercase_letters"
+}
+```
+
+```
+funifier_save type=quiz payload=<json>
+```
+
+Guarde o `_id` retornado — necessário para associar perguntas.
+
+### 3. Criar as perguntas (associadas ao quiz)
+
+```json
+{
+  "quiz": "<quiz_id>",
+  "type": "MULTIPLE_CHOICE",
+  "title": "Best Platform",
+  "question": "What is the best gamification platform?",
+  "grade": 1,
+  "select": "one_answer",
+  "shuffle": false,
+  "choices": [
+    { "answer": "1", "label": "Funifier", "grade": 1, "gradePercent": 100, "gradeCheck": true, "extra": {} },
+    { "answer": "2", "label": "Other A", "grade": 0, "gradePercent": 0, "extra": {} },
+    { "answer": "3", "label": "Other B", "grade": 0, "gradePercent": 0, "extra": {} }
+  ]
+}
+```
+
+```
+funifier_save type=question payload=<json>
+```
+
+Repita para cada pergunta.
+
+### 4. Validar criação
+
+```
+funifier_list type=quiz search=<titulo>
+GET /v3/quiz/<quiz_id>/question
+```
+
+### 5. Testar fluxo do jogador (opcional)
+
+```
+POST /v3/quiz/start   { "quiz": "<id>", "player": "<player_id>" }
+POST /v3/question/log/bulk   [{ "quiz": "<id>", "quiz_log": "<log_id>", "question": "<q_id>", "answer": ["1"], "player": "<player_id>" }]
+POST /v3/quiz/finish  { "quiz_log": "<log_id>" }
+```

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

@@ -0,0 +1,141 @@
+# funifier-create-scheduler
+
+Create a Funifier scheduler — guided workflow from naming and cron expression to Groovy code generation
+
+---
+
+## 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
+
+### Regras críticas
+
+- Método principal: `void execute()` — sem parâmetros, sem return
+- **Não use `import`** — toda a biblioteca já está no wrapper (Unirest, Groovy JSON, Apache HTTP, etc.)
+- **`manager`** (ManagerFactory) disponível como campo da classe — acesse DatabaseManager, PlayerManager, etc.
+- **Timeout padrão: 10s** — use `"timeout": N` (segundos) no payload para scripts mais longos
+
+### CRON Expression
+
+| Expressão | Significado |
+|---|---|
+| `0 0 8 * * ?` | Todo dia às 8:00 |
+| `0 0/30 * * * ?` | A cada 30 minutos |
+| `0 0 9 ? * 2` | Toda segunda-feira às 9:00 |
+| `0 0 10 ? * 5L` | Última sexta do mês às 10:00 |
+
+---
+
+## Steps
+
+### 1. Entender o requisito
+
+- O que deve acontecer? (ex: debitar pontos, enviar lembrete, processar inativos)
+- Com que frequência? → define a expressão CRON
+- Requer dados externos? (jogadores, pontos, coleções customizadas)
+
+### 2. Verificar se já existe
+
+```
+funifier_list type=scheduler search=<nome>
+```
+
+### 3. Escrever o script
+
+```java
+void execute() {
+    // Exemplo: processar jogadores com poucas ações
+    def logs = manager.getJongoConnection()
+        .getCollection("action_log")
+        .find()
+        .limit(100)
+        .as(HashMap.class)
+    logs.each { log ->
+        println("Processing: " + log.userId)
+    }
+}
+```
+
+> Leituras obrigatórias para Groovy avançado:
+> - `datasource-funifier-docs/knowledge/guides/java-managers.md`
+> - `datasource-funifier-docs/knowledge/guides/java-libraries.md`
+
+### 4. Montar e salvar o payload
+
+```json
+{
+  "name": "Weekly Report",
+  "description": "Gera relatório toda sexta às 10h",
+  "active": true,
+  "expression": "0 0 10 ? * 5L",
+  "timeout": 30,
+  "script": "void execute() {\n  println('Running');\n}\n"
+}
+```
+
+```
+funifier_save type=scheduler payload=<json>
+```
+
+### 5. Validar via logs
+
+```
+funifier_logs type=scheduler id=<_id>
+```
+
+Confirme que não há erros de compilação ou execução no stack trace.