@semacode/cli 1.5.45 → 1.5.47
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 +324 -324
- package/AGENT_CONTEXT_PACK.json +30 -18
- package/SEMA_BRIEF.curto.txt +6 -5
- package/SEMA_BRIEF.md +106 -106
- package/SEMA_BRIEF.micro.txt +4 -4
- package/SEMA_INDEX.json +741 -456
- package/dist/agentContext.d.ts +2 -2
- package/dist/agentContextPack.js +29 -18
- package/dist/agentContextPack.js.map +1 -1
- package/dist/agentContextTipos.d.ts +1 -1
- package/dist/agentContextTipos.js +1 -0
- package/dist/agentContextTipos.js.map +1 -1
- package/dist/agentEntryPoints.js +247 -7
- package/dist/agentEntryPoints.js.map +1 -1
- package/dist/driftOrcamento.d.ts +2 -2
- package/dist/driftOrcamento.js +13 -10
- package/dist/driftOrcamento.js.map +1 -1
- package/dist/index.part01.js +4 -2
- package/dist/index.part01.js.map +1 -1
- package/dist/index.part02.js +1 -1
- package/dist/index.part02.js.map +1 -1
- package/dist/index.part04.js +34 -3
- package/dist/index.part04.js.map +1 -1
- package/dist/initCommand.js +20 -0
- package/dist/initCommand.js.map +1 -1
- package/dist/initTemplatesBase.js +50 -2
- package/dist/initTemplatesBase.js.map +1 -1
- package/dist/profileArtefatoValidadores.d.ts +2 -0
- package/dist/profileArtefatoValidadores.js +42 -0
- package/dist/profileArtefatoValidadores.js.map +1 -1
- package/dist/profileAuthorTipos.d.ts +2 -2
- package/dist/profileCatalogo.js +64 -2
- package/dist/profileCatalogo.js.map +1 -1
- package/dist/profileCommand.js +4 -4
- package/dist/profileCommand.js.map +1 -1
- package/dist/profileRegras.js +17 -0
- package/dist/profileRegras.js.map +1 -1
- package/dist/profileRulePacks.js +71 -1
- package/dist/profileRulePacks.js.map +1 -1
- package/dist/projetoBusca.js +8 -0
- package/dist/projetoBusca.js.map +1 -1
- package/docs/AGENT_STARTER.md +13 -13
- package/docs/agentes-por-capacidade.md +7 -7
- package/docs/cli.md +3 -0
- package/docs/comandos.md +702 -0
- package/docs/env.md +2 -2
- package/docs/extensao-vscode.md +1 -1
- package/node_modules/@sema/gerador-css/package.json +1 -1
- package/node_modules/@sema/gerador-dart/package.json +1 -1
- package/node_modules/@sema/gerador-html/package.json +1 -1
- package/node_modules/@sema/gerador-javascript/package.json +1 -1
- package/node_modules/@sema/gerador-lua/package.json +1 -1
- package/node_modules/@sema/gerador-python/package.json +1 -1
- package/node_modules/@sema/gerador-typescript/package.json +1 -1
- package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.d.ts +2 -2
- package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js +2 -2
- package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js.map +1 -1
- package/node_modules/@sema/nucleo/package.json +1 -1
- package/node_modules/@sema/padroes/package.json +1 -1
- package/package.json +10 -10
package/dist/projetoBusca.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"projetoBusca.js","sourceRoot":"","sources":["../src/projetoBusca.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"projetoBusca.js","sourceRoot":"","sources":["../src/projetoBusca.ts"],"names":[],"mappings":"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"}
|
package/docs/AGENT_STARTER.md
CHANGED
|
@@ -41,7 +41,7 @@ Importante:
|
|
|
41
41
|
- a Sema funciona como camada de navegacao operacional para agente, nao como runtime magico
|
|
42
42
|
- leitura humana e bonus toleravel, nao centro do produto
|
|
43
43
|
- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
|
|
44
|
-
- a Sema gera codigo e scaffolding real para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS
|
|
44
|
+
- a Sema gera codigo e scaffolding real para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS
|
|
45
45
|
- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico
|
|
46
46
|
- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo
|
|
47
47
|
- a Sema usa `impl` para ligar task a simbolo real do runtime
|
|
@@ -55,11 +55,11 @@ Importante:
|
|
|
55
55
|
- se a tarefa envolver UI, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivo aleatorio
|
|
56
56
|
- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
|
|
57
57
|
|
|
58
|
-
Regras:
|
|
59
|
-
- nao invente sintaxe fora da gramatica e dos exemplos oficiais
|
|
60
|
-
- se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
|
|
61
|
-
- se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo antes de declarar falha
|
|
62
|
-
- trate `ir --json` como fonte de verdade semantica
|
|
58
|
+
Regras:
|
|
59
|
+
- nao invente sintaxe fora da gramatica e dos exemplos oficiais
|
|
60
|
+
- se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
|
|
61
|
+
- se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo antes de declarar falha
|
|
62
|
+
- trate `ir --json` como fonte de verdade semantica
|
|
63
63
|
- trate `diagnosticos --json` como fonte de correcao
|
|
64
64
|
- use `sema formatar` como fonte unica de estilo
|
|
65
65
|
- preserve a intencao do contrato
|
|
@@ -75,7 +75,7 @@ Comandos essenciais:
|
|
|
75
75
|
- diagnosticos: `sema diagnosticos <arquivo.sema> --json`
|
|
76
76
|
- formatacao: `sema formatar <arquivo.sema>`
|
|
77
77
|
- importacao assistida de legado: `sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|typescript|python|dart|dotnet|java|go|rust|cpp> <diretorio> --saida <diretorio>`
|
|
78
|
-
- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>`
|
|
78
|
+
- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>`
|
|
79
79
|
- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`
|
|
80
80
|
|
|
81
81
|
Regra pratica de ouro:
|
|
@@ -83,11 +83,11 @@ Regra pratica de ouro:
|
|
|
83
83
|
- se a tarefa partir de projeto que nao nasceu com Sema, `sema importar` deve entrar antes da lapidacao semantica
|
|
84
84
|
- se a tarefa pedir apenas leitura ou correcao sem gerar codigo, `sema compilar` pode ficar fora
|
|
85
85
|
|
|
86
|
-
Antes de editar:
|
|
87
|
-
1. leia README, docs de IA e um exemplo oficial parecido
|
|
88
|
-
2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
|
|
89
|
-
- se timeout local estourar, repita com timeout maior ou escopo menor; timeout do agente nao e falha do Sema
|
|
90
|
-
3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
|
|
86
|
+
Antes de editar:
|
|
87
|
+
1. leia README, docs de IA e um exemplo oficial parecido
|
|
88
|
+
2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
|
|
89
|
+
- se timeout local estourar, repita com timeout maior ou escopo menor; timeout do agente nao e falha do Sema
|
|
90
|
+
3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
|
|
91
91
|
|
|
92
92
|
Depois de editar:
|
|
93
93
|
1. rode `sema formatar`
|
|
@@ -108,4 +108,4 @@ Documentos de apoio:
|
|
|
108
108
|
|
|
109
109
|
- [como-ensinar-a-sema-para-ia.md](./como-ensinar-a-sema-para-ia.md)
|
|
110
110
|
- [prompt-base-ia-sema.md](./prompt-base-ia-sema.md)
|
|
111
|
-
- [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)
|
|
111
|
+
- [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)
|
|
@@ -16,12 +16,12 @@ O Sema governa contrato, escopo, drift, evidência e qualidade do projeto. Ele n
|
|
|
16
16
|
## Código Governado
|
|
17
17
|
|
|
18
18
|
Arquivos gerados ou governados pela Sema devem manter o marcador `SEMA-GOVERNED`.
|
|
19
|
-
Orçamento semântico é regra:
|
|
19
|
+
Orçamento semântico é regra: código ou contrato governado com 1000+ linhas exige plano de divisão; 2000+ linhas não pode concluir, gerar nem sincronizar. Markdown documental não entra nesse limite de código.
|
|
20
20
|
Validação inline 100/100 não remove essa obrigação: ela comprova aquele payload, mas o arquivo físico ainda precisa avisar a próxima IA que existe contrato.
|
|
21
21
|
|
|
22
|
-
- Fraca: Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Não crie
|
|
23
|
-
- Média: Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate
|
|
24
|
-
- Forte: Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift, orçamento de
|
|
22
|
+
- Fraca: Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Não crie código ou contrato governado acima de 2000 linhas nem envie payload inline acima de 262144 caracteres; divida antes por responsabilidade, nunca em partes p1/p2 sem sentido.
|
|
23
|
+
- Média: Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate 1000+ linhas em código ou contrato governado como refatoração provável; se o payload inline passar de 262144 caracteres, separe HTML, estilos, estado, renderização, cálculo e dados antes de sincronizar.
|
|
24
|
+
- Forte: Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift, orçamento governado de 2000 linhas e finalizar-mudanca. Contexto grande não autoriza monólito nem payload inline acima de 262144 caracteres.
|
|
25
25
|
|
|
26
26
|
## Payload e Transporte MCP
|
|
27
27
|
|
|
@@ -71,8 +71,8 @@ Use para Copilot em modo simples, Cline/Roo com pouco contexto, modelos locais p
|
|
|
71
71
|
- Não abrir AST/IR completos no começo.
|
|
72
72
|
- Não editar se Sema não respondeu.
|
|
73
73
|
- Não pedir para MCP remoto ler pasta local.
|
|
74
|
-
- Não criar
|
|
75
|
-
- Não fatiar
|
|
74
|
+
- Não criar código ou contrato governado grande; divida antes de passar de 2000 linhas.
|
|
75
|
+
- Não fatiar código ou contrato grande em partes artificiais; divida por responsabilidade real.
|
|
76
76
|
- Não aceitar score ou achado como prova sem evidência concreta.
|
|
77
77
|
|
|
78
78
|
## Média
|
|
@@ -82,7 +82,7 @@ Use para agentes com bom contexto, mas sem garantia de seguir todos os gates.
|
|
|
82
82
|
- Entrada: `SEMA_BOOT.md` -> `AGENT_CONTEXT_PACK.json` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json`.
|
|
83
83
|
- Rodar docs-impacto antes de agir.
|
|
84
84
|
- Validar drift e contrato no fechamento.
|
|
85
|
-
- Tratar
|
|
85
|
+
- Tratar 1000+ linhas em código ou contrato governado como sinal de refatoração e 2000+ como bloqueio.
|
|
86
86
|
- Em UI ou HTML estático, separar estrutura, estilos, estado, cálculo, renderização e dados antes de sincronizar.
|
|
87
87
|
- Verificar se score, achados e decisão correspondem a regra real, não só termo copiado.
|
|
88
88
|
|
package/docs/cli.md
CHANGED
|
@@ -20,6 +20,7 @@ Use it for local-agent work:
|
|
|
20
20
|
- resolve documentation gates;
|
|
21
21
|
- run profile and pipeline validators;
|
|
22
22
|
- generate derived artifacts for TypeScript, Python, Dart, Lua, JavaScript, HTML, and CSS;
|
|
23
|
+
- initialize a new project with `AGENTS.md`, `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_INDEX.json`, `docs/sintaxe.md`, `docs/fluxo-pratico-ia-sema.md`, and `exemplos/`;
|
|
23
24
|
- execute local or VPS-side project actions.
|
|
24
25
|
|
|
25
26
|
The key installer from the site installs Node/npm when missing, installs the CLI, and saves `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL`, and compatibility MCP env vars. In a local IDE, the agent must first run `sema --version`. If it fails, the agent stops and asks the human to open the Sema panel and run the key installer. If `preflight` returns anything other than `decisao=use_cli_local`, stop. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` just to read a local workspace.
|
|
@@ -56,6 +57,7 @@ Use a CLI para trabalho de agente local:
|
|
|
56
57
|
- resolver gates de documentação;
|
|
57
58
|
- rodar validadores de profiles e pipelines;
|
|
58
59
|
- gerar artefatos derivados para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS;
|
|
60
|
+
- iniciar projeto novo com `AGENTS.md`, `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_INDEX.json`, `docs/sintaxe.md`, `docs/fluxo-pratico-ia-sema.md` e `exemplos/`;
|
|
59
61
|
- executar ações locais ou na VPS.
|
|
60
62
|
|
|
61
63
|
O instalador do site instala Node/npm quando faltar, instala a CLI e grava `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` e variáveis MCP de compatibilidade. Se o `preflight` retornar qualquer coisa diferente de `decisao=use_cli_local`, pare. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` só para ler workspace local.
|
|
@@ -93,6 +95,7 @@ Usa la CLI para trabajo de agente local:
|
|
|
93
95
|
- resolver gates de documentación;
|
|
94
96
|
- ejecutar validadores de profiles y pipelines;
|
|
95
97
|
- generar artefactos derivados para TypeScript, Python, Dart, Lua, JavaScript, HTML y CSS;
|
|
98
|
+
- iniciar un proyecto nuevo con `AGENTS.md`, `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_INDEX.json`, `docs/sintaxe.md`, `docs/fluxo-pratico-ia-sema.md` y `exemplos/`;
|
|
96
99
|
- ejecutar acciones locales o en la VPS.
|
|
97
100
|
|
|
98
101
|
El instalador del sitio instala Node/npm cuando falten, instala la CLI y guarda `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` y variables MCP de compatibilidad. En una IDE local, el agente debe ejecutar primero `sema --version`. Si falla, para y pide al humano que abra el panel Sema y ejecute el instalador de clave. Si `preflight` devuelve algo distinto de `decisao=use_cli_local`, para. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` solo para leer un workspace local.
|