funifier-mcp 0.2.28 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/.cursor/rules/funifier.mdc +7 -7
  2. package/.github/copilot-instructions.md +10 -8
  3. package/AGENTS.md +8 -4
  4. package/README.md +6 -12
  5. package/datasource-funifier-docs/.coverage.json +1 -1
  6. package/dist/cli/init.d.ts.map +1 -1
  7. package/dist/cli/init.js +13 -9
  8. package/dist/cli/init.js.map +1 -1
  9. package/dist/cli/init.test.js +28 -9
  10. package/dist/cli/init.test.js.map +1 -1
  11. package/dist/cli/prompts.d.ts +1 -0
  12. package/dist/cli/prompts.d.ts.map +1 -1
  13. package/dist/cli/prompts.js +8 -0
  14. package/dist/cli/prompts.js.map +1 -1
  15. package/dist/cli/search.js +3 -3
  16. package/dist/cli/search.js.map +1 -1
  17. package/dist/cli/search.test.js +9 -9
  18. package/dist/cli/search.test.js.map +1 -1
  19. package/dist/mcp/bundle.js +84 -84
  20. package/dist/mcp/resources/documentation.d.ts.map +1 -1
  21. package/dist/mcp/resources/documentation.js +2 -1
  22. package/dist/mcp/resources/documentation.js.map +1 -1
  23. package/dist/mcp/tools/docs-flow.test.d.ts +2 -0
  24. package/dist/mcp/tools/docs-flow.test.d.ts.map +1 -0
  25. package/dist/mcp/tools/docs-flow.test.js +91 -0
  26. package/dist/mcp/tools/docs-flow.test.js.map +1 -0
  27. package/dist/mcp/tools/index.d.ts.map +1 -1
  28. package/dist/mcp/tools/index.js +2 -0
  29. package/dist/mcp/tools/index.js.map +1 -1
  30. package/dist/mcp/tools/read-doc.d.ts +3 -0
  31. package/dist/mcp/tools/read-doc.d.ts.map +1 -0
  32. package/dist/mcp/tools/read-doc.js +97 -0
  33. package/dist/mcp/tools/read-doc.js.map +1 -0
  34. package/dist/mcp/tools/read-doc.test.d.ts +2 -0
  35. package/dist/mcp/tools/read-doc.test.d.ts.map +1 -0
  36. package/dist/mcp/tools/read-doc.test.js +92 -0
  37. package/dist/mcp/tools/read-doc.test.js.map +1 -0
  38. package/dist/mcp/tools/search-docs.js +3 -3
  39. package/dist/mcp/tools/search-docs.js.map +1 -1
  40. package/dist/mcp/tools/search-docs.test.d.ts +2 -0
  41. package/dist/mcp/tools/search-docs.test.d.ts.map +1 -0
  42. package/dist/mcp/tools/search-docs.test.js +100 -0
  43. package/dist/mcp/tools/search-docs.test.js.map +1 -0
  44. package/package.json +1 -1
  45. package/skills/funifier/SKILL.md +5 -3
  46. package/skills/funifier/references/configure-security.md +7 -7
  47. package/skills/funifier/references/create-action.md +7 -7
  48. package/skills/funifier/references/create-aggregate.md +8 -8
  49. package/skills/funifier/references/create-challenge.md +8 -8
  50. package/skills/funifier/references/create-competition.md +6 -6
  51. package/skills/funifier/references/create-crossword.md +1 -1
  52. package/skills/funifier/references/create-custom-object.md +7 -7
  53. package/skills/funifier/references/create-custom-page.md +8 -8
  54. package/skills/funifier/references/create-folder.md +6 -6
  55. package/skills/funifier/references/create-lastmile.md +1 -1
  56. package/skills/funifier/references/create-leaderboard.md +8 -8
  57. package/skills/funifier/references/create-level.md +7 -7
  58. package/skills/funifier/references/create-notification.md +7 -7
  59. package/skills/funifier/references/create-point.md +7 -7
  60. package/skills/funifier/references/create-quiz.md +7 -7
  61. package/skills/funifier/references/create-scheduler.md +10 -10
  62. package/skills/funifier/references/create-story.md +1 -1
  63. package/skills/funifier/references/create-swap.md +6 -6
  64. package/skills/funifier/references/create-trigger.md +14 -14
  65. package/skills/funifier/references/create-virtual-good.md +7 -7
  66. package/skills/funifier/references/create-webhook.md +7 -7
  67. package/skills/funifier/references/create-websocket.md +8 -8
  68. package/skills/funifier/references/create-widget.md +7 -7
  69. package/skills/funifier/references/debug.md +16 -16
  70. package/skills/funifier/references/help.md +8 -8
  71. package/skills/funifier/references/implement-frontend.md +15 -15
  72. package/skills/funifier/references/import-csv.md +7 -7
  73. package/skills/funifier/references/manage-player.md +6 -6
  74. package/skills/funifier/references/manage-team.md +6 -6
  75. package/skills/funifier/references/upload-file.md +6 -6
@@ -6,19 +6,19 @@ Create a Funifier widget — embeddable visual components (rankings, challenge l
6
6
 
7
7
  ## Before starting — find relevant docs
8
8
 
9
- Run lexical search to load only what you need:
9
+ Use the `funifier_search_docs` MCP tool to load only what you need:
10
10
 
11
- ```bash
12
- npx funifier-mcp search "widget embed visual ranking leaderboard component intranet integration display" --skill funifier-create-widget
11
+ ```
12
+ funifier_search_docs "widget embed visual ranking leaderboard component intranet integration display"
13
13
  ```
14
14
 
15
- Read only files returned with score > 0.5 (this threshold is printed in the search output).
15
+ Then read the most relevant results with `funifier_read_doc path=<path>`.
16
16
 
17
17
  ## Primary docs for this skill
18
18
 
19
- If search returns insufficient results, read directly:
19
+ If search returns insufficient results, read these directly:
20
20
 
21
- - `datasource-funifier-docs/knowledge/modules/widget.md`
21
+ - `funifier_read_doc path=modules/widget`
22
22
 
23
23
  ## Steps
24
24
 
@@ -41,7 +41,7 @@ funifier_list type=widget search=<nome>
41
41
  ### 2. Ler a documentação do módulo
42
42
 
43
43
  ```
44
- datasource-funifier-docs/knowledge/modules/widget.md
44
+ funifier_read_doc path=modules/widget
45
45
  ```
46
46
 
47
47
  ### 3. Criar o widget no Studio
@@ -6,25 +6,25 @@ Debug a Funifier resource — systematic diagnosis of triggers, schedulers, aggr
6
6
 
7
7
  ## Before starting — find relevant docs
8
8
 
9
- Run lexical search to load only what you need:
9
+ Use the `funifier_search_docs` MCP tool to load only what you need:
10
10
 
11
- ```bash
12
- npx funifier-mcp search "debug error log exception timeout groovy stack trace fix" --skill funifier-debug
11
+ ```
12
+ funifier_search_docs "debug error log exception timeout groovy stack trace fix"
13
13
  ```
14
14
 
15
- Read only files returned with score > 0.5 (this threshold is printed in the search output).
15
+ Then read the most relevant results with `funifier_read_doc path=<path>`.
16
16
 
17
17
  ## Primary docs for this skill
18
18
 
19
- If search returns insufficient results, read directly:
19
+ If search returns insufficient results, read these directly:
20
20
 
21
- - `datasource-funifier-docs/knowledge/guides/java-libraries.md`
22
- - `datasource-funifier-docs/knowledge/modules/trigger.md`
23
- - `datasource-funifier-docs/knowledge/guides/triggers-guide.md`
24
- - `datasource-funifier-docs/knowledge/guides/trigger-examples.md`
25
- - `datasource-funifier-docs/knowledge/modules/scheduler.md`
26
- - `datasource-funifier-docs/knowledge/guides/aggregates.md`
27
- - `datasource-funifier-docs/knowledge/modules/public.md`
21
+ - `funifier_read_doc path=guides/java-libraries`
22
+ - `funifier_read_doc path=modules/trigger`
23
+ - `funifier_read_doc path=guides/triggers-guide`
24
+ - `funifier_read_doc path=guides/trigger-examples`
25
+ - `funifier_read_doc path=modules/scheduler`
26
+ - `funifier_read_doc path=guides/aggregates`
27
+ - `funifier_read_doc path=modules/public`
28
28
 
29
29
  ## Steps
30
30
 
@@ -81,7 +81,7 @@ Compare com o que a documentação exige.
81
81
  ### 5. Ler a documentação primária do módulo
82
82
 
83
83
  Leia o arquivo de doc específico para o módulo com problema:
84
- - Trigger → `datasource-funifier-docs/knowledge/modules/trigger.md` + guides
85
- - Scheduler → `datasource-funifier-docs/knowledge/modules/scheduler.md`
86
- - Aggregate → `datasource-funifier-docs/knowledge/guides/aggregates.md`
87
- - Security/Auth → `datasource-funifier-docs/knowledge/modules/security.md`
84
+ - Trigger → `funifier_read_doc path=modules/trigger` + guides
85
+ - Scheduler → `funifier_read_doc path=modules/scheduler`
86
+ - Aggregate → `funifier_read_doc path=guides/aggregates`
87
+ - Security/Auth → `funifier_read_doc path=modules/security`
@@ -6,19 +6,19 @@ Get help with Funifier — routes to the right documentation or skill based on y
6
6
 
7
7
  ## Before starting — find relevant docs
8
8
 
9
- Run lexical search to load only what you need:
9
+ Use the `funifier_search_docs` MCP tool to load only what you need:
10
10
 
11
- ```bash
12
- npx funifier-mcp search "help documentation guide module question how what funifier" --skill funifier-help
11
+ ```
12
+ funifier_search_docs "help documentation guide module question how what funifier"
13
13
  ```
14
14
 
15
- Read only files returned with score > 0.5 (this threshold is printed in the search output).
15
+ Then read the most relevant results with `funifier_read_doc path=<path>`.
16
16
 
17
17
  ## Primary docs for this skill
18
18
 
19
- If search returns insufficient results, read directly:
19
+ If search returns insufficient results, read these directly:
20
20
 
21
- - `datasource-funifier-docs/knowledge/index.md`
21
+ - `funifier_read_doc path=index`
22
22
 
23
23
  ## Steps
24
24
 
@@ -69,7 +69,7 @@ Perguntar: o que você está tentando fazer na gamificação?
69
69
  ### 2. Consultar a documentação de índice
70
70
 
71
71
  ```
72
- datasource-funifier-docs/knowledge/index.md
72
+ funifier_read_doc path=index
73
73
  ```
74
74
 
75
75
  ### 3. Redirecionar para a skill correta
@@ -78,4 +78,4 @@ Baseado na tabela acima, instrua o usuário a usar a skill específica.
78
78
 
79
79
  ### 4. Se não encontrar skill específica
80
80
 
81
- Consulte `datasource-funifier-docs/knowledge/index.md` e leia o módulo relevante diretamente.
81
+ Consulte `funifier_read_doc path=index` e leia o módulo relevante diretamente.
@@ -6,24 +6,24 @@ Implement frontend code that consumes the Funifier API — authentication, data
6
6
 
7
7
  ## Before starting — find relevant docs
8
8
 
9
- Run lexical search to load only what you need:
9
+ Use the `funifier_search_docs` MCP tool to load only what you need:
10
10
 
11
- ```bash
12
- npx funifier-mcp search "frontend api authentication fetch jwt token javascript react angular static hosting" --skill funifier-implement-frontend
11
+ ```
12
+ funifier_search_docs "frontend api authentication fetch jwt token javascript react angular static hosting"
13
13
  ```
14
14
 
15
- Read only files returned with score > 0.5 (this threshold is printed in the search output).
15
+ Then read the most relevant results with `funifier_read_doc path=<path>`.
16
16
 
17
17
  ## Primary docs for this skill
18
18
 
19
- If search returns insufficient results, read directly:
19
+ If search returns insufficient results, read these directly:
20
20
 
21
- - `datasource-funifier-docs/knowledge/modules/auth.md`
22
- - `datasource-funifier-docs/knowledge/guides/aggregates.md`
23
- - `datasource-funifier-docs/knowledge/guides/database-access.md`
24
- - `datasource-funifier-docs/knowledge/modules/patterns.md`
25
- - `datasource-funifier-docs/knowledge/modules/action-log.md`
26
- - `datasource-funifier-docs/knowledge/modules/static-repo.md`
21
+ - `funifier_read_doc path=modules/auth`
22
+ - `funifier_read_doc path=guides/aggregates`
23
+ - `funifier_read_doc path=guides/database-access`
24
+ - `funifier_read_doc path=modules/patterns`
25
+ - `funifier_read_doc path=modules/action-log`
26
+ - `funifier_read_doc path=modules/static-repo`
27
27
 
28
28
  ## Steps
29
29
 
@@ -69,9 +69,9 @@ const basicToken = 'Basic ' + btoa('API_KEY:APP_SECRET');
69
69
 
70
70
  ### 1. Ler documentação de auth e padrões
71
71
 
72
- - `datasource-funifier-docs/knowledge/modules/auth.md`
73
- - `datasource-funifier-docs/knowledge/modules/patterns.md`
74
- - `datasource-funifier-docs/knowledge/guides/aggregates.md` (para relatórios)
72
+ - `funifier_read_doc path=modules/auth`
73
+ - `funifier_read_doc path=modules/patterns`
74
+ - `funifier_read_doc path=guides/aggregates` (para relatórios)
75
75
 
76
76
  ### 2. Implementar autenticação
77
77
 
@@ -103,4 +103,4 @@ const report = await fetch('/v3/database/achievement/aggregate', {
103
103
 
104
104
  ### 5. Hospedar no Funifier (opcional)
105
105
 
106
- Para arquivos estáticos, leia `datasource-funifier-docs/knowledge/modules/static-repo.md`.
106
+ Para arquivos estáticos, leia `funifier_read_doc path=modules/static-repo`.
@@ -6,19 +6,19 @@ Import or export Funifier platform data via CSV — bulk player import, performa
6
6
 
7
7
  ## Before starting — find relevant docs
8
8
 
9
- Run lexical search to load only what you need:
9
+ Use the `funifier_search_docs` MCP tool to load only what you need:
10
10
 
11
- ```bash
12
- npx funifier-mcp search "csv import export bulk data migration player dataset" --skill funifier-import-csv
11
+ ```
12
+ funifier_search_docs "csv import export bulk data migration player dataset"
13
13
  ```
14
14
 
15
- Read only files returned with score > 0.5 (this threshold is printed in the search output).
15
+ Then read the most relevant results with `funifier_read_doc path=<path>`.
16
16
 
17
17
  ## Primary docs for this skill
18
18
 
19
- If search returns insufficient results, read directly:
19
+ If search returns insufficient results, read these directly:
20
20
 
21
- - `datasource-funifier-docs/knowledge/modules/csv-data.md`
21
+ - `funifier_read_doc path=modules/csv-data`
22
22
 
23
23
  ## Steps
24
24
 
@@ -35,7 +35,7 @@ O módulo CSV permite importar dados em massa (jogadores, ações, etc.) e expor
35
35
  ### 1. Ler a documentação do módulo
36
36
 
37
37
  ```
38
- datasource-funifier-docs/knowledge/modules/csv-data.md
38
+ funifier_read_doc path=modules/csv-data
39
39
  ```
40
40
 
41
41
  ### 2. Preparar o arquivo CSV
@@ -6,19 +6,19 @@ Register and manage Funifier players — CRUD workflow for participant onboardin
6
6
 
7
7
  ## Before starting — find relevant docs
8
8
 
9
- Run lexical search to load only what you need:
9
+ Use the `funifier_search_docs` MCP tool to load only what you need:
10
10
 
11
- ```bash
12
- npx funifier-mcp search "player user register onboarding participant status extra profile" --skill funifier-manage-player
11
+ ```
12
+ funifier_search_docs "player user register onboarding participant status extra profile"
13
13
  ```
14
14
 
15
- Read only files returned with score > 0.5 (this threshold is printed in the search output).
15
+ Then read the most relevant results with `funifier_read_doc path=<path>`.
16
16
 
17
17
  ## Primary docs for this skill
18
18
 
19
- If search returns insufficient results, read directly:
19
+ If search returns insufficient results, read these directly:
20
20
 
21
- - `datasource-funifier-docs/knowledge/modules/player.md`
21
+ - `funifier_read_doc path=modules/player`
22
22
 
23
23
  ## Steps
24
24
 
@@ -6,19 +6,19 @@ Create and manage Funifier teams — group players for collective challenges, te
6
6
 
7
7
  ## Before starting — find relevant docs
8
8
 
9
- Run lexical search to load only what you need:
9
+ Use the `funifier_search_docs` MCP tool to load only what you need:
10
10
 
11
- ```bash
12
- npx funifier-mcp search "team group department member collective ranking collaboration squad" --skill funifier-manage-team
11
+ ```
12
+ funifier_search_docs "team group department member collective ranking collaboration squad"
13
13
  ```
14
14
 
15
- Read only files returned with score > 0.5 (this threshold is printed in the search output).
15
+ Then read the most relevant results with `funifier_read_doc path=<path>`.
16
16
 
17
17
  ## Primary docs for this skill
18
18
 
19
- If search returns insufficient results, read directly:
19
+ If search returns insufficient results, read these directly:
20
20
 
21
- - `datasource-funifier-docs/knowledge/modules/team.md`
21
+ - `funifier_read_doc path=modules/team`
22
22
 
23
23
  ## Steps
24
24
 
@@ -6,19 +6,19 @@ Upload files to Funifier — images and documents for player avatars, challenge
6
6
 
7
7
  ## Before starting — find relevant docs
8
8
 
9
- Run lexical search to load only what you need:
9
+ Use the `funifier_search_docs` MCP tool to load only what you need:
10
10
 
11
- ```bash
12
- npx funifier-mcp search "upload image file avatar media asset s3 multipart" --skill funifier-upload-file
11
+ ```
12
+ funifier_search_docs "upload image file avatar media asset s3 multipart"
13
13
  ```
14
14
 
15
- Read only files returned with score > 0.5 (this threshold is printed in the search output).
15
+ Then read the most relevant results with `funifier_read_doc path=<path>`.
16
16
 
17
17
  ## Primary docs for this skill
18
18
 
19
- If search returns insufficient results, read directly:
19
+ If search returns insufficient results, read these directly:
20
20
 
21
- - `datasource-funifier-docs/knowledge/modules/upload.md`
21
+ - `funifier_read_doc path=modules/upload`
22
22
 
23
23
  ## Steps
24
24