@orchestrator-claude/cli 3.11.0 → 3.12.0

package/dist/templates/base/claude/skills/workflow-status/SKILL.md

@@ -1,322 +1,90 @@
 ---
 name: workflow-status
 description: Consulta status detalhado do workflow atual incluindo fase, artefatos, gates e proximos passos. Use para verificar progresso ou diagnosticar problemas.
-allowed-tools: Read, Grep, Glob
 ---
 
 # Workflow Status Skill
 
-## Descricao
+## Data Source
 
-Esta skill fornece informacoes detalhadas sobre o status atual do workflow de orquestracao, incluindo fase atual, artefatos gerados, gates avaliados e proximos passos.
+All workflow state is in **PostgreSQL** via MCP tools. NEVER read `.orchestrator/orchestrator-index.json`.
 
-## Quando Usar
+### MCP Tools for Status Queries
 
-Use esta skill quando:
-- Precisar saber o status atual do workflow
-- Verificar quais artefatos foram gerados
-- Consultar progresso por fase
-- Identificar proximos passos
-- Verificar checkpoints disponiveis
-- Diagnosticar problemas no fluxo
-
-## Invocacao
-
-Exemplos de como invocar esta skill:
+| Tool | What it returns |
+|------|----------------|
+| `getStatus` | Current workflow: phase, status, pending action |
+| `getWorkflows` | All workflows with phase configs |
+| `getNextAction` | Next pending action (agent + status) |
+| `getInvocations` | Agent invocation history |
+| `getMetrics` | Workflow metrics (duration, counts) |
+| `listCheckpoints` | Checkpoint history |
 
+Load tools via ToolSearch before first use:
 ```
-"Qual o status atual do workflow?"
-
-"Mostre o progresso da implementacao"
-
-"Quais artefatos ja foram gerados?"
-
-"Em qual fase estamos?"
-
-"Quais sao os proximos passos?"
-
-"Liste os checkpoints disponiveis"
+ToolSearch("select:mcp__orchestrator-tools__getStatus")
 ```
 
-## Parametros
-
-| Parametro | Tipo | Obrigatorio | Descricao |
-|-----------|------|-------------|-----------|
-| `workflowId` | string | Nao | ID do workflow (usa atual se omitido) |
-| `detail_level` | enum | Nao | summary, standard, detailed |
-| `include_artifacts` | boolean | Nao | Incluir lista de artefatos |
-| `include_checkpoints` | boolean | Nao | Incluir lista de checkpoints |
-| `include_gates` | boolean | Nao | Incluir status dos gates |
-
-### Valores de detail_level
-
-- **summary**: Apenas fase atual e status geral
-- **standard** (default): Fase, status, ultimos artefatos, proximo passo
-- **detailed**: Tudo incluindo historico completo
-
-## Output
-
-A skill retorna informacoes estruturadas:
-
-```json
-{
-  "success": true,
-  "workflow": {
-    "id": "wf-123",
-    "type": "feature_development",
-    "feature": "OAuth2 Authentication",
-    "status": "in_progress",
-    "startedAt": "2025-12-09T10:00:00Z",
-    "updatedAt": "2025-12-09T14:30:00Z"
-  },
+## When to Use
 
-  "currentPhase": {
-    "name": "implement",
-    "status": "in_progress",
-    "startedAt": "2025-12-09T14:00:00Z",
-    "progress": {
-      "totalTasks": 10,
-      "completedTasks": 6,
-      "percentage": 60
-    }
-  },
+- Check current workflow phase and progress
+- Verify which artifacts have been generated
+- Diagnose why a workflow is stuck
+- List available checkpoints
+- Review agent invocation history
 
-  "phases": [
-    {
-      "name": "research",
-      "status": "completed",
-      "duration": "45m",
-      "artifacts": ["research-context.md"]
-    },
-    {
-      "name": "specify",
-      "status": "completed",
-      "duration": "1h",
-      "artifacts": ["spec.md"]
-    },
-    {
-      "name": "plan",
-      "status": "completed",
-      "duration": "1h 30m",
-      "artifacts": ["plan.md"]
-    },
-    {
-      "name": "tasks",
-      "status": "completed",
-      "duration": "45m",
-      "artifacts": ["tasks.md"]
-    },
-    {
-      "name": "implement",
-      "status": "in_progress",
-      "duration": "2h (ongoing)",
-      "artifacts": ["impl-001.md", "impl-002.md"]
-    }
-  ],
+## How to Report Status
 
-  "artifacts": [
-    {
-      "id": "art-001",
-      "type": "research",
-      "path": ".orchestrator/artifacts/research/research-context.md",
-      "status": "validated",
-      "createdAt": "2025-12-09T10:45:00Z"
-    },
-    {
-      "id": "art-002",
-      "type": "specification",
-      "path": ".orchestrator/artifacts/specify/spec.md",
-      "status": "validated",
-      "createdAt": "2025-12-09T11:45:00Z"
-    }
-  ],
-
-  "gates": {
-    "research": { "passed": true, "evaluatedAt": "2025-12-09T10:50:00Z" },
-    "specify": { "passed": true, "evaluatedAt": "2025-12-09T11:50:00Z" },
-    "plan": { "passed": true, "evaluatedAt": "2025-12-09T13:20:00Z" },
-    "tasks": { "passed": true, "evaluatedAt": "2025-12-09T14:00:00Z" },
-    "implement": { "passed": false, "pending": true }
-  },
-
-  "checkpoints": [
-    {
-      "id": "chk-001",
-      "phase": "specify",
-      "message": "[orchestrator] specify: specification validated",
-      "gitRef": "abc123",
-      "createdAt": "2025-12-09T11:50:00Z"
-    },
-    {
-      "id": "chk-002",
-      "phase": "plan",
-      "message": "[orchestrator] plan: technical plan approved",
-      "gitRef": "def456",
-      "createdAt": "2025-12-09T13:20:00Z"
-    }
-  ],
-
-  "nextSteps": [
-    "Completar TASK-007: Implementar middleware de autenticacao",
-    "Executar testes de integracao",
-    "Avaliar gate de implement para concluir workflow"
-  ],
-
-  "metrics": {
-    "totalDuration": "4h 30m",
-    "estimatedRemaining": "2h",
-    "artifactsGenerated": 6,
-    "gatesPassed": 4,
-    "checkpointsCreated": 4
-  }
-}
-```
-
-## Formato de Output para Usuario
-
-Quando invocada, a skill formata output amigavel:
+### Quick Status (default)
 
 ```markdown
-## Status do Workflow
-
-**ID**: wf-123
-**Tipo**: feature_development
-**Feature**: OAuth2 Authentication
-**Status**: 🟡 Em Progresso
-
-### Fase Atual: IMPLEMENT
-
-```
-[████████░░░░░░░░░░░░] 60% (6/10 tasks)
-```
+## Workflow Status
 
-### Progresso por Fase
+**ID**: wf-123 | **Type**: feature_development | **Status**: in_progress
+**Phase**: IMPLEMENT (6/10 tasks)
 
-| Fase | Status | Duracao | Artefatos |
-|------|--------|---------|-----------|
-| research | ✅ Completo | 45m | 1 |
-| specify | ✅ Completo | 1h | 1 |
-| plan | ✅ Completo | 1h 30m | 1 |
-| tasks | ✅ Completo | 45m | 1 |
-| implement | 🟡 Em Progresso | 2h | 2 |
+### Phase Progress
+| Phase | Status | Gate |
+|-------|--------|------|
+| specify | completed | passed |
+| plan | completed | passed |
+| tasks | completed | passed |
+| implement | in_progress | pending |
 
-### Gates
-
-- [x] research-complete
-- [x] specification-complete
-- [x] plan-complete
-- [x] tasks-complete
-- [ ] implementation-complete (pendente)
-
-### Proximos Passos
-
-1. Completar TASK-007: Implementar middleware de autenticacao
-2. Executar testes de integracao
-3. Avaliar gate de implement para concluir workflow
-
-### Metricas
-
-- **Tempo Total**: 4h 30m
-- **Estimativa Restante**: 2h
-- **Artefatos**: 6
-- **Checkpoints**: 4
+### Next Action
+Agent: implementer | Status: awaiting_agent
 ```
 
-## Integracao com TypeScript
-
-Esta skill invoca o handler TypeScript:
+### Detailed Status (when user asks for details)
 
-```typescript
-// src/presentation/skills/WorkflowStatusSkill.ts
+Add to quick status:
+- **Artifacts**: List with type, status (draft/validated), storage location
+- **Checkpoints**: List with phase, git ref, timestamp
+- **Invocations**: Agent history with duration and result
+- **Metrics**: Total duration, artifacts generated, gates passed
 
-export class WorkflowStatusSkillHandler extends SkillHandler {
-  name = 'workflow-status';
-  description = 'Consulta status detalhado do workflow';
+## Diagnosing Common Problems
 
-  async execute(input: WorkflowStatusInput): Promise<SkillResult> {
-    // 1. Obtem workflow atual ou por ID
-    // 2. Carrega orchestrator-index.json
-    // 3. Coleta informacoes de fases
-    // 4. Coleta status de gates
-    // 5. Lista artefatos e checkpoints
-    // 6. Calcula metricas
-    // 7. Formata output
-  }
-}
-```
+### Workflow stuck — no pending action
+1. Call `getStatus` to check current phase
+2. Call `getNextAction` — if `hasAction: false`:
+   - In implement phase → call `completeWorkflow`
+   - In other phases → orchestrator needs to set next pendingAction
 
-## Casos de Uso
-
-### Verificar Status Rapido
-```
-User: "Status do workflow?"
-Skill: workflow-status com detail_level=summary
-Output: Fase atual, status, progresso percentual
-```
-
-### Relatorio Detalhado
-```
-User: "Me de um relatorio completo do progresso"
-Skill: workflow-status com detail_level=detailed, todos includes=true
-Output: Relatorio completo com historico
-```
+### Gate not passing
+1. Call `getStatus` to see which phase is current
+2. Check artifact exists for that phase via `artifactRetrieve`
+3. Check artifact status (draft vs validated)
+4. If draft → artifact-validator hook may not have fired
 
-### Verificar Artefatos
-```
-User: "Quais artefatos ja temos?"
-Skill: workflow-status com include_artifacts=true
-Output: Lista de artefatos com status e paths
-```
-
-### Diagnostico de Problema
-```
-User: "Por que o workflow esta travado?"
-Skill: workflow-status com include_gates=true
-Output: Status detalhado mostrando gate pendente
-```
-
-## Comportamento em Casos Especiais
-
-### Nenhum Workflow Ativo
-```json
-{
-  "success": false,
-  "error": {
-    "code": "NO_ACTIVE_WORKFLOW",
-    "message": "Nenhum workflow ativo encontrado",
-    "suggestion": "Use 'orchestrate start' para iniciar um novo workflow"
-  }
-}
-```
-
-### Workflow Nao Encontrado
-```json
-{
-  "success": false,
-  "error": {
-    "code": "WORKFLOW_NOT_FOUND",
-    "message": "Workflow 'wf-xyz' nao encontrado",
-    "suggestion": "Verifique o ID ou use sem parametro para workflow atual"
-  }
-}
-```
-
-### Index Corrompido
-```json
-{
-  "success": false,
-  "error": {
-    "code": "INDEX_CORRUPTED",
-    "message": "orchestrator-index.json esta corrompido ou invalido",
-    "suggestion": "Execute 'orchestrator config validate' para diagnosticar"
-  }
-}
-```
+### Phase stuck in in_progress
+1. Check if agent invocation completed (`getInvocations`)
+2. Check if `completeAgentInvocation` was called
+3. If not → pending action may be stale
 
-## Notas Importantes
+## Important Notes
 
-1. Esta skill e **read-only** - apenas consulta, nao modifica estado
-2. Dados vem de `orchestrator-index.json` e artefatos
-3. Metricas de tempo sao calculadas a partir de timestamps
-4. Progresso de tarefas requer leitura de tasks.md
-5. Cache de 30 segundos para evitar leituras repetidas
+1. This skill is **read-only** — it queries state, never modifies it
+2. All data comes from PostgreSQL via MCP tools
+3. Artifacts content is in MinIO — use `artifactRetrieve` to read
+4. The `ping-pong-enforcer` hook auto-injects getNextAction after Agent calls

package/dist/templates/base/docker-compose.yml.hbs

@@ -154,7 +154,8 @@ services:
       POSTGRES_PORT: "5432"
       DATABASE_URL: postgresql://${POSTGRES_USER:-orchestrator}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-orchestrator}
       # MinIO object storage (requires --profile object-storage or --profile full)
-      ENABLE_OBJECT_STORAGE: "${ENABLE_OBJECT_STORAGE:-true}"
+      # ADR-013 Phase 4 (F-07): Default false — set true in .env when using object-storage profile
+      ENABLE_OBJECT_STORAGE: "${ENABLE_OBJECT_STORAGE:-false}"
       OBJECT_STORAGE_PROVIDER: minio
       OBJECT_STORAGE_ENDPOINT: "http://minio:9000"
       OBJECT_STORAGE_REGION: us-east-1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchestrator-claude/cli",
-  "version": "3.11.0",
+  "version": "3.12.0",
   "description": "Orchestrator CLI - Project scaffolding, migration and management",
   "type": "module",
   "main": "dist/index.js",