@semacode/cli 1.5.11 → 1.5.14

package/README.md

@@ -6,6 +6,8 @@ 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.
 
 Tambem resolve documentacao obrigatoria por intencao para impedir IA de agir sem ler ou criar docs relacionadas.
 
@@ -95,6 +97,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

@@ -496,6 +496,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]",
@@ -3376,6 +3378,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 Evidencia",
+        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 Consequencia",
+        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 Funcao",
+        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: "Exposicao 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 Logica 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 Solucao 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: "Misterio 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: "Dialogo 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: "Acao 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 Capitulo 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-Cliche 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 +4286,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 +4805,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;