biaws 0.3.0 → 0.5.0

package/src/commands/agent.js

@@ -11,30 +11,23 @@ import { runSkillsCommand } from "./skills.js";
 const CODEX_BEGIN = "# BEGIN BIAWS MANAGED MCP";
 const CODEX_END = "# END BIAWS MANAGED MCP";
 export const MCP_PACKAGE_NAME = "biaws-mcp";
-export const MCP_PACKAGE_VERSION = "0.2.0";
+export const MCP_PACKAGE_VERSION = "0.12.0";
 export const MCP_PACKAGE_SPEC = `${MCP_PACKAGE_NAME}@${MCP_PACKAGE_VERSION}`;
 const MCP_COMMAND = "npx";
 const MCP_ARGS = ["--yes", MCP_PACKAGE_SPEC];
 
 function skillTarget(client, projectDirectory) {
-  return path.join(
-    projectDirectory,
-    client === "claude" ? ".claude" : ".agents",
-    "skills",
-  );
+  return path.join(projectDirectory, client === "claude" ? ".claude" : ".agents", "skills");
 }
 
 function isExpectedClaudeServer(server) {
-  if (
-    server?.command === MCP_COMMAND &&
-    JSON.stringify(server.args || []) === JSON.stringify(MCP_ARGS)
-  ) {
+  if (server?.command === MCP_COMMAND && JSON.stringify(server.args || []) === JSON.stringify(MCP_ARGS)) {
     return true;
   }
   return (
     server?.command === "node" &&
     server.args?.length === 1 &&
-    /(?:^|[\\/])biaws-mcp[\\/]src[\\/]index\.js$/u.test(server.args[0])
+    /(?:^|[\\/])biaws-mcp[\\/](?:(?:dist[\\/])?src[\\/]index\.js|bin[\\/]biaws-mcp\.js)$/u.test(server.args[0])
   );
 }
 
@@ -47,12 +40,7 @@ async function readOptional(filePath, fallback = "") {
   }
 }
 
-async function writeCodexConfiguration(
-  projectDirectory,
-  envFile,
-  workspaceId,
-  force,
-) {
+async function writeCodexConfiguration(projectDirectory, envFile, workspaceId, force) {
   const configPath = path.join(projectDirectory, ".codex", "config.toml");
   await mkdir(path.dirname(configPath), { recursive: true });
   let current = await readOptional(configPath);
@@ -67,10 +55,7 @@ async function writeCodexConfiguration(
     );
   }
   if (force) {
-    current = current.replace(
-      /\n?\[mcp_servers\.biaws\]\n(?:[^[\n].*\n?)*/gu,
-      "",
-    );
+    current = current.replace(/\n?\[mcp_servers\.biaws\]\n(?:[^[\n].*\n?)*/gu, "");
   }
   const managed = `${CODEX_BEGIN}
 [mcp_servers.biaws]
@@ -84,12 +69,7 @@ ${CODEX_END}
   return configPath;
 }
 
-async function writeClaudeConfiguration(
-  projectDirectory,
-  envFile,
-  workspaceId,
-  force,
-) {
+async function writeClaudeConfiguration(projectDirectory, envFile, workspaceId, force) {
   const configPath = path.join(projectDirectory, ".mcp.json");
   const raw = await readOptional(configPath, "{}");
   let config;
@@ -99,11 +79,7 @@ async function writeClaudeConfiguration(
     throw new Error(`JSON inválido em ${configPath}`);
   }
   config.mcpServers ||= {};
-  if (
-    config.mcpServers.biaws &&
-    !force &&
-    !isExpectedClaudeServer(config.mcpServers.biaws)
-  ) {
+  if (config.mcpServers.biaws && !force && !isExpectedClaudeServer(config.mcpServers.biaws)) {
     throw new Error(
       `Já existe uma configuração Claude diferente para o servidor biaws em ${configPath}; use --force para substituí-la`,
     );
@@ -121,12 +97,7 @@ async function writeClaudeConfiguration(
   return configPath;
 }
 
-async function resolveWorkspaceId(
-  api,
-  requestedWorkspaceId = "",
-  interactive = false,
-  prompts,
-) {
+async function resolveWorkspaceId(api, requestedWorkspaceId = "", interactive = false, prompts) {
   let identity;
   try {
     identity = await api.identity();
@@ -146,9 +117,7 @@ async function resolveWorkspaceId(
       type: "select",
       message: "Workspace do projeto",
       choices: workspaces.map((workspace) => ({
-        name: workspace.name
-          ? `${workspace.name} (${workspace.id})`
-          : workspace.id,
+        name: workspace.name ? `${workspace.name} (${workspace.id})` : workspace.id,
         value: workspace.id,
       })),
       ...(workspaceId ? { default: workspaceId } : {}),
@@ -169,17 +138,10 @@ async function resolveWorkspaceId(
 
 async function configure(api, client, options, context) {
   if (!["codex", "claude"].includes(client)) {
-    throw new Error(
-      "Informe o cliente: biaws workspace agent configure codex|claude",
-    );
+    throw new Error("Informe o cliente: biaws workspace agent configure codex|claude");
   }
   const projectDirectory = path.resolve(options.project || process.cwd());
-  const { workspaceId } = await resolveWorkspaceId(
-    api,
-    context.workspaceId,
-    options.interactive,
-    options.prompts,
-  );
+  const { workspaceId } = await resolveWorkspaceId(api, context.workspaceId, options.interactive, options.prompts);
   if (options.interactive) {
     const confirmed = await options.prompts.ask({
       name: "confirmConfiguration",
@@ -188,31 +150,19 @@ async function configure(api, client, options, context) {
       default: true,
     });
     if (!confirmed) {
-      throw new CliError(
-        "Configuração cancelada antes de qualquer alteração.",
-        {
-          code: "PROMPT_CANCELLED",
-          exitCode: 130,
-        },
-      );
+      throw new CliError("Configuração cancelada antes de qualquer alteração.", {
+        code: "PROMPT_CANCELLED",
+        exitCode: 130,
+      });
     }
   }
+  const scopedApi = api.withWorkspace ? api.withWorkspace(workspaceId) : api;
   const target = skillTarget(client, projectDirectory);
   const configPath =
     client === "codex"
-      ? await writeCodexConfiguration(
-          projectDirectory,
-          context.envFile,
-          workspaceId,
-          options.force,
-        )
-      : await writeClaudeConfiguration(
-          projectDirectory,
-          context.envFile,
-          workspaceId,
-          options.force,
-        );
-  const installation = await runSkillsCommand(api, "install-all", [], {
+      ? await writeCodexConfiguration(projectDirectory, context.envFile, workspaceId, options.force)
+      : await writeClaudeConfiguration(projectDirectory, context.envFile, workspaceId, options.force);
+  const installation = await runSkillsCommand(scopedApi, "install-all", [], {
     target,
     force: options.force,
     json: false,
@@ -289,6 +239,13 @@ async function mcpStatus(envFile, workspaceId) {
         if (!line.trim()) continue;
         try {
           const message = JSON.parse(line);
+          if (message.error) {
+            finish({
+              ok: false,
+              detail: message.error.message || "MCP recusou a chamada",
+            });
+            return;
+          }
           if (message.id === 1 && message.result && !toolsRequested) {
             toolsRequested = true;
             child.stdin.write(
@@ -313,9 +270,7 @@ async function mcpStatus(envFile, workspaceId) {
       }
     });
     child.on("error", (error) => finish({ ok: false, detail: error.message }));
-    child.stdin.on("error", (error) =>
-      finish({ ok: false, detail: error.message }),
-    );
+    child.stdin.on("error", (error) => finish({ ok: false, detail: error.message }));
     child.on("exit", (code) => {
       if (!settled && code !== null) {
         finish({
@@ -329,7 +284,11 @@ async function mcpStatus(envFile, workspaceId) {
         jsonrpc: "2.0",
         id: 1,
         method: "initialize",
-        params: { protocolVersion: "2024-11-05", capabilities: {} },
+        params: {
+          protocolVersion: "2024-11-05",
+          capabilities: {},
+          clientInfo: { name: "biaws-agent-doctor", version: "1.0.0" },
+        },
       })}\n`,
     );
   });
@@ -348,9 +307,7 @@ function configurationStatus(client, contents, envFile, workspaceId) {
       contents.includes(`BIAWS_WORKSPACE_ID = ${JSON.stringify(workspaceId)}`);
     return {
       ok,
-      detail: ok
-        ? null
-        : "A configuração Codex não aponta para a instância selecionada",
+      detail: ok ? null : "A configuração Codex não aponta para a instância selecionada",
     };
   }
   try {
@@ -362,9 +319,7 @@ function configurationStatus(client, contents, envFile, workspaceId) {
       server.env?.BIAWS_WORKSPACE_ID === workspaceId;
     return {
       ok,
-      detail: ok
-        ? null
-        : "A configuração Claude não aponta para a instância selecionada",
+      detail: ok ? null : "A configuração Claude não aponta para a instância selecionada",
     };
   } catch {
     return { ok: false, detail: "Configuração Claude contém JSON inválido" };
@@ -373,9 +328,7 @@ function configurationStatus(client, contents, envFile, workspaceId) {
 
 async function doctor(api, client, options, context) {
   if (!["codex", "claude"].includes(client)) {
-    throw new Error(
-      "Informe o cliente: biaws workspace agent doctor codex|claude",
-    );
+    throw new Error("Informe o cliente: biaws workspace agent doctor codex|claude");
   }
   const projectDirectory = path.resolve(options.project || process.cwd());
   const target = skillTarget(client, projectDirectory);
@@ -397,12 +350,7 @@ async function doctor(api, client, options, context) {
     workspace: { ok: true, id: resolved.workspaceId },
     mcp,
     configuration: {
-      ...configurationStatus(
-        client,
-        configContents,
-        context.envFile,
-        resolved.workspaceId,
-      ),
+      ...configurationStatus(client, configContents, context.envFile, resolved.workspaceId),
       path: configPath,
     },
     skills: {
@@ -424,13 +372,7 @@ async function doctor(api, client, options, context) {
   return result;
 }
 
-export async function runAgentCommand(
-  api,
-  action,
-  positional,
-  options,
-  context,
-) {
+export async function runAgentCommand(api, action, positional, options, context) {
   const client = positional[0];
   if (action === "configure") return configure(api, client, options, context);
   if (action === "doctor") return doctor(api, client, options, context);

package/src/commands/api.js

@@ -3,8 +3,7 @@ import { Help } from "@oclif/core";
 import { AuthenticatedApiCommand } from "../baseCommands.js";
 
 export default class Api extends AuthenticatedApiCommand {
-  static description =
-    "Executa operações autenticadas nos recursos da API do Bondia Workspaces";
+  static description = "Executa operações autenticadas nos recursos da API do Bondia Workspaces";
   static examples = [
     "<%= config.bin %> api workspaces list --json",
     "<%= config.bin %> api demands get <id-ou-código> --json",

package/src/commands/applications/get.js

@@ -10,8 +10,6 @@ export default class ApplicationGet extends ReadCommand {
       resource: "application",
       operation: "get",
     });
-    this.emit(flags, result, (p) =>
-      JSON.stringify(p.application || p, null, 2),
-    );
+    this.emit(flags, result, (p) => JSON.stringify(p.application || p, null, 2));
   }
 }

package/src/commands/applications/list.js

@@ -1,8 +1,4 @@
-import {
-  connectionFlags,
-  listFlags,
-  ReadCommand,
-} from "../../domain/readCommand.js";
+import { connectionFlags, listFlags, ReadCommand } from "../../domain/readCommand.js";
 import { table } from "../../domain/readService.js";
 export default class ApplicationList extends ReadCommand {
   static description = "lista aplicações do workspace";

package/src/commands/configure/claude.js

@@ -1,14 +1,9 @@
 import { ProjectCommand } from "../../baseCommands.js";
-import {
-  configureContextFlags,
-  interactiveConfigureInput,
-  legacyAgentContext,
-} from "../../configure/command.js";
+import { configureContextFlags, interactiveConfigureInput, legacyAgentContext } from "../../configure/command.js";
 import { runAgentCommand } from "../agent.js";
 
 export default class ConfigureClaude extends ProjectCommand {
-  static description =
-    "configura MCP e skills do Claude sem persistir credenciais no projeto";
+  static description = "configura MCP e skills do Claude sem persistir credenciais no projeto";
   static flags = configureContextFlags;
 
   async run() {

package/src/commands/configure/codex.js

@@ -1,14 +1,9 @@
 import { ProjectCommand } from "../../baseCommands.js";
-import {
-  configureContextFlags,
-  interactiveConfigureInput,
-  legacyAgentContext,
-} from "../../configure/command.js";
+import { configureContextFlags, interactiveConfigureInput, legacyAgentContext } from "../../configure/command.js";
 import { runAgentCommand } from "../agent.js";
 
 export default class ConfigureCodex extends ProjectCommand {
-  static description =
-    "configura MCP e skills do Codex sem persistir credenciais no projeto";
+  static description = "configura MCP e skills do Codex sem persistir credenciais no projeto";
   static flags = configureContextFlags;
 
   async run() {

package/src/commands/configure/skills.js

@@ -3,10 +3,7 @@ import path from "node:path";
 import { Args, Flags } from "@oclif/core";
 
 import { ProjectCommand } from "../../baseCommands.js";
-import {
-  configureContextFlags,
-  configureContextInput,
-} from "../../configure/command.js";
+import { configureContextFlags, configureContextInput } from "../../configure/command.js";
 import { CliError } from "../../core/errors.js";
 import { runSkillsCommand } from "../skills.js";
 
@@ -35,20 +32,16 @@ export default class ConfigureSkills extends ProjectCommand {
     const context = await this.projectContext(configureContextInput(flags), {
       requireWorkspace: true,
     });
-    const target = path.join(
-      context.projectDirectory,
-      flags.client === "claude" ? ".claude" : ".agents",
-      "skills",
-    );
+    const target = path.join(context.projectDirectory, flags.client === "claude" ? ".claude" : ".agents", "skills");
     let action = args.action;
     let positional = args.skill ? [args.skill] : [];
     if (action === "install" && flags.all) action = "install-all";
     if (action === "install" && !args.skill) {
       if (!context.isInteractive) {
-        throw new CliError(
-          "Informe o ID da skill ou use --all em modo não interativo.",
-          { code: "SKILL_SELECTION_REQUIRED", exitCode: 2 },
-        );
+        throw new CliError("Informe o ID da skill ou use --all em modo não interativo.", {
+          code: "SKILL_SELECTION_REQUIRED",
+          exitCode: 2,
+        });
       }
       const catalog = await context.api.list();
       if (!catalog.items.length)

package/src/commands/configure.js

@@ -3,8 +3,7 @@ import { Help } from "@oclif/core";
 import { ProjectCommand } from "../baseCommands.js";
 
 export default class Configure extends ProjectCommand {
-  static description =
-    "Configura projetos, clientes de agentes e skills de desenvolvimento";
+  static description = "Configura projetos, clientes de agentes e skills de desenvolvimento";
   static examples = [
     "<%= config.bin %> configure codex",
     "<%= config.bin %> configure claude",

package/src/commands/demands/get.js

@@ -6,11 +6,11 @@ export default class DemandGet extends ReadCommand {
   static flags = connectionFlags;
   async run() {
     const { args, flags } = await this.parse(DemandGet);
-    const result = await this.read(
-      flags,
-      (api, c) => api.demand(args.id, { workspaceId: c.workspaceId }),
-      { resource: "demand", operation: "get", requireWorkspace: true },
-    );
+    const result = await this.read(flags, (api, c) => api.demand(args.id, { workspaceId: c.workspaceId }), {
+      resource: "demand",
+      operation: "get",
+      requireWorkspace: true,
+    });
     this.emit(flags, result, (p) => JSON.stringify(p.request || p, null, 2));
   }
 }

package/src/commands/demands/list.js

@@ -1,9 +1,5 @@
 import { Flags } from "@oclif/core";
-import {
-  connectionFlags,
-  listFlags,
-  ReadCommand,
-} from "../../domain/readCommand.js";
+import { connectionFlags, listFlags, ReadCommand } from "../../domain/readCommand.js";
 import { table } from "../../domain/readService.js";
 export default class DemandList extends ReadCommand {
   static description = "lista melhorias no escopo informado";

package/src/commands/demands/task-status.js

@@ -26,10 +26,7 @@ export default class DemandTaskStatus extends WriteCommand {
       flags,
       "task",
       async (service) => {
-        const { request, task } = findTask(
-          await service.demand(args.demand),
-          args.task,
-        );
+        const { request, task } = findTask(await service.demand(args.demand), args.task);
         return {
           resource: "task",
           operation: "status.update",
@@ -42,8 +39,7 @@ export default class DemandTaskStatus extends WriteCommand {
           entity: task,
         };
       },
-      (service, plan) =>
-        service.updateTaskStatus(plan.requestId, plan.taskId, plan.status),
+      (service, plan) => service.updateTaskStatus(plan.requestId, plan.taskId, plan.status),
     );
   }
 }

package/src/commands/demands/tasks.js

@@ -17,9 +17,7 @@ export default class DemandTasks extends ReadCommand {
           workspaceId: c.workspaceId,
         });
         const request = payload.request || payload;
-        const items = (request.tasks || []).filter(
-          (x) => !flags.status || x.status === flags.status,
-        );
+        const items = (request.tasks || []).filter((x) => !flags.status || x.status === flags.status);
         return { items, meta: { total: items.length } };
       },
       {

package/src/commands/instance/backup.js

@@ -1,21 +1,11 @@
 import { Flags } from "@oclif/core";
 
 import { LocalInstanceCommand } from "../../baseCommands.js";
-import {
-  contextFlags,
-  contextInput,
-  instanceArgument,
-} from "../../instance/command.js";
-import {
-  backupArguments,
-  executeInstanceScript,
-  getInstance,
-  withPasswordFile,
-} from "../../instance/service.js";
+import { contextFlags, contextInput, instanceArgument } from "../../instance/command.js";
+import { backupArguments, executeInstanceScript, getInstance, withPasswordFile } from "../../instance/service.js";
 
 export default class InstanceBackup extends LocalInstanceCommand {
-  static description =
-    "cria backup completo, criptografado e verificável de uma instância";
+  static description = "cria backup completo, criptografado e verificável de uma instância";
   static args = { instance: instanceArgument };
   static flags = {
     ...contextFlags,
@@ -32,11 +22,7 @@ export default class InstanceBackup extends LocalInstanceCommand {
   async run() {
     const { args, flags } = await this.parse(InstanceBackup);
     const context = await this.localContext(contextInput(flags, args.instance));
-    const instance = await getInstance(
-      context,
-      this.adapters.filesystem,
-      args.instance,
-    );
+    const instance = await getInstance(context, this.adapters.filesystem, args.instance);
     let password;
     if (!flags["password-file"]) {
       if (!context.isInteractive)

package/src/commands/instance/list.js

@@ -1,11 +1,7 @@
 import { Flags } from "@oclif/core";
 
 import { LocalInstanceCommand } from "../../baseCommands.js";
-import {
-  contextFlags,
-  contextInput,
-  writeResult,
-} from "../../instance/command.js";
+import { contextFlags, contextInput, writeResult } from "../../instance/command.js";
 import { listInstances } from "../../instance/service.js";
 
 export default class InstanceList extends LocalInstanceCommand {
@@ -18,9 +14,7 @@ export default class InstanceList extends LocalInstanceCommand {
   async run() {
     const { flags } = await this.parse(InstanceList);
     const context = await this.localContext(contextInput(flags));
-    const instances = (
-      await listInstances(context, this.adapters.filesystem)
-    ).map(({ env, ...item }) => item);
+    const instances = (await listInstances(context, this.adapters.filesystem)).map(({ env, ...item }) => item);
     writeResult(
       this,
       instances,

package/src/commands/instance/remove.js

@@ -1,20 +1,11 @@
 import { Flags } from "@oclif/core";
 
 import { LocalInstanceCommand } from "../../baseCommands.js";
-import {
-  contextFlags,
-  contextInput,
-  instanceArgument,
-} from "../../instance/command.js";
-import {
-  executeInstanceScript,
-  getInstance,
-  removeArguments,
-} from "../../instance/service.js";
+import { contextFlags, contextInput, instanceArgument } from "../../instance/command.js";
+import { executeInstanceScript, getInstance, removeArguments } from "../../instance/service.js";
 
 export default class InstanceRemove extends LocalInstanceCommand {
-  static description =
-    "remove uma instância preservando bind mounts externos por padrão";
+  static description = "remove uma instância preservando bind mounts externos por padrão";
   static args = { instance: instanceArgument };
   static flags = {
     ...contextFlags,
@@ -28,11 +19,7 @@ export default class InstanceRemove extends LocalInstanceCommand {
   async run() {
     const { args, flags } = await this.parse(InstanceRemove);
     const context = await this.localContext(contextInput(flags, args.instance));
-    const instance = await getInstance(
-      context,
-      this.adapters.filesystem,
-      args.instance,
-    );
+    const instance = await getInstance(context, this.adapters.filesystem, args.instance);
     if (!flags.yes) {
       if (!context.isInteractive)
         this.error("Remoção exige --yes em modo não interativo.", {

package/src/commands/instance/restore.js

@@ -1,21 +1,11 @@
 import { Flags } from "@oclif/core";
 
 import { LocalInstanceCommand } from "../../baseCommands.js";
-import {
-  contextFlags,
-  contextInput,
-  instanceArgument,
-} from "../../instance/command.js";
-import {
-  executeInstanceScript,
-  getInstance,
-  restoreArguments,
-  withPasswordFile,
-} from "../../instance/service.js";
+import { contextFlags, contextInput, instanceArgument } from "../../instance/command.js";
+import { executeInstanceScript, getInstance, restoreArguments, withPasswordFile } from "../../instance/service.js";
 
 export default class InstanceRestore extends LocalInstanceCommand {
-  static description =
-    "restaura um backup completo preservando a configuração do host de destino";
+  static description = "restaura um backup completo preservando a configuração do host de destino";
   static args = { instance: instanceArgument };
   static flags = {
     ...contextFlags,
@@ -37,11 +27,7 @@ export default class InstanceRestore extends LocalInstanceCommand {
   async run() {
     const { args, flags } = await this.parse(InstanceRestore);
     const context = await this.localContext(contextInput(flags, args.instance));
-    const instance = await getInstance(
-      context,
-      this.adapters.filesystem,
-      args.instance,
-    );
+    const instance = await getInstance(context, this.adapters.filesystem, args.instance);
     if (!flags.yes) {
       if (!context.isInteractive)
         this.error("Restauração exige --yes em modo não interativo.", {
@@ -72,20 +58,16 @@ export default class InstanceRestore extends LocalInstanceCommand {
         message: "Senha do backup",
       });
     }
-    const output = await withPasswordFile(
-      this.adapters.filesystem,
-      password,
-      flags["password-file"],
-      (passwordFile) =>
-        executeInstanceScript(
-          restoreArguments(instance, context, {
-            archive: flags.archive,
-            passwordFile,
-          }),
-          context,
-          this.adapters.processRunner,
-          { secrets: password ? [password] : [], silent: flags.json },
-        ),
+    const output = await withPasswordFile(this.adapters.filesystem, password, flags["password-file"], (passwordFile) =>
+      executeInstanceScript(
+        restoreArguments(instance, context, {
+          archive: flags.archive,
+          passwordFile,
+        }),
+        context,
+        this.adapters.processRunner,
+        { secrets: password ? [password] : [], silent: flags.json },
+      ),
     );
     if (flags.json)
       this.output({ json: true }).result({