docs: pre-release sync — cora commit across all docs

.gitignore

@@ -43,3 +43,4 @@ coverage/
 dist/
 *.tar.gz
 *.zip
+.cora/history/

AGENT.md

@@ -234,7 +234,7 @@ Missing any = release blocker.
 ### 1. Code
 
 - [ ] All target issues merged to `develop`
-- [ ] `cargo test` — all 506+ tests pass
+- [ ] `cargo test` — all 517+ tests pass
 - [ ] `cargo clippy --all-targets -- -D warnings` — clean
 - [ ] `cargo fmt --all -- --check` — clean
 - [ ] `cargo build --release` — no errors

docs/changelog.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **`cora commit`** — review staged diff + generate commit message + commit (#262)
+  - HITL mode (default): interactive `[Y]es / [E]dit / [N]o` prompt
+  - YOLO mode (`--yolo`): auto-commit without prompts
+  - `--force`: commit even if quality gate fails
+  - `--no-review`: skip review, only generate commit message
+  - `--edit`: always open `$EDITOR`
+  - Conventional commit format (feat/fix/refactor/perf/docs/test/chore/style/build/ci)
+  - Auto-truncates subjects to 72 chars
+  - Quality gate integration (block on FAIL unless `--force`)
+  - Debt snapshot saved after commit
+  - `chat_completion_raw()` + `chat_completion_stream_raw()` in `engine/llm.rs`
+  - 22 unit tests
+
 ## [0.5.0] - 2026-06-10
 
 ### Added

docs/examples.md

@@ -50,6 +50,43 @@ Stream results as they come in from the LLM.
 $ cora review --staged --stream
 ```
 
+## 06 — Auto-Commit (Review + Message + Commit)
+
+Review staged changes, generate a conventional commit message, and commit in one step.
+
+### HITL mode (default — interactive prompt)
+
+```bash
+$ git add -A
+$ cora commit
+🔍 Reviewing staged changes (3 files, 247 lines)...
+✅ No issues found (quality score: 9.2/10)
+
+📝 Generated commit message:
+  feat(auth): add session expiry validation
+
+Accept commit message? [Y]es / [E]dit / [N]o › y
+✅ Committed: feat(auth): add session expiry validation
+```
+
+### YOLO mode (CI / trusted workflows)
+
+```bash
+$ cora commit --yolo
+```
+
+### Skip review (message only)
+
+```bash
+$ cora commit --no-review
+```
+
+### Force commit past quality gate
+
+```bash
+$ cora commit --force
+```
+
 ## 06 — GitHub Actions CI (Recommended)
 
 The easiest way to add cora to your PR workflow. This reusable action installs cora, runs the review, posts a PR comment with findings, and optionally uploads SARIF to GitHub Code Scanning.

docs/getting-started.md

@@ -135,6 +135,21 @@ Now that you have cora running, explore these topics to get the most out of it:
 - [CLI Reference](./cli-reference) — full command documentation
 - [Examples](./examples) — CI/CD setup for GitHub, GitLab, Gitea, Bitbucket
 
+### Daily Workflow
+
+Once set up, your daily workflow becomes:
+
+```bash
+git add -A
+cora commit          # review + generate commit message + commit
+```
+
+Or skip the prompt in CI/trusted workflows:
+
+```bash
+cora commit --yolo    # auto-commit, no prompts
+```
+
 ## AI Agent Integration
 
 cora includes a built-in MCP server for AI coding agents. After installation:

docs/roadmap.md

@@ -73,6 +73,7 @@ Demand-gated — we build what people actually need. Track progress on [GitHub I
 - [#188](https://github.com/codecoradev/cora-cli/issues/188) Auto-chunking for large diffs — ✓ Done
 - [#206](https://github.com/codecoradev/cora-cli/issues/206) Tech debt metrics — review history — ✓ Done
 - [#232](https://github.com/codecoradev/cora-cli/issues/232) Uteke memory integration — recall + learn — ✓ Done
+- [#262](https://github.com/codecoradev/cora-cli/issues/262) `cora commit` — review + auto commit message + quality gate — ✓ Done
 
 ## v0.6 — Growth & Marketplace