docs: doc 12 blueprint Widget Builder (spec->widget Elementor PHP)

Fundamentado na API publica real do Elementor (Widget_Base, Controls_Manager,
Widgets_Manager, Elements_Manager, widget core Heading como exemplo) mais os
padroes de seguranca ja confirmados em codigo real Free (EMCP_Tools_Widget_Store/
Widget_Loader do doc06 - manifest-only, tamper guard sha256, path containment,
runtime_validate). O compilador spec->PHP em si (EMCP_Tools_Widget_Generator) e
a camada de abilities MCP continuam ausentes do build Free - marcado [REAL] vs
[DESENHO PROPRIO] em cada afirmacao do documento.

Recomenda 'zero tool de activacao via MCP' para set-widget-status, seguindo a
mesma filosofia ja confirmada no Themer PHP e nos PHP Snippets (aprovacao
humana obrigatoria antes de codigo gerado por IA correr em producao).

Actualiza INDEX.md com a 13a entrada e totais revistos.

graphify-out/GRAPH_REPORT.md

@@ -0,0 +1,103 @@
+# Graph Report - emcp-tools-mapping  (2026-08-19)
+
+## Corpus Check
+- 13 files · ~66,158 words
+- Verdict: corpus is large enough that graph structure adds value.
+
+## Summary
+- 55 nodes · 54 edges · 10 communities
+- Extraction: 100% EXTRACTED · 0% INFERRED · 0% AMBIGUOUS
+- Token cost: 0 input · 0 output
+
+## Graph Freshness
+- Built from commit: `2f98a527`
+- Run `git rev-parse HEAD` and compare to check if the graph is stale.
+- Run `graphify update .` after code changes (no API cost).
+
+## Community Hubs (Navigation)
+- [[_COMMUNITY_EMCP Tools — Mapeamento completo e blueprint de réplica|EMCP Tools — Mapeamento completo e blueprint de réplica]]
+- [[_COMMUNITY_5. Sequência de construção recomendada para uma réplica|5. Sequência de construção recomendada para uma réplica]]
+- [[_COMMUNITY_11 — WooCommerce blueprint de abilities MCP (não é auditoria EMCP)|11 — WooCommerce: blueprint de abilities MCP (não é auditoria EMCP)]]
+- [[_COMMUNITY_3. Encomendas|3. Encomendas]]
+- [[_COMMUNITY_6. Relatórios  Analytics (`wc-analytics`)|6. Relatórios / Analytics (`wc-analytics/*`)]]
+- [[_COMMUNITY_7. Webhooks|7. Webhooks]]
+- [[_COMMUNITY_2. Produtos|2. Produtos]]
+- [[_COMMUNITY_4. Clientes|4. Clientes]]
+- [[_COMMUNITY_5. Cupões  Descontos|5. Cupões / Descontos]]
+- [[_COMMUNITY_9. Blueprint para réplica|9. Blueprint para réplica]]
+
+## God Nodes (most connected - your core abstractions)
+1. `11 — WooCommerce: blueprint de abilities MCP (não é auditoria EMCP)` - 12 edges
+2. `EMCP Tools — Mapeamento completo e blueprint de réplica` - 9 edges
+3. `5. Sequência de construção recomendada para uma réplica` - 8 edges
+4. `3. Encomendas` - 6 edges
+5. `6. Relatórios / Analytics (`wc-analytics/*`)` - 5 edges
+6. `7. Webhooks` - 5 edges
+7. `2. Produtos` - 4 edges
+8. `4. Clientes` - 4 edges
+9. `5. Cupões / Descontos` - 4 edges
+10. `9. Blueprint para réplica` - 4 edges
+
+## Surprising Connections (you probably didn't know these)
+- None detected - all connections are within the same source files.
+
+## Import Cycles
+- None detected.
+
+## Communities (10 total, 0 thin omitted)
+
+### Community 0 - "EMCP Tools — Mapeamento completo e blueprint de réplica"
+Cohesion: 0.25
+Nodes (8): 1. Mapa dos documentos, 2. O achado mais importante de toda a série, 3. Os 5 subsistemas de maior valor para copiar quase verbatim, 4. Padrões arquitecturais que atravessam todo o plugin, 6. Tabela de risco consolidada, 7. Como usar esta documentação, EMCP Tools — Mapeamento completo e blueprint de réplica, Metodologia
+
+### Community 1 - "5. Sequência de construção recomendada para uma réplica"
+Cohesion: 0.25
+Nodes (8): 5. Sequência de construção recomendada para uma réplica, Explicitamente fora de âmbito (doc 10 §2), Fase 0 — Fundação (sem isto, nada mais tem rollback nem é seguro), Fase 1 — Conteúdo WordPress puro (sem dependência de Elementor), Fase 2 — Elementor (o núcleo de "construir páginas"), Fase 3 — Camadas de produto sobre o conteúdo, Fase 4 — Superfície de risco elevado, opt-in, Fase 5 — Integrações e periferia (valor incremental, não bloqueante)
+
+### Community 2 - "11 — WooCommerce: blueprint de abilities MCP (não é auditoria EMCP)"
+Cohesion: 0.29
+Nodes (5): 0. Porque este documento é diferente dos outros 10, 10. Fonte, 11 — WooCommerce: blueprint de abilities MCP (não é auditoria EMCP), 1. Panorama, 8. Segurança / gating recomendado
+
+### Community 3 - "3. Encomendas"
+Cohesion: 0.33
+Nodes (6): 3.1 Estados reais (não inventados — via `wc_get_order_statuses()`), 3.2 Itens da encomenda e ciclo de escrita, 3.3 Devoluções (refunds), 3.4 Notas da encomenda, 3.5 Tabela de ability proposta — Encomendas, 3. Encomendas
+
+### Community 4 - "6. Relatórios / Analytics (`wc-analytics/*`)"
+Cohesion: 0.40
+Nodes (5): 6.1 Dois grupos de controllers, 6.2 Capability real para relatórios (não `manage_woocommerce`), 6.3 Data stores de agregação confirmados, 6.4 Tabela de ability proposta — Analytics, 6. Relatórios / Analytics (`wc-analytics/*`)
+
+### Community 5 - "7. Webhooks"
+Cohesion: 0.40
+Nodes (5): 7.1 Modelo de dados real (confirmado por `$data` default em `WC_Webhook`), 7.2 Validação de topic — não é livre texto, 7.3 Entrega assíncrona por omissão, 7.4 Tabela de ability proposta — Webhooks, 7. Webhooks
+
+### Community 6 - "2. Produtos"
+Cohesion: 0.50
+Nodes (4): 2.1 Schema real (campos confirmados por leitura de `get_item_schema()`), 2.2 Endpoints extra confirmados (além do CRUD standard), 2.3 Tabela de ability proposta — Produtos, 2. Produtos
+
+### Community 7 - "4. Clientes"
+Cohesion: 0.50
+Nodes (4): 4.1 Capabilities reais (não `manage_woocommerce` genérico), 4.2 Schema real (confirmado por `get_item_schema()`), 4.3 Tabela de ability proposta — Clientes, 4. Clientes
+
+### Community 8 - "5. Cupões / Descontos"
+Cohesion: 0.50
+Nodes (4): 5.1 Tipos de desconto reais (via `wc_get_coupon_types()`), 5.2 Campos de restrição confirmados (schema/data props do coupon), 5.3 Tabela de ability proposta — Cupões, 5. Cupões / Descontos
+
+### Community 9 - "9. Blueprint para réplica"
+Cohesion: 0.50
+Nodes (4): 9.1 Prioridade de construção (por valor/esforço, assumindo Fase 0 do doc00 já feita), 9.2 Reaproveitamento explícito dos padrões já documentados, 9.3 O que NÃO replicar sem decisão explícita, 9. Blueprint para réplica
+
+## Knowledge Gaps
+- **43 isolated node(s):** `0. Porque este documento é diferente dos outros 10`, `1. Panorama`, `2.1 Schema real (campos confirmados por leitura de `get_item_schema()`)`, `2.2 Endpoints extra confirmados (além do CRUD standard)`, `2.3 Tabela de ability proposta — Produtos` (+38 more)
+  These have ≤1 connection - possible missing edges or undocumented components.
+
+## Suggested Questions
+_Questions this graph is uniquely positioned to answer:_
+
+- **Why does `11 — WooCommerce: blueprint de abilities MCP (não é auditoria EMCP)` connect `11 — WooCommerce: blueprint de abilities MCP (não é auditoria EMCP)` to `3. Encomendas`, `6. Relatórios / Analytics (`wc-analytics/*`)`, `7. Webhooks`, `2. Produtos`, `4. Clientes`, `5. Cupões / Descontos`, `9. Blueprint para réplica`?**
+  _High betweenness centrality (0.852) - this node is a cross-community bridge._
+- **Why does `EMCP Tools — Mapeamento completo e blueprint de réplica` connect `EMCP Tools — Mapeamento completo e blueprint de réplica` to `5. Sequência de construção recomendada para uma réplica`, `11 — WooCommerce: blueprint de abilities MCP (não é auditoria EMCP)`?**
+  _High betweenness centrality (0.463) - this node is a cross-community bridge._
+- **Why does `5. Sequência de construção recomendada para uma réplica` connect `5. Sequência de construção recomendada para uma réplica` to `EMCP Tools — Mapeamento completo e blueprint de réplica`?**
+  _High betweenness centrality (0.245) - this node is a cross-community bridge._
+- **What connects `0. Porque este documento é diferente dos outros 10`, `1. Panorama`, `2.1 Schema real (campos confirmados por leitura de `get_item_schema()`)` to the rest of the system?**
+  _43 weakly-connected nodes found - possible documentation gaps or missing edges._