@mcp-graph-workflow/mcp-graph 5.27.0 → 5.28.1
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.
- package/README.md +10 -9
- package/dist/api/router.d.ts.map +1 -1
- package/dist/api/router.js +2 -0
- package/dist/api/router.js.map +1 -1
- package/dist/api/routes/docs-reference.d.ts +7 -0
- package/dist/api/routes/docs-reference.d.ts.map +1 -0
- package/dist/api/routes/docs-reference.js +136 -0
- package/dist/api/routes/docs-reference.js.map +1 -0
- package/dist/api/routes/knowledge.d.ts.map +1 -1
- package/dist/api/routes/knowledge.js +90 -8
- package/dist/api/routes/knowledge.js.map +1 -1
- package/dist/cli/commands/update.js +1 -1
- package/dist/cli/commands/update.js.map +1 -1
- package/dist/core/config/ai-memory-generator.d.ts +2 -2
- package/dist/core/config/ai-memory-generator.d.ts.map +1 -1
- package/dist/core/config/ai-memory-generator.js +33 -176
- package/dist/core/config/ai-memory-generator.js.map +1 -1
- package/dist/core/config/ignore-templates.d.ts +20 -0
- package/dist/core/config/ignore-templates.d.ts.map +1 -0
- package/dist/core/config/ignore-templates.js +176 -0
- package/dist/core/config/ignore-templates.js.map +1 -0
- package/dist/core/config/reference-content.d.ts +35 -0
- package/dist/core/config/reference-content.d.ts.map +1 -0
- package/dist/core/config/reference-content.js +449 -0
- package/dist/core/config/reference-content.js.map +1 -0
- package/dist/core/deployer/deploy-readiness.d.ts +12 -0
- package/dist/core/deployer/deploy-readiness.d.ts.map +1 -0
- package/dist/core/deployer/deploy-readiness.js +102 -0
- package/dist/core/deployer/deploy-readiness.js.map +1 -0
- package/dist/core/docs/doc-generator.d.ts +23 -0
- package/dist/core/docs/doc-generator.d.ts.map +1 -0
- package/dist/core/docs/doc-generator.js +86 -0
- package/dist/core/docs/doc-generator.js.map +1 -0
- package/dist/core/docs/doc-updater.d.ts +10 -0
- package/dist/core/docs/doc-updater.d.ts.map +1 -0
- package/dist/core/docs/doc-updater.js +27 -0
- package/dist/core/docs/doc-updater.js.map +1 -0
- package/dist/core/docs/route-introspector.d.ts +19 -0
- package/dist/core/docs/route-introspector.d.ts.map +1 -0
- package/dist/core/docs/route-introspector.js +60 -0
- package/dist/core/docs/route-introspector.js.map +1 -0
- package/dist/core/docs/tool-introspector.d.ts +17 -0
- package/dist/core/docs/tool-introspector.d.ts.map +1 -0
- package/dist/core/docs/tool-introspector.js +82 -0
- package/dist/core/docs/tool-introspector.js.map +1 -0
- package/dist/core/planner/lifecycle-phase.d.ts +1 -1
- package/dist/core/planner/lifecycle-phase.d.ts.map +1 -1
- package/dist/core/planner/lifecycle-phase.js +52 -0
- package/dist/core/planner/lifecycle-phase.js.map +1 -1
- package/dist/core/rag/phase-metadata.d.ts.map +1 -1
- package/dist/core/rag/phase-metadata.js +5 -0
- package/dist/core/rag/phase-metadata.js.map +1 -1
- package/dist/core/store/knowledge-store.d.ts +7 -0
- package/dist/core/store/knowledge-store.d.ts.map +1 -1
- package/dist/core/store/knowledge-store.js +15 -0
- package/dist/core/store/knowledge-store.js.map +1 -1
- package/dist/mcp/init-project.d.ts.map +1 -1
- package/dist/mcp/init-project.js +68 -8
- package/dist/mcp/init-project.js.map +1 -1
- package/dist/mcp/tools/analyze.d.ts.map +1 -1
- package/dist/mcp/tools/analyze.js +40 -1
- package/dist/mcp/tools/analyze.js.map +1 -1
- package/dist/mcp/tools/help.d.ts +3 -0
- package/dist/mcp/tools/help.d.ts.map +1 -0
- package/dist/mcp/tools/help.js +74 -0
- package/dist/mcp/tools/help.js.map +1 -0
- package/dist/mcp/tools/index.d.ts.map +1 -1
- package/dist/mcp/tools/index.js +2 -0
- package/dist/mcp/tools/index.js.map +1 -1
- package/dist/mcp/tools/list-skills.js +1 -1
- package/dist/mcp/tools/list-skills.js.map +1 -1
- package/dist/mcp/tools/manage-skill.js +1 -1
- package/dist/mcp/tools/manage-skill.js.map +1 -1
- package/dist/mcp/tools/set-phase.js +1 -1
- package/dist/mcp/tools/set-phase.js.map +1 -1
- package/dist/schemas/deployer-schema.d.ts +34 -0
- package/dist/schemas/deployer-schema.d.ts.map +1 -0
- package/dist/schemas/deployer-schema.js +17 -0
- package/dist/schemas/deployer-schema.js.map +1 -0
- package/dist/schemas/skill.schema.d.ts +3 -0
- package/dist/schemas/skill.schema.d.ts.map +1 -1
- package/dist/schemas/skill.schema.js +1 -1
- package/dist/schemas/skill.schema.js.map +1 -1
- package/dist/web/dashboard/dist/assets/{benchmark-tab-ChRIBQcA.js → benchmark-tab-Dx9G7cqf.js} +1 -1
- package/dist/web/dashboard/dist/assets/{circle-alert-CDZ2Oz9A.js → circle-alert-B17sfIdw.js} +1 -1
- package/dist/web/dashboard/dist/assets/constants-Dd6A34aQ.js +1 -0
- package/dist/web/dashboard/dist/assets/{context-tab-ClyJEQyQ.js → context-tab-BX2hlI9H.js} +1 -1
- package/dist/web/dashboard/dist/assets/docs-tab-sxC7Gxc7.js +1 -0
- package/dist/web/dashboard/dist/assets/{gitnexus-tab-uG_IXJAC.js → gitnexus-tab-DEcNhLvY.js} +1 -1
- package/dist/web/dashboard/dist/assets/{graph-section-BfAmG5lE.js → graph-section-CsHifp70.js} +1 -1
- package/dist/web/dashboard/dist/assets/{graph-tab-CG9ZAKno.js → graph-tab-D8ZSUyGR.js} +1 -1
- package/dist/web/dashboard/dist/assets/{graph-utils-_5ZIVYpg.js → graph-utils-D10A5HwE.js} +1 -1
- package/dist/web/dashboard/dist/assets/{index-jFrjjy9L.js → index-07Y4UWP1.js} +1 -1
- package/dist/web/dashboard/dist/assets/{index-CaC7cmzW.js → index-CVRN6scU.js} +1 -1
- package/dist/web/dashboard/dist/assets/index-DVIgWBT4.css +1 -0
- package/dist/web/dashboard/dist/assets/{index-BaFYAVmk.js → index-Dbaws8C6.js} +46 -41
- package/dist/web/dashboard/dist/assets/{insights-tab-EnTEAW50.js → insights-tab-DJAtypOr.js} +1 -1
- package/dist/web/dashboard/dist/assets/{journey-tab-Ba2R4l8c.js → journey-tab-CXtDFeGm.js} +1 -1
- package/dist/web/dashboard/dist/assets/{languages-tab-BOZaQLA6.js → languages-tab-03j3C58E.js} +25 -30
- package/dist/web/dashboard/dist/assets/{loader-circle-DIYk9wxS.js → loader-circle-BNEIXs1s.js} +1 -1
- package/dist/web/dashboard/dist/assets/{logs-tab-ZWCruIzU.js → logs-tab-D3BE923P.js} +1 -1
- package/dist/web/dashboard/dist/assets/{lsp-tab-B_xnLDB4.js → lsp-tab-cac4ysh4.js} +1 -1
- package/dist/web/dashboard/dist/assets/memories-tab-BPJTM45d.js +1 -0
- package/dist/web/dashboard/dist/assets/{prd-backlog-tab-BByZFrjw.js → prd-backlog-tab-5PCpKm0j.js} +1 -1
- package/dist/web/dashboard/dist/assets/{refresh-cw-Ds0I1g9D.js → refresh-cw-CI2U4FGa.js} +1 -1
- package/dist/web/dashboard/dist/assets/{siebel-tab-BndR6AA4.js → siebel-tab-BuhOpZO3.js} +3 -3
- package/dist/web/dashboard/dist/assets/{skills-tab-DT6taugG.js → skills-tab-BHWwOBtm.js} +1 -1
- package/dist/web/dashboard/dist/assets/{style-C5z-qKN9.js → style-BPgBTbDw.js} +1 -1
- package/dist/web/dashboard/dist/assets/{triangle-alert-DA1VDEuy.js → triangle-alert-aqoYdsgW.js} +1 -1
- package/dist/web/dashboard/dist/index.html +2 -2
- package/package.json +15 -2
- package/dist/web/dashboard/dist/assets/constants-lq4BIQN3.js +0 -1
- package/dist/web/dashboard/dist/assets/index-C4f-Fp0Q.css +0 -1
- 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
|
|
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. **
|
|
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
|
|
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
|
-
\`\`\`
|
|
189
|
-
|
|
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
|
-
|
|
197
|
-
|
|
51
|
+
if (mode === "lean") {
|
|
52
|
+
return `${header}
|
|
198
53
|
|
|
199
|
-
|
|
200
|
-
Dados armazenados em \`workflow-graph/graph.db\` (local, gitignored).
|
|
54
|
+
${workflow}
|
|
201
55
|
|
|
202
|
-
${
|
|
56
|
+
${LIFECYCLE_SUMMARY}
|
|
57
|
+
|
|
58
|
+
${XP_PRINCIPLES}
|
|
203
59
|
|
|
204
|
-
|
|
60
|
+
${LEAN_DISCOVERY_HINT}`;
|
|
61
|
+
}
|
|
62
|
+
// Full mode — backward compatible output
|
|
63
|
+
return `${header}
|
|
205
64
|
|
|
206
65
|
${TOOL_TABLE_FULL}
|
|
207
66
|
|
|
208
|
-
${
|
|
67
|
+
${DEPRECATED_TOOLS_SECTION}
|
|
209
68
|
|
|
210
|
-
|
|
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
|
-
${
|
|
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,
|
|
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"}
|