@mcp-graph-workflow/mcp-graph 5.27.0 → 5.28.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 (114) hide show
  1. package/README.md +10 -9
  2. package/dist/api/router.d.ts.map +1 -1
  3. package/dist/api/router.js +2 -0
  4. package/dist/api/router.js.map +1 -1
  5. package/dist/api/routes/docs-reference.d.ts +7 -0
  6. package/dist/api/routes/docs-reference.d.ts.map +1 -0
  7. package/dist/api/routes/docs-reference.js +136 -0
  8. package/dist/api/routes/docs-reference.js.map +1 -0
  9. package/dist/api/routes/knowledge.d.ts.map +1 -1
  10. package/dist/api/routes/knowledge.js +90 -8
  11. package/dist/api/routes/knowledge.js.map +1 -1
  12. package/dist/cli/commands/update.js +1 -1
  13. package/dist/cli/commands/update.js.map +1 -1
  14. package/dist/core/config/ai-memory-generator.d.ts +2 -2
  15. package/dist/core/config/ai-memory-generator.d.ts.map +1 -1
  16. package/dist/core/config/ai-memory-generator.js +33 -176
  17. package/dist/core/config/ai-memory-generator.js.map +1 -1
  18. package/dist/core/config/ignore-templates.d.ts +20 -0
  19. package/dist/core/config/ignore-templates.d.ts.map +1 -0
  20. package/dist/core/config/ignore-templates.js +176 -0
  21. package/dist/core/config/ignore-templates.js.map +1 -0
  22. package/dist/core/config/reference-content.d.ts +35 -0
  23. package/dist/core/config/reference-content.d.ts.map +1 -0
  24. package/dist/core/config/reference-content.js +449 -0
  25. package/dist/core/config/reference-content.js.map +1 -0
  26. package/dist/core/deployer/deploy-readiness.d.ts +12 -0
  27. package/dist/core/deployer/deploy-readiness.d.ts.map +1 -0
  28. package/dist/core/deployer/deploy-readiness.js +102 -0
  29. package/dist/core/deployer/deploy-readiness.js.map +1 -0
  30. package/dist/core/docs/doc-generator.d.ts +23 -0
  31. package/dist/core/docs/doc-generator.d.ts.map +1 -0
  32. package/dist/core/docs/doc-generator.js +86 -0
  33. package/dist/core/docs/doc-generator.js.map +1 -0
  34. package/dist/core/docs/doc-updater.d.ts +10 -0
  35. package/dist/core/docs/doc-updater.d.ts.map +1 -0
  36. package/dist/core/docs/doc-updater.js +27 -0
  37. package/dist/core/docs/doc-updater.js.map +1 -0
  38. package/dist/core/docs/route-introspector.d.ts +19 -0
  39. package/dist/core/docs/route-introspector.d.ts.map +1 -0
  40. package/dist/core/docs/route-introspector.js +60 -0
  41. package/dist/core/docs/route-introspector.js.map +1 -0
  42. package/dist/core/docs/tool-introspector.d.ts +17 -0
  43. package/dist/core/docs/tool-introspector.d.ts.map +1 -0
  44. package/dist/core/docs/tool-introspector.js +82 -0
  45. package/dist/core/docs/tool-introspector.js.map +1 -0
  46. package/dist/core/planner/lifecycle-phase.d.ts +1 -1
  47. package/dist/core/planner/lifecycle-phase.d.ts.map +1 -1
  48. package/dist/core/planner/lifecycle-phase.js +52 -0
  49. package/dist/core/planner/lifecycle-phase.js.map +1 -1
  50. package/dist/core/rag/phase-metadata.d.ts.map +1 -1
  51. package/dist/core/rag/phase-metadata.js +5 -0
  52. package/dist/core/rag/phase-metadata.js.map +1 -1
  53. package/dist/core/store/knowledge-store.d.ts +7 -0
  54. package/dist/core/store/knowledge-store.d.ts.map +1 -1
  55. package/dist/core/store/knowledge-store.js +15 -0
  56. package/dist/core/store/knowledge-store.js.map +1 -1
  57. package/dist/mcp/init-project.d.ts.map +1 -1
  58. package/dist/mcp/init-project.js +68 -8
  59. package/dist/mcp/init-project.js.map +1 -1
  60. package/dist/mcp/tools/analyze.d.ts.map +1 -1
  61. package/dist/mcp/tools/analyze.js +40 -1
  62. package/dist/mcp/tools/analyze.js.map +1 -1
  63. package/dist/mcp/tools/help.d.ts +3 -0
  64. package/dist/mcp/tools/help.d.ts.map +1 -0
  65. package/dist/mcp/tools/help.js +74 -0
  66. package/dist/mcp/tools/help.js.map +1 -0
  67. package/dist/mcp/tools/index.d.ts.map +1 -1
  68. package/dist/mcp/tools/index.js +2 -0
  69. package/dist/mcp/tools/index.js.map +1 -1
  70. package/dist/mcp/tools/list-skills.js +1 -1
  71. package/dist/mcp/tools/list-skills.js.map +1 -1
  72. package/dist/mcp/tools/manage-skill.js +1 -1
  73. package/dist/mcp/tools/manage-skill.js.map +1 -1
  74. package/dist/mcp/tools/set-phase.js +1 -1
  75. package/dist/mcp/tools/set-phase.js.map +1 -1
  76. package/dist/schemas/deployer-schema.d.ts +34 -0
  77. package/dist/schemas/deployer-schema.d.ts.map +1 -0
  78. package/dist/schemas/deployer-schema.js +17 -0
  79. package/dist/schemas/deployer-schema.js.map +1 -0
  80. package/dist/schemas/skill.schema.d.ts +3 -0
  81. package/dist/schemas/skill.schema.d.ts.map +1 -1
  82. package/dist/schemas/skill.schema.js +1 -1
  83. package/dist/schemas/skill.schema.js.map +1 -1
  84. package/dist/web/dashboard/dist/assets/{benchmark-tab-ChRIBQcA.js → benchmark-tab-Dx9G7cqf.js} +1 -1
  85. package/dist/web/dashboard/dist/assets/{circle-alert-CDZ2Oz9A.js → circle-alert-B17sfIdw.js} +1 -1
  86. package/dist/web/dashboard/dist/assets/constants-Dd6A34aQ.js +1 -0
  87. package/dist/web/dashboard/dist/assets/{context-tab-ClyJEQyQ.js → context-tab-BX2hlI9H.js} +1 -1
  88. package/dist/web/dashboard/dist/assets/docs-tab-sxC7Gxc7.js +1 -0
  89. package/dist/web/dashboard/dist/assets/{gitnexus-tab-uG_IXJAC.js → gitnexus-tab-DEcNhLvY.js} +1 -1
  90. package/dist/web/dashboard/dist/assets/{graph-section-BfAmG5lE.js → graph-section-CsHifp70.js} +1 -1
  91. package/dist/web/dashboard/dist/assets/{graph-tab-CG9ZAKno.js → graph-tab-D8ZSUyGR.js} +1 -1
  92. package/dist/web/dashboard/dist/assets/{graph-utils-_5ZIVYpg.js → graph-utils-D10A5HwE.js} +1 -1
  93. package/dist/web/dashboard/dist/assets/{index-jFrjjy9L.js → index-07Y4UWP1.js} +1 -1
  94. package/dist/web/dashboard/dist/assets/{index-CaC7cmzW.js → index-CVRN6scU.js} +1 -1
  95. package/dist/web/dashboard/dist/assets/index-DVIgWBT4.css +1 -0
  96. package/dist/web/dashboard/dist/assets/{index-BaFYAVmk.js → index-Dbaws8C6.js} +46 -41
  97. package/dist/web/dashboard/dist/assets/{insights-tab-EnTEAW50.js → insights-tab-DJAtypOr.js} +1 -1
  98. package/dist/web/dashboard/dist/assets/{journey-tab-Ba2R4l8c.js → journey-tab-CXtDFeGm.js} +1 -1
  99. package/dist/web/dashboard/dist/assets/{languages-tab-BOZaQLA6.js → languages-tab-03j3C58E.js} +25 -30
  100. package/dist/web/dashboard/dist/assets/{loader-circle-DIYk9wxS.js → loader-circle-BNEIXs1s.js} +1 -1
  101. package/dist/web/dashboard/dist/assets/{logs-tab-ZWCruIzU.js → logs-tab-D3BE923P.js} +1 -1
  102. package/dist/web/dashboard/dist/assets/{lsp-tab-B_xnLDB4.js → lsp-tab-cac4ysh4.js} +1 -1
  103. package/dist/web/dashboard/dist/assets/memories-tab-BPJTM45d.js +1 -0
  104. package/dist/web/dashboard/dist/assets/{prd-backlog-tab-BByZFrjw.js → prd-backlog-tab-5PCpKm0j.js} +1 -1
  105. package/dist/web/dashboard/dist/assets/{refresh-cw-Ds0I1g9D.js → refresh-cw-CI2U4FGa.js} +1 -1
  106. package/dist/web/dashboard/dist/assets/{siebel-tab-BndR6AA4.js → siebel-tab-BuhOpZO3.js} +3 -3
  107. package/dist/web/dashboard/dist/assets/{skills-tab-DT6taugG.js → skills-tab-BHWwOBtm.js} +1 -1
  108. package/dist/web/dashboard/dist/assets/{style-C5z-qKN9.js → style-BPgBTbDw.js} +1 -1
  109. package/dist/web/dashboard/dist/assets/{triangle-alert-DA1VDEuy.js → triangle-alert-aqoYdsgW.js} +1 -1
  110. package/dist/web/dashboard/dist/index.html +2 -2
  111. package/package.json +15 -2
  112. package/dist/web/dashboard/dist/assets/constants-lq4BIQN3.js +0 -1
  113. package/dist/web/dashboard/dist/assets/index-C4f-Fp0Q.css +0 -1
  114. package/dist/web/dashboard/dist/assets/memories-tab-EeBOo09e.js +0 -1
@@ -2,6 +2,7 @@
2
2
  * Generates AI instruction sections for CLAUDE.md and .github/copilot-instructions.md.
3
3
  * Both outputs are idempotent (use markers to detect existing sections).
4
4
  */
5
+ import { TOOL_TABLE_FULL, DEPRECATED_TOOLS_SECTION, ANALYZE_MODES_SECTION, KNOWLEDGE_PIPELINE_SECTION, SKILLS_SECTION, CLI_COMMANDS as CLI_COMMANDS_REF, } from "./reference-content.js";
5
6
  export const MARKER_START = "<!-- mcp-graph:start -->";
6
7
  export const MARKER_END = "<!-- mcp-graph:end -->";
7
8
  const MANDATORY_EXECUTION_RULE = `### ⚠️ Regra de Execução OBRIGATÓRIA
@@ -16,157 +17,7 @@ const MANDATORY_EXECUTION_RULE = `### ⚠️ Regra de Execução OBRIGATÓRIA
16
17
  6. **Zero trabalho não-rastreado** — se não tem node no grafo, CRIAR PRIMEIRO
17
18
 
18
19
  > **Sem node no grafo = sem código escrito.**`;
19
- const TOOL_TABLE_FULL = `#### Projeto & Grafo
20
-
21
- | Tool | Quando usar |
22
- |------|-------------|
23
- | \`init\` | Inicializar grafo do projeto (cria DB, AI memory files, detecta MCPs) |
24
- | \`list\` | Listar nodes do grafo (filtrar por tipo/status/parent) |
25
- | \`show\` | Ver detalhes de um node específico (metadata, deps, knowledge) |
26
- | \`search\` | Busca full-text no grafo (FTS5 + BM25 ranking) |
27
- | \`export\` | Exportar grafo (JSON completo ou Mermaid diagram) |
28
- | \`snapshot\` | Criar/restaurar snapshots do grafo (backup/rollback) |
29
- | \`metrics\` | Estatísticas do grafo (\`stats\`) ou velocidade por sprint (\`velocity\`) |
30
-
31
- #### Nodes & Edges
32
-
33
- | Tool | Quando usar |
34
- |------|-------------|
35
- | \`node\` | CRUD de nodes: action \`add\` (criar), \`update\` (atualizar), \`delete\` (remover) |
36
- | \`move_node\` | Mover node para outro parent |
37
- | \`clone_node\` | Clonar node com filhos (deep copy) |
38
- | \`edge\` | Criar/remover relações entre nodes (depends_on, blocks, related_to) |
39
- | \`update_status\` | Mudar status de um node (backlog\u2192ready\u2192in_progress\u2192done) |
40
- | \`bulk_update_status\` | Atualizar status de m\u00FAltiplos nodes de uma vez |
41
-
42
- #### PRD & Planejamento
43
-
44
- | Tool | Quando usar |
45
- |------|-------------|
46
- | \`import_prd\` | Importar PRD \u2192 segmentar \u2192 classificar \u2192 extrair \u2192 inferir deps \u2192 criar grafo + indexar knowledge |
47
- | \`plan_sprint\` | Gerar relat\u00F3rio de planejamento de sprint (capacity, velocity, recomenda\u00E7\u00F5es) |
48
- | \`analyze\` | 24 modos de an\u00E1lise por fase do lifecycle (ver modos abaixo) |
49
- | \`set_phase\` | For\u00E7ar/resetar fase do lifecycle (strict/advisory, gate checks) + Code Intelligence mode (strict/advisory/off) + Tool Prerequisites mode (strict/advisory/off) |
50
-
51
- #### Contexto & RAG
52
-
53
- | Tool | Quando usar |
54
- |------|-------------|
55
- | \`next\` | Pr\u00F3xima task recomendada (prioridade + deps + knowledge coverage 0-1 + TDD hints + velocity) |
56
- | \`context\` | Contexto comprimido da task (token-efficient, ~73% redu\u00E7\u00E3o) |
57
- | \`rag_context\` | Contexto RAG phase-aware (tiers: summary/standard/deep, budget 60/30/10) |
58
- | \`reindex_knowledge\` | Rebuild completo do \u00EDndice de knowledge (BM25 + TF-IDF) |
59
- | \`sync_stack_docs\` | Sincronizar docs das libs do projeto via Context7 |
60
-
61
- #### Mem\u00F3rias do Projeto
62
-
63
- | Tool | Quando usar |
64
- |------|-------------|
65
- | \`write_memory\` | Escrever mem\u00F3ria em workflow-graph/memories/{name}.md (auto-indexa no RAG) |
66
- | \`read_memory\` | Ler conte\u00FAdo de uma mem\u00F3ria espec\u00EDfica |
67
- | \`list_memories\` | Listar todas as mem\u00F3rias dispon\u00EDveis |
68
- | \`delete_memory\` | Remover mem\u00F3ria do filesystem e do knowledge store |
69
-
70
- #### Valida\u00E7\u00E3o
71
-
72
- | Tool | Quando usar |
73
- |------|-------------|
74
- | \`validate\` | Validação: action \`task\` (browser A/B com Playwright) ou \`ac\` (critérios de aceitação) |
75
-
76
- #### Skills
77
-
78
- | Tool | Quando usar |
79
- |------|-------------|
80
- | \`manage_skill\` | Gerenciar skills: action \`list\` (listar/filtrar por fase), \`enable\`/\`disable\`, CRUD de custom skills |
81
-
82
- #### Tools Deprecated (backward compat, removidos na v7.0)
83
-
84
- | Tool antigo | Usar no lugar |
85
- |-------------|---------------|
86
- | \`add_node\` | \`node\` com action:\`add\` |
87
- | \`update_node\` | \`node\` com action:\`update\` |
88
- | \`delete_node\` | \`node\` com action:\`delete\` |
89
- | \`validate_task\` | \`validate\` com action:\`task\` |
90
- | \`validate_ac\` | \`validate\` com action:\`ac\` |
91
- | \`list_skills\` | \`manage_skill\` com action:\`list\` |`;
92
- const ANALYZE_MODES_SECTION = `### Modos do analyze por fase
93
-
94
- | Fase | Modo | O que verifica |
95
- |------|------|----------------|
96
- | ANALYZE | \`prd_quality\` | Qualidade do PRD (completude, user stories, AC) |
97
- | ANALYZE | \`scope\` | Escopo do grafo (tipos, distribui\u00E7\u00E3o, cobertura) |
98
- | ANALYZE | \`ready\` | Definition of Ready (bloqueios, depend\u00EAncias, AC) |
99
- | ANALYZE | \`risk\` | Riscos (complexidade, deps, tamanho, AC faltantes) |
100
- | ANALYZE | \`blockers\` | Bloqueios transitivos de um node |
101
- | ANALYZE | \`cycles\` | Ciclos de depend\u00EAncia no grafo |
102
- | ANALYZE | \`critical_path\` | Caminho cr\u00EDtico (sequ\u00EAncia mais longa de deps) |
103
- | PLAN | \`decompose\` | Tasks grandes que precisam ser decompostas |
104
- | DESIGN | \`adr\` | Valida\u00E7\u00E3o de ADRs (Architecture Decision Records) |
105
- | DESIGN | \`traceability\` | Matriz de rastreabilidade (req \u2192 task \u2192 test) |
106
- | DESIGN | \`coupling\` | Acoplamento entre m\u00F3dulos |
107
- | DESIGN | \`interfaces\` | Verifica\u00E7\u00E3o de interfaces e contratos |
108
- | DESIGN | \`tech_risk\` | Riscos t\u00E9cnicos (complexidade, stack, deps externas) |
109
- | DESIGN | \`design_ready\` | Gate DESIGN\u2192PLAN (pr\u00E9-requisitos atendidos?) |
110
- | IMPLEMENT | \`implement_done\` | Definition of Done (8 checks: 4 required + 4 recommended) |
111
- | IMPLEMENT | \`tdd_check\` | Ader\u00EAncia TDD (specs sugeridos por AC) |
112
- | IMPLEMENT | \`progress\` | Sprint burndown + velocity trend + blockers + ETA |
113
- | VALIDATE | \`validate_ready\` | Gate IMPLEMENT\u2192VALIDATE |
114
- | VALIDATE | \`done_integrity\` | Integridade dos nodes marcados done |
115
- | VALIDATE | \`status_flow\` | Fluxo de status v\u00E1lido (sem pulos) |
116
- | REVIEW | \`review_ready\` | Gate VALIDATE\u2192REVIEW |
117
- | HANDOFF | \`handoff_ready\` | Gate REVIEW\u2192HANDOFF |
118
- | HANDOFF | \`doc_completeness\` | Completude de documenta\u00E7\u00E3o |
119
- | LISTENING | \`listening_ready\` | Gate HANDOFF\u2192LISTENING |
120
- | LISTENING | \`backlog_health\` | Sa\u00FAde do backlog (distribui\u00E7\u00E3o, aging) |`;
121
- const KNOWLEDGE_PIPELINE_SECTION = `### Pipeline de Conhecimento (Knowledge Store + RAG)
122
-
123
- Fontes indexadas automaticamente:
124
- - **Project memories** \u2014 ao escrever com \`write_memory\` (auto-indexa)
125
- - **PRD imports** \u2014 ao importar com \`import_prd\`
126
- - **Browser captures** \u2014 ao validar com \`validate_task\`
127
- - **Stack docs** \u2014 ao sincronizar com \`sync_stack_docs\`
128
- - **Sprint reports** \u2014 ao gerar com \`plan_sprint\`
129
-
130
- Recupera\u00E7\u00E3o: \`rag_context\` monta contexto phase-aware com budget de tokens:
131
- - 60% contexto do grafo (nodes, deps, status)
132
- - 30% knowledge store (BM25 + TF-IDF)
133
- - 10% metadata de fase
134
-
135
- Manual: \`reindex_knowledge\` para rebuild completo do \u00EDndice.`;
136
- const SKILLS_SECTION = `### Skills Built-in (40 skills)
137
-
138
- 40 skills mapeadas \u00E0s fases do lifecycle. Use \`list_skills\` para descobrir por fase ou ver instru\u00E7\u00F5es completas.
139
-
140
- #### Skills por fase
141
-
142
- | Fase | Skills sugeridas |
143
- |------|-----------------|
144
- | ANALYZE | \`create-prd-chat-mode\`, \`business-analyst\`, \`product-manager\` |
145
- | DESIGN | \`breakdown-epic-arch\`, \`context-architect\`, \`backend-architect\` |
146
- | PLAN | \`breakdown-feature-prd\`, \`track-with-mcp-graph\` |
147
- | IMPLEMENT | \`subagent-driven-development\`, \`xp-bootstrap\`, \`self-healing-awareness\` |
148
- | VALIDATE | \`playwright-explore-website\`, \`playwright-generate-test\`, \`e2e-testing\` |
149
- | REVIEW | \`code-reviewer\`, \`code-review-checklist\`, \`review-and-refactor\`, \`observability-engineer\` |
150
-
151
- #### Categorias adicionais (multi-fase)
152
-
153
- | Categoria | Skills |
154
- |-----------|--------|
155
- | software-design | SOLID, KISS, YAGNI, DRY, clean-architecture, composition-over-inheritance |
156
- | security | \`owasp-web-security\`, \`auth-and-secrets\`, \`database-and-deps-security\` |
157
- | ddd | \`domain-driven-design\` (DESIGN, PLAN) |
158
- | testing | \`comprehensive-testing-reference\`, \`self-healing-awareness\` (IMPLEMENT, VALIDATE) |
159
- | cost-reducer | \`cloud-infra-cost\`, \`code-level-savings\`, \`finops-services\` (DESIGN, REVIEW) |
160
- | frontend-design | \`ui-ux-patterns\` (DESIGN, IMPLEMENT) |
161
-
162
- #### Custom Skills
163
-
164
- Crie skills espec\u00EDficas do projeto via \`manage_skill\` (create/enable/disable). Custom skills s\u00E3o armazenadas no grafo e aparecem junto com as built-in em \`list_skills\`.
165
-
166
- #### Self-Healing Awareness
167
-
168
- A skill \`self-healing-awareness\` monitora padr\u00F5es de erro recorrentes e sugere corre\u00E7\u00F5es automaticamente. Ativa nas fases IMPLEMENT e VALIDATE.`;
169
- const LIFECYCLE_SUMMARY = `### Lifecycle (8 fases)
20
+ const LIFECYCLE_SUMMARY = `### Lifecycle (9 fases)
170
21
 
171
22
  1. **ANALYZE** \u2014 Criar PRD, definir requisitos (\`import_prd\`, \`add_node\`)
172
23
  2. **DESIGN** \u2014 Arquitetura, decis\u00F5es t\u00E9cnicas (\`add_node\`, \`edge\`, \`analyze\`)
@@ -175,7 +26,8 @@ const LIFECYCLE_SUMMARY = `### Lifecycle (8 fases)
175
26
  5. **VALIDATE** \u2014 Testes E2E, crit\u00E9rios de aceita\u00E7\u00E3o (\`validate_task\`, \`metrics\`)
176
27
  6. **REVIEW** \u2014 Code review, blast radius (\`export\`, \`metrics\`)
177
28
  7. **HANDOFF** \u2014 PR, documenta\u00E7\u00E3o, entrega (\`export\`, \`snapshot\`)
178
- 8. **LISTENING** \u2014 Feedback, novo ciclo (\`add_node\`, \`import_prd\`)`;
29
+ 8. **DEPLOY** \u2014 CI pipeline, release, post-release validation (\`export\`, \`snapshot\`, \`analyze\`)
30
+ 9. **LISTENING** \u2014 Feedback, novo ciclo (\`add_node\`, \`import_prd\`)`;
179
31
  const XP_PRINCIPLES = `### Princ\u00EDpios XP Anti-Vibe-Coding
180
32
 
181
33
  - **TDD obrigat\u00F3rio** \u2014 Teste antes do c\u00F3digo. Sem teste = sem implementa\u00E7\u00E3o.
@@ -183,35 +35,40 @@ const XP_PRINCIPLES = `### Princ\u00EDpios XP Anti-Vibe-Coding
183
35
  - **Decomposi\u00E7\u00E3o at\u00F4mica** \u2014 Cada task deve ser complet\u00E1vel em \u22642h.
184
36
  - **Code detachment** \u2014 Se a IA errou, explique o erro via prompt. Nunca edite manualmente.
185
37
  - **CLAUDE.md como spec evolutiva** \u2014 Documente padr\u00F5es e decis\u00F5es aqui.`;
186
- const CLI_COMMANDS = `### Comandos essenciais
38
+ const LEAN_DISCOVERY_HINT = `> **Referências detalhadas on-demand:** Use \`help\` tool para consultar: \`tools\`, \`analyze_modes\`, \`skills\`, \`cli\`, \`knowledge\`, \`workflow\`.`;
39
+ function buildSectionBody(projectName, mode = "full") {
40
+ const header = `## mcp-graph — ${projectName}
41
+
42
+ Este projeto usa **mcp-graph** para gestão de execução via grafo persistente (SQLite).
43
+ Dados armazenados em \`workflow-graph/graph.db\` (local, gitignored).
44
+
45
+ ${MANDATORY_EXECUTION_RULE}`;
46
+ const workflow = `### Fluxo de trabalho OBRIGATÓRIO
187
47
 
188
- \`\`\`bash
189
- npx mcp-graph stats # Estat\u00EDsticas do grafo
190
- npx mcp-graph list # Listar nodes
191
- npx mcp-graph update # Atualizar configs para \u00FAltima vers\u00E3o
192
- npx mcp-graph doctor # Validar ambiente de execu\u00E7\u00E3o
193
- npx mcp-graph doctor --json # Diagn\u00F3stico em JSON estruturado
194
- npx mcp-graph serve --port 3000 # Dashboard visual
48
+ \`\`\`
49
+ next context rag_context → [implementar com TDD] → analyze(implement_done) → update_status → next
195
50
  \`\`\``;
196
- function buildSectionBody(projectName) {
197
- return `## mcp-graph \u2014 ${projectName}
51
+ if (mode === "lean") {
52
+ return `${header}
198
53
 
199
- Este projeto usa **mcp-graph** para gest\u00E3o de execu\u00E7\u00E3o via grafo persistente (SQLite).
200
- Dados armazenados em \`workflow-graph/graph.db\` (local, gitignored).
54
+ ${workflow}
201
55
 
202
- ${MANDATORY_EXECUTION_RULE}
56
+ ${LIFECYCLE_SUMMARY}
57
+
58
+ ${XP_PRINCIPLES}
203
59
 
204
- ### Ferramentas MCP dispon\u00EDveis (28 tools + 6 deprecated)
60
+ ${LEAN_DISCOVERY_HINT}`;
61
+ }
62
+ // Full mode — backward compatible output
63
+ return `${header}
205
64
 
206
65
  ${TOOL_TABLE_FULL}
207
66
 
208
- ${ANALYZE_MODES_SECTION}
67
+ ${DEPRECATED_TOOLS_SECTION}
209
68
 
210
- ### Fluxo de trabalho OBRIGAT\u00D3RIO
69
+ ${ANALYZE_MODES_SECTION}
211
70
 
212
- \`\`\`
213
- next \u2192 context \u2192 rag_context \u2192 [implementar com TDD] \u2192 analyze(implement_done) \u2192 update_status \u2192 next
214
- \`\`\`
71
+ ${workflow}
215
72
 
216
73
  ${LIFECYCLE_SUMMARY}
217
74
 
@@ -221,18 +78,18 @@ ${SKILLS_SECTION}
221
78
 
222
79
  ${XP_PRINCIPLES}
223
80
 
224
- ${CLI_COMMANDS}`;
81
+ ${CLI_COMMANDS_REF}`;
225
82
  }
226
- export function generateClaudeMdSection(projectName) {
83
+ export function generateClaudeMdSection(projectName, mode = "full") {
227
84
  return `
228
85
  ${MARKER_START}
229
- ${buildSectionBody(projectName)}
86
+ ${buildSectionBody(projectName, mode)}
230
87
  ${MARKER_END}
231
88
  `;
232
89
  }
233
- export function generateCopilotInstructions(projectName) {
90
+ export function generateCopilotInstructions(projectName, mode = "full") {
234
91
  return `${MARKER_START}
235
- ${buildSectionBody(projectName)}
92
+ ${buildSectionBody(projectName, mode)}
236
93
  ${MARKER_END}
237
94
  `;
238
95
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ai-memory-generator.js","sourceRoot":"","sources":["../../../src/core/config/ai-memory-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAEnD,MAAM,wBAAwB,GAAG;;;;;;;;;;;8CAWa,CAAC;AAE/C,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DAwEmC,CAAC;AAE5D,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;2FA4B6D,CAAC;AAE5F,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;oEAciC,CAAC;AAErE,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iKAgC0I,CAAC;AAElK,MAAM,iBAAiB,GAAG;;;;;;;;;4EASkD,CAAC;AAE7E,MAAM,aAAa,GAAG;;;;;;wFAMkE,CAAC;AAEzF,MAAM,YAAY,GAAG;;;;;;;;;OASd,CAAC;AAER,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,OAAO,uBAAuB,WAAW;;;;;EAKzC,wBAAwB;;;;EAIxB,eAAe;;EAEf,qBAAqB;;;;;;;;EAQrB,iBAAiB;;EAEjB,0BAA0B;;EAE1B,cAAc;;EAEd,aAAa;;EAEb,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO;EACP,YAAY;EACZ,gBAAgB,CAAC,WAAW,CAAC;EAC7B,UAAU;CACX,CAAC;AACF,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,OAAO,GAAG,YAAY;EACtB,gBAAgB,CAAC,WAAW,CAAC;EAC7B,UAAU;CACX,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,eAAuB,EAAE,UAAkB;IACtE,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;IAEhD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;QAChF,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,UAAU,GAAG,cAAc,GAAG,SAAS,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,MAAM,GAAG,cAAc,CAAC;AACjC,CAAC"}
1
+ {"version":3,"file":"ai-memory-generator.js","sourceRoot":"","sources":["../../../src/core/config/ai-memory-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,YAAY,IAAI,gBAAgB,GACjC,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAEnD,MAAM,wBAAwB,GAAG;;;;;;;;;;;8CAWa,CAAC;AAE/C,MAAM,iBAAiB,GAAG;;;;;;;;;;4EAUkD,CAAC;AAE7E,MAAM,aAAa,GAAG;;;;;;wFAMkE,CAAC;AAGzF,MAAM,mBAAmB,GAAG,2JAA2J,CAAC;AAExL,SAAS,gBAAgB,CAAC,WAAmB,EAAE,OAAwB,MAAM;IAC3E,MAAM,MAAM,GAAG,kBAAkB,WAAW;;;;;EAK5C,wBAAwB,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG;;;;OAIZ,CAAC;IAEN,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,GAAG,MAAM;;EAElB,QAAQ;;EAER,iBAAiB;;EAEjB,aAAa;;EAEb,mBAAmB,EAAE,CAAC;IACtB,CAAC;IAED,yCAAyC;IACzC,OAAO,GAAG,MAAM;;EAEhB,eAAe;;EAEf,wBAAwB;;EAExB,qBAAqB;;EAErB,QAAQ;;EAER,iBAAiB;;EAEjB,0BAA0B;;EAE1B,cAAc;;EAEd,aAAa;;EAEb,gBAAgB,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB,EAAE,OAAwB,MAAM;IACzF,OAAO;EACP,YAAY;EACZ,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC;EACnC,UAAU;CACX,CAAC;AACF,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,WAAmB,EAAE,OAAwB,MAAM;IAC7F,OAAO,GAAG,YAAY;EACtB,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC;EACnC,UAAU;CACX,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,eAAuB,EAAE,UAAkB;IACtE,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;IAEhD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;QAChF,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,UAAU,GAAG,cAAc,GAAG,SAAS,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,MAAM,GAAG,cAAc,CAAC;AACjC,CAAC"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Templates for .claudeignore and .copilotignore files.
3
+ * Both files share the same content — lean context philosophy:
4
+ * zero auto-load, everything via MCP on-demand.
5
+ *
6
+ * Generated by: npx mcp-graph init
7
+ */
8
+ /**
9
+ * Get the shared ignore template content.
10
+ */
11
+ export declare function getIgnoreTemplate(): string;
12
+ /**
13
+ * Ensure .claudeignore exists. Does NOT overwrite existing files.
14
+ */
15
+ export declare function ensureClaudeIgnore(projectDir: string): boolean;
16
+ /**
17
+ * Ensure .copilotignore exists. Does NOT overwrite existing files.
18
+ */
19
+ export declare function ensureCopilotIgnore(projectDir: string): boolean;
20
+ //# sourceMappingURL=ignore-templates.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ignore-templates.d.ts","sourceRoot":"","sources":["../../../src/core/config/ignore-templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4IH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAS9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAS/D"}
@@ -0,0 +1,176 @@
1
+ /**
2
+ * Templates for .claudeignore and .copilotignore files.
3
+ * Both files share the same content — lean context philosophy:
4
+ * zero auto-load, everything via MCP on-demand.
5
+ *
6
+ * Generated by: npx mcp-graph init
7
+ */
8
+ import { existsSync, writeFileSync } from "node:fs";
9
+ import path from "node:path";
10
+ import { logger } from "../utils/logger.js";
11
+ const IGNORE_TEMPLATE = `# ========================================
12
+ # LEAN CONTEXT (mcp-graph)
13
+ # Filosofia: zero auto-load, tudo on-demand via MCP
14
+ # Gerado por: npx mcp-graph init
15
+ # ========================================
16
+
17
+ # === DEPENDENCIAS ===
18
+ node_modules/
19
+
20
+ # === GIT / GITHUB ===
21
+ .git/
22
+ .gitattributes
23
+ .github/
24
+
25
+ # === BUILDS / COMPILADOS ===
26
+ dist/
27
+ build/
28
+ out/
29
+ .next/
30
+ .turbo/
31
+ .cache/
32
+ *.tsbuildinfo
33
+ *.js.map
34
+ *.d.ts.map
35
+
36
+ # === TESTES (usar mcp-graph context para navegar) ===
37
+ src/tests/
38
+ __tests__/
39
+ *.test.ts
40
+ *.test.tsx
41
+ *.spec.ts
42
+ *.spec.tsx
43
+ coverage/
44
+ test-results/
45
+ playwright-report/
46
+
47
+ # === LOGS ===
48
+ logs/
49
+ *.log
50
+
51
+ # === DOCS (mcp-graph serve como fonte de docs) ===
52
+ docs/
53
+ *.md
54
+ !CLAUDE.md
55
+
56
+ # === SCRIPTS / TEMPLATES / DATA ===
57
+ scripts/
58
+ templates/
59
+ data/
60
+
61
+ # === ARQUIVOS GERADOS ===
62
+ **/prisma/migrations/
63
+ **/prisma/generated/
64
+ **/types/generated/
65
+ **/*.generated.ts
66
+
67
+ # === AMBIENTE / SECRETS ===
68
+ .env*
69
+ *.env
70
+ !.env.example
71
+
72
+ # === TEMP / BACKUPS ===
73
+ **/uploads/
74
+ **/temp/
75
+ **/tmp/
76
+ *.backup
77
+ *.bak
78
+
79
+ # === IDE ===
80
+ .vscode/
81
+ .idea/
82
+ *.swp
83
+ *.swo
84
+ *~
85
+ .DS_Store
86
+
87
+ # === DADOS MCP / SQLITE ===
88
+ workflow-graph/
89
+ *.db
90
+ *.db-shm
91
+ *.db-wal
92
+
93
+ # === MIDIA / BINARIOS ===
94
+ *.mp4
95
+ *.pdf
96
+ *.zip
97
+ *.tar
98
+ *.gz
99
+ *.png
100
+ *.jpg
101
+ *.jpeg
102
+ *.gif
103
+ *.svg
104
+ *.ico
105
+ *.woff*
106
+ *.ttf
107
+
108
+ # === LOCKS ===
109
+ package-lock.json
110
+ yarn.lock
111
+ pnpm-lock.yaml
112
+
113
+ # === CACHE ===
114
+ .eslintcache
115
+ .husky/
116
+
117
+ # === CONFIGS (ler sob demanda) ===
118
+ **/tailwind.config.*
119
+ **/postcss.config.*
120
+ **/tsconfig*.json
121
+ **/eslint*
122
+ **/.prettier*
123
+ **/vitest.config.*
124
+ **/playwright.config.*
125
+ docker-compose*.yml
126
+ Dockerfile*
127
+
128
+ # === CLAUDE (exceto rules/) ===
129
+ .claude/skills/
130
+ .claude/plans/
131
+ .claude/docs/
132
+ .claude/data/
133
+ .claude/*.md
134
+ .claude/*.json
135
+ .claude/*.json.backup
136
+
137
+ # === ROOT NAO-ESSENCIAIS ===
138
+ CHANGELOG.md
139
+ CODE_OF_CONDUCT.md
140
+ CONTRIBUTING.md
141
+ LICENSE
142
+ release-please-config.json
143
+ `;
144
+ /**
145
+ * Get the shared ignore template content.
146
+ */
147
+ export function getIgnoreTemplate() {
148
+ return IGNORE_TEMPLATE;
149
+ }
150
+ /**
151
+ * Ensure .claudeignore exists. Does NOT overwrite existing files.
152
+ */
153
+ export function ensureClaudeIgnore(projectDir) {
154
+ const filePath = path.join(projectDir, ".claudeignore");
155
+ if (existsSync(filePath)) {
156
+ logger.debug(".claudeignore already exists, skipping");
157
+ return false;
158
+ }
159
+ writeFileSync(filePath, IGNORE_TEMPLATE, "utf-8");
160
+ logger.info(".claudeignore created with lean context template");
161
+ return true;
162
+ }
163
+ /**
164
+ * Ensure .copilotignore exists. Does NOT overwrite existing files.
165
+ */
166
+ export function ensureCopilotIgnore(projectDir) {
167
+ const filePath = path.join(projectDir, ".copilotignore");
168
+ if (existsSync(filePath)) {
169
+ logger.debug(".copilotignore already exists, skipping");
170
+ return false;
171
+ }
172
+ writeFileSync(filePath, IGNORE_TEMPLATE, "utf-8");
173
+ logger.info(".copilotignore created with lean context template");
174
+ return true;
175
+ }
176
+ //# sourceMappingURL=ignore-templates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ignore-templates.js","sourceRoot":"","sources":["../../../src/core/config/ignore-templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoIvB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Reference content extracted from ai-memory-generator.ts.
3
+ * Shared between the generator (full mode) and the help MCP tool (on-demand).
4
+ */
5
+ export declare const TOOL_TABLE_FULL = "### Ferramentas MCP dispon\u00EDveis (46 tools + 6 deprecated)\n\n#### Projeto & Grafo\n\n| Tool | Quando usar |\n|------|-------------|\n| `init` | Inicializar grafo do projeto (cria DB, AI memory files, detecta MCPs) |\n| `list` | Listar nodes do grafo (filtrar por tipo/status/parent) |\n| `show` | Ver detalhes de um node espec\u00EDfico (metadata, deps, knowledge) |\n| `search` | Busca full-text no grafo (FTS5 + BM25 ranking) |\n| `export` | Exportar grafo (JSON completo ou Mermaid diagram) |\n| `snapshot` | Criar/restaurar snapshots do grafo (backup/rollback) |\n| `metrics` | Estat\u00EDsticas do grafo (`stats`) ou velocidade por sprint (`velocity`) |\n\n#### Nodes & Edges\n\n| Tool | Quando usar |\n|------|-------------|\n| `node` | CRUD de nodes: action `add` (criar), `update` (atualizar), `delete` (remover) |\n| `move_node` | Mover node para outro parent |\n| `clone_node` | Clonar node com filhos (deep copy) |\n| `edge` | Criar/remover rela\u00E7\u00F5es entre nodes (depends_on, blocks, related_to) |\n| `update_status` | Mudar status de um node (backlog\u2192ready\u2192in_progress\u2192done) |\n| `bulk_update_status` | Atualizar status de m\u00FAltiplos nodes de uma vez |\n\n#### PRD & Planejamento\n\n| Tool | Quando usar |\n|------|-------------|\n| `import_prd` | Importar PRD \u2192 segmentar \u2192 classificar \u2192 extrair \u2192 inferir deps \u2192 criar grafo + indexar knowledge |\n| `plan_sprint` | Gerar relat\u00F3rio de planejamento de sprint (capacity, velocity, recomenda\u00E7\u00F5es) |\n| `analyze` | 24 modos de an\u00E1lise por fase do lifecycle (ver modos abaixo) |\n| `set_phase` | For\u00E7ar/resetar fase do lifecycle (strict/advisory, gate checks) + Code Intelligence mode (strict/advisory/off) + Tool Prerequisites mode (strict/advisory/off) |\n\n#### Contexto & RAG\n\n| Tool | Quando usar |\n|------|-------------|\n| `next` | Pr\u00F3xima task recomendada (prioridade + deps + knowledge coverage 0-1 + TDD hints + velocity) |\n| `context` | Contexto comprimido da task (token-efficient, ~73% redu\u00E7\u00E3o) |\n| `rag_context` | Contexto RAG phase-aware (tiers: summary/standard/deep, budget 60/30/10) |\n| `reindex_knowledge` | Rebuild completo do \u00EDndice de knowledge (BM25 + TF-IDF) |\n| `sync_stack_docs` | Sincronizar docs das libs do projeto via Context7 |\n\n#### Mem\u00F3rias do Projeto\n\n| Tool | Quando usar |\n|------|-------------|\n| `write_memory` | Escrever mem\u00F3ria em workflow-graph/memories/{name}.md (auto-indexa no RAG) |\n| `read_memory` | Ler conte\u00FAdo de uma mem\u00F3ria espec\u00EDfica |\n| `list_memories` | Listar todas as mem\u00F3rias dispon\u00EDveis |\n| `delete_memory` | Remover mem\u00F3ria do filesystem e do knowledge store |\n\n#### Valida\u00E7\u00E3o\n\n| Tool | Quando usar |\n|------|-------------|\n| `validate` | Valida\u00E7\u00E3o: action `task` (browser A/B com Playwright) ou `ac` (crit\u00E9rios de aceita\u00E7\u00E3o) |\n\n#### Skills\n\n| Tool | Quando usar |\n|------|-------------|\n| `manage_skill` | Gerenciar skills: action `list` (listar/filtrar por fase), `enable`/`disable`, CRUD de custom skills |\n\n#### Utilit\u00E1rios\n\n| Tool | Quando usar |\n|------|-------------|\n| `help` | Refer\u00EAncia on-demand de tools, analyze modes, skills, CLI, workflow (este tool) |\n| `journey` | Gerenciar journey maps de websites (list, get, search, index para RAG) |\n| `import_graph` | Importar/merge grafo JSON exportado (local wins, dry_run dispon\u00EDvel) |\n\n#### Code Intelligence (LSP)\n\n| Tool | Quando usar |\n|------|-------------|\n| `code_intelligence` | An\u00E1lise sem\u00E2ntica via LSP: definition, references, hover, rename, call_hierarchy, diagnostics, symbols. Multi-language (TS, Python, Rust, Go, Java, C/C++, Ruby, PHP, Kotlin, Swift, C#, Lua) |\n\n#### Knowledge Avan\u00E7ado\n\n| Tool | Quando usar |\n|------|-------------|\n| `knowledge_feedback` | Feedback em docs do knowledge store (helpful/unhelpful/outdated) para melhorar RAG |\n| `knowledge_stats` | Estat\u00EDsticas do knowledge store: contagem por source, qualidade, docs mais acessados |\n| `export_knowledge` | Export/import/preview de knowledge packages para colabora\u00E7\u00E3o entre projetos |\n\n#### Siebel CRM (8 tools)\n\n| Tool | Quando usar |\n|------|-------------|\n| `siebel_import_sif` | Importar .SIF (XML Siebel) \u2014 parse, extrai objetos, mapeia no grafo, indexa no knowledge |\n| `siebel_analyze` | Analisar objetos Siebel: impact, dependencies, circular, diff, refactor_script, troubleshoot |\n| `siebel_composer` | Automa\u00E7\u00E3o do Siebel Composer via Playwright: navigate, import_sif, edit, publish, capture |\n| `siebel_env` | Gerenciar ambientes Siebel CRM: list, add, remove |\n| `siebel_validate` | Validar .SIF: full, naming, security, performance, migration_ready, code_review |\n| `siebel_search` | Buscar objetos Siebel indexados no knowledge store (BCs, Applets, Views, Workflows) |\n| `siebel_generate_sif` | Gerar SIF: prepare, finalize, templates, scaffold, clone_adapt, auto_wire, wsdl_to_sif |\n| `siebel_import_docs` | Importar docs (Swagger/WSDL/PDF/HTML/DOCX/MD) no knowledge store para contexto Siebel |\n\n#### Translation (3 tools)\n\n| Tool | Quando usar |\n|------|-------------|\n| `translate_code` | Traduzir c\u00F3digo entre linguagens \u2014 cria job, analisa constructs, gera prompt, finaliza com c\u00F3digo |\n| `analyze_translation` | Analisar c\u00F3digo-fonte para prontid\u00E3o de tradu\u00E7\u00E3o (language, constructs, complexity, translatability) |\n| `translation_jobs` | Gerenciar jobs de tradu\u00E7\u00E3o: list, get, delete, stats |";
6
+ export declare const DEPRECATED_TOOLS_SECTION = "#### Tools Deprecated (backward compat, removidos na v7.0)\n\n| Tool antigo | Usar no lugar |\n|-------------|---------------|\n| `add_node` | `node` com action:`add` |\n| `update_node` | `node` com action:`update` |\n| `delete_node` | `node` com action:`delete` |\n| `validate_task` | `validate` com action:`task` |\n| `validate_ac` | `validate` com action:`ac` |\n| `list_skills` | `manage_skill` com action:`list` |";
7
+ export declare const ANALYZE_MODES_SECTION = "### Modos do analyze por fase\n\n| Fase | Modo | O que verifica |\n|------|------|----------------|\n| ANALYZE | `prd_quality` | Qualidade do PRD (completude, user stories, AC) |\n| ANALYZE | `scope` | Escopo do grafo (tipos, distribui\u00E7\u00E3o, cobertura) |\n| ANALYZE | `ready` | Definition of Ready (bloqueios, depend\u00EAncias, AC) |\n| ANALYZE | `risk` | Riscos (complexidade, deps, tamanho, AC faltantes) |\n| ANALYZE | `blockers` | Bloqueios transitivos de um node |\n| ANALYZE | `cycles` | Ciclos de depend\u00EAncia no grafo |\n| ANALYZE | `critical_path` | Caminho cr\u00EDtico (sequ\u00EAncia mais longa de deps) |\n| PLAN | `decompose` | Tasks grandes que precisam ser decompostas |\n| DESIGN | `adr` | Valida\u00E7\u00E3o de ADRs (Architecture Decision Records) |\n| DESIGN | `traceability` | Matriz de rastreabilidade (req \u2192 task \u2192 test) |\n| DESIGN | `coupling` | Acoplamento entre m\u00F3dulos |\n| DESIGN | `interfaces` | Verifica\u00E7\u00E3o de interfaces e contratos |\n| DESIGN | `tech_risk` | Riscos t\u00E9cnicos (complexidade, stack, deps externas) |\n| DESIGN | `design_ready` | Gate DESIGN\u2192PLAN (pr\u00E9-requisitos atendidos?) |\n| IMPLEMENT | `implement_done` | Definition of Done (8 checks: 4 required + 4 recommended) |\n| IMPLEMENT | `tdd_check` | Ader\u00EAncia TDD (specs sugeridos por AC) |\n| IMPLEMENT | `progress` | Sprint burndown + velocity trend + blockers + ETA |\n| VALIDATE | `validate_ready` | Gate IMPLEMENT\u2192VALIDATE |\n| VALIDATE | `done_integrity` | Integridade dos nodes marcados done |\n| VALIDATE | `status_flow` | Fluxo de status v\u00E1lido (sem pulos) |\n| REVIEW | `review_ready` | Gate VALIDATE\u2192REVIEW |\n| HANDOFF | `handoff_ready` | Gate REVIEW\u2192HANDOFF |\n| HANDOFF | `doc_completeness` | Completude de documenta\u00E7\u00E3o |\n| DEPLOY | `deploy_ready` | Gate HANDOFF\u2192DEPLOY (snapshot, tasks done, no blocked) |\n| DEPLOY | `release_check` | Valida\u00E7\u00E3o de release readiness |\n| LISTENING | `listening_ready` | Gate DEPLOY\u2192LISTENING |\n| LISTENING | `backlog_health` | Sa\u00FAde do backlog (distribui\u00E7\u00E3o, aging) |";
8
+ export declare const KNOWLEDGE_PIPELINE_SECTION = "### Pipeline de Conhecimento (Knowledge Store + RAG)\n\nFontes indexadas automaticamente:\n- **Project memories** \u2014 ao escrever com `write_memory` (auto-indexa)\n- **PRD imports** \u2014 ao importar com `import_prd`\n- **Browser captures** \u2014 ao validar com `validate_task`\n- **Stack docs** \u2014 ao sincronizar com `sync_stack_docs`\n- **Sprint reports** \u2014 ao gerar com `plan_sprint`\n\nRecupera\u00E7\u00E3o: `rag_context` monta contexto phase-aware com budget de tokens:\n- 60% contexto do grafo (nodes, deps, status)\n- 30% knowledge store (BM25 + TF-IDF)\n- 10% metadata de fase\n\nManual: `reindex_knowledge` para rebuild completo do \u00EDndice.";
9
+ export declare const SKILLS_SECTION = "### Skills Built-in (40 skills)\n\n40 skills mapeadas \u00E0s fases do lifecycle. Use `list_skills` para descobrir por fase ou ver instru\u00E7\u00F5es completas.\n\n#### Skills por fase\n\n| Fase | Skills sugeridas |\n|------|-----------------|\n| ANALYZE | `create-prd-chat-mode`, `business-analyst`, `product-manager` |\n| DESIGN | `breakdown-epic-arch`, `context-architect`, `backend-architect` |\n| PLAN | `breakdown-feature-prd`, `track-with-mcp-graph` |\n| IMPLEMENT | `subagent-driven-development`, `xp-bootstrap`, `self-healing-awareness` |\n| VALIDATE | `playwright-explore-website`, `playwright-generate-test`, `e2e-testing` |\n| REVIEW | `code-reviewer`, `code-review-checklist`, `review-and-refactor`, `observability-engineer` |\n\n#### Categorias adicionais (multi-fase)\n\n| Categoria | Skills |\n|-----------|--------|\n| software-design | SOLID, KISS, YAGNI, DRY, clean-architecture, composition-over-inheritance |\n| security | `owasp-web-security`, `auth-and-secrets`, `database-and-deps-security` |\n| ddd | `domain-driven-design` (DESIGN, PLAN) |\n| testing | `comprehensive-testing-reference`, `self-healing-awareness` (IMPLEMENT, VALIDATE) |\n| cost-reducer | `cloud-infra-cost`, `code-level-savings`, `finops-services` (DESIGN, REVIEW) |\n| frontend-design | `ui-ux-patterns` (DESIGN, IMPLEMENT) |\n\n#### Custom Skills\n\nCrie skills espec\u00EDficas do projeto via `manage_skill` (create/enable/disable). Custom skills s\u00E3o armazenadas no grafo e aparecem junto com as built-in em `list_skills`.\n\n#### Self-Healing Awareness\n\nA skill `self-healing-awareness` monitora padr\u00F5es de erro recorrentes e sugere corre\u00E7\u00F5es automaticamente. Ativa nas fases IMPLEMENT e VALIDATE.";
10
+ export declare const CLI_COMMANDS = "### Comandos essenciais\n\n```bash\nnpx mcp-graph stats # Estat\u00EDsticas do grafo\nnpx mcp-graph list # Listar nodes\nnpx mcp-graph update # Atualizar configs para \u00FAltima vers\u00E3o\nnpx mcp-graph doctor # Validar ambiente de execu\u00E7\u00E3o\nnpx mcp-graph doctor --json # Diagn\u00F3stico em JSON estruturado\nnpx mcp-graph serve --port 3000 # Dashboard visual\n```";
11
+ /**
12
+ * Get tool reference, optionally filtered by lifecycle phase.
13
+ */
14
+ export declare function getToolReference(phase?: string): string;
15
+ /**
16
+ * Get analyze modes, optionally filtered by lifecycle phase.
17
+ */
18
+ export declare function getAnalyzeModes(phase?: string): string;
19
+ /**
20
+ * Get skills by lifecycle phase.
21
+ */
22
+ export declare function getSkillsByPhase(phase?: string): string;
23
+ /**
24
+ * Get CLI commands reference.
25
+ */
26
+ export declare function getCliCommands(): string;
27
+ /**
28
+ * Get knowledge pipeline documentation.
29
+ */
30
+ export declare function getKnowledgePipeline(): string;
31
+ /**
32
+ * Get all reference content combined.
33
+ */
34
+ export declare function getFullReference(): string;
35
+ //# sourceMappingURL=reference-content.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reference-content.d.ts","sourceRoot":"","sources":["../../../src/core/config/reference-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,eAAe,igLA0GoD,CAAC;AAEjF,eAAO,MAAM,wBAAwB,uaASsB,CAAC;AAE5D,eAAO,MAAM,qBAAqB,8lEA8B0C,CAAC;AAE7E,eAAO,MAAM,0BAA0B,iqBAcwB,CAAC;AAEhE,eAAO,MAAM,cAAc,2rDAgCuH,CAAC;AAEnJ,eAAO,MAAM,YAAY,8aASlB,CAAC;AAsKR;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CASvD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CASzC"}