biaws 0.2.2 → 0.3.0

package/README.md

@@ -122,6 +122,7 @@ biaws workspace api PATCH /recurso/ID --body '{"status":"Ativo"}'
 ```bash
 biaws workspace agent configure codex
 biaws workspace agent configure claude
+biaws workspace agent configure codex --no-interactive --env-file /caminho/instancia.env --workspace workspace-id
 biaws workspace agent doctor codex
 biaws workspace skills list
 biaws workspace skills install SKILL_ID

package/docs/command-taxonomy.md

@@ -61,9 +61,8 @@ flags > variáveis de ambiente > configuração da pasta > perfil global > defau
 ```
 
 As variáveis canônicas são `BIAWS_API_URL`, `BIAWS_API_KEY` e
-`BIAWS_WORKSPACE_ID`. Os nomes `ISSUE_*` permanecem aceitos como variáveis de
-ambiente internas durante a transição do backend, mas não representam comandos
-antigos do CLI.
+`BIAWS_WORKSPACE_ID`. Variáveis com o prefixo temporário anterior não são
+aceitas como aliases.
 
 ## Convenções
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "biaws",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "CLI do Bondia Workspaces para administração, configuração e operação de workspaces",
   "license": "Apache-2.0",
   "repository": {

package/src/commandFactories.js

@@ -4,6 +4,7 @@ import { AuthenticatedApiCommand, ProjectCommand } from "./baseCommands.js";
 import {
   configureContextFlags,
   configureContextInput,
+  interactiveConfigureInput,
   legacyAgentContext,
 } from "./configure/command.js";
 import { runAgentCommand } from "./commands/agent.js";
@@ -85,12 +86,21 @@ export function createAgentCommand(action) {
 
     async run() {
       const { args, flags } = await this.parse(this.constructor);
-      const context = await this.projectContext(configureContextInput(flags));
+      const input =
+        action === "configure"
+          ? await interactiveConfigureInput(this, flags)
+          : configureContextInput(flags);
+      const context = await this.projectContext(input);
       await runAgentCommand(
         context.api,
         action,
         [args.client],
-        { ...flags, project: context.projectDirectory },
+        {
+          ...flags,
+          interactive: input.interactive,
+          project: context.projectDirectory,
+          prompts: this.adapters.prompts,
+        },
         legacyAgentContext(context),
       );
     }

package/src/commands/agent.js

@@ -4,13 +4,14 @@ import path from "node:path";
 
 import { BaseCommand, TOOL_DIRECTORY } from "../baseCommands.js";
 import { showTopic } from "../commandFactories.js";
+import { CliError } from "../core/errors.js";
 import { readLock } from "../localSkills.js";
 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.1.0";
+export const MCP_PACKAGE_VERSION = "0.2.0";
 export const MCP_PACKAGE_SPEC = `${MCP_PACKAGE_NAME}@${MCP_PACKAGE_VERSION}`;
 const MCP_COMMAND = "npx";
 const MCP_ARGS = ["--yes", MCP_PACKAGE_SPEC];
@@ -75,7 +76,7 @@ async function writeCodexConfiguration(
 [mcp_servers.biaws]
 command = ${JSON.stringify(MCP_COMMAND)}
 args = ${JSON.stringify(MCP_ARGS)}
-env = {${envFile ? ` BIAWS_ENV_FILE = ${JSON.stringify(envFile)},` : ""} ISSUE_WORKSPACE_ID = ${JSON.stringify(workspaceId)} }
+env = {${envFile ? ` BIAWS_ENV_FILE = ${JSON.stringify(envFile)},` : ""} BIAWS_WORKSPACE_ID = ${JSON.stringify(workspaceId)} }
 ${CODEX_END}
 `;
   const output = current ? `${current}\n\n${managed}` : managed;
@@ -113,14 +114,19 @@ async function writeClaudeConfiguration(
     args: MCP_ARGS,
     env: {
       ...(envFile ? { BIAWS_ENV_FILE: envFile } : {}),
-      ISSUE_WORKSPACE_ID: workspaceId,
+      BIAWS_WORKSPACE_ID: workspaceId,
     },
   };
   await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
   return configPath;
 }
 
-async function resolveWorkspaceId(api, requestedWorkspaceId = "") {
+async function resolveWorkspaceId(
+  api,
+  requestedWorkspaceId = "",
+  interactive = false,
+  prompts,
+) {
   let identity;
   try {
     identity = await api.identity();
@@ -132,7 +138,22 @@ async function resolveWorkspaceId(api, requestedWorkspaceId = "") {
     }
     throw error;
   }
-  const workspaceId = requestedWorkspaceId || identity?.actor?.workspaceId;
+  const workspaces = identity?.actor?.workspaces || [];
+  let workspaceId = requestedWorkspaceId || identity?.actor?.workspaceId;
+  if (interactive && workspaces.length > 0) {
+    workspaceId = await prompts.ask({
+      name: "workspaceId",
+      type: "select",
+      message: "Workspace do projeto",
+      choices: workspaces.map((workspace) => ({
+        name: workspace.name
+          ? `${workspace.name} (${workspace.id})`
+          : workspace.id,
+        value: workspace.id,
+      })),
+      ...(workspaceId ? { default: workspaceId } : {}),
+    });
+  }
   if (!workspaceId) {
     if ((identity?.actor?.workspaces?.length || 0) > 1) {
       throw new Error(
@@ -153,7 +174,29 @@ async function configure(api, client, options, context) {
     );
   }
   const projectDirectory = path.resolve(options.project || process.cwd());
-  const { workspaceId } = await resolveWorkspaceId(api, context.workspaceId);
+  const { workspaceId } = await resolveWorkspaceId(
+    api,
+    context.workspaceId,
+    options.interactive,
+    options.prompts,
+  );
+  if (options.interactive) {
+    const confirmed = await options.prompts.ask({
+      name: "confirmConfiguration",
+      type: "confirm",
+      message: `Configurar ${client} em ${projectDirectory} para o workspace ${workspaceId}?`,
+      default: true,
+    });
+    if (!confirmed) {
+      throw new CliError(
+        "Configuração cancelada antes de qualquer alteração.",
+        {
+          code: "PROMPT_CANCELLED",
+          exitCode: 130,
+        },
+      );
+    }
+  }
   const target = skillTarget(client, projectDirectory);
   const configPath =
     client === "codex"
@@ -213,7 +256,7 @@ async function mcpStatus(envFile, workspaceId) {
       env: {
         ...process.env,
         ...(envFile ? { BIAWS_ENV_FILE: envFile } : {}),
-        ISSUE_WORKSPACE_ID: workspaceId,
+        BIAWS_WORKSPACE_ID: workspaceId,
       },
     });
     let output = "";
@@ -302,7 +345,7 @@ function configurationStatus(client, contents, envFile, workspaceId) {
       contents.includes(`command = ${JSON.stringify(MCP_COMMAND)}`) &&
       contents.includes(`args = ${JSON.stringify(MCP_ARGS)}`) &&
       (!envFile || contents.includes(JSON.stringify(envFile))) &&
-      contents.includes(`ISSUE_WORKSPACE_ID = ${JSON.stringify(workspaceId)}`);
+      contents.includes(`BIAWS_WORKSPACE_ID = ${JSON.stringify(workspaceId)}`);
     return {
       ok,
       detail: ok
@@ -316,7 +359,7 @@ function configurationStatus(client, contents, envFile, workspaceId) {
       server?.command === MCP_COMMAND &&
       JSON.stringify(server.args || []) === JSON.stringify(MCP_ARGS) &&
       (!envFile || server.env?.BIAWS_ENV_FILE === envFile) &&
-      server.env?.ISSUE_WORKSPACE_ID === workspaceId;
+      server.env?.BIAWS_WORKSPACE_ID === workspaceId;
     return {
       ok,
       detail: ok

package/src/commands/configure/claude.js

@@ -1,7 +1,7 @@
 import { ProjectCommand } from "../../baseCommands.js";
 import {
   configureContextFlags,
-  configureContextInput,
+  interactiveConfigureInput,
   legacyAgentContext,
 } from "../../configure/command.js";
 import { runAgentCommand } from "../agent.js";
@@ -13,12 +13,18 @@ export default class ConfigureClaude extends ProjectCommand {
 
   async run() {
     const { flags } = await this.parse(ConfigureClaude);
-    const context = await this.projectContext(configureContextInput(flags));
+    const input = await interactiveConfigureInput(this, flags);
+    const context = await this.projectContext(input);
     await runAgentCommand(
       context.api,
       "configure",
       ["claude"],
-      { ...flags, project: context.projectDirectory },
+      {
+        ...flags,
+        interactive: input.interactive,
+        project: context.projectDirectory,
+        prompts: this.adapters.prompts,
+      },
       legacyAgentContext(context),
     );
   }

package/src/commands/configure/codex.js

@@ -1,7 +1,7 @@
 import { ProjectCommand } from "../../baseCommands.js";
 import {
   configureContextFlags,
-  configureContextInput,
+  interactiveConfigureInput,
   legacyAgentContext,
 } from "../../configure/command.js";
 import { runAgentCommand } from "../agent.js";
@@ -13,12 +13,18 @@ export default class ConfigureCodex extends ProjectCommand {
 
   async run() {
     const { flags } = await this.parse(ConfigureCodex);
-    const context = await this.projectContext(configureContextInput(flags));
+    const input = await interactiveConfigureInput(this, flags);
+    const context = await this.projectContext(input);
     await runAgentCommand(
       context.api,
       "configure",
       ["codex"],
-      { ...flags, project: context.projectDirectory },
+      {
+        ...flags,
+        interactive: input.interactive,
+        project: context.projectDirectory,
+        prompts: this.adapters.prompts,
+      },
       legacyAgentContext(context),
     );
   }

package/src/configuration/commands.js

@@ -52,7 +52,7 @@ function credentialsWithKey(configuration, name, apiKey) {
 async function requiredApiKey(command) {
   const fromEnvironment = String(
     command.adapters.environment.BIAWS_API_KEY ||
-      command.adapters.environment.ISSUE_API_KEY ||
+      command.adapters.environment.BIAWS_API_KEY ||
       "",
   ).trim();
   if (fromEnvironment) return fromEnvironment;

package/src/configure/command.js

@@ -2,6 +2,8 @@ import path from "node:path";
 
 import { Args, Flags } from "@oclif/core";
 
+import { CliError } from "../core/errors.js";
+
 export const configureContextFlags = Object.freeze({
   project: Flags.string({
     char: "p",
@@ -16,6 +18,12 @@ export const configureContextFlags = Object.freeze({
   "env-file": Flags.string({
     description: "arquivo privado com URL e chave de API",
   }),
+  interactive: Flags.boolean({
+    char: "i",
+    allowNo: true,
+    description:
+      "usa o modo assistente (padrão em terminais; use --no-interactive para desativar)",
+  }),
   force: Flags.boolean({
     char: "f",
     description: "substitui somente a configuração BIAWS conflitante",
@@ -23,6 +31,46 @@ export const configureContextFlags = Object.freeze({
   json: Flags.boolean({ description: "emite somente JSON em stdout" }),
 });
 
+export async function interactiveConfigureInput(command, flags) {
+  const interactive =
+    flags.interactive === true ||
+    (flags.interactive !== false && command.adapters.terminal.isInteractive);
+  if (!interactive) {
+    return { ...configureContextInput(flags), interactive: false };
+  }
+  if (!command.adapters.prompts.isInteractive) {
+    throw new CliError("O modo assistente exige um terminal interativo.", {
+      code: "INTERACTIVE_INPUT_UNAVAILABLE",
+      exitCode: 2,
+    });
+  }
+  const project = String(
+    await command.adapters.prompts.ask({
+      name: "project",
+      message: "Diretório do projeto",
+      default: flags.project || command.adapters.cwd(),
+    }),
+  ).trim();
+  const envFile = String(
+    await command.adapters.prompts.ask({
+      name: "envFile",
+      message: "Arquivo privado da instância (BIAWS_ENV_FILE)",
+      default:
+        flags["env-file"] || command.adapters.environment.BIAWS_ENV_FILE || "",
+    }),
+  ).trim();
+  if (!envFile) {
+    throw new CliError("Informe o arquivo privado da instância.", {
+      code: "ENV_FILE_REQUIRED",
+      exitCode: 2,
+    });
+  }
+  return {
+    ...configureContextInput({ ...flags, project, "env-file": envFile }),
+    interactive: true,
+  };
+}
+
 export const clientArgument = Args.string({
   description: "cliente a diagnosticar",
   options: ["codex", "claude"],

package/src/core/context.js

@@ -126,32 +126,31 @@ export async function resolveCommandContext(options) {
   const configuredApiUrl =
     input.apiUrl ||
     explicitFileEnv.BIAWS_API_URL ||
-    explicitFileEnv.ISSUE_API_URL ||
+    explicitFileEnv.BIAWS_API_URL ||
+    environment.BIAWS_API_URL ||
     environment.BIAWS_API_URL ||
-    environment.ISSUE_API_URL ||
-    environment.ISSUE_API_BASE_URL ||
+    environment.BIAWS_API_BASE_URL ||
     workspaceConfiguration.apiUrl ||
     profile.config.apiUrl ||
-    effectiveEnv.ISSUE_API_URL ||
-    effectiveEnv.ISSUE_API_BASE_URL ||
+    effectiveEnv.BIAWS_API_URL ||
+    effectiveEnv.BIAWS_API_BASE_URL ||
     DEFAULT_API_URL;
   const configuredApiKey = String(
     input.apiKey ||
       explicitFileEnv.BIAWS_API_KEY ||
-      explicitFileEnv.ISSUE_API_KEY ||
+      explicitFileEnv.BIAWS_API_KEY ||
+      environment.BIAWS_API_KEY ||
       environment.BIAWS_API_KEY ||
-      environment.ISSUE_API_KEY ||
       profile.credentials.apiKey ||
-      effectiveEnv.ISSUE_API_KEY ||
+      effectiveEnv.BIAWS_API_KEY ||
       "",
   );
   const configuredWorkspaceId = String(
     input.workspaceId ||
       input.workspace ||
       environment.BIAWS_WORKSPACE_ID ||
-      environment.ISSUE_WORKSPACE_ID ||
       workspaceConfiguration.workspaceId ||
-      effectiveEnv.ISSUE_WORKSPACE_ID ||
+      effectiveEnv.BIAWS_WORKSPACE_ID ||
       "",
   ).trim();
 

package/src/instance/service.js

@@ -6,8 +6,8 @@ import { parseEnv } from "../core/context.js";
 
 const PORT_FIELDS = Object.freeze({
   mongoPort: "MONGO_PORT",
-  apiPort: "ISSUE_API_PORT",
-  uiPort: "ISSUE_UI_PORT",
+  apiPort: "BIAWS_API_PORT",
+  uiPort: "BIAWS_UI_PORT",
 });
 
 const STORAGE_FIELDS = Object.freeze({
@@ -143,11 +143,11 @@ export async function listInstances(context, filesystem) {
       directory,
       envFile: path.join(directory, ".env"),
       mongoPort: Number(env.MONGO_PORT || 27_017),
-      apiPort: Number(env.ISSUE_API_PORT || 3_100),
-      uiPort: Number(env.ISSUE_UI_PORT || 4_400),
+      apiPort: Number(env.BIAWS_API_PORT || 3_100),
+      uiPort: Number(env.BIAWS_UI_PORT || 4_400),
       publicUrl:
         env.BIAWS_PUBLIC_URL ||
-        `http://localhost:${env.ISSUE_UI_PORT || 4_400}`,
+        `http://localhost:${env.BIAWS_UI_PORT || 4_400}`,
       storage: Object.values(STORAGE_FIELDS).some((key) => env[key])
         ? "directories"
         : "volumes",