@semacode/cli 1.5.28 → 1.5.30

package/dist/guard.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Guarda de governança Sema.
+ *
+ * Cria um bloqueio local que obriga a chamada de `docs-impacto`
+ * antes de operações destrutivas (compilar, publicar, validar pesado).
+ *
+ * Arquivo de estado: .sema/guard.json
+ *
+ * Contrato: contratos/sema/guard.sema
+ */
+export interface EstadoGuarda {
+    ativo: boolean;
+    sessaoId: string;
+    ativadoEm: string;
+    docsImpactoChamado: boolean;
+    intencao?: string;
+    docsLidas: string[];
+    ultimaAtualizacao: string;
+}
+export interface ResultadoGuarda {
+    comando: string;
+    sucesso: boolean;
+    estado?: EstadoGuarda;
+    bloqueado?: boolean;
+    mensagem?: string;
+}
+export declare function ativarGuarda(baseProjeto: string): Promise<ResultadoGuarda>;
+export declare function desativarGuarda(baseProjeto: string): Promise<ResultadoGuarda>;
+export declare function statusGuarda(baseProjeto: string): Promise<ResultadoGuarda>;
+export declare function registrarDocsImpacto(baseProjeto: string, intencao: string): Promise<ResultadoGuarda>;
+export declare function registrarDocLida(baseProjeto: string, caminhoDoc: string): Promise<ResultadoGuarda>;
+export declare function verificarSePodeProsseguir(baseProjeto: string, operacao: string): Promise<{
+    pode: boolean;
+    motivo?: string;
+}>;

package/dist/guard.js

@@ -0,0 +1,164 @@
+/**
+ * Guarda de governança Sema.
+ *
+ * Cria um bloqueio local que obriga a chamada de `docs-impacto`
+ * antes de operações destrutivas (compilar, publicar, validar pesado).
+ *
+ * Arquivo de estado: .sema/guard.json
+ *
+ * Contrato: contratos/sema/guard.sema
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+// ---------------------------------------------------------------------------
+// Constantes
+// ---------------------------------------------------------------------------
+const ARQUIVO_GUARD = path.join(".sema", "guard.json");
+function caminhoGuard(baseProjeto) {
+    return path.resolve(baseProjeto, ARQUIVO_GUARD);
+}
+// ---------------------------------------------------------------------------
+// Estado padrão
+// ---------------------------------------------------------------------------
+function estadoVazio() {
+    return {
+        ativo: false,
+        sessaoId: "",
+        ativadoEm: "",
+        docsImpactoChamado: false,
+        docsLidas: [],
+        ultimaAtualizacao: "",
+    };
+}
+// ---------------------------------------------------------------------------
+// Ler / escrever estado do guarda
+// ---------------------------------------------------------------------------
+async function lerEstado(baseProjeto) {
+    try {
+        const conteudo = await readFile(caminhoGuard(baseProjeto), "utf8");
+        return JSON.parse(conteudo);
+    }
+    catch {
+        return estadoVazio();
+    }
+}
+async function escreverEstado(baseProjeto, estado) {
+    const dir = path.dirname(caminhoGuard(baseProjeto));
+    await mkdir(dir, { recursive: true });
+    estado.ultimaAtualizacao = new Date().toISOString();
+    await writeFile(caminhoGuard(baseProjeto), JSON.stringify(estado, null, 2), "utf8");
+}
+// ---------------------------------------------------------------------------
+// Ações do guarda
+// ---------------------------------------------------------------------------
+export async function ativarGuarda(baseProjeto) {
+    const estado = await lerEstado(baseProjeto);
+    if (estado.ativo) {
+        return {
+            comando: "guard on",
+            sucesso: false,
+            estado,
+            mensagem: `Guarda ja esta ativo (sessao: ${estado.sessaoId}). Desative com 'sema guard off' primeiro.`,
+        };
+    }
+    const novoEstado = {
+        ativo: true,
+        sessaoId: randomUUID(),
+        ativadoEm: new Date().toISOString(),
+        docsImpactoChamado: false,
+        docsLidas: [],
+        ultimaAtualizacao: new Date().toISOString(),
+    };
+    await escreverEstado(baseProjeto, novoEstado);
+    return {
+        comando: "guard on",
+        sucesso: true,
+        estado: novoEstado,
+        mensagem: `Guarda ativado. Sessao: ${novoEstado.sessaoId.slice(0, 8)}...`,
+    };
+}
+export async function desativarGuarda(baseProjeto) {
+    const estado = await lerEstado(baseProjeto);
+    if (!estado.ativo) {
+        return {
+            comando: "guard off",
+            sucesso: false,
+            estado,
+            mensagem: "Guarda nao esta ativo.",
+        };
+    }
+    await escreverEstado(baseProjeto, estadoVazio());
+    return {
+        comando: "guard off",
+        sucesso: true,
+        estado: estadoVazio(),
+        mensagem: "Guarda desativado.",
+    };
+}
+export async function statusGuarda(baseProjeto) {
+    const estado = await lerEstado(baseProjeto);
+    return {
+        comando: "guard status",
+        sucesso: true,
+        estado,
+        bloqueado: estado.ativo && !estado.docsImpactoChamado,
+        mensagem: estado.ativo
+            ? estado.docsImpactoChamado
+                ? `Guarda ativo. Docs-impacto ja registrado. Sessao: ${estado.sessaoId.slice(0, 8)}...`
+                : `Guarda ativo. Docs-impacto pendente! Sessao: ${estado.sessaoId.slice(0, 8)}...`
+            : "Guarda inativo.",
+    };
+}
+export async function registrarDocsImpacto(baseProjeto, intencao) {
+    const estado = await lerEstado(baseProjeto);
+    if (!estado.ativo) {
+        // Guarda inativo: registrar mesmo assim (útil pra relatório)
+        return {
+            comando: "guard registrar-docs",
+            sucesso: true,
+            mensagem: "Guarda inativo. Docs-impacto registrado em cache leve.",
+        };
+    }
+    estado.docsImpactoChamado = true;
+    estado.intencao = intencao;
+    await escreverEstado(baseProjeto, estado);
+    return {
+        comando: "guard registrar-docs",
+        sucesso: true,
+        estado,
+        mensagem: `Docs-impacto registrado: "${intencao.slice(0, 60)}"`,
+    };
+}
+export async function registrarDocLida(baseProjeto, caminhoDoc) {
+    const estado = await lerEstado(baseProjeto);
+    if (!estado.ativo) {
+        return { comando: "guard registrar-doc", sucesso: true };
+    }
+    if (!estado.docsLidas.includes(caminhoDoc)) {
+        estado.docsLidas.push(caminhoDoc);
+    }
+    await escreverEstado(baseProjeto, estado);
+    return {
+        comando: "guard registrar-doc",
+        sucesso: true,
+        estado,
+    };
+}
+// ---------------------------------------------------------------------------
+// Verificação: operação pode prosseguir?
+// ---------------------------------------------------------------------------
+export async function verificarSePodeProsseguir(baseProjeto, operacao) {
+    const estado = await lerEstado(baseProjeto);
+    if (!estado.ativo) {
+        return { pode: true }; // Guarda inativo: liberado
+    }
+    if (!estado.docsImpactoChamado) {
+        return {
+            pode: false,
+            motivo: `Guarda ativo bloqueou "${operacao}". Execute 'sema docs-impacto --intencao "${operacao}"' primeiro.`,
+        };
+    }
+    return { pode: true };
+}
+//# sourceMappingURL=guard.js.map

package/dist/guard.js.map

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