@mocoto/mahoraga 0.15.3 → 0.15.4

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 (19) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/Docs/.obsidian/workspace.json +11 -17
  3. package/Docs/01-arquitetura/ADR-001-estrutura-testes.md +2 -0
  4. package/Docs/01-arquitetura/_index.md +3 -1
  5. package/Docs/02-componentes/_index.md +2 -0
  6. package/Docs/02-componentes/configuracao.md +2 -0
  7. package/Docs/02-componentes/supressao-inline.md +2 -0
  8. package/Docs/03-guias/_index.md +2 -0
  9. package/Docs/03-guias/contribuindo.md +6 -0
  10. package/Docs/03-guias/testes.md +3 -0
  11. package/Docs/04-glossario/_index.md +2 -0
  12. package/Docs/04-glossario/termos.md +3 -1
  13. package/Docs/05-referencias/_index.md +2 -0
  14. package/Docs/06-feedbacks/_index.md +20 -0
  15. package/Docs/06-feedbacks/feedback.md +9 -0
  16. package/Docs/_home.md +13 -8
  17. package/Docs/partials/AVISO-PROVENIENCIA.md +4 -1
  18. package/README.md +11 -5
  19. package/package.json +1 -2
package/CHANGELOG.md ADDED
@@ -0,0 +1,16 @@
1
+ # Changelog
2
+
3
+ ## 0.15.3
4
+
5
+ - Ajustes para publicação no npm como devDependency.
6
+ - Correção de dependência circular.
7
+ - Melhorias na documentação.
8
+
9
+ ## 0.15.2
10
+
11
+ - Correções e refinamentos diversos.
12
+
13
+ ## 0.15.1
14
+
15
+ - Documentação em formato Obsidian vault.
16
+ - Melhorias no sistema de relatórios e compliance.
package/Docs/.obsidian/workspace.json CHANGED
@@ -4,21 +4,17 @@
4
4
  "type": "split",
5
5
  "children": [
6
6
  {
7
- "id": "f49eb26fe94f5853",
7
+ "id": "cf3d6eca2f46262f",
8
8
  "type": "tabs",
9
9
  "children": [
10
10
  {
11
- "id": "8dedf7c146f5cebf",
11
+ "id": "deaae3eaddd32702",
12
12
  "type": "leaf",
13
13
  "state": {
14
- "type": "markdown",
15
- "state": {
16
- "file": "03-guias/testes.md",
17
- "mode": "source",
18
- "source": false
19
- },
14
+ "type": "empty",
15
+ "state": {},
20
16
  "icon": "lucide-file",
21
- "title": "testes"
17
+ "title": "Nova aba"
22
18
  }
23
19
  }
24
20
  ]
@@ -94,8 +90,7 @@
94
90
  "state": {
95
91
  "type": "backlink",
96
92
  "state": {
97
- "file": "06-feedbacks/feedback.md",
98
- "collapseAll": false,
93
+ "collapseAll": true,
99
94
  "extraContext": false,
100
95
  "sortOrder": "alphabetical",
101
96
  "showSearch": false,
@@ -104,7 +99,7 @@
104
99
  "unlinkedCollapsed": true
105
100
  },
106
101
  "icon": "links-coming-in",
107
- "title": "Links inversos para feedback"
102
+ "title": "Links inversos"
108
103
  }
109
104
  },
110
105
  {
@@ -167,8 +162,7 @@
167
162
  }
168
163
  ],
169
164
  "direction": "horizontal",
170
- "width": 300,
171
- "collapsed": true
165
+ "width": 300
172
166
  },
173
167
  "left-ribbon": {
174
168
  "hiddenItems": {
@@ -181,8 +175,10 @@
181
175
  "bases:Criar nova base": false
182
176
  }
183
177
  },
184
- "active": "8dedf7c146f5cebf",
178
+ "active": "deaae3eaddd32702",
185
179
  "lastOpenFiles": [
180
+ "Sem título.base",
181
+ "03-guias/testes.md",
186
182
  "03-guias/contribuindo.md",
187
183
  "03-guias/_index.md",
188
184
  "02-componentes/supressao-inline.md",
@@ -193,12 +189,10 @@
193
189
  "06-feedbacks/feedback.md",
194
190
  "Sem título.md",
195
191
  "Sem título",
196
- "Sem título.base",
197
192
  "templates/guia.md",
198
193
  "templates/componente.md",
199
194
  "templates/ADR.md",
200
195
  "04-glossario/termos.md",
201
- "03-guias/testes.md",
202
196
  "_home.md"
203
197
  ]
204
198
  }
package/Docs/01-arquitetura/ADR-001-estrutura-testes.md CHANGED
@@ -5,6 +5,8 @@ status: aceito
5
5
  created: 2026-07-24
6
6
  ---
7
7
 
8
+ [[_index|← Arquitetura]] • [[../_home|Home]]
9
+
8
10
  # ADR-001: Estrutura de Testes com Vitest
9
11
 
10
12
  ## Contexto
package/Docs/01-arquitetura/_index.md CHANGED
@@ -5,6 +5,8 @@ created: 2026-07-24
5
5
  updated: 2026-07-25
6
6
  ---
7
7
 
8
+ [[../_home|← Home]]
9
+
8
10
  # Arquitetura
9
11
 
10
12
  ## Visão Geral
@@ -108,7 +110,7 @@ O projeto usa path aliases estilo `@pasta/arquivo` para todos os imports interno
108
110
  ## Decisões Arquiteturais
109
111
 
110
112
  - [[ADR-001-estrutura-testes|ADR-001: Estrutura de Testes com Vitest]]
111
- - Novos ADRs devem seguir o template em `templates/ADR.md`
113
+ - Novos ADRs devem seguir o [[../templates/ADR|template ADR]]
112
114
 
113
115
  ## Diagrama de Componentes
114
116
 
package/Docs/02-componentes/_index.md CHANGED
@@ -5,6 +5,8 @@ created: 2026-07-24
5
5
  updated: 2026-07-25
6
6
  ---
7
7
 
8
+ [[../_home|← Home]] • [[../01-arquitetura/_index|Arquitetura]]
9
+
8
10
  # Componentes
9
11
 
10
12
  ## src/bin/
package/Docs/02-componentes/configuracao.md CHANGED
@@ -5,6 +5,8 @@ status: aceito
5
5
  created: 2026-07-25
6
6
  ---
7
7
 
8
+ [[_index|← Componentes]] • [[../_home|Home]]
9
+
8
10
  # Configuração (`mahoraga.config.json`)
9
11
 
10
12
  ## Fluxo de Carregamento
package/Docs/02-componentes/supressao-inline.md CHANGED
@@ -5,6 +5,8 @@ status: aceito
5
5
  created: 2026-07-25
6
6
  ---
7
7
 
8
+ [[_index|← Componentes]] • [[../_home|Home]]
9
+
8
10
  # Supressão Inline (`@mahoraga-disable`)
9
11
 
10
12
  ## Propósito
package/Docs/03-guias/_index.md CHANGED
@@ -5,6 +5,8 @@ created: 2026-07-24
5
5
  updated: 2026-07-25
6
6
  ---
7
7
 
8
+ [[../_home|← Home]]
9
+
8
10
  # Guias
9
11
 
10
12
  ## Desenvolvimento
package/Docs/03-guias/contribuindo.md CHANGED
@@ -6,6 +6,8 @@ created: 2026-07-24
6
6
  updated: 2026-07-25
7
7
  ---
8
8
 
9
+ [[_index|← Guias]] • [[../_home|Home]]
10
+
9
11
  # Contribuindo
10
12
 
11
13
  ## Workflow
@@ -24,6 +26,10 @@ updated: 2026-07-25
24
26
  - [ ] Mensagens i18n atualizadas em pt, en, zh, ja
25
27
  - [ ] Documentação atualizada em `Docs/`
26
28
 
29
+ ## Templates
30
+
31
+ Novos documentos devem usar os templates em [[../templates/componente|template de componente]] ou [[../templates/guia|template de guia]]. ADRs seguem o [[../templates/ADR|template ADR]].
32
+
27
33
  ## Convenções
28
34
 
29
35
  - Commits: `tipo(escopo): descrição no imperativo`
package/Docs/03-guias/testes.md CHANGED
@@ -6,6 +6,8 @@ created: 2026-07-24
6
6
  updated: 2026-07-25
7
7
  ---
8
8
 
9
+ [[_index|← Guias]] • [[../_home|Home]]
10
+
9
11
  # Testes
10
12
 
11
13
  ## Stack
@@ -15,6 +17,7 @@ updated: 2026-07-25
15
17
  - **Mocks:** `vi.hoisted()` + `vi.mock()` no topo dos arquivos
16
18
  - **Organização:** `tests/` espelha `src/` em estrutura de diretórios
17
19
  - **Aliases:** Mesma configuração de paths do tsconfig (definidos em `vitest.config.ts`)
20
+ - **Decisão:** Ver [[../01-arquitetura/ADR-001-estrutura-testes|ADR-001: Estrutura de Testes]]
18
21
 
19
22
  ## Padrões
20
23
 
package/Docs/04-glossario/_index.md CHANGED
@@ -4,6 +4,8 @@ tags: [moc, glossario]
4
4
  created: 2026-07-24
5
5
  ---
6
6
 
7
+ [[../_home|← Home]]
8
+
7
9
  # Glossário
8
10
 
9
11
  ## Termos do Domínio
package/Docs/04-glossario/termos.md CHANGED
@@ -5,13 +5,15 @@ created: 2026-07-24
5
5
  updated: 2026-07-25
6
6
  ---
7
7
 
8
+ [[_index|← Glossário]] • [[../_home|Home]]
9
+
8
10
  # Termos do Domínio
9
11
 
10
12
  ## A
11
13
 
12
14
  ### ADR (Architecture Decision Record)
13
15
 
14
- Registro de decisão arquitetural. Documenta o contexto, a decisão tomada, consequências e alternativas consideradas. Usa o template em `templates/ADR.md`.
16
+ Registro de decisão arquitetural. Documenta o contexto, a decisão tomada, consequências e alternativas consideradas. Usa o [[../templates/ADR|template ADR]].
15
17
 
16
18
  ### Advisor
17
19
 
package/Docs/05-referencias/_index.md CHANGED
@@ -5,6 +5,8 @@ created: 2026-07-24
5
5
  updated: 2026-07-25
6
6
  ---
7
7
 
8
+ [[../_home|← Home]]
9
+
8
10
  # Referências
9
11
 
10
12
  ## Links Externos
package/Docs/06-feedbacks/_index.md ADDED
@@ -0,0 +1,20 @@
1
+ ---
2
+ Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
3
+ tags: [moc, feedback]
4
+ created: 2026-07-25
5
+ updated: 2026-07-25
6
+ ---
7
+
8
+ [[../_home|← Home]]
9
+
10
+ # Feedbacks
11
+
12
+ Análises de relatórios gerados pelo linter, com identificação de falsos positivos e sugestões de melhoria.
13
+
14
+ ## Relatórios
15
+
16
+ - [[feedback|Feedback — Análise de Relatórios do Linter]]
17
+
18
+ ## Propósito
19
+
20
+ Esta seção documenta problemas identificados durante o uso do Mahoraga para auto-análise, servindo como _feedback loop_ para refinamento contínuo das regras do linter e da documentação.
package/Docs/06-feedbacks/feedback.md CHANGED
@@ -1,3 +1,12 @@
1
+ ---
2
+ Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
3
+ tags: [feedback, analise]
4
+ created: 2026-07-25
5
+ updated: 2026-07-25
6
+ ---
7
+
8
+ [[_index|← Feedbacks]] • [[../_home|Home]]
9
+
1
10
  # Feedback — Análise de Relatórios do Linter
2
11
 
3
12
  ## Resumo
package/Docs/_home.md CHANGED
@@ -11,14 +11,19 @@ CLI modular para análise, diagnóstico e manutenção de projetos JavaScript/Ty
11
11
 
12
12
  ## Navegação
13
13
 
14
- | Área | Descrição |
15
- | ---------------------------------- | ------------------ | ------------------------------------------------------------ |
16
- | [[01-arquitetura/_index\ | Arquitetura]] | Decisões arquiteturais, ADRs, diagramas, fluxos |
17
- | [[02-componentes/_index\ | Componentes]] | Documentação de todos os módulos do sistema |
18
- | [[02-componentes/supressao-inline\ | Supressão Inline]] | Sistema de `@mahoraga-disable` para analistas e formatadores |
19
- | [[03-guias/_index\ | Guias]] | Guias de contribuição, testes, CLI, debug |
20
- | [[04-glossario/_index\ | Glossário]] | Termos do domínio e conceitos |
21
- | [[05-referencias/_index\ | Referências]] | Links externos, specs, recursos |
14
+ | Área | Descrição |
15
+ | --- | --- |
16
+ | [[01-arquitetura/_index|Arquitetura]] | Decisões arquiteturais, ADRs, diagramas, fluxos |
17
+ | [[02-componentes/_index|Componentes]] | Documentação de todos os módulos do sistema |
18
+ | [[02-componentes/supressao-inline|Supressão Inline]] | Sistema de `@mahoraga-disable` para analistas e formatadores |
19
+ | [[03-guias/_index|Guias]] | Guias de contribuição, testes, CLI, debug |
20
+ | [[04-glossario/_index|Glossário]] | Termos do domínio e conceitos |
21
+ | [[05-referencias/_index|Referências]] | Links externos, specs, recursos |
22
+ | [[06-feedbacks/_index|Feedbacks]] | Análises de relatórios do linter |
23
+ | [[partials/AVISO-PROVENIENCIA|Partial: Aviso de Proveniência]] | Bloco reutilizável para transclusão |
24
+ | [[templates/ADR|Template: ADR]] | Template para Architecture Decision Records |
25
+ | [[templates/componente|Template: Componente]] | Template para documentação de componentes |
26
+ | [[templates/guia|Template: Guia]] | Template para guias de desenvolvimento |
22
27
 
23
28
  ## Visão Geral
24
29
 
package/Docs/partials/AVISO-PROVENIENCIA.md CHANGED
@@ -1,3 +1,6 @@
1
1
  ---
2
2
  Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
3
- ---
3
+ tags: [partial, template]
4
+ ---
5
+
6
+ > Use `![[partials/AVISO-PROVENIENCIA]]` para transcluir este aviso em qualquer nota.
package/README.md CHANGED
@@ -8,13 +8,19 @@ Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (lice
8
8
 
9
9
  </div>
10
10
 
11
- Abre seu obsidian, se não tiver instalado instala. Vai em abrir cofre, vai no seu projeto onde o mahoraga esta instalado, vai em projeto/node_modules/@mocoto/mahoraga/Docs e clique em selecionar. A documentação vai estar como obsidian do jeito que voces gostam. Como eu ia usar o projeto só pra mim então eu exclui a documentão essa é nova e vai ser completada conforme o projeto avança, mas acho que ja serve pra voces iniciar.
11
+ > **🥱 Documentação no Obsidian**: A pasta `Docs/` é um vault Obsidian com wikilinks, MOCs e diagramas. Para navegar:
12
+ > 1. Instale o [Obsidian](https://obsidian.md/)
13
+ > 2. Abra **Gerenciar Cofres** → **Abrir cofre como pasta**
14
+ > 3. Selecione `node_modules/@mocoto/mahoraga/Docs` (ou a cópia local em `Docs/`)
15
+ >
16
+ > A documentação é viva e será complementada conforme o projeto avança. Contribuições são bem-vindas.
12
17
 
13
- o mahoraga deve ser instalado como devdependence npm install @mocoto/mahoraga --save-dev depois arrumo certinho. to ocupado agora.
14
-
15
- Caso queira ajudar com relatórios de bugs e erros ou com sugestões, entre em contato pelo e-mail abaixo.
18
+ ```bash
19
+ # Instalação como devDependency
20
+ npm install @mocoto/mahoraga --save-dev
21
+ ```
16
22
 
17
- [ProtonMail](mailto:mahoraga.able522@passfwd.com)
23
+ > Dúvidas, sugestões ou reporte de bugs: [ProtonMail](mailto:mahoraga.able522@passfwd.com)
18
24
 
19
25
  ---
20
26
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mocoto/mahoraga",
3
- "version": "0.15.3",
3
+ "version": "0.15.4",
4
4
  "type": "module",
5
5
  "description": "C.L.I modular para análise, diagnóstico e manutenção de projetos JavaScript/TypeScript e multi-stack leve",
6
6
  "author": "Italo Lopes",
@@ -121,7 +121,6 @@
121
121
  "yaml": "^2.9.0"
122
122
  },
123
123
  "devDependencies": {
124
- "@mocoto/mahoraga": "0.15.2",
125
124
  "@types/micromatch": "^4.0.10",
126
125
  "@types/node": "^26.1.1",
127
126
  "@typescript-eslint/eslint-plugin": "8.65.0",