funifier-mcp 0.3.19 → 0.3.21

package/.cursor/rules/funifier.mdc

@@ -62,6 +62,7 @@ Then read a result with `funifier_read_doc path=<path>`.
 | `skills/funifier/references/upload-file.md` | Upload files to Funifier — images and documents for player avatars, challenge resources, and visual assets; use when adding media to the platform, not for CSV data import (use funifier-import-csv) or static frontend hosting (use funifier-implement-frontend) |
 | `skills/funifier/references/manage-indexes.md` | Create, list, and drop MongoDB single-field indexes on Funifier collections via the REST API. Composite (multi-field) indexes are NOT supported by this endpoint — see Limitation section. |
 | `skills/funifier/references/audit-permissions.md` | Cross-check a project's Funifier API calls against the live security document — scan code for usage, build an evidence-backed manifest, run the deterministic audit engine, and report missing scopes, excess tokens, and static danger findings; use when debugging 401s, auditing minimum privilege, or verifying permissions before deploying; audit is read-only and never changes any configuration |
+| `skills/funifier/references/server-utils.md` | Use the server-side utility classes from com.funifier.engine.util in Groovy triggers, schedulers, and public endpoints — validates CPF, encrypts fields with AES/BCrypt/PGP, renders Mustache templates, evaluates inline expressions, computes object diffs/changelogs, converts JSON, generates Excel, makes HTTP calls, and handles files and pagination |
 
 Full workflow files: `skills/funifier/references/`
 

package/.github/copilot-instructions.md

@@ -55,6 +55,7 @@ Detailed guided workflows live in `skills/funifier/references/`:
 | `skills/funifier/references/upload-file.md` | Upload files to Funifier — images and documents for player avatars, challenge resources, and visual assets; use when adding media to the platform, not for CSV data import (use funifier-import-csv) or static frontend hosting (use funifier-implement-frontend) |
 | `skills/funifier/references/manage-indexes.md` | Create, list, and drop MongoDB single-field indexes on Funifier collections via the REST API. Composite (multi-field) indexes are NOT supported by this endpoint — see Limitation section. |
 | `skills/funifier/references/audit-permissions.md` | Cross-check a project's Funifier API calls against the live security document — scan code for usage, build an evidence-backed manifest, run the deterministic audit engine, and report missing scopes, excess tokens, and static danger findings; use when debugging 401s, auditing minimum privilege, or verifying permissions before deploying; audit is read-only and never changes any configuration |
+| `skills/funifier/references/server-utils.md` | Use the server-side utility classes from com.funifier.engine.util in Groovy triggers, schedulers, and public endpoints — validates CPF, encrypts fields with AES/BCrypt/PGP, renders Mustache templates, evaluates inline expressions, computes object diffs/changelogs, converts JSON, generates Excel, makes HTTP calls, and handles files and pagination |
 
 ### Funifier Modules
 

package/AGENTS.md

@@ -94,6 +94,7 @@ Before any `funifier_*` MCP tool call or Funifier task, find the matching row an
 | `skills/funifier/references/upload-file.md` | Upload files to Funifier — images and documents for player avatars, challenge resources, and visual assets; use when adding media to the platform, not for CSV data import (use funifier-import-csv) or static frontend hosting (use funifier-implement-frontend) |
 | `skills/funifier/references/manage-indexes.md` | Create, list, and drop MongoDB single-field indexes on Funifier collections via the REST API. Composite (multi-field) indexes are NOT supported by this endpoint — see Limitation section. |
 | `skills/funifier/references/audit-permissions.md` | Cross-check a project's Funifier API calls against the live security document — scan code for usage, build an evidence-backed manifest, run the deterministic audit engine, and report missing scopes, excess tokens, and static danger findings; use when debugging 401s, auditing minimum privilege, or verifying permissions before deploying; audit is read-only and never changes any configuration |
+| `skills/funifier/references/server-utils.md` | Use the server-side utility classes from com.funifier.engine.util in Groovy triggers, schedulers, and public endpoints — validates CPF, encrypts fields with AES/BCrypt/PGP, renders Mustache templates, evaluates inline expressions, computes object diffs/changelogs, converts JSON, generates Excel, makes HTTP calls, and handles files and pagination |
 
 ## Funifier Modules
 

package/CHANGELOG.md

@@ -3,6 +3,36 @@
 All notable changes to `funifier-mcp` are documented here. Format loosely follows
 [Keep a Changelog](https://keepachangelog.com/); versions follow semver.
 
+## [0.3.21]
+
+Documentation of the `com.funifier.engine.util` package as a new knowledge guide and Claude Code skill.
+
+### Documentation
+- **Add `guides/server-utils.md`.** Covers all 17 developer-facing classes in the Funifier server-side utilities package: `JsonUtil`, `StringUtil`, `CpfUtil`, `FormatterUtil`, `ParserUtil`, `ExpressionUtils`, `MustacheUtils`, `DiffUtil`, `AesCrypt`, `BCrypt`, `PgpCrypt`, `OtpAuthUtil`, `HttpUtil`, `UrlUtil`, `ExcelUtil`, `PaginationUtil`, and `FileUtil`. Each class has its FQN, real public signatures (verified against source), and ≥1 Groovy/Java server-side example. Security-sensitive classes (AesCrypt, BCrypt, PgpCrypt, OtpAuthUtil) include secret-management notes. `DateUtil` is cross-linked to `funifier-date-handling` instead of duplicated.
+- **Register in `knowledge/index.md`.** New entry in the Java guides section so the knowledge router surfaces the guide.
+
+### Skills
+- **New skill `funifier-server-utils`** in `scripts/skills-config.ts` + regenerated reference. Triggers on requests like "validar CPF", "criptografar campo", "gerar TOTP", "renderizar template Mustache", "diff de objeto", "converter JSON", "gerar Excel" and similar.
+
+## [0.3.20]
+
+Documentation of trigger flow-interruption (strict mode) in the Funifier knowledge base.
+
+### Documentation
+- **Document `TriggerManager.executeStrict` (strict mode).** `DatabaseRest.insert/update/delete`
+  run `before_create`/`before_update`/`before_delete` triggers on database collections
+  (`/v3/database/{collection}`) in strict mode: an exception in the script aborts the
+  operation (document not written/removed; API responds **HTTP 500** with
+  `{ "message", "statusCode": 500 }`). Every other path (player/action/swap/quiz/bulk/`after_*`)
+  still uses plain `execute()`, which swallows exceptions and persists the document.
+- **Mode A (strict `throw`) vs Mode B (`after_create` + delete).** Rewrote
+  `guides/triggers-guide.md` §8 and updated `guides/trigger-examples.md` and
+  `modules/trigger.md` (new §2.5.1 `execute` vs `executeStrict`) to distinguish the two
+  rejection patterns and when each applies.
+- **Version-dependent feature + detection probe.** Strict mode was added in a recent Engine
+  update and is not on every instance; docs and the `funifier-create-trigger` skill now
+  include a disposable-trigger probe to detect support before relying on it.
+
 ## [0.3.19]
 
 Implementation of the prioritized improvements from the MCP implementation review

package/datasource-funifier-docs/.coverage.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-06-12T18:58:00.000Z",
+  "generatedAt": "2026-06-22T15:32:00.000Z",
   "docsRoot": "datasource-funifier-docs/",
   "docs": {
     "knowledge/guides/aggregates.md": {
@@ -39,7 +39,8 @@
       "status": "grouped",
       "skillIds": [
         "funifier-create-trigger",
-        "funifier-create-scheduler"
+        "funifier-create-scheduler",
+        "funifier-server-utils"
       ]
     },
     "knowledge/guides/permission-audit.md": {
@@ -48,6 +49,12 @@
         "funifier-audit-permissions"
       ]
     },
+    "knowledge/guides/server-utils.md": {
+      "status": "covered",
+      "skillIds": [
+        "funifier-server-utils"
+      ]
+    },
     "knowledge/guides/trigger-examples.md": {
       "status": "grouped",
       "skillIds": [
@@ -59,7 +66,8 @@
       "status": "grouped",
       "skillIds": [
         "funifier-create-trigger",
-        "funifier-debug"
+        "funifier-debug",
+        "funifier-server-utils"
       ]
     },
     "knowledge/index.md": {
@@ -338,8 +346,8 @@
     }
   },
   "summary": {
-    "total": 52,
-    "covered": 32,
+    "total": 53,
+    "covered": 33,
     "grouped": 14,
     "deferred": 6,
     "uncovered": 0