agent-hub-sdd 0.0.0-stage → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Hub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,74 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Agent Hub
+
+App **Windows** para orquestrar personas do SDLC no seu próprio repositório. Não é um site e não é um runtime novo: a janela do Agent Hub dispara a CLI do Cursor (`agent`) ou do Claude Code (`claude`) com o login da sua assinatura. Skills, MCP e plugins continuam na CLI. O Hub não define `CURSOR_API_KEY`, `ANTHROPIC_API_KEY` nem passa `--api-key`.
+
+## Instalar
+
+Node 20+ no PATH, depois:
+
+Na pasta do repositório (depois de `npm install`):
+
+```powershell
+npm run app
+```
+
+Pelo npm, quando a versão 0.1.1 estiver publicada:
+
+```powershell
+npx agent-hub-sdd
+```
+
+Isso abre a janela do app. Na primeira vez o npm baixa o Electron e o Next.
+
+## App no Windows (a partir do código)
+
+1. Instale o [Node.js 20+](https://nodejs.org/) e deixe `node` e `npm` no `PATH`.
+2. Instale a CLI do Cursor e/ou a do Claude Code. Faça login da assinatura, sem chave de API:
+
+```bat
+agent login
+claude auth login
+```
+
+3. Na pasta do Agent Hub:
+
+```powershell
+npm install
+scripts\dev.ps1
+```
+
+Isso abre a **janela do aplicativo** (Electron), não o Chrome. O botão **Pasta** usa o seletor nativo de pastas do Windows.
+
+### Instalador `.exe`
+
+Com o mesmo Node no PATH:
+
+```powershell
+npm run dist:win
+```
+
+O setup fica em `dist-app\Agent Hub Setup.exe`. Cria atalho no menu Iniciar. O Node 20+ continua necessário no PATH para o app empacotado subir o hub local.
+
+## Workspace
+
+O workspace é a pasta do **seu** projeto, por exemplo `C:\src\meu-app`. No app, clique em **Pasta**. Enquanto o campo estiver vazio, nada é gravado no disco do projeto.
+
+## Skills, MCP e plugins
+
+O Hub não carrega skills, MCP, plugins, hooks nem regras. Quem carrega é a CLI filha (`%USERPROFILE%\.cursor` e `%USERPROFILE%\.claude`). O spawn não usa `--bare` nem `--disable-slash-commands`. Na CLI do Cursor o Hub inclui `--approve-mcps`.
+
+## Simulador
+
+Se a CLI pedida não estiver no `PATH`, o Hub responde no simulador e não edita o projeto.
+
+## Dados
+
+`AGENT_HUB_HOME` guarda o estado. Padrão no Windows: `%USERPROFILE%\.agent-hub`.
+
+## Gastos
+
+A página **Gastos** soma o que o harness reporta. Claude Code pode enviar USD. A CLI do Cursor com assinatura muitas vezes não envia preço — o Hub mostra duração e execuções, sem inventar tarifa.
+
+## Desenvolvimento
+
+`npm run app` sobe o servidor local se a porta `43147` estiver livre e abre a janela. `npm run dev` deixa só o servidor (útil para iterar na UI). `npm test` roda o vitest.

package/components.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "radix-nova",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "zinc",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

package/electron/main.mjs

@@ -0,0 +1,132 @@
+import { spawn } from "node:child_process";
+import http from "node:http";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { app, BrowserWindow, dialog, ipcMain, shell } from "electron";
+
+const PORT = Number(process.env.AGENT_HUB_PORT || 43147);
+const HUB = `http://127.0.0.1:${PORT}`;
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.join(here, "..");
+
+let win;
+let child;
+let startedServer = false;
+
+function hubDir() {
+  return app.isPackaged ? path.join(process.resourcesPath, "hub") : repoRoot;
+}
+
+function isUp() {
+  return new Promise((resolve) => {
+    const req = http.get(HUB, (res) => {
+      res.resume();
+      resolve(true);
+    });
+    req.on("error", () => resolve(false));
+    req.setTimeout(800, () => {
+      req.destroy();
+      resolve(false);
+    });
+  });
+}
+
+async function waitForHub() {
+  for (let i = 0; i < 120; i++) {
+    if (await isUp()) return;
+    await new Promise((r) => setTimeout(r, 250));
+  }
+  throw new Error(`O servidor do Agent Hub não subiu em ${HUB}`);
+}
+
+function startServer() {
+  const cwd = hubDir();
+  const env = { ...process.env, HOSTNAME: "127.0.0.1", PORT: String(PORT) };
+  if (app.isPackaged) {
+    const serverJs = path.join(cwd, "server.js");
+    const node = process.platform === "win32" ? "node.exe" : "node";
+    return spawn(node, [serverJs], {
+      cwd,
+      env,
+      stdio: "ignore",
+      windowsHide: true,
+      shell: false,
+    });
+  }
+  const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+  return spawn(npm, ["run", "dev"], {
+    cwd,
+    env,
+    stdio: "inherit",
+    shell: process.platform === "win32",
+    windowsHide: false,
+  });
+}
+
+function createWindow() {
+  const windows = process.platform === "win32";
+  win = new BrowserWindow({
+    width: 1280,
+    height: 820,
+    minWidth: 880,
+    minHeight: 560,
+    backgroundColor: "#000000",
+    show: false,
+    autoHideMenuBar: true,
+    title: "Agent Hub",
+    ...(windows
+      ? {
+          titleBarStyle: "hidden",
+          titleBarOverlay: { color: "#000000", symbolColor: "#f4f4f5", height: 36 },
+        }
+      : {}),
+    webPreferences: {
+      preload: path.join(here, "preload.cjs"),
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: true,
+    },
+  });
+  win.once("ready-to-show", () => win.show());
+  win.loadURL(HUB);
+  win.webContents.setWindowOpenHandler(({ url }) => {
+    void shell.openExternal(url);
+    return { action: "deny" };
+  });
+}
+
+ipcMain.handle("pick-folder", async () => {
+  const parent = BrowserWindow.getFocusedWindow() ?? win;
+  const result = await dialog.showOpenDialog(parent ?? undefined, {
+    title: "Escolher workspace",
+    properties: ["openDirectory"],
+  });
+  if (result.canceled || !result.filePaths[0]) return null;
+  return result.filePaths[0];
+});
+
+app.whenReady().then(async () => {
+  try {
+    if (!(await isUp())) {
+      child = startServer();
+      startedServer = true;
+      child.on("error", (error) => {
+        void dialog.showErrorBox("Agent Hub", error.message);
+      });
+    }
+    await waitForHub();
+    createWindow();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    await dialog.showErrorBox(
+      "Agent Hub",
+      `${message}\n\nNo Windows empacotado, o Node.js 20+ precisa estar no PATH para subir o hub.`,
+    );
+    app.quit();
+  }
+});
+
+app.on("window-all-closed", () => {
+  if (startedServer && child && !child.killed) child.kill();
+  app.quit();
+});

package/electron/preload.cjs

@@ -0,0 +1,6 @@
+const { contextBridge, ipcRenderer } = require("electron");
+
+contextBridge.exposeInMainWorld("agentHub", {
+  platform: process.platform,
+  pickFolder: () => ipcRenderer.invoke("pick-folder"),
+});

package/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/next.config.ts

@@ -0,0 +1,12 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+  output: "standalone",
+  // Cache Components rejects `runtime` / `dynamic` on route handlers. The hub
+  // APIs stay Node and force-dynamic so the JSON store and SSE turns are not prerendered.
+  cacheComponents: false,
+  partialPrefetching: false,
+};
+
+export default nextConfig;

package/package.json

@@ -1,6 +1,74 @@
-{
-  "name": "agent-hub-sdd",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "agent-hub-sdd",
+  "version": "0.1.2",
+  "private": false,
+  "license": "MIT",
+  "author": "Agent Hub",
+  "description": "App Windows para agentes de SDLC sobre Cursor CLI e Claude Code",
+  "keywords": [
+    "agent",
+    "cursor",
+    "claude-code",
+    "sdd",
+    "electron",
+    "sdlc"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GustavoCostaAM/agent-hub.git"
+  },
+  "bin": {
+    "agent-hub": "scripts/cli.cjs",
+    "agent-hub-sdd": "scripts/cli.cjs"
+  },
+  "files": [
+    "electron",
+    "src",
+    "public",
+    "scripts",
+    "next.config.ts",
+    "tsconfig.json",
+    "components.json",
+    "eslint.config.mjs"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "electron/main.mjs",
+  "scripts": {
+    "dev": "next dev --webpack --hostname 127.0.0.1 --port 43147",
+    "app": "electron .",
+    "start": "next start --hostname 127.0.0.1 --port 43147",
+    "build": "next build",
+    "pack:hub": "node scripts/pack-hub.mjs",
+    "dist:win": "npm run build && npm run pack:hub && electron-builder --win --x64",
+    "lint": "eslint",
+    "test": "vitest run",
+    "prepublishOnly": "node -e \"process.exit(0)\""
+  },
+  "dependencies": {
+    "@tailwindcss/turbopack": "^4",
+    "class-variance-authority": "^0.7.1",
+    "cn": "^0.5.0",
+    "electron": "^45.0.0",
+    "lucide-react": "^1.61.0",
+    "next": "16.4.3",
+    "radix-ui": "^1.8.1",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "shadcn": "^4.22.1",
+    "tailwindcss": "^4",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "electron-builder": "^26.18.0",
+    "eslint": "^9",
+    "eslint-config-next": "16.4.3",
+    "jsdom": "^30.1.3",
+    "vitest": "^5.0.5"
+  }
+}

package/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/scripts/cli.cjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+const { spawn } = require("node:child_process");
+const path = require("node:path");
+
+const root = path.join(__dirname, "..");
+let electron;
+try {
+  electron = require("electron");
+} catch {
+  console.error("Falta o Electron. Na pasta do projeto rode: npm install");
+  process.exit(1);
+}
+
+const child = spawn(electron, [root], {
+  cwd: root,
+  stdio: "inherit",
+  env: process.env,
+  windowsHide: false,
+  shell: process.platform === "win32",
+});
+child.on("error", (error) => {
+  console.error(error.message);
+  process.exit(1);
+});
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  process.exit(code ?? 0);
+});

package/scripts/cli.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+createRequire(import.meta.url)("./cli.cjs");

package/scripts/dev.bat

@@ -0,0 +1,5 @@
+@echo off
+cd /d "%~dp0.."
+if not exist node_modules call npm install
+if errorlevel 1 exit /b 1
+npm run app

package/scripts/dev.ps1

@@ -0,0 +1,4 @@
+$ErrorActionPreference = "Stop"
+Set-Location $PSScriptRoot\..
+if (-not (Test-Path node_modules)) { npm install }
+npm run app

package/scripts/pack-hub.mjs

@@ -0,0 +1,20 @@
+import { cpSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
+const standalone = path.join(root, ".next", "standalone");
+const out = path.join(root, "dist-hub");
+
+if (!existsSync(path.join(standalone, "server.js"))) {
+  throw new Error("Rode npm run build antes de empacotar. Falta .next/standalone/server.js");
+}
+
+rmSync(out, { recursive: true, force: true });
+mkdirSync(out, { recursive: true });
+cpSync(standalone, out, { recursive: true });
+cpSync(path.join(root, ".next", "static"), path.join(out, ".next", "static"), { recursive: true });
+if (existsSync(path.join(root, "public"))) {
+  cpSync(path.join(root, "public"), path.join(out, "public"), { recursive: true });
+}
+console.log("pack-hub: dist-hub pronto");

package/src/app/api/agents/[id]/route.ts

@@ -0,0 +1,60 @@
+import { deleteAgent, getAgent, upsertAgent } from "../../../../lib/store";
+import type { Agent, HarnessId, SdlcStage } from "../../../../lib/types";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+type RouteContext = { params: Promise<{ id: string }> };
+
+const STAGES = new Set<SdlcStage>(["spec", "architect", "implement", "review", "test", "release", "custom"]);
+const HARNESSES = new Set<HarnessId>(["cursor", "claude", "mock"]);
+
+export async function GET(_request: Request, context: RouteContext) {
+  const { id } = await context.params;
+  const agent = getAgent(id);
+  if (!agent) return Response.json({ error: "Agente não encontrado" }, { status: 404 });
+  return Response.json(agent);
+}
+
+export async function PUT(request: Request, context: RouteContext) {
+  const { id } = await context.params;
+  const current = getAgent(id);
+  if (!current) return Response.json({ error: "Agente não encontrado" }, { status: 404 });
+  const body = await readJson(request);
+  if (!body) return Response.json({ error: "JSON inválido" }, { status: 400 });
+  const next: Agent = {
+    ...current,
+    name: typeof body.name === "string" && body.name.trim() ? body.name.trim() : current.name,
+    stage: isStage(body.stage) ? body.stage : current.stage,
+    harness: isHarness(body.harness) ? body.harness : current.harness,
+    model: body.model === undefined ? current.model : typeof body.model === "string" && body.model ? body.model : undefined,
+    basePrompt: typeof body.basePrompt === "string" ? body.basePrompt : current.basePrompt,
+    specs: typeof body.specs === "string" ? body.specs : current.specs,
+    color: typeof body.color === "string" && body.color ? body.color : current.color,
+    updatedAt: new Date().toISOString(),
+  };
+  return Response.json(upsertAgent(next));
+}
+
+export async function DELETE(_request: Request, context: RouteContext) {
+  const { id } = await context.params;
+  if (!getAgent(id)) return Response.json({ error: "Agente não encontrado" }, { status: 404 });
+  deleteAgent(id);
+  return new Response(null, { status: 204 });
+}
+
+function isStage(value: unknown): value is SdlcStage {
+  return typeof value === "string" && STAGES.has(value as SdlcStage);
+}
+
+function isHarness(value: unknown): value is HarnessId {
+  return typeof value === "string" && HARNESSES.has(value as HarnessId);
+}
+
+async function readJson(request: Request): Promise<Record<string, unknown> | undefined> {
+  try {
+    return (await request.json()) as Record<string, unknown>;
+  } catch {
+    return undefined;
+  }
+}

package/src/app/api/agents/route.ts

@@ -0,0 +1,51 @@
+import { newId } from "../../../lib/id";
+import { listAgents, seedIfEmpty, upsertAgent } from "../../../lib/store";
+import type { Agent, HarnessId, SdlcStage } from "../../../lib/types";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+const STAGES = new Set<SdlcStage>(["spec", "architect", "implement", "review", "test", "release", "custom"]);
+const HARNESSES = new Set<HarnessId>(["cursor", "claude", "mock"]);
+
+export async function GET() {
+  seedIfEmpty();
+  return Response.json(listAgents());
+}
+
+export async function POST(request: Request) {
+  const body = await readJson(request);
+  if (!body || typeof body.name !== "string" || !body.name.trim() || !isStage(body.stage) || !isHarness(body.harness)) {
+    return Response.json({ error: "Campos obrigatórios: name, stage, harness" }, { status: 400 });
+  }
+  const now = new Date().toISOString();
+  const agent: Agent = {
+    id: newId(),
+    name: body.name.trim(),
+    stage: body.stage,
+    harness: body.harness,
+    model: typeof body.model === "string" && body.model ? body.model : undefined,
+    basePrompt: typeof body.basePrompt === "string" ? body.basePrompt : "",
+    specs: typeof body.specs === "string" ? body.specs : "",
+    color: typeof body.color === "string" && body.color ? body.color : "#a1a1aa",
+    createdAt: now,
+    updatedAt: now,
+  };
+  return Response.json(upsertAgent(agent), { status: 201 });
+}
+
+function isStage(value: unknown): value is SdlcStage {
+  return typeof value === "string" && STAGES.has(value as SdlcStage);
+}
+
+function isHarness(value: unknown): value is HarnessId {
+  return typeof value === "string" && HARNESSES.has(value as HarnessId);
+}
+
+async function readJson(request: Request): Promise<Record<string, unknown> | undefined> {
+  try {
+    return (await request.json()) as Record<string, unknown>;
+  } catch {
+    return undefined;
+  }
+}