oxe-cc 1.2.1 → 1.4.0

package/oxe/workflows/route.md

@@ -6,22 +6,22 @@ Desambiguar pedidos em **linguagem natural** e devolver **exatamente um** destin
 Este passo é **meta**: só orientação. A execução real pertence ao workflow apontado.
 </objective>
 
-<context>
-- Aplicar `oxe/workflows/references/reasoning-status.md`. A saída deve ser curta, orientada a decisão e com confiança explícita quando houver ambiguidade real.
-- A tabela canónica de mapeamento vive em **`oxe/workflows/help.md`** na secção **Router (linguagem natural)**.
-- Saída no chat: **um** comando (`/oxe-*` ou `npx oxe-cc …`) e **uma** frase de justificativa — alinhado a `next.md` (sem alternativas equiparáveis).
-</context>
-
-<process>
-1. Ler a secção **Router** em `oxe/workflows/help.md` (ou `.oxe/workflows/help.md` no projeto).
-2. Classificar a intenção do utilizador e escolher **uma** linha da tabela.
-3. Se a classificação não for claramente dominante, ainda devolver um único destino, mas explicitar a confiança da escolha e a lacuna que poderia mudar o roteamento.
-4. Responder apenas:
-   - **Comando:** …
-   - **Workflow:** `oxe/workflows/<nome>.md`
-   - **Por quê:** (uma frase)
-   - **Confiança:** alta | média | baixa (só quando houver ambiguidade real)
-5. Não criar ficheiros em `.oxe/` salvo o utilizador pedir explícito registo; se o utilizador pedir rastreio: acrescentar uma linha em **`.oxe/STATE.md`** (ex.: `last_route: /oxe-scan — YYYY-MM-DD`).
+<context>
+- Aplicar `oxe/workflows/references/reasoning-status.md`. A saída deve ser curta, orientada a decisão e com confiança explícita quando houver ambiguidade real.
+- A tabela canónica de mapeamento vive em **`oxe/workflows/help.md`** na secção **Router (linguagem natural)**.
+- Saída no chat: **um** comando (`/oxe-*` ou `npx oxe-cc …`) e **uma** frase de justificativa — alinhado a `next.md` (sem alternativas equiparáveis).
+</context>
+
+<process>
+1. Ler a secção **Router** em `oxe/workflows/help.md` (ou `.oxe/workflows/help.md` no projeto).
+2. Classificar a intenção do utilizador e escolher **uma** linha da tabela.
+3. Se a classificação não for claramente dominante, ainda devolver um único destino, mas explicitar a confiança da escolha e a lacuna que poderia mudar o roteamento.
+4. Responder apenas:
+   - **Comando:** …
+   - **Workflow:** `oxe/workflows/<nome>.md`
+   - **Por quê:** (uma frase)
+   - **Confiança:** alta | média | baixa (só quando houver ambiguidade real)
+5. Não criar ficheiros em `.oxe/` salvo o utilizador pedir explícito registo; se o utilizador pedir rastreio: acrescentar uma linha em **`.oxe/STATE.md`** (ex.: `last_route: /oxe-scan — YYYY-MM-DD`).
 </process>
 
 <success_criteria>

package/oxe/workflows/session.md

@@ -1,213 +1,213 @@
-# OXE — Workflow: session
-
-<objective>
-Gerenciar **sessões OXE** em `.oxe/sessions/` para isolar artefatos por ciclo de trabalho, mantendo **`.oxe/STATE.md`** como índice global e preservando o **modo legado** quando não houver sessão ativa.
-
-Subcomandos de sessão:
-- `new <nome>`
-- `list`
-- `switch <id-ou-nome>`
-- `resume <id-ou-nome>`
-- `status`
-- `close`
-- `migrate <nome>`
-- `fork [nome-opcional]`
-- `revert <checkpoint-slug>`
-
-Subcomandos de milestone (absorvidos de `/oxe-project` e `/oxe-milestone`):
-- `milestone new [nome]` — iniciar marco de entrega (M-01, M-02, …)
-- `milestone complete` — fechar milestone ativo, arquivar em `.oxe/milestones/M-NN/`
-- `milestone status` — progresso do milestone ativo
-- `milestone audit` — Definition of Done do milestone
-
-Subcomandos de workstream (absorvidos de `/oxe-project` e `/oxe-workstream`):
-- `workstream new <nome>` — trilha paralela em `.oxe/workstreams/<nome>/`
-- `workstream switch <nome>` — definir workstream ativo
-- `workstream list` — listar trilhas
-- `workstream close <nome>` — fechar trilha
-
-Sem argumento: mostrar status atual (sessão ativa, milestone, workstream ativo).
-
-**Nota de compatibilidade v1.1.0:** `/oxe-project`, `/oxe-milestone` e `/oxe-workstream` foram incorporados por este comando. Esses comandos legados continuam funcionando mas exibem aviso de migração.
-</objective>
-
-<context>
-- Fonte de regra de path: `oxe/workflows/references/session-path-resolution.md`
-- Template da sessão: `oxe/templates/SESSION.template.md`
-- Índice global: `.oxe/SESSIONS.md`
-- Sessão ativa fica sempre em `.oxe/STATE.md`, campo `active_session`, com path relativo completo: `sessions/sNNN-slug`
-- Sem sessão ativa, os workflows continuam a operar na raiz `.oxe/`
-- Esta entrega é **workflows only**: `oxe-cc status` / `doctor` continuam legados e isso deve ser assumido nesta versão
-</context>
-
-<index_format>
-## Formato fixo de `.oxe/SESSIONS.md`
-
-```markdown
-# OXE — Índice de sessões
-
-| ID | Nome | Status | Criada | Última atividade | Resumo | Path |
-|----|------|--------|--------|------------------|--------|------|
-| s001 | auth-redesign | active | 2026-04-07 | 2026-04-07 | Sessão criada por migrate | `sessions/s001-auth-redesign` |
-```
-
-- Linha mais recente no topo
-- `switch` e `resume` atualizam **Última atividade**
-- `close` atualiza **Status** para `archived`
-</index_format>
-
-<process_new>
-## `new <nome>`
-
-1. Garantir `.oxe/`, `.oxe/sessions/` e `.oxe/global/`.
-2. Normalizar o nome para slug ASCII em kebab-case.
-3. Ler `.oxe/SESSIONS.md` se existir; calcular o próximo ID `sNNN`.
-4. Criar `.oxe/sessions/sNNN-slug/` com:
-   - `spec/`
-   - `plan/`
-   - `execution/`
-   - `verification/`
-   - `checkpoints/`
-   - `research/`
-   - `artifacts/`
-   - `workstreams/`
-5. Criar `SESSION.md` a partir de `SESSION.template.md`.
-6. Criar ou atualizar `.oxe/SESSIONS.md` com a nova linha no topo.
-7. Atualizar `.oxe/STATE.md`:
-   - `active_session: sessions/sNNN-slug`
-   - `session_id: sNNN`
-   - fase resumida e próximo passo coerentes com a sessão nova
-8. Responder no chat com ID, path da sessão e próximo passo sugerido.
-</process_new>
-
-<process_list>
-## `list`
-
-1. Ler `.oxe/SESSIONS.md`.
-2. Se o ficheiro não existir, responder que não há sessões registadas.
-3. Exibir a tabela do índice; se o utilizador pedir filtro, aceitar `--status active|archived`.
-</process_list>
-
-<process_switch>
-## `switch <id-ou-nome>`
-
-1. Ler `.oxe/SESSIONS.md`.
-2. Resolver a sessão por `sNNN`, slug ou nome exibido na tabela.
-3. Atualizar `.oxe/STATE.md` global:
-   - `active_session`
-   - `session_id`
-   - `Última atividade` dessa sessão em `.oxe/SESSIONS.md`
-4. Não mover artefatos; apenas mudar o contexto ativo.
-</process_switch>
-
-<process_resume>
-## `resume <id-ou-nome>`
-
-- Mesmo comportamento de `switch`
-- Usar wording de retomada no chat, mas sem lógica diferente
-</process_resume>
-
-<process_status>
-## `status`
-
-1. Ler `.oxe/STATE.md` global.
-2. Se houver `active_session`, abrir `SESSION.md` da sessão ativa e resumir:
-   - metadados
-   - índice de artefatos
-   - tags
-   - último evento do histórico
-3. Se não houver sessão ativa, responder com a tabela de `.oxe/SESSIONS.md` (equivalente funcional a `list`).
-</process_status>
-
-<process_close>
-## `close`
-
-1. Ler `.oxe/STATE.md`; se não houver sessão ativa, pausar e informar.
-2. Abrir `SESSION.md` da sessão ativa e marcar `Status: archived`.
-3. Atualizar `.oxe/SESSIONS.md` com `Status = archived` e `Última atividade = hoje`.
-4. Limpar de `.oxe/STATE.md`:
-   - `active_session`
-   - `session_id`
-5. Responder com a sessão encerrada e lembrar que sessões arquivadas continuam legíveis.
-</process_close>
-
-<process_migrate>
-## `migrate <nome>`
-
-1. Executar logicamente `new <nome>` para abrir uma nova sessão.
-2. Mover apenas artefatos session-scoped existentes da raiz `.oxe/`:
-   - `SPEC.md`, `ROADMAP.md`, `DISCUSS.md`, `UI-SPEC.md` → `spec/`
-   - `PLAN.md`, `QUICK.md`, `plan-agents.json`, `quick-agents.json`, `plan-agent-messages/` → `plan/`
-   - `OBSERVATIONS.md`, `DEBUG.md`, `FORENSICS.md`, `SUMMARY.md` → `execution/`
-   - `VERIFY.md`, `VALIDATION-GAPS.md`, `SECURITY.md`, `UI-REVIEW.md` → `verification/`
-   - `checkpoints/`, `CHECKPOINTS.md` → `checkpoints/`
-   - `research/`, `RESEARCH.md` → `research/`
-   - `workstreams/` → `workstreams/`
-3. Não mover:
-   - `.oxe/STATE.md`
-   - `.oxe/config.json`
-   - `.oxe/codebase/`
-   - `.oxe/SESSIONS.md`
-   - `.oxe/global/`
-4. No chat, listar:
-   - movidos
-   - mantidos globais
-   - ignorados por inexistência
-</process_migrate>
-
-<process_fork>
-## `fork [nome-opcional]`
-
-1. Verificar que existe `active_session` em `.oxe/STATE.md`. Se não houver, informar e sair.
-2. Ler `SESSION.md` da sessão ativa; anotar ID de origem (`sNNN`).
-3. Calcular próximo ID `sMMM` a partir de `.oxe/SESSIONS.md`.
-4. Se nome não fornecido, usar `fork-<slug-original>`.
-5. Criar `.oxe/sessions/sMMM-<slug>/` com as mesmas subpastas: `spec/`, `plan/`, `execution/`, `verification/`, `checkpoints/`, `research/`, `artifacts/`, `workstreams/`.
-6. **Copiar** (não mover) todos os arquivos da sessão ativa para a nova sessão, preservando estrutura de diretórios. Não copiar diretórios vazios.
-7. Criar `SESSION.md` na nova sessão a partir de `SESSION.template.md`, com:
-   - `forked_from: sNNN`
-   - `forked_at: YYYY-MM-DD`
-   - `Status: active`
-   - `Resumo: Fork de sNNN — <slug-original>`
-8. Atualizar `.oxe/SESSIONS.md`:
-   - Adicionar linha da nova sessão (topo, status `active`)
-   - **Não** alterar status da sessão original
-9. Atualizar `.oxe/STATE.md`:
-   - `active_session: sessions/sMMM-<slug>`
-   - `session_id: sMMM`
-10. Registar evento no Histórico da SESSION.md original: `YYYY-MM-DD | Forked → sMMM`
-11. Responder no chat: ID novo, path, contagem de artefatos copiados, e lembrar que a sessão original permanece intacta.
-</process_fork>
-
-<process_revert>
-## `revert <checkpoint-slug>`
-
-1. Verificar que existe sessão ativa ou operar na raiz `.oxe/`.
-2. Resolver o checkpoint: procurar em `checkpoints/` (do escopo resolvido) arquivo cujo slug corresponda ao argumento. Se não encontrar, listar checkpoints disponíveis e pedir escolha.
-3. Ler o conteúdo do checkpoint (seção `## Snapshot`):
-   - Extrair campos de STATE: `phase`, `next_step` (campo `Comando:`), `execute_mode`, `Última onda executada`, `Tarefas concluídas`
-4. Atualizar `.oxe/STATE.md` com os valores do snapshot:
-   - Sobrescrever os campos extraídos do snapshot
-   - **Não apagar** campos ausentes no snapshot (preservar `active_session`, `session_id`, config refs, etc.)
-5. Registar no Histórico da SESSION.md (se sessão ativa): `YYYY-MM-DD | Revertido para checkpoint <slug>`
-6. Registar evento em `EXECUTION-RUNTIME.md` se existir: `Revert to checkpoint <slug>`
-7. Responder no chat: quais campos foram restaurados, quais permaneceram intactos, e próximo passo sugerido baseado no STATE restaurado.
-</process_revert>
-
-<process_default>
-## Sem subcomando
-
-- Se houver sessão ativa: executar `status`
-- Se não houver sessão ativa: executar `list`
-</process_default>
-
-<success_criteria>
-- [ ] `.oxe/sessions/sNNN-slug/` é o path da sessão criado/consultado.
-- [ ] `active_session` guarda o path relativo completo no `STATE.md` global.
-- [ ] `.oxe/SESSIONS.md` usa as colunas mínimas `ID | Nome | Status | Criada | Última atividade | Resumo | Path`.
-- [ ] `close` arquiva sem apagar artefatos.
-- [ ] `migrate` move só artefatos session-scoped e preserva os globais.
-- [ ] `fork` cria sessão nova com cópia dos artefatos sem modificar a sessão de origem.
-- [ ] `fork` registra `forked_from` na SESSION.md da sessão derivada.
-- [ ] `revert` restaura STATE.md a partir do snapshot do checkpoint, sem apagar campos ausentes.
-</success_criteria>
+# OXE — Workflow: session
+
+<objective>
+Gerenciar **sessões OXE** em `.oxe/sessions/` para isolar artefatos por ciclo de trabalho, mantendo **`.oxe/STATE.md`** como índice global e preservando o **modo legado** quando não houver sessão ativa.
+
+Subcomandos de sessão:
+- `new <nome>`
+- `list`
+- `switch <id-ou-nome>`
+- `resume <id-ou-nome>`
+- `status`
+- `close`
+- `migrate <nome>`
+- `fork [nome-opcional]`
+- `revert <checkpoint-slug>`
+
+Subcomandos de milestone (absorvidos de `/oxe-project` e `/oxe-milestone`):
+- `milestone new [nome]` — iniciar marco de entrega (M-01, M-02, …)
+- `milestone complete` — fechar milestone ativo, arquivar em `.oxe/milestones/M-NN/`
+- `milestone status` — progresso do milestone ativo
+- `milestone audit` — Definition of Done do milestone
+
+Subcomandos de workstream (absorvidos de `/oxe-project` e `/oxe-workstream`):
+- `workstream new <nome>` — trilha paralela em `.oxe/workstreams/<nome>/`
+- `workstream switch <nome>` — definir workstream ativo
+- `workstream list` — listar trilhas
+- `workstream close <nome>` — fechar trilha
+
+Sem argumento: mostrar status atual (sessão ativa, milestone, workstream ativo).
+
+**Nota de compatibilidade v1.1.0:** `/oxe-project`, `/oxe-milestone` e `/oxe-workstream` foram incorporados por este comando. Esses comandos legados continuam funcionando mas exibem aviso de migração.
+</objective>
+
+<context>
+- Fonte de regra de path: `oxe/workflows/references/session-path-resolution.md`
+- Template da sessão: `oxe/templates/SESSION.template.md`
+- Índice global: `.oxe/SESSIONS.md`
+- Sessão ativa fica sempre em `.oxe/STATE.md`, campo `active_session`, com path relativo completo: `sessions/sNNN-slug`
+- Sem sessão ativa, os workflows continuam a operar na raiz `.oxe/`
+- Esta entrega é **workflows only**: `oxe-cc status` / `doctor` continuam legados e isso deve ser assumido nesta versão
+</context>
+
+<index_format>
+## Formato fixo de `.oxe/SESSIONS.md`
+
+```markdown
+# OXE — Índice de sessões
+
+| ID | Nome | Status | Criada | Última atividade | Resumo | Path |
+|----|------|--------|--------|------------------|--------|------|
+| s001 | auth-redesign | active | 2026-04-07 | 2026-04-07 | Sessão criada por migrate | `sessions/s001-auth-redesign` |
+```
+
+- Linha mais recente no topo
+- `switch` e `resume` atualizam **Última atividade**
+- `close` atualiza **Status** para `archived`
+</index_format>
+
+<process_new>
+## `new <nome>`
+
+1. Garantir `.oxe/`, `.oxe/sessions/` e `.oxe/global/`.
+2. Normalizar o nome para slug ASCII em kebab-case.
+3. Ler `.oxe/SESSIONS.md` se existir; calcular o próximo ID `sNNN`.
+4. Criar `.oxe/sessions/sNNN-slug/` com:
+   - `spec/`
+   - `plan/`
+   - `execution/`
+   - `verification/`
+   - `checkpoints/`
+   - `research/`
+   - `artifacts/`
+   - `workstreams/`
+5. Criar `SESSION.md` a partir de `SESSION.template.md`.
+6. Criar ou atualizar `.oxe/SESSIONS.md` com a nova linha no topo.
+7. Atualizar `.oxe/STATE.md`:
+   - `active_session: sessions/sNNN-slug`
+   - `session_id: sNNN`
+   - fase resumida e próximo passo coerentes com a sessão nova
+8. Responder no chat com ID, path da sessão e próximo passo sugerido.
+</process_new>
+
+<process_list>
+## `list`
+
+1. Ler `.oxe/SESSIONS.md`.
+2. Se o ficheiro não existir, responder que não há sessões registadas.
+3. Exibir a tabela do índice; se o utilizador pedir filtro, aceitar `--status active|archived`.
+</process_list>
+
+<process_switch>
+## `switch <id-ou-nome>`
+
+1. Ler `.oxe/SESSIONS.md`.
+2. Resolver a sessão por `sNNN`, slug ou nome exibido na tabela.
+3. Atualizar `.oxe/STATE.md` global:
+   - `active_session`
+   - `session_id`
+   - `Última atividade` dessa sessão em `.oxe/SESSIONS.md`
+4. Não mover artefatos; apenas mudar o contexto ativo.
+</process_switch>
+
+<process_resume>
+## `resume <id-ou-nome>`
+
+- Mesmo comportamento de `switch`
+- Usar wording de retomada no chat, mas sem lógica diferente
+</process_resume>
+
+<process_status>
+## `status`
+
+1. Ler `.oxe/STATE.md` global.
+2. Se houver `active_session`, abrir `SESSION.md` da sessão ativa e resumir:
+   - metadados
+   - índice de artefatos
+   - tags
+   - último evento do histórico
+3. Se não houver sessão ativa, responder com a tabela de `.oxe/SESSIONS.md` (equivalente funcional a `list`).
+</process_status>
+
+<process_close>
+## `close`
+
+1. Ler `.oxe/STATE.md`; se não houver sessão ativa, pausar e informar.
+2. Abrir `SESSION.md` da sessão ativa e marcar `Status: archived`.
+3. Atualizar `.oxe/SESSIONS.md` com `Status = archived` e `Última atividade = hoje`.
+4. Limpar de `.oxe/STATE.md`:
+   - `active_session`
+   - `session_id`
+5. Responder com a sessão encerrada e lembrar que sessões arquivadas continuam legíveis.
+</process_close>
+
+<process_migrate>
+## `migrate <nome>`
+
+1. Executar logicamente `new <nome>` para abrir uma nova sessão.
+2. Mover apenas artefatos session-scoped existentes da raiz `.oxe/`:
+   - `SPEC.md`, `ROADMAP.md`, `DISCUSS.md`, `UI-SPEC.md` → `spec/`
+   - `PLAN.md`, `QUICK.md`, `plan-agents.json`, `quick-agents.json`, `plan-agent-messages/` → `plan/`
+   - `OBSERVATIONS.md`, `DEBUG.md`, `FORENSICS.md`, `SUMMARY.md` → `execution/`
+   - `VERIFY.md`, `VALIDATION-GAPS.md`, `SECURITY.md`, `UI-REVIEW.md` → `verification/`
+   - `checkpoints/`, `CHECKPOINTS.md` → `checkpoints/`
+   - `research/`, `RESEARCH.md` → `research/`
+   - `workstreams/` → `workstreams/`
+3. Não mover:
+   - `.oxe/STATE.md`
+   - `.oxe/config.json`
+   - `.oxe/codebase/`
+   - `.oxe/SESSIONS.md`
+   - `.oxe/global/`
+4. No chat, listar:
+   - movidos
+   - mantidos globais
+   - ignorados por inexistência
+</process_migrate>
+
+<process_fork>
+## `fork [nome-opcional]`
+
+1. Verificar que existe `active_session` em `.oxe/STATE.md`. Se não houver, informar e sair.
+2. Ler `SESSION.md` da sessão ativa; anotar ID de origem (`sNNN`).
+3. Calcular próximo ID `sMMM` a partir de `.oxe/SESSIONS.md`.
+4. Se nome não fornecido, usar `fork-<slug-original>`.
+5. Criar `.oxe/sessions/sMMM-<slug>/` com as mesmas subpastas: `spec/`, `plan/`, `execution/`, `verification/`, `checkpoints/`, `research/`, `artifacts/`, `workstreams/`.
+6. **Copiar** (não mover) todos os arquivos da sessão ativa para a nova sessão, preservando estrutura de diretórios. Não copiar diretórios vazios.
+7. Criar `SESSION.md` na nova sessão a partir de `SESSION.template.md`, com:
+   - `forked_from: sNNN`
+   - `forked_at: YYYY-MM-DD`
+   - `Status: active`
+   - `Resumo: Fork de sNNN — <slug-original>`
+8. Atualizar `.oxe/SESSIONS.md`:
+   - Adicionar linha da nova sessão (topo, status `active`)
+   - **Não** alterar status da sessão original
+9. Atualizar `.oxe/STATE.md`:
+   - `active_session: sessions/sMMM-<slug>`
+   - `session_id: sMMM`
+10. Registar evento no Histórico da SESSION.md original: `YYYY-MM-DD | Forked → sMMM`
+11. Responder no chat: ID novo, path, contagem de artefatos copiados, e lembrar que a sessão original permanece intacta.
+</process_fork>
+
+<process_revert>
+## `revert <checkpoint-slug>`
+
+1. Verificar que existe sessão ativa ou operar na raiz `.oxe/`.
+2. Resolver o checkpoint: procurar em `checkpoints/` (do escopo resolvido) arquivo cujo slug corresponda ao argumento. Se não encontrar, listar checkpoints disponíveis e pedir escolha.
+3. Ler o conteúdo do checkpoint (seção `## Snapshot`):
+   - Extrair campos de STATE: `phase`, `next_step` (campo `Comando:`), `execute_mode`, `Última onda executada`, `Tarefas concluídas`
+4. Atualizar `.oxe/STATE.md` com os valores do snapshot:
+   - Sobrescrever os campos extraídos do snapshot
+   - **Não apagar** campos ausentes no snapshot (preservar `active_session`, `session_id`, config refs, etc.)
+5. Registar no Histórico da SESSION.md (se sessão ativa): `YYYY-MM-DD | Revertido para checkpoint <slug>`
+6. Registar evento em `EXECUTION-RUNTIME.md` se existir: `Revert to checkpoint <slug>`
+7. Responder no chat: quais campos foram restaurados, quais permaneceram intactos, e próximo passo sugerido baseado no STATE restaurado.
+</process_revert>
+
+<process_default>
+## Sem subcomando
+
+- Se houver sessão ativa: executar `status`
+- Se não houver sessão ativa: executar `list`
+</process_default>
+
+<success_criteria>
+- [ ] `.oxe/sessions/sNNN-slug/` é o path da sessão criado/consultado.
+- [ ] `active_session` guarda o path relativo completo no `STATE.md` global.
+- [ ] `.oxe/SESSIONS.md` usa as colunas mínimas `ID | Nome | Status | Criada | Última atividade | Resumo | Path`.
+- [ ] `close` arquiva sem apagar artefatos.
+- [ ] `migrate` move só artefatos session-scoped e preserva os globais.
+- [ ] `fork` cria sessão nova com cópia dos artefatos sem modificar a sessão de origem.
+- [ ] `fork` registra `forked_from` na SESSION.md da sessão derivada.
+- [ ] `revert` restaura STATE.md a partir do snapshot do checkpoint, sem apagar campos ausentes.
+</success_criteria>