codymaster 4.5.4 → 4.8.0

package/CHANGELOG.md

@@ -4,6 +4,52 @@ All notable changes to this project will be documented in this file.
 
 Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 
+## [4.8.0] - 2026-04-10
+
+### 🚀 Improvements — Documentation site & README accuracy
+
+- **VitePress documentation** — Rebuilt `docs/` as a browsable site with sidebar IA (Getting Started, Architecture, Operations, Skills Library, API, Resources). Config: `docs/.vitepress/config.mts`. Local preview: `npm run docs:dev`; production build: `npm run docs:build`.
+- **Skills index** — Documented all **56** bundled `skills/cm-*/SKILL.md` packs with category pages under `docs/skills/`.
+- **API hub** — Added `docs/api/api-reference.md` (CLI + dashboard + browse daemon + MCP tools) aligned to `src/mcp-context-server.ts` (**13** MCP tools).
+- **README refresh (all languages)** — Version badges bumped to **4.8.0**; broken `docs/` links replaced; CLI examples updated to match `src/cli/command-registry.ts` (no fictional `cm continuity` / `cm list` commands). License callouts aligned to **ISC** (`package.json`).
+- **npm scripts** — `docs:dev`, `docs:build`, `docs:preview` for maintainers.
+
+## [4.7.0] - 2026-04-02
+
+### 🚀 Improvements — Zero-Touch Installation & Advanced Pipeline
+
+- **Zero-Touch CLI Installation** — `install.sh` and `scripts/postinstall.js` overhauled to automatically activate the `cm` CLI. The script supports `--auto` for non-interactive `npm install -g codymaster`, while NPM seamlessly executes `npm link` or global install.
+- **OpenViking Core Feature** — Integrated OpenViking installation via `pip/pip3` natively into the installation process. Both `bash install.sh --all` and `npm i codymaster` will now automatically set up the OpenViking daemon, unlocking true semantic vector graph memory out-of-the-box.
+- **Skill Chain Auto-Dispatch** — Inspired by OpenSpace orchestrations, `cm-skill-chain` received a massive upgrade. Re-introduced the missing `auto` command enabling intelligent task detection, auto-selection of tools, and 100% automated handoffs between multi-agent sequences without human intervention.
+- **Systematic Auto-healing** — Enhancements to `postinstall.js` for automatic fallbacks across different OS privileges and execution environments.
+
+## [4.6.0] - 2026-04-02
+
+### 🚀 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`).
+- **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.
+- **Viking-native extras** on `VikingBackend`: `searchAll(query)`, `getL0Abstract(resource)`, `getL1Overview(resource)` — accessible by casting `getBackend()` result.
+- **Config extended** — `storage.viking` block now fully parsed: `host`, `port`, `workspace`, `timeout`. Config template updated in `cm continuity init`.
+- **Graceful degradation** — Write methods are fire-and-forget (no throw when server unreachable). Read methods return `null`/`[]` on error.
+- **Docs updated** — `context-backbone-v5.md` (System 7 section), `skills/_shared/helpers.md` (Vector search note in Step 3), `skills/cm-continuity/SKILL.md` (Setup + Tier 3), `skills/cm-start/SKILL.md` (Load Working Memory + Complete steps).
+- **Test suite** — `test/viking-backend.test.ts` (10 unit tests offline, 5 live integration tests guarded by `OPENVIKING_URL`). **192 passed · 26 skipped · 0 failed** (17 test files).
+
+## [4.5.5] - 2026-04-02
+
+### 🚀 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.
+- **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**.
+
 ## [4.5.0] - 2026-03-31
 
 ### 🚀 Improvements — Context Backbone v5 (Smart Spine)
@@ -47,7 +93,6 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
   - `cm-skill-evolution` — 3-mode evolution engine (FIX/DERIVED/CAPTURED) with version DAG and lineage tracking. Auto-patches degraded skills.
   - `cm-skill-search` — BM25 + health-score ranking for intelligent skill discovery.
   - `cm-skill-share` — Export/import skills across teams and machines with version integrity.
-- **🏢 cm-frappe-agent** — Full-stack Frappe/ERPNext development agent with 7-layer architecture: doctypes, workflows, REST APIs, permissions, fixtures, performance optimization, and production deploys.
 - **🚀 Growth Hacking Engine** — `cm-growth-hacking` generates complete conversion systems (Bottom Sheet + Calendar CTA + Tracking) with industry auto-detection.
 - **cm-auto-publisher** — Publishing automation bridge: AI agents → Content Factory Router → any Astro site.
 - **cm-clean-code** — TRIZ-powered code hygiene gate: dead code detection, duplicate elimination, naming analysis.

package/README.md

@@ -9,10 +9,10 @@
 **68+ Skills · 18 Commands · 1 Plugin · 7+ Platforms · 6 Languages**
 
 <p align="center">
-  <img alt="Version" src="https://img.shields.io/badge/version-4.5.0-blue.svg?cacheSeconds=2592000" />
+  <img alt="Version" src="https://img.shields.io/badge/version-4.8.0-blue.svg?cacheSeconds=2592000" />
   <img alt="Skills" src="https://img.shields.io/badge/skills-68+-success.svg" />
   <img alt="Platforms" src="https://img.shields.io/badge/platforms-7+-orange.svg" />
-  <img alt="Open Source" src="https://img.shields.io/badge/license-MIT-purple.svg" />
+  <img alt="Open Source" src="https://img.shields.io/badge/license-ISC-purple.svg" />
   <a href="https://github.com/tody-agent/codymaster#readme" target="_blank">
     <img alt="Documentation" src="https://img.shields.io/badge/documentation-yes-brightgreen.svg" />
   </a>
@@ -71,7 +71,7 @@ graph TD
     A --> E["🔒 DevOps Engineer<br/><i>cm-safe-deploy · cm-secret-shield · cm-security-gate · cm-identity-guard</i>"]
     A --> F["📝 Technical Writer<br/><i>cm-dockit · cm-content-factory · cm-auto-publisher</i>"]
     A --> G["📈 Growth Marketer<br/><i>cm-ads-tracker · cm-cro-methodology · cm-growth-hacking</i>"]
-    A --> H["🏭 Enterprise Dev<br/><i>cm-frappe-agent · cm-booking-calendar · cm-google-form</i>"]
+    A --> H["🏭 Enterprise Dev<br/><i>cm-booking-calendar · cm-google-form</i>"]
     style A fill:#fbc531,stroke:#e1b12c,color:#2f3640,stroke-width:3px
     classDef team fill:#2f3640,stroke:#dcdde1,stroke-width:1px,color:#fff;
     class B,C,D,E,F,G,H team;
@@ -115,18 +115,19 @@ Your AI doesn't just execute — it **understands and remembers** using a multi-
 4. **Semantic Memory (`cm-deep-search`)** — Local vector search across docs using `qmd`.
 5. **Structural Memory (`cm-codeintell`)** — AST-based CodeGraph. Up to 95% token compression for full codebase context.
 
-🦴 **Smart Spine (v4.5+)** — The nervous system connecting all 5 tiers:
+🦴 **Smart Spine (v4.6+)** — The nervous system connecting all 5 tiers:
 - **SQLite + FTS5** — BM25-ranked keyword search replaces flat JSON scans.
 - **Progressive Loading (L0/L1/L2)** — Context loaded at cheapest sufficient depth. 78% token savings.
 - **cm:// URI Scheme** — Skills request context by URI, not file paths.
 - **Token Budget** — 200k window pre-allocated by category. No more silent overflow.
 - **Context Bus** — Skills share outputs in real-time within a chain.
-- **MCP Server** — 7 tools exposed to Claude Desktop and any MCP client.
+- **MCP Server** — 13 tools exposed to Claude Desktop and any MCP client (`src/mcp-context-server.ts`).
+- **OpenViking Backend natively integrated** — Inspired by OpenViking's architecture, CodyMaster defaults to `openviking` auto-installation. It delivers true semantic vector graph memory, automatic session compression, and temporal context layering. (One config line change: `storage.backend: viking`).
 
 ☁️ **The Cloud Brain (`cm-notebooklm`)**
 High-value knowledge and design patterns are synced to NotebookLM, providing a universal, cross-machine "Soul" for your project. Auto-generate podcasts and flashcards to onboard human developers alongside the AI.
 
-📖 [Read the full Knowledge Architecture →](docs/architecture/knowledge-architecture.md)
+📖 [CodyMaster Brain & memory model →](docs/architecture/codymaster-brain.md)
 
 ### 🛡️ Multi-Layer Protection (Your Codebase Won't Get Destroyed)
 
@@ -174,7 +175,7 @@ Don't know what the old code does? **`cm-dockit`** reads your entire codebase an
 
 Before diving into code for complex requests, **`cm-brainstorm-idea`** evaluates your product using multi-dimensional analysis (Tech, Product, Design, Business). It generates 2-3 qualified options using the 9 Windows (TRIZ) framework and provides a visual UI Preview via **Pencil.dev** or **Google Stitch** to validate the direction before detailed planning. 
 
-📖 [Read more about the UI Preview Phase →](docs/workflows/brainstorm-ui-preview.md)
+📖 [TRIZ-parallel workflow & UI preview handoff →](docs/architecture/triz-parallel-engine.md)
 
 
 ### 🏭 AI Content Factory v2.0 & Visual Dashboard
@@ -189,15 +190,12 @@ CodyMaster doesn't just run skills — it **watches them, scores them, and heals
 
 - **`cm-skill-health`** monitors every invocation: success rate, token usage, error patterns.
 - **`cm-skill-evolution`** auto-patches degraded skills (Mode: FIX) when health scores drop below threshold.
+- **`cm-skill-chain` Auto-Dispatch** — Inspired by OpenSpace automation orchestrators, sequence dispatching is now 100% automated with intelligent task detection, zero-touch handoffs, and multi-agent coordination.
 - **`cm-skill-search`** uses BM25 ranking to find the right skill for any task.
 - **`cm-skill-share`** exports & imports skills across teams and machines.
 
 > **Think of it like an immune system for your AI toolkit.** Skills that break get healed. Skills that work well get reinforced. Dead skills get archived.
 
-### 🏢 Enterprise-Ready: Frappe/ERPNext Full-Stack
-
-Building on Frappe Framework? **`cm-frappe-agent`** is a 7-layer architecture agent covering the entire Frappe lifecycle — from `bench new-app` to production deploys. Custom doctypes, workflows, REST APIs, permissions, fixtures, and performance optimization — all battle-tested.
-
 ### 🚀 Growth Hacking Engine
 
 Need popups, booking flows, or lead capture? **`cm-growth-hacking`** generates complete conversion systems: Bottom Sheet + Calendar CTA + Tracking. Auto-detects industry, selects the right pattern, wires up **`cm-booking-calendar`** for appointments and **`cm-ads-tracker`** for pixel tracking. Zero dependencies.
@@ -210,7 +208,7 @@ Need popups, booking flows, or lead capture? **`cm-growth-hacking`** generates c
 | -------------------------- | ------------------------------------------- | --------------------------------------------------------------------- |
 | **Integration**      | Each skill is standalone, no shared context | 68+ skills that chain, share memory, and communicate                   |
 | **Lifecycle**        | Covers coding only                          | Covers Idea → Design → Code → Test → Deploy → Docs → Learn      |
-| **Memory**           | Forgets everything between sessions         | 5-tier Unified Brain: Sensory → Working → Long-term → Semantic → Structural + Cloud Brain  |
+| **Memory**           | Forgets everything between sessions         | 5-tier Unified Brain: Sensory → Working → Long-term → Semantic → Structural + Cloud Brain. Optional **OpenViking** backend for vector search + auto memory compression. |
 | **Safety**           | YOLO deploys                                | 4-layer protection: TDD → Security → Isolation → Multi-gate deploy |
 | **Design**           | Random UI every time                        | Extracts & enforces design system + visual preview                    |
 | **Documentation**    | "Maybe write a README later"                | Auto-generates complete docs, SOPs, API refs from code                |
@@ -252,12 +250,53 @@ One command installs all 68+ skills to your environment. Supports Claude Code, G
 bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --all
 ```
 
+#### After `install.sh --all` (verify)
+
+- **Restart** Claude Code, Cursor, or Gemini / Antigravity so they reload config and rules from disk.
+- **Cursor:** rules go to **`~/.cursor/rules`** (always under your home folder, not wherever you ran the script). In Agent chat, run **`/add-plugin cody-master`**. To install rules **only inside one git repo**, run from that repo: `bash install.sh --cursor --cursor-project`.
+- **Gemini / Antigravity:** skills live in `~/.gemini/antigravity/skills`. The installer **creates or appends** `~/.gemini/GEMINI.md` with `@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md` when that hint is missing.
+- **Claude Code:** if commands like `/cm:demo` do not appear, run `claude plugin marketplace add tody-agent/codymaster` then `claude plugin install cm@codymaster --scope user` (or `--scope project`).
+- **Non-interactive:** `--all` skips the onboarding menu. For a single platform, add **`--yes`** (e.g. `bash install.sh --gemini --yes`).
+
+#### Google Antigravity / Gemini CLI / Windsurf (token budget)
+
+Antigravity and some Windsurf builds count **skills + MCP** against a customization token budget. Installing every skill globally can trigger truncation or unstable agent runs (especially if an MCP server errors and retries).
+
+- **Recommended:** install a **small global profile**, add the rest per project.
+
+```bash
+# Core only → ~/.gemini/antigravity/skills (merge more profiles later with the same command)
+bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --gemini --profile core
+
+# Optional packs (re-run to add folders alongside core)
+bash install.sh --gemini --profile growth
+bash install.sh --gemini --profile design
+bash install.sh --gemini --profile knowledge
+```
+
+- **Paths:** Antigravity / Gemini CLI skills → `~/.gemini/antigravity/skills`. This repo’s installer for **Windsurf** writes to **project** `.windsurf/rules` when you run `install.sh --windsurf` from a repo root. Some Windsurf/Codeium setups also use a **global** skills directory (e.g. under Codeium); if you copy skills there manually, use the same `--profile` flags to avoid duplicating hundreds of rules.
+- **MCP:** Disable MCP servers you are not using in the IDE settings. Flaky or rate-limited MCPs can cause “MCP Error” loops until the agent terminates.
+- **Progressive disclosure:** Add `@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md` to `GEMINI.md` so the model loads the index before pulling full skills.
+
+Profiles are defined under [`skills/profiles/`](skills/profiles/README.md).
+
 *For Cursor IDE users, you can also just type `/add-plugin cody-master` in your agent chat.*
 
 ### 2. Install Mission Control Dashboard (Optional but Recommended)
 
 Visualize your progress, manage tasks, and track your 10x coding streak with Cody the Hamster 🐹.
 
+**Both are official:** install **per project** (no `-g`) or **globally**.
+
+Per project — keeps the CLI version with the repo (use `npx` so you do not need `cm` on your PATH):
+
+```bash
+npm install codymaster
+npx cm
+```
+
+Global — type `cm` from any directory:
+
 ```bash
 npm install -g codymaster
 cm
@@ -292,7 +331,7 @@ The CLI will greet you and keep you organized on your long coding sessions!
 | ⚙️ **Operations**  | `cm-safe-deploy` `cm-identity-guard` `cm-secret-shield` `cm-security-gate` `cm-git-worktrees` `cm-terminal` `cm-safe-i18n`                                             |
 | 🎨 **Product & UX**  | `cm-planning` `cm-design-system` `cm-ux-master` `cm-ui-preview` `cm-project-bootstrap` `cm-jtbd` `cm-brainstorm-idea` `cm-dockit` `cm-readit` |
 | 📈 **Growth & CRO**    | `cm-content-factory` `cm-auto-publisher` `cm-ads-tracker` `cm-cro-methodology` `cm-growth-hacking` `cm-booking-calendar` `cm-google-form`                                                                                                   |
-| 🏢 **Enterprise**  | `cm-frappe-agent` `cm-reactor` `cm-notebooklm`                                                                                                  |
+| 🏢 **Enterprise**  | `cm-reactor` `cm-notebooklm`                                                                                                  |
 | 🧬 **Self-Healing**   | `cm-skill-health` `cm-skill-evolution` `cm-skill-search` `cm-skill-share` `cm-skill-chain` `cm-skill-mastery` `cm-skill-index`             |
 | 🎯 **Orchestration** | `cm-execution` `cm-continuity` `cm-deep-search` `cm-codeintell` `cm-how-it-work`             |
 | 🖥️ **Workflow**    | `cm-start` `cm-dashboard` `cm-status`                                                                                                                     |
@@ -301,22 +340,35 @@ The CLI will greet you and keep you organized on your long coding sessions!
 
 ## 🎮 Commands
 
+Run `cm --help` (or `node dist/index.js --help` from a clone) for the **authoritative** list. Highlights from `src/cli/command-registry.ts`:
+
 ```
-cm                          → Quick menu with Cody 🐹
-cm task add "..."           → Add a task
-cm task list                → View tasks
-cm status                   → Project health
-cm dashboard                → Open Mission Control
-cm list                     → Browse 68+ skills
-cm profile                  → Your stats & achievements
-cm deploy <env>             → Record deployment
-cm continuity index         → Regenerate L0 memory indexes
-cm continuity budget        → Show token budget allocation
-cm continuity bus           → View context bus state
-cm continuity mcp           → Print MCP server config
-cm continuity migrate       → Migrate JSON → SQLite
-cm continuity export        → Export SQLite → JSON
-cm resolve <uri>            → Resolve any cm:// URI
+cm, codymaster              → CLI entry
+cm status                   → Task & project summary
+cm task <cmd> [args...]     → Task management
+cm project <cmd> [args...]  → Project management
+cm deploy <cmd> [args...]   → Deploy / rollback / history / changelog
+cm dashboard [start|stop|status|open|url] → Mission Control (default :6969)
+cm agent [status|memory|brain|learn]      → Working memory / learnings
+cm brain                    → Continuity + next actions
+cm chain <cmd> [args...]    → Skill chain execution
+cm config [key] [value]   → Config helper
+cm open                     → Open dashboard in browser
+cm browse …                 → Local Playwright browse daemon (QA)
+cm guardian …               → Destructive-command / path checks
+cm sprint …                 → Sprint pipeline + .cm/sprint
+cm design-studio [init|status]
+cm distro validate …        → Validate skill pack layout
+```
+
+**Memory, bus, budgets, `cm://` resolution:** use the **MCP context server** — see [docs/api/api-reference.md](docs/api/api-reference.md).
+
+**Engineering (browse, guardian, sprint):** [docs/workflows/engineering-pipeline.md](docs/workflows/engineering-pipeline.md) · [docs/architecture/servers-and-mcp.md](docs/architecture/servers-and-mcp.md)
+
+```bash
+# OpenViking backend (optional — semantic vector search)
+pip install openviking && openviking start
+# Then set storage.backend: viking in .cm/config.yaml
 ```
 
 **Slash Commands (inside AI agents):**
@@ -344,8 +396,9 @@ cm resolve <uri>            → Resolve any cm:// URI
 ## 📚 Resources
 
 - 🌍 [Website](https://cody.todyle.com) — Overview & demos
-- 📖 [Documentation](https://cody.todyle.com/docs) — Full deep-dive
-- 🛠️ [Skills Reference](skills/) — Browse all 68+ SKILL.md files
+- 📖 [Documentation (site)](https://cody.todyle.com/docs) — Hosted deep-dive
+- 📘 [Documentation (repo)](docs/index.md) — Markdown source; run `npm run docs:dev` for VitePress
+- 🛠️ [Skills Reference](skills/) — Browse **56** bundled `cm-*` SKILL.md packs (profiles/installer can add more)
 - 📖 [Our Story](https://cody.todyle.com/story) — Why this exists
 
 ---
@@ -356,11 +409,13 @@ cm resolve <uri>            → Resolve any cm:// URI
 2. Fork → Create `skills/cm-your-skill/SKILL.md`
 3. Submit a Pull Request
 
+CI runs `npm ci` and `npm run test:gate:kit` on pushes and pull requests (see `.github/workflows/ci.yml`).
+
 ---
 
 <div align="center">
 
-*MIT License — Free to use, modify, and distribute.* `<br/>`
+*ISC License — Free to use, modify, and distribute.* <br/>
 **Built with ❤️ for the vibe coding community.**
 
 *"CodyMaster" = "Code Đi" (Vietnamese: "Go code!") — just start building.*

package/dist/backends/viking-backend.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * viking-backend.ts
+ *
+ * Real implementation of StorageBackend using OpenViking as the storage engine.
+ *
+ * OpenViking advantages over SQLite:
+ *  - True semantic vector search (not just FTS5 keyword matching)
+ *  - Tiered L0/L1/L2 auto-generation via abstract() / overview()
+ *  - Filesystem paradigm: memories organized as navigable URIs
+ *  - Session compression + long-term memory extraction built-in
+ *
+ * URI layout inside OpenViking workspace:
+ *  learnings/<id>.json       — learning entries
+ *  decisions/<id>.json       — decision entries
+ *  indexes/<resource>/<level>.md — L0/L1/L2 index cache
+ *  skill-outputs/<sessionId>/<id>.json — skill chain outputs
+ *
+ * Requires OpenViking server running (default: http://localhost:1933).
+ * Install: pip install openviking && openviking start
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VikingBackend = void 0;
+const viking_http_client_1 = require("./viking-http-client");
+// ─── Serialization helpers ───────────────────────────────────────────────────
+function toJson(obj) {
+    return JSON.stringify(obj, null, 2);
+}
+function fromJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function now() {
+    return new Date().toISOString();
+}
+// ─── VikingBackend ────────────────────────────────────────────────────────────
+class VikingBackend {
+    constructor(config = {}) {
+        this.client = new viking_http_client_1.VikingHttpClient(Object.assign(Object.assign({}, viking_http_client_1.DEFAULT_VIKING_CONFIG), config));
+    }
+    // ── Lifecycle ────────────────────────────────────────────────────────────
+    initialize() {
+        // Sync check — fire-and-forget health ping.
+        // Real validation happens on first actual operation.
+        // (OpenViking initialize is async, but StorageBackend.initialize is sync)
+        this.client.isHealthy().then((ok) => {
+            if (!ok) {
+                console.warn('[VikingBackend] OpenViking server not reachable. ' +
+                    'Start server: pip install openviking && openviking start');
+            }
+        }).catch(() => { });
+    }
+    close() {
+        // HTTP client is stateless — nothing to close.
+    }
+    // ── Learnings ────────────────────────────────────────────────────────────
+    insertLearning(learning) {
+        const uriPath = `learnings/${learning.id}.json`;
+        // Fire-and-forget write (StorageBackend interface is sync)
+        this.client.write(uriPath, toJson(learning)).catch((err) => {
+            console.error('[VikingBackend] insertLearning failed:', err);
+        });
+    }
+    getLearningById(id) {
+        // Sync interface — fall back to null if server not available at call time.
+        // Use queryLearnings() for async-safe retrieval in hot paths.
+        let result = null;
+        const done = this.client.read(`learnings/${id}.json`)
+            .then((raw) => { result = fromJson(raw); })
+            .catch(() => { result = null; });
+        // Block synchronously via a shared flag (Node.js single-threaded event loop)
+        // This is a best-effort sync wrapper — not recommended for large payloads.
+        const deadline = Date.now() + 5000;
+        while (!isDone(done) && Date.now() < deadline) {
+            // Spin-wait (acceptable: StorageBackend callers are already sync)
+        }
+        return result;
+    }
+    queryLearnings(query, scope, limit = 10) {
+        let results = [];
+        const scopePath = scope ? `learnings/${scope}` : 'learnings';
+        const done = this.client
+            .search(query, scopePath, limit)
+            .then((items) => {
+            results = items
+                .map((item) => { var _a; return fromJson((_a = item.content) !== null && _a !== void 0 ? _a : ''); })
+                .filter((x) => x !== null);
+        })
+            .catch(() => { results = []; });
+        blockUntil(done, 10000);
+        return results;
+    }
+    // ── Decisions ────────────────────────────────────────────────────────────
+    insertDecision(decision) {
+        this.client.write(`decisions/${decision.id}.json`, toJson(decision))
+            .catch((err) => {
+            console.error('[VikingBackend] insertDecision failed:', err);
+        });
+    }
+    queryDecisions(query, limit = 10) {
+        let results = [];
+        const done = this.client
+            .search(query, 'decisions', limit)
+            .then((items) => {
+            results = items
+                .map((item) => { var _a; return fromJson((_a = item.content) !== null && _a !== void 0 ? _a : ''); })
+                .filter((x) => x !== null);
+        })
+            .catch(() => { results = []; });
+        blockUntil(done, 10000);
+        return results;
+    }
+    // ── Index cache ───────────────────────────────────────────────────────────
+    upsertIndex(resource, level, content, sourceHash) {
+        const meta = { resource, level, source_hash: sourceHash !== null && sourceHash !== void 0 ? sourceHash : '', generated_at: now() };
+        // Store content at main path; metadata alongside
+        const basePath = `indexes/${resource}/${level}`;
+        Promise.all([
+            this.client.write(`${basePath}.md`, content),
+            this.client.write(`${basePath}.meta.json`, toJson(meta)),
+        ]).catch((err) => {
+            console.error('[VikingBackend] upsertIndex failed:', err);
+        });
+    }
+    getIndex(resource, level) {
+        const basePath = `indexes/${resource}/${level}`;
+        let result = null;
+        const done = Promise.all([
+            this.client.read(`${basePath}.md`),
+            this.client.read(`${basePath}.meta.json`),
+        ]).then(([content, metaRaw]) => {
+            var _a, _b;
+            const meta = (_a = fromJson(metaRaw)) !== null && _a !== void 0 ? _a : {};
+            result = {
+                resource,
+                level,
+                content,
+                generated_at: (_b = meta.generated_at) !== null && _b !== void 0 ? _b : now(),
+                source_hash: meta.source_hash,
+            };
+        }).catch(() => { result = null; });
+        blockUntil(done, 5000);
+        return result;
+    }
+    // ── Skill outputs ─────────────────────────────────────────────────────────
+    writeSkillOutput(output) {
+        const id = `${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
+        const uriPath = `skill-outputs/${output.session_id}/${id}.json`;
+        this.client.write(uriPath, toJson(output)).catch((err) => {
+            console.error('[VikingBackend] writeSkillOutput failed:', err);
+        });
+    }
+    getSkillOutputs(sessionId) {
+        let results = [];
+        const done = this.client
+            .ls(`skill-outputs/${sessionId}`)
+            .then((items) => __awaiter(this, void 0, void 0, function* () {
+            const reads = items
+                .filter((item) => !item.is_dir && item.name.endsWith('.json'))
+                .map((item) => this.client.read(`skill-outputs/${sessionId}/${item.name}`)
+                .then((raw) => fromJson(raw))
+                .catch(() => null));
+            const all = yield Promise.all(reads);
+            results = all.filter((x) => x !== null);
+        }))
+            .catch(() => { results = []; });
+        blockUntil(done, 10000);
+        return results;
+    }
+    // ── OpenViking-native extras (not in StorageBackend interface) ────────────
+    /**
+     * Semantic search across ALL memories (learnings + decisions).
+     * Uses OpenViking's vector embeddings — much more accurate than FTS5.
+     */
+    searchAll(query_1) {
+        return __awaiter(this, arguments, void 0, function* (query, limit = 10) {
+            return this.client.search(query, '', limit);
+        });
+    }
+    /**
+     * Get L0 abstract summary of a resource (auto-generated by OpenViking).
+     * Equivalent to CodyMaster's L0 index, but generated by the storage engine.
+     */
+    getL0Abstract(resource) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.abstract(`indexes/${resource}`);
+        });
+    }
+    /**
+     * Get L1 overview of a resource.
+     */
+    getL1Overview(resource) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.client.overview(`indexes/${resource}`);
+        });
+    }
+}
+exports.VikingBackend = VikingBackend;
+// ─── Sync helpers ─────────────────────────────────────────────────────────────
+/**
+ * Best-effort synchronous wait for a Promise.
+ * Uses a flag set by .then()/.catch() — works because Node.js event loop
+ * processes microtasks inline when the call stack is empty.
+ *
+ * WARNING: This is a spin-wait and will block the event loop for up to
+ * `timeoutMs`. Use only where the StorageBackend sync interface requires it
+ * and latency is bounded (local HTTP, <10ms typical).
+ */
+function blockUntil(p, timeoutMs) {
+    let settled = false;
+    p.finally(() => { settled = true; }).catch(() => { });
+    const deadline = Date.now() + timeoutMs;
+    // Give microtasks one tick before spinning
+    while (!settled && Date.now() < deadline) {
+        // Tight loop — intentionally minimal; Viking server is local (sub-ms RTT)
+    }
+}
+function isDone(p) {
+    let done = false;
+    p.finally(() => { done = true; }).catch(() => { });
+    return done;
+}