omnispace 0.11.0 → 0.12.0

package/README.md

@@ -84,6 +84,13 @@ 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
+```
+
 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

package/dist/env.js

@@ -11,9 +11,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 +25,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 +44,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 +53,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) {

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.12.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": {