oxe-cc 1.14.0 → 1.16.0

package/packages/runtime/src/workspace/strategies/git-worktree.ts

@@ -9,21 +9,21 @@ export class GitWorktreeManager implements WorkspaceManager {
   readonly isolation_level = 'isolated' as const;
   private leases = new Map<string, WorkspaceLease>();
 
-  constructor(private readonly projectRoot: string) {}
-
-  async allocate(req: WorkspaceRequest): Promise<WorkspaceLease> {
-    const suffix = crypto.randomBytes(4).toString('hex');
-    const safeWorkItem = String(req.work_item_id).replace(/[^A-Za-z0-9._-]/g, '-');
-    const wsId = `ws-${safeWorkItem}-a${req.attempt_number}-${suffix}`;
-    const branch = `oxe/${safeWorkItem}-attempt${req.attempt_number}-${suffix}`;
-    const worktreePath = path.join(this.projectRoot, '.oxe', 'workspaces', wsId);
-
-    const baseCommit = this.git(['rev-parse', 'HEAD'], undefined, 'git_worktree requires a git repository with at least one base commit').trim();
+  constructor(private readonly projectRoot: string) {}
+
+  async allocate(req: WorkspaceRequest): Promise<WorkspaceLease> {
+    const suffix = crypto.randomBytes(4).toString('hex');
+    const safeWorkItem = String(req.work_item_id).replace(/[^A-Za-z0-9._-]/g, '-');
+    const wsId = `ws-${safeWorkItem}-a${req.attempt_number}-${suffix}`;
+    const branch = `oxe/${safeWorkItem}-attempt${req.attempt_number}-${suffix}`;
+    const worktreePath = path.join(this.projectRoot, '.oxe', 'workspaces', wsId);
+
+    const baseCommit = this.git(['rev-parse', 'HEAD'], undefined, 'git_worktree requires a git repository with at least one base commit').trim();
 
     fs.mkdirSync(path.dirname(worktreePath), { recursive: true });
 
     // Create worktree on a new branch starting from HEAD
-    this.git(['worktree', 'add', worktreePath, '-b', branch], undefined, 'failed to create git_worktree workspace');
+    this.git(['worktree', 'add', worktreePath, '-b', branch], undefined, 'failed to create git_worktree workspace');
 
     const lease: WorkspaceLease = {
       workspace_id: wsId,
@@ -72,16 +72,16 @@ export class GitWorktreeManager implements WorkspaceManager {
     this.leases.delete(id);
   }
 
-  private git(args: string[], cwd?: string, message?: string): string {
-    try {
-      return execFileSync('git', args, {
-        cwd: cwd ?? this.projectRoot,
-        encoding: 'utf8',
-        stdio: ['ignore', 'pipe', 'pipe'],
-      });
-    } catch (error) {
-      const detail = error instanceof Error ? error.message : String(error);
-      throw new Error(`${message || 'git command failed'}: git ${args.join(' ')} (${detail})`);
-    }
-  }
-}
+  private git(args: string[], cwd?: string, message?: string): string {
+    try {
+      return execFileSync('git', args, {
+        cwd: cwd ?? this.projectRoot,
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+      });
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      throw new Error(`${message || 'git command failed'}: git ${args.join(' ')} (${detail})`);
+    }
+  }
+}

package/packages/runtime/tsconfig.json

@@ -12,6 +12,12 @@
     "rootDir": "src",
     "skipLibCheck": true
   },
-  "include": ["src/**/*.ts"],
-  "exclude": ["tests/**", "node_modules/**", "dist-tests/**"]
+  "include": [
+    "src/**/*.ts"
+  ],
+  "exclude": [
+    "tests/**",
+    "node_modules/**",
+    "dist-tests/**"
+  ]
 }

package/vscode-extension/.vscodeignore

@@ -2,6 +2,8 @@
 .git/**
 .gitignore
 node_modules/**
+.vscode-test/**
+test/**
 **/*.map
 **/*.test.js
 tests/**

package/vscode-extension/package.json

@@ -1,185 +1,193 @@
-{
-  "name": "oxe-agents",
-  "displayName": "OXE Agents",
-  "description": "Agentes OXE para GitHub Copilot Chat — cada fase do ciclo como um @agente no VS Code",
-  "version": "1.14.0",
-  "publisher": "oxe-cc",
-  "license": "MIT",
-  "engines": {
-    "vscode": "^1.95.0"
-  },
-  "categories": [
-    "AI",
-    "Programming Languages",
-    "Other"
-  ],
-  "keywords": [
-    "oxe",
-    "copilot",
-    "chat",
-    "agent",
-    "workflow",
-    "spec-driven"
-  ],
-  "extensionDependencies": [
-    "GitHub.copilot-chat"
-  ],
-  "activationEvents": [
-    "onStartupFinished"
-  ],
-  "main": "./src/extension.js",
-  "contributes": {
-    "chatParticipants": [
-      {
-        "id": "oxe.router",
-        "name": "oxe",
-        "fullName": "OXE",
-        "description": "Router universal — lê STATE.md e sugere o próximo passo do ciclo OXE",
-        "isSticky": false,
-        "sampleRequest": "Qual é a situação atual do projeto e o próximo passo recomendado?"
-      },
-      {
-        "id": "oxe.ask",
-        "name": "oxe-ask",
-        "fullName": "OXE Ask",
-        "description": "Situational awareness — responde perguntas sobre o estado atual do projeto com evidência explícita",
-        "isSticky": false,
-        "sampleRequest": "Qual é a fase atual e o que foi implementado até agora?"
-      },
-      {
-        "id": "oxe.scan",
-        "name": "oxe-scan",
-        "fullName": "OXE Scan",
-        "description": "Mapeamento do codebase — reconstrói .oxe/codebase/ e contextualiza o projeto para um novo ciclo",
-        "isSticky": false,
-        "sampleRequest": "Mapeie o codebase e atualize o contexto do projeto."
-      },
-      {
-        "id": "oxe.spec",
-        "name": "oxe-spec",
-        "fullName": "OXE Spec",
-        "description": "Especificação — gera SPEC.md com critérios de aceite verificáveis a partir de requisitos",
-        "isSticky": true,
-        "sampleRequest": "Preciso adicionar autenticação JWT ao sistema. Gere a especificação.",
-        "commands": [
-          {
-            "name": "discuss",
-            "description": "Abrir discussão estruturada antes de gerar a spec"
-          }
-        ]
-      },
-      {
-        "id": "oxe.plan",
-        "name": "oxe-plan",
-        "fullName": "OXE Plan",
-        "description": "Planejamento — gera PLAN.md com ondas, tarefas, hipóteses críticas e confidence vector",
-        "isSticky": true,
-        "sampleRequest": "Gere o plano de implementação para o SPEC atual.",
-        "commands": [
-          {
-            "name": "replan",
-            "description": "Replanejar ciclo atual com motivo e lições aplicadas"
-          },
-          {
-            "name": "agents",
-            "description": "Gerar blueprint multi-agente para planos com múltiplos domínios"
-          }
-        ]
-      },
-      {
-        "id": "oxe.quick",
-        "name": "oxe-quick",
-        "fullName": "OXE Quick",
-        "description": "Plano rápido — para tarefas S/M sem SPEC formal; objetivo → passos → verify",
-        "isSticky": true,
-        "sampleRequest": "Preciso renomear a função processPayment para handlePayment em todos os arquivos."
-      },
-      {
-        "id": "oxe.execute",
-        "name": "oxe-execute",
-        "fullName": "OXE Execute",
-        "description": "Execução — implementa a onda atual do PLAN validando hipóteses antes de mutar",
-        "isSticky": true,
-        "sampleRequest": "Execute a onda atual do plano.",
-        "commands": [
-          {
-            "name": "wave",
-            "description": "Executar uma onda específica (ex: /wave 2)"
-          },
-          {
-            "name": "task",
-            "description": "Executar uma tarefa específica (ex: /task T3)"
-          }
-        ]
-      },
-      {
-        "id": "oxe.debug",
-        "name": "oxe-debug",
-        "fullName": "OXE Debug",
-        "description": "Debug — diagnóstico orientado a hipóteses durante execução travada ou falha inline",
-        "isSticky": false,
-        "sampleRequest": "A tarefa T3 está falhando com erro de timeout. Ajude a diagnosticar."
-      },
-      {
-        "id": "oxe.verify",
-        "name": "oxe-verify",
-        "fullName": "OXE Verify",
-        "description": "Verificação — valida critérios A* do SPEC contra evidências reais produzidas pelo executor",
-        "isSticky": true,
-        "sampleRequest": "Verifique se a implementação atende todos os critérios do SPEC.",
-        "commands": [
-          {
-            "name": "audit",
-            "description": "Auditoria adversarial: sem acesso ao PLAN, apenas SPEC + evidências"
-          }
-        ]
-      },
-      {
-        "id": "oxe.review",
-        "name": "oxe-review",
-        "fullName": "OXE Review",
-        "description": "Revisão de código — auditor adversarial de PR e mudanças, findings por severidade",
-        "isSticky": false,
-        "sampleRequest": "Revise as mudanças desta branch e liste os findings por severidade."
-      },
-      {
-        "id": "oxe.capabilities",
-        "name": "oxe-capabilities",
-        "fullName": "OXE Capabilities",
-        "description": "Capabilities — lista, instala, remove e atualiza capabilities nativas do projeto em .oxe/",
-        "isSticky": false,
-        "sampleRequest": "Liste as capabilities disponíveis neste projeto.",
-        "commands": [
-          {
-            "name": "list",
-            "description": "Listar capabilities instaladas"
-          },
-          {
-            "name": "install",
-            "description": "Instalar uma capability"
-          }
-        ]
-      },
-      {
-        "id": "oxe.skill",
-        "name": "oxe-skill",
-        "fullName": "OXE Skill",
-        "description": "Skills — gerencia skills e habilidades registradas no framework OXE do projeto",
-        "isSticky": false,
-        "sampleRequest": "Quais skills estão disponíveis neste projeto OXE?"
-      },
-      {
-        "id": "oxe.dashboard",
-        "name": "oxe-dashboard",
-        "fullName": "OXE Dashboard",
-        "description": "Dashboard — exibe status operacional: runtime, ondas, checkpoints e saúde do ciclo",
-        "isSticky": false,
-        "sampleRequest": "Mostre o status do dashboard: fase, active run e próximo passo."
-      }
-    ]
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/oxe-cc/oxe-cc"
-  }
-}
+{
+  "name": "oxe-agents",
+  "displayName": "OXE Agents",
+  "description": "Agentes OXE para GitHub Copilot Chat — cada fase do ciclo como um @agente no VS Code",
+  "version": "1.16.0",
+  "publisher": "oxe-cc",
+  "license": "MIT",
+  "engines": {
+    "vscode": "^1.95.0"
+  },
+  "scripts": {
+    "test": "node test/run-extension-tests.cjs",
+    "package": "vsce package --no-yarn --no-dependencies --allow-missing-repository"
+  },
+  "devDependencies": {
+    "@vscode/test-electron": "2.5.2",
+    "@vscode/vsce": "3.9.2"
+  },
+  "categories": [
+    "AI",
+    "Programming Languages",
+    "Other"
+  ],
+  "keywords": [
+    "oxe",
+    "copilot",
+    "chat",
+    "agent",
+    "workflow",
+    "spec-driven"
+  ],
+  "extensionDependencies": [
+    "GitHub.copilot-chat"
+  ],
+  "activationEvents": [
+    "onStartupFinished"
+  ],
+  "main": "./src/extension.js",
+  "contributes": {
+    "chatParticipants": [
+      {
+        "id": "oxe.router",
+        "name": "oxe",
+        "fullName": "OXE",
+        "description": "Router universal — lê STATE.md e sugere o próximo passo do ciclo OXE",
+        "isSticky": false,
+        "sampleRequest": "Qual é a situação atual do projeto e o próximo passo recomendado?"
+      },
+      {
+        "id": "oxe.ask",
+        "name": "oxe-ask",
+        "fullName": "OXE Ask",
+        "description": "Situational awareness — responde perguntas sobre o estado atual do projeto com evidência explícita",
+        "isSticky": false,
+        "sampleRequest": "Qual é a fase atual e o que foi implementado até agora?"
+      },
+      {
+        "id": "oxe.scan",
+        "name": "oxe-scan",
+        "fullName": "OXE Scan",
+        "description": "Mapeamento do codebase — reconstrói .oxe/codebase/ e contextualiza o projeto para um novo ciclo",
+        "isSticky": false,
+        "sampleRequest": "Mapeie o codebase e atualize o contexto do projeto."
+      },
+      {
+        "id": "oxe.spec",
+        "name": "oxe-spec",
+        "fullName": "OXE Spec",
+        "description": "Especificação — gera SPEC.md com critérios de aceite verificáveis a partir de requisitos",
+        "isSticky": true,
+        "sampleRequest": "Preciso adicionar autenticação JWT ao sistema. Gere a especificação.",
+        "commands": [
+          {
+            "name": "discuss",
+            "description": "Abrir discussão estruturada antes de gerar a spec"
+          }
+        ]
+      },
+      {
+        "id": "oxe.plan",
+        "name": "oxe-plan",
+        "fullName": "OXE Plan",
+        "description": "Planejamento — gera PLAN.md com ondas, tarefas, hipóteses críticas e confidence vector",
+        "isSticky": true,
+        "sampleRequest": "Gere o plano de implementação para o SPEC atual.",
+        "commands": [
+          {
+            "name": "replan",
+            "description": "Replanejar ciclo atual com motivo e lições aplicadas"
+          },
+          {
+            "name": "agents",
+            "description": "Gerar blueprint multi-agente para planos com múltiplos domínios"
+          }
+        ]
+      },
+      {
+        "id": "oxe.quick",
+        "name": "oxe-quick",
+        "fullName": "OXE Quick",
+        "description": "Plano rápido — para tarefas S/M sem SPEC formal; objetivo → passos → verify",
+        "isSticky": true,
+        "sampleRequest": "Preciso renomear a função processPayment para handlePayment em todos os arquivos."
+      },
+      {
+        "id": "oxe.execute",
+        "name": "oxe-execute",
+        "fullName": "OXE Execute",
+        "description": "Execução — implementa a onda atual do PLAN validando hipóteses antes de mutar",
+        "isSticky": true,
+        "sampleRequest": "Execute a onda atual do plano.",
+        "commands": [
+          {
+            "name": "wave",
+            "description": "Executar uma onda específica (ex: /wave 2)"
+          },
+          {
+            "name": "task",
+            "description": "Executar uma tarefa específica (ex: /task T3)"
+          }
+        ]
+      },
+      {
+        "id": "oxe.debug",
+        "name": "oxe-debug",
+        "fullName": "OXE Debug",
+        "description": "Debug — diagnóstico orientado a hipóteses durante execução travada ou falha inline",
+        "isSticky": false,
+        "sampleRequest": "A tarefa T3 está falhando com erro de timeout. Ajude a diagnosticar."
+      },
+      {
+        "id": "oxe.verify",
+        "name": "oxe-verify",
+        "fullName": "OXE Verify",
+        "description": "Verificação — valida critérios A* do SPEC contra evidências reais produzidas pelo executor",
+        "isSticky": true,
+        "sampleRequest": "Verifique se a implementação atende todos os critérios do SPEC.",
+        "commands": [
+          {
+            "name": "audit",
+            "description": "Auditoria adversarial: sem acesso ao PLAN, apenas SPEC + evidências"
+          }
+        ]
+      },
+      {
+        "id": "oxe.review",
+        "name": "oxe-review",
+        "fullName": "OXE Review",
+        "description": "Revisão de código — auditor adversarial de PR e mudanças, findings por severidade",
+        "isSticky": false,
+        "sampleRequest": "Revise as mudanças desta branch e liste os findings por severidade."
+      },
+      {
+        "id": "oxe.capabilities",
+        "name": "oxe-capabilities",
+        "fullName": "OXE Capabilities",
+        "description": "Capabilities — lista, instala, remove e atualiza capabilities nativas do projeto em .oxe/",
+        "isSticky": false,
+        "sampleRequest": "Liste as capabilities disponíveis neste projeto.",
+        "commands": [
+          {
+            "name": "list",
+            "description": "Listar capabilities instaladas"
+          },
+          {
+            "name": "install",
+            "description": "Instalar uma capability"
+          }
+        ]
+      },
+      {
+        "id": "oxe.skill",
+        "name": "oxe-skill",
+        "fullName": "OXE Skill",
+        "description": "Skills — gerencia skills e habilidades registradas no framework OXE do projeto",
+        "isSticky": false,
+        "sampleRequest": "Quais skills estão disponíveis neste projeto OXE?"
+      },
+      {
+        "id": "oxe.dashboard",
+        "name": "oxe-dashboard",
+        "fullName": "OXE Dashboard",
+        "description": "Dashboard — exibe status operacional: runtime, ondas, checkpoints e saúde do ciclo",
+        "isSticky": false,
+        "sampleRequest": "Mostre o status do dashboard: fase, active run e próximo passo."
+      }
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/propagno/oxe-build"
+  }
+}

package/vscode-extension/src/extension.js

@@ -11,6 +11,13 @@ const contractBuilder = require('./shared/contractBuilder');
 
 /** @type {vscode.OutputChannel | null} */
 let outputChannel = null;
+let registeredParticipantIds = [];
+
+function publicRegistrationApi() {
+  return Object.freeze({
+    getRegisteredParticipantIds: () => [...registeredParticipantIds],
+  });
+}
 
 function log(message) {
   if (outputChannel) outputChannel.appendLine(`[OXE Agents] ${message}`);
@@ -261,6 +268,7 @@ function makeHandler(agentDef) {
  * @param {import('vscode').ExtensionContext} context
  */
 function activate(context) {
+  registeredParticipantIds = [];
   // Criar output channel para diagnóstico
   outputChannel = vscode.window.createOutputChannel('OXE Agents');
   context.subscriptions.push(outputChannel);
@@ -271,7 +279,7 @@ function activate(context) {
     const msg = 'OXE Agents requer GitHub Copilot Chat (GitHub.copilot-chat) instalado e habilitado no VS Code.';
     log(`AVISO: ${msg}`);
     vscode.window.showWarningMessage(msg);
-    return;
+    return publicRegistrationApi();
   }
 
   // Registrar todos os agentes
@@ -282,6 +290,7 @@ function activate(context) {
       participant.iconPath = new vscode.ThemeIcon('sparkle');
       context.subscriptions.push(participant);
       registered++;
+      registeredParticipantIds.push(agentDef.id);
       log(`Agente registrado: ${agentDef.id}`);
     } catch (err) {
       log(`Falha ao registrar ${agentDef.id}: ${err.message}`);
@@ -301,6 +310,7 @@ function activate(context) {
       if (choice === 'Ver log') outputChannel?.show();
     });
   }
+  return publicRegistrationApi();
 }
 
 function deactivate() {