omnispace 0.11.0 → 0.13.0

package/README.md

@@ -84,6 +84,21 @@ Tirar esta máquina da conta e o `.omni/` das pastas dela (pede duas confirmaç
 npx -y omnispace@latest desvincular
 ```
 
+Ver e mudar o que o agente pode fazer sozinho com cada ação dos conectores do espaço. Por padrão, leitura é automática, escrita pede confirmação e ação destrutiva fica bloqueada. Restringir vale na hora; liberar pede confirmação no navegador:
+
+```
+npx -y omnispace@latest permissoes
+npx -y omnispace@latest permissoes set slack send_message bloqueado
+```
+
+Perguntar sobre o espaço. A resposta usa a versão publicada, com as fontes (arquivo e versão) e os limites da consulta:
+
+```
+npx -y omnispace@latest ask "Qual foi a última decisão deste projeto?"
+```
+
+Com conectores ligados no espaço, o agente também consulta os conectores: leitura automática roda na hora e aparece como `[C1]`, com o horário da consulta. Uma ação que pede confirmação (como criar uma task ou mandar uma mensagem) não roda sozinha: a CLI mostra o pedido inteiro e pergunta `Executar? [s/n]`. Só `s` executa, uma vez; o pedido vale 10 minutos. Sem terminal, nada é executado.
+
 No Windows, se o caminho tiver espaço ou apóstrofo, entre na pasta com aspas duplas: `cd "C:\caminho\da\pasta"`.
 
 ## O que o Omni lê e envia
@@ -103,5 +118,6 @@ npx -y omnispace@latest env push
 
 Com a CLI logada, dentro da pasta do espaço: a CLI lê os arquivos `.env` da raiz (menos `.env.example`, `.env.sample` e `.env.template`) e pergunta chave por chave se ela vai para o cofre do espaço. Mostra o nome, o arquivo e no máximo os 4 últimos caracteres do valor. Antes de enviar, pede que você confirme no navegador, logado na sua conta, digitando o código do terminal. O valor vai cifrado para o cofre (Vault) e não aparece em tela, log nem resposta. Sem terminal, nada é enviado.
 
+- Chaves que formam um conector já ligam o conector do espaço, depois de um teste de conexão: Supabase com `<PREFIXO>_URL` e `<PREFIXO>_SERVICE_ROLE_KEY` (ou `_SERVICE_KEY`), como `SUPABASE_URL` ou `SUPABASE_TOOLS_URL`; ClickUp com o token (`CLICKUP_API_KEY` ou `CLICKUP_<NOME>_TOKEN`) e o `CLICKUP_TEAM_ID`. Se houver mais de um projeto para o mesmo conector, a CLI pergunta qual liga.
 - `env list` mostra as chaves guardadas (só nomes).
 - `env rm <CHAVE> [--arquivo .env.local]` apaga do cofre de vez, também com confirmação no navegador. Se um conector usava a chave, ele fica desligado.

package/dist/ask.js

@@ -1,4 +1,5 @@
 import { basename, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
 import { callApi } from "./api.js";
 import { loadToken, readSpaceConfig } from "./config.js";
 export const ASK_USAGE = 'Uso: omnispace ask "<pergunta>" [pasta] [--fontes] [--detalhes]';
@@ -19,6 +20,32 @@ export function parseAskArgs(rest, cwd = process.cwd()) {
         details: rest.includes("--detalhes"),
     };
 }
+/**
+ * Text that came from the model or a connector, made safe for the terminal: no escape sequences or
+ * control characters (an ANSI code could hide part of what the person is about to confirm).
+ */
+export function terminalSafe(text) {
+    return text.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "").replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f]/g, "");
+}
+const hhmm = (iso) => {
+    const d = new Date(iso);
+    return Number.isNaN(d.getTime()) ? iso : d.toLocaleTimeString("pt-BR", { hour: "2-digit", minute: "2-digit" });
+};
+/** A pending request shown in full: connector, action and every field of the input, as it will run. */
+export function formatPending(p) {
+    const out = [`Pedido ${terminalSafe(p.ref)}, aguardando sua decisão (vale até ${hhmm(p.expiresAt)}):`, `  ${terminalSafe(p.connector)}: ${terminalSafe(p.actionName)} (${terminalSafe(p.action)})`];
+    const input = p.input && typeof p.input === "object" && !Array.isArray(p.input) ? p.input : { entrada: p.input };
+    for (const [key, value] of Object.entries(input)) {
+        const text = typeof value === "string" ? value : JSON.stringify(value);
+        const lines = terminalSafe(text ?? "").split("\n");
+        out.push(`    ${terminalSafe(key)}: ${lines[0]}`);
+        for (const line of lines.slice(1))
+            out.push(`      ${line}`);
+    }
+    if (Object.keys(input).length === 0)
+        out.push("    (sem entrada)");
+    return out;
+}
 const REASON = { index: "index.md", log: "log.md", link: "apontado no index", termo: "busca por termo" };
 /** What `omnispace ask` prints, as lines. `baseVersion`: the version this folder is on. */
 export function formatAsk(res, opts) {
@@ -35,16 +62,24 @@ export function formatAsk(res, opts) {
         consultedList();
     }
     else {
-        out.push("Resposta:", res.answer ?? "", "");
+        out.push("Resposta:", terminalSafe(res.answer ?? ""), "");
         const sources = res.sources ?? [];
+        const calls = res.connectorCalls ?? [];
         if (sources.length > 0) {
             out.push("Fontes:");
             for (const s of sources)
                 out.push(`  [${s.id}] ${s.path}  (versão ${s.version})`);
         }
-        else {
+        else if (!calls.some((c) => c.cited)) {
             out.push("Fontes: nenhuma citada. Esta resposta não se apoia em arquivo do espaço.");
         }
+        if (calls.length > 0) {
+            out.push("Conectores consultados:");
+            for (const c of calls) {
+                const status = c.ok ? "" : `, falhou: ${terminalSafe(c.error ?? "sem detalhe")}`;
+                out.push(`  [${c.id}] ${terminalSafe(c.connector)}, ${terminalSafe(c.actionName)}  (${hhmm(c.at)}${c.cited ? "" : ", não citado"}${status})`);
+            }
+        }
     }
     out.push("", "Limites:");
     for (const limit of res.limits)
@@ -70,12 +105,50 @@ export function formatAsk(res, opts) {
     }
     return out;
 }
+async function askTerminal(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return (await rl.question(question)).trim();
+    }
+    finally {
+        rl.close();
+    }
+}
 /**
- * `omnispace ask`: a question about this folder's space, answered by the server from the latest
- * published version. Reads nothing from the folder besides .omni/space.json, and writes nothing.
- * Never retried: an answer costs tokens.
+ * The s/n for each pending request (C4): the person sees it in full and decides. Only "s" runs it;
+ * anything else is a refusal. Without a terminal nothing is asked and nothing runs: the request
+ * just expires. The confirmation is never retried: it runs an action.
  */
-export async function askSpace(args) {
+export async function decidePending(pending, ctx, opts) {
+    if (pending.length === 0)
+        return;
+    const interactive = opts.interactive ?? Boolean(process.stdin.isTTY);
+    for (const p of pending) {
+        for (const line of formatPending(p))
+            console.log(line);
+        if (!interactive) {
+            console.log("  Nada foi executado: sem terminal para confirmar. O pedido vence sozinho; para fazer, rode a pergunta de novo num terminal.\n");
+            continue;
+        }
+        const answer = (await (opts.ask ?? askTerminal)("  Executar? [s/n] ")).trim().toLowerCase();
+        const decision = answer === "s" || answer === "sim" ? "s" : "n";
+        const res = await callApi(ctx.apiUrl, ctx.token, "/api/cli/actions/confirm", { spaceId: ctx.spaceId, requestId: p.id, decision });
+        if (decision === "n") {
+            console.log(res.ok ? "  Recusado. Nada foi executado.\n" : `  ${terminalSafe(String(res.error))}\n`);
+            continue;
+        }
+        if (res.ok) {
+            console.log("  ✓ Executado.");
+            if (typeof res.output === "string")
+                console.log(`  Resultado: ${terminalSafe(res.output)}`);
+            console.log("");
+        }
+        else {
+            console.log(`  ✗ Não executado: ${terminalSafe(String(res.error))}\n`);
+        }
+    }
+}
+export async function askSpace(args, opts = {}) {
     const config = await readSpaceConfig(args.folder);
     if (!config) {
         console.log(`\n${basename(args.folder)} não é um espaço Omni (não tem .omni/space.json).`);
@@ -107,9 +180,10 @@ export async function askSpace(args) {
         return 1;
     }
     console.log("");
-    const opts = { baseVersion: config.baseVersion, sourcesOnly: args.sourcesOnly, details: args.details };
-    for (const line of formatAsk(res, opts))
+    const answer = res;
+    for (const line of formatAsk(answer, { baseVersion: config.baseVersion, sourcesOnly: args.sourcesOnly, details: args.details }))
         console.log(line);
     console.log("");
+    await decidePending(answer.pending ?? [], { apiUrl: config.apiUrl, token, spaceId: config.spaceId }, opts);
     return 0;
 }

package/dist/env-connectors.js

@@ -0,0 +1,88 @@
+// Copy of apps/omni/src/lib/env-connectors.ts (C4 item 1, docs/plan/c4-ferramentas-no-ask.md): the
+// server decides what it binds; the CLI uses the same rules only to ask, before sending, which
+// group turns on the connector when the chosen keys have more than one. Change both together; the
+// tests on each side use the same cases.
+const SUPABASE_KEY_SUFFIXES = ["_SERVICE_ROLE_KEY", "_SERVICE_KEY"];
+const CLICKUP_TOKEN = /^CLICKUP(?:_[A-Z0-9]+)*_(?:API_KEY|API_TOKEN|TOKEN)$/;
+const CLICKUP_TEAM_KEYS = ["CLICKUP_TEAM_ID", "CLICKUP_WORKSPACE_ID"];
+/**
+ * Supabase: `<P>_URL` with `<P>_SERVICE_ROLE_KEY` or `<P>_SERVICE_KEY`, where P has SUPABASE in it
+ * (SUPABASE, SUPABASE_TOOLS, NOVODASH_SUPABASE...). `NEXT_PUBLIC_<P>_URL` counts as `<P>_URL`, and
+ * `<P>_URL` wins when both exist. ClickUp: a token key (`CLICKUP_API_KEY`, `CLICKUP_API_TOKEN`,
+ * `CLICKUP_TOKEN`, `CLICKUP_<X>_TOKEN`) with `CLICKUP_TEAM_ID` (or `CLICKUP_WORKSPACE_ID`).
+ */
+export function detectEnvGroups(keyNames) {
+    const keys = new Set(keyNames);
+    const groups = [];
+    const partial = [];
+    // Supabase
+    const urlByPrefix = new Map();
+    for (const key of keys) {
+        const m = /^(?:NEXT_PUBLIC_)?(.*SUPABASE.*)_URL$/.exec(key);
+        if (!m)
+            continue;
+        const prefix = m[1];
+        const current = urlByPrefix.get(prefix);
+        if (!current || current.startsWith("NEXT_PUBLIC_"))
+            urlByPrefix.set(prefix, key);
+    }
+    for (const [prefix, urlKey] of [...urlByPrefix].sort(([a], [b]) => a.localeCompare(b))) {
+        const serviceKey = SUPABASE_KEY_SUFFIXES.map((s) => `${prefix}${s}`).find((k) => keys.has(k));
+        if (!serviceKey)
+            continue;
+        groups.push({ connectorId: "supabase", label: prefix, credential: { service_role_key: serviceKey }, config: { project_url: urlKey } });
+    }
+    if (!groups.some((g) => g.connectorId === "supabase")) {
+        const loose = [...keys]
+            .filter((k) => /SUPABASE/.test(k) && (/_URL$/.test(k) || SUPABASE_KEY_SUFFIXES.some((s) => k.endsWith(s))))
+            .sort();
+        // A public URL alone is what every Supabase front end has: not a half-done connector.
+        if (loose.some((k) => !k.startsWith("NEXT_PUBLIC_")))
+            partial.push({ connectorId: "supabase", keys: loose });
+    }
+    // ClickUp
+    const tokens = [...keys].filter((k) => CLICKUP_TOKEN.test(k)).sort();
+    const team = CLICKUP_TEAM_KEYS.find((k) => keys.has(k));
+    if (tokens.length > 0 && team) {
+        for (const token of tokens) {
+            groups.push({ connectorId: "clickup", label: token, credential: { api_key: token }, config: { team_id: team } });
+        }
+    }
+    else if (tokens.length > 0 || team) {
+        partial.push({ connectorId: "clickup", keys: [...tokens, ...(team ? [team] : [])] });
+    }
+    return { groups, partial };
+}
+/**
+ * The group that turns on each connector: the only one, or the one the person picked. `null` in
+ * `choice` means the person said none. More than one and no valid pick: ambiguous, nothing is bound.
+ */
+export function chooseGroups(groups, choice = {}) {
+    const chosen = [];
+    const ambiguous = [];
+    const byConnector = new Map();
+    for (const g of groups)
+        byConnector.set(g.connectorId, [...(byConnector.get(g.connectorId) ?? []), g]);
+    for (const [connectorId, list] of byConnector) {
+        if (connectorId in choice) {
+            const picked = choice[connectorId];
+            if (picked === null)
+                continue;
+            const match = list.find((g) => g.label === picked);
+            if (match)
+                chosen.push(match);
+            else
+                ambiguous.push({ connectorId, labels: list.map((g) => g.label) });
+            continue;
+        }
+        if (list.length === 1)
+            chosen.push(list[0]);
+        else
+            ambiguous.push({ connectorId, labels: list.map((g) => g.label) });
+    }
+    return { chosen, ambiguous };
+}
+/** A ClickUp team (workspace) id: digits only. */
+export function isClickUpTeamId(value) {
+    return /^\d{1,20}$/.test(value.trim());
+}

package/dist/env.js

@@ -3,6 +3,7 @@ import { createInterface } from "node:readline/promises";
 import { callApi } from "./api.js";
 import { insecureApiUrl, loadToken, readSpaceConfig } from "./config.js";
 import { maskValue, readEnvVars } from "./dotenv.js";
+import { chooseGroups, detectEnvGroups } from "./env-connectors.js";
 import { openBrowser } from "./login.js";
 import { RETRY_DELAYS_MS } from "./retry.js";
 const STATUS_TEXT = {
@@ -11,9 +12,9 @@ const STATUS_TEXT = {
     error: "com erro",
     disabled: "desligado",
 };
-const USAGE = `Uso:
-  omnispace env push [pasta]                      pergunta chave por chave o que vai para o cofre do espaço
-  omnispace env list [pasta]                      mostra as chaves guardadas (só nomes)
+const USAGE = `Uso:
+  omnispace env push [pasta]                      pergunta chave por chave o que vai para o cofre do espaço
+  omnispace env list [pasta]                      mostra as chaves guardadas (só nomes)
   omnispace env rm <CHAVE>... [--arquivo .env] [--pasta <pasta>]  apaga do cofre, de vez`;
 async function askTerminal(question) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -25,7 +26,7 @@ async function askTerminal(question) {
     }
 }
 /** The space of this folder and this machine's session, or a printed reason why not. */
-async function context(root) {
+export async function context(root) {
     const config = await readSpaceConfig(root);
     if (!config?.spaceId) {
         console.error(config ? "O espaço desta pasta ainda não foi criado. Termine a conta no navegador." : "Esta pasta não é um espaço Omni. Rode omnispace init primeiro.");
@@ -44,7 +45,7 @@ async function context(root) {
     }
     return { apiUrl: config.apiUrl, token, spaceId: config.spaceId };
 }
-function refused(res, what) {
+export function refused(res, what) {
     console.error(`${what}: ${res.error}`);
     if (res.expired || res.status === 401)
         console.error("Para entrar de novo: omnispace login");
@@ -53,7 +54,7 @@ function refused(res, what) {
  * Asks for the on-the-spot verification and waits for the browser. Returns the device code to send
  * with the action, or null (refused, expired, failed).
  */
-async function verify(ctx, action, keys, opts) {
+export async function verify(ctx, action, keys, opts) {
     const log = opts.log ?? ((line) => console.log(line));
     const start = await callApi(ctx.apiUrl, ctx.token, "/api/cli/verify/start", { spaceId: ctx.spaceId, action, keys }, { retryDelaysMs: RETRY_DELAYS_MS });
     if (!start.ok) {
@@ -93,6 +94,31 @@ async function readVault(ctx) {
     }
     return { keys: res.keys, connectors: (res.connectors ?? []) };
 }
+const CONNECTOR_NAME = { supabase: "Supabase", clickup: "ClickUp" };
+/**
+ * When the chosen keys hold more than one set for the same connector (the Novo Dash has two Supabase
+ * projects), the person picks which one turns it on; the others stay only in the vault (C4 item 1).
+ * An answer that is not on the list counts as none: nothing is bound by guess.
+ */
+export async function chooseConnectorGroups(accepted, ask, log) {
+    const { groups } = detectEnvGroups(accepted.map((v) => v.key));
+    const { ambiguous } = chooseGroups(groups);
+    const connect = {};
+    for (const { connectorId, labels } of ambiguous) {
+        const name = CONNECTOR_NAME[connectorId];
+        log("");
+        log(`Há mais de um conjunto de chaves para o ${name}. Qual liga o conector ${name} deste espaço?`);
+        labels.forEach((label, i) => log(`  ${i + 1}) ${label}`));
+        log("  n) nenhum (as chaves ficam só no cofre)");
+        const answer = (await ask(`Escolha [1-${labels.length}/n] `)).trim().toLowerCase();
+        const index = Number.parseInt(answer, 10);
+        const picked = /^\d+$/.test(answer) && index >= 1 && index <= labels.length ? labels[index - 1] : null;
+        if (!picked && answer !== "n")
+            log(`Resposta fora da lista: o ${name} não será ligado agora.`);
+        connect[connectorId] = picked;
+    }
+    return connect;
+}
 async function push(root, opts) {
     const log = opts.log ?? ((line) => console.log(line));
     const ask = opts.ask ?? askTerminal;
@@ -133,6 +159,7 @@ async function push(root, opts) {
         log("\nNada escolhido. Nada foi enviado.");
         return 0;
     }
+    const connect = await chooseConnectorGroups(accepted, ask, log);
     const keys = accepted.map(({ file, key }) => ({ file, key }));
     const deviceCode = await verify(ctx, "env_push", keys, opts);
     if (!deviceCode)
@@ -141,6 +168,7 @@ async function push(root, opts) {
         spaceId: ctx.spaceId,
         verification: deviceCode,
         entries: accepted.map(({ file, key, value }) => ({ file, key, value })),
+        ...(Object.keys(connect).length > 0 ? { connect } : {}),
     });
     if (!res.ok) {
         refused(res, "O cofre recusou o envio");

package/dist/include.js

@@ -9,6 +9,15 @@ export const SKIP_DIRS = new Set([
     "node_modules", ".git", ".next", ".vercel", "dist", "build", "out", "coverage",
     ".turbo", ".cache", "venv", ".venv", "__pycache__", ".idea", ".vscode", "target",
 ]);
+/**
+ * Folders skipped by where they are, not by their name alone. `.claude/worktrees/` holds full copies
+ * of a repo that Claude Code sessions work on in parallel (Lucas, 2026-09-28): synced, every copy
+ * would go up as text. Matches at any depth (a repo inside the space can have its own).
+ */
+const SKIP_DIR_PATHS_RE = /(^|\/)\.claude\/worktrees$/i;
+export function isSkippedDirPath(path) {
+    return SKIP_DIR_PATHS_RE.test(path);
+}
 // Local state of the Omni link itself: machine specific, never part of the space. `.omni/tmp/`
 // holds downloads of an unfinished pull (fatia 3); `.omni/conflicts.json` and `.omni/backups/`
 // are the conflict resolution of this machine (fatia 4); `.omni/pull-pending.json` and
@@ -74,7 +83,8 @@ export function isMachineConfig(path) {
  */
 export function neverSyncs(path) {
     const name = path.slice(path.lastIndexOf("/") + 1);
-    return isSecret(name) || isMachineConfig(path) || isLocalOnly(path);
+    const inSkippedDir = /(^|\/)\.claude\/worktrees\//i.test(path);
+    return isSecret(name) || isMachineConfig(path) || isLocalOnly(path) || inSkippedDir;
 }
 export function isText(name) {
     const lower = name.toLowerCase();
@@ -143,7 +153,7 @@ export async function buildManifest(root) {
             const abs = join(dir, entry.name);
             const relParts = [...parts, entry.name];
             if (entry.isDirectory()) {
-                if (SKIP_DIRS.has(entry.name))
+                if (SKIP_DIRS.has(entry.name) || isSkippedDirPath(normalizePath(relParts)))
                     continue;
                 // A subfolder with its own .git (repo, submodule or worktree) DOES sync, text only: the
                 // agent needs the code to act on it (find a bug, fix it, report back). Lucas, 2026-09-23,

package/dist/index.js

@@ -18,30 +18,32 @@ import { terminalAsk, unlinkMachine } from "./desvincular.js";
 import { linkExistingSpace } from "./vincular.js";
 import { askSpace, parseAskArgs } from "./ask.js";
 import { runEnv } from "./env.js";
-const USAGE = `
-Omni CLI
-
-Uso:
-  omni login                        entra na sua conta pelo navegador (a sessão vale 14 dias sem uso)
-  omni logout                       encerra a sessão da CLI nesta máquina
-  omni whoami                       mostra a conta, a máquina e até quando a sessão vale
-  omni init [pasta] [--nome <nome>] com a CLI logada, cria o espaço na sua conta e liga a pasta
-  omni init [pasta] --scan-only     varre a pasta e mostra o que encontrou
-  omni init [pasta] --link <código> varre a pasta e envia pro código mostrado no navegador
-  omni status [pasta] [--resumo]    o que mudou aqui e no servidor, e o próximo comando (só lê)
-  omni ask "<pergunta>" [pasta]     responde com base na versão publicada do espaço, com as fontes
-        [--fontes]                  só mostra quais arquivos seriam lidos, sem chamar o modelo
-        [--detalhes]                mostra também custo, contexto e arquivos consultados
-  omni sync [pasta] --push [--yes]  publica uma nova versão do espaço no servidor
-  omni sync [pasta] --pull          traz para a pasta a versão mais nova do servidor
-        [--conflito=local|mesclar|backup]  mesma resposta para todos os conflitos, sem perguntar
-  omni clone <código> <pasta>       baixa um espaço da sua conta numa pasta nova desta máquina
-  omni vincular [pasta] [--espaco <nome>]  liga uma pasta que já tem os arquivos a um espaço da conta
-  omni desvincular [pasta]          tira esta máquina da conta e o .omni/ das pastas (pede 2 confirmações)
-  omni env push|list|rm [pasta]     guarda chaves do .env no cofre do espaço, uma a uma (confirma no navegador)
-
-A CLI não reorganiza a sua pasta. Com --link, o que fazer com o que foi
-varrido é decidido na tela de revisão, no navegador.
+import { runPermissoes } from "./permissoes.js";
+const USAGE = `
+Omni CLI
+
+Uso:
+  omni login                        entra na sua conta pelo navegador (a sessão vale 14 dias sem uso)
+  omni logout                       encerra a sessão da CLI nesta máquina
+  omni whoami                       mostra a conta, a máquina e até quando a sessão vale
+  omni init [pasta] [--nome <nome>] com a CLI logada, cria o espaço na sua conta e liga a pasta
+  omni init [pasta] --scan-only     varre a pasta e mostra o que encontrou
+  omni init [pasta] --link <código> varre a pasta e envia pro código mostrado no navegador
+  omni status [pasta] [--resumo]    o que mudou aqui e no servidor, e o próximo comando (só lê)
+  omni ask "<pergunta>" [pasta]     responde com base na versão publicada do espaço, com as fontes
+        [--fontes]                  só mostra quais arquivos seriam lidos, sem chamar o modelo
+        [--detalhes]                mostra também custo, contexto e arquivos consultados
+  omni sync [pasta] --push [--yes]  publica uma nova versão do espaço no servidor
+  omni sync [pasta] --pull          traz para a pasta a versão mais nova do servidor
+        [--conflito=local|mesclar|backup]  mesma resposta para todos os conflitos, sem perguntar
+  omni clone <código> <pasta>       baixa um espaço da sua conta numa pasta nova desta máquina
+  omni vincular [pasta] [--espaco <nome>]  liga uma pasta que já tem os arquivos a um espaço da conta
+  omni desvincular [pasta]          tira esta máquina da conta e o .omni/ das pastas (pede 2 confirmações)
+  omni env push|list|rm [pasta]     guarda chaves do .env no cofre do espaço, uma a uma (confirma no navegador)
+  omni permissoes [set <conector> <ação> <estado>] [pasta]  o que o agente pode fazer sozinho em cada ação
+
+A CLI não reorganiza a sua pasta. Com --link, o que fazer com o que foi
+varrido é decidido na tela de revisão, no navegador.
 `;
 async function main(argv) {
     const args = argv.slice(2);
@@ -67,6 +69,8 @@ async function main(argv) {
         return runClone(args.slice(1));
     if (command === "env")
         return runEnv(args.slice(1), { openBrowser: process.stdout.isTTY });
+    if (command === "permissoes")
+        return runPermissoes(args.slice(1), { openBrowser: process.stdout.isTTY });
     if (command === "vincular") {
         const rest = args.slice(1);
         const espacoIndex = rest.indexOf("--espaco");
@@ -114,20 +118,20 @@ async function main(argv) {
             if (!who.ok && !who.noToken)
                 console.error(`\n${who.error}`);
             const site = defaultApiUrl();
-            console.log(`
-Omni CLI
-
-Já tem conta no Omni? Entre por aqui e rode o init de novo:
-  npx -y omnispace@latest login
-
-Primeira vez? Comece pelo navegador:
-  ${site}/omnispace/escolha
-
-Lá aparece um código (tipo ABCD-2345). Com ele, dentro da pasta do espaço, rode:
-  npx -y omnispace@latest init . --link <código>
-
-Só quer ver o que o Omni leria nesta pasta, sem enviar nada?
-  npx -y omnispace@latest init . --scan-only
+            console.log(`
+Omni CLI
+
+Já tem conta no Omni? Entre por aqui e rode o init de novo:
+  npx -y omnispace@latest login
+
+Primeira vez? Comece pelo navegador:
+  ${site}/omnispace/escolha
+
+Lá aparece um código (tipo ABCD-2345). Com ele, dentro da pasta do espaço, rode:
+  npx -y omnispace@latest init . --link <código>
+
+Só quer ver o que o Omni leria nesta pasta, sem enviar nada?
+  npx -y omnispace@latest init . --scan-only
 `);
             return who.ok || who.noToken ? 0 : 1;
         }

package/dist/permissoes.js

@@ -0,0 +1,92 @@
+import { resolve } from "node:path";
+import { callApi } from "./api.js";
+import { RETRY_DELAYS_MS } from "./retry.js";
+import { context, refused, verify } from "./env.js";
+// `omnispace permissoes` (docs/plan/permissoes-por-acao.md; Lucas, 2026-09-28): what the agent may
+// do on its own with each connector action of the space. Tightening applies right away; loosening
+// asks for the confirmation in the browser, like a credential.
+const STATES = ["automatico", "confirmar", "bloqueado"];
+const STATE_LABEL = { automatico: "automático", confirmar: "pedir confirmação", bloqueado: "bloqueado" };
+const ORIGIN_LABEL = { padrao: "padrão do Omni", usuario: "definida por você", importacao: "importada" };
+const USAGE = `Uso:
+  omnispace permissoes [pasta]                                  lista as ações dos conectores do espaço e o que o agente pode fazer
+  omnispace permissoes set <conector> <ação> <estado> [pasta]   muda uma ação: automatico, confirmar ou bloqueado
+Liberar (bloqueado para confirmar, ou para automático) pede confirmação no navegador; restringir vale na hora.`;
+export function parseStateArg(value) {
+    const plain = (value ?? "").toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "");
+    return STATES.find((s) => s === plain) ?? null;
+}
+async function list(root, opts) {
+    const log = opts.log ?? ((line) => console.log(line));
+    const ctx = await context(root);
+    if (!ctx)
+        return 1;
+    const res = await callApi(ctx.apiUrl, ctx.token, "/api/cli/permissions/list", { spaceId: ctx.spaceId }, { retryDelaysMs: RETRY_DELAYS_MS });
+    if (!res.ok) {
+        refused(res, "Falha ao ler as permissões");
+        return 1;
+    }
+    const rows = res.permissions;
+    if (rows.length === 0) {
+        log("Este espaço ainda não tem conector. As permissões aparecem aqui quando houver um (omnispace env push).");
+        return 0;
+    }
+    let current = "";
+    for (const r of rows) {
+        if (r.connectorId !== current) {
+            current = r.connectorId;
+            log(`\n${r.connectorName} (${r.connectorId})`);
+        }
+        log(`  ${r.actionKey.padEnd(22)} ${r.actionName.padEnd(26)} ${r.kind.padEnd(10)} ${STATE_LABEL[r.state].padEnd(18)} ${ORIGIN_LABEL[r.origin] ?? r.origin}`);
+    }
+    log("\nPara mudar: omnispace permissoes set <conector> <ação> <automatico|confirmar|bloqueado>");
+    return 0;
+}
+async function set(root, connectorId, actionKey, state, opts) {
+    const log = opts.log ?? ((line) => console.log(line));
+    const ctx = await context(root);
+    if (!ctx)
+        return 1;
+    const changes = [{ connectorId, actionKey, state }];
+    // Not retried: a repeat after a cut connection is harmless (same state), but it is reported.
+    let res = await callApi(ctx.apiUrl, ctx.token, "/api/cli/permissions/set", { spaceId: ctx.spaceId, changes });
+    if (!res.ok && res.needsVerification) {
+        log(`Liberar ${connectorId}:${actionKey} (${STATE_LABEL[state]}) deixa o agente fazer mais sozinho.`);
+        const interactive = opts.interactive ?? Boolean(process.stdin.isTTY);
+        if (!interactive) {
+            console.error("Sem terminal para acompanhar a confirmação no navegador. Nada mudou.");
+            return 1;
+        }
+        const code = await verify(ctx, "perm_set", [{ file: `${connectorId}:${actionKey}`, key: state }], opts);
+        if (!code)
+            return 1;
+        res = await callApi(ctx.apiUrl, ctx.token, "/api/cli/permissions/set", { spaceId: ctx.spaceId, changes, verification: code });
+    }
+    if (!res.ok) {
+        refused(res, "A permissão não mudou");
+        return 1;
+    }
+    const applied = res.applied;
+    if (applied.length === 0)
+        log(`${connectorId}:${actionKey} já estava como ${STATE_LABEL[state]}. Nada mudou.`);
+    else
+        log(`✓ ${connectorId}:${actionKey}: ${STATE_LABEL[applied[0].from]} → ${STATE_LABEL[applied[0].to]}.`);
+    return 0;
+}
+export async function runPermissoes(args, opts = {}) {
+    const [first, ...rest] = args;
+    if (first === "set") {
+        const [connectorId, actionKey, stateArg, folder] = rest;
+        const state = parseStateArg(stateArg);
+        if (!connectorId || !actionKey || !state) {
+            console.error(USAGE);
+            return 1;
+        }
+        return set(resolve(folder ?? process.cwd()), connectorId, actionKey, state, opts);
+    }
+    if (first === "--help" || first === "-h" || first === "help") {
+        console.log(USAGE);
+        return 0;
+    }
+    return list(resolve(first && first !== "list" ? first : (rest[0] ?? process.cwd())), opts);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omnispace",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Omni CLI (alpha): transforma uma pasta da sua máquina em um espaço Omni e sincroniza entre máquinas.",
   "type": "module",
   "bin": {