@semacode/cli 1.5.27 → 1.5.28
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/README.md +3 -3
- package/SEMA_BRIEF.curto.txt +2 -2
- package/SEMA_BRIEF.md +2 -2
- package/SEMA_BRIEF.micro.txt +1 -1
- package/SEMA_INDEX.json +20 -18
- package/docs/cli.md +4 -4
- package/docs/deploy.md +93 -0
- package/docs/env.md +3 -3
- package/docs/instalacao-e-primeiro-uso.md +5 -5
- package/docs/persistencia-vendor-first.md +1 -1
- package/docs/rollback.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/package.json +1 -1
- package/node_modules/@sema/padroes/package.json +1 -1
- package/package.json +10 -10
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
It validates `.sema` contracts, checks semantic drift against live code, maps impact, prepares AI-first context, enforces documentation gates, and validates the official Sema profiles: Software, Workflow/Ops, Author, Game, Legal, and Research.
|
|
8
8
|
|
|
9
|
-
Current public version: `1.5.
|
|
9
|
+
Current public version: `1.5.28`.
|
|
10
10
|
|
|
11
11
|
### Install
|
|
12
12
|
|
|
@@ -52,7 +52,7 @@ The command stores the commercial MCP key in the local user environment as `SEMA
|
|
|
52
52
|
|
|
53
53
|
Ele valida contratos `.sema`, verifica drift semântico contra código vivo, mapeia impacto, prepara contexto IA-first, aplica gates de documentação e valida os profiles oficiais da Sema: Software, Workflow/Ops, Author, Game, Legal e Research.
|
|
54
54
|
|
|
55
|
-
Versão pública atual: `1.5.
|
|
55
|
+
Versão pública atual: `1.5.28`.
|
|
56
56
|
|
|
57
57
|
### Instalar
|
|
58
58
|
|
|
@@ -98,7 +98,7 @@ O comando grava a chave MCP comercial no ambiente local do usuário como `SEMA_M
|
|
|
98
98
|
|
|
99
99
|
Valida contratos `.sema`, verifica drift semántico contra código vivo, mapea impacto, prepara contexto IA-first, aplica gates de documentación y valida los profiles oficiales de Sema: Software, Workflow/Ops, Author, Game, Legal y Research.
|
|
100
100
|
|
|
101
|
-
Versión pública actual: `1.5.
|
|
101
|
+
Versión pública actual: `1.5.28`.
|
|
102
102
|
|
|
103
103
|
### Instalar
|
|
104
104
|
|
package/SEMA_BRIEF.curto.txt
CHANGED
|
@@ -7,5 +7,5 @@ ENTRADA_IA: llms.txt -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md ->
|
|
|
7
7
|
TOP_MODULOS: app.pedidos, sema.produto.author, sema.produto.ergonomia_e_dominio, sema.produto.fronteira_repositorios, sema.produto.game, sema.produto.geradores_web (+7)
|
|
8
8
|
TOP_RISCOS: altera_persistencia, assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio, classificar_artefato_repositorio:medio, comparar_diff_semantico_author:medio, consultar_scorecard_compatibilidade:medio (+35)
|
|
9
9
|
TOP_LACUNAS: execucao_implicita, sem_impl, vinculo_quebrado
|
|
10
|
-
TOP_ARQUIVOS: C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\
|
|
11
|
-
GERADO_EM: 2026-05-
|
|
10
|
+
TOP_ARQUIVOS: C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\env.md, C:\GitHub\Sema\docs\mcp.md, C:\GitHub\Sema\docs\README.md (+19)
|
|
11
|
+
GERADO_EM: 2026-05-18T23:17:36.000Z
|
package/SEMA_BRIEF.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
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-05-
|
|
5
|
+
- Gerado em: `2026-05-18T23:17:36.000Z`
|
|
6
6
|
- Modulos: `13`
|
|
7
7
|
|
|
8
8
|
## Entrada canonica para IA
|
|
@@ -44,7 +44,7 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
|
|
|
44
44
|
### sema.produto.fronteira_repositorios
|
|
45
45
|
- Faz: governa 2 task(s) com foco em classificar artefato repositorio
|
|
46
46
|
- Publico: nenhum
|
|
47
|
-
- Tocar: C:\GitHub\Sema\docs\repositories.md, C:\GitHub\Sema\scripts\verificar-fronteira-publica.mjs
|
|
47
|
+
- Tocar: C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\repositories.md, C:\GitHub\Sema\scripts\verificar-fronteira-publica.mjs
|
|
48
48
|
- Score: 93 | Confianca: alta | Risco: alto
|
|
49
49
|
- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
|
|
50
50
|
|
package/SEMA_BRIEF.micro.txt
CHANGED
|
@@ -6,4 +6,4 @@ ENTRADA_IA: llms.txt -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
|
|
|
6
6
|
TOP_MODULOS: app.pedidos, sema.produto.author, sema.produto.ergonomia_e_dominio (+10)
|
|
7
7
|
TOP_RISCOS: altera_persistencia, assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio (+38)
|
|
8
8
|
TOP_LACUNAS: execucao_implicita, sem_impl, vinculo_quebrado
|
|
9
|
-
GERADO_EM: 2026-05-
|
|
9
|
+
GERADO_EM: 2026-05-18T23:17:36.000Z
|
package/SEMA_INDEX.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"comando": "resumo-projeto",
|
|
3
|
-
"geradoEm": "2026-05-
|
|
4
|
-
"cliVersao": "1.5.
|
|
3
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
4
|
+
"cliVersao": "1.5.28",
|
|
5
5
|
"baseProjeto": "C:\\GitHub\\Sema",
|
|
6
6
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
7
7
|
"fontesConclusao": [
|
|
@@ -182,7 +182,7 @@
|
|
|
182
182
|
},
|
|
183
183
|
"modulos": [
|
|
184
184
|
{
|
|
185
|
-
"geradoEm": "2026-05-
|
|
185
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
186
186
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\pedidos.sema",
|
|
187
187
|
"modulo": "app.pedidos",
|
|
188
188
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -262,7 +262,7 @@
|
|
|
262
262
|
]
|
|
263
263
|
},
|
|
264
264
|
{
|
|
265
|
-
"geradoEm": "2026-05-
|
|
265
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
266
266
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\author.sema",
|
|
267
267
|
"modulo": "sema.produto.author",
|
|
268
268
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -387,7 +387,7 @@
|
|
|
387
387
|
]
|
|
388
388
|
},
|
|
389
389
|
{
|
|
390
|
-
"geradoEm": "2026-05-
|
|
390
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
391
391
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\ergonomia_e_dominio.sema",
|
|
392
392
|
"modulo": "sema.produto.ergonomia_e_dominio",
|
|
393
393
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -497,7 +497,7 @@
|
|
|
497
497
|
]
|
|
498
498
|
},
|
|
499
499
|
{
|
|
500
|
-
"geradoEm": "2026-05-
|
|
500
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
501
501
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\fronteira_repositorios.sema",
|
|
502
502
|
"modulo": "sema.produto.fronteira_repositorios",
|
|
503
503
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -549,6 +549,7 @@
|
|
|
549
549
|
"TipoRepositorioSema"
|
|
550
550
|
],
|
|
551
551
|
"arquivosProvaveis": [
|
|
552
|
+
"C:\\GitHub\\Sema\\docs\\deploy.md",
|
|
552
553
|
"C:\\GitHub\\Sema\\docs\\repositories.md",
|
|
553
554
|
"C:\\GitHub\\Sema\\scripts\\verificar-fronteira-publica.mjs"
|
|
554
555
|
],
|
|
@@ -567,12 +568,12 @@
|
|
|
567
568
|
"vinculo_quebrado"
|
|
568
569
|
],
|
|
569
570
|
"inferido": [
|
|
571
|
+
"classificar_artefato_repositorio:docs/deploy.md",
|
|
570
572
|
"classificar_artefato_repositorio:docs/repositories.md",
|
|
571
573
|
"classificar_artefato_repositorio:scripts/verificar-fronteira-publica.mjs",
|
|
574
|
+
"sema.produto.fronteira_repositorios:docs/deploy.md",
|
|
572
575
|
"sema.produto.fronteira_repositorios:docs/repositories.md",
|
|
573
|
-
"sema.produto.fronteira_repositorios:scripts/verificar-fronteira-publica.mjs"
|
|
574
|
-
"verificar_indice_git_publico:docs/repositories.md",
|
|
575
|
-
"verificar_indice_git_publico:scripts/verificar-fronteira-publica.mjs"
|
|
576
|
+
"sema.produto.fronteira_repositorios:scripts/verificar-fronteira-publica.mjs"
|
|
576
577
|
],
|
|
577
578
|
"checksSugeridos": [
|
|
578
579
|
"confirmar proibicoes operacionais",
|
|
@@ -593,12 +594,13 @@
|
|
|
593
594
|
"consumerBridges": [],
|
|
594
595
|
"ancoragensVinculo": [],
|
|
595
596
|
"arquivosProvaveisEditar": [
|
|
597
|
+
"C:\\GitHub\\Sema\\docs\\deploy.md",
|
|
596
598
|
"C:\\GitHub\\Sema\\docs\\repositories.md",
|
|
597
599
|
"C:\\GitHub\\Sema\\scripts\\verificar-fronteira-publica.mjs"
|
|
598
600
|
]
|
|
599
601
|
},
|
|
600
602
|
{
|
|
601
|
-
"geradoEm": "2026-05-
|
|
603
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
602
604
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\game.sema",
|
|
603
605
|
"modulo": "sema.produto.game",
|
|
604
606
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -690,7 +692,7 @@
|
|
|
690
692
|
]
|
|
691
693
|
},
|
|
692
694
|
{
|
|
693
|
-
"geradoEm": "2026-05-
|
|
695
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
694
696
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\geradores_web.sema",
|
|
695
697
|
"modulo": "sema.produto.geradores_web",
|
|
696
698
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -794,7 +796,7 @@
|
|
|
794
796
|
]
|
|
795
797
|
},
|
|
796
798
|
{
|
|
797
|
-
"geradoEm": "2026-05-
|
|
799
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
798
800
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\governanca_ia.sema",
|
|
799
801
|
"modulo": "sema.produto.governanca_ia",
|
|
800
802
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -943,7 +945,7 @@
|
|
|
943
945
|
]
|
|
944
946
|
},
|
|
945
947
|
{
|
|
946
|
-
"geradoEm": "2026-05-
|
|
948
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
947
949
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\legal.sema",
|
|
948
950
|
"modulo": "sema.produto.legal",
|
|
949
951
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -1028,7 +1030,7 @@
|
|
|
1028
1030
|
]
|
|
1029
1031
|
},
|
|
1030
1032
|
{
|
|
1031
|
-
"geradoEm": "2026-05-
|
|
1033
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
1032
1034
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\linguagem_composta.sema",
|
|
1033
1035
|
"modulo": "sema.produto.linguagem_composta",
|
|
1034
1036
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -1141,7 +1143,7 @@
|
|
|
1141
1143
|
]
|
|
1142
1144
|
},
|
|
1143
1145
|
{
|
|
1144
|
-
"geradoEm": "2026-05-
|
|
1146
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
1145
1147
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\persistencia_vendor_first.sema",
|
|
1146
1148
|
"modulo": "sema.produto.persistencia_vendor_first",
|
|
1147
1149
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -1256,7 +1258,7 @@
|
|
|
1256
1258
|
]
|
|
1257
1259
|
},
|
|
1258
1260
|
{
|
|
1259
|
-
"geradoEm": "2026-05-
|
|
1261
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
1260
1262
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\research.sema",
|
|
1261
1263
|
"modulo": "sema.produto.research",
|
|
1262
1264
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -1346,7 +1348,7 @@
|
|
|
1346
1348
|
]
|
|
1347
1349
|
},
|
|
1348
1350
|
{
|
|
1349
|
-
"geradoEm": "2026-05-
|
|
1351
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
1350
1352
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\software.sema",
|
|
1351
1353
|
"modulo": "sema.produto.software",
|
|
1352
1354
|
"modoVerificacaoCodigo": "codigo_completo",
|
|
@@ -1436,7 +1438,7 @@
|
|
|
1436
1438
|
]
|
|
1437
1439
|
},
|
|
1438
1440
|
{
|
|
1439
|
-
"geradoEm": "2026-05-
|
|
1441
|
+
"geradoEm": "2026-05-18T23:17:36.000Z",
|
|
1440
1442
|
"arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\workflow_ops.sema",
|
|
1441
1443
|
"modulo": "sema.produto.workflow_ops",
|
|
1442
1444
|
"modoVerificacaoCodigo": "codigo_completo",
|
package/docs/cli.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
The Sema CLI is the public npm package for local semantic governance. It validates `.sema` contracts, checks drift, maps impact, prepares AI-first context, resolves documentation gates, and runs profile validators before an agent continues.
|
|
6
6
|
|
|
7
|
-
Current public version: `1.5.
|
|
7
|
+
Current public version: `1.5.28`.
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -g @semacode/cli
|
|
@@ -16,7 +16,7 @@ sema validar contratos/pedidos.sema --json
|
|
|
16
16
|
|
|
17
17
|
A CLI da Sema é o pacote público no npm para governança semântica local. Ela valida contratos `.sema`, verifica drift, mapeia impacto, prepara contexto IA-first, resolve gates de documentação e roda validadores de profiles antes de um agente continuar.
|
|
18
18
|
|
|
19
|
-
Versão pública atual: `1.5.
|
|
19
|
+
Versão pública atual: `1.5.28`.
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
22
|
npm install -g @semacode/cli
|
|
@@ -28,7 +28,7 @@ sema validar contratos/pedidos.sema --json
|
|
|
28
28
|
|
|
29
29
|
La CLI de Sema es el paquete público en npm para gobernanza semántica local. Valida contratos `.sema`, verifica drift, mapea impacto, prepara contexto IA-first, resuelve gates de documentación y ejecuta validadores de profiles antes de que un agente continúe.
|
|
30
30
|
|
|
31
|
-
Versión pública actual: `1.5.
|
|
31
|
+
Versión pública actual: `1.5.28`.
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
34
|
npm install -g @semacode/cli
|
|
@@ -76,7 +76,7 @@ Adoção incremental:
|
|
|
76
76
|
|
|
77
77
|
## Persistência vendor-first
|
|
78
78
|
|
|
79
|
-
A linha 1.5.
|
|
79
|
+
A linha 1.5.28 mantém persistência vendor-first como seção canônica no contrato, no semântico, na IR e no formatador, além de `drift` com escopo real, `impacto`, renomeação semântica assistida, `verificar` mais coerente nos alvos gerados, match de métodos JS/TS definidos via `Object.assign(...prototype...)`, leitura de `Preferences`/`localStorage`/`sessionStorage`, fallback para `angular-consumer` standalone sem `.routes`, limpeza de runtime da CLI pública no Windows, Sema Author oficial e MCP remoto desmembrado da distribuição pública.
|
|
80
80
|
|
|
81
81
|
Cobertura pública:
|
|
82
82
|
|
package/docs/deploy.md
ADDED
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
# Public Release Runbook
|
|
2
|
+
|
|
3
|
+
<!-- sema:i18n -->
|
|
4
|
+
> EN: English first.
|
|
5
|
+
> PT: Português depois.
|
|
6
|
+
> ES: Español al final.
|
|
7
|
+
|
|
8
|
+
## English
|
|
9
|
+
|
|
10
|
+
This public runbook covers only the open Sema distribution: source repository, npm CLI package, VS Code extension artifact, release notes, checksums, and public install scripts.
|
|
11
|
+
|
|
12
|
+
Private hosting, account panels, OAuth endpoints, Supabase projects, billing flows, service accounts, customer data, server paths, and commercial deployment scripts belong in the private repository.
|
|
13
|
+
|
|
14
|
+
### What Goes Public
|
|
15
|
+
|
|
16
|
+
- Versioned source for the open language, parser, CLI, base profiles, examples, public docs, and basic extension.
|
|
17
|
+
- Public release assets generated under `.tmp/release-assets`.
|
|
18
|
+
- Generic install scripts that do not embed tokens, private URLs, customer identifiers, or server paths.
|
|
19
|
+
- Release notes in this order: English, Portuguese, Spanish.
|
|
20
|
+
|
|
21
|
+
### What Stays Private
|
|
22
|
+
|
|
23
|
+
- Hosted-site code, account panel code, billing, Supabase migrations, OAuth client secrets, MCP key issuing, production Caddy/Nginx files, and server-specific runbooks.
|
|
24
|
+
- Any token, service role, customer identifier, database URL, private endpoint, or local agent configuration.
|
|
25
|
+
- Commercial rule packs and internal dashboards until explicitly approved for public release.
|
|
26
|
+
|
|
27
|
+
### Public Release Checklist
|
|
28
|
+
|
|
29
|
+
1. Run `npm run repo:verificar-publico`.
|
|
30
|
+
2. Run `npm run project:check`.
|
|
31
|
+
3. Run `npm run release:preparar-publica`.
|
|
32
|
+
4. Publish the npm package only after `npm dist-tag ls @semacode/cli` can be checked.
|
|
33
|
+
5. Push `main` and the matching `v<version>` tag.
|
|
34
|
+
6. Create the GitHub Release from `.tmp/release-assets` and mark it as latest.
|
|
35
|
+
7. Confirm the GitHub About description is English and product-facing.
|
|
36
|
+
|
|
37
|
+
## Português
|
|
38
|
+
|
|
39
|
+
Este runbook público cobre apenas a distribuição aberta da Sema: repositório-fonte, pacote npm da CLI, artefato da extensão VS Code, notas de release, checksums e instaladores públicos.
|
|
40
|
+
|
|
41
|
+
Hospedagem privada, painéis de conta, endpoints OAuth, projetos Supabase, billing, service accounts, dados de clientes, caminhos de servidor e scripts comerciais de deploy ficam no repositório privado.
|
|
42
|
+
|
|
43
|
+
### O Que Vai Para o Público
|
|
44
|
+
|
|
45
|
+
- Código versionado da linguagem aberta, parser, CLI, profiles base, exemplos, docs públicas e extensão básica.
|
|
46
|
+
- Assets públicos de release gerados em `.tmp/release-assets`.
|
|
47
|
+
- Instaladores genéricos sem tokens, URLs privadas, identificadores de cliente ou caminhos de servidor.
|
|
48
|
+
- Notas de release nesta ordem: inglês, português, espanhol.
|
|
49
|
+
|
|
50
|
+
### O Que Fica Privado
|
|
51
|
+
|
|
52
|
+
- Código do site hospedado, painel de contas, billing, migrations Supabase, OAuth client secrets, emissão de chaves MCP, Caddy/Nginx de produção e runbooks específicos de servidor.
|
|
53
|
+
- Qualquer token, service role, identificador de cliente, URL de banco, endpoint privado ou configuração local de agentes.
|
|
54
|
+
- Rule packs comerciais e dashboards internos até aprovação explícita para release pública.
|
|
55
|
+
|
|
56
|
+
### Checklist De Release Pública
|
|
57
|
+
|
|
58
|
+
1. Rode `npm run repo:verificar-publico`.
|
|
59
|
+
2. Rode `npm run project:check`.
|
|
60
|
+
3. Rode `npm run release:preparar-publica`.
|
|
61
|
+
4. Publique o pacote npm somente depois de conseguir conferir `npm dist-tag ls @semacode/cli`.
|
|
62
|
+
5. Envie `main` e a tag `v<versão>` correspondente.
|
|
63
|
+
6. Crie o GitHub Release a partir de `.tmp/release-assets` e marque como latest.
|
|
64
|
+
7. Confirme que o About do GitHub está em inglês e com posicionamento de produto.
|
|
65
|
+
|
|
66
|
+
## Español
|
|
67
|
+
|
|
68
|
+
Este runbook público cubre solo la distribución abierta de Sema: repositorio fuente, paquete npm de la CLI, artefacto de la extensión VS Code, notas de release, checksums e instaladores públicos.
|
|
69
|
+
|
|
70
|
+
El hosting privado, los paneles de cuenta, endpoints OAuth, proyectos Supabase, billing, service accounts, datos de clientes, rutas de servidor y scripts comerciales de despliegue pertenecen al repositorio privado.
|
|
71
|
+
|
|
72
|
+
### Qué Va Al Público
|
|
73
|
+
|
|
74
|
+
- Código versionado del lenguaje abierto, parser, CLI, profiles base, ejemplos, docs públicas y extensión básica.
|
|
75
|
+
- Assets públicos de release generados en `.tmp/release-assets`.
|
|
76
|
+
- Instaladores genéricos sin tokens, URLs privadas, identificadores de cliente ni rutas de servidor.
|
|
77
|
+
- Notas de release en este orden: inglés, portugués, español.
|
|
78
|
+
|
|
79
|
+
### Qué Queda Privado
|
|
80
|
+
|
|
81
|
+
- Código del sitio hospedado, panel de cuentas, billing, migrations Supabase, OAuth client secrets, emisión de claves MCP, Caddy/Nginx de producción y runbooks específicos de servidor.
|
|
82
|
+
- Cualquier token, service role, identificador de cliente, URL de base de datos, endpoint privado o configuración local de agentes.
|
|
83
|
+
- Rule packs comerciales y dashboards internos hasta aprobación explícita para release pública.
|
|
84
|
+
|
|
85
|
+
### Checklist De Release Pública
|
|
86
|
+
|
|
87
|
+
1. Ejecuta `npm run repo:verificar-publico`.
|
|
88
|
+
2. Ejecuta `npm run project:check`.
|
|
89
|
+
3. Ejecuta `npm run release:preparar-publica`.
|
|
90
|
+
4. Publica el paquete npm solo después de poder verificar `npm dist-tag ls @semacode/cli`.
|
|
91
|
+
5. Envía `main` y la tag `v<versión>` correspondiente.
|
|
92
|
+
6. Crea el GitHub Release desde `.tmp/release-assets` y márcalo como latest.
|
|
93
|
+
7. Confirma que el About de GitHub está en inglés y con posicionamiento de producto.
|
package/docs/env.md
CHANGED
|
@@ -25,13 +25,13 @@ Ambiente necessário para publicar a Sema.
|
|
|
25
25
|
No PowerShell, o instalador recebe a versão por parametro:
|
|
26
26
|
|
|
27
27
|
```powershell
|
|
28
|
-
.\install-sema.ps1 -Version 1.5.
|
|
28
|
+
.\install-sema.ps1 -Version 1.5.28 -WithVSCode
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
No shell:
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
|
-
SEMA_VERSION=1.5.
|
|
34
|
+
SEMA_VERSION=1.5.28 ./install-sema.sh --with-vscode
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
## Credenciais
|
|
@@ -92,7 +92,7 @@ Nunca publique `/mcp` ou `/sse` na internet sem chave comercial bearer por reque
|
|
|
92
92
|
|
|
93
93
|
## GitHub Release
|
|
94
94
|
|
|
95
|
-
O tag público deve seguir `v<versao>`, por exemplo `v1.5.
|
|
95
|
+
O tag público deve seguir `v<versao>`, por exemplo `v1.5.28`.
|
|
96
96
|
|
|
97
97
|
Os assets ficam em `.tmp/release-assets` e sao derivados dos scripts versionados no repositório.
|
|
98
98
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
This guide covers the current public installation path for the Sema CLI and VS Code extension. The remote MCP server is a private/commercial authorized service and is not distributed as a public npm package.
|
|
6
6
|
|
|
7
|
-
Current public version: `1.5.
|
|
7
|
+
Current public version: `1.5.28`.
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -g @semacode/cli
|
|
@@ -16,7 +16,7 @@ sema doctor
|
|
|
16
16
|
|
|
17
17
|
Este guia cobre o caminho público atual da Sema para CLI e extensão VS Code. O servidor MCP remoto é um serviço privado/comercial autorizado e não é distribuído como pacote npm público.
|
|
18
18
|
|
|
19
|
-
Versão pública atual: `1.5.
|
|
19
|
+
Versão pública atual: `1.5.28`.
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
22
|
npm install -g @semacode/cli
|
|
@@ -28,7 +28,7 @@ sema doctor
|
|
|
28
28
|
|
|
29
29
|
Esta guía cubre el camino público actual de instalación para la CLI de Sema y la extensión de VS Code. El servidor MCP remoto es un servicio privado/comercial autorizado y no se distribuye como paquete público de npm.
|
|
30
30
|
|
|
31
|
-
Versión pública actual: `1.5.
|
|
31
|
+
Versión pública actual: `1.5.28`.
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
34
|
npm install -g @semacode/cli
|
|
@@ -58,7 +58,7 @@ sema docs-impacto --intencao "alterar projeto" --json
|
|
|
58
58
|
Instalação de uma versão específica pelo npm:
|
|
59
59
|
|
|
60
60
|
```bash
|
|
61
|
-
npm install -g @semacode/cli@1.5.
|
|
61
|
+
npm install -g @semacode/cli@1.5.28
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
Instalação local ao projeto:
|
|
@@ -93,7 +93,7 @@ Se quiser uma tag específica, troque `main` pela versão desejada.
|
|
|
93
93
|
|
|
94
94
|
```bash
|
|
95
95
|
npm run extensao:empacotar
|
|
96
|
-
code --install-extension .tmp/editor-vscode/sema-language-tools-1.5.
|
|
96
|
+
code --install-extension .tmp/editor-vscode/sema-language-tools-1.5.28.vsix --force
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
Os assets versionados da VSIX devem ser anexados manualmente a GitHub Releases quando houver release pública com binários. Se `--with-vscode` for usado antes disso, o instalador mantém a CLI instalada e apenas pula a extensão.
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
> ES: Español al final; não traduza comandos, rotas nem sómbolos `.sema` sem contrato.
|
|
7
7
|
|
|
8
8
|
|
|
9
|
-
Sema 1.5.
|
|
9
|
+
Sema 1.5.28 trata banco como superficie semântica de primeira classe. Isso significa assumir diferenças reais entre engines e coloca-las no contrato, no semântico, na IR, no drift, no impact map, na renomeacao assistida, no `verificar` e na extensao. Nesta linha, o `drift` também materializa persistência local real em `Preferences`, `localStorage` e `sessionStorage` quando a task está ancorada no arquivo que usa essas APIs, preservando o framing IA-first da release atual.
|
|
10
10
|
|
|
11
11
|
## Engines publicas
|
|
12
12
|
|
package/docs/rollback.md
CHANGED
|
@@ -25,7 +25,7 @@ npm dist-tag add @semacode/cli@<versao-boa> latest
|
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
3. Se o problema for só VSIX ou asset de release, substitua o asset no GitHub Release ou publique uma release patch.
|
|
28
|
-
4. Prefira publicar patch corretivo (`1.5.
|
|
28
|
+
4. Prefira publicar patch corretivo (`1.5.28`, por exemplo) quando o pacote já saiu para usuários.
|
|
29
29
|
|
|
30
30
|
## Validação de rollback
|
|
31
31
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@semacode/cli",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.28",
|
|
4
4
|
"description": "Semantic governance CLI for AI agents: contracts, drift, impact, documentation gates, and Sema profiles for live systems.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"icon": "logo.png",
|
|
@@ -49,15 +49,15 @@
|
|
|
49
49
|
"LICENSE"
|
|
50
50
|
],
|
|
51
51
|
"dependencies": {
|
|
52
|
-
"@sema/nucleo": "1.5.
|
|
53
|
-
"@sema/gerador-dart": "1.5.
|
|
54
|
-
"@sema/gerador-lua": "1.5.
|
|
55
|
-
"@sema/gerador-python": "1.5.
|
|
56
|
-
"@sema/gerador-typescript": "1.5.
|
|
57
|
-
"@sema/gerador-javascript": "1.5.
|
|
58
|
-
"@sema/gerador-html": "1.5.
|
|
59
|
-
"@sema/gerador-css": "1.5.
|
|
60
|
-
"@sema/padroes": "1.5.
|
|
52
|
+
"@sema/nucleo": "1.5.28",
|
|
53
|
+
"@sema/gerador-dart": "1.5.28",
|
|
54
|
+
"@sema/gerador-lua": "1.5.28",
|
|
55
|
+
"@sema/gerador-python": "1.5.28",
|
|
56
|
+
"@sema/gerador-typescript": "1.5.28",
|
|
57
|
+
"@sema/gerador-javascript": "1.5.28",
|
|
58
|
+
"@sema/gerador-html": "1.5.28",
|
|
59
|
+
"@sema/gerador-css": "1.5.28",
|
|
60
|
+
"@sema/padroes": "1.5.28",
|
|
61
61
|
"typescript": "^5.8.3"
|
|
62
62
|
},
|
|
63
63
|
"bundledDependencies": [
|