@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 +16 -2
- package/AGENT_CONTEXT_PACK.json +170 -46
- package/SEMA_BRIEF.curto.txt +4 -4
- package/SEMA_BRIEF.md +19 -18
- package/SEMA_BRIEF.micro.txt +3 -3
- package/SEMA_INDEX.json +645 -233
- package/dist/docs.js +72 -5
- package/dist/docs.js.map +1 -1
- package/dist/index.js +479 -139
- package/dist/index.js.map +1 -1
- package/docs/agentes-por-capacidade.md +42 -0
- package/docs/env.md +3 -3
- package/docs/fluxo-pratico-ia-sema.md +13 -5
- package/docs/integracao-com-ia.md +14 -0
- package/docs/mcp.md +6 -0
- package/package.json +10 -10
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
|
|
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
|
package/AGENT_CONTEXT_PACK.json
CHANGED
|
@@ -1,90 +1,111 @@
|
|
|
1
1
|
{
|
|
2
2
|
"nome": "Agent Context Pack",
|
|
3
|
-
"versao":
|
|
4
|
-
"objetivo": "Dar a agentes IA uma entrada curta, estruturada e
|
|
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
|
|
15
|
-
"Leia
|
|
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,
|
|
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
|
|
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
|
-
"
|
|
23
|
-
"
|
|
24
|
-
"
|
|
25
|
-
"
|
|
26
|
-
"
|
|
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,
|
|
35
|
+
"Contrato, índice e AGENTS antes de código cru.",
|
|
31
36
|
"Exemplos oficiais antes de nova sintaxe.",
|
|
32
|
-
"
|
|
33
|
-
"Se risco ou escopo estiver
|
|
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": "
|
|
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
|
|
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":
|
|
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,
|
|
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":
|
|
76
|
+
"prioridade": 5,
|
|
56
77
|
"obrigatorio": true,
|
|
57
|
-
"quandoUsar": "IA
|
|
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":
|
|
84
|
+
"prioridade": 6,
|
|
64
85
|
"obrigatorio": true,
|
|
65
|
-
"quandoUsar": "IA
|
|
66
|
-
"incluirTextoBrutoQuando": "o
|
|
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":
|
|
92
|
+
"prioridade": 7,
|
|
72
93
|
"obrigatorio": true,
|
|
73
|
-
"quandoUsar": "antes de abrir
|
|
74
|
-
"incluirTextoBrutoQuando": "a IA precisa mapear
|
|
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":
|
|
100
|
+
"prioridade": 8,
|
|
80
101
|
"obrigatorio": true,
|
|
81
|
-
"quandoUsar": "antes de editar
|
|
82
|
-
"incluirTextoBrutoQuando": "a IA precisa confirmar regras locais
|
|
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":
|
|
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":
|
|
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": "
|
|
98
|
-
"incluirTextoBrutoQuando": "
|
|
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":
|
|
132
|
+
"prioridade": 12,
|
|
104
133
|
"obrigatorio": false,
|
|
105
|
-
"quandoUsar": "
|
|
106
|
-
"incluirTextoBrutoQuando": "a IA vai editar contrato e os exemplos
|
|
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":
|
|
140
|
+
"prioridade": 13,
|
|
112
141
|
"obrigatorio": true,
|
|
113
|
-
"quandoUsar": "antes de qualquer
|
|
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
|
-
"
|
|
130
|
-
"
|
|
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
|
|
133
|
-
"SEMA_INDEX.json": "a IA precisa mapear
|
|
134
|
-
"AGENTS.md": "a IA precisa confirmar regras locais
|
|
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
|
|
137
|
-
"docs/
|
|
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
|
}
|
package/SEMA_BRIEF.curto.txt
CHANGED
|
@@ -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 (+
|
|
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 (+
|
|
11
|
-
GERADO_EM: 2026-06-
|
|
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-
|
|
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
|
|
12
|
-
- IA
|
|
13
|
-
- IA
|
|
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
|
|
19
|
-
- Regras: Contrato vem antes da
|
|
20
|
-
- Fontes brutas sob demanda: llms.txt, AGENT_CONTEXT_PACK.json, SEMA_BRIEF.micro.txt, SEMA_BRIEF.curto.txt, SEMA_INDEX.json
|
|
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
|
-
-
|
|
25
|
-
- media: IA
|
|
26
|
-
-
|
|
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
|
|
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:
|
|
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:
|
|
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
|
|
298
|
+
- Faz: governa 3 task(s) com foco em materializar exemplos oficiais
|
|
298
299
|
- Publico: nenhum
|
|
299
|
-
- Tocar: C:\GitHub\Sema\
|
|
300
|
-
- Score:
|
|
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:
|
|
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
|
package/SEMA_BRIEF.micro.txt
CHANGED
|
@@ -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 (+
|
|
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-
|
|
9
|
+
GERADO_EM: 2026-06-05T13:46:09.184Z
|