@semacode/cli 1.5.32 → 1.5.34

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/AGENTS.md CHANGED
@@ -3,6 +3,18 @@
3
3
  O Sema e o contrato semantico IA-first deste projeto.
4
4
  Toda IA deve consultar o Sema antes de qualquer acao sobre codigo ou contratos. Humanos escrevem e aprovam; agentes consomem o contrato para operar software vivo.
5
5
 
6
+ ## Boot obrigatório para qualquer IA
7
+
8
+ Antes de abrir código cru, leia `SEMA_BOOT.md`. Se a IA tiver pouco contexto, pouca disciplina de tool use ou for um agente secundário, leia também `SEMA_SMALL_MODEL.md`.
9
+
10
+ Capacidade operacional:
11
+
12
+ - IA fraca: use `SEMA_BOOT.md`, `SEMA_SMALL_MODEL.md`, `SEMA_BRIEF.micro.txt` e falhe fechado se Sema não responder.
13
+ - IA média: use `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_BRIEF.curto.txt` e `SEMA_INDEX.json`.
14
+ - IA forte: pode subir para `SEMA_BRIEF.md`, AST, IR e drift completo, mas continua obrigada a passar pelos gates Sema.
15
+
16
+ Idioma humano: responda no idioma falado pelo usuário. Em PT-BR, use acentos, cedilha, pontuação e símbolos normais. A DSL `.sema` pode usar palavras-chave ASCII; isso não autoriza texto humano sem acentos.
17
+
6
18
  ## Regras
7
19
 
8
20
  1. Ao abrir o projeto, chame sema_resumo para entender o estado atual.
@@ -16,7 +28,7 @@ Toda IA deve consultar o Sema antes de qualquer acao sobre codigo ou contratos.
16
28
  ## MCP
17
29
 
18
30
  O servidor MCP do Sema e uma superficie privada/comercial acessada por endpoint remoto autorizado; ele nao e instalado por pacote npm publico neste repositorio.
19
- Use as ferramentas quando o endpoint privado estiver configurado: sema_resumo, sema_validar, sema_drift, sema_impacto, sema_renomear_semantico, sema_inspecionar, sema_ir, sema_verificar, sema_contexto_ia, sema_prompt_ia, sema_author_iniciar, sema_author_validar, sema_author_briefing, sema_author_revisar_cliches, sema_sync_ai_entrypoints, sema_instalar_exemplos, sema_docs_impacto, sema_finalizar_mudanca.
31
+ Use as ferramentas quando o endpoint privado estiver configurado: sema_resumo, sema_validar, sema_drift, sema_impacto, sema_renomear_semantico, sema_inspecionar, sema_ir, sema_verificar, sema_contexto_ia, sema_prompt_ia, sema_author_iniciar, sema_author_validar, sema_author_briefing, sema_author_revisar_cliches, sema_sync_ai_entrypoints, sema_exemplos, sema_instalar_exemplos, sema_docs_impacto, sema_finalizar_mudanca.
20
32
 
21
33
  O MCP deve deixar claro em toda orientacao: se nao existe contrato, crie; se a intencao mudou, edite; se a capacidade saiu, remova ou aposente. Isso vale para todo tipo de Sema: Software, Author, Workflow, Ops, Game, Legal, Research e profiles futuros.
22
34
 
@@ -47,7 +59,9 @@ Quando usar Sema via CLI:
47
59
 
48
60
  - Sempre salve arquivos .sema na pasta `contratos/` do projeto.
49
61
  - Crie um arquivo .sema por modulo ou contexto de negocio. Exemplo: `contratos/pedido.sema`, `contratos/pagamento.sema`, `contratos/usuario.sema`. Nunca coloque modulos de contextos diferentes no mesmo arquivo.
50
- - Antes de criar qualquer arquivo .sema, leia todos os arquivos da pasta `exemplos/` para entender o formato correto da linguagem.
62
+ - Antes de criar qualquer arquivo .sema, leia os exemplos oficiais para entender o formato correto da linguagem.
63
+ - Em MCP remoto/cliente web, use `sema_exemplos` para listar ou ler exemplos oficiais. Nao peca para o MCP ler `C:\GitHub\Sema\exemplos` nem qualquer pasta local do usuario.
64
+ - Em CLI/local repo, a pasta `exemplos/` pode ser lida ou materializada localmente quando necessario.
51
65
  - Nunca edite os arquivos da pasta `exemplos/`.
52
66
 
53
67
  ## Quando o projeto nao tem .sema
@@ -1,90 +1,111 @@
1
1
  {
2
2
  "nome": "Agent Context Pack",
3
- "versao": 1,
4
- "objetivo": "Dar a agentes IA uma entrada curta, estruturada e auditavel antes de abrir codigo cru ou inventar contexto.",
3
+ "versao": 2,
4
+ "objetivo": "Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.",
5
5
  "ordemLeitura": [
6
+ "SEMA_BOOT.md",
6
7
  "llms.txt",
7
8
  "AGENT_CONTEXT_PACK.json",
9
+ "SEMA_SMALL_MODEL.md",
8
10
  "SEMA_BRIEF.micro.txt",
9
11
  "SEMA_INDEX.json",
10
12
  "AGENTS.md",
11
13
  "exemplos/"
12
14
  ],
13
15
  "regrasObrigatorias": [
14
- "Contrato vem antes da acao.",
15
- "Leia AGENTS.md antes de editar codigo, contrato, docs operacionais, release ou deploy.",
16
+ "Contrato vem antes da ação.",
17
+ "Leia SEMA_BOOT.md antes de qualquer outro artefato de IA.",
18
+ "Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy.",
16
19
  "Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.",
17
- "Use SEMA_INDEX.json para escolher contrato, modulo e arquivos provaveis antes de abrir codigo cru.",
20
+ "Use SEMA_INDEX.json para escolher contrato, módulo e arquivos prováveis antes de abrir código cru.",
18
21
  "Valide .sema alterado e rode drift antes de concluir.",
19
- "Quando faltar contrato aplicavel, crie ou edite o contrato antes do codigo."
22
+ "Quando faltar contrato aplicável, crie ou edite o contrato antes do código.",
23
+ "Responda no idioma do usuário e preserve acentos, cedilha, pontuação e símbolos humanos."
20
24
  ],
21
25
  "proibicoes": [
22
- "Nao inventar sintaxe Sema fora da gramatica e dos exemplos oficiais.",
23
- "Nao tratar README, texto livre ou codigo como fonte superior ao contrato.",
24
- "Nao sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
25
- "Nao publicar, deployar ou remover capacidade sem contrato, drift e verificacao.",
26
- "Nao misturar repositorio publico e privado sem conferir docs de repositorios e AGENTS.md."
26
+ "Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
27
+ "Não tratar README, texto livre ou código como fonte superior ao contrato.",
28
+ "Não sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
29
+ "Não publicar, deployar ou remover capacidade sem contrato, drift e verificação.",
30
+ "Não misturar repositório público e privado sem conferir docs de repositórios e AGENTS.md.",
31
+ "Não usar a estética ASCII da DSL como desculpa para escrever PT-BR sem acentos."
27
32
  ],
28
33
  "prioridades": [
29
34
  "Menor artefato suficiente primeiro.",
30
- "Contrato, indice e AGENTS antes de codigo cru.",
35
+ "Contrato, índice e AGENTS antes de código cru.",
31
36
  "Exemplos oficiais antes de nova sintaxe.",
32
- "Diagnostico estruturado antes de opiniao livre.",
33
- "Se risco ou escopo estiver ambigui, parar e pedir contrato/contexto."
37
+ "Diagnóstico estruturado antes de opinião livre.",
38
+ "Se risco ou escopo estiver ambíguo, parar e pedir contrato/contexto."
34
39
  ],
35
40
  "fontes": [
36
41
  {
37
- "caminho": "llms.txt",
42
+ "caminho": "SEMA_BOOT.md",
38
43
  "tipo": "entrypoint",
39
44
  "prioridade": 1,
40
45
  "obrigatorio": true,
46
+ "quandoUsar": "sempre no primeiro contato de qualquer agente com o projeto",
47
+ "incluirTextoBrutoQuando": "a IA precisa de um boot curto, fail-closed e independente do tamanho de contexto"
48
+ },
49
+ {
50
+ "caminho": "SEMA_SMALL_MODEL.md",
51
+ "tipo": "entrypoint",
52
+ "prioridade": 2,
53
+ "obrigatorio": true,
54
+ "quandoUsar": "IA fraca, Copilot, modelo local pequeno, Cline/Roo com pouco contexto ou tarefa curta",
55
+ "incluirTextoBrutoQuando": "a IA tende a ignorar instruções longas ou copiar a estética ASCII da DSL"
56
+ },
57
+ {
58
+ "caminho": "llms.txt",
59
+ "tipo": "entrypoint",
60
+ "prioridade": 3,
61
+ "obrigatorio": true,
41
62
  "quandoUsar": "sempre no primeiro contato com o projeto",
42
- "incluirTextoBrutoQuando": "a IA precisa de orientacao compacta para operar o repositorio"
63
+ "incluirTextoBrutoQuando": "a IA precisa de orientação compacta para operar o repositório"
43
64
  },
44
65
  {
45
66
  "caminho": "AGENT_CONTEXT_PACK.json",
46
67
  "tipo": "entrypoint",
47
- "prioridade": 2,
68
+ "prioridade": 4,
48
69
  "obrigatorio": true,
49
70
  "quandoUsar": "sempre antes de decidir quais documentos ou exemplos abrir",
50
- "incluirTextoBrutoQuando": "a IA precisa auditar regras, proibicoes, prioridades e fontes de verdade"
71
+ "incluirTextoBrutoQuando": "a IA precisa auditar regras, proibições, prioridades e fontes de verdade"
51
72
  },
52
73
  {
53
74
  "caminho": "SEMA_BRIEF.micro.txt",
54
75
  "tipo": "resumo",
55
- "prioridade": 3,
76
+ "prioridade": 5,
56
77
  "obrigatorio": true,
57
- "quandoUsar": "IA pequena, onboarding, chat remoto ou primeiro triage",
78
+ "quandoUsar": "IA fraca, onboarding, chat remoto ou primeiro triage",
58
79
  "incluirTextoBrutoQuando": "a tarefa cabe em contexto curto"
59
80
  },
60
81
  {
61
82
  "caminho": "SEMA_BRIEF.curto.txt",
62
83
  "tipo": "resumo",
63
- "prioridade": 4,
84
+ "prioridade": 6,
64
85
  "obrigatorio": true,
65
- "quandoUsar": "IA media, mudanca pequena ou review rapido",
66
- "incluirTextoBrutoQuando": "o modulo alvo ainda nao esta claro pelo micro"
86
+ "quandoUsar": "IA média, mudança pequena ou review rápido",
87
+ "incluirTextoBrutoQuando": "o módulo alvo ainda não está claro pelo micro"
67
88
  },
68
89
  {
69
90
  "caminho": "SEMA_INDEX.json",
70
91
  "tipo": "indice",
71
- "prioridade": 5,
92
+ "prioridade": 7,
72
93
  "obrigatorio": true,
73
- "quandoUsar": "antes de abrir codigo cru ou escolher contrato alvo",
74
- "incluirTextoBrutoQuando": "a IA precisa mapear modulos, lacunas, riscos ou arquivos provaveis"
94
+ "quandoUsar": "antes de abrir código cru ou escolher contrato alvo",
95
+ "incluirTextoBrutoQuando": "a IA precisa mapear módulos, lacunas, riscos ou arquivos prováveis"
75
96
  },
76
97
  {
77
98
  "caminho": "AGENTS.md",
78
99
  "tipo": "operacional",
79
- "prioridade": 6,
100
+ "prioridade": 8,
80
101
  "obrigatorio": true,
81
- "quandoUsar": "antes de editar codigo, contrato, docs operacionais, release ou deploy",
82
- "incluirTextoBrutoQuando": "a IA precisa confirmar regras locais obrigatorias e prioridades do projeto"
102
+ "quandoUsar": "antes de editar código, contrato, docs operacionais, release ou deploy",
103
+ "incluirTextoBrutoQuando": "a IA precisa confirmar regras locais obrigatórias e prioridades do projeto"
83
104
  },
84
105
  {
85
106
  "caminho": "exemplos/",
86
107
  "tipo": "exemplos",
87
- "prioridade": 7,
108
+ "prioridade": 9,
88
109
  "obrigatorio": true,
89
110
  "quandoUsar": "antes de criar ou corrigir arquivo .sema, profile, Author, workflow, ops, game, legal ou research",
90
111
  "incluirTextoBrutoQuando": "a IA vai escrever sintaxe Sema ou comparar um contrato com formato oficial"
@@ -92,25 +113,33 @@
92
113
  {
93
114
  "caminho": "docs/AGENT_STARTER.md",
94
115
  "tipo": "docs",
95
- "prioridade": 8,
116
+ "prioridade": 10,
117
+ "obrigatorio": false,
118
+ "quandoUsar": "onboarding de agente novo ou explicação curta do fluxo",
119
+ "incluirTextoBrutoQuando": "o agente remoto não conhece Sema ainda"
120
+ },
121
+ {
122
+ "caminho": "docs/agentes-por-capacidade.md",
123
+ "tipo": "docs",
124
+ "prioridade": 11,
96
125
  "obrigatorio": false,
97
- "quandoUsar": "onboarding de agente novo ou explicacao curta do fluxo",
98
- "incluirTextoBrutoQuando": "o agente remoto nao conhece Sema ainda"
126
+ "quandoUsar": "configurar Copilot, Cline, Roo Code, OpenCode ou outro agente com disciplina variável",
127
+ "incluirTextoBrutoQuando": "a IA precisa entender tiers fraca/média/forte e política de idioma"
99
128
  },
100
129
  {
101
130
  "caminho": "docs/sintaxe.md",
102
131
  "tipo": "docs",
103
- "prioridade": 9,
132
+ "prioridade": 12,
104
133
  "obrigatorio": false,
105
- "quandoUsar": "duvida de gramatica, blocos ou formato do DSL",
106
- "incluirTextoBrutoQuando": "a IA vai editar contrato e os exemplos nao bastam"
134
+ "quandoUsar": "dúvida de gramática, blocos ou formato do DSL",
135
+ "incluirTextoBrutoQuando": "a IA vai editar contrato e os exemplos não bastam"
107
136
  },
108
137
  {
109
138
  "caminho": "contratos/",
110
139
  "tipo": "contrato",
111
- "prioridade": 10,
140
+ "prioridade": 13,
112
141
  "obrigatorio": true,
113
- "quandoUsar": "antes de qualquer implementacao ou alteracao de comportamento",
142
+ "quandoUsar": "antes de qualquer implementação ou alteração de comportamento",
114
143
  "incluirTextoBrutoQuando": "a tarefa toca uma capacidade governada por contrato"
115
144
  }
116
145
  ],
@@ -126,32 +155,57 @@
126
155
  "exemplos/author_obra_comum.sema"
127
156
  ],
128
157
  "textoBrutoSobDemanda": {
129
- "llms.txt": "a IA precisa de orientacao compacta para operar o repositorio",
130
- "AGENT_CONTEXT_PACK.json": "a IA precisa auditar regras, proibicoes, prioridades e fontes de verdade",
158
+ "SEMA_BOOT.md": "a IA precisa de um boot curto, fail-closed e independente do tamanho de contexto",
159
+ "SEMA_SMALL_MODEL.md": "a IA tende a ignorar instruções longas ou copiar a estética ASCII da DSL",
160
+ "llms.txt": "a IA precisa de orientação compacta para operar o repositório",
161
+ "AGENT_CONTEXT_PACK.json": "a IA precisa auditar regras, proibições, prioridades e fontes de verdade",
131
162
  "SEMA_BRIEF.micro.txt": "a tarefa cabe em contexto curto",
132
- "SEMA_BRIEF.curto.txt": "o modulo alvo ainda nao esta claro pelo micro",
133
- "SEMA_INDEX.json": "a IA precisa mapear modulos, lacunas, riscos ou arquivos provaveis",
134
- "AGENTS.md": "a IA precisa confirmar regras locais obrigatorias e prioridades do projeto",
163
+ "SEMA_BRIEF.curto.txt": "o módulo alvo ainda não está claro pelo micro",
164
+ "SEMA_INDEX.json": "a IA precisa mapear módulos, lacunas, riscos ou arquivos prováveis",
165
+ "AGENTS.md": "a IA precisa confirmar regras locais obrigatórias e prioridades do projeto",
135
166
  "exemplos/": "a IA vai escrever sintaxe Sema ou comparar um contrato com formato oficial",
136
- "docs/AGENT_STARTER.md": "o agente remoto nao conhece Sema ainda",
137
- "docs/sintaxe.md": "a IA vai editar contrato e os exemplos nao bastam",
167
+ "docs/AGENT_STARTER.md": "o agente remoto não conhece Sema ainda",
168
+ "docs/agentes-por-capacidade.md": "a IA precisa entender tiers fraca/média/forte e política de idioma",
169
+ "docs/sintaxe.md": "a IA vai editar contrato e os exemplos não bastam",
138
170
  "contratos/": "a tarefa toca uma capacidade governada por contrato"
139
171
  },
140
172
  "guiaPorCapacidade": {
173
+ "fraca": [
174
+ "SEMA_BOOT.md",
175
+ "SEMA_SMALL_MODEL.md",
176
+ "agent-context-pack.json",
177
+ "resumo.micro.txt",
178
+ "briefing.min.json",
179
+ "resumo.curto.txt"
180
+ ],
141
181
  "pequena": [
182
+ "SEMA_BOOT.md",
183
+ "SEMA_SMALL_MODEL.md",
142
184
  "agent-context-pack.json",
143
185
  "resumo.micro.txt",
144
186
  "briefing.min.json",
145
187
  "resumo.curto.txt"
146
188
  ],
147
189
  "media": [
190
+ "SEMA_BOOT.md",
148
191
  "agent-context-pack.json",
149
192
  "resumo.curto.txt",
150
193
  "briefing.min.json",
151
194
  "drift.json",
152
195
  "resumo.md"
153
196
  ],
197
+ "forte": [
198
+ "SEMA_BOOT.md",
199
+ "agent-context-pack.json",
200
+ "README.md",
201
+ "resumo.md",
202
+ "briefing.json",
203
+ "drift.json",
204
+ "ir.json",
205
+ "ast.json"
206
+ ],
154
207
  "grande": [
208
+ "SEMA_BOOT.md",
155
209
  "agent-context-pack.json",
156
210
  "README.md",
157
211
  "resumo.md",
@@ -160,5 +214,75 @@
160
214
  "ir.json",
161
215
  "ast.json"
162
216
  ]
163
- }
217
+ },
218
+ "aliasesCapacidade": {
219
+ "pequena": "fraca",
220
+ "grande": "forte"
221
+ },
222
+ "entrypointsClientes": [
223
+ {
224
+ "cliente": "copilot",
225
+ "arquivos": [
226
+ ".github/copilot-instructions.md",
227
+ "AGENTS.md",
228
+ "SEMA_BOOT.md"
229
+ ],
230
+ "capacidadePadrao": "media",
231
+ "observacao": "VS Code/Copilot deve receber uma instrução curta e repetida no arquivo próprio, sem depender só do AGENTS.md."
232
+ },
233
+ {
234
+ "cliente": "cline",
235
+ "arquivos": [
236
+ ".clinerules/00-sema.md",
237
+ ".clinerules",
238
+ "SEMA_BOOT.md"
239
+ ],
240
+ "capacidadePadrao": "fraca",
241
+ "observacao": "Cline costuma obedecer melhor quando o gate Sema vem em arquivo curto; se .clinerules for arquivo legado, o Sema atualiza esse fallback."
242
+ },
243
+ {
244
+ "cliente": "roo",
245
+ "arquivos": [
246
+ ".roo/rules/00-sema.md",
247
+ "AGENTS.md",
248
+ "SEMA_BOOT.md"
249
+ ],
250
+ "capacidadePadrao": "fraca",
251
+ "observacao": "Roo Code deve começar por uma regra dedicada em .roo/rules antes de abrir arquivos longos."
252
+ },
253
+ {
254
+ "cliente": "opencode",
255
+ "arquivos": [
256
+ ".opencode/instructions.md",
257
+ "AGENTS.md",
258
+ "SEMA_BOOT.md"
259
+ ],
260
+ "capacidadePadrao": "media",
261
+ "observacao": "OpenCode deve receber a mesma regra curta em instructions.md quando a pasta .opencode já existir."
262
+ },
263
+ {
264
+ "cliente": "generico",
265
+ "arquivos": [
266
+ "SEMA_BOOT.md",
267
+ "SEMA_SMALL_MODEL.md",
268
+ "AGENT_CONTEXT_PACK.json"
269
+ ],
270
+ "capacidadePadrao": "fraca",
271
+ "observacao": "Qualquer agente sem integração específica começa pelo boot card e só sobe contexto se passar pelos gates."
272
+ }
273
+ ],
274
+ "politicaIdioma": {
275
+ "regra": "A linguagem humana da resposta deve seguir o idioma do usuário e preservar acentos, cedilha, pontuação e símbolos esperados. A DSL .sema pode ter palavras-chave ASCII; isso não autoriza PT-BR sem acentos.",
276
+ "idiomaHumanoPadrao": "pt-BR quando a conversa ou o projeto estiverem em português; caso contrário, use o idioma falado pelo usuário.",
277
+ "preservarAcentos": true,
278
+ "separarDslDeTextoHumano": true,
279
+ "comandosESimbolos": "Não traduza comandos, nomes de arquivos, rotas, símbolos de código ou palavras-chave da DSL."
280
+ },
281
+ "failClosed": [
282
+ "Se não conseguir chamar Sema, pare e declare bloqueio em vez de editar código ou contrato.",
283
+ "Se não houver contrato aplicável, crie ou edite o .sema antes do código.",
284
+ "Se o MCP remoto não tiver projeto sincronizado, use sema_chat_contexto e sema_sync/conteúdo inline; não peça para ler C:\\GitHub\\Sema.",
285
+ "Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",
286
+ "Se a resposta humana estiver em PT-BR, preserve acentos e símbolos mesmo que a DSL use ASCII."
287
+ ]
164
288
  }
@@ -3,9 +3,9 @@ BASE: C:\GitHub\Sema
3
3
  MODULOS: 84
4
4
  MODO_CODIGO: codigo_completo
5
5
  FONTES_CONCLUSAO: contrato, codigo
6
- ENTRADA_IA: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
6
+ ENTRADA_IA: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
7
7
  TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2, sema.produto.author.modelos, sema.produto.author.superficies, sema.produto.author.tarefas_2 (+78)
8
- TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+174)
8
+ TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+176)
9
9
  TOP_LACUNAS: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados, execucao_critica_sem_bloco, execucao_implicita
10
- TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\documentacao.md (+104)
11
- GERADO_EM: 2026-06-04T04:37:43.152Z
10
+ TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\documentacao.md (+105)
11
+ GERADO_EM: 2026-06-05T13:46:09.184Z
package/SEMA_BRIEF.md CHANGED
@@ -2,28 +2,29 @@
2
2
 
3
3
  Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto sem varrer o repo inteiro no escuro.
4
4
 
5
- - Gerado em: `2026-06-04T04:37:43.152Z`
5
+ - Gerado em: `2026-06-05T13:46:09.184Z`
6
6
  - Modulos: `84`
7
7
 
8
8
  ## Entrada canonica para IA
9
9
 
10
- - Ordem minima: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md -> llms-full.txt
11
- - IA pequena: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
12
- - IA media: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
13
- - IA grande: llms-full.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md
10
+ - Ordem minima: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_SMALL_MODEL.md -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md -> llms-full.txt
11
+ - IA fraca: SEMA_BOOT.md -> SEMA_SMALL_MODEL.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
12
+ - IA média: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
13
+ - IA forte: SEMA_BOOT.md -> llms-full.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md
14
+ - Aliases: pequena -> fraca; grande -> forte
14
15
 
15
16
  ## Agent Context Pack
16
17
 
17
18
  - Arquivo: `AGENT_CONTEXT_PACK.json`
18
- - Objetivo: Dar a agentes IA uma entrada curta, estruturada e auditavel antes de abrir codigo cru ou inventar contexto.
19
- - Regras: Contrato vem antes da acao. | Leia AGENTS.md antes de editar codigo, contrato, docs operacionais, release ou deploy. | Use exemplos oficiais antes de criar ou corrigir sintaxe .sema. | Use SEMA_INDEX.json para escolher contrato, modulo e arquivos provaveis antes de abrir codigo cru.
20
- - Fontes brutas sob demanda: llms.txt, AGENT_CONTEXT_PACK.json, SEMA_BRIEF.micro.txt, SEMA_BRIEF.curto.txt, SEMA_INDEX.json, AGENTS.md, exemplos/
19
+ - Objetivo: Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.
20
+ - Regras: Contrato vem antes da ação. | Leia SEMA_BOOT.md antes de qualquer outro artefato de IA. | Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy. | Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.
21
+ - Fontes brutas sob demanda: SEMA_BOOT.md, SEMA_SMALL_MODEL.md, llms.txt, AGENT_CONTEXT_PACK.json, SEMA_BRIEF.micro.txt, SEMA_BRIEF.curto.txt, SEMA_INDEX.json
21
22
 
22
23
  ## Guia por capacidade
23
24
 
24
- - pequena: IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo. Artefatos: agent-context-pack.json, resumo.micro.txt, briefing.min.json, prompt-curto.txt.
25
- - media: IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift. Artefatos: agent-context-pack.json, resumo.curto.txt, briefing.min.json, drift.json, prompt-curto.txt.
26
- - grande: IA com contexto grande ou tool use. Pode consumir o pacote completo. Artefatos: agent-context-pack.json, README.md, resumo.md, briefing.json, drift.json, ir.json, ast.json.
25
+ - fraca: IA fraca, gratuita, local pequena ou com disciplina baixa. Leia o boot card, pare cedo e chame Sema antes de agir. Artefatos: SEMA_BOOT.md, SEMA_SMALL_MODEL.md, agent-context-pack.json, resumo.micro.txt, briefing.min.json, prompt-curto.txt.
26
+ - media: IA média. Aguenta boot, resumo expandido, briefing mínimo, drift e documentação curta. Artefatos: SEMA_BOOT.md, agent-context-pack.json, resumo.curto.txt, briefing.min.json, drift.json, prompt-curto.txt.
27
+ - forte: IA forte, com tool use bom e contexto grande. Pode consumir o pacote completo, mas ainda deve começar pelo boot e pelos gates Sema. Artefatos: SEMA_BOOT.md, agent-context-pack.json, README.md, resumo.md, briefing.json, drift.json, ir.json, ast.json.
27
28
 
28
29
  ## Modulos
29
30
 
@@ -266,17 +267,17 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
266
267
  - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
267
268
 
268
269
  ### sema.produto.governanca_ia.contexto
269
- - Faz: governa 3 task(s) com foco em mapear projeto sem adivinhacao
270
+ - Faz: governa 4 task(s) com foco em mapear projeto sem adivinhacao
270
271
  - Publico: nenhum
271
272
  - Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js, C:\GitHub\Sema\scripts\empacotar-cli-publica.mjs (+2)
272
- - Score: 82 | Confianca: alta | Risco: alto
273
+ - Score: 91 | Confianca: alta | Risco: alto
273
274
  - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
274
275
 
275
276
  ### sema.produto.governanca_ia.documentacao
276
277
  - Faz: governa 3 task(s) com foco em resolver documentacao obrigatoria para mudanca
277
278
  - Publico: nenhum
278
279
  - Tocar: C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\i18n.md, C:\GitHub\Sema\docs\README.md, C:\GitHub\Sema\pacotes\cli\package.json (+4)
279
- - Score: 52 | Confianca: media | Risco: alto
280
+ - Score: 95 | Confianca: alta | Risco: alto
280
281
  - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
281
282
 
282
283
  ### sema.produto.governanca_ia.drift_impacto
@@ -294,10 +295,10 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
294
295
  - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
295
296
 
296
297
  ### sema.produto.governanca_ia.exemplos
297
- - Faz: governa 2 task(s) com foco em materializar exemplos oficiais
298
+ - Faz: governa 3 task(s) com foco em materializar exemplos oficiais
298
299
  - Publico: nenhum
299
- - Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js
300
- - Score: 63 | Confianca: media | Risco: medio
300
+ - Tocar: C:\GitHub\Sema\docs\mcp.md, C:\GitHub\Sema\mcp\src\officialExamples.ts, C:\GitHub\Sema\mcp\src\runtimeConfig.ts, C:\GitHub\Sema\mcp\src\toolsAuthorDocs.ts (+2)
301
+ - Score: 93 | Confianca: alta | Risco: medio
301
302
  - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
302
303
 
303
304
  ### sema.produto.governanca_ia.mcp
@@ -318,7 +319,7 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
318
319
  - Faz: governa 2 task(s) com foco em verificar distribuicao publica
319
320
  - Publico: nenhum
320
321
  - Tocar: C:\GitHub\Sema\docs\refinamentos-agentes-semanticos.md, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\scripts\verificar-distribuicao-publica.mjs
321
- - Score: 78 | Confianca: alta | Risco: alto
322
+ - Score: 93 | Confianca: alta | Risco: alto
322
323
  - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
323
324
 
324
325
  ### sema.produto.governanca_ia
@@ -2,8 +2,8 @@ PROJETO: Sema
2
2
  MODULOS: 84
3
3
  MODO_CODIGO: codigo_completo
4
4
  FONTES_CONCLUSAO: contrato, codigo
5
- ENTRADA_IA: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
5
+ ENTRADA_IA: SEMA_BOOT.md -> SEMA_SMALL_MODEL.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
6
6
  TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+81)
7
- TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+177)
7
+ TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+179)
8
8
  TOP_LACUNAS: audit_ausente, auth_ausente, authz_frouxa (+3)
9
- GERADO_EM: 2026-06-04T04:37:43.152Z
9
+ GERADO_EM: 2026-06-05T13:46:09.184Z