@semacode/cli 1.5.11 → 1.5.16

package/README.md

@@ -6,6 +6,9 @@ Ela valida contratos `.sema`, mede `drift` entre contrato e codigo vivo, importa
 
 Lua e suportado como alvo de geracao e como origem semantica de codigo vivo em `use`, `impl`, IR, `drift` e `sema importar`.
 PHP tambem e suportado como origem semantica de codigo vivo em `use`, `impl`, IR, `drift` e `sema importar`, incluindo controllers, funcoes, rotas Laravel/Slim e atributos Symfony/PHP 8.
+`sema author` expoe o profile Author para obra, capitulos, cenas, personagens, continuidade, fontes, estilo, agents e flow editorial.
+O comando tambem expoe `regrasAutomaticas` com o piso geral do Author: mostrar por evidencia, causa e consequencia, cena com dupla funcao, exposicao com atrito, dialogo com subtexto, final sem slogan e anti-cliche adaptativa.
+Em pacotes de contexto e resumos de projeto, os artefatos compactos (`resumo.micro.txt`, `resumo.curto.txt`, `prompt-curto.txt`, `briefing.min.json` e `SEMA_BRIEF.*`) tambem expõem `AUTHOR_RULES_AUTO` para IA pequena nao perder essas regras.
 
 Tambem resolve documentacao obrigatoria por intencao para impedir IA de agir sem ler ou criar docs relacionadas.
 
@@ -70,7 +73,7 @@ Nesta linha, o `drift` tambem passa a resolver melhor metodos JS/TS browser-side
 
 Nesta linha, o `drift` tambem passa a enxergar `Preferences`, `localStorage` e `sessionStorage` como persistencia local real, distinguir `ancoragemVinculo` herdada do modulo e cobrir `angular-consumer` standalone mesmo quando o app nao tem `.routes`.
 
-Nesta linha, o pacote publico da CLI tambem deixa `tsx` fora das dependencias de runtime para evitar ruído de instalacao global no Windows.
+Nesta linha, o `verificar/typescript` tambem deixa de depender de `tsx`: a CLI transpila os testes gerados com `typescript` e roda `node --test`, evitando `fsevents` e `node-gyp` na instalacao global do Windows.
 
 Cobertura publica:
 
@@ -95,6 +98,8 @@ O tarball publico da CLI inclui:
 - `sema drift <arquivo-ou-pasta> --json`
 - `sema resumo <arquivo-ou-pasta> --micro --para onboarding`
 - `sema prompt-curto <arquivo-ou-pasta> --curto --para mudanca`
+- `sema author --help`
+- `sema author exemplo [--sensivel] [--json]`
 - `sema contexto-ia <arquivo.sema> --saida <diretorio> --json`
 - `sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] --json`
 - `sema finalizar-mudanca --intencao <acao> [--doc-lida <caminho>] --json`

package/dist/index.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
+import ts from "typescript";
 import pacoteCli from "../package.json" with { type: "json" };
 import { compilarCodigo, formatarCodigo, formatarDiagnosticos, lerArquivoTexto, temErros, } from "@sema/nucleo";
 import { descreverEstruturaModulo } from "@sema/padroes";
@@ -324,7 +325,6 @@ Comandos uteis da CLI para esse fluxo:
 `;
 const DIRETORIO_CLI_ATUAL = path.dirname(fileURLToPath(import.meta.url));
 const VERSAO_CLI = pacoteCli.version;
-const requireRuntimeCli = createRequire(import.meta.url);
 const ARQUIVOS_CANONICOS_IA_RAIZ = [
     "llms.txt",
     "SEMA_BRIEF.md",
@@ -348,16 +348,6 @@ const DOCUMENTOS_SUPORTE_IA = [
     "docs/rollback.md",
     "docs/extensao-vscode.md",
 ];
-function resolverImportadorNodeOpcional(especificador) {
-    try {
-        return requireRuntimeCli.resolve(especificador);
-    }
-    catch {
-        return undefined;
-    }
-}
-const TSX_IMPORTADOR_CLI = resolverImportadorNodeOpcional("tsx");
-const TSX_EXECUTOR_CLI = resolverImportadorNodeOpcional("tsx/cli");
 async function caminhoEhDiretorio(caminhoAlvo) {
     try {
         return (await stat(caminhoAlvo)).isDirectory();
@@ -496,6 +486,8 @@ function ajuda() {
             "sema prompt-ia-react",
             "sema prompt-ia-sema-primeiro",
             "sema exemplos-prompt-ia",
+            "sema author [--help]",
+            "sema author exemplo [--sensivel] [--json]",
             "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--json]",
             "sema sync-ai-entrypoints [--json]",
             "sema instalar-exemplos [--json]",
@@ -656,11 +648,7 @@ function coletarDependenciasDoctor() {
             comando: "verificar/typescript",
             itens: [
                 criarItemDependencia("node", comandoDisponivel("node"), "execucao do runner TypeScript"),
-                criarItemDependencia("tsx", Boolean(TSX_EXECUTOR_CLI ?? TSX_IMPORTADOR_CLI), TSX_EXECUTOR_CLI
-                    ? `runner resolvido em ${TSX_EXECUTOR_CLI}`
-                    : TSX_IMPORTADOR_CLI
-                        ? `importador resolvido em ${TSX_IMPORTADOR_CLI}`
-                        : "tsx nao foi encontrado junto da CLI"),
+                criarItemDependencia("typescript", typeof ts.transpileModule === "function", `transpilador runtime resolvido em typescript ${ts.version}`),
             ],
         },
         {
@@ -710,11 +698,7 @@ function avaliarPreflightVerificacao(configuracoesAlvo) {
         if (configuracao.alvo === "typescript") {
             registrar("verificar/typescript", [
                 criarItemDependencia("node", comandoDisponivel("node"), "execucao do runner TypeScript"),
-                criarItemDependencia("tsx", Boolean(TSX_EXECUTOR_CLI ?? TSX_IMPORTADOR_CLI), TSX_EXECUTOR_CLI
-                    ? `runner resolvido em ${TSX_EXECUTOR_CLI}`
-                    : TSX_IMPORTADOR_CLI
-                        ? `importador resolvido em ${TSX_IMPORTADOR_CLI}`
-                        : "tsx nao foi encontrado junto da CLI"),
+                criarItemDependencia("typescript", typeof ts.transpileModule === "function", `transpilador runtime resolvido em typescript ${ts.version}`),
             ]);
             continue;
         }
@@ -1001,6 +985,35 @@ function contarCasosDeTesteGerados(alvo, arquivos) {
     }
     return (arquivoTeste.conteudo.match(/\bdef test_/g) ?? []).length;
 }
+function reescreverImportsTypeScriptGerados(codigo) {
+    return codigo
+        .replace(/(from\s+["']\.{1,2}\/[^"']+)\.ts(["'])/g, "$1.cjs$2")
+        .replace(/(require\(\s*["']\.{1,2}\/[^"']+)\.ts(["']\s*\))/g, "$1.cjs$2");
+}
+function compilarTypeScriptGeradoParaNodeTest(baseSaida, arquivos, arquivoTeste) {
+    const pastaRuntime = path.join(baseSaida, ".sema-js-tests");
+    rmSync(pastaRuntime, { recursive: true, force: true });
+    for (const arquivo of arquivos) {
+        if (!arquivo.caminhoRelativo.endsWith(".ts")) {
+            continue;
+        }
+        const caminhoRelativoJs = arquivo.caminhoRelativo.replace(/\.ts$/i, ".cjs");
+        const destino = path.join(pastaRuntime, caminhoRelativoJs);
+        mkdirSync(path.dirname(destino), { recursive: true });
+        const transpilado = ts.transpileModule(arquivo.conteudo, {
+            fileName: arquivo.caminhoRelativo,
+            compilerOptions: {
+                module: ts.ModuleKind.CommonJS,
+                target: ts.ScriptTarget.ES2022,
+                esModuleInterop: true,
+                sourceMap: false,
+                inlineSourceMap: false,
+            },
+        }).outputText;
+        writeFileSync(destino, reescreverImportsTypeScriptGerados(transpilado), "utf8");
+    }
+    return path.join(pastaRuntime, arquivoTeste.replace(/\.ts$/i, ".cjs"));
+}
 function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
     const quantidadeTestes = contarCasosDeTesteGerados(alvo, arquivos);
     if (quantidadeTestes === 0) {
@@ -1021,15 +1034,8 @@ function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
             }
             return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
         }
-        if (!TSX_EXECUTOR_CLI) {
-            return {
-                codigoSaida: 1,
-                quantidadeTestes,
-                saidaPadrao: "",
-                saidaErro: "Nao foi possivel localizar o runner tsx junto da CLI para executar testes TypeScript.",
-            };
-        }
-        const execucao = spawnSync("node", [TSX_EXECUTOR_CLI, arquivoTeste], {
+        const arquivoTesteJs = compilarTypeScriptGeradoParaNodeTest(baseSaida, arquivos, arquivoTeste);
+        const execucao = spawnSync("node", ["--test", arquivoTesteJs], {
             stdio: silencioso ? "pipe" : "inherit",
             cwd: baseSaida,
             encoding: silencioso ? "utf8" : undefined,
@@ -1351,6 +1357,7 @@ function coletarResumoSemanticoModulo(contexto) {
             ...rotas.map((route) => `${route.metodo ?? "?"} ${route.caminho ?? route.nome}`),
         ]), 8),
         regrasCriticas: limitarLista(regrasCriticas, 8),
+        regrasAuthorAutomaticas: extrairRegrasAuthorAutomaticas(ir),
         efeitos: limitarLista(efeitos, 8),
         erros: limitarLista(erros, 8),
         entidadesAfetadas: limitarLista(entidadesAfetadas, 8),
@@ -1369,6 +1376,19 @@ function coletarResumoSemanticoModulo(contexto) {
         arquivosProvaveisEditar: limitarLista(unicosOrdenados(briefing.arquivosProvaveisEditar ?? briefing.oQueTocar), 8),
     };
 }
+const NOME_REGRAS_AUTHOR_AUTOMATICAS = "regras_gerais_author";
+const LINHA_REGRAS_AUTHOR_AUTOMATICAS_COMPACTA = "AUTHOR_RULES_AUTO: regras_gerais_author ativa; aplicar evidencia concreta, causa/consequencia, cena com dupla funcao, exposicao com atrito, subtexto, acao com geografia/dano, final sem slogan, morte com peso estrutural e anti-cliche adaptativa.";
+function extrairRegrasAuthorAutomaticas(ir) {
+    const regraAutomatica = ir?.author.find((item) => item.tipo === "style_rule" && item.nome === NOME_REGRAS_AUTHOR_AUTOMATICAS);
+    return limitarLista(unicosOrdenados(regraAutomatica?.requisitos ?? []), 20);
+}
+function renderizarLinhaRegrasAuthorAutomaticas(ids) {
+    return ids.length > 0 ? LINHA_REGRAS_AUTHOR_AUTOMATICAS_COMPACTA : null;
+}
+function renderizarLinhasRegrasAuthorAutomaticas(ids) {
+    const linha = renderizarLinhaRegrasAuthorAutomaticas(ids);
+    return linha ? [linha] : [];
+}
 function renderizarResumoModuloTexto(resumo, tamanho, modo) {
     const limite = tamanho === "micro" ? 2 : tamanho === "curto" ? 4 : 6;
     const linhas = [
@@ -1376,6 +1396,7 @@ function renderizarResumoModuloTexto(resumo, tamanho, modo) {
         `MODULO: ${resumo.modulo}`,
         `FAZ: ${resumo.faz}`,
         `PERFIL: ${resumo.perfilCompatibilidade}`,
+        ...renderizarLinhasRegrasAuthorAutomaticas(resumo.regrasAuthorAutomaticas),
         `CONSUMER_FRAMEWORK: ${resumo.consumerFramework ?? "nenhum"}`,
         `APP_ROUTES: ${resumirListaTexto(resumo.appRoutes, limite)}`,
         `CONSUMER_SURFACES: ${resumirListaTexto(resumo.consumerSurfaces, limite)}`,
@@ -1400,7 +1421,8 @@ function renderizarResumoModuloTexto(resumo, tamanho, modo) {
         `GERADO_EM: ${resumo.geradoEm}`,
     ];
     if (tamanho === "micro") {
-        return `${linhas.slice(0, 12).join("\n")}\n`;
+        const limiteMicro = 12 + (resumo.regrasAuthorAutomaticas.length > 0 ? 1 : 0);
+        return `${linhas.slice(0, limiteMicro).join("\n")}\n`;
     }
     return `${linhas.join("\n")}\n`;
 }
@@ -1427,6 +1449,9 @@ function renderizarResumoModuloMarkdown(resumo, modo, guiaPorCapacidade) {
         `- Entradas chave: ${resumirListaTexto(resumo.entradasChave, 6)}`,
         `- Saidas chave: ${resumirListaTexto(resumo.saidasChave, 6)}`,
         `- Regras criticas: ${resumirListaTexto(resumo.regrasCriticas, 6)}`,
+        ...(resumo.regrasAuthorAutomaticas.length > 0
+            ? [`- Regras Author automaticas: ${resumirListaTexto(resumo.regrasAuthorAutomaticas, 20)}`]
+            : []),
         `- Efeitos: ${resumirListaTexto(resumo.efeitos, 6)}`,
         `- Erros: ${resumirListaTexto(resumo.erros, 6)}`,
         `- Entidades afetadas: ${resumirListaTexto(resumo.entidadesAfetadas, 6)}`,
@@ -1486,6 +1511,7 @@ function criarBriefingMinimo(resumo, modo, tamanho) {
         entradasChave: resumo.entradasChave,
         saidasChave: resumo.saidasChave,
         regrasCriticas: resumo.regrasCriticas,
+        regrasAuthorAutomaticas: resumo.regrasAuthorAutomaticas,
         efeitos: resumo.efeitos,
         erros: resumo.erros,
         arquivosProvaveis: resumo.arquivosProvaveis,
@@ -1526,6 +1552,7 @@ ${resumoTexto}
 }
 function renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapacidade) {
     const entradaCanonica = criarEntradaCanonicaProjeto(guiaPorCapacidade);
+    const regrasAuthorAutomaticas = unicosOrdenados(modulos.flatMap((modulo) => modulo.regrasAuthorAutomaticas));
     const linhas = [
         "# SEMA_BRIEF",
         "",
@@ -1540,6 +1567,9 @@ function renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapacidade) {
         `- IA pequena: ${entradaCanonica.porCapacidade.pequena.join(" -> ")}`,
         `- IA media: ${entradaCanonica.porCapacidade.media.join(" -> ")}`,
         `- IA grande: ${entradaCanonica.porCapacidade.grande.join(" -> ")}`,
+        ...(regrasAuthorAutomaticas.length > 0
+            ? [`- Regras Author automaticas: ${resumirListaTexto(regrasAuthorAutomaticas, 20)}`]
+            : []),
         "",
         "## Guia por capacidade",
         "",
@@ -1862,6 +1892,8 @@ async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz
             : path.resolve(baseProjeto, ".tmp", "sema-resumo");
     await mkdir(pastaSaida, { recursive: true });
     const semaBrief = renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapacidade);
+    const regrasAuthorAutomaticas = unicosOrdenados(modulos.flatMap((modulo) => modulo.regrasAuthorAutomaticas));
+    const linhasRegrasAuthorAutomaticas = renderizarLinhasRegrasAuthorAutomaticas(regrasAuthorAutomaticas);
     const indexJson = {
         comando: "resumo-projeto",
         geradoEm,
@@ -1870,12 +1902,14 @@ async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz
         totalModulos: modulos.length,
         entradaCanonica,
         guiaPorCapacidade,
+        regrasAuthorAutomaticas,
         modulos,
     };
     const micro = [
         `PROJETO: ${path.basename(baseProjeto)}`,
         `MODULOS: ${modulos.length}`,
         `ENTRADA_IA: ${entradaCanonica.porCapacidade.pequena.join(" -> ")}`,
+        ...linhasRegrasAuthorAutomaticas,
         `TOP_MODULOS: ${resumirListaTexto(modulos.map((modulo) => modulo.modulo), 3)}`,
         `TOP_RISCOS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.riscosPrincipais)), 3)}`,
         `TOP_LACUNAS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.lacunas)), 3)}`,
@@ -1887,6 +1921,7 @@ async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz
         `BASE: ${baseProjeto}`,
         `MODULOS: ${modulos.length}`,
         `ENTRADA_IA: ${entradaCanonica.porCapacidade.media.join(" -> ")}`,
+        ...linhasRegrasAuthorAutomaticas,
         `TOP_MODULOS: ${resumirListaTexto(modulos.map((modulo) => modulo.modulo), 6)}`,
         `TOP_RISCOS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.riscosPrincipais)), 6)}`,
         `TOP_LACUNAS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.lacunas)), 6)}`,
@@ -3376,6 +3411,381 @@ async function comandoFinalizarMudanca(posicionais, args, emJson) {
     }
     return 1;
 }
+const BLOCOS_AUTHOR_CLI = [
+    "work/book",
+    "part/chapter/section",
+    "scene/character/arc",
+    "audience",
+    "claim/source",
+    "voice/style_rule/lexicon/motif/canon",
+    "agent",
+    "flow",
+];
+const FLUXO_EDITORIAL_AUTHOR_CLI = [
+    "modele a obra e seus limites em work/book",
+    "declare publico, canon, personagens, linha do tempo e regras de mundo quando existirem",
+    "declare style_rule para cortar cliches, ecos, muletas e repeticoes",
+    "declare claim/source para material factual ou sensivel",
+    "governe revisores como agents com tools, memory e policy",
+    "orquestre revisao, checagem de fontes e continuidade em flow",
+    "rode docs-impacto antes de mexer em capitulo importante",
+    "gere contexto-ia para compactar canon, arcos e continuidade",
+    "feche com finalizar-mudanca informando docs lidas",
+];
+const REGRAS_AUTHOR_AUTOMATICAS_CLI = [
+    {
+        id: "mostrar_por_evidencia",
+        nome: "Mostrar Por Evidência",
+        aplica: "emocao, trauma, revolta e mudanca social precisam aparecer por evidencia concreta em cena",
+        evitar: ["moral explicada", "emocao declarada", "simbolo sem uso concreto"],
+        preferir: ["objeto alterado", "rotina quebrada", "gesto observavel", "decisao visivel"],
+    },
+    {
+        id: "causa_e_consequencia",
+        nome: "Causa E Consequência",
+        aplica: "acao relevante precisa gerar consequencia proporcional",
+        evitar: ["vitoria sem custo", "erro sem punicao", "revelacao sem efeito"],
+        preferir: ["custo emocional", "custo fisico", "custo politico", "custo relacional"],
+    },
+    {
+        id: "cena_com_dupla_funcao",
+        nome: "Cena Com Dupla Função",
+        aplica: "toda cena deve cumprir pelo menos duas funcoes narrativas sem exigir personagem novo",
+        evitar: ["cena morta", "deslocamento vazio", "clima sem funcao"],
+        preferir: ["avancar trama", "revelar personagem", "plantar pista", "mostrar consequencia"],
+    },
+    {
+        id: "exposicao_com_atrito",
+        nome: "Exposição Com Atrito",
+        aplica: "informacao de mundo ou passado deve aparecer em situacao com tensao",
+        evitar: ["palestra", "lore sem conflito", "dialogo em que todos ja sabem"],
+        preferir: ["discussao", "ameaca", "documento incompleto", "erro operacional"],
+    },
+    {
+        id: "antagonista_com_logica_interna",
+        nome: "Antagonista Com Lógica Interna",
+        aplica: "antagonistas precisam ter objetivo compreensivel e poder real de afetar a trama",
+        evitar: ["malvadeza decorativa", "plano explicado inteiro", "incompetencia conveniente"],
+        preferir: ["argumento parcialmente convincente", "vantagem estrutural", "contradicao humana"],
+    },
+    {
+        id: "conflito_sem_solucao_limpa",
+        nome: "Conflito Sem Solução Limpa",
+        aplica: "problemas importantes nao devem ser resolvidos de forma perfeita ou gratuita",
+        evitar: ["solucao magica", "perdao instantaneo", "plano sem imprevisto"],
+        preferir: ["vitoria parcial", "dilema moral", "perda permanente", "novo problema"],
+    },
+    {
+        id: "continuidade_de_personagens",
+        nome: "Continuidade De Personagens",
+        aplica: "personagem relevante precisa manter estado narrativo rastreavel",
+        evitar: ["personagem sumir sem explicacao", "arco abandonado", "mudanca sem transicao"],
+        preferir: ["onde esta", "o que quer", "o que sabe", "o que perdeu", "relacao alterada"],
+    },
+    {
+        id: "misterio_em_escada",
+        nome: "Mistério Em Escada",
+        aplica: "revelacoes devem ser construidas por etapas",
+        evitar: ["revelacao sem pista", "segredo tardio", "misterio mantido por falta de conversa"],
+        preferir: ["pista", "contradicao", "interpretacao errada", "verdade parcial"],
+    },
+    {
+        id: "dialogo_com_subtexto",
+        nome: "Diálogo Com Subtexto",
+        aplica: "dialogo deve carregar intencao, defesa, disputa ou tensao",
+        evitar: ["fala explicativa", "todos com a mesma voz", "frase de efeito no lugar de conflito"],
+        preferir: ["resposta indireta", "mentira util", "silencio significativo", "pergunta como ataque"],
+    },
+    {
+        id: "acao_com_geografia_e_dano",
+        nome: "Ação Com Geografia E Dano",
+        aplica: "acao precisa ter espaco claro, objetivo concreto e consequencia depois",
+        evitar: ["correria generica", "tiro para fingir ritmo", "sair ileso sem motivo"],
+        preferir: ["mapa mental da cena", "obstaculo crescente", "uso do ambiente", "dano posterior"],
+    },
+    {
+        id: "final_de_capitulo_sem_slogan",
+        nome: "Final De Capítulo Sem Slogan",
+        aplica: "capitulo termina com decisao, imagem, perda, ameaca ou descoberta, nao com moral de trailer",
+        evitar: ["frase filosofica", "slogan sobre destino", "resumo da moral da cena"],
+        preferir: ["decisao irreversivel", "imagem forte", "perda concreta", "ameaca especifica"],
+    },
+    {
+        id: "morte_com_peso_estrutural",
+        nome: "Morte Com Peso Estrutural",
+        aplica: "morte importante precisa alterar relacoes, objetivo, poder, estado emocional ou rumo da obra",
+        evitar: ["morte so para chocar", "luto pulado", "morte revertida sem custo"],
+        preferir: ["mudanca em tres dimensoes", "custo narrativo", "consequencia no proximo capitulo"],
+    },
+    {
+        id: "especificidade_sensorial",
+        nome: "Especificidade Sensorial",
+        aplica: "descricao deve trocar abstracao generica por detalhe observavel",
+        evitar: ["ambiente sombrio", "dor insuportavel", "cidade caotica", "olhar triste"],
+        preferir: ["som especifico", "cheiro especifico", "textura", "temperatura", "objeto fora do lugar"],
+    },
+    {
+        id: "voz_distinta_por_personagem",
+        nome: "Voz Distinta Por Personagem",
+        aplica: "personagens recorrentes precisam ter forma propria de pensar, decidir e falar",
+        evitar: ["todos falando como o narrador", "mesmo humor", "mesma reacao ao medo"],
+        preferir: ["vocabulario proprio", "ritmo de fala", "tipo de silencio", "forma unica de mentir"],
+    },
+    {
+        id: "anti_cliche_adaptativa",
+        nome: "Anti-Clichê Adaptativa",
+        aplica: "estrutura reconhecivel demais deve ser substituida por alternativa especifica",
+        evitar: ["nao era sobre X, era sobre Y", "a esperanca renasceu", "o destino cobraria seu preco"],
+        preferir: ["acao concreta", "consequencia", "gesto observavel", "pista plantada"],
+    },
+];
+function resumirRegrasAuthorAutomaticas() {
+    return REGRAS_AUTHOR_AUTOMATICAS_CLI.map((regra) => `${regra.nome}: ${regra.aplica}`);
+}
+function criarContratoAuthorExemplo(sensivel) {
+    if (sensivel) {
+        return `module author.starter.sensivel {
+  work obra_sensivel {
+    titulo: "Guia responsavel"
+    proposito: "explicar um tema sensivel sem prometer verdade clinica"
+    tipo: nao_ficcao
+    tema: autismo
+    sensivel: verdadeiro
+  }
+
+  audience publico_principal {
+    publico: familias_educadores_pessoas_autistas
+    limites: "nao substitui avaliacao clinica ou orientacao profissional"
+  }
+
+  claim autismo_e_espectro {
+    texto: "autismo e um espectro com manifestacoes variadas"
+    source: fonte_principal
+    confidence: alta
+  }
+
+  source fonte_principal {
+    tipo: revisao_bibliografica
+    confianca: alta
+  }
+
+  style_rule linguagem_respeitosa {
+    require {
+      mostrar_por_evidencia
+      causa_e_consequencia
+      exposicao_com_atrito
+      final_de_capitulo_sem_slogan
+      anti_cliche_adaptativa
+    }
+    proibido {
+      frase: "superar o autismo"
+      generalizacao: "todo autista"
+      promessa: "diagnostico garantido"
+      slogan: "a esperanca renasceu"
+    }
+    evitar {
+      tom: infantilizacao
+      abordagem: sensacionalismo
+      estrutura: "nao era sobre X, era sobre Y"
+    }
+    preferir {
+      evidencia: gesto_observavel
+      consequencia: custo_visivel
+      linguagem: detalhe_especifico
+    }
+    tolerancia {
+      max_repeticao_palavra_por_trecho: 2
+      cena_funcoes_minimas: 2
+    }
+  }
+
+  agent checador_fontes {
+    role: revisor_fontes
+    goal: bloquear_afirmacao_sensivel_sem_fonte
+    tools {
+      ler_contrato
+      verificar_fontes
+      analisar_trecho
+    }
+    memory {
+      claim
+      source
+      style_rule
+    }
+    policy {
+      nao_afirmar_sem_fonte
+      sinalizar_incerteza
+      citar_trechos_afetados
+    }
+  }
+
+  flow revisar_secao_sensivel {
+    trecho: Texto
+    etapa fontes usa checador_fontes com trecho = trecho
+  }
+}
+`;
+    }
+    return `module author.starter.obra {
+  work obra {
+    titulo: "Projeto autoral"
+    proposito: "governar continuidade, arcos, personagens e tom editorial"
+    tipo: ficcao
+  }
+
+  audience leitores {
+    publico: leitores_ficcao_especulativa
+    promessa: "continuidade consistente e cenas com causa e consequencia"
+  }
+
+  character protagonista {
+    funcao: protagonista
+    arco: queda_e_reconstrucao
+  }
+
+  arc arco_principal {
+    inicio: "desejo claro"
+    virada: "custo moral visivel"
+    fim: "mudanca irreversivel"
+  }
+
+  canon universo {
+    regra: "nada muda no mundo sem custo emocional, logistico ou relacional"
+  }
+
+  style_rule anti_texto_raso {
+    require {
+      mostrar_por_evidencia
+      causa_e_consequencia
+      cena_com_dupla_funcao
+      exposicao_com_atrito
+      dialogo_com_subtexto
+      final_de_capitulo_sem_slogan
+      anti_cliche_adaptativa
+    }
+    proibido {
+      frase: "de alguma forma"
+      cliche: "o tempo parecia parar"
+      estrutura: "nao era sobre X, era sobre Y"
+      slogan: "a esperanca renasceu"
+      moral: "todos finalmente entenderam a verdade"
+    }
+    ecos {
+      palavra: "silencio"
+    }
+    preferir {
+      evidencia: gesto_concreto
+      consequencia: custo_visivel
+      misterio: pista_contradicao_verdade_parcial
+      final: decisao_ou_imagem_concreta
+    }
+    tolerancia {
+      max_repeticao_palavra_por_trecho: 2
+      cena_funcoes_minimas: 2
+    }
+  }
+
+  agent revisor_continuidade {
+    role: editor_author
+    goal: preservar_canon_arcos_e_continuidade
+    tools {
+      ler_contrato
+      analisar_trecho
+      comparar_canon
+    }
+    memory {
+      canon
+      character
+      arc
+      style_rule
+    }
+    policy {
+      nao_reescrever_sem_aprovacao
+      citar_trechos_afetados
+      registrar_decisoes_editoriais
+    }
+  }
+
+  flow revisar_capitulo {
+    trecho: Texto
+    etapa continuidade usa revisor_continuidade com trecho = trecho
+  }
+}
+`;
+}
+function criarPayloadAuthorCli(modo, sensivel) {
+    return {
+        comando: "author",
+        profile: "Author",
+        modo,
+        sensivel,
+        blocos: [...BLOCOS_AUTHOR_CLI],
+        fluxoEditorial: [...FLUXO_EDITORIAL_AUTHOR_CLI],
+        regrasAutomaticas: REGRAS_AUTHOR_AUTOMATICAS_CLI.map((regra) => ({
+            ...regra,
+            evitar: [...regra.evitar],
+            preferir: [...regra.preferir],
+        })),
+        comandos: [
+            "sema author --help",
+            "sema author exemplo",
+            "sema author exemplo --sensivel --json",
+            "sema validar contratos/<obra>.sema --json",
+            "sema docs-impacto --intencao \"editar capitulo\" --arquivo contratos/<obra>.sema --criar-ausentes --json",
+            "sema contexto-ia contratos/<obra>.sema --saida ./.tmp/contexto-author --json",
+            "sema finalizar-mudanca --intencao \"editar capitulo\" --arquivo contratos/<obra>.sema --doc-lida docs/<doc>.md --json",
+        ],
+        contratoExemplo: criarContratoAuthorExemplo(sensivel),
+    };
+}
+function renderizarAjudaAuthor() {
+    return [
+        "Sema Author",
+        "",
+        renderizarSecaoAscii("Uso", [
+            "sema author --help",
+            "sema author exemplo",
+            "sema author exemplo --sensivel",
+            "sema author exemplo --sensivel --json",
+        ]),
+        "",
+        renderizarSecaoAscii("Serve para", [
+            "obra, livro, capitulo, cena, personagem, arco, canon, tese, claim, fonte e continuidade",
+            "ficcao, nao ficcao, livro tecnico, ensaio, biografia, pesquisa aplicada, manual e curso em livro",
+            "evitar cliche, eco, muleta, generalizacao, infantilizacao e reescrita sem politica",
+        ]),
+        "",
+        renderizarSecaoAscii("Fluxo recomendado", [...FLUXO_EDITORIAL_AUTHOR_CLI]),
+        "",
+        renderizarSecaoAscii("Regras automaticas", resumirRegrasAuthorAutomaticas()),
+        "",
+        renderizarSecaoAscii("Blocos principais", [...BLOCOS_AUTHOR_CLI]),
+        "",
+        renderizarSecaoAscii("Comandos que encaixam", [
+            "sema docs-impacto --intencao \"editar capitulo\" --arquivo contratos/<obra>.sema --criar-ausentes --json",
+            "sema contexto-ia contratos/<obra>.sema --saida ./.tmp/contexto-author --json",
+            "sema finalizar-mudanca --intencao \"editar capitulo\" --arquivo contratos/<obra>.sema --doc-lida docs/<doc>.md --json",
+        ]),
+    ].join("\n");
+}
+async function comandoAuthor(posicionais, args, emJson) {
+    const subcomando = posicionais[0];
+    const sensivel = possuiFlag(args, "--sensivel") || possuiFlag(args, "--sensitive");
+    const modo = subcomando === "exemplo" || subcomando === "template" || subcomando === "starter"
+        ? "exemplo"
+        : "ajuda";
+    const payload = criarPayloadAuthorCli(modo, sensivel);
+    if (emJson) {
+        console.log(JSON.stringify(payload, null, 2));
+        return 0;
+    }
+    if (modo === "exemplo") {
+        console.log(payload.contratoExemplo);
+        return 0;
+    }
+    console.log(renderizarAjudaAuthor());
+    return 0;
+}
 async function comandoValidar(entrada) {
     const modulos = await carregarModulos(entrada);
     const diagnosticos = modulos.flatMap((item) => item.resultado.diagnosticos);
@@ -3909,6 +4319,7 @@ async function comandoAjudaIa() {
         "Use `sema prompt-curto <arquivo> --curto --para mudanca` para colar contexto em modelo gratuito.",
         "Use `sema prompt-ia`, `sema prompt-ia-ui`, `sema prompt-ia-react` e `sema prompt-ia-sema-primeiro` conforme a tarefa.",
         "Use `sema exemplos-prompt-ia` para pegar modelos prontos de prompt.",
+        "Use `sema author` para obra, capitulos, cenas, personagens, continuidade, fontes, estilo, agents e flow editorial.",
         "Use `sema inspecionar` para descobrir base, codigo vivo e fontes legado.",
         "Use `sema drift` para medir impls, vinculos, rotas, score e lacunas.",
         "Use `sema docs-impacto --intencao <acao>` para ler ou criar docs obrigatorias antes de agir.",
@@ -4427,6 +4838,9 @@ async function principal() {
         case "finalizar-mudanca":
             codigoSaida = await comandoFinalizarMudanca(posicionais, resto, possuiFlag(resto, "--json"));
             break;
+        case "author":
+            codigoSaida = await comandoAuthor(posicionais, resto, possuiFlag(resto, "--json"));
+            break;
         case "resumo":
             codigoSaida = await comandoResumo(posicionais[0], resto, possuiFlag(resto, "--json"));
             break;