@semacode/cli 1.5.30 → 1.5.32

package/dist/runnerValidacaoRemotaTipos.d.ts

@@ -0,0 +1,158 @@
+import type { Server } from "node:http";
+export type ModoVerificacaoRemota = "CONTRATOS_APENAS" | "CODIGO_SELECIONADO" | "CODIGO_COMPLETO";
+export type StatusJobVerificacao = "APROVADO" | "BLOQUEADO" | "FALHOU";
+export type AmbienteRunner = "VPS" | "WORKER_CONTAINER" | "WORKTREE_ISOLADO";
+export interface ArquivoSnapshotRemoto {
+    caminho: string;
+    conteudo: string;
+    tipo?: string;
+    hash?: string;
+}
+export interface ComandoProjetoRemoto {
+    comando: string;
+    args?: string[];
+}
+export interface SnapshotProjetoRemoto {
+    origem: string;
+    tenant: string;
+    modo: ModoVerificacaoRemota;
+    contratos: ArquivoSnapshotRemoto[];
+    codigo: ArquivoSnapshotRemoto[];
+    documentacao: ArquivoSnapshotRemoto[];
+    indice: string[];
+    segredos_detectados: string[];
+    politica_segredos: string;
+    contrato_alvo?: string;
+    comandos_projeto: ComandoProjetoRemoto[];
+}
+export interface WorkspaceRunner {
+    id: string;
+    ambiente: AmbienteRunner;
+    caminho: string;
+    tenant: string;
+    isolamento: string;
+    expira_em: string;
+}
+export interface ArtefatoVerificacaoRemota {
+    nome: string;
+    tipo: string;
+    caminho: string;
+    hash: string;
+    publico: boolean;
+}
+export interface ComandoExecutadoRunner {
+    nome: string;
+    args: string[];
+    codigoSaida: number;
+    stdoutArquivo: string;
+    stderrArquivo: string;
+    duracaoMs: number;
+    sucesso: boolean;
+}
+export type EscopoDriftRunner = "projeto" | "nao_executado";
+export interface EscopoEvidenciaRemota {
+    origem_snapshot: string;
+    tenant: string;
+    workspace_id: string;
+    workspace_caminho: string;
+    modo_verificacao: ModoVerificacaoRemota;
+    contrato_alvo: string | null;
+    entrada_sema: string;
+    escopo_drift: EscopoDriftRunner;
+    fontes_conclusao: string[];
+    codigo_verificado: boolean;
+    testes_projeto_executados: boolean;
+    comando_drift: string;
+    conclusao_limpa_autorizada: boolean;
+    ressalva_escopo: string;
+}
+export interface RelatorioVerificacaoRemota {
+    job_id: string;
+    modo: ModoVerificacaoRemota;
+    status: StatusJobVerificacao;
+    score_semantico: number;
+    diagnosticos: string[];
+    avisos_alta_severidade: string[];
+    comandos_executados: ComandoExecutadoRunner[];
+    artefatos: ArtefatoVerificacaoRemota[];
+    escopo_evidencia: EscopoEvidenciaRemota;
+    resumo_ia: string;
+}
+export interface ResultadoRecebimentoSnapshot {
+    snapshot: SnapshotProjetoRemoto;
+    modo_verificacao: ModoVerificacaoRemota;
+    pronto_para_workspace: boolean;
+    bloqueios: string[];
+}
+export interface ResultadoProvisionamentoWorkspace {
+    workspace: WorkspaceRunner;
+    isolamento_ok: boolean;
+    limpeza_agendada: boolean;
+    bloqueios: string[];
+}
+export interface ResultadoPublicacaoRelatorio {
+    resumo_ia: string;
+    url_relatorio: string;
+    artefatos_publicados: ArtefatoVerificacaoRemota[];
+    redacao_ok: boolean;
+    bloqueios: string[];
+}
+export interface ResultadoFechamentoJob {
+    concluido: boolean;
+    pode_liberar: boolean;
+    decisao_agente: "continuar" | "continuar_com_ressalva" | "parar" | "chamar_humano";
+    proximas_acoes: string[];
+    bloqueios: string[];
+}
+export interface ResultadoRunnerValidacaoRemota {
+    comando: "runner validar-remoto";
+    sucesso: boolean;
+    status: StatusJobVerificacao;
+    podeLiberar: boolean;
+    jobId: string;
+    modo: ModoVerificacaoRemota;
+    snapshot: {
+        origem: string;
+        tenant: string;
+        contratos: number;
+        codigo: number;
+        documentacao: number;
+    };
+    workspace: WorkspaceRunner | null;
+    workspaceRemovido: boolean;
+    relatorio: RelatorioVerificacaoRemota;
+    publicacao: ResultadoPublicacaoRelatorio;
+    fechamento: ResultadoFechamentoJob;
+    relatorioArquivo: string;
+}
+export interface OpcoesRunnerValidacaoRemota {
+    saida: string;
+    cwd: string;
+    manterWorkspace: boolean;
+    modoOverride?: ModoVerificacaoRemota;
+    contratoAlvo?: string;
+    timeoutMs?: number;
+}
+export interface OpcoesServidorRunnerValidacaoRemota {
+    cwd: string;
+    host: string;
+    porta: number;
+    saida: string;
+    token?: string;
+}
+export interface ServidorRunnerValidacaoRemota {
+    server: Server;
+    host: string;
+    porta: number;
+    url: string;
+    authObrigatoria: boolean;
+}
+export interface EntradaSnapshotRemoto {
+    [key: string]: unknown;
+}
+export declare const MODOS_VALIDOS: Set<ModoVerificacaoRemota>;
+export declare const AMBIENTE_PADRAO: AmbienteRunner;
+export declare const TIMEOUT_COMANDO_PADRAO_MS = 120000;
+export declare const PREFIXO_WORKSPACE = "sema-runner-";
+export declare const DIRETORIOS_PROIBIDOS: Set<string>;
+export declare const COMANDOS_PROJETO_PERMITIDOS: Set<string>;

package/dist/runnerValidacaoRemotaTipos.js

@@ -0,0 +1,35 @@
+export const MODOS_VALIDOS = new Set(["CONTRATOS_APENAS", "CODIGO_SELECIONADO", "CODIGO_COMPLETO"]);
+export const AMBIENTE_PADRAO = "WORKTREE_ISOLADO";
+export const TIMEOUT_COMANDO_PADRAO_MS = 120_000;
+export const PREFIXO_WORKSPACE = "sema-runner-";
+export const DIRETORIOS_PROIBIDOS = new Set([
+    ".git",
+    ".hg",
+    ".svn",
+    ".next",
+    ".nuxt",
+    ".turbo",
+    ".cache",
+    ".pytest_cache",
+    ".venv",
+    "build",
+    "coverage",
+    "dist",
+    "node_modules",
+    "vendor",
+]);
+export const COMANDOS_PROJETO_PERMITIDOS = new Set([
+    "npm",
+    "pnpm",
+    "yarn",
+    "node",
+    "python",
+    "py",
+    "pytest",
+    "go",
+    "cargo",
+    "dotnet",
+    "mvn",
+    "gradle",
+]);
+//# sourceMappingURL=runnerValidacaoRemotaTipos.js.map

package/dist/runnerValidacaoRemotaTipos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerValidacaoRemotaTipos.js","sourceRoot":"","sources":["../src/runnerValidacaoRemotaTipos.ts"],"names":[],"mappings":"AA4KA,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAwB,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAC3H,MAAM,CAAC,MAAM,eAAe,GAAmB,kBAAkB,CAAC;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IAC1C,MAAM;IACN,KAAK;IACL,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,eAAe;IACf,OAAO;IACP,OAAO;IACP,UAAU;IACV,MAAM;IACN,cAAc;IACd,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IACjD,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,KAAK;IACL,QAAQ;CACT,CAAC,CAAC"}

package/dist/runnerValidacaoRemotaUtil.d.ts

@@ -0,0 +1,3 @@
+export declare function hashTexto(texto: string): string;
+export declare function hashArquivo(caminho: string): Promise<string>;
+export declare function verificarArquivoExiste(caminho: string): Promise<boolean>;

package/dist/runnerValidacaoRemotaUtil.js

@@ -0,0 +1,18 @@
+import { createHash } from "node:crypto";
+import { readFile, stat } from "node:fs/promises";
+export function hashTexto(texto) {
+    return createHash("sha256").update(texto).digest("hex");
+}
+export async function hashArquivo(caminho) {
+    return hashTexto(await readFile(caminho, "utf8"));
+}
+export async function verificarArquivoExiste(caminho) {
+    try {
+        await stat(caminho);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=runnerValidacaoRemotaUtil.js.map

package/dist/runnerValidacaoRemotaUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerValidacaoRemotaUtil.js","sourceRoot":"","sources":["../src/runnerValidacaoRemotaUtil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe;IAC/C,OAAO,SAAS,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAe;IAC1D,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/runnerValidacaoRemotaWorkspace.d.ts

@@ -0,0 +1,2 @@
+import { type AmbienteRunner, type ResultadoProvisionamentoWorkspace, type SnapshotProjetoRemoto } from "./runnerValidacaoRemotaTipos.js";
+export declare function provisionarWorkspaceRunner(snapshot: SnapshotProjetoRemoto, ambiente?: AmbienteRunner): Promise<ResultadoProvisionamentoWorkspace>;

package/dist/runnerValidacaoRemotaWorkspace.js

@@ -0,0 +1,110 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, mkdtemp, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { AMBIENTE_PADRAO, PREFIXO_WORKSPACE } from "./runnerValidacaoRemotaTipos.js";
+import { dedupe } from "./runnerValidacaoRemotaSnapshot.js";
+import { hashTexto } from "./runnerValidacaoRemotaUtil.js";
+async function escreverArquivoRelativoSeguro(base, arquivo) {
+    const destino = path.resolve(base, ...arquivo.caminho.split("/"));
+    const relativo = path.relative(base, destino);
+    if (relativo.startsWith("..") || path.isAbsolute(relativo)) {
+        throw new Error(`Caminho fora do workspace recusado: ${arquivo.caminho}`);
+    }
+    await mkdir(path.dirname(destino), { recursive: true });
+    await writeFile(destino, arquivo.conteudo, "utf8");
+}
+function inferirOrigensContratos(contratos) {
+    const origens = contratos.map((arquivo) => {
+        const partes = arquivo.caminho.split("/");
+        if (partes[0] === "contratos" || partes[0] === "contracts" || partes[0] === "sema") {
+            return `./${partes[0]}`;
+        }
+        const dir = path.posix.dirname(arquivo.caminho);
+        return dir === "." ? "." : `./${dir}`;
+    });
+    return dedupe(origens);
+}
+function inferirDiretoriosCodigoSnapshot(codigo) {
+    const dirs = codigo.map((arquivo) => {
+        const partes = arquivo.caminho.split("/");
+        return partes.length > 1 ? `./${partes[0]}` : ".";
+    });
+    return dedupe(dirs);
+}
+function inferirFontesLegadoSnapshot(codigo) {
+    const fontes = new Set();
+    for (const arquivo of codigo) {
+        const caminho = arquivo.caminho.toLowerCase();
+        if (/\.(ts|tsx|js|jsx|mjs|cjs)$/.test(caminho)) {
+            fontes.add("typescript");
+        }
+        if (caminho.endsWith(".py")) {
+            fontes.add("python");
+        }
+        if (caminho.endsWith(".dart")) {
+            fontes.add("dart");
+        }
+        if (caminho.endsWith(".lua")) {
+            fontes.add("lua");
+        }
+        if (caminho.endsWith(".cs")) {
+            fontes.add("dotnet");
+        }
+        if (caminho.endsWith(".java")) {
+            fontes.add("java");
+        }
+        if (caminho.endsWith(".go")) {
+            fontes.add("go");
+        }
+        if (caminho.endsWith(".rs")) {
+            fontes.add("rust");
+        }
+        if (/\.(cpp|cc|cxx|hpp|h)$/.test(caminho)) {
+            fontes.add("cpp");
+        }
+    }
+    return [...fontes].sort((a, b) => a.localeCompare(b, "pt-BR"));
+}
+export async function provisionarWorkspaceRunner(snapshot, ambiente = AMBIENTE_PADRAO) {
+    const caminho = await mkdtemp(path.join(os.tmpdir(), PREFIXO_WORKSPACE));
+    const workspace = {
+        id: randomUUID(),
+        ambiente,
+        caminho,
+        tenant: snapshot.tenant,
+        isolamento: "tmpdir_efemero_sem_home_host_sem_docker_socket",
+        expira_em: new Date(Date.now() + 60 * 60 * 1000).toISOString(),
+    };
+    for (const arquivo of [...snapshot.contratos, ...snapshot.codigo, ...snapshot.documentacao]) {
+        await escreverArquivoRelativoSeguro(caminho, arquivo);
+    }
+    await mkdir(path.join(caminho, ".sema-runner"), { recursive: true });
+    await writeFile(path.join(caminho, ".sema-runner", "snapshot.json"), `${JSON.stringify({
+        origem: snapshot.origem,
+        tenant: snapshot.tenant,
+        modo: snapshot.modo,
+        indice: snapshot.indice,
+        contratos: snapshot.contratos.map((arquivo) => ({ caminho: arquivo.caminho, hash: hashTexto(arquivo.conteudo) })),
+        codigo: snapshot.codigo.map((arquivo) => ({ caminho: arquivo.caminho, hash: hashTexto(arquivo.conteudo) })),
+        documentacao: snapshot.documentacao.map((arquivo) => ({ caminho: arquivo.caminho, hash: hashTexto(arquivo.conteudo) })),
+    }, null, 2)}\n`, "utf8");
+    await writeFile(path.join(caminho, "sema.config.json"), `${JSON.stringify({
+        origens: inferirOrigensContratos(snapshot.contratos),
+        saida: "./generated",
+        alvos: ["typescript"],
+        alvoPadrao: "typescript",
+        framework: "base",
+        estruturaSaida: "modulos",
+        diretoriosCodigo: inferirDiretoriosCodigoSnapshot(snapshot.codigo),
+        fontesLegado: inferirFontesLegadoSnapshot(snapshot.codigo),
+        modoAdocao: "incremental",
+    }, null, 2)}\n`, "utf8");
+    return {
+        workspace,
+        isolamento_ok: true,
+        limpeza_agendada: true,
+        bloqueios: [],
+    };
+}
+//# sourceMappingURL=runnerValidacaoRemotaWorkspace.js.map

package/dist/runnerValidacaoRemotaWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerValidacaoRemotaWorkspace.js","sourceRoot":"","sources":["../src/runnerValidacaoRemotaWorkspace.ts"],"names":[],"mappings":"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"}

package/dist/sync/index.d.ts

@@ -0,0 +1,24 @@
+export interface MapeamentoTipo {
+    semaTipo: string;
+    prismaTipo: string;
+    atributosPrisma: string[];
+}
+export declare function mapearTiposSemaPrisma(): {
+    mapeamentos: MapeamentoTipo[];
+    cobertura: number;
+};
+export declare function gerarSchemaPrisma(pastaContratos: string, saidaSchema: string, datasourceProvider?: string): Promise<{
+    schemaGerado: string;
+    modelsGerados: number;
+    enumsGerados: number;
+}>;
+export declare function importarSchemaPrisma(caminhoSchema: string, pastaSaida: string, nomeModulo: string): Promise<{
+    contratosGerados: string[];
+    entitiesCriadas: number;
+}>;
+export declare function compararDivergencias(pastaContratos: string, caminhoSchema: string): Promise<{
+    divergencias: string[];
+    total: number;
+    breaking: number;
+}>;
+export declare function comandoSyncPrisma(args: string[]): Promise<void>;

package/dist/sync/index.js

@@ -0,0 +1,174 @@
+// Sync Sema ↔ Prisma
+// Contrato: cli_sync_prisma.sema
+import * as fs from 'fs';
+import * as path from 'path';
+const MAPEAMENTO_TIPOS = [
+    { semaTipo: 'Id', prismaTipo: 'String', atributosPrisma: ['@id', '@default(uuid())'] },
+    { semaTipo: 'Texto', prismaTipo: 'String', atributosPrisma: [] },
+    { semaTipo: 'Email', prismaTipo: 'String', atributosPrisma: [] },
+    { semaTipo: 'Decimal', prismaTipo: 'Decimal', atributosPrisma: [] },
+    { semaTipo: 'Inteiro', prismaTipo: 'Int', atributosPrisma: [] },
+    { semaTipo: 'Booleano', prismaTipo: 'Boolean', atributosPrisma: [] },
+    { semaTipo: 'Timestamp', prismaTipo: 'DateTime', atributosPrisma: [] },
+    { semaTipo: 'Lista', prismaTipo: 'String[]', atributosPrisma: [] },
+    { semaTipo: 'Mapa', prismaTipo: 'Json', atributosPrisma: [] },
+];
+export function mapearTiposSemaPrisma() {
+    return {
+        mapeamentos: MAPEAMENTO_TIPOS,
+        cobertura: 0.85
+    };
+}
+function semaParaPrismaTipo(semaTipo) {
+    const mapeamento = MAPEAMENTO_TIPOS.find(m => m.semaTipo === semaTipo);
+    if (!mapeamento)
+        return 'String'; // fallback
+    const atributos = mapeamento.atributosPrisma.length > 0
+        ? ' ' + mapeamento.atributosPrisma.join(' ')
+        : '';
+    return `${mapeamento.prismaTipo}${atributos}`;
+}
+export async function gerarSchemaPrisma(pastaContratos, saidaSchema, datasourceProvider = 'postgresql') {
+    // Verificar pasta
+    if (!fs.existsSync(pastaContratos)) {
+        throw new Error(`Pasta nao existe: ${pastaContratos}`);
+    }
+    const arquivos = fs.readdirSync(pastaContratos);
+    const contratos = arquivos.filter(f => f.endsWith('.sema'));
+    if (contratos.length === 0) {
+        throw new Error('Nenhum contrato .sema encontrado');
+    }
+    // Gerar schema basico
+    let models = '';
+    let modelCount = 0;
+    for (const contrato of contratos) {
+        const nomeModel = path.basename(contrato, '.sema').replace(/\./g, '_');
+        // Schema simplificado - em producao, fazer parsing real do contrato
+        models += `\nmodel ${nomeModel.charAt(0).toUpperCase() + nomeModel.slice(1)} {
+  id        String   @id @default(uuid())
+  criadoEm  DateTime @default(now())
+  // Gerado a partir de: ${contrato}
+  // TODO: Adicionar campos do contrato Sema
+}\n`;
+        modelCount++;
+    }
+    const schema = `// Gerado automaticamente pelo Sema
+// Fonte: ${pastaContratos}
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "${datasourceProvider}"
+  url      = env("DATABASE_URL")
+}
+${models}`;
+    // Salvar
+    fs.writeFileSync(saidaSchema, schema, 'utf-8');
+    return {
+        schemaGerado: schema,
+        modelsGerados: modelCount,
+        enumsGerados: 0
+    };
+}
+export async function importarSchemaPrisma(caminhoSchema, pastaSaida, nomeModulo) {
+    if (!fs.existsSync(caminhoSchema)) {
+        throw new Error(`Schema nao existe: ${caminhoSchema}`);
+    }
+    const schema = fs.readFileSync(caminhoSchema, 'utf-8');
+    // Extrair models (regex simplificado)
+    const modelMatches = schema.match(/model\s+(\w+)\s*\{([^}]+)\}/g) || [];
+    const contratos = [];
+    for (const match of modelMatches) {
+        const nomeMatch = match.match(/model\s+(\w+)/);
+        if (!nomeMatch)
+            continue;
+        const nomeModel = nomeMatch[1];
+        const nomeContrato = `${nomeModel.toLowerCase()}.sema`;
+        const caminhoContrato = path.join(pastaSaida, nomeContrato);
+        // Gerar contrato basico
+        const conteudo = `module ${nomeModulo}.${nomeModel.toLowerCase()} {
+  entity ${nomeModel} {
+    fields {
+      id: Id
+      // TODO: Mapear campos do schema Prisma
+    }
+  }
+
+  task criar_${nomeModel.toLowerCase()} {
+    input {
+      // TODO: Definir inputs
+    }
+    output {
+      ${nomeModel.toLowerCase()}: ${nomeModel}
+    }
+    effects {
+      persistencia ${nomeModel}
+    }
+  }
+}`;
+        fs.writeFileSync(caminhoContrato, conteudo, 'utf-8');
+        contratos.push(caminhoContrato);
+    }
+    return {
+        contratosGerados: contratos,
+        entitiesCriadas: modelMatches.length
+    };
+}
+export async function compararDivergencias(pastaContratos, caminhoSchema) {
+    // Implementacao simplificada
+    const divergencias = [];
+    // Verificar se ambos existem
+    if (!fs.existsSync(pastaContratos)) {
+        divergencias.push('Pasta de contratos nao existe');
+    }
+    if (!fs.existsSync(caminhoSchema)) {
+        divergencias.push('Schema Prisma nao existe');
+    }
+    return {
+        divergencias,
+        total: divergencias.length,
+        breaking: 0
+    };
+}
+// Handlers CLI
+export async function comandoSyncPrisma(args) {
+    const gerarIdx = args.indexOf('--gerar');
+    const importarIdx = args.indexOf('--importar');
+    const compararIdx = args.indexOf('--comparar');
+    if (gerarIdx !== -1) {
+        const pasta = args[gerarIdx + 1] || 'contratos/';
+        const saida = args[gerarIdx + 2] || 'prisma/schema.prisma';
+        const resultado = await gerarSchemaPrisma(pasta, saida);
+        console.log(`\n✅ Schema gerado: ${saida}`);
+        console.log(`   Models: ${resultado.modelsGerados}`);
+    }
+    else if (importarIdx !== -1) {
+        const schema = args[importarIdx + 1];
+        const saida = args[importarIdx + 2] || 'contratos/importados/';
+        const modulo = args[importarIdx + 3] || 'legacy';
+        if (!schema) {
+            console.error('Uso: sema sync prisma --importar <schema.prisma> [saida] [modulo]');
+            process.exit(1);
+        }
+        fs.mkdirSync(saida, { recursive: true });
+        const resultado = await importarSchemaPrisma(schema, saida, modulo);
+        console.log(`\n✅ Importado: ${resultado.contratosGerados.length} contratos`);
+    }
+    else if (compararIdx !== -1) {
+        const pasta = args[compararIdx + 1] || 'contratos/';
+        const schema = args[compararIdx + 2] || 'prisma/schema.prisma';
+        const resultado = await compararDivergencias(pasta, schema);
+        console.log(`\n📊 Divergencias: ${resultado.total}`);
+        if (resultado.divergencias.length > 0) {
+            resultado.divergencias.forEach(d => console.log(`   - ${d}`));
+        }
+    }
+    else {
+        console.log('Uso: sema sync prisma --gerar [pasta] [saida]');
+        console.log('     sema sync prisma --importar <schema> [saida] [modulo]');
+        console.log('     sema sync prisma --comparar [pasta] [schema]');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"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"}

package/docs/AGENT_STARTER.md

@@ -0,0 +1,109 @@
+# AGENT_STARTER
+
+<!-- sema:i18n -->
+> EN: English first. The canonical operational body below may still be in Portuguese until full translation lands.
+> PT: Português depois, com acentos preservados.
+> ES: Español al final; não traduza comandos, rotas nem sómbolos `.sema` sem contrato.
+
+
+Use este texto como starter curto para qualquer IA antes de editar `.sema`.
+
+Ordem canonica de entrada no repo:
+
+1. `llms.txt`
+2. `SEMA_BRIEF.md`
+3. `SEMA_INDEX.json`
+4. `AGENTS.md`
+5. `README.md`
+
+Roteamento por capacidade:
+
+- IA pequena ou gratuita: `llms.txt` -> `SEMA_BRIEF.micro.txt` -> `SEMA_INDEX.json`
+- IA média: `llms.txt` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json` -> `README.md`
+- IA grande ou com tool use: `llms-full.txt` -> `SEMA_BRIEF.md` -> `SEMA_INDEX.json` -> `AGENTS.md` -> `README.md`
+
+Tres modos de uso da Sema:
+
+- projeto novo: modele, valide, compile e verifique antes de subir código derivado
+- projeto já semantizado: inspecione, leia resumo, rode drift e gere contexto antes de editar
+- legado sem Sema: importe, revise o rascunho, formate, valide e use drift como arbitro da adoção incremental
+
+Para manter os artefatos gerados da raiz sincronizados:
+
+- `sema sync-ai-entrypoints --json`
+
+```text
+Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.
+
+Importante:
+- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana
+- humanos sao autores/aprovadores; agentes sao os consumidores primarios do contrato
+- a Sema funciona como camada de navegacao operacional para agente, nao como runtime magico
+- leitura humana e bonus toleravel, nao centro do produto
+- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
+- a Sema gera codigo e scaffolding real para TypeScript, Python e Dart
+- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico
+- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo
+- a Sema usa `impl` para ligar task a simbolo real do runtime
+- a Sema usa `resumo` e `prompt-curto` para IA pequena ou gratuita
+- a Sema pode servir de base para interfaces graficas elegantes e coerentes
+- a primeira onda consumer oficial agora cobre `Next.js consumer`, `React/Vite consumer`, `Angular consumer` e `flutter-consumer`
+- esses slices oficiais cobrem `consumer bridge + superficies rastreaveis`, nao geracao completa de UI
+- a proxima camada semantica de front (`screen`, `action`, `query`, `form`, `navigation`) esta documentada como roadmap, nao como sintaxe oficial ja suportada
+- trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto
+- nao cobre da Sema persistencia real, runtime ou smoke test automatico; isso continua sendo engenharia viva
+- se a tarefa envolver UI, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivo aleatorio
+- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
+
+Regras:
+- nao invente sintaxe fora da gramatica e dos exemplos oficiais
+- se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
+- trate `ir --json` como fonte de verdade semantica
+- trate `diagnosticos --json` como fonte de correcao
+- use `sema formatar` como fonte unica de estilo
+- preserve a intencao do contrato
+- nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo
+
+Comandos essenciais:
+- resumo por capacidade: `sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`
+- prompt curto: `sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`
+- contexto completo do modulo: `sema contexto-ia <arquivo.sema>`
+- estrutura sintatica: `sema ast <arquivo.sema> --json`
+- estrutura semantica: `sema ir <arquivo.sema> --json`
+- validacao: `sema validar <arquivo.sema> --json`
+- diagnosticos: `sema diagnosticos <arquivo.sema> --json`
+- formatacao: `sema formatar <arquivo.sema>`
+- importacao assistida de legado: `sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|typescript|python|dart|dotnet|java|go|rust|cpp> <diretorio> --saida <diretorio>`
+- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart> --saida <diretorio>`
+- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`
+
+Regra pratica de ouro:
+- se a tarefa pedir codigo derivado, `sema compilar` e obrigatorio
+- se a tarefa partir de projeto que nao nasceu com Sema, `sema importar` deve entrar antes da lapidacao semantica
+- se a tarefa pedir apenas leitura ou correcao sem gerar codigo, `sema compilar` pode ficar fora
+
+Antes de editar:
+1. leia README, docs de IA e um exemplo oficial parecido
+2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
+3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
+
+Depois de editar:
+1. rode `sema formatar`
+2. rode `sema validar --json`
+3. se houver falha, use `diagnosticos --json`
+4. se a tarefa pedir codigo derivado, rode `sema compilar`
+5. feche com `sema verificar <arquivo-ou-pasta> --json`
+
+Priorize sempre:
+- exemplos oficiais
+- JSON da CLI
+- consistencia semantica
+
+Nao improvise quando faltar contexto.
+```
+
+Documentos de apoio:
+
+- [como-ensinar-a-sema-para-ia.md](./como-ensinar-a-sema-para-ia.md)
+- [prompt-base-ia-sema.md](./prompt-base-ia-sema.md)
+- [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)