oxe-cc 1.0.0 → 1.3.0

package/oxe/workflows/session.md

@@ -1,197 +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:
-- `new <nome>`
-- `list`
-- `switch <id-ou-nome>`
-- `resume <id-ou-nome>`
-- `status`
-- `close`
-- `migrate <nome>`
-- `fork [nome-opcional]`
-- `revert <checkpoint-slug>`
-</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>

package/oxe/workflows/ship.md

@@ -0,0 +1,142 @@
+# OXE — Workflow: ship (entrega / commit)
+
+<objective>
+Criar um commit local a partir do trabalho verificado — gerando a mensagem de commit a partir de `SPEC.md`, `PLAN.md` e `VERIFY.md` e chamando `git commit`.
+
+Fecha o ciclo de desenvolvimento com um commit limpo, rastreável e alinhado aos artefatos OXE.
+</objective>
+
+<flags>
+- `--message "mensagem"` — sobrescreve a mensagem de commit gerada automaticamente.
+- `--amend` — usa `git commit --amend` em vez de criar um commit novo.
+- `--verify-first` — rodar `/oxe-verify` antes de criar o PR se VERIFY ainda não passou.
+- `--no-checks` — pular checagem de verify (commitar mesmo sem verify completo — gera aviso).
+- `--dry-run` — mostrar a mensagem de commit e o comando `git commit` sem commitar.
+</flags>
+
+<context>
+- Ship requer que `VERIFY.md` exista e indique aprovação, OU que o usuário confirme explicitamente com `--no-checks`.
+- A mensagem de commit é gerada a partir dos artefatos OXE — não a partir do histórico git cru.
+- Salvar o rascunho da mensagem em `.oxe/commit-draft.md`.
+- Salvar referência do commit em `.oxe/commit-record.json` após commitar.
+- Se houver alterações não relacionadas no worktree, pausar e pedir confirmação antes de stagear tudo.
+</context>
+
+<process>
+
+### Step 1 — Pré-voo
+
+1. Ler `.oxe/STATE.md` e sessão ativa (se houver).
+2. Verificar branch atual: `git branch --show-current`.
+3. Verificar status do verify:
+   - Existe `VERIFY.md` e está aprovado? → continuar.
+   - Existe `VERIFY.md` mas tem falhas? → avisar. Se `--no-checks`, continuar. Se não, sugerir `/oxe-verify` primeiro.
+   - Não existe `VERIFY.md`? → se `--verify-first`, executar `oxe/workflows/verify.md` antes de continuar. Caso contrário: bloquear a entrega e orientar `/oxe-verify` ou `--no-checks`.
+
+4. Verificar worktree (`git status --short`):
+   - Se não houver mudanças staged ou unstaged: informar que não há nada para commitar e encerrar.
+   - Se houver mudanças fora do escopo planejado: avisar e pedir confirmação antes de prosseguir.
+
+### Step 2 — Gerar mensagem de commit
+
+Ler os artefatos disponíveis nesta ordem de prioridade:
+1. `SPEC.md` (ou `QUICK.md` se for quick task) → objetivo / resumo curto
+2. `PLAN.md` → tarefas concluídas / ondas fechadas
+3. `VERIFY.md` → checks passados, evidências, riscos residuais
+4. `CONCERNS.md` ou `SUMMARY.md` → notas adicionais se houver
+
+Template da mensagem:
+```markdown
+feat: <descrição concisa em <= 72 chars>
+
+<Resumo de 1-2 parágrafos derivado de SPEC/QUICK e PLAN>
+
+Validation:
+- <check 1>
+- <check 2>
+
+---
+OXE: spec-driven workflow
+```
+
+Gerar também uma variante `fix:` ou `refactor:` quando os artefatos indicarem esse tipo de mudança. Se `--message` existir, usá-la como título e manter o corpo gerado abaixo.
+
+Salvar a mensagem em `.oxe/commit-draft.md`.
+
+### Step 3 — Stage e commit
+
+1. Fazer stage explícito:
+   - padrão: `git add -A`
+   - se houver arquivos claramente fora do escopo, parar e confirmar antes
+2. Executar:
+   - commit novo:
+     ```bash
+     git commit -F .oxe/commit-draft.md
+     ```
+   - amend:
+     ```bash
+     git commit --amend -F .oxe/commit-draft.md
+     ```
+
+Salvar em `.oxe/commit-record.json`:
+```json
+{
+  "commit_sha": "<sha>",
+  "subject": "...",
+  "amend": false,
+  "committed_at": "ISO",
+  "branch": "...",
+  "verify_status": "passed|skipped|failed_with_override"
+}
+```
+
+Se `git commit` falhar por hooks, conflitos ou falta de stage válido:
+- registrar o erro
+- não apagar `.oxe/commit-draft.md`
+- reportar o bloqueio com o comando falhado
+
+### Step 4 — Saída final
+
+**Sucesso:**
+```
+✓ Commit criado: [sha-curto]
+Branch: [current]
+Mensagem: [subject]
+Próximo: push manual, revisão de diff ou /oxe-session milestone (se for a última feature do ciclo)
+```
+
+**Dry-run:**
+```
+[dry-run] Commit não criado. Mensagem gerada em .oxe/commit-draft.md
+Comando para commitar: git commit -F .oxe/commit-draft.md
+```
+
+**Falha / bloqueio:**
+```
+Commit não realizado. Rascunho mantido em .oxe/commit-draft.md
+Resolva o bloqueio (verify, stage, hook ou conflito) e rode /oxe-ship novamente.
+```
+</process>
+
+<message_generation>
+## Geração automática da mensagem
+
+O subject é gerado a partir de `SPEC.md` (primeira linha de objetivo) ou de `QUICK.md` (primeira tarefa):
+
+Formato padrão: `feat: [descrição concisa da feature em ≤ 72 chars]`
+
+Exemplos:
+- `feat: add OAuth2 login with Google provider`
+- `fix: resolve race condition in payment processor`
+- `refactor: extract auth middleware to standalone module`
+
+Se houver ticket/issue referenciado na SPEC: `feat(AUTH-123): add OAuth2 login`
+</message_generation>
+
+<success_criteria>
+- [ ] Commit criado (ou dry-run mostrou a mensagem e o comando).
+- [ ] `.oxe/commit-record.json` atualizado com SHA e subject.
+- [ ] Mensagem de commit inclui resumo derivado de SPEC/QUICK, mudanças de PLAN e validação de VERIFY.
+- [ ] Se VERIFY não passou: só continuou com `--no-checks`, com aviso explícito.
+- [ ] Sugeriu próximo passo (push, revisão de diff ou milestone).
+</success_criteria>