From 588e3fb06e3130045e635b024716b89d1cd93c1e Mon Sep 17 00:00:00 2001 From: "Anaz S. Aji" Date: Thu, 11 Jun 2026 09:01:29 +0700 Subject: [PATCH] =?UTF-8?q?docs:=20final=20sync=20for=20v0.5.0=20=E2=80=94?= =?UTF-8?q?=20Uteke=20memory=20integration?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds Uteke memory integration (#232) docs across all files: - CHANGELOG.md + docs/changelog.md: added to [0.5.0] Added - docs/roadmap.md: #232 Done - README.md: --memory and --learn in commands table - docs/cli-reference.md: new review flags - docs/configuration.md: Uteke Memory Integration section - AGENT.md: test count 495→506, memory.rs in structure - .agent.md: test count 495→506 --- .agent.md | 2 +- AGENT.md | 9 +++++---- CHANGELOG.md | 5 +++++ README.md | 2 ++ docs/changelog.md | 5 +++++ docs/cli-reference.md | 2 ++ docs/configuration.md | 24 ++++++++++++++++++++++++ docs/roadmap.md | 1 + 8 files changed, 45 insertions(+), 5 deletions(-) diff --git a/.agent.md b/.agent.md index 1537a48b..4e8efa96 100644 --- a/.agent.md +++ b/.agent.md @@ -8,7 +8,7 @@ Before creating any release PR, verify ALL of the following are updated: - [ ] `Cargo.toml` — version bump - [ ] All target issues merged to `develop` -- [ ] `cargo test` — all 495+ tests pass +- [ ] `cargo test` — all 506+ tests pass - [ ] `cargo clippy --all-targets -- -D warnings` — clean - [ ] `cargo fmt --all -- --check` — clean - [ ] `cargo build --release` — no errors diff --git a/AGENT.md b/AGENT.md index b4b246bc..f083afe4 100644 --- a/AGENT.md +++ b/AGENT.md @@ -17,7 +17,7 @@ no managed API, no cloud service. Runs locally against diffs, scans, or branches ```bash cargo build # Build (debug) cargo build --release # Build (release) -cargo test # Run all 495 tests +cargo test # Run all 506 tests cargo clippy --all-targets -- -D warnings # Lint (strict) cargo fmt --all -- --check # Format check ``` @@ -62,6 +62,7 @@ src/ │ ├── language_analyzer.rs # Language-specific review guidance │ ├── secrets_scanner.rs # Secret/credential detection │ ├── debt_tracker.rs # Tech debt metrics + history snapshots +│ ├── memory.rs # Uteke memory integration (recall + learn) │ └── rules/ # Custom rule engine │ ├── mod.rs │ ├── builtin.rs # Built-in rules @@ -100,8 +101,8 @@ src/ ## Testing ```bash -cargo test # 495 tests total - # 473 unit tests +cargo test # 506 tests total + # 484 unit tests # 16 CLI integration tests # 6 config tests cargo test --no-verify # Skip pre-commit hooks (avoids timeout in hooks) @@ -232,7 +233,7 @@ Missing any = release blocker. ### 1. Code - [ ] All target issues merged to `develop` -- [ ] `cargo test` — all 495+ tests pass +- [ ] `cargo test` — all 506+ tests pass - [ ] `cargo clippy --all-targets -- -D warnings` — clean - [ ] `cargo fmt --all -- --check` — clean - [ ] `cargo build --release` — no errors diff --git a/CHANGELOG.md b/CHANGELOG.md index b4658545..95c26f4a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -43,6 +43,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Auto-save after every review (best-effort, never fails review) - `debt:` config section in `.cora.yaml` (history_dir, retention_days) - 32 unit tests +- **Uteke memory integration** — recall project patterns and learn from reviews (#232) + - `--memory` flag — recall context from Uteke before review + - `--learn` flag — recall + save findings after review + - `MemoryBackend` with auto-detect, graceful degradation when Uteke not installed + - 11 unit tests - **Multi-platform CI docs** — Gitea/Forgejo, GitLab CI, Bitbucket Pipelines workflow examples (#225) - **GitHub Marketplace action** — published as [`codecoradev/cora-review-action@v1`](https://github.com/marketplace/actions/cora-ai-code-review) - **Improved review prompt** — better consistency, lower false-negative rate, explicit error handling focus area diff --git a/README.md b/README.md index 25d25b91..d41570e3 100644 --- a/README.md +++ b/README.md @@ -138,6 +138,8 @@ Works on **all CI platforms** — [Gitea, GitLab, Bitbucket →](https://codecor | `cora config show` | Show resolved config | | `cora providers` | List available LLM providers | | `cora debt` | Show tech debt report from review history | +| `cora review --memory` | Recall project patterns from Uteke before review | +| `cora review --learn` | Recall + save findings to Uteke | | `cora mcp` | Start MCP server for AI coding agents | | `cora hook install` | Install pre-commit hook | diff --git a/docs/changelog.md b/docs/changelog.md index b4658545..95c26f4a 100644 --- a/docs/changelog.md +++ b/docs/changelog.md @@ -43,6 +43,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Auto-save after every review (best-effort, never fails review) - `debt:` config section in `.cora.yaml` (history_dir, retention_days) - 32 unit tests +- **Uteke memory integration** — recall project patterns and learn from reviews (#232) + - `--memory` flag — recall context from Uteke before review + - `--learn` flag — recall + save findings after review + - `MemoryBackend` with auto-detect, graceful degradation when Uteke not installed + - 11 unit tests - **Multi-platform CI docs** — Gitea/Forgejo, GitLab CI, Bitbucket Pipelines workflow examples (#225) - **GitHub Marketplace action** — published as [`codecoradev/cora-review-action@v1`](https://github.com/marketplace/actions/cora-ai-code-review) - **Improved review prompt** — better consistency, lower false-negative rate, explicit error handling focus area diff --git a/docs/cli-reference.md b/docs/cli-reference.md index 5a5264d2..d62f7926 100644 --- a/docs/cli-reference.md +++ b/docs/cli-reference.md @@ -26,6 +26,8 @@ Complete command reference for the cora CLI. | `cora init` | Create `.cora.yaml` config file | | `cora review` | Review code changes (default: staged files) | | `cora review --staged` | Review staged git changes explicitly | +| `cora review --memory` | Recall project patterns from Uteke before review | +| `cora review --learn` | Recall + save findings to Uteke (implies --memory) | | `cora review --unstaged` | Review unstaged working changes | | `cora review --unpushed` | Review unpushed commits | | `cora review --base` `` | Compare current branch against target | diff --git a/docs/configuration.md b/docs/configuration.md index d856b760..6632ca4b 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -374,6 +374,30 @@ cora debt --branch develop # Filter by branch Snapshots are auto-saved after every review (best-effort, never fails the review). +## Uteke Memory Integration + +cora can optionally integrate with [Uteke](https://github.com/codecoradev/uteke) — a local-first memory engine for AI agents. + +### Prerequisites + +Install Uteke: `curl -fsSL https://raw.githubusercontent.com/codecoradev/uteke/main/install.sh | sh` + +### Usage + +```bash +cora review # Standalone review (default, no memory) +cora review --memory # Recall project patterns before review +cora review --memory --learn # Recall + save findings after review +``` + +### How It Works + +1. **`--memory`**: Cora calls `uteke recall` to fetch project-specific patterns from previous reviews, enriching the LLM prompt with historical context. + +2. **`--learn`**: After review, Cora calls `uteke remember` to save findings, patterns, and stats for future recall. + +3. **Graceful degradation**: If Uteke is not installed, Cora warns and continues without memory. Reviews never fail due to memory issues. + ## MCP Server cora includes a built-in MCP (Model Context Protocol) server that exposes rules and config to AI coding agents like Claude Code, Cursor, Copilot, and Windsurf. diff --git a/docs/roadmap.md b/docs/roadmap.md index 72e5dafc..e0985485 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -72,6 +72,7 @@ Demand-gated — we build what people actually need. Track progress on [GitHub I - [#238](https://github.com/codecoradev/cora-cli/issues/238) Quality profiles bug fix — path resolution, fail-fast, dedup — ✓ Done - [#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 ## v0.6 — Growth & Marketplace