funifier-mcp 0.3.19 → 0.3.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "funifier-mcp",
-  "version": "0.3.19",
+  "version": "0.3.20",
   "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/references/create-trigger.md

@@ -65,19 +65,39 @@ If search returns insufficient results, read these directly:
 
 ## Steps
 
-## ⚠ Regra crítica: triggers não impedem persistência via throw
+## ⚠ Regra crítica: quando `throw` interrompe a operação
 
-O Funifier **sempre salva o documento** antes de executar o trigger.
+Há **dois modos**, e qual vale depende de onde a trigger roda:
 
-- `before_create` → enriquecimento apenas (normalizar, preencher defaults)
-- Rejeitar criação → usar `after_create`: validar → se inválido:
+- **Modo A — estrito (`throw` aborta):** SÓ em `before_create`/`before_update`/`before_delete` de **coleções de banco** via Database API (`POST`/`PUT`/`DELETE /v3/database/{collection}`). O `DatabaseRest` roda via `TriggerManager.executeStrict`: qualquer exceção aborta a operação — o documento não é gravado/removido e a API responde **HTTP 500** `{ "message": "<msg>", "statusCode": 500 }`. ⚠️ **Recurso version-dependent** — nem toda instância recebeu a atualização. **Sonde antes de depender** (ver bloco de detecção abaixo) ou use o Modo B.
+- **Modo B — persistência garantida (`throw` NÃO cancela):** todo o resto (player, action, swap, quiz, achievement pelos managers, eventos `after_*`, `*_bulk`/`csv_*`). O documento é salvo antes do trigger rodar. Rejeitar = `after_create`:
   ```java
-  database.delete(entity._id, "collection__c");
+  database.delete(entity.id, "collection__c");
   entity.clear();
   entity.put("message", "motivo");
   return;
   ```
-- Para lógica complexa, use `BusinessException` interna (capturada dentro do trigger, não propaga para a plataforma).
+  Para lógica complexa, use `BusinessException` interna (capturada dentro do trigger).
+
+**Regra de ouro:** se o suporte ao Modo A não for confirmado, **gere código no Modo B** e diga ao usuário que o Modo A exige instância atualizada. Detalhes e exemplos: `funifier_read_doc path=guides/triggers-guide` §8.
+
+## 🔎 Detectar suporte ao Modo A (sonda)
+
+Antes de entregar uma trigger que aborta via `throw`, confirme na instância conectada:
+
+```
+# 1. cria trigger-sonda que sempre lança exceção
+funifier_save type=trigger payload={"name":"__probe_strict_mode__","entity":"probe_strict__c","event":"before_create","active":true,"script":"void trigger(event, entity, player, database){ throw new RuntimeException(\"__STRICT_PROBE_BLOCKED__\"); }"}
+# 2. tenta inserir (passa por DatabaseRest.insert → executeStrict)
+funifier_database action=insert collection=probe_strict__c payload={"probe":true}
+#    → erro 500 com "__STRICT_PROBE_BLOCKED__"  = Modo A SUPORTADO
+#    → insert bem-sucedido                       = Modo A NÃO suportado (use Modo B)
+# 3. limpeza (sempre)
+funifier_database action=delete collection=probe_strict__c filter={"probe":true}
+funifier_delete type=trigger id=<_id da sonda>
+```
+
+Sem permissão de escrita / produção sensível → **assuma o Modo B** e avise o usuário.
 
 ---
 
@@ -129,8 +149,8 @@ Perguntar (ou inferir do contexto):
 | `achievement` | `before_create` | Enriquecer conquista com dados de origem (`context.extra`) |
 | `player` | `after_create` | Inicializar campos customizados ao criar jogador |
 | `player` | `before_update` | Normalizar campos antes de salvar atualização |
-| `custom__c` | `before_create` | Normalizar/enriquecer documento customizado |
-| `custom__c` | `after_create` | Validar e rejeitar se inválido (delete + message) |
+| `custom__c` | `before_create` | Normalizar/enriquecer documento; **rejeitar via `throw` no Modo A** (instância atualizada — sondar antes) |
+| `custom__c` | `after_create` | Validar e rejeitar se inválido (delete + message) — **portável, qualquer instância** |
 | `custom__c` | `after_bulk` | Processar import em lote (entity é uma List) |
 
 ### 2. Verificar se já existe
@@ -183,11 +203,3 @@ funifier_logs type=trigger id=<_id>
 ```
 
 Confirme que não há erros de compilação ou execução. Se houver, leia o stack trace e corrija o script.
-
-## Verified References
-
-| Claim | Status | Evidence |
-|-------|--------|----------|
-| Achievement constants TYPE_POINT=0, TYPE_CHALLENGE=1, TYPE_VIRTUAL_GOOD=2, TYPE_LEVEL=3 are defined in the Achievement class | ✓ verified | Class:src/main/java/com/funifier/engine/achievement/Achievement.java:Achievement |
-| ActionLog is the entity class for action triggers with fields actionId, userId, attributes (Map), time, and id | ✓ verified | Class:src/main/java/com/funifier/engine/action/ActionLog.java:ActionLog |
-| TriggerManager is the class that manages trigger script execution and lifecycle in funifier-service | ✓ verified | Class:src/main/java/com/funifier/engine/integration/trigger/TriggerManager.java:TriggerManager |

package/skills/funifier/references/debug.md

@@ -90,9 +90,3 @@ Leia o arquivo de doc específico para o módulo com problema:
 - Scheduler → `funifier_read_doc path=modules/scheduler`
 - Aggregate → `funifier_read_doc path=guides/aggregates`
 - Security/Auth → `funifier_read_doc path=modules/security`
-
-## Verified References
-
-| Claim | Status | Evidence |
-|-------|--------|----------|
-| TriggerManager is the entry point for trigger script execution and error capture in funifier-service | ✓ verified | Class:src/main/java/com/funifier/engine/integration/trigger/TriggerManager.java:TriggerManager |