chore: bump to v3.2.0, rewrite README, update CHANGELOG

[flyingrobots]

Summary

• Bump version 3.1.0 → 3.2.0 (M10 LENS is a minor feature addition)
• Complete README rewrite: lens/view section, full command coverage, import YAML format, commit directives, multi-repo federation, AI curation, JSON scripting, corrected version
• CHANGELOG [3.2.0] entry documenting all M10 LENS additions and PR feat: M10 LENS — composable view projections #250 fixes
• GitHub repo description updated

Problem Statement

README was written before M1 and hadn't been updated since. It referenced v2.0.0-alpha.0, omitted 10 of 17 commands, and made no mention of views, lenses, AI curation, time-travel, or multi-repo federation — all of which have shipped. Version in package.json was at 3.1.0 with no changelog entry for M10.

ADR Compliance (Required)

• This PR is fully compliant with all checked ADRs.

Architecture Laws Checklist (Hard Gates)

• Graph remains canonical truth (no dual truth with generated files).
• No hidden worktree coupling introduced in core/domain/materialization paths.
• Context-sensitive behavior is explicit (--at, --observer, --trust) or deterministically defaulted.
• Resolved context is surfaced in output metadata where applicable.
• Pure query/materialization paths remain deterministic for identical inputs.
• Mutations/materializations include provenance receipts/envelopes where required.
• No forbidden generated artifact paths are tracked.
• Machine-facing outputs are schema-versioned.

Scope Control

Docs and version bump only. No logic changes.

Backward Compatibility

N/A — documentation and version metadata only.

Test Plan (Required)

Unit

• Added/updated tests for changed logic

No logic changes; existing 461 tests cover all code paths.

Integration

• Added/updated integration tests

N/A.

Determinism

• Determinism assertions included for relevant paths

N/A.

Contract/Schema

• Schema validation updated/passing

No schema changes.

Policy Gates

• Mechanical architecture gates pass

scripts/review-checklist.sh

---

Security / Trust Impact

• Threat surface changed?: No
• Trust policy impact: None
• Provenance/audit impact: None
• New failure modes introduced: None

Performance Impact

• Hot path affected?: No
• Expected impact (latency/memory/io): None
• Benchmarks or profiling evidence: N/A

Observability / Debuggability

• Errors are actionable and include context.
• Logs/diagnostics added or updated where needed.
• git mind status / diagnostics updated if writeback/eventing behavior changed.

Operational Notes

• Feature flag (if any): None
• Rollback strategy: Revert commit
• Operational caveats: None

Linked Issues / Milestones

• Closes feat: M10 LENS — composable view projections #250
• Milestone: M10

---

Reviewer Quick Verdict Block (for maintainers)

MUST (Hard Gates)

• PASS

SHOULD (Quality)

• PASS

Verdict

• APPROVE

[coderabbitai]

📝 Walkthrough

Walkthrough

The pull request updates the package version from 3.1.0 to 3.2.0 in package.json, indicating a minor version release. No changes to runtime logic, control flow, exports, or error handling are present.

Changes

Cohort / File(s)	Summary
Version Bump package.json	Updated package version from 3.1.0 to 3.2.0.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 A version blooms, from one point one to two,
The rabbit hops higher, as new features grew!
A minor bump forward, so simple and clean,
The finest of updates you've ever seen. ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately reflects the main changes: version bump to v3.2.0, README rewrite, and CHANGELOG update. It is concise and specific, clearly summarizing the three primary objectives of the PR.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	The PR description comprehensively follows the template structure with all major sections completed, including summary, problem statement, ADR compliance, architecture laws checklist, backward compatibility, test plan, security/trust impact, and operational notes.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch chore/meta

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}