Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

feat(cli): adicionar omniroute audit (Fase 3.4)

diegosouzapw28629bf7f0d1
diff --git a/bin/cli/commands/audit.mjs b/bin/cli/commands/audit.mjs
new file mode 100644
index 0000000000..fdd392308e
--- /dev/null
+++ b/bin/cli/commands/audit.mjs
@@ -0,0 +1,203 @@
+import { writeFileSync } from "node:fs";
+import { setTimeout as sleep } from "node:timers/promises";
+import { apiFetch } from "../api.mjs";
+import { emit } from "../output.mjs";
+import { t } from "../i18n.mjs";
+
+function truncate(v, len = 40) {
+ if (v == null) return "-";
+ const s = String(v);
+ return s.length > len ? s.slice(0, len - 1) + "…" : s;
+}
+
+function fmtTs(v) {
+ if (!v) return "-";
+ try {
+ return new Date(v).toLocaleString();
+ } catch {
+ return String(v);
+ }
+}
+
+function maskActor(v) {
+ if (!v) return "-";
+ const s = String(v);
+ if (s.length <= 8) return s;
+ return `${s.slice(0, 4)}****${s.slice(-4)}`;
+}
+
+const auditSchema = [
+ { key: "timestamp", header: "Time", width: 22, formatter: fmtTs },
+ { key: "source", header: "Source", width: 10 },
+ { key: "actor", header: "Actor", width: 16, formatter: maskActor },
+ { key: "action", header: "Action", width: 28 },
+ { key: "resource", header: "Resource", width: 32, formatter: truncate },
+ { key: "result", header: "Result", formatter: (v) => (v === "success" ? "✓" : "✗") },
+ { key: "details", header: "Details", formatter: truncate },
+];
+
+function endpointFor(source) {
+ return source === "mcp" ? "/api/mcp/audit" : "/api/compliance/audit-log";
+}
+
+async function fetchAuditEntries(sources, params) {
+ const entries = [];
+ for (const src of sources) {
+ const endpoint = endpointFor(src);
+ const res = await apiFetch(`${endpoint}?${params}`);
+ if (!res.ok) continue;
+ const data = await res.json();
+ for (const e of data.items ?? data) {
+ entries.push({ ...e, source: src });
+ }
+ }
+ return entries;
+}
+
+function resolveSources(source) {
+ if (source === "all") return ["compliance", "mcp"];
+ return [source ?? "compliance"];
+}
+
+export async function runAuditTail(opts, cmd) {
+ const globalOpts = cmd.optsWithGlobals();
+ const sources = resolveSources(opts.source);
+ const params = new URLSearchParams({ limit: String(opts.limit ?? 100) });
+ const entries = await fetchAuditEntries(sources, params);
+ entries.sort((a, b) => String(b.timestamp ?? "").localeCompare(String(a.timestamp ?? "")));
+ emit(entries.slice(0, opts.limit ?? 100), globalOpts, auditSchema);
+
+ if (opts.follow) {
+ process.stderr.write("\n[following — Ctrl+C to exit]\n");
+ let lastTs = entries[0]?.timestamp ?? new Date().toISOString();
+ const loop = async () => {
+ while (true) {
+ await sleep(2000);
+ for (const src of sources) {
+ const endpoint = endpointFor(src);
+ const res = await apiFetch(`${endpoint}?since=${encodeURIComponent(lastTs)}&limit=50`);
+ if (!res.ok) continue;
+ const data = await res.json();
+ const newEntries = (data.items ?? data)
+ .map((e) => ({ ...e, source: src }))
+ .filter((e) => String(e.timestamp ?? "") > String(lastTs));
+ for (const e of newEntries) {
+ if (String(e.timestamp ?? "") > String(lastTs)) lastTs = e.timestamp;
+ emit([e], globalOpts, auditSchema);
+ }
+ }
+ }
+ };
+ process.on("SIGINT", () => process.exit(0));
+ await loop();
+ }
+}
+
+export async function runAuditSearch(query, opts, cmd) {
+ const globalOpts = cmd.optsWithGlobals();
+ const sources = resolveSources(opts.source);
+ const params = new URLSearchParams({ q: query, limit: String(opts.limit ?? 200) });
+ if (opts.since) params.set("since", opts.since);
+ if (opts.until) params.set("until", opts.until);
+ if (opts.actor) params.set("actor", opts.actor);
+ if (opts.action) params.set("action", opts.action);
+ const entries = await fetchAuditEntries(sources, params);
+ entries.sort((a, b) => String(b.timestamp ?? "").localeCompare(String(a.timestamp ?? "")));
+ emit(entries, globalOpts, auditSchema);
+}
+
+export async function runAuditExport(file, opts, cmd) {
+ const sources = resolveSources(opts.source === "all" ? "compliance" : opts.source);
+ const format = opts.format ?? "jsonl";
+ const params = new URLSearchParams({ format });
+ if (opts.since) params.set("since", opts.since);
+ if (opts.until) params.set("until", opts.until);
+
+ const allLines = [];
+ for (const src of sources) {
+ const endpoint = endpointFor(src);
+ const res = await apiFetch(`${endpoint}?${params}`);
+ if (!res.ok) {
+ process.stderr.write(`Error fetching ${src}: ${res.status}\n`);
+ continue;
+ }
+ const body = await res.text();
+ allLines.push(body);
+ }
+
+ const combined = allLines.join("\n");
+ writeFileSync(file, combined);
+ process.stdout.write(`Exported to ${file} (${combined.length} bytes)\n`);
+}
+
+export async function runAuditStats(opts, cmd) {
+ const globalOpts = cmd.optsWithGlobals();
+ const source = opts.source ?? "mcp";
+ const params = new URLSearchParams({ period: opts.period ?? "7d" });
+ const endpoint = source === "mcp" ? "/api/mcp/audit/stats" : "/api/compliance/audit-log/stats";
+ const res = await apiFetch(`${endpoint}?${params}`);
+ if (!res.ok) {
+ process.stderr.write(`Error: ${res.status}\n`);
+ process.exit(1);
+ }
+ const data = await res.json();
+ emit(data, globalOpts);
+}
+
+export async function runAuditGet(id, opts, cmd) {
+ const globalOpts = cmd.optsWithGlobals();
+ const source = opts.source ?? "compliance";
+ const endpoint = endpointFor(source);
+ const res = await apiFetch(`${endpoint}/${id}`);
+ if (!res.ok) {
+ process.stderr.write(`Not found: ${id}\n`);
+ process.exit(1);
+ }
+ const data = await res.json();
+ emit(data, globalOpts, auditSchema);
+}
+
+export function registerAudit(program) {
+ const audit = program.command("audit").description(t("audit.description"));
+
+ audit
+ .command("tail")
+ .description(t("audit.tail.description"))
+ .option("--source <s>", t("audit.source"), "all")
+ .option("--follow", t("audit.tail.follow"))
+ .option("--limit <n>", t("audit.tail.limit"), parseInt, 100)
+ .action(runAuditTail);
+
+ audit
+ .command("search <query>")
+ .description(t("audit.search.description"))
+ .option("--source <s>", t("audit.source"), "all")
+ .option("--since <ts>", t("audit.since"))
+ .option("--until <ts>", t("audit.until"))
+ .option("--limit <n>", t("audit.search.limit"), parseInt, 200)
+ .option("--actor <id>", t("audit.search.actor"))
+ .option("--action <a>", t("audit.search.action"))
+ .action(runAuditSearch);
+
+ audit
+ .command("export <file>")
+ .description(t("audit.export.description"))
+ .option("--source <s>", t("audit.source"), "all")
+ .option("--format <f>", t("audit.export.format"), "jsonl")
+ .option("--since <ts>", t("audit.since"))
+ .option("--until <ts>", t("audit.until"))
+ .action(runAuditExport);
+
+ audit
+ .command("stats")
+ .description(t("audit.stats.description"))
+ .option("--source <s>", t("audit.source"), "mcp")
+ .option("--period <p>", t("audit.stats.period"), "7d")
+ .action(runAuditStats);
+
+ audit
+ .command("get <id>")
+ .description(t("audit.get.description"))
+ .option("--source <s>", t("audit.source"), "compliance")
+ .action(runAuditGet);
+}
diff --git a/bin/cli/commands/registry.mjs b/bin/cli/commands/registry.mjs
index d3eb5b7d50..7d4e3c07db 100644
--- a/bin/cli/commands/registry.mjs
+++ b/bin/cli/commands/registry.mjs
@@ -1,5 +1,6 @@
import { registerMemory } from "./memory.mjs";
import { registerSkills } from "./skills.mjs";
+import { registerAudit } from "./audit.mjs";
import { registerChat } from "./chat.mjs";
import { registerStream } from "./stream.mjs";
import { registerSimulate } from "./simulate.mjs";
@@ -34,6 +35,7 @@ import { registerCompletion } from "./completion.mjs";
export function registerCommands(program) {
registerMemory(program);
registerSkills(program);
+ registerAudit(program);
registerChat(program);
registerStream(program);
registerSimulate(program);
diff --git a/bin/cli/locales/en.json b/bin/cli/locales/en.json
index b000ef1f46..69f3615ff5 100644
--- a/bin/cli/locales/en.json
+++ b/bin/cli/locales/en.json
@@ -274,6 +274,34 @@
"noServer": "Server not running. Start with: omniroute serve",
"noModels": "No models found."
},
+ "audit": {
+ "description": "Access compliance and MCP audit logs",
+ "source": "Log source: all|compliance|mcp (default: all)",
+ "since": "Return entries since this timestamp (ISO 8601)",
+ "until": "Return entries until this timestamp (ISO 8601)",
+ "tail": {
+ "description": "Show recent audit log entries",
+ "follow": "Continuously tail new entries (2s poll)",
+ "limit": "Maximum entries to show (default: 100)"
+ },
+ "search": {
+ "description": "Search audit log entries by keyword",
+ "limit": "Maximum results (default: 200)",
+ "actor": "Filter by actor ID",
+ "action": "Filter by action name"
+ },
+ "export": {
+ "description": "Export audit log to file",
+ "format": "Output format: jsonl|csv (default: jsonl)"
+ },
+ "stats": {
+ "description": "Show audit log statistics",
+ "period": "Time period: 1d|7d|30d (default: 7d)"
+ },
+ "get": {
+ "description": "Get a single audit log entry by ID"
+ }
+ },
"skills": {
"description": "Manage OmniRoute skills (sandbox, builtin, custom, hybrid, skillssh)",
"list": {
diff --git a/bin/cli/locales/pt-BR.json b/bin/cli/locales/pt-BR.json
index 87b02ea04d..e4dc3203ec 100644
--- a/bin/cli/locales/pt-BR.json
+++ b/bin/cli/locales/pt-BR.json
@@ -274,6 +274,34 @@
"noServer": "Servidor não está em execução. Inicie com: omniroute serve",
"noModels": "Nenhum modelo encontrado."
},
+ "audit": {
+ "description": "Acessar logs de auditoria de compliance e MCP",
+ "source": "Fonte do log: all|compliance|mcp (padrão: all)",
+ "since": "Retornar entradas desde este timestamp (ISO 8601)",
+ "until": "Retornar entradas até este timestamp (ISO 8601)",
+ "tail": {
+ "description": "Exibir entradas recentes do log de auditoria",
+ "follow": "Fazer tail contínuo de novas entradas (poll 2s)",
+ "limit": "Máximo de entradas (padrão: 100)"
+ },
+ "search": {
+ "description": "Buscar entradas do log de auditoria por palavra-chave",
+ "limit": "Máximo de resultados (padrão: 200)",
+ "actor": "Filtrar por ID de ator",
+ "action": "Filtrar por nome de ação"
+ },
+ "export": {
+ "description": "Exportar log de auditoria para arquivo",
+ "format": "Formato de saída: jsonl|csv (padrão: jsonl)"
+ },
+ "stats": {
+ "description": "Exibir estatísticas do log de auditoria",
+ "period": "Período: 1d|7d|30d (padrão: 7d)"
+ },
+ "get": {
+ "description": "Obter uma entrada do log de auditoria por ID"
+ }
+ },
"skills": {
"description": "Gerenciar skills do OmniRoute (sandbox, builtin, custom, hybrid, skillssh)",
"list": {
diff --git a/tests/unit/cli-audit-commands.test.ts b/tests/unit/cli-audit-commands.test.ts
new file mode 100644
index 0000000000..0d300cbf25
--- /dev/null
+++ b/tests/unit/cli-audit-commands.test.ts
@@ -0,0 +1,193 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+
+const COMPLIANCE_ENTRIES = [
+ {
+ id: "c1",
+ timestamp: "2026-05-10T10:00:00Z",
+ actor: "[email protected]",
+ action: "user.login",
+ resource: "/admin",
+ result: "success",
+ },
+ {
+ id: "c2",
+ timestamp: "2026-05-10T09:00:00Z",
+ actor: "[email protected]",
+ action: "key.delete",
+ resource: "sk-xxx",
+ result: "success",
+ },
+];
+
+const MCP_ENTRIES = [
+ {
+ id: "m1",
+ timestamp: "2026-05-10T11:00:00Z",
+ actor: "cli_client",
+ action: "omniroute_memory_search",
+ resource: null,
+ result: "success",
+ },
+];
+
+const MCP_STATS = {
+ period: "7d",
+ totalCalls: 150,
+ byTool: [{ tool: "omniroute_memory_search", count: 40 }],
+ byResult: { success: 140, error: 10 },
+};
+
+function makeResp(data: unknown, status = 200) {
+ const obj = {
+ ok: status < 400,
+ status,
+ exitCode: status < 400 ? 0 : 1,
+ json: () => Promise.resolve(data),
+ text: () => Promise.resolve(JSON.stringify(data)),
+ headers: new Headers(),
+ };
+ obj.json = obj.json.bind(obj);
+ obj.text = obj.text.bind(obj);
+ return obj;
+}
+
+function mockFetch(overrides: Record<string, unknown> = {}) {
+ return (url: string) => {
+ if (url.includes("/api/mcp/audit/stats"))
+ return Promise.resolve(makeResp(overrides.stats ?? MCP_STATS));
+ if (url.includes("/api/mcp/audit"))
+ return Promise.resolve(makeResp({ items: overrides.mcp ?? MCP_ENTRIES }));
+ if (url.includes("/api/compliance/audit-log"))
+ return Promise.resolve(makeResp({ items: overrides.compliance ?? COMPLIANCE_ENTRIES }));
+ return Promise.resolve(makeResp({}, 404));
+ };
+}
+
+async function captureStdout(fn: () => Promise<void>): Promise<string> {
+ const chunks: string[] = [];
+ const orig = process.stdout.write.bind(process.stdout);
+ process.stdout.write = (c: string | Uint8Array) => {
+ chunks.push(typeof c === "string" ? c : c.toString());
+ return true;
+ };
+ try {
+ await fn();
+ } finally {
+ process.stdout.write = orig;
+ }
+ return chunks.join("");
+}
+
+function makeCmd(output = "json") {
+ return { optsWithGlobals: () => ({ output, quiet: output !== "table" }) };
+}
+
+test("runAuditTail --source all mescla compliance e mcp", async () => {
+ const origFetch = globalThis.fetch;
+ globalThis.fetch = mockFetch() as any;
+
+ const { runAuditTail } = await import("../../bin/cli/commands/audit.mjs");
+ const out = await captureStdout(() =>
+ runAuditTail({ source: "all", limit: 50 }, makeCmd() as any)
+ );
+
+ globalThis.fetch = origFetch;
+ const parsed = JSON.parse(out);
+ assert.ok(Array.isArray(parsed));
+ assert.ok(parsed.some((e: any) => e.source === "compliance"));
+ assert.ok(parsed.some((e: any) => e.source === "mcp"));
+});
+
+test("runAuditTail --source compliance retorna apenas compliance", async () => {
+ let capturedUrls: string[] = [];
+ const origFetch = globalThis.fetch;
+ globalThis.fetch = ((url: string) => {
+ capturedUrls.push(url);
+ return Promise.resolve(makeResp({ items: COMPLIANCE_ENTRIES }));
+ }) as any;
+
+ const { runAuditTail } = await import("../../bin/cli/commands/audit.mjs");
+ const out = await captureStdout(() =>
+ runAuditTail({ source: "compliance", limit: 50 }, makeCmd() as any)
+ );
+
+ globalThis.fetch = origFetch;
+ assert.ok(capturedUrls.every((u) => u.includes("/api/compliance/audit-log")));
+ const parsed = JSON.parse(out);
+ assert.ok(parsed.every((e: any) => e.source === "compliance"));
+});
+
+test("runAuditSearch envia q e filtros na query", async () => {
+ let capturedUrl = "";
+ const origFetch = globalThis.fetch;
+ globalThis.fetch = ((url: string) => {
+ capturedUrl = url;
+ return Promise.resolve(makeResp({ items: COMPLIANCE_ENTRIES }));
+ }) as any;
+
+ const { runAuditSearch } = await import("../../bin/cli/commands/audit.mjs");
+ await captureStdout(() =>
+ runAuditSearch(
+ "scope_denied",
+ { source: "compliance", limit: 100, actor: "admin" },
+ makeCmd() as any
+ )
+ );
+
+ globalThis.fetch = origFetch;
+ assert.ok(capturedUrl.includes("q=scope_denied"));
+ assert.ok(capturedUrl.includes("actor=admin"));
+});
+
+test("runAuditStats consulta endpoint stats do mcp", async () => {
+ let capturedUrl = "";
+ const origFetch = globalThis.fetch;
+ globalThis.fetch = ((url: string) => {
+ capturedUrl = url;
+ return Promise.resolve(makeResp(MCP_STATS));
+ }) as any;
+
+ const { runAuditStats } = await import("../../bin/cli/commands/audit.mjs");
+ const out = await captureStdout(() =>
+ runAuditStats({ source: "mcp", period: "7d" }, makeCmd() as any)
+ );
+
+ globalThis.fetch = origFetch;
+ assert.ok(capturedUrl.includes("/api/mcp/audit/stats"));
+ assert.ok(capturedUrl.includes("period=7d"));
+ const parsed = JSON.parse(out);
+ assert.equal(parsed.totalCalls, 150);
+});
+
+test("runAuditGet busca entrada por id", async () => {
+ let capturedUrl = "";
+ const origFetch = globalThis.fetch;
+ globalThis.fetch = ((url: string) => {
+ capturedUrl = url;
+ return Promise.resolve(makeResp(COMPLIANCE_ENTRIES[0]));
+ }) as any;
+
+ const { runAuditGet } = await import("../../bin/cli/commands/audit.mjs");
+ const out = await captureStdout(() =>
+ runAuditGet("c1", { source: "compliance" }, makeCmd() as any)
+ );
+
+ globalThis.fetch = origFetch;
+ assert.ok(capturedUrl.includes("/api/compliance/audit-log/c1"));
+ const parsed = JSON.parse(out);
+ assert.equal(parsed.id, "c1");
+});
+
+test("runAuditTail mascaramento de actor em output table", async () => {
+ const origFetch = globalThis.fetch;
+ globalThis.fetch = mockFetch() as any;
+
+ const { runAuditTail } = await import("../../bin/cli/commands/audit.mjs");
+ const out = await captureStdout(() =>
+ runAuditTail({ source: "compliance", limit: 10 }, makeCmd("table") as any)
+ );
+
+ globalThis.fetch = origFetch;
+ assert.ok(!out.includes("[email protected]") || out.includes("****"));
+});