@semacode/cli 1.5.53 → 1.5.55

package/dist/index.part06.js

@@ -206,7 +206,7 @@ export async function comandoAjudaIa() {
         "Use `sema docs-impacto --intencao <acao>` para ler ou criar docs obrigatorias antes de agir.",
         "Use `sema finalizar-mudanca --intencao <acao>` para bloquear conclusao sem leitura documental comprovada.",
         "Use `sema contexto-ia <arquivo.sema>` para gerar AST, IR, drift, `briefing.json` e `briefing.min.json`.",
-        "Use `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>` quando a tarefa pedir codigo derivado.",
+        "Use `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css> --saida <diretorio>` quando a tarefa pedir codigo derivado.",
     ]));
     console.log("");
     console.log(renderizarSecaoAscii("Regras praticas", [

package/dist/index.part08.js

@@ -121,7 +121,7 @@ export async function principal() {
             {
                 const fonte = normalizarFonteImportacao(posicionais[0]);
                 if (!fonte || !posicionais[1]) {
-                    console.error("Uso: sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]");
+                    console.error("Uso: sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|php|typescript|python|dart> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]");
                     codigoSaida = 1;
                     break;
                 }

package/dist/initTemplatesBase.js

@@ -118,7 +118,7 @@ export function arquivosTemplateIniciar(template) {
         ?? [
             {
                 caminhoRelativo: "sema.config.json",
-                conteudo: "{\n  \"origens\": [\"./contratos\"],\n  \"saida\": \"./generated\",\n  \"alvos\": [\"typescript\", \"javascript\", \"python\", \"dart\", \"lua\", \"html\", \"css\"],\n  \"alvoPadrao\": \"typescript\",\n  \"estruturaSaida\": \"modulos\",\n  \"framework\": \"base\",\n  \"modoEstrito\": true,\n  \"diretoriosSaidaPorAlvo\": {\n    \"typescript\": \"./generated/typescript\",\n    \"javascript\": \"./generated/javascript\",\n    \"python\": \"./generated/python\",\n    \"dart\": \"./generated/dart\",\n    \"lua\": \"./generated/lua\",\n    \"html\": \"./generated/html\",\n    \"css\": \"./generated/css\"\n  },\n  \"convencoesGeracaoPorProjeto\": \"base\"\n}\n",
+                conteudo: "{\n  \"origens\": [\"./contratos\"],\n  \"saida\": \"./generated\",\n  \"alvos\": [\"typescript\", \"javascript\", \"python\", \"php\", \"dart\", \"lua\", \"html\", \"css\"],\n  \"alvoPadrao\": \"typescript\",\n  \"estruturaSaida\": \"modulos\",\n  \"framework\": \"base\",\n  \"modoEstrito\": true,\n  \"diretoriosSaidaPorAlvo\": {\n    \"typescript\": \"./generated/typescript\",\n    \"javascript\": \"./generated/javascript\",\n    \"python\": \"./generated/python\",\n    \"php\": \"./generated/php\",\n    \"dart\": \"./generated/dart\",\n    \"lua\": \"./generated/lua\",\n    \"html\": \"./generated/html\",\n    \"css\": \"./generated/css\"\n  },\n  \"convencoesGeracaoPorProjeto\": \"base\"\n}\n",
             },
             ...arquivosBase,
         ];

package/dist/php-http.d.ts

@@ -0,0 +1,24 @@
+export interface ParametroRotaPhp {
+    nome: string;
+    tipoSema: "Texto" | "Inteiro" | "Decimal" | "Id";
+}
+export interface SimboloPhpExtraido {
+    simbolo: string;
+    aliases?: string[];
+    retorno?: string;
+    parametros: Array<{
+        nome: string;
+        tipoTexto?: string;
+        obrigatorio: boolean;
+    }>;
+}
+export interface RotaPhpExtraida {
+    origem: "php";
+    metodo: string;
+    caminho: string;
+    simbolo: string;
+    parametros: ParametroRotaPhp[];
+    retorno?: string;
+}
+export declare function extrairSimbolosPhp(codigo: string): SimboloPhpExtraido[];
+export declare function extrairRotasPhp(codigo: string): RotaPhpExtraida[];

package/dist/php-http.js

@@ -0,0 +1,252 @@
+// SEMA-GOVERNED: sema.governanca_ia_contexto
+// Descricao: extracao PHP para drift/importacao; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
+const METODOS_HTTP = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
+function contarChar(texto, alvo) {
+    return [...texto].filter((char) => char === alvo).length;
+}
+function limparStringPhp(valor) {
+    const limpo = (valor ?? "").trim();
+    if (!limpo) {
+        return undefined;
+    }
+    if ((limpo.startsWith("\"") && limpo.endsWith("\"")) || (limpo.startsWith("'") && limpo.endsWith("'"))) {
+        return limpo.slice(1, -1);
+    }
+    return limpo;
+}
+function normalizarCaminhoPhp(caminho) {
+    const limpo = caminho
+        .trim()
+        .replace(/^\/+|\/+$/g, "")
+        .replace(/:([A-Za-z_]\w*)/g, "{$1}")
+        .replace(/\{([^}:?]+)\??(?::[^}]+)?\}/g, "{$1}");
+    return `/${limpo}`.replace(/\/+/g, "/");
+}
+function juntarCaminhoPhp(base, sufixo) {
+    const partes = [base, sufixo]
+        .map((parte) => (parte ?? "").trim())
+        .filter(Boolean)
+        .map((parte) => parte.replace(/^\/+|\/+$/g, ""));
+    return normalizarCaminhoPhp(partes.join("/"));
+}
+function mapearTipoPhp(tipo) {
+    const normalizado = (tipo ?? "").toLowerCase().replace(/^[?\\]+/, "");
+    if (/^(int|integer)$/.test(normalizado)) {
+        return "Inteiro";
+    }
+    if (/^(float|double|decimal)$/.test(normalizado)) {
+        return "Decimal";
+    }
+    if (/uuid|id$/.test(normalizado)) {
+        return "Id";
+    }
+    return "Texto";
+}
+function extrairParametrosPhp(assinatura) {
+    return assinatura.split(",").map((parametroBruto) => {
+        const parametro = parametroBruto.trim();
+        if (!parametro) {
+            return undefined;
+        }
+        const semPadrao = parametro.split("=")[0]?.trim() ?? parametro;
+        const nome = semPadrao.match(/\$([A-Za-z_]\w*)/)?.[1];
+        if (!nome) {
+            return undefined;
+        }
+        const tipoTexto = semPadrao
+            .slice(0, semPadrao.indexOf(`$${nome}`))
+            .replace(/\b(?:public|protected|private|readonly|static)\b/g, "")
+            .replace(/[&.]{1,3}/g, "")
+            .trim() || undefined;
+        return {
+            nome,
+            tipoTexto,
+            obrigatorio: !parametro.includes("=") && !tipoTexto?.startsWith("?"),
+        };
+    }).filter((item) => Boolean(item));
+}
+function extrairParametrosRotaPhp(caminho, assinatura) {
+    const assinaturaMap = new Map();
+    for (const parametro of extrairParametrosPhp(assinatura)) {
+        assinaturaMap.set(parametro.nome, parametro.tipoTexto ?? "");
+    }
+    return [...normalizarCaminhoPhp(caminho).matchAll(/\{([^}]+)\}/g)].map((match) => {
+        const nome = match[1];
+        return {
+            nome,
+            tipoSema: mapearTipoPhp(assinaturaMap.get(nome)),
+        };
+    });
+}
+function removerComentariosBloco(codigo) {
+    return codigo.replace(/\/\*[\s\S]*?\*\//g, "");
+}
+function extrairAtributoRoutePhp(linha) {
+    const match = linha.match(/#\[\s*Route\s*\(([\s\S]+)\)\s*\]/i);
+    if (!match) {
+        return undefined;
+    }
+    const corpo = match[1];
+    const caminho = limparStringPhp(corpo.match(/(?:path\s*:\s*)?(['"][^'"]+['"])/i)?.[1]);
+    if (!caminho) {
+        return undefined;
+    }
+    const metodos = [...corpo.matchAll(/['"](GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)['"]/gi)]
+        .map((item) => item[1].toUpperCase())
+        .filter((metodo) => METODOS_HTTP.has(metodo));
+    return {
+        caminho,
+        metodos: metodos.length > 0 ? [...new Set(metodos)] : ["GET"],
+    };
+}
+function extrairTargetLaravel(bloco) {
+    const arrayController = bloco.match(/([A-Za-z_][\\A-Za-z0-9_]*)::class\s*,\s*['"]([A-Za-z_]\w*)['"]/);
+    if (arrayController) {
+        const classe = arrayController[1].split("\\").at(-1);
+        return `${classe}.${arrayController[2]}`;
+    }
+    const stringController = bloco.match(/['"]([A-Za-z_][\\A-Za-z0-9_]*)@([A-Za-z_]\w*)['"]/);
+    if (stringController) {
+        const classe = stringController[1].split("\\").at(-1);
+        return `${classe}.${stringController[2]}`;
+    }
+    const invokable = bloco.match(/([A-Za-z_][\\A-Za-z0-9_]*)::class/);
+    if (invokable) {
+        const classe = invokable[1].split("\\").at(-1);
+        return `${classe}.__invoke`;
+    }
+    const closure = bloco.match(/function\s*\(/);
+    if (closure) {
+        return "closure";
+    }
+    return undefined;
+}
+function assinaturaFuncaoPhp(linha) {
+    return linha.match(/^(?:(?:public|protected|private|static|final|abstract|readonly)\s+)*function\s+&?\s*([A-Za-z_]\w*)\s*\(([^)]*)\)\s*(?::\s*([?\\A-Za-z_][\\A-Za-z0-9_|?]*))?/);
+}
+function namespaceParaCaminhoPhp(namespace) {
+    const limpo = namespace?.trim().replace(/\\+/g, ".");
+    return limpo || undefined;
+}
+function variantesNamespacePhp(namespace, classe, metodo) {
+    const base = namespaceParaCaminhoPhp(namespace);
+    if (!base) {
+        return [];
+    }
+    const caminho = `${base}.${classe}.${metodo}`;
+    const partes = caminho.split(".");
+    const primeiroMinusculo = partes.length > 0
+        ? [partes[0].toLowerCase(), ...partes.slice(1)].join(".")
+        : caminho;
+    return [...new Set([caminho, primeiroMinusculo])];
+}
+export function extrairSimbolosPhp(codigo) {
+    const simbolos = new Map();
+    const linhas = removerComentariosBloco(codigo).split(/\r?\n/);
+    const pilhaClasses = [];
+    let profundidade = 0;
+    let namespaceAtual;
+    for (const linhaOriginal of linhas) {
+        const linha = linhaOriginal.trim();
+        if (!linha || linha.startsWith("//") || linha.startsWith("#")) {
+            profundidade += contarChar(linhaOriginal, "{") - contarChar(linhaOriginal, "}");
+            continue;
+        }
+        const namespace = linha.match(/^namespace\s+([^;{]+)\s*[;{]/);
+        if (namespace) {
+            namespaceAtual = namespace[1].trim();
+        }
+        const classe = linha.match(/\b(?:class|trait)\s+([A-Za-z_]\w*)/);
+        const classeSemChaveNaLinha = Boolean(classe && !linhaOriginal.includes("{"));
+        if (classe) {
+            pilhaClasses.push({ nome: classe[1], profundidade: profundidade + 1 });
+        }
+        const funcao = assinaturaFuncaoPhp(linha);
+        if (funcao) {
+            const nome = funcao[1];
+            if (!["__construct", "__destruct"].includes(nome)) {
+                const classeAtual = pilhaClasses[pilhaClasses.length - 1];
+                const simbolo = classeAtual ? `${classeAtual.nome}.${nome}` : nome;
+                simbolos.set(simbolo, {
+                    simbolo,
+                    aliases: classeAtual ? variantesNamespacePhp(namespaceAtual, classeAtual.nome, nome) : [],
+                    retorno: funcao[3]?.trim(),
+                    parametros: extrairParametrosPhp(funcao[2] ?? ""),
+                });
+            }
+        }
+        profundidade += contarChar(linhaOriginal, "{") - contarChar(linhaOriginal, "}");
+        while (!classeSemChaveNaLinha && pilhaClasses.length > 0 && profundidade < pilhaClasses[pilhaClasses.length - 1].profundidade) {
+            pilhaClasses.pop();
+        }
+    }
+    return [...simbolos.values()];
+}
+export function extrairRotasPhp(codigo) {
+    const rotas = new Map();
+    const texto = removerComentariosBloco(codigo);
+    for (const match of texto.matchAll(/\b(?:Route::|\$?[A-Za-z_]\w*->)(get|post|put|patch|delete|head|options)\s*\(\s*(['"][^'"]+['"])\s*,\s*([\s\S]*?)\)\s*;/gi)) {
+        const metodo = match[1].toUpperCase();
+        if (!METODOS_HTTP.has(metodo)) {
+            continue;
+        }
+        const caminho = normalizarCaminhoPhp(limparStringPhp(match[2]) ?? "/");
+        const simbolo = extrairTargetLaravel(match[3] ?? "") ?? metodo.toLowerCase();
+        rotas.set(`${metodo}:${caminho}:${simbolo}`, {
+            origem: "php",
+            metodo,
+            caminho,
+            simbolo,
+            parametros: extrairParametrosRotaPhp(caminho, ""),
+        });
+    }
+    const linhas = texto.split(/\r?\n/);
+    const pilhaClasses = [];
+    let atributoPendente;
+    let profundidade = 0;
+    for (const linhaOriginal of linhas) {
+        const linha = linhaOriginal.trim();
+        const atributo = extrairAtributoRoutePhp(linha);
+        if (atributo) {
+            atributoPendente = atributo;
+            continue;
+        }
+        const classe = linha.match(/\b(?:class|trait)\s+([A-Za-z_]\w*)/);
+        const classeSemChaveNaLinha = Boolean(classe && !linhaOriginal.includes("{"));
+        if (classe) {
+            pilhaClasses.push({
+                nome: classe[1],
+                profundidade: profundidade + 1,
+                rotaBase: atributoPendente?.caminho,
+            });
+            atributoPendente = undefined;
+        }
+        const funcao = assinaturaFuncaoPhp(linha);
+        if (funcao && atributoPendente) {
+            const classeAtual = pilhaClasses[pilhaClasses.length - 1];
+            const nome = funcao[1];
+            const simbolo = classeAtual ? `${classeAtual.nome}.${nome}` : nome;
+            const caminho = juntarCaminhoPhp(classeAtual?.rotaBase, atributoPendente.caminho);
+            for (const metodo of atributoPendente.metodos) {
+                rotas.set(`${metodo}:${caminho}:${simbolo}`, {
+                    origem: "php",
+                    metodo,
+                    caminho,
+                    simbolo,
+                    parametros: extrairParametrosRotaPhp(caminho, funcao[2] ?? ""),
+                    retorno: funcao[3]?.trim(),
+                });
+            }
+            atributoPendente = undefined;
+        }
+        else if (funcao) {
+            atributoPendente = undefined;
+        }
+        profundidade += contarChar(linhaOriginal, "{") - contarChar(linhaOriginal, "}");
+        while (!classeSemChaveNaLinha && pilhaClasses.length > 0 && profundidade < pilhaClasses[pilhaClasses.length - 1].profundidade) {
+            pilhaClasses.pop();
+        }
+    }
+    return [...rotas.values()];
+}
+//# sourceMappingURL=php-http.js.map

package/dist/projetoBusca.js

@@ -54,6 +54,7 @@ export const EXTENSOES_CODIGO = [
     ".cxx",
     ".hpp",
     ".h",
+    ".php",
     ".html",
     ".htm",
     ".css",

package/dist/projetoConfig.js

@@ -52,7 +52,7 @@ export function normalizarFrameworkGeracao(valor) {
     return "base";
 }
 export function normalizarAlvo(valor) {
-    if (valor === "typescript" || valor === "python" || valor === "dart" || valor === "lua" || valor === "javascript" || valor === "html" || valor === "css") {
+    if (valor === "typescript" || valor === "python" || valor === "dart" || valor === "lua" || valor === "javascript" || valor === "html" || valor === "css" || valor === "php") {
         return valor;
     }
     if (valor === "js") {
@@ -85,7 +85,8 @@ export function normalizarFonteLegado(valor) {
         || valor === "java"
         || valor === "go"
         || valor === "rust"
-        || valor === "cpp") {
+        || valor === "cpp"
+        || valor === "php") {
         return valor;
     }
     return undefined;

package/dist/projetoLegado.js

@@ -45,6 +45,8 @@ export async function inferirFontesLegado(diretoriosCodigo, baseProjeto, configC
         const arquivosRust = await listarArquivosRecursivosLimitado(diretorio, [".rs"], 5, 20);
         const arquivosCppBrutos = await listarArquivosRecursivosLimitado(diretorio, [".cpp", ".cc", ".cxx", ".hpp", ".h"], 5, 30);
         const arquivosCpp = arquivosCppBrutos.filter((arquivo) => !/(^|[\\/])(windows|linux|macos|runner|flutter|ephemeral|build|vendor)([\\/]|$)/i.test(arquivo));
+        const arquivosPhp = (await listarArquivosRecursivosLimitado(diretorio, [".php"], 5, 30))
+            .filter((arquivo) => !/(^|[\\/])(vendor|storage|bootstrap[\\/]cache|cache|tests?)([\\/]|$)/i.test(arquivo));
         if (arquivosTs.length > 0) {
             encontrados.add("typescript");
         }
@@ -176,6 +178,15 @@ export async function inferirFontesLegado(diretoriosCodigo, baseProjeto, configC
         if (arquivosCpp.length > 0) {
             encontrados.add("cpp");
         }
+        if (arquivosPhp.length > 0) {
+            encontrados.add("php");
+            const composer = await procurarArquivosPorNome(diretorio, ["composer.json"], 4);
+            const amostrasPhp = await Promise.all(arquivosPhp.slice(0, 8).map((arquivo) => lerConteudoSeExistir(arquivo)));
+            if (composer.length > 0
+                || amostrasPhp.some((texto) => /Route::(?:get|post|put|patch|delete)|#\[\s*Route\s*\(|namespace\s+App\\|use\s+Illuminate\\|use\s+Symfony\\/i.test(texto ?? ""))) {
+                encontrados.add("php");
+            }
+        }
     }
     return [...encontrados].sort((a, b) => a.localeCompare(b, "pt-BR"));
 }

package/dist/tipos.d.ts

@@ -1,3 +1,3 @@
 export type EstruturaSaida = "flat" | "modulos" | "backend";
-export type FonteLegado = "nestjs" | "fastapi" | "flask" | "nextjs" | "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer" | "firebase" | "typescript" | "javascript" | "python" | "dart" | "lua" | "dotnet" | "java" | "go" | "rust" | "cpp";
+export type FonteLegado = "nestjs" | "fastapi" | "flask" | "nextjs" | "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer" | "firebase" | "typescript" | "javascript" | "python" | "dart" | "lua" | "dotnet" | "java" | "go" | "rust" | "cpp" | "php";
 export type ModoAdocao = "incremental";

package/docs/ai-workflow.md

@@ -35,7 +35,7 @@ If the delivery includes code derived from a contract, run `sema compilar`.
 sema compilar contratos/orders.sema --alvo javascript --saida ./generated/javascript
 ```
 
-Replace `javascript` with `typescript`, `python`, `dart`, `lua`, `html`, or `css` when appropriate.
+Replace `javascript` with `typescript`, `python`, `php`, `dart`, `lua`, `html`, or `css` when appropriate.
 
 ## Fail Closed
 

package/docs/commands.md

@@ -36,7 +36,7 @@ Honest closure: treat drift JSON as the source of truth. `sucesso:false`, `vincu
 
 ## Sema Code
 
-- `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>`: generates starter/support artifacts from the contract.
+- `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css> --saida <diretorio>`: generates starter/support artifacts from the contract.
 - `sema testar <arquivo.sema> --alvo <alvo> --saida <diretorio-temporario>`: generates and runs local tests when the target supports it.
 - `sema importar <fonte> <diretorio> --saida <diretorio> --json`: imports a legacy project into initial contracts.
 - `sema renomear-semantico <arquivo-ou-pasta> --de <nome> --para <nome> --json`: helps rename symbols semantically.
@@ -49,7 +49,7 @@ Ready UI rule: if the task generates an app, site, dashboard, form, or static HT
 
 ## Canonical Syntax Lists
 
-- Origins for `use` and `impl`: `ts/typescript`, `js/javascript`, `py/python`, `dart`, `lua`, `cs/dotnet`, `java`, `go`, `rust`, `cpp`.
+- Origins for `use` and `impl`: `ts/typescript`, `js/javascript`, `py/python`, `dart`, `lua`, `cs/dotnet`, `java`, `go`, `rust`, `cpp`, `php`.
 - Frequent `effects` categories: `persistencia`, `consulta`, `evento`, `auditoria`, `db.write`, `queue.publish`, `fs.write`, `network.egress`, `secret.read`, `shell.exec`.
 - Accepted `audit.motivo` values: `obrigatorio`, `opcional`, `dispensado`.
 

package/docs/syntax.md

@@ -74,6 +74,7 @@ Use these origins before inventing a new one:
 - `go`
 - `rust`
 - `cpp`
+- `php`
 
 Examples:
 
@@ -104,13 +105,13 @@ impl {
 
 ## JavaScript Is Supported
 
-The CLI supports JavaScript generation:
+The CLI supports JavaScript and PHP generation:
 
 ```bash
 sema compilar contratos/orders.sema --alvo javascript --saida ./generated/javascript
 ```
 
-The project can also generate TypeScript, Python, Dart, Lua, HTML, and CSS when those targets are enabled in `sema.config.json`.
+The project can also generate TypeScript, Python, PHP, Dart, Lua, HTML, and CSS when those targets are enabled in `sema.config.json`.
 
 ## Support Files
 

package/node_modules/@sema/gerador-php/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { IrModulo } from "@sema/nucleo";
+import { type ArquivoGerado } from "@sema/padroes";
+export declare function gerarPhp(modulo: IrModulo): ArquivoGerado[];