@semacode/cli 3.8.2 → 3.8.4

package/dist/agentEntryPoints.js

@@ -153,8 +153,9 @@ Você está em um projeto governado por Sema. O contrato semântico vem antes de
 5. Este boot é para workspace local em disco; se não houver workspace local, pare bloqueado em vez de inventar caminho.
 6. Antes de criar módulo, rota, task ou contrato, inspecione o contrato \`.sema\` aplicável.
 7. Antes de editar código existente, rode \`sema drift --cache fresh\` e impacto pela CLI local.
-8. Antes de criar ou corrigir \`.sema\`, use os exemplos oficiais na CLI local.
-9. Se qualquer etapa falhar, pare e diga que está bloqueado.
+8. Para módulo novo com contrato validado, gere o andaime com \`sema compilar\` no alvo padrão, preencha a implementação real mantendo \`impl\`/\`vinculos\` e feche com \`sema verificar\`.
+9. Antes de criar ou corrigir \`.sema\`, use os exemplos oficiais na CLI local.
+10. Se qualquer etapa falhar, pare e diga que está bloqueado.
 
 Não substitua esse fluxo por leitura manual de \`AGENTS.md\`, \`README.md\`, busca local, inferência pelo nome do projeto, bom senso ou ferramenta não citada aqui.
 
@@ -446,10 +447,11 @@ Este workspace é governado por Sema. Antes de qualquer ação em código, contr
 5. Não use fonte externa de workspace para substituir a CLI local quando ela estiver operacional.
 6. Chame docs-impacto com a intenção declarada antes de agir.
 7. Chame inspecionar no contrato \`.sema\` aplicável.
-8. Antes de editar código existente, rode \`sema drift --cache fresh\` e impacto.
-9. Antes de criar ou editar \`.sema\`, use exemplos oficiais.
-10. Ao concluir mudança de contrato, rode validar.
-11. Antes de finalizar, use finalizar-mudanca com as docs lidas.
+8. Para módulo novo com contrato validado, gere o andaime com \`sema compilar <contrato> --alvo <alvoPadrao>\`, preencha a implementação real mantendo \`impl\`/\`vinculos\` e feche com \`sema verificar\`.
+9. Antes de editar código existente, rode \`sema drift --cache fresh\` e impacto.
+10. Antes de criar ou editar \`.sema\`, use exemplos oficiais.
+11. Ao concluir mudança de contrato, rode validar.
+12. Antes de finalizar, use finalizar-mudanca com as docs lidas.
 
 É proibido substituir esse fluxo por leitura manual de \`AGENTS.md\`, \`README.md\`, busca local por arquivos, inferência pelo nome do projeto, bom senso ou ferramenta não citada nesta lista.
 
@@ -657,8 +659,9 @@ This is the minimum workflow for Codex in a local workspace.
 7. If the right capability is unclear, run \`sema descobrir recomendar --intencao "<goal>" --json\`; do not auto-run ambiguous recommendations.
 8. Use \`exemplos/\` and \`docs/syntax.md\` before creating or editing a contract.
 9. Run \`sema drift --cache fresh\` and \`sema impacto\` before editing existing code.
-10. Run \`sema formatar\` and \`sema validar\` after changing a \`.sema\` contract.
-11. Run \`sema finalizar-mudanca\` with the documents read before closure.
+10. For a new module with a validated contract, scaffold with \`sema compilar <contract> --alvo <default target>\`, fill the real implementation keeping \`impl\`/\`vinculos\`, and close with \`sema verificar\`.
+11. Run \`sema formatar\` and \`sema validar\` after changing a \`.sema\` contract.
+12. Run \`sema finalizar-mudanca\` with the documents read before closure.
 
 Contract edit rule: \`.sema\` has its own size budget. Above ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA} lines, plan a split by domain/capability; above ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA}, do not create or edit before splitting. Do not use parte_1/parte_2 and do not force a 1:1 contract-to-file relationship; several contracts can govern the same file through \`vinculos\`.
 

package/dist/driftEscopo.js

@@ -277,6 +277,40 @@ function candidatosRotasDeterministicos(contexto, irs, diretoriosCodigo) {
     }
     return [...candidatos.values()];
 }
+function candidatosRotasNextDeterministicos(contexto, irs, diretoriosCodigo) {
+    const candidatos = new Map();
+    const extensoes = [".ts", ".tsx", ".js", ".jsx"];
+    for (const ir of irs) {
+        for (const rota of ir.routes) {
+            const caminho = (rota.caminho ?? "").trim();
+            if (!caminho.startsWith("/")) {
+                continue;
+            }
+            const segmentos = caminho.split("/").filter(Boolean).map((segmento) => segmento.replace(/^\{(.+)\}$/u, "[$1]").replace(/^:(.+)$/u, "[$1]"));
+            if (segmentos.length === 0) {
+                continue;
+            }
+            const ultimo = segmentos.at(-1);
+            const intermediarios = segmentos.slice(0, -1);
+            const segmentosApi = segmentos[0] === "api" ? segmentos.slice(1) : segmentos;
+            const ultimoApi = segmentosApi.length > 0 ? segmentosApi.at(-1) : undefined;
+            const intermediariosApi = segmentosApi.length > 0 ? segmentosApi.slice(0, -1) : [];
+            for (const raiz of diretoriosCodigo) {
+                for (const extensao of extensoes) {
+                    // Next.js App Router: src/app/<caminho>/route.ts e app/<caminho>/route.ts
+                    adicionarCandidatoPreservandoForma(candidatos, contexto.baseProjeto, path.resolve(raiz, "src", "app", ...segmentos, `route${extensao}`));
+                    adicionarCandidatoPreservandoForma(candidatos, contexto.baseProjeto, path.resolve(raiz, "app", ...segmentos, `route${extensao}`));
+                    // Next.js Pages Router API: src/pages/api/<caminho>.ts e pages/api/<caminho>.ts
+                    if (ultimoApi !== undefined) {
+                        adicionarCandidatoPreservandoForma(candidatos, contexto.baseProjeto, path.resolve(raiz, "src", "pages", "api", ...intermediariosApi, `${ultimoApi}${extensao}`));
+                        adicionarCandidatoPreservandoForma(candidatos, contexto.baseProjeto, path.resolve(raiz, "pages", "api", ...intermediariosApi, `${ultimoApi}${extensao}`));
+                    }
+                }
+            }
+        }
+    }
+    return [...candidatos.values()];
+}
 function candidatosConvencionaisEscopo(contexto, irs, diretoriosCodigo) {
     const candidatos = new Map();
     const adicionar = (caminho) => {
@@ -414,6 +448,7 @@ export async function planejarEscopoDrift(contexto, configuracao) {
         const candidatosDeterministicos = [
             ...candidatosConsumerDeterministicos(contexto, irs, configuracao.termosEscopo, raizesAncoradas),
             ...candidatosRotasDeterministicos(contexto, irs, raizesAncoradas),
+            ...candidatosRotasNextDeterministicos(contexto, irs, raizesAncoradas),
             ...candidatosConvencionaisEscopo(contexto, irs, raizesAncoradas),
         ];
         const sondagensDeterministicas = await sondarArquivosRegularesContidos(candidatosDeterministicos, raizReal);

package/docs/ai-workflow.md

@@ -12,8 +12,9 @@ This is the minimum workflow for Codex in a local workspace.
 7. If the right capability is unclear, run `sema descobrir recomendar --intencao "<goal>" --json`; do not auto-run ambiguous recommendations.
 8. Use `exemplos/` and `docs/syntax.md` before creating or editing a contract.
 9. Run `sema drift --cache fresh` and `sema impacto` before editing existing code.
-10. Run `sema formatar` and `sema validar` after changing a `.sema` contract.
-11. Run `sema finalizar-mudanca` with the documents read before closure.
+10. For a new module with a validated contract, scaffold with `sema compilar <contract> --alvo <default target>`, fill the real implementation keeping `impl`/`vinculos`, and close with `sema verificar`.
+11. Run `sema formatar` and `sema validar` after changing a `.sema` contract.
+12. Run `sema finalizar-mudanca` with the documents read before closure.
 
 Contract edit rule: `.sema` has its own size budget. Above 300 lines, plan a split by domain/capability; above 500, do not create or edit before splitting. Do not use parte_1/parte_2 and do not force a 1:1 contract-to-file relationship; several contracts can govern the same file through `vinculos`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semacode/cli",
-  "version": "3.8.2",
+  "version": "3.8.4",
   "description": "Local-first semantic governance CLI for AI agents, proven with Claude, Codex, zCode (GLM) and Kimi: contracts, drift, impact, docs gates, and code generation.",
   "type": "module",
   "icon": "logo.png",