codymaster 4.8.0 → 7.0.0

package/CHANGELOG.md

@@ -4,6 +4,331 @@ All notable changes to this project will be documented in this file.
 
 Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 
+---
+
+## [7.0.0] - 2026-05-11
+
+### 🚀 Improvements — Browse Hybrid Bridge
+
+Major browser automation upgrade. Combines agent-browser (Rust/CDP) with Playwright via adapter pattern for AI-native browser control, a11y snapshots, structured error collection, and video recording.
+
+**Browse Hybrid Bridge:**
+- New `src/browse/adapters/types.ts` — BrowserAdapter interface + types (A11ySnapshot, BrowserError, EngineInfo)
+- New `src/browse/adapters/playwright-adapter.ts` — Playwright implementation with a11y tree support
+- New `src/browse/adapters/agent-browser-adapter.ts` — agent-browser CLI wrapper (Rust/CDP)
+- New `src/browse/adapter-factory.ts` — Auto-detect engine + fallback chain (agent-browser → Playwright)
+- New `src/browse/error-collector.ts` — Structured error classification (js-error, network-fail, console-error, crash, timeout)
+- New `src/browse/event-log.ts` — Upgraded ring buffer with filtering, export, 1000 max entries
+- New `src/browse/index.ts` — Barrel export for browse module
+
+**Refactored BrowseDaemon:**
+- Refactored `src/browse-server.ts` — Adapter pattern, new endpoints, backward compatible
+- New endpoints: `GET /errors`, `GET /a11y-snapshot`, `GET /engine`, `GET /events`, `POST /record/start`, `POST /record/stop`
+- EventLog replaces RingBuffer for structured event tracking
+
+**New CLI Commands:**
+- `cm browse start --engine <auto|agent-browser|playwright>` — Engine selection
+- `cm browse doctor` — Check engine availability
+- `cm browse errors [--type <t>] [--severity <s>]` — List collected errors
+- `cm browse snapshot` — A11y tree with `@eN` refs
+- `cm browse engine` — Current engine info + capabilities
+- `cm browse record start|stop` — Video recording control
+
+**Skill Integration:**
+- Updated `cm-browse` SKILL.md — Hybrid Bridge documentation
+- Updated `cm-skill-index` — Added cm-browse to Engineering Swarm
+- Updated `cm-quality-gate` — Added cm-browse integration
+- Updated `cm-debugging` — Added cm-browse for error collection
+- Updated `cm-safe-deploy` — Added cm-browse for post-deploy smoke
+- Updated `cm-mcp-engineering` — Updated cm_qa tool description
+- Updated `AGENTS.md` — Added browse module to Authority table
+
+**Files Created:**
+- `src/browse/adapters/types.ts`
+- `src/browse/adapters/playwright-adapter.ts`
+- `src/browse/adapters/agent-browser-adapter.ts`
+- `src/browse/adapter-factory.ts`
+- `src/browse/error-collector.ts`
+- `src/browse/event-log.ts`
+- `src/browse/index.ts`
+
+**Files Modified:**
+- `src/browse-server.ts` — Adapter pattern refactor
+- `src/cli/commands/engineering.ts` — New browse commands + --engine flag
+
+---
+
+## [6.1.0] - 2026-05-11
+
+### 🚀 Improvements — Workflow Pipeline Fix + Unified CLI
+
+Fix broken skill pipeline across all 14 AI coding platforms. Restore seamless start → brainstorm → planning → execution → QA → deploy workflow. Add unified CLI commands for easier management.
+
+**Multi-Platform Skill Sync:**
+- Updated `scripts/build-skills.mjs` to sync ALL 50 `cm-*` skills + `_shared/` to ALL 14 platforms
+- Platforms: Claude Code, Claude Desktop, Cursor, Windsurf, Antigravity, Codex, OpenCode, Cline, Kiro, Copilot, Aider, Continue, Amazon Q, Amp
+- Added `npm run sync:all` command for one-click sync
+- `_shared/helpers.md` now accessible from all platforms
+
+**TDD Enforcement Gate:**
+- New `src/execution/tdd-gate.ts` — blocks execution without tests
+- Enforces RED phase: test must fail before implementation
+- Added `test/tdd-gate.test.ts` — 10 tests pass
+- Updated `cm-execution` and `cm-tdd` SKILL.md with enforcement docs
+
+**Changelog Automation:**
+- New `scripts/update-changelog.sh` — auto-update from git commits
+- Follows conventional commits format (feat, fix, security, improve)
+- Added `npm run changelog` and `npm run changelog:dry` commands
+
+**Gemini CLI Integration:**
+- New `src/cli/commands/parallel.ts` — `cm parallel` command
+- Execute tasks in parallel using Gemini CLI
+- Supports `--count`, `--context`, `--model` options
+- Graceful fallback when Gemini CLI not installed
+
+**Unified CLI Commands:**
+- New `cm update` — unified update command
+  - `cm update --sync` — sync skills to all platforms
+  - `cm update --changelog` — update changelog
+  - `cm update --check` — check for available updates
+  - `cm update --full` — full update (sync + changelog)
+- New `cm upgrade` — upgrade CodyMaster package + sync
+- Enhanced `cm install --sync` — auto-sync after install
+- Enhanced `cm doctor --sync-check` — check sync status
+- Added npm scripts: `update`, `update:sync`, `update:changelog`, `upgrade`
+
+**Files Created:**
+- `src/execution/tdd-gate.ts`
+- `test/tdd-gate.test.ts`
+- `scripts/update-changelog.sh`
+- `src/cli/commands/parallel.ts`
+- `src/cli/commands/update.ts`
+
+**Files Modified:**
+- `scripts/build-skills.mjs` — 14 platforms + _shared/ sync
+- `src/cli/command-registry.ts` — Register parallel + update commands
+- `src/cli/commands/install.ts` — Add --sync flag, enhance doctor
+- `package.json` — Add sync:all, changelog, update, upgrade scripts
+- `.opencode/skills/cm-execution/SKILL.md` — Document TDD gate
+- `.opencode/skills/cm-tdd/SKILL.md` — Reference TDD gate
+
+**Test Results:** 49 files, 406 tests pass
+
+---
+
+## [6.0.0] - 2026-05-10
+
+### 🚀 Major Release — "The Disciplined Brain"
+
+Đây là bản nâng cấp lớn nhất kể từ v4.5. Ba trụ cột thay đổi chính: **kỷ luật hành vi AI** (Karpathy Principles), **hạ tầng Dashboard Managed Agents** hoàn toàn mới, và **chuẩn hóa tài liệu toàn diện**.
+
+---
+
+### 🧘 Karpathy Behavioral Discipline — Nhúng kỷ luật vào từng kỹ năng
+
+Lấy cảm hứng từ [quan sát của Andrej Karpathy](https://x.com/karpathy/status/2015883857489522876) về các lỗi phổ biến khi LLM viết code, CodyMaster nhúng 4 quy tắc hành vi cứng trực tiếp vào 6 kỹ năng cốt lõi — AI tự có kỷ luật mà không cần nhắc nhở.
+
+**4 quy tắc Karpathy được thực thi:**
+
+| Quy tắc | Kỹ năng thực thi |
+|---------|-----------------|
+| **Think Before Coding** — nêu giả định, làm rõ mơ hồ, phản biện trước khi viết | `cm-planning` |
+| **Simplicity First** — code tối thiểu, không trừu tượng hóa suy đoán | `cm-clean-code`, `cm-tdd` |
+| **Surgical Changes** — mọi dòng sửa đều có lý do rõ ràng từ task | `cm-execution`, `cm-code-review` |
+| **Goal-Driven Execution** — tiêu chí thành công có thể xác minh trước khi code | `cm-tdd`, `cm-quality-gate` |
+
+**Files cập nhật:**
+- `skills/cm-planning/SKILL.md` — thêm "Think Before Coding" gate ở bước đầu
+- `skills/cm-tdd/SKILL.md` — nhúng "Simplicity First" + "Goal-Driven" vào quy trình viết test
+- `skills/cm-clean-code/SKILL.md` — thêm "Simplicity First" audit checklist
+- `skills/cm-execution/SKILL.md` — nhúng "Surgical Changes" trước mọi thao tác sửa file
+- `skills/cm-code-review/SKILL.md` — thêm Karpathy Review Layer vào checklist
+- `skills/cm-quality-gate/SKILL.md` — thêm "Goal-Driven" verification gate
+- `AGENTS.md` — ghi rõ 4 nguyên tắc Karpathy làm behavioral contract toàn dự án
+
+---
+
+### 🏗️ Dashboard Managed Agents — Hạ tầng hoàn toàn mới
+
+Nâng cấp kiến trúc toàn diện cho `cm-dashboard`, tách biệt rõ ràng các lớp: Agent, Storage, Realtime.
+
+**Modules mới (`src/`):**
+
+- **`src/agent/`** — Lớp quản lý agent
+  - `backend.ts` — Agent backend abstraction layer
+  - `claude.ts` — Claude Code agent integration
+  - `codex.ts` — OpenAI Codex agent integration
+  - `spawn-helper.ts` — Cross-platform agent process spawner
+
+- **`src/realtime/`** — Lớp realtime
+  - `event-bus.ts` — In-process typed event bus cho agent lifecycle events
+  - `ws-hub.ts` — WebSocket hub để push live updates lên Dashboard UI
+
+- **`src/storage/`** — Lớp lưu trữ chuẩn hóa
+  - `sqlite.ts` — SQLite connection factory + WAL mode
+  - `index.ts` — Unified storage API
+  - `repos/activity-repo.ts` — Activity log CRUD
+  - `repos/message-repo.ts` — Agent message thread storage
+  - `repos/project-repo.ts` — Project metadata repository
+  - `repos/task-repo.ts` — Task lifecycle repository
+  - `services/project-service.ts` — Project business logic
+  - `services/task-service.ts` — Task state machine
+  - `migrations/001_init.sql` — Schema khởi tạo toàn bộ bảng
+
+- **`src/dashboard.ts`**, **`src/data.ts`** — Cập nhật để consume lớp storage mới
+- **`src/cli/commands/dashboard.ts`** — Wired up managed agent lifecycle
+- **`dist/`** — Toàn bộ dist artifact rebuild tương ứng
+
+**OpenSpec kèm theo:**
+- `openspec/changes/upgrade-cm-dashboard-to-managed-agents/design.md`
+- `openspec/changes/upgrade-cm-dashboard-to-managed-agents/specs/dashboard/spec.md`
+- `openspec/changes/upgrade-cm-dashboard-to-managed-agents/tasks.md`
+
+**Test:**
+- `test/dashboard.test.ts` — Test suite đầy đủ cho dashboard managed agents
+
+---
+
+### 📦 Extracted Plugins — Content Factory & Growth Marketing
+
+Tách 2 plugin lớn thành các package độc lập với đầy đủ metadata và migration guide.
+
+**`extracted-plugins/content-factory/`:**
+- `.claude-plugin/marketplace.json` + `plugin.json`
+- `AGENTS.md` — Behavioral contract cho content agent
+- `MIGRATION.md` — Hướng dẫn upgrade từ inline skills
+- Skills: `auto-publisher`, `content-factory`, `notebooklm` (cập nhật đồng bộ)
+
+**`extracted-plugins/growth-marketing/`:**
+- `.claude-plugin/marketplace.json` + `plugin.json`
+- `AGENTS.md` — Behavioral contract cho growth agent
+- `MIGRATION.md` — Hướng dẫn upgrade từ inline skills
+- Skills: `ads-tracker`, `booking-calendar`, `cro-methodology`, `google-form`, `growth-hacking`, `jtbd`, `readit` (cập nhật đồng bộ)
+
+---
+
+### 🗂️ Unified Install Engine — npm-first, 14 nền tảng
+
+Wizard `cm` mới: phát hiện tự động mọi AI tool đang cài, multi-select platform, pick profile, cài một lần.
+
+```bash
+npm install -g codymaster && cm
+```
+
+**CLI mới:**
+```
+cm install <platform>            # cài hoặc refresh một nền tảng
+cm install --all --profile core  # cài vào mọi nền tảng phát hiện được
+cm doctor                        # kiểm tra trạng thái cài đặt
+cm install --list                # liệt kê tất cả platform id
+```
+
+**14 nền tảng hỗ trợ:** Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Aider, Continue, Kiro, Amazon Q, Amp, Copilot, OpenCode, Codex, Antigravity/Gemini CLI.
+
+---
+
+### 📁 Archive & Research — Dọn dẹp repo
+
+- `Archive/` — Di chuyển tất cả file legacy/deprecated vào đây thay vì xóa:
+  - `deprecated-docs/translations/` — Các README ngôn ngữ cũ (hi, ko, ru, zh)
+  - `experiments/gemini/` — Gemini extension thử nghiệm
+  - `legacy-agent-system/` — cm-video-factory, xss-html-injection skills cũ
+  - `legacy-editors/` — codex + opencode INSTALL.md cũ
+  - `legacy-plugins/cursor-plugin/` — cursor plugin cũ
+- `research/` — Tài liệu nghiên cứu nội bộ (`multica.md`, `rtk.md`)
+- `MIGRATION.md` — Hướng dẫn migration tổng thể từ v5.x → v6.0
+
+---
+
+### 📚 Documentation & README — Chuẩn hóa toàn diện
+
+**README.md (English):**
+- Phiên bản v6.0.0
+- Thêm phần **Karpathy Behavioral Discipline** với bảng 4 quy tắc
+- Cập nhật install section: unified `npm install -g codymaster && cm`
+- Cập nhật bảng so sánh, skill arsenal, và CLI commands
+- **Xóa 4 ngôn ngữ thừa** (zh, ru, ko, hi) — chỉ giữ EN + VI
+- Language bar: `[English](README.md) | [Tiếng Việt](README-vi.md)`
+
+**README-vi.md (Vietnamese):**
+- Viết lại hoàn toàn từ đầu, đồng bộ 100% với README.md EN v6.0.0
+- Thêm phần Karpathy, unified install wizard, Growth Hacking Engine
+- Cập nhật version badge → v6.0.0
+- Bảng so sánh cập nhật: "npm i -g codymaster" thay vì "git pull"
+- Cập nhật `.opencode/skills/cm-dashboard/SKILL.md`
+
+---
+
+### 🔧 Skill Profiles
+
+- `skills/profiles/design.txt` — Cập nhật danh sách kỹ năng
+- `skills/profiles/full.txt` — Thêm kỹ năng mới từ extracted plugins
+- `skills/profiles/growth.txt` — Đồng bộ với growth-marketing plugin
+- `skills/profiles/knowledge.txt` — Cập nhật knowledge pack
+- `skills/profiles/top35.json` — Cập nhật metadata và scoring
+
+---
+
+### 📦 Package
+
+- `package.json` — Bump version + dependency updates
+- `package-lock.json` — Lock file cập nhật
+- `.claude-plugin/marketplace.json` + `plugin.json` — Metadata plugin cập nhật
+- `.claude/settings.local.json` — Cập nhật local settings
+- `skills/cm-autopilot/scripts/autopilot.py` — Minor fixes
+
+---
+
+## [Unreleased]
+
+### 🚀 Improvements — Zero-Token Skill Discovery
+- Removed LLM token waste on skill search by porting deterministic tech-stack parsing natively into `src/indexer/skills.ts`.
+- Introduced `cm index skills` CLI command to compile `.cm/project-skills.md` locally.
+- Updated Fission framework (`cm-project-bootstrap`, `cm-skill-index`, `AGENTS.md`) to prioritize zero-token local indexes over massive community directory sweeps.
+
+### 🚀 Improvements — CodyMaster v6.0 "Self-Evolving Brain"
+
+- **Smart Brain Router** — `src/smart-brain-router.ts` adds a zero-cost keyword-based classifier that dynamically selects the optimal memory tiers for incoming tasks, reducing token waste by up to 60-80% for simple tasks.
+- **Skill Execution Cache** — `src/skill-execution-cache.ts` introduces an FTS5-backed warm cache for successful execution chains (effectiveness >= 0.70), skipping BM25 and LLM selection entirely for recurring task patterns.
+- **Per-Tier Adaptive Token Budgeting** — Enhanced `src/token-budget.ts` controls budgets natively per memory tier and visually outputs budget and savings reports.
+- **Evolution Engine (Skill Evolver)** — `src/skill-evolver.ts` brings true autonomy. CodyMaster now auto-repairs and auto-generates `SKILL.md` files locally with three modes: `FIX` (adds warnings to broken skills), `DERIVED` (clones highly successful fallback paths), and `CAPTURED` (creates new skills completely autonomously when a task completes without predefined skills). Ships with anti-loop protection and automatic `.md` backups.
+- **Learning Promoter** — `src/learning-promoter.ts` scans working memory for recurring failures or patterns (reinforced >= 3 times) and automatically promotes them into permanent `cm-learned-*` skills.
+- **New CLI Tools** — `cm smart plan/tiers`, `cm token report/savings`, and a full `cm evolve` lifecycle toolkit (`status`, `run`, `history`, `rollback`, `candidates`, `promote`).
+- **Comprehensive Testing** — Extensively covered the new architectures with 62 new testing scenarios (system currently sits at 302 passed tests natively).
+
+### 🚀 Improvements — OpenViking De-scope
+
+- Removed OpenViking auto-installation from `install.sh` and `scripts/postinstall.js`; CodyMaster now keeps the normal install path focused on the supported Node-first stack.
+- Updated runtime/config/docs guidance so `storage.backend: viking` is treated as a deprecated experimental path instead of a default-facing feature.
+- Removed the remaining OpenViking runtime backend, demo script, and dedicated tests; legacy `storage.backend: viking` configs now warn and fall back to SQLite.
+
+### 🚀 Improvements — Advisory Loop Productization
+
+- Added `cm advisory report`, `cm advisory metrics`, and `cm advisory handoff` so operators can inspect execution analyses, review per-skill quality, and generate structured recovery notes for `cm-skill-health` / `cm-skill-evolution`.
+- `selectTopSkills()` now uses recorded `skill_metrics` as a quality-weighted boost for optional step ranking, while mandatory `always` steps remain unchanged.
+- Added `src/advisory-handoff.ts` as the shared contract between analyzer output and self-healing workflows; the handoff can be emitted as Markdown or JSON.
+- Exposed the advisory loop to MCP clients via `cm_advisory_report`, `cm_advisory_metrics`, and `cm_advisory_handoff` in `src/mcp-context-server.ts`.
+- Added workflow and API docs for the advisory loop under `docs/workflows/advisory-loop.md` and `docs/api/api-reference.md`.
+
+## [5.1.0] - 2026-04-11
+
+### 🚀 Improvements — SkillsBench Intelligence + Ecosystem Reach
+
+- **Intelligent Skill Selection (`selectTopSkills`)** — `src/skill-chain.ts` now applies SkillsBench research findings at runtime. Each chain execution dynamically selects the top-3 most relevant skills for the current task (scored by BM25 token overlap + mandatory-step priority bonus). Result: 2-3 focused skills → **+18.6pp** improvement vs 4+ loaded statically (+5.9pp). Chains with >3 mandatory steps still execute fully with a performance advisory logged to stderr. New exported functions: `scoreStepRelevance()`, `selectTopSkills()`.
+
+- **`cm mcp-serve` command** — New `src/cli/commands/mcp-serve.ts` registers `cm mcp-serve [--project <path>] [--print-config]`. Spawns `dist/mcp-context-server.js` over stdio with SIGINT/SIGTERM forwarding. `--print-config` prints ready-to-paste JSON config for **Goose** and **Claude Desktop**, enabling one-command ecosystem integration. Goose extension config: `{ "type": "stdio", "cmd": "npx", "args": ["codymaster", "mcp-serve"] }`.
+
+- **CodyBench v0.1** — New `cm bench` command backed by `src/codybench/` scaffolding. Three eval suites with A/B comparison (with vs without CodyMaster): `tdd-regression` (bug catch rate), `token-efficiency` (savings vs documented 78% claim), `memory-retention` (SQLite recall hit rate). Runner: `claude-code`. Judge: automated (mean/min/max/stddev). Results written to `codybench/reports/`. Methodology mirrors Goose's transparent benchmark publication strategy.
+
+- **NLI Memory Interface (`cm_memory_write` + `cm_natural`)** — MCP server now exposes **15 tools** (up from 13). `cm_memory_write` persists a learning to SQLite with auto-detected category (arch_decision / bug_fix / user_pref / code_pattern / context), configurable scope (session/project/global), TTL, and importance. `cm_natural` is a natural language router: "remember that…" → write, "forget about…" → decay, "what did we learn about…" → FTS5 query. Zero new npm dependencies; pattern matching via regex.
+
+- **Goose integration guide** — `docs/integrations/goose.md` — step-by-step tutorial: install CodyMaster → `cm mcp-serve --print-config` → paste YAML config into Goose → test with `cm_natural`. Tool reference table included.
+
+- **GitHub community templates** — `.github/ISSUE_TEMPLATE/` now includes `good-first-skill.md` (with SkillsBench 12-point quality checklist), `benchmark-needed.md` (CodyBench eval request), `skill-improvement.md` (rubric-based improvement proposal).
+
+- **Version bump** — `package.json` version: `5.0.0` → `5.1.0`. CLI command count: 18 → 20 (`mcp-serve`, `bench`). MCP tool count: 13 → 15.
+
 ## [4.8.0] - 2026-04-10
 
 ### 🚀 Improvements — Documentation site & README accuracy
@@ -27,8 +352,8 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 
 ### 🚀 Improvements — OpenViking Backend (Real Implementation)
 
-- **`VikingBackend` — real implementation** — `src/backends/viking-backend.ts` implements all 11 `StorageBackend` methods by calling the [OpenViking REST API](https://github.com/volcengine/OpenViking) (default: `http://localhost:1933`). Replaces the placeholder stub from v4.5.5.
-- **`VikingHttpClient`** — New `src/backends/viking-http-client.ts`: thin fetch-based HTTP client wrapping OpenViking's `/write`, `/read`, `/ls`, `/search`, `/abstract`, `/overview`, `/health`, `/mkdir` endpoints. Zero new npm dependencies (uses Node.js built-in `fetch`).
+- `**VikingBackend` — real implementation** — `src/backends/viking-backend.ts` implements all 11 `StorageBackend` methods by calling the [OpenViking REST API](https://github.com/volcengine/OpenViking) (default: `http://localhost:1933`). Replaces the placeholder stub from v4.5.5.
+- `**VikingHttpClient`** — New `src/backends/viking-http-client.ts`: thin fetch-based HTTP client wrapping OpenViking's `/write`, `/read`, `/ls`, `/search`, `/abstract`, `/overview`, `/health`, `/mkdir` endpoints. Zero new npm dependencies (uses Node.js built-in `fetch`).
 - **URI layout in OpenViking workspace:** `learnings/<id>.json`, `decisions/<id>.json`, `indexes/<resource>/<level>.md`, `skill-outputs/<sessionId>/<id>.json`.
 - **Semantic vector search** — `queryLearnings()` and `queryDecisions()` now call OpenViking's `/search` endpoint, which uses embedding-based vector similarity. Finds related memories even when query terms don't match exactly (e.g. "async timeout" matches "network latency spike").
 - **Auto L0/L1 via engine** — `getL0Abstract()` and `getL1Overview()` call OpenViking's `/abstract` and `/overview` endpoints. No manual `cm continuity index` needed with Viking backend.
@@ -42,10 +367,10 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 
 ### 🚀 Improvements — StorageBackend Interface (OpenViking Swap Path)
 
-- **`StorageBackend` interface** — New `src/storage-backend.ts` defines an 11-method abstraction over CodyMaster's persistent memory store. Swapping storage engines is now a config change, not a code rewrite.
-- **`SqliteBackend`** — Thin wrapper around `context-db.ts`. Zero logic duplication; all existing callers untouched. New callers use `getBackend(projectPath)` for polymorphism.
-- **`VikingBackend` stub** — All methods throw a descriptive `NotImplementedError` with step-by-step install instructions for `@openviking/client`. Explicit swap path documented.
-- **`getBackend(projectPath)` factory** — Reads `.cm/config.yaml → storage.backend` (`sqlite` | `viking`). Defaults to `sqlite` when config is absent or malformed.
+- `**StorageBackend` interface** — New `src/storage-backend.ts` defines an 11-method abstraction over CodyMaster's persistent memory store. Swapping storage engines is now a config change, not a code rewrite.
+- `**SqliteBackend`** — Thin wrapper around `context-db.ts`. Zero logic duplication; all existing callers untouched. New callers use `getBackend(projectPath)` for polymorphism.
+- `**VikingBackend` stub** — All methods throw a descriptive `NotImplementedError` with step-by-step install instructions for `@openviking/client`. Explicit swap path documented.
+- `**getBackend(projectPath)` factory** — Reads `.cm/config.yaml → storage.backend` (`sqlite` | `viking`). Defaults to `sqlite` when config is absent or malformed.
 - **Config template updated** — `cm continuity init` now writes a `storage:` section to `.cm/config.yaml` with the backend switch commented out.
 - **Zero breaking changes** — `context-db.ts` and all existing callers unchanged. StorageBackend is additive.
 - **Test suite expanded** — `test/storage-backend.test.ts` (23 tests): factory defaults, config-driven dispatch, SqliteBackend full roundtrip, VikingBackend error messages. Total: **178 passed · 16 skipped · 0 failed**.
@@ -107,7 +432,6 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 - **OpenSpec Protocol Upgrade** — Enhanced integration with Fission-AI OpenSpec format (`openspec/changes/[initiative]/proposal.md`) for seamless context handoffs to downstream skills (`cm-planning` & `cm-execution`).
 - **Skill Evolution Engine** — Successfully executed automated self-healing mechanisms (Mode: FIX) for `cm-tdd` and `cm-debugging` after health monitor alerts.
 
-
 ## [4.3.0] - 2026-03-27
 
 ### 🚀 Improvements