@semacode/cli 2.1.0 → 2.3.0

package/dist/discovery/render.js

@@ -0,0 +1,100 @@
+// SEMA-GOVERNED: sema.produto.descoberta_capacidades
+// Descrição: saída humana agrupada, contextual e explícita sobre ausência de execução.
+const KIND_LABELS = {
+    GOVERNANCE_FLOW: "Fluxos de governança",
+    PROFILE_GATE: "Gates por profile",
+    SPECIALIZED_WORKFLOW: "Workflows especializados",
+    ORCHESTRATION_PIPELINE: "Pipelines de orquestração",
+    CAPABILITY_TOKEN: "Capabilities declarativas",
+    GENERATOR: "Geradores",
+    ADAPTER: "Adapters externos",
+};
+const FRONTEIRA = "Nenhuma ação foi executada; o workspace e serviços externos não foram tocados.";
+function linhaComando(entry) {
+    const command = entry.commandTemplates[0]?.command;
+    return command ? `   Comando explícito: ${command}` : "   Comando explícito: não disponível";
+}
+function renderizarCatalogo(payload) {
+    const linhas = [
+        "DESCOBERTA SEMA",
+        `CATÁLOGO · ${payload.entries.length} capacidade(s)`,
+        FRONTEIRA,
+    ];
+    if (payload.entries.length === 0) {
+        linhas.push("", "Nenhuma capacidade corresponde aos filtros informados.");
+        return linhas.join("\n");
+    }
+    for (const kind of Object.keys(KIND_LABELS)) {
+        const entries = payload.entries.filter((entry) => entry.kind === kind);
+        if (entries.length === 0)
+            continue;
+        linhas.push("", `${KIND_LABELS[kind]} (${entries.length})`);
+        for (const entry of entries) {
+            linhas.push(`- ${entry.label} · ${entry.id}`, `   ${entry.summary}`, `   Use quando: ${entry.useWhen[0] ?? "consulte a descrição detalhada"}`, linhaComando(entry));
+        }
+    }
+    return linhas.join("\n");
+}
+function renderizarRanking(payload) {
+    const linhas = [
+        "DESCOBERTA SEMA",
+        `INTENÇÃO · ${payload.intent}`,
+        FRONTEIRA,
+    ];
+    if (payload.noMatch) {
+        linhas.push("", "Sem correspondência segura (o melhor score ficou abaixo de 60/100).");
+    }
+    else if (payload.ambiguity.detected) {
+        linhas.push("", `Ambiguidade detectada entre ${payload.ambiguity.candidates.join(" e ")}.`, "Nenhum comando único foi sugerido; refine a intenção ou escolha uma capacidade explicitamente.");
+    }
+    if (payload.recommendations.length === 0) {
+        linhas.push("", "Nenhuma candidata recebeu sinais positivos.");
+        return linhas.join("\n");
+    }
+    linhas.push("");
+    for (const recommendation of payload.recommendations) {
+        linhas.push(`${recommendation.rank}. ${recommendation.label} · ${recommendation.id} — ${recommendation.score}/100`, `   Motivos: ${recommendation.reasons.join("; ")}`, `   Sinais: ${recommendation.matchedSignals.join(", ") || "nenhum"}`);
+        if (recommendation.missingInputs.length > 0) {
+            linhas.push(`   Entradas ainda necessárias: ${recommendation.missingInputs.join(", ")}`);
+        }
+        if (recommendation.suggestedCommandTemplate) {
+            linhas.push(`   Comando explícito: ${recommendation.suggestedCommandTemplate}`);
+        }
+    }
+    return linhas.join("\n");
+}
+function renderizarExplicacao(payload) {
+    const entry = payload.entry;
+    const linhas = [
+        "DESCOBERTA SEMA",
+        `${entry.label} · ${entry.id}`,
+        `${KIND_LABELS[entry.kind]} · ${entry.domains.join(", ")}`,
+        FRONTEIRA,
+        "",
+        entry.summary,
+        "",
+        "Use quando:",
+        ...entry.useWhen.map((item) => `- ${item}`),
+        "",
+        "Evite quando:",
+        ...entry.avoidWhen.map((item) => `- ${item}`),
+        "",
+        "Comandos explícitos:",
+        ...entry.commandTemplates.map((item) => (`- ${item.command} [${item.effectClass}; muta workspace: ${item.mutatesWorkspace ? "sim" : "não"}; runtime externo: ${item.executesExternalRuntime ? "sim" : "não"}]`)),
+    ];
+    return linhas.join("\n");
+}
+export function renderizarResultadoDescoberta(payload) {
+    if (payload.mode === "catalog")
+        return renderizarCatalogo(payload);
+    if (payload.mode === "ranking")
+        return renderizarRanking(payload);
+    if (payload.mode === "explain")
+        return renderizarExplicacao(payload);
+    return [
+        "DESCOBERTA SEMA · ERRO",
+        payload.error.message,
+        FRONTEIRA,
+    ].join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/discovery/types.d.ts

@@ -0,0 +1,119 @@
+export declare const DISCOVERY_SCHEMA_VERSION: "sema.discovery/v1";
+export declare const DISCOVERY_KINDS: readonly ["GOVERNANCE_FLOW", "PROFILE_GATE", "SPECIALIZED_WORKFLOW", "ORCHESTRATION_PIPELINE", "CAPABILITY_TOKEN", "GENERATOR", "ADAPTER"];
+export type DiscoveryKind = (typeof DISCOVERY_KINDS)[number];
+export type DiscoveryEffectClass = "READ_ONLY_DISCOVERY" | "READ_ONLY_VALIDATION" | "DECLARATIVE_PLANNING" | "WORKSPACE_BOOTSTRAP" | "WORKSPACE_GENERATION" | "WORKSPACE_VERIFICATION";
+export interface DiscoveryCommandTemplate {
+    readonly id: string;
+    readonly command: string;
+    readonly effectClass: DiscoveryEffectClass;
+    readonly mutatesWorkspace: boolean;
+    readonly executesExternalRuntime: boolean;
+}
+export interface DiscoveryEntry {
+    readonly id: string;
+    readonly kind: DiscoveryKind;
+    readonly domains: readonly string[];
+    readonly label: string;
+    readonly summary: string;
+    readonly useWhen: readonly string[];
+    readonly avoidWhen: readonly string[];
+    readonly intentSignals: readonly string[];
+    readonly negativeSignals: readonly string[];
+    readonly requiredInputs: readonly string[];
+    readonly commandTemplates: readonly DiscoveryCommandTemplate[];
+    readonly related: readonly string[];
+    readonly source: string;
+    readonly extensible: boolean;
+    readonly aliases?: readonly string[];
+}
+export interface DiscoveryExecutionBoundary {
+    readonly executed: false;
+    readonly workspaceMutated: false;
+    readonly externalCalls: false;
+    readonly requiresExplicitRun: true;
+}
+export interface DiscoveryCatalogFilters {
+    readonly kind?: DiscoveryKind | string | null;
+    readonly id?: string | null;
+    readonly domain?: string | null;
+}
+export interface DiscoveryCatalogPayload extends DiscoveryExecutionBoundary {
+    readonly schemaVersion: typeof DISCOVERY_SCHEMA_VERSION;
+    readonly command: "descobrir catalogo" | "descobrir pipeline listar";
+    readonly success: true;
+    readonly mode: "catalog";
+    readonly filters: {
+        readonly kind: DiscoveryKind | null;
+        readonly id: string | null;
+        readonly domain: string | null;
+    };
+    readonly entries: readonly DiscoveryEntry[];
+}
+export interface DiscoveryRecommendation {
+    readonly rank: number;
+    readonly id: string;
+    readonly kind: DiscoveryKind;
+    readonly label: string;
+    readonly score: number;
+    readonly matchedSignals: readonly string[];
+    readonly reasons: readonly string[];
+    readonly missingInputs: readonly string[];
+    readonly suggestedCommandTemplate: string | null;
+}
+export interface DiscoveryAmbiguity {
+    readonly detected: boolean;
+    readonly delta: number | null;
+    readonly candidates: readonly string[];
+}
+export interface DiscoveryRecommendationPayload extends DiscoveryExecutionBoundary {
+    readonly schemaVersion: typeof DISCOVERY_SCHEMA_VERSION;
+    readonly command: "descobrir recomendar";
+    readonly success: true;
+    readonly mode: "ranking";
+    readonly intent: string;
+    readonly recommendations: readonly DiscoveryRecommendation[];
+    readonly ambiguity: DiscoveryAmbiguity;
+    readonly noMatch: boolean;
+}
+export interface DiscoveryExplainPayload extends DiscoveryExecutionBoundary {
+    readonly schemaVersion: typeof DISCOVERY_SCHEMA_VERSION;
+    readonly command: "descobrir explicar" | "descobrir pipeline descrever";
+    readonly success: true;
+    readonly mode: "explain";
+    readonly entry: DiscoveryEntry;
+}
+export interface DiscoveryErrorPayload extends DiscoveryExecutionBoundary {
+    readonly schemaVersion: typeof DISCOVERY_SCHEMA_VERSION;
+    readonly command: "descobrir";
+    readonly success: false;
+    readonly mode: "error";
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+export type DiscoveryPayload = DiscoveryCatalogPayload | DiscoveryRecommendationPayload | DiscoveryExplainPayload | DiscoveryErrorPayload;
+export interface DiscoveryCommandResult {
+    readonly exitCode: 0 | 2;
+    readonly payload: DiscoveryPayload;
+    readonly text: string;
+    readonly outputFormat: "json" | "text";
+    readonly executed: false;
+}
+export interface ResumoDescobertaAgentContext {
+    readonly schemaVersion: typeof DISCOVERY_SCHEMA_VERSION;
+    readonly command: "sema descobrir catalogo --json";
+    readonly kinds: readonly DiscoveryKind[];
+    readonly pipelinesPrincipais: readonly {
+        readonly id: string;
+        readonly label: string;
+        readonly command: string;
+    }[];
+    readonly commands: {
+        readonly catalogo: "sema descobrir catalogo --json";
+        readonly recomendar: "sema descobrir recomendar --intencao <texto> --json";
+        readonly explicar: "sema descobrir explicar <id> --json";
+    };
+}
+/** @deprecated Prefira o nome canônico em PT-BR. */
+export type DiscoveryAgentContextSummary = ResumoDescobertaAgentContext;

package/dist/discovery/types.js

@@ -0,0 +1,13 @@
+// SEMA-GOVERNED: sema.produto.descoberta_capacidades
+// Descrição: tipos públicos e fronteira sem efeitos da descoberta de capacidades.
+export const DISCOVERY_SCHEMA_VERSION = "sema.discovery/v1";
+export const DISCOVERY_KINDS = [
+    "GOVERNANCE_FLOW",
+    "PROFILE_GATE",
+    "SPECIALIZED_WORKFLOW",
+    "ORCHESTRATION_PIPELINE",
+    "CAPABILITY_TOKEN",
+    "GENERATOR",
+    "ADAPTER",
+];
+//# sourceMappingURL=types.js.map

package/dist/execucoesExternas.js

@@ -1,7 +1,6 @@
-// SEMA-GOVERNED
-// M?dulo: sema.produto.orcamento_semantico
-// Contrato: contratos/sema/orcamento_semantico.sema
-// Descri??o: detec??o de comandos externos usados por doctor, testes gerados e runners opcionais.
+// SEMA-GOVERNED: sema.produto.cli_toolchain_local
+// Contrato: contratos/sema/cli_toolchain_local.sema
+// Descrição: detecção de comandos externos usados por doctor, testes gerados e runners opcionais.
 import { spawnSync } from "node:child_process";
 import { createRequire } from "node:module";
 const requireRuntimeCli = createRequire(import.meta.url);
@@ -16,14 +15,29 @@ function resolverImportadorNodeOpcional(especificador) {
 export const TSX_IMPORTADOR_CLI = resolverImportadorNodeOpcional("tsx");
 export const TSX_EXECUTOR_CLI = resolverImportadorNodeOpcional("tsx/cli");
 const TIMEOUT_CHECAGEM_COMANDO_MS = 5_000;
+const disponibilidadeComandosNoProcesso = new Map();
 export function comandoDisponivel(comando, argumentos = ["--version"]) {
+    const chaveSondagem = JSON.stringify({
+        comando,
+        argumentos,
+        cwd: process.cwd(),
+        path: process.env.PATH ?? "",
+        pathExt: process.env.PATHEXT ?? "",
+        comSpec: process.env.COMSPEC ?? "",
+    });
+    const resultadoMemorizado = disponibilidadeComandosNoProcesso.get(chaveSondagem);
+    if (resultadoMemorizado !== undefined) {
+        return resultadoMemorizado;
+    }
     const execucao = spawnSync(comando, argumentos, {
         stdio: "ignore",
         shell: process.platform === "win32",
         timeout: TIMEOUT_CHECAGEM_COMANDO_MS,
         windowsHide: true,
     });
-    return !execucao.error && execucao.signal === null && (execucao.status ?? 1) === 0;
+    const disponivel = !execucao.error && execucao.signal === null && (execucao.status ?? 1) === 0;
+    disponibilidadeComandosNoProcesso.set(chaveSondagem, disponivel);
+    return disponivel;
 }
 export function resolverExecucaoPython() {
     if (comandoDisponivel("python")) {

package/dist/exemplosOficiais.js

@@ -6,6 +6,32 @@ import { fileURLToPath } from "node:url";
 import { caminhoEhDiretorio } from "./fsGovernado.js";
 import { escreverArquivoWorkspaceSeguro, validarDestinosEscritaWorkspace, } from "./workspaceWrite.js";
 const DIRETORIO_CLI_ATUAL = path.dirname(fileURLToPath(import.meta.url));
+const EXTENSOES_EXEMPLOS_OFICIAIS = new Set([".sema", ".json", ".md"]);
+async function listarArquivosExemplosOficiais(origem, diretorioAtual = origem) {
+    const arquivos = [];
+    const entradas = await readdir(diretorioAtual, { withFileTypes: true });
+    for (const entrada of entradas) {
+        const origemArquivo = path.join(diretorioAtual, entrada.name);
+        const relativoOrigem = path.relative(origem, origemArquivo);
+        if (entrada.isSymbolicLink()) {
+            throw new Error(`Exemplo oficial nao pode atravessar symlink ou junction: ${relativoOrigem}`);
+        }
+        if (entrada.isDirectory()) {
+            arquivos.push(...await listarArquivosExemplosOficiais(origem, origemArquivo));
+            continue;
+        }
+        if (!entrada.isFile() ||
+            !EXTENSOES_EXEMPLOS_OFICIAIS.has(path.extname(entrada.name).toLowerCase())) {
+            continue;
+        }
+        arquivos.push({
+            nome: relativoOrigem,
+            origemArquivo,
+            caminhoRelativo: path.join("exemplos", relativoOrigem),
+        });
+    }
+    return arquivos;
+}
 export async function localizarDiretorioExemplosOficiais() {
     const candidatos = [
         path.resolve(DIRETORIO_CLI_ATUAL, "..", "exemplos"),
@@ -23,16 +49,11 @@ export async function planejarExemplosOficiais() {
     if (!origem) {
         return { origem: undefined, arquivos: [] };
     }
-    const entradas = (await readdir(origem, { withFileTypes: true }))
-        .filter((entrada) => entrada.isFile() && entrada.name.endsWith(".sema"))
-        .sort((a, b) => a.name.localeCompare(b.name, "pt-BR"));
+    const arquivos = await listarArquivosExemplosOficiais(origem);
+    arquivos.sort((a, b) => a.caminhoRelativo.localeCompare(b.caminhoRelativo, "pt-BR"));
     return {
         origem,
-        arquivos: entradas.map((entrada) => ({
-            nome: entrada.name,
-            origemArquivo: path.join(origem, entrada.name),
-            caminhoRelativo: path.join("exemplos", entrada.name),
-        })),
+        arquivos,
     };
 }
 export async function materializarExemplosOficiais(baseProjeto = process.cwd(), preservarExistentes = true) {

package/dist/iaPrompts.d.ts

@@ -3,4 +3,4 @@ export declare const PROMPT_BASE_IA = "Voce esta trabalhando com Sema, um contra
 export declare const PROMPT_IA_UI = "Atue como Engenheiro de Software Senior e UX/UI Designer de elite.\n\nQuero que voce trabalhe com Sema como fonte de verdade semantica do sistema e com React + TypeScript como camada de interface.\n\nEntregue obrigatoriamente duas partes integradas:\n1. os arquivos `.sema` do dominio\n2. a proposta ou implementacao da interface em React + TypeScript\n\nRegras:\n- nao entregue apenas HTML solto em arquivo unico\n- nao trate a Sema como enfeite conceitual\n- a interface deve nascer do contrato semantico definido em Sema\n- use os exemplos oficiais da Sema como referencia de estilo e semantica\n- nao invente sintaxe fora da gramatica suportada\n\nA Sema deve modelar, quando fizer sentido:\n- `module`\n- `use`\n- `entity`\n- `enum`\n- `state`\n- `task`\n- `flow`\n- `route`\n- `effects`\n- `error`\n- `guarantees`\n- `tests`\n- `docs`\n\nA interface deve refletir visualmente:\n- `state` como status e progresso observavel\n- `flow` como etapas ou orquestracao visivel\n- `error` como falhas tratadas com clareza\n- `effects` como operacoes relevantes para usuario ou operacao\n- `guarantees` como confianca, confirmacao ou consistencia final\n\nEstruture a entrega assim:\n1. visao do produto\n2. dominio modelado em Sema\n3. arquitetura de pastas em React + TypeScript\n4. componentes principais\n5. estrategia visual\n6. codigo principal da interface\n7. explicacao curta de como a UI conversa com a semantica da Sema\n\nSe a tarefa envolver app visual, a Sema governa o significado e o React renderiza a experiencia. Nao atropele essa separacao.\n";
 export declare const PROMPT_IA_REACT = "Crie uma solucao com Sema + React + TypeScript.\n\nRegras principais:\n- a Sema deve ser a fonte de verdade semantica do dominio\n- React + TypeScript deve ser a camada de interface e experiencia\n- nao entregue HTML unico solto\n- nao trate a Sema como enfeite\n\nEntregue obrigatoriamente:\n1. arquivos `.sema` do dominio\n2. arquitetura de pastas do frontend\n3. componentes React principais\n4. contratos e tipos derivados da semantica\n5. interface elegante e implementavel\n\nA modelagem Sema deve cobrir, quando fizer sentido:\n- `entity`\n- `enum`\n- `state`\n- `task`\n- `flow`\n- `route`\n- `effects`\n- `error`\n- `guarantees`\n- `tests`\n\nA interface React deve tornar visiveis:\n- estado atual e transicoes relevantes\n- fluxo operacional\n- erros publicos\n- efeitos operacionais importantes\n- garantias ou confirmacoes finais\n\nEstruture a entrega assim:\n1. visao do produto\n2. arquivos `.sema`\n3. arquitetura React + TypeScript\n4. componentes e telas\n5. codigo principal\n6. explicacao de como a UI deriva da semantica da Sema\n\nSe houver duvida, siga os exemplos oficiais e mantenha a separacao:\n- Sema governa o significado\n- React governa a apresentacao\n";
 export declare const PROMPT_IA_SEMA_PRIMEIRO = "Quero que voce trabalhe no modo \"Sema primeiro\".\n\nRegra principal:\n- modele primeiro o dominio em arquivos `.sema`\n- se a intencao mudar, crie, edite ou remova o contrato antes de qualquer acao operacional\n- so depois proponha ou gere codigo de aplicacao derivado disso\n\nFluxo obrigatorio:\n1. entender o dominio pedido\n2. modelar o contrato em Sema\n3. validar coerencia entre `task`, `route`, `state`, `flow`, `error`, `effects` e `guarantees`\n4. so depois gerar TypeScript, Python, React ou outra camada de implementacao\n\nNao entregue apenas codigo de interface ou codigo imperativo direto sem antes entregar a camada semantica.\n\nA modelagem em Sema deve:\n- preservar a intencao do dominio\n- explicitar entradas, saidas, erros, efeitos e garantias\n- usar apenas blocos e sintaxe oficiais\n- incluir testes embutidos quando fizer sentido\n\nSe houver interface grafica:\n- entregue a modelagem Sema primeiro\n- depois explique como a interface deve refletir a semantica\n- se gerar UI, use React + TypeScript em vez de HTML unico solto\n\nSe houver backend:\n- entregue a modelagem Sema primeiro\n- depois gere a borda publica e a implementacao derivada\n\nNao pule a etapa semantica. A camada `.sema` e a ancora principal da solucao.\n";
-export declare const EXEMPLOS_PROMPT_IA = "Exemplos de prompt oficial para trabalhar com Sema\n\n1. Sema primeiro\n\nCrie uma solucao seguindo a estrategia \"Sema primeiro\".\nEntregue primeiro os arquivos `.sema` do dominio e so depois a implementacao derivada.\nNao entregue apenas codigo imperativo.\nUse Sema como fonte de verdade para contratos, estados, erros, efeitos e garantias.\n\n2. Sema + React + TypeScript\n\nCrie um projeto com Sema + React + TypeScript.\nEntregue:\n- os arquivos `.sema` do dominio\n- a arquitetura de pastas do frontend\n- componentes React que reflitam `state`, `flow`, `error`, `effects` e `guarantees`\n- uma interface elegante e implementavel\n- nao entregue HTML solto em arquivo unico\n\n3. Revisar ou corrigir um modulo Sema\n\nRevise e corrija um modulo `.sema`.\nAntes de editar:\n- leia os exemplos oficiais parecidos\n- consulte AST e IR\nDepois de editar:\n- rode `sema formatar`\n- rode `sema validar --json`\n- use `diagnosticos --json` se houver falha\n- feche com `sema verificar`\n\n4. Caso de UI sem perder a semantica\n\nQuero uma interface premium para este dominio, mas a solucao deve continuar ancorada em Sema.\nModele primeiro o dominio em `.sema`.\nDepois proponha uma interface em React + TypeScript que torne visiveis:\n- estado\n- fluxo\n- erros\n- efeitos\n- garantias\nNao transforme isso em um `index.html` solto.\n\nComandos uteis da CLI para esse fluxo:\n- `sema starter-ia`\n- `sema ajuda-ia`\n- `sema resumo <arquivo-ou-pasta>`\n- `sema prompt-curto <arquivo-ou-pasta>`\n- `sema prompt-ia`\n- `sema prompt-ia-ui`\n- `sema prompt-ia-react`\n- `sema prompt-ia-sema-primeiro`\n- `sema contexto-ia <arquivo.sema>`\n";
+export declare const EXEMPLOS_PROMPT_IA = "Exemplos de prompt oficial para trabalhar com Sema\n\n1. Sema primeiro\n\nCrie uma solucao seguindo a estrategia \"Sema primeiro\".\nEntregue primeiro os arquivos `.sema` do dominio e so depois a implementacao derivada.\nNao entregue apenas codigo imperativo.\nUse Sema como fonte de verdade para contratos, estados, erros, efeitos e garantias.\n\n2. Sema + React + TypeScript\n\nCrie um projeto com Sema + React + TypeScript.\nEntregue:\n- os arquivos `.sema` do dominio\n- a arquitetura de pastas do frontend\n- componentes React que reflitam `state`, `flow`, `error`, `effects` e `guarantees`\n- uma interface elegante e implementavel\n- nao entregue HTML solto em arquivo unico\n\n3. Revisar ou corrigir um modulo Sema\n\nRevise e corrija um modulo `.sema`.\nAntes de editar:\n- leia os exemplos oficiais parecidos\n- consulte AST e IR\nDepois de editar:\n- rode `sema formatar`\n- rode `sema validar --json`\n- use `diagnosticos --json` se houver falha\n- feche com `sema verificar`\n\n4. Caso de UI sem perder a semantica\n\nQuero uma interface premium para este dominio, mas a solucao deve continuar ancorada em Sema.\nModele primeiro o dominio em `.sema`.\nDepois proponha uma interface em React + TypeScript que torne visiveis:\n- estado\n- fluxo\n- erros\n- efeitos\n- garantias\nNao transforme isso em um `index.html` solto.\n\nComandos uteis da CLI para esse fluxo:\n- `sema starter-ia`\n- `sema ajuda-ia`\n- `sema descobrir catalogo --json`\n- `sema descobrir recomendar --intencao \"<objetivo>\" --json`\n- `sema interativo pipelines --json`\n- `sema resumo <arquivo-ou-pasta>`\n- `sema prompt-curto <arquivo-ou-pasta>`\n- `sema prompt-ia`\n- `sema prompt-ia-ui`\n- `sema prompt-ia-react`\n- `sema prompt-ia-sema-primeiro`\n- `sema contexto-ia <arquivo.sema>`\n";

package/dist/iaPrompts.js

@@ -307,6 +307,9 @@ Nao transforme isso em um \`index.html\` solto.
 Comandos uteis da CLI para esse fluxo:
 - \`sema starter-ia\`
 - \`sema ajuda-ia\`
+- \`sema descobrir catalogo --json\`
+- \`sema descobrir recomendar --intencao "<objetivo>" --json\`
+- \`sema interativo pipelines --json\`
 - \`sema resumo <arquivo-ou-pasta>\`
 - \`sema prompt-curto <arquivo-ou-pasta>\`
 - \`sema prompt-ia\`

package/dist/index.d.ts

@@ -5,3 +5,6 @@ export { iniciarProfileAuthor, comandoAuthor, criarAuthorBriefing, revisarCliche
 export { validarProfileSemantico } from "./profileCommand.js";
 export { materializarExemplosOficiais } from "./exemplosOficiais.js";
 export { expandirIntencaoSemanticaProfile, sugerirStarterPresetProfile, validarPipelineProfiles, exigirQaCriativoQuandoPublicavel, catalogoDropdownOnboarding } from "./profileOrquestracao.js";
+export * from "./pipelineConteudo/index.js";
+export * from "./sistemasInterativos/index.js";
+export * from "./discovery/index.js";

package/dist/index.js

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
 // SEMA-GOVERNED: sema.governanca_ia_contexto
 // Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
+import { realpathSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { principal } from "./index.part08.js";
 export * from "./index.part01.js";
 export * from "./index.part08.js";
@@ -8,9 +11,25 @@ export { iniciarProfileAuthor, comandoAuthor, criarAuthorBriefing, revisarCliche
 export { validarProfileSemantico } from "./profileCommand.js";
 export { materializarExemplosOficiais } from "./exemplosOficiais.js";
 export { expandirIntencaoSemanticaProfile, sugerirStarterPresetProfile, validarPipelineProfiles, exigirQaCriativoQuandoPublicavel, catalogoDropdownOnboarding } from "./profileOrquestracao.js";
-principal().catch((erro) => {
-    console.error("Falha ao executar a CLI da Sema.");
-    console.error(erro instanceof Error ? erro.stack ?? erro.message : erro);
-    process.exit(1);
-});
+export * from "./pipelineConteudo/index.js";
+export * from "./sistemasInterativos/index.js";
+export * from "./discovery/index.js";
+function moduloExecutadoDiretamente() {
+    if (!process.argv[1]) {
+        return false;
+    }
+    try {
+        return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url));
+    }
+}
+if (moduloExecutadoDiretamente()) {
+    principal().catch((erro) => {
+        console.error("Falha ao executar a CLI da Sema.");
+        console.error(erro instanceof Error ? erro.stack ?? erro.message : erro);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/index.part01.d.ts

@@ -2,7 +2,7 @@ import { compilarCodigo, type IrModulo } from "@sema/nucleo";
 import { analisarDriftLegado, type OpcoesDriftLegado } from "./drift.js";
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
 import { criarBriefingAgente, resumirDriftPorModulo } from "./index.part03.js";
-export type Comando = "iniciar" | "init" | "dev" | "sync" | "author" | "profile" | "validar" | "ast" | "ir" | "compilar" | "gerar" | "testar" | "diagnosticos" | "verificar" | "inspecionar" | "drift" | "impacto" | "renomear-semantico" | "importar" | "doctor" | "formatar" | "ajuda-ia" | "starter-ia" | "sync-codex" | "instalar-exemplos" | "rule-packs" | "docs-impacto" | "finalizar-mudanca" | "resumo" | "prompt-curto" | "prompt-ia" | "prompt-ia-ui" | "prompt-ia-react" | "prompt-ia-sema-primeiro" | "exemplos-prompt-ia" | "contexto-ia";
+export type Comando = "iniciar" | "init" | "dev" | "sync" | "author" | "profile" | "conteudo" | "interativo" | "descobrir" | "pipeline" | "capabilities" | "validar" | "ast" | "ir" | "compilar" | "gerar" | "testar" | "diagnosticos" | "verificar" | "inspecionar" | "drift" | "impacto" | "renomear-semantico" | "importar" | "doctor" | "formatar" | "ajuda-ia" | "starter-ia" | "sync-codex" | "instalar-exemplos" | "rule-packs" | "docs-impacto" | "finalizar-mudanca" | "resumo" | "prompt-curto" | "prompt-ia" | "prompt-ia-ui" | "prompt-ia-react" | "prompt-ia-sema-primeiro" | "exemplos-prompt-ia" | "contexto-ia";
 export interface ResultadoFormatacaoArquivo {
     caminho: string;
     alterado: boolean;

package/dist/index.part01.js

@@ -60,13 +60,47 @@ export function ajuda() {
             "sema profile validar workflow contratos/sema/workflow_ops.sema --maturidade production --preset webhook --artefato-arquivo workflow.md --json",
             "sema profile validar ops contratos/sema/workflow_ops.sema --maturidade critical --preset deploy --artefato-arquivo runbook.md --json",
             "sema profile validar game contratos/sema/game.sema --maturidade prototype --preset playtest --artefato-arquivo playtest.md --json",
+            "sema profile validar simulation contratos/sema/simulation.sema --maturidade production --preset calibration --artefato-arquivo calibration.md --json",
             "sema profile validar redacao contratos/sema/redator.sema --maturidade production --preset seo --artefato-arquivo materia.md --json",
             "sema profile validar propostas contratos/sema/propostas_comerciais.sema --maturidade production --preset score90 --artefato-arquivo proposta.md --json",
             "sema profile validar conversas contratos/sema/conversas.sema --maturidade production --preset vendas --artefato-arquivo conversa.md --json",
             "sema profile capabilities --json",
             "sema rule-packs --profile legal --json",
             "",
-            "[5] Adotar Sema em projeto que ainda não usa",
+            "[5] Descobrir a capacidade ou pipeline certo",
+            "sema descobrir catalogo --json",
+            "sema descobrir recomendar --intencao \"validar simulador 3D autonomo calibrado\" --json",
+            "sema descobrir explicar simulation.calibrate --json",
+            "sema pipeline listar --json",
+            "sema capabilities --json",
+            "",
+            "[6] Modelar jogos e simulações em qualquer combinação espacial, visual e de render",
+            "sema interativo capabilities --json",
+            "sema interativo schema --json",
+            "sema interativo pipelines --json",
+            "sema interativo adapters --spatial-model THREE_D --render-mode VISUAL --json",
+            "sema interativo validar <definition.json> --json",
+            "sema interativo planejar <definition.json> --json",
+            "sema interativo validar-evidencias <definition.json> [--plano-arquivo <plan.json>] --bundle-arquivo <bundle.json> --json",
+            "sema interativo validar-protocolo <adapter-run.json> --json",
+            "sema interativo validar-ir <experience-ir.json> --json",
+            "sema interativo consultar-ir <experience-ir.json> --semantic-id <id> --json",
+            "sema interativo validar-engine-snapshot <snapshot.json> --json",
+            "sema interativo validar-temporal <temporal.json> --json",
+            "sema interativo validar-autonomia <cycle.json> --json",
+            "sema interativo validar-playtest-fuzz <plan.json> --json",
+            "sema interativo validar-multiplayer <model.json> --json",
+            "sema interativo analisar-portabilidade <plan.json> --json",
+            "sema interativo validar-workers <plan.json> --json",
+            "",
+            "[7] Orquestrar criação de conteúdo por IA",
+            "sema conteudo capabilities --json",
+            "sema conteudo validar <definition.json> --json",
+            "sema conteudo planejar <definition.json> --alvos-arquivo <targets.json> --json",
+            "sema conteudo registrar <ledger.ndjson> --envelope-arquivo <envelope.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-id <id> --expected-head <sha256:...> --json",
+            "sema conteudo status <definition.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-arquivo <ledger.ndjson> --expected-head <sha256:...> --json",
+            "",
+            "[8] Adotar Sema em projeto que ainda não usa",
             "sema importar <fonte> <diretorio> --saida <diretorio> --json",
             "sema formatar <arquivo-ou-pasta>",
             "sema validar <arquivo-ou-pasta> --json",
@@ -81,6 +115,9 @@ export function ajuda() {
         "",
         renderizarSecaoAscii("Comandos principais", [
             "descoberta: sema inspecionar [arquivo-ou-pasta] [--json]",
+            "catálogo: sema descobrir <catalogo|recomendar|explicar> [id] [--intencao <objetivo>] [--json]",
+            "pipelines: sema pipeline <listar|descrever> [id] [--json]",
+            "todas as capacidades: sema capabilities [--json]",
             "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]",
             "impacto: sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--json]",
             "renomeação: sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--escopo <arquivo|modulo|projeto>] [--json]",
@@ -93,9 +130,11 @@ export function ajuda() {
             "verificação final: sema verificar <arquivo-ou-pasta> [--saida <diretorio-base>] [--json]",
             "formatação: sema formatar <arquivo-ou-pasta> [--check] [--json]",
             "author: sema author <iniciar|validar|briefing|revisar-cliches|validar-narrativa|validar-proibicoes> [arquivo] [--tema-sensivel] [--preset conto|romance|roteiro|lore|campanha] [--saida <arquivo>] [--texto <texto>] [--json]",
-            "profile: sema profile validar <software|workflow|ops|game|legal|research|redacao|propostas|conversas> <arquivo-ou-pasta> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
+            "profile: sema profile validar <software|workflow|ops|game|simulation|legal|research|redacao|propostas|conversas> <arquivo-ou-pasta> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
             "capabilities: sema profile capabilities [--json]",
-            "rule packs: sema rule-packs [--profile <author|software|workflow|ops|game|legal|research|redacao|propostas|conversas>] [--json]",
+            "conteúdo: sema conteudo <capabilities|validar|planejar|validar-envelope|registrar|status|projetar> [--trust-root-digest <sha256:...>] [--revocation-digest <sha256:...>] [--expected-head <sha256:...>] [opções] [--json]",
+            "interativo: sema interativo <capabilities|schema|pipelines|adapters|validar|planejar|validar-evidencias|status|validar-protocolo|extensões-P0-P2> [opções] [--json]",
+            "rule packs: sema rule-packs [--profile <author|software|workflow|ops|game|simulation|legal|research|redacao|propostas|conversas>] [--json]",
         ]),
         "",
         renderizarSecaoAscii("Ajuda IA-first", [
@@ -119,6 +158,11 @@ export function ajuda() {
             "sema author validar-proibicoes <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--json]",
             "sema profile validar <profile> <arquivo.sema> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
             "sema profile capabilities [--json]",
+            "sema descobrir <catalogo|recomendar|explicar> [id] [--intencao <objetivo>] [--json]",
+            "sema pipeline <listar|descrever> [id] [--json]",
+            "sema capabilities [--json]",
+            "sema interativo <capabilities|schema|pipelines|adapters|validar|planejar|validar-evidencias|status|validar-protocolo|extensões-P0-P2> [opções] [--json]",
+            "sema conteudo <capabilities|validar|planejar|validar-envelope|registrar|status|projetar> [--trust-root-digest <sha256:...>] [--revocation-digest <sha256:...>] [--expected-head <sha256:...>] [opções] [--json]",
             "sema rule-packs [--profile <profile>] [--json]",
         ]),
         "",

package/dist/index.part06.js

@@ -203,6 +203,9 @@ export async function comandoAjudaIa() {
     console.log("");
     console.log(renderizarSecaoAscii("Fluxo recomendado", [
         "Use `sema starter-ia` para um texto curto de onboarding.",
+        "Use `sema descobrir recomendar --intencao <objetivo> --json` quando ainda não souber qual profile, workflow, pipeline, gerador ou adaptador usar.",
+        "Use `sema descobrir catalogo --json` ou `sema capabilities --json` para expor o mapa completo de capacidades à IA.",
+        "Use `sema interativo pipelines --json` para jogos, simulações e híbridos 3D, 2D, retro, texto, XR ou headless.",
         "Use `sema sync-codex` para regenerar o contexto governado do Codex na raiz.",
         "Use `sema instalar-exemplos` para materializar `exemplos/` oficiais sem sobrescrever arquivos locais.",
         "Use `sema resumo <arquivo> --micro --para onboarding --json` para IA fraca; o resumo vem no stdout.",

package/dist/initTemplatesBase.js

@@ -77,14 +77,15 @@ Antes de alterar codigo, contrato ou documentacao:
 3. rode \`sema resumo\`;
 4. rode \`sema docs-impacto --intencao "<acao>" --json\`;
 5. leia \`docs/commands.md\` antes de escolher comando ou interpretar \`--saida\`;
-6. use \`exemplos/\` e \`docs/syntax.md\` antes de criar ou corrigir \`.sema\`.
+6. use \`sema descobrir recomendar --intencao "<objetivo>" --json\` quando não souber qual capacidade ou pipeline aplicar;
+7. use \`exemplos/\` e \`docs/syntax.md\` antes de criar ou corrigir \`.sema\`.
 
 ## Estrutura criada
 
 - \`contratos/\`: contratos semanticamente governados.
 - \`AGENTS.md\`: entrypoint oficial do Codex.
 - \`exemplos/\`: exemplos oficiais da DSL Sema.
-- \`docs/commands.md\`: catalogo de comandos, gates e regra de \`--saida\`.
+- \`docs/commands.md\`: catalogo de comandos, pipelines, gates e regra de \`--saida\`.
 - \`docs/syntax.md\`: referencia curta para escrever \`.sema\`.
 - \`docs/ai-workflow.md\`: fluxo minimo para agentes.
 - \`SEMA_BOOT.md\`, \`SEMA_SMALL_MODEL.md\`, \`AGENT_CONTEXT_PACK.json\` e \`SEMA_INDEX.json\`: contexto IA-first.

package/dist/pipelineConteudo/adapters.d.ts

@@ -0,0 +1,84 @@
+import type { AdaptadorConteudo, AlvoConteudo, ArtefatoConteudo, MetadataPublicaConteudo, RestricaoDeterministicaConteudo } from "./types.js";
+/**
+ * Vocabulário inicial para definições usuais. O validador aceita qualquer
+ * capability opaca não vazia; esta lista não é uma whitelist.
+ */
+export declare const CAPABILITIES_CONTEUDO_PADRAO: readonly ["content.topic.plan", "content.research.collect", "content.master.compose", "content.target.adapt", "content.qa.deterministic", "content.qa.semantic", "content.target.deliver", "content.target.confirm"];
+export declare const CONSTRAINTS_DETERMINISTICAS_SUPORTADAS: readonly ["artifact.bytes.min", "artifact.bytes.max", "media.duration.min", "media.duration.max", "text.length.min", "text.length.max"];
+export interface ObservacoesDeterministicasArtefatoConteudo {
+    /** Media type observado por sniffing/verificador independente. */
+    readonly observedMediaType?: string;
+    /** Tamanho materializado do artefato, em bytes. */
+    readonly artifactBytes?: number;
+    /** Duração observada da mídia, em segundos. */
+    readonly mediaDuration?: number;
+    /** Comprimento textual observado, em pontos de código Unicode. */
+    readonly textLength?: number;
+}
+export interface ResultadoConstraintDeterministicaConteudo {
+    readonly constraintId: string;
+    readonly kind: string;
+    readonly observed: number | null;
+    readonly limit: number | null;
+    readonly passed: boolean;
+    readonly bloqueios: readonly string[];
+}
+export interface ResultadoAvaliacaoConstraintsConteudo {
+    readonly valido: boolean;
+    readonly artifactDigest: string;
+    readonly constraintsDigest: string;
+    readonly resultsDigest: string;
+    readonly resultados: readonly ResultadoConstraintDeterministicaConteudo[];
+    readonly bloqueios: readonly string[];
+}
+export interface ResultadoValidacaoAdaptadorConteudo {
+    readonly valido: boolean;
+    readonly bloqueios: readonly string[];
+}
+export interface PlanoAdaptacaoConteudo {
+    readonly targetId: string;
+    readonly adapterId: string;
+    readonly adapterVersion: string;
+    readonly accountScope: string;
+    readonly isolationKey: string;
+    readonly formatProfileId: string;
+    readonly locale: string;
+    readonly capabilities: readonly string[];
+    readonly acceptedMediaTypes: readonly string[];
+    readonly deterministicConstraints: readonly RestricaoDeterministicaConteudo[];
+    readonly requiredMetadata: readonly string[];
+    readonly optionalMetadata: readonly string[];
+    readonly confirmationPredicates: readonly string[];
+    readonly metadata: MetadataPublicaConteudo;
+    readonly masterArtifacts: readonly unknown[];
+}
+export interface BloqueioAlvoConteudo {
+    readonly targetId: string;
+    readonly codigo: string;
+}
+export interface ResultadoPlanejamentoAlvosConteudo {
+    readonly planosAdaptacao: readonly PlanoAdaptacaoConteudo[];
+    readonly bloqueiosPorAlvo: readonly BloqueioAlvoConteudo[];
+}
+export declare function validarReferenciaAccountScopeConteudo(valor: unknown): readonly string[];
+/** Metadata de target e publica no plano/ledger/projecao; segredos sao sempre externos. */
+export declare function validarMetadataPublicaConteudo(valor: unknown): readonly string[];
+/**
+ * Escopo exato e injetivo para autorização target-bound. Alterar execução,
+ * target ou conta sempre altera o escopo.
+ */
+export declare function escopoAutorizacaoAlvo(runId: string, alvo: AlvoConteudo): string;
+export declare function escopoAutorizacaoGlobal(runId: string): string;
+/**
+ * Avalia somente medições fornecidas. Não lê arquivos, não chama ferramentas e
+ * nunca trata um kind desconhecido como aprovação implícita.
+ */
+export declare function avaliarConstraintsDeterministicasConteudo(artefato: ArtefatoConteudo, constraints: readonly RestricaoDeterministicaConteudo[], observacoes?: ObservacoesDeterministicasArtefatoConteudo): ResultadoAvaliacaoConstraintsConteudo;
+/** Valida somente propriedades declarativas; nenhuma capability é executada. */
+export declare function validarAdaptadorConteudo(adapter: AdaptadorConteudo): ResultadoValidacaoAdaptadorConteudo;
+/**
+ * Materializa um plano isolado por targetId/accountScope. Os planos carregam
+ * instruções e referências; credenciais e chamadas de ferramenta ficam no
+ * runner externo.
+ */
+export declare function planejarAlvosConteudo(alvos: readonly AlvoConteudo[], adapters: readonly AdaptadorConteudo[], artefatosMestre: readonly unknown[]): ResultadoPlanejamentoAlvosConteudo;