funifier-mcp 0.2.25 → 0.2.27

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

@@ -0,0 +1,135 @@
+# funifier-create-custom-page
+
+Create a Funifier Studio custom page — guided workflow for building admin dashboards, CRUDs, reports, and KPI pages using AngularJS + Bootstrap
+
+---
+
+## 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 "custom page studio dashboard angularjs bootstrap admin crud kpi" --skill funifier-create-custom-page
+```
+
+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/studio-page.md`
+- `datasource-funifier-docs/knowledge/guides/aggregates.md`
+- `datasource-funifier-docs/knowledge/modules/auth.md`
+
+## Steps
+
+### Regras críticas
+
+- **Collection é `studio_page`** — não `page`. Salvar via `PUT /v3/database/studio_page`
+- **`html` e `script` são strings JSON-escapadas** — nunca cole código multilinha cru no JSON
+- Contexto JS: `$scope`, `$http`, `$location`, `$routeParams`, `Marketplace`
+- Para autenticação: `Marketplace.auth.getAuthorization()` e `Marketplace.auth.getService()`
+- `?strict=true` em GETs para preservar tipos BSON (evita conversão de datas/IDs)
+
+### Variáveis de contexto
+
+| Variável | Uso |
+|---|---|
+| `Marketplace.auth.getService()` | URL da API (ex: https://service2.funifier.com) |
+| `Marketplace.auth.getAuthorization()` | Bearer token do Studio |
+| `Marketplace.range.parse(content_range)` | Parseia header de paginação |
+| `Marketplace.range.paginate(page, range)` | Gera header Range para paginação |
+
+---
+
+## Steps
+
+### 1. Definir o objetivo da página
+
+- Dashboard? Lista? CRUD? Relatório com gráfico?
+- Precisa de parâmetros na URL? (ex: `:id` no slug para edição)
+
+### 2. Verificar se já existe
+
+```
+GET /v3/database/studio_page
+```
+
+### 3. Escrever html + script
+
+Hello World:
+```json
+{
+  "_id": "hello1",
+  "display": true,
+  "title": "Hello World!",
+  "slug": "studio/custom/hello",
+  "html": "<button ng-click=\"hello()\" class=\"btn btn-warning\">Hello</button>",
+  "script": "$scope.hello = function(){ alert('Hello World!'); };"
+}
+```
+
+Lista simples:
+```javascript
+// script para listar jogadores
+$scope.all = [];
+$scope.list = function () {
+  $http({
+    method: 'GET',
+    url: Marketplace.auth.getService() + '/v3/database/player',
+    headers: { "Authorization": Marketplace.auth.getAuthorization(), "content-type": "application/json" }
+  }).then(function(data) { $scope.all = data.data; });
+};
+$scope.list();
+```
+
+### 4. Salvar a página
+
+```
+PUT /v3/database/studio_page   { "_id": "...", "display": true, "title": "...", "slug": "studio/custom/...", "html": "...", "script": "..." }
+```
+
+### 5. Validar no Studio
+
+Acesse `/studio/custom/<slug>` no browser para testar.
+Para CRUD completo: crie página de lista (`display: true`) + formulário (`display: false`, slug com `/:id`).

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

@@ -0,0 +1,104 @@
+# funifier-create-folder
+
+Create a Funifier learning trail (folder) — hierarchical courses with content types, progress tracking, conditional unlock policies, and trigger events; use when structuring sequenced training journeys, not when standalone challenges are enough
+
+---
+
+## Before starting — find relevant docs
+
+Run lexical search 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
+```
+
+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/folder.md`
+
+## Steps
+
+### Regras críticas
+
+- **`DELETE /v3/folder/:id` é cascata e irreversível** — deleta sub-pastas, conteúdos, logs e dados de formulário
+- **Sempre use `/v3/folder/log`** para registrar progresso — nunca insira direto na collection `folder_log`
+- **`insertLog` é idempotente** — atualiza log existente por `(player, item)` sem duplicar
+- **`status: "done"`** → `percent = 100` (automático); `percent >= 100` → `status = "done"` (automático)
+- Herança de `unlock_policy`: pastas sem policy própria herdam do pai
+
+### MCP tools para folder
+
+| Operação | Tool | Parâmetro |
+|---|---|---|
+| Criar/atualizar pasta | `funifier_save` | `type: "folder"` |
+| Adicionar conteúdo | `funifier_save` | `type: "folder-content"` |
+| Definir tipo de conteúdo | `funifier_save` | `type: "folder-content-type"` |
+| Registrar progresso | `funifier_save` | `type: "folder-log"` |
+| Ver árvore completa | `funifier_folder` | `operation: "inside"` |
+| Ver progresso do jogador | `funifier_folder` | `operation: "progress"` |
+
+---
+
+## Steps
+
+### 1. Criar estrutura de pastas
+
+Raiz da trilha:
+```json
+{ "title": "Sales Trail" }
+```
+
+Módulo com unlock sequencial (requer 80% do anterior):
+```json
+{
+  "title": "Module 2 — Closing",
+  "parent": "<root_id>",
+  "position": 1,
+  "unlock_policy": { "type": "progress", "folder_ref": "prev", "min_percent": 80 }
+}
+```
+
+```
+funifier_save type=folder payload=<json>
+```
+
+### 2. Definir tipos de conteúdo (se necessário)
+
+```json
+{ "_id": "video", "entity": "video__c", "input": "repository", "title": "Video" }
+```
+
+```
+funifier_save type=folder-content-type payload=<json>
+```
+
+### 3. Adicionar conteúdo às pastas
+
+```json
+{ "type": "video", "content": "<video_id>", "parent": "<module_id>", "position": 0 }
+```
+
+```
+funifier_save type=folder-content payload=<json>
+```
+
+### 4. Registrar progresso do jogador
+
+```json
+{ "item": "<content_id>", "player": "player123", "status": "done" }
+```
+
+```
+funifier_save type=folder-log payload=<json>
+```
+
+### 5. Verificar progresso
+
+```
+funifier_folder operation=progress   { "folder": "<root_id>", "player": "player123" }
+funifier_folder operation=inside     { "folder": "<root_id>" }
+```