@polymorphism-tech/morph-spec 7.2.0 → 7.4.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 (74) hide show
  1. package/CLAUDE.md +1 -1
  2. package/README.md +2 -2
  3. package/bin/morph-spec.js +4 -2
  4. package/claude-plugin.json +1 -1
  5. package/docs/CHEATSHEET.md +1 -1
  6. package/docs/QUICKSTART.md +1 -1
  7. package/framework/CLAUDE.md +2 -2
  8. package/framework/MORPH.md +29 -12
  9. package/framework/agents.json +132 -132
  10. package/framework/commands/morph-apply.md +1 -1
  11. package/framework/commands/morph-proposal.md +1 -1
  12. package/framework/evals/rubrics/README.md +9 -8
  13. package/framework/hooks/README.md +3 -1
  14. package/framework/hooks/claude-code/core/gate-guard.js +160 -0
  15. package/framework/hooks/claude-code/core/state-sync.js +15 -3
  16. package/framework/hooks/claude-code/core/validate-completion.js +241 -136
  17. package/framework/hooks/shared/state-reader.js +236 -221
  18. package/framework/phases.json +1 -1
  19. package/framework/skills/README.md +2 -2
  20. package/framework/skills/core/morph-apply/SKILL.md +63 -21
  21. package/framework/skills/core/morph-brainstorming/SKILL.md +5 -1
  22. package/framework/skills/core/morph-eval/SKILL.md +4 -5
  23. package/framework/skills/core/morph-implement/SKILL.md +47 -19
  24. package/framework/skills/core/morph-plan/SKILL.md +8 -2
  25. package/framework/skills/core/morph-proposal/SKILL.md +1 -1
  26. package/framework/skills/core/morph-review/SKILL.md +13 -6
  27. package/framework/skills/core/morph-stack-scan/SKILL.md +1 -1
  28. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  29. package/framework/standards/ai-agents/setup.md +258 -244
  30. package/framework/templates/README.md +708 -709
  31. package/framework/templates/REGISTRY.json +1 -20
  32. package/framework/templates/context/CONTEXT-FEATURE.md +276 -276
  33. package/framework/templates/docs/proposal.md +171 -171
  34. package/framework/templates/feature/recap.md +145 -145
  35. package/package.json +1 -1
  36. package/src/commands/project/doctor.js +941 -946
  37. package/src/commands/project/init.js +517 -515
  38. package/src/commands/project/status.js +373 -376
  39. package/src/commands/state/approve.js +251 -213
  40. package/src/commands/validation/validate-feature.js +356 -287
  41. package/src/core/state/state-manager.js +910 -934
  42. package/src/dashboard/app/App.jsx +29 -31
  43. package/src/dashboard/app/components/Sidebar.jsx +44 -45
  44. package/src/dashboard/scanner/index.js +20 -21
  45. package/src/lib/context/context-builder.js +3 -3
  46. package/src/lib/generators/context-generator.js +2 -3
  47. package/src/lib/generators/mandate-generator.js +48 -92
  48. package/src/lib/generators/metadata-extractor.js +385 -386
  49. package/src/lib/generators/recap-generator.js +285 -285
  50. package/src/lib/risk-detector.js +2 -2
  51. package/src/lib/validators/content/content-validator.js +89 -286
  52. package/src/lib/validators/content/index.js +0 -1
  53. package/src/utils/hooks-installer.js +527 -516
  54. package/framework/templates/feature/tasks.md +0 -199
  55. package/framework/workflows/README.md +0 -1041
  56. package/framework/workflows/configs/fast-track.json +0 -46
  57. package/framework/workflows/configs/full.json +0 -64
  58. package/framework/workflows/configs/quick.json +0 -32
  59. package/framework/workflows/configs/standard.json +0 -57
  60. package/framework/workflows/docs/STORY-DRIVEN-DEVELOPMENT.md +0 -392
  61. package/framework/workflows/docs/design-impl.md +0 -37
  62. package/framework/workflows/docs/enforcement-pipeline.md +0 -668
  63. package/framework/workflows/docs/fast-track.md +0 -29
  64. package/framework/workflows/docs/full-morph.md +0 -69
  65. package/framework/workflows/docs/standard.md +0 -49
  66. package/framework/workflows/docs/ui-refresh.md +0 -39
  67. package/src/commands/state/index.js +0 -7
  68. package/src/core/workflows/workflow-detector.js +0 -586
  69. package/src/core/workflows/workflow-router.js +0 -204
  70. package/src/dashboard/app/pages/Workflows.jsx +0 -346
  71. package/src/dashboard/scanner/workflows-scanner.js +0 -18
  72. package/src/lib/phase-chain/phase-validator.js +0 -359
  73. package/src/lib/validators/content/cross-phase-validator.js +0 -281
  74. package/src/lib/validators/spec-validator.js +0 -312
@@ -1,69 +0,0 @@
1
- # Workflow: FULL (Alta Complexidade)
2
-
3
- > **Layer:** 1 | **Load:** on-keyword | **Keywords:** sistema, integração, arquitetura, migração, infraestrutura, plataforma
4
-
5
- ## Critérios
6
-
7
- - > 10 arquivos, > 500 linhas, múltiplos componentes novos
8
- - Infraestrutura, decisões arquiteturais estratégicas, multi-domínio
9
-
10
- ## Fases (TODAS obrigatórias)
11
-
12
- ### FASE 0: PROPOSAL
13
- 1. Analisar solicitação, identificar stack, estimar complexidade
14
- 2. Gerar proposal.md, registrar agentes no state.json
15
- 3. Avaliar complexidade → recomendar workflow full
16
- - **⛔ PAUSA:** Aprovar proposta?
17
-
18
- ### FASE 1: UI/UX (condicional — se keywords UI detectadas)
19
- 1. **Perguntar ao usuário:** layout, referências visuais, fluxo, imagens
20
- 2. Analisar referências fornecidas
21
- 3. Gerar deliverables (design-system, mockups, components, flows)
22
- 4. Validar acessibilidade (WCAG 2.1) e responsividade
23
- - **⛔ PAUSA:** Aprovar UI/UX?
24
-
25
- ### FASE 2: DESIGN (com clarificação integrada)
26
- 1. Scan real do schema (Neon/psql, EF Core, TypeScript)
27
- 2. Validar schema com usuário (CHECKPOINT 1)
28
- 3. Gerar blueprint arquitetural (CHECKPOINT 2)
29
- 4. Gerar spec.md, contracts.cs/.ts, schema-analysis.md, decisions.md
30
- 5. **Quality + Satisfaction scoring** (0-100):
31
- - Quality: schema fidelity, functional coverage, blueprint, integrations, infra
32
- - Satisfaction: functional completeness, failure coverage, edge cases, clarity, contracts
33
- 6. Loop de refinamento: perguntas → atualizar spec.md direto → re-score
34
- 7. Sai quando score ≥ 85 E usuário aprova
35
- - **⛔ PAUSA:** Aprovar design?
36
-
37
- ### FASE 3: PLAN
38
- 1. Ler spec + contracts + decisions
39
- 2. Analisar codebase existente (Glob + Grep)
40
- 3. Determinar estratégia de execução (single/subagents/agent-teams)
41
- 4. Gerar plan.md com tasks cross-referenciando FRs
42
- - **⛔ PAUSA:** Aprovar plano?
43
-
44
- ### FASE 4: TASKS
45
- 1. Quebrar spec em tasks T001-TXXX com [FR refs]
46
- 2. Definir ordem, checkpoints, dependências
47
- - **⛔ PAUSA:** Aprovar tasks?
48
-
49
- ### FASE 5: IMPLEMENT
50
- 1. Para cada task: ler spec FRs → ler contracts → implementar → verificar
51
- 2. `morph-spec task done {feature} {task-id}` após cada task
52
- 3. Checkpoints automáticos a cada 3 tasks
53
- 4. Gerar recap.md ao final
54
-
55
- ### FASE 6: SYNC
56
- 1. Revisar decisions.md, categorizar
57
- 2. Promover para `.morph/context/{category}.md`
58
- 3. Gerar commit dedicado de sync
59
- - **⛔ PAUSA:** Aprovar promoção de decisões?
60
-
61
- ## Outputs Completos
62
- proposal.md, design-system.md, mockups.md, components.md, flows.md, spec.md, contracts.cs/.ts, schema-analysis.md, decisions.md, plan.md, tasks.md, recap.md
63
-
64
- ## Exemplos
65
- - "Sistema de relatórios com jobs agendados Hangfire"
66
- - "Autenticação completa com Neon Auth (login, signup, OAuth)"
67
- - "Dashboard com gráficos, tabelas e filtros complexos"
68
- - "RAG pipeline com AI Search e embeddings"
69
- - "Infraestrutura completa com Docker/Easypanel"
@@ -1,49 +0,0 @@
1
- # Workflow: STANDARD (Média Complexidade)
2
-
3
- > **Layer:** 1 | **Load:** on-keyword | **Keywords:** paginação, filtro, refatorar, performance, exportar
4
-
5
- ## Critérios
6
-
7
- - 3-10 arquivos, 50-500 linhas, 1-2 componentes simples
8
- - Sem infraestrutura complexa, decisões táticas (não estratégicas)
9
-
10
- ## Fases
11
-
12
- ### 1. FASE 0: PROPOSAL (simplificada)
13
- - Análise inicial em 1 parágrafo
14
- - Detecta agentes relevantes
15
- - Avalia complexidade e recomenda workflow
16
- - **PAUSA:** Aprovar?
17
-
18
- ### 2. FASE 2: DESIGN (spec.md + clarificação integrada)
19
- - Spec técnico conciso (1-2 páginas)
20
- - Quality loop com scoring (0-100) + clarificação embutida
21
- - Spec editável até aprovação final
22
- - Decisões táticas em decisions.md
23
- - **PAUSA:** Aprovar?
24
-
25
- ### 3. FASE 3: PLAN
26
- - Plano de implementação com paths exatos e TDD
27
- - Tasks com cross-references para FRs do spec
28
- - **PAUSA:** Aprovar?
29
-
30
- ### 4. FASE 4: TASKS
31
- - Breakdown em tasks com [FR001, FR003] refs
32
- - **PAUSA:** Aprovar? (se > 5 tasks)
33
-
34
- ### 5. FASE 5: IMPLEMENT
35
- - Implementa task por task consultando spec por FR
36
- - Gera recap.md ao final
37
-
38
- ## Outputs
39
- proposal.md, spec.md, plan.md, tasks.md, recap.md
40
-
41
- ## Fases Puladas
42
- - UI/UX — se não tiver front-end significativo (skipIfCondition: !hasUIAgents)
43
- - Sync — decisões não são estratégicas
44
-
45
- ## Exemplos
46
- - "Adicionar paginação na tabela de usuários"
47
- - "Criar filtro por data no relatório"
48
- - "Refatorar serviço de email para async"
49
- - "Adicionar botão de exportar CSV"
@@ -1,39 +0,0 @@
1
- # Workflow: UI REFRESH (Redesign Visual)
2
-
3
- > **Layer:** 1 | **Load:** on-keyword | **Keywords:** redesign, redesenhar, bonito, visual, estetica, modernizar
4
-
5
- ## Critérios
6
-
7
- - Páginas existentes com código funcional
8
- - Apenas mudanças visuais (CSS, HTML, layout)
9
- - Sem mudanças em lógica de negócio, sem infraestrutura
10
-
11
- ## Fases
12
-
13
- ### 1. ANÁLISE VISUAL (FASE 0+1 combinadas)
14
- - Listar páginas a redesenhar
15
- - Identificar componentes compartilhados e design system existente
16
- - Se protótipo existir: ler e extrair padrões
17
- - **PAUSA:** Escolher direção estética
18
-
19
- ### 2. DESIGN SYSTEM (FASE 2 simplificada)
20
- - Definir variáveis CSS novas
21
- - Listar componentes CSS a criar (checklist)
22
- - Gerar/atualizar design-system.css
23
- - **PAUSA:** Aprovar componentes
24
-
25
- ### 3. IMPLEMENT (por página)
26
- - Atualizar CSS primeiro, depois cada página .razor
27
- - Build incremental a cada 2-3 páginas
28
- - Validar com `morph-spec validate-css`
29
-
30
- ## Outputs
31
- design-refresh-checklist.md, CSS atualizado, páginas .razor, recap.md
32
-
33
- ## Fases Puladas
34
- Setup completo, Contracts, Tasks detalhadas, Infra, Clarify, Sync
35
-
36
- ## Exemplos
37
- - "Redesenhar as páginas do checkout para ficar mais bonito"
38
- - "Modernizar visual do dashboard"
39
- - "Aplicar novo design system nas telas existentes"
@@ -1,7 +0,0 @@
1
- /**
2
- * State Management Commands
3
- */
4
- export { stateCommand } from './state.js';
5
- export { advancePhaseCommand } from './advance-phase.js';
6
- export { approveCommand, unapproveCommand, approvalStatusCommand } from './approve.js';
7
- export { phaseRunCommand } from './phase-runner.js';