@semacode/cli 2.3.0 → 2.3.1

package/docs/documentation.md

@@ -1,48 +1,39 @@
-# Documentation Governance
-
-Documentation is part of every governed change. Codex must use
-`sema docs-impacto` before editing contracts, code, operational docs, workflows,
-profiles, generated artifacts, or release material.
-
-Public Sema documentation is English and local-only.
-
-## Required Flow
-
-```bash
-sema docs-impacto --intencao "describe the change" --json
-```
-
-The result lists:
-
-- `leituraObrigatoria`: files that must be read before the change;
-- `docsAusentes`: missing docs that block the change;
-- `docsCriadas`: generated draft docs that must be completed by Codex;
-- `bloqueios`: blocking diagnostics.
-
-Before closing the change, prove the required docs were read:
-
-```bash
-sema finalizar-mudanca \
-  --intencao "describe the change" \
-  --doc-lida README.md \
-  --doc-lida docs/documentation.md \
-  --json
-```
-
-## Public Docs Rules
-
-- Write public docs in English.
-- Keep commands, file paths, package names, environment variable names, and DSL
-  keywords literal.
-- Do not include private or sensitive operational material.
-- Prefer local CLI examples.
-- Point support requests to suporte@otimitare.online.
+# Documentation Governance
+
+Documentation is part of every governed change. Codex must use
+`sema docs-impacto` before editing contracts, code, operational docs, workflows,
+profiles, generated artifacts, or release material.
+
+Public Sema documentation is English and local-only.
+
+## Required Flow
+
+```bash
+sema docs-impacto --intencao "describe the change" --json
+```
 
-## Contract Split Plan
+The result lists:
 
-`contratos/sema/governanca_ia_documentacao.sema` is close to the 500-line
-blocking limit. Before adding another documentation capability, split it by
-responsibility into contracts for required-document resolution, localization,
-and change-finalization evidence. Preserve the existing task names, guarantees,
-implementations, and links; the contracts may continue to govern the same CLI
-files through multiple `vinculos`. Do not create numbered part files.
+- `leituraObrigatoria`: files that must be read before the change;
+- `docsAusentes`: missing docs that block the change;
+- `docsCriadas`: generated draft docs that must be completed by Codex;
+- `bloqueios`: blocking diagnostics.
+
+Before closing the change, prove the required docs were read:
+
+```bash
+sema finalizar-mudanca \
+  --intencao "describe the change" \
+  --doc-lida README.md \
+  --doc-lida docs/documentation.md \
+  --json
+```
+
+## Public Docs Rules
+
+- Write public docs in English.
+- Keep commands, file paths, package names, environment variable names, and DSL
+  keywords literal.
+- Do not include private or sensitive operational material.
+- Prefer local CLI examples.
+- Point support requests to suporte@otimitare.online.

package/docs/env.md

@@ -1,16 +1,16 @@
-# Environment
-
-The public Sema CLI works without private service credentials. No environment
-variable unlocks local execution: there is no login, activation, product
-authorization, license-key, billing, credit, token, or panel gate.
-
-Allowed public examples may use placeholders:
-
-```bash
-EXAMPLE_API_KEY=replace-me
-```
-
-Do not publish private or sensitive operational material in public Sema docs.
-
-If an application governed by Sema needs environment variables, document them in
-that application repository.
+# Environment
+
+The public Sema CLI works without private service credentials. No environment
+variable unlocks local execution: there is no login, activation, product
+authorization, license-key, billing, credit, token, or panel gate.
+
+Allowed public examples may use placeholders:
+
+```bash
+EXAMPLE_API_KEY=replace-me
+```
+
+Do not publish private or sensitive operational material in public Sema docs.
+
+If an application governed by Sema needs environment variables, document them in
+that application repository.

package/docs/frontend.md

@@ -1,41 +1,41 @@
-# User Experience Quality
-
-When Sema governs a UI, dashboard, app, site, game, or terminal tool, the
-experience must be modern, contextual, and verified. This is a quality gate, not
-decoration.
-
-## Before Building
-
-Define:
-
-- audience and domain
-- primary workflow
-- density and information hierarchy
-- interaction states
-- responsive behavior
-- accessibility basics
-- evidence needed before closing
-
-## Browser Evidence
-
-For web UI, check desktop and mobile. On a narrow viewport such as 390px, this
-must be true:
-
-```js
-document.documentElement.scrollWidth <= document.documentElement.clientWidth
-```
-
-Fix overlapping text, broken wrapping, hidden controls, and incoherent layout
-before closing the change.
-
-## Terminal Evidence
-
-For CLI/TUI work, smoke-check:
-
-- `--help`
-- success output
-- error output
-- JSON output when supported
-
-The public Sema CLI itself must stay local-only and must not depend on private
-or sensitive operational material for these checks.
+# User Experience Quality
+
+When Sema governs a UI, dashboard, app, site, game, or terminal tool, the
+experience must be modern, contextual, and verified. This is a quality gate, not
+decoration.
+
+## Before Building
+
+Define:
+
+- audience and domain
+- primary workflow
+- density and information hierarchy
+- interaction states
+- responsive behavior
+- accessibility basics
+- evidence needed before closing
+
+## Browser Evidence
+
+For web UI, check desktop and mobile. On a narrow viewport such as 390px, this
+must be true:
+
+```js
+document.documentElement.scrollWidth <= document.documentElement.clientWidth
+```
+
+Fix overlapping text, broken wrapping, hidden controls, and incoherent layout
+before closing the change.
+
+## Terminal Evidence
+
+For CLI/TUI work, smoke-check:
+
+- `--help`
+- success output
+- error output
+- JSON output when supported
+
+The public Sema CLI itself must stay local-only and must not depend on private
+or sensitive operational material for these checks.

package/docs/getting-started.md

@@ -1,57 +1,57 @@
-# Installation And First Use
-
-Sema is installed and used as a local CLI.
-
-```bash
-npm install -g @semacode/cli
-codex plugin marketplace add gerlanss/Sema
-codex plugin add sema@sema
-```
-
-Open a new Codex task in the target repository so the newly installed `$sema`
-skill is loaded, then ask it to initialize Sema. Existing tasks do not refresh
-their skill catalog. After bootstrap, `AGENTS.md` becomes the automatic protocol
-for subsequent tasks.
-
-Then verify the local engine:
-
-```bash
-sema --version
-sema resumo
-```
-
-The CLI is ready when `sema --version` succeeds. No Sema login, user
-authorization, activation key, product-license check, token, credits, billing
-service, or control panel is involved.
-
-The Codex skill is required for first contact with a project that does not yet
-have Sema. It only bootstraps the local CLI and generates the repository's
-`AGENTS.md`; that file becomes the automatic workspace protocol afterward.
-Plugin installation is explicit and does not happen from npm lifecycle scripts.
-
-## First Project
-
-```bash
-sema iniciar --template base
-sema validar contratos/*.sema --json
-sema resumo
-```
-
-`sema iniciar` preserves existing project files and refuses symlink or junction
-escapes. The bootstrap skill never uses `--force`; explicit overwrite remains a
-human decision.
-
-## Existing Project
-
-```bash
-sema resumo
-sema docs-impacto --intencao "describe the change" --json
-sema inspecionar contratos/example.sema --json
-sema drift contratos/example.sema --escopo modulo --json
-sema impacto contratos/example.sema --alvo sema.example.target --mudanca "describe the change" --json
-```
-
-The public CLI does not require private service credentials or an external
-request before local commands run.
-
-Support: suporte@otimitare.online
+# Installation And First Use
+
+Sema is installed and used as a local CLI.
+
+```bash
+npm install -g @semacode/cli
+codex plugin marketplace add gerlanss/Sema
+codex plugin add sema@sema
+```
+
+Open a new Codex task in the target repository so the newly installed `$sema`
+skill is loaded, then ask it to initialize Sema. Existing tasks do not refresh
+their skill catalog. After bootstrap, `AGENTS.md` becomes the automatic protocol
+for subsequent tasks.
+
+Then verify the local engine:
+
+```bash
+sema --version
+sema resumo
+```
+
+The CLI is ready when `sema --version` succeeds. No Sema login, user
+authorization, activation key, product-license check, token, credits, billing
+service, or control panel is involved.
+
+The Codex skill is required for first contact with a project that does not yet
+have Sema. It only bootstraps the local CLI and generates the repository's
+`AGENTS.md`; that file becomes the automatic workspace protocol afterward.
+Plugin installation is explicit and does not happen from npm lifecycle scripts.
+
+## First Project
+
+```bash
+sema iniciar --template base
+sema validar contratos/*.sema --json
+sema resumo
+```
+
+`sema iniciar` preserves existing project files and refuses symlink or junction
+escapes. The bootstrap skill never uses `--force`; explicit overwrite remains a
+human decision.
+
+## Existing Project
+
+```bash
+sema resumo
+sema docs-impacto --intencao "describe the change" --json
+sema inspecionar contratos/example.sema --json
+sema drift contratos/example.sema --escopo modulo --json
+sema impacto contratos/example.sema --alvo sema.example.target --mudanca "describe the change" --json
+```
+
+The public CLI does not require private service credentials or an external
+request before local commands run.
+
+Support: suporte@otimitare.online

package/docs/i18n.md

@@ -1,15 +1,15 @@
-# Language And Identifiers
-
-Public Sema documentation is English.
-
-Do not translate commands, file paths, package names, endpoint paths, environment
-variable names, code symbols, DSL keywords, or brand names.
-
-Examples:
-
-- Keep `sema validar`, not an English paraphrase.
-- Keep `.sema`, `task`, `input`, `output`, `rules`, `effects`, and `guarantees`.
-- Keep package names such as `@semacode/cli`.
-
-Human-facing prose should be clear English. Contract DSL can keep its own
-keywords and domain identifiers.
+# Language And Identifiers
+
+Public Sema documentation is English.
+
+Do not translate commands, file paths, package names, endpoint paths, environment
+variable names, code symbols, DSL keywords, or brand names.
+
+Examples:
+
+- Keep `sema validar`, not an English paraphrase.
+- Keep `.sema`, `task`, `input`, `output`, `rules`, `effects`, and `guarantees`.
+- Keep package names such as `@semacode/cli`.
+
+Human-facing prose should be clear English. Contract DSL can keep its own
+keywords and domain identifiers.