biaws 0.1.0 → 0.2.1

package/src/admin/commands.js

@@ -0,0 +1,214 @@
+import { createHash } from "node:crypto";
+import { tmpdir } from "node:os";
+import path from "node:path";
+
+import { Flags } from "@oclif/core";
+
+import { BaseCommand, LocalInstanceCommand } from "../baseCommands.js";
+import { CliError } from "../core/errors.js";
+
+function emit(command, json, value, human) {
+  command.output({ json }).result(json ? value : human);
+}
+
+export class AdminConfigCommand extends LocalInstanceCommand {
+  static description = "exibe os caminhos da instalação administrativa";
+  static flags = {
+    root: Flags.string({ description: "raiz da instalação" }),
+    json: Flags.boolean({ description: "emite somente JSON em stdout" }),
+  };
+
+  async run() {
+    const { flags } = await this.parse(this.constructor);
+    const context = await this.localContext({ root: flags.root });
+    const result = {
+      instancesDirectory: context.instancesDirectory,
+      repositoryRoot: context.repositoryRoot,
+      toolDirectory: context.toolDirectory,
+    };
+    emit(
+      this,
+      flags.json,
+      result,
+      [
+        `Raiz da instalação: ${result.repositoryRoot}`,
+        `Diretório de instâncias: ${result.instancesDirectory}`,
+        `Diretório do CLI: ${result.toolDirectory}`,
+      ].join("\n"),
+    );
+  }
+}
+
+export class AdminDoctorCommand extends BaseCommand {
+  static description = "diagnostica os pré-requisitos administrativos";
+  static flags = {
+    json: Flags.boolean({ description: "emite somente JSON em stdout" }),
+  };
+
+  async run() {
+    const { flags } = await this.parse(this.constructor);
+    const checks = [
+      { name: "Node.js", command: "node", args: ["--version"] },
+      { name: "Git", command: "git", args: ["--version"] },
+      { name: "Docker", command: "docker", args: ["--version"] },
+      {
+        name: "Docker Compose",
+        command: "docker",
+        args: ["compose", "version"],
+      },
+    ];
+    const items = [];
+    for (const check of checks) {
+      try {
+        const result = await this.adapters.processRunner.run(
+          check.command,
+          check.args,
+          { silent: true },
+        );
+        items.push({
+          name: check.name,
+          status: "disponível",
+          version: result.stdout.trim(),
+        });
+      } catch (error) {
+        items.push({
+          name: check.name,
+          status: "ausente",
+          error: error.message,
+        });
+      }
+    }
+    const healthy = items.every((item) => item.status === "disponível");
+    if (!healthy) process.exitCode = 1;
+    emit(
+      this,
+      flags.json,
+      { healthy, items },
+      items
+        .map(
+          (item) =>
+            `${item.name}: ${item.status}${item.version ? ` (${item.version})` : ""}`,
+        )
+        .join("\n"),
+    );
+  }
+}
+
+function githubArchive(repository, version) {
+  const base = String(repository).replace(/\/+$/u, "");
+  return `${base}/releases/download/v${version}/biaws-${version}.tar.gz`;
+}
+
+async function ensureEmptyDirectory(filesystem, directory) {
+  try {
+    const entries = await filesystem.readdir(directory);
+    if (entries.length) {
+      throw new CliError(
+        `O diretório de destino não está vazio: ${directory}.`,
+        {
+          code: "INSTALL_DIRECTORY_NOT_EMPTY",
+          exitCode: 2,
+        },
+      );
+    }
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+    await filesystem.mkdir(directory, { recursive: true });
+  }
+}
+
+async function fetchBuffer(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new CliError(`Falha ao baixar ${url}: HTTP ${response.status}.`, {
+      code: "INSTALL_DOWNLOAD_FAILED",
+    });
+  }
+  return Buffer.from(await response.arrayBuffer());
+}
+
+async function expectedChecksum(url, explicit) {
+  if (explicit) return explicit.toLocaleLowerCase("en-US");
+  const response = await fetch(`${url}.sha256`);
+  if (!response.ok) {
+    throw new CliError(
+      "A release não possui checksum publicado. Informe --checksum somente após verificar a origem do arquivo.",
+      { code: "INSTALL_CHECKSUM_REQUIRED" },
+    );
+  }
+  return (await response.text())
+    .trim()
+    .split(/\s+/u)[0]
+    .toLocaleLowerCase("en-US");
+}
+
+export class AdminInstallCommand extends BaseCommand {
+  static description = "baixa uma release verificada da plataforma BIAWS";
+  static flags = {
+    version: Flags.string({ description: "versão da release" }),
+    repository: Flags.string({
+      description: "repositório de origem",
+      default: "https://github.com/fbondia/biaws",
+    }),
+    directory: Flags.string({ char: "d", description: "diretório de destino" }),
+    checksum: Flags.string({ description: "SHA-256 verificado da release" }),
+    "dry-run": Flags.boolean({
+      description: "exibe o plano sem baixar arquivos",
+    }),
+    json: Flags.boolean({ description: "emite somente JSON em stdout" }),
+  };
+
+  async run() {
+    const { flags } = await this.parse(this.constructor);
+    const version = flags.version || this.config.version;
+    const directory = path.resolve(
+      flags.directory || path.join(this.adapters.cwd(), `biaws-${version}`),
+    );
+    const url = githubArchive(flags.repository, version);
+    const plan = { directory, source: url, version };
+    if (flags["dry-run"]) {
+      emit(
+        this,
+        flags.json,
+        { ...plan, dryRun: true },
+        `Release v${version}\nOrigem: ${url}\nDestino: ${directory}`,
+      );
+      return;
+    }
+    await ensureEmptyDirectory(this.adapters.filesystem, directory);
+    const archive = await fetchBuffer(url);
+    const checksum = await expectedChecksum(url, flags.checksum);
+    const actual = createHash("sha256").update(archive).digest("hex");
+    if (actual !== checksum) {
+      throw new CliError(
+        `Checksum inválido: esperado ${checksum}, obtido ${actual}.`,
+        { code: "INSTALL_CHECKSUM_MISMATCH" },
+      );
+    }
+    const temporary = await this.adapters.filesystem.mkdtemp(
+      path.join(tmpdir(), "biaws-install-"),
+    );
+    const archivePath = path.join(temporary, "biaws.tar.gz");
+    try {
+      await this.adapters.filesystem.writeFile(archivePath, archive);
+      await this.adapters.processRunner.run("tar", [
+        "-xzf",
+        archivePath,
+        "--strip-components=1",
+        "-C",
+        directory,
+      ]);
+    } finally {
+      await this.adapters.filesystem.rm(temporary, {
+        recursive: true,
+        force: true,
+      });
+    }
+    emit(
+      this,
+      flags.json,
+      { ...plan, checksum, installed: true },
+      `BIAWS v${version} instalado em ${directory}.\nPróximo passo: biaws admin instance setup --root ${directory}`,
+    );
+  }
+}

package/src/admin/monitoringCommands.js

@@ -0,0 +1,88 @@
+import path from "node:path";
+
+import { Args, Flags } from "@oclif/core";
+
+import { LocalInstanceCommand } from "../baseCommands.js";
+
+const contextFlags = {
+  instance: Flags.string({
+    char: "i",
+    description: "nome da instância",
+    required: true,
+  }),
+  root: Flags.string({ description: "raiz da instalação" }),
+};
+
+const descriptions = {
+  build: "constrói a imagem dos executores de monitoramento",
+  logs: "acompanha os logs dos executores de monitoramento",
+  start: "inicia os executores de monitoramento",
+  status: "exibe o estado dos executores de monitoramento",
+  stop: "interrompe os executores de monitoramento",
+  validate: "valida arquivos, segredos e a configuração dos executores",
+};
+
+export function createAdminMonitoringCommand(action) {
+  return class AdminMonitoringAction extends LocalInstanceCommand {
+    static description = descriptions[action];
+    static args = {
+      workspace: Args.string({
+        description: "identificadores locais dos workspaces",
+        multiple: true,
+      }),
+    };
+    static flags = contextFlags;
+
+    async run() {
+      const { args, flags } = await this.parse(this.constructor);
+      const context = await this.localContext({
+        instance: flags.instance,
+        root: flags.root,
+      });
+      const script = path.join(
+        context.repositoryRoot,
+        "scripts",
+        "manage-monitoring-workspaces.sh",
+      );
+      await this.adapters.processRunner.run("bash", [
+        script,
+        "--instance",
+        flags.instance,
+        action,
+        ...(args.workspace || []),
+      ]);
+    }
+  };
+}
+
+export class AdminMonitoringProvisionCommand extends LocalInstanceCommand {
+  static description =
+    "provisiona a identidade técnica de monitoramento de um workspace";
+  static args = {
+    workspace: Args.string({
+      description: "identificador local do workspace",
+      required: true,
+    }),
+  };
+  static flags = contextFlags;
+
+  async run() {
+    const { args, flags } = await this.parse(this.constructor);
+    const context = await this.localContext({
+      instance: flags.instance,
+      root: flags.root,
+    });
+    const script = path.join(
+      context.repositoryRoot,
+      "scripts",
+      "provision-monitoring-workspace.mjs",
+    );
+    await this.adapters.processRunner.run("node", [
+      script,
+      "--instance",
+      flags.instance,
+      "--workspace",
+      args.workspace,
+    ]);
+  }
+}

package/src/apiClient.js

@@ -2,6 +2,23 @@ function trimTrailingSlash(value) {
   return String(value || "").replace(/\/+$/u, "");
 }
 
+function errorCodeForStatus(status) {
+  const codes = {
+    401: "UNAUTHENTICATED",
+    403: "FORBIDDEN",
+    404: "NOT_FOUND",
+    409: "CONFLICT",
+  };
+  return codes[status] || "ISSUE_API_ERROR";
+}
+
+function apiError(response, data) {
+  const error = new Error(data?.error?.message || `HTTP ${response.status}`);
+  error.statusCode = response.status;
+  error.code = data?.error?.code || errorCodeForStatus(response.status);
+  return error;
+}
+
 export function createApiClient(baseUrl, apiKey, workspaceId = "") {
   const apiRoot = `${trimTrailingSlash(baseUrl)}/api`;
   const root = `${apiRoot}/skills`;
@@ -18,24 +35,7 @@ export function createApiClient(baseUrl, apiKey, workspaceId = "") {
       },
     });
     const data = await response.json().catch(() => null);
-    if (!response.ok) {
-      const error = new Error(
-        data?.error?.message || `HTTP ${response.status}`,
-      );
-      error.statusCode = response.status;
-      error.code =
-        data?.error?.code ||
-        (response.status === 401
-          ? "UNAUTHENTICATED"
-          : response.status === 403
-            ? "FORBIDDEN"
-            : response.status === 404
-              ? "NOT_FOUND"
-              : response.status === 409
-                ? "CONFLICT"
-                : "ISSUE_API_ERROR");
-      throw error;
-    }
+    if (!response.ok) throw apiError(response, data);
     return data;
   }
 

package/src/baseCommands.js

@@ -90,11 +90,15 @@ export class BaseCommand extends Command {
       toolDirectory: TOOL_DIRECTORY,
     };
   }
+
+  commandContext(input = {}) {
+    return resolveCommandContext(this.contextOptions(input));
+  }
 }
 
 export class LocalInstanceCommand extends BaseCommand {
   localContext(input = {}) {
-    return resolveCommandContext(this.contextOptions(input));
+    return this.commandContext(input);
   }
 }
 

package/src/cli/admin/config.js

@@ -0,0 +1 @@
+export { AdminConfigCommand as default } from "../../admin/commands.js";

package/src/cli/admin/doctor.js

@@ -0,0 +1 @@
+export { AdminDoctorCommand as default } from "../../admin/commands.js";

package/src/cli/admin/install.js

@@ -0,0 +1 @@
+export { AdminInstallCommand as default } from "../../admin/commands.js";

package/src/cli/admin/instance/backup.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/backup.js";

package/src/cli/admin/instance/list.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/list.js";

package/src/cli/admin/instance/remove.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/remove.js";

package/src/cli/admin/instance/restore.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/restore.js";

package/src/cli/admin/instance/setup.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/setup.js";

package/src/cli/admin/instance/show.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/show.js";

package/src/cli/admin/instance/start.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/start.js";

package/src/cli/admin/instance/status.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/status.js";

package/src/cli/admin/instance/stop.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/instance/stop.js";

package/src/cli/admin/monitoring/build.js

@@ -0,0 +1,3 @@
+import { createAdminMonitoringCommand } from "../../../admin/monitoringCommands.js";
+
+export default createAdminMonitoringCommand("build");

package/src/cli/admin/monitoring/logs.js

@@ -0,0 +1,3 @@
+import { createAdminMonitoringCommand } from "../../../admin/monitoringCommands.js";
+
+export default createAdminMonitoringCommand("logs");

package/src/cli/admin/monitoring/provision.js

@@ -0,0 +1 @@
+export { AdminMonitoringProvisionCommand as default } from "../../../admin/monitoringCommands.js";

package/src/cli/admin/monitoring/start.js

@@ -0,0 +1,3 @@
+import { createAdminMonitoringCommand } from "../../../admin/monitoringCommands.js";
+
+export default createAdminMonitoringCommand("start");

package/src/cli/admin/monitoring/status.js

@@ -0,0 +1,3 @@
+import { createAdminMonitoringCommand } from "../../../admin/monitoringCommands.js";
+
+export default createAdminMonitoringCommand("status");

package/src/cli/admin/monitoring/stop.js

@@ -0,0 +1,3 @@
+import { createAdminMonitoringCommand } from "../../../admin/monitoringCommands.js";
+
+export default createAdminMonitoringCommand("stop");

package/src/cli/admin/monitoring/validate.js

@@ -0,0 +1,3 @@
+import { createAdminMonitoringCommand } from "../../../admin/monitoringCommands.js";
+
+export default createAdminMonitoringCommand("validate");

package/src/cli/config/doctor.js

@@ -0,0 +1 @@
+export { ConfigDoctorCommand as default } from "../../configuration/commands.js";

package/src/cli/config/init.js

@@ -0,0 +1 @@
+export { ConfigInitCommand as default } from "../../configuration/commands.js";

package/src/cli/config/login.js

@@ -0,0 +1 @@
+export { ConfigLoginCommand as default } from "../../configuration/commands.js";

package/src/cli/config/profiles/list.js

@@ -0,0 +1 @@
+export { ConfigProfilesListCommand as default } from "../../../configuration/commands.js";

package/src/cli/config/profiles/use.js

@@ -0,0 +1 @@
+export { ConfigProfilesUseCommand as default } from "../../../configuration/commands.js";

package/src/cli/config/set.js

@@ -0,0 +1 @@
+export { ConfigSetCommand as default } from "../../configuration/commands.js";

package/src/cli/config/show.js

@@ -0,0 +1 @@
+export { ConfigShowCommand as default } from "../../configuration/commands.js";

package/src/cli/config/unset.js

@@ -0,0 +1 @@
+export { ConfigUnsetCommand as default } from "../../configuration/commands.js";

package/src/cli/help.js

@@ -0,0 +1,71 @@
+import { Args, Help } from "@oclif/core";
+
+import { LocalInstanceCommand } from "../baseCommands.js";
+
+function overview(context) {
+  return `Bondia Workspaces (BIAWS)
+
+O BIAWS organiza o contexto operacional de aplicações, melhorias, issues,
+conhecimento e agentes. Este CLI permite administrar uma instalação, configurar
+o acesso global e trabalhar com o workspace associado à pasta atual.
+
+NÍVEIS DE USO
+  admin      instala, diagnostica e opera instalação e instâncias da plataforma
+  config     gerencia URLs, perfis e credenciais globais
+  workspace  associa a pasta e acessa os recursos do workspace
+
+BIAWS CLI
+  Raiz da instalação: ${context.repositoryRoot}
+  Diretório de instâncias: ${context.instancesDirectory}
+  Diretório do CLI: ${context.toolDirectory}
+
+  Configure caminhos persistentes com as variáveis de ambiente:
+
+    BIAWS_ROOT           raiz da release ou checkout BIAWS; deve conter
+                         compose.yaml, scripts/ e os demais arquivos da plataforma
+                         e é normalmente o diretório onde foi feito o git clone
+
+    BIAWS_INSTANCES_DIR  diretório que conterá uma subpasta por instância,
+                         com seu arquivo .env e dados de configuração, normalmente
+                         é o uma pasta instances dentro do BIAWS_ROOT
+
+  Exemplo:
+    export BIAWS_ROOT=/opt/biaws
+    export BIAWS_INSTANCES_DIR=/var/lib/biaws/instances
+
+PRIMEIROS PASSOS
+  biaws config init
+  biaws workspace init
+  biaws workspace applications list
+
+AJUDA
+  biaws help admin
+  biaws help config
+  biaws help workspace issues
+
+PROJETO
+  Saiba mais sobre o projeto (e contribua se quiser):
+  https://github.com/fbondia/biaws`;
+}
+
+export default class HelpCommand extends LocalInstanceCommand {
+  static description = "explica o BIAWS ou exibe a ajuda de um comando";
+  static strict = false;
+  static args = {
+    command: Args.string({
+      description: "caminho do comando",
+      multiple: true,
+    }),
+  };
+
+  async run() {
+    const { args } = await this.parse(this.constructor);
+    const subject = args.command || [];
+    if (!subject.length) {
+      const context = await this.localContext();
+      this.log(overview(context));
+      return;
+    }
+    await new Help(this.config).showHelp(subject);
+  }
+}

package/src/cli/workspace/agent/configure/claude.js

@@ -0,0 +1 @@
+export { default } from "../../../../commands/configure/claude.js";

package/src/cli/workspace/agent/configure/codex.js

@@ -0,0 +1 @@
+export { default } from "../../../../commands/configure/codex.js";

package/src/cli/workspace/agent/doctor.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/configure/doctor.js";

package/src/cli/workspace/api.js

@@ -0,0 +1 @@
+export { default } from "../../workspace/apiCommand.js";

package/src/cli/workspace/applications/get.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/applications/get.js";

package/src/cli/workspace/applications/list.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/applications/list.js";

package/src/cli/workspace/current.js

@@ -0,0 +1 @@
+export { WorkspaceCurrentCommand as default } from "../../workspace/commands.js";

package/src/cli/workspace/demands/complete-task.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/demands/complete-task.js";

package/src/cli/workspace/demands/get.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/demands/get.js";

package/src/cli/workspace/demands/list.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/demands/list.js";

package/src/cli/workspace/demands/task-status.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/demands/task-status.js";

package/src/cli/workspace/demands/tasks.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/demands/tasks.js";

package/src/cli/workspace/get.js

@@ -0,0 +1 @@
+export { default } from "../../commands/workspaces/get.js";

package/src/cli/workspace/init.js

@@ -0,0 +1 @@
+export { WorkspaceInitCommand as default } from "../../workspace/commands.js";

package/src/cli/workspace/issues/get.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/issues/get.js";

package/src/cli/workspace/issues/list.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/issues/list.js";

package/src/cli/workspace/issues/transition.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/issues/transition.js";

package/src/cli/workspace/list.js

@@ -0,0 +1 @@
+export { default } from "../../commands/workspaces/list.js";

package/src/cli/workspace/monitoring/describe.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/monitoring/describe.js";

package/src/cli/workspace/monitoring/signal.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/monitoring/signal.js";

package/src/cli/workspace/monitoring/signals.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/monitoring/signals.js";

package/src/cli/workspace/monitoring/validate.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/monitoring/validate.js";

package/src/cli/workspace/skills/install-all.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/skills/install-all.js";

package/src/cli/workspace/skills/install.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/skills/install.js";

package/src/cli/workspace/skills/list.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/skills/list.js";

package/src/cli/workspace/skills/publish-all.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/skills/publish-all.js";

package/src/cli/workspace/skills/publish.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/skills/publish.js";

package/src/cli/workspace/skills/status.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/skills/status.js";

package/src/cli/workspace/skills/update.js

@@ -0,0 +1 @@
+export { default } from "../../../commands/skills/update.js";

package/src/cli/workspace/unlink.js

@@ -0,0 +1 @@
+export { WorkspaceUnlinkCommand as default } from "../../workspace/commands.js";

package/src/cli/workspace/use.js

@@ -0,0 +1 @@
+export { WorkspaceUseCommand as default } from "../../workspace/commands.js";