docs: website refresh, localized READMEs, CI quality gates (#49)

docs: website refresh, localized READMEs, CI quality gates

Author: christopherkarani

.github/workflows/quality-gates.yml

@@ -18,4 +18,4 @@ jobs:
 
       - name: Run Production Gate
         run: |
-          bash scripts/quality/production_readiness_gates.sh ${{ matrix.mode }}
+          bash Resources/scripts/quality/production_readiness_gates.sh ${{ matrix.mode }}

.github/workflows/release-waxmcp.yml

@@ -20,8 +20,8 @@ jobs:
         include:
           - runs-on: macos-14
             platform: darwin-x64
-            triple: ""
-            source-build: false
+            triple: x86_64-apple-macosx14.0
+            source-build: true
           - runs-on: macos-14
             platform: darwin-arm64
             triple: arm64-apple-macosx14.0

.github/workflows/waxcore-linux.yml

@@ -15,10 +15,10 @@ jobs:
       - name: Install Linux codec dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y liblz4-dev zlib1g-dev
+          sudo apt-get install -y liblz4-dev zlib1g-dev libsqlite3-dev
 
       - name: Build WaxCore target
-        run: swift build --target WaxCore
+        run: swift build --target WaxCore -Xswiftc -DGRDBCUSTOMSQLITE
 
       - name: Run WaxCore tests
-        run: swift test --filter WaxCoreTests
+        run: swift test --filter WaxCoreTests -Xswiftc -DGRDBCUSTOMSQLITE

.gitignore

@@ -23,3 +23,22 @@ AGENTS.md
 *.o
 *.swiftdeps
 tasks/
+docs/
+task/
+output/
+.tmp/
+.linux-scratch/
+.gemini/
+.sisyphus/
+/memvid-main/
+/memvid/
+*.log
+.env
+.env.*
+.idea/
+.zed/
+Resources/website/node_modules/
+Resources/website/.docusaurus/
+Resources/website/build/
+*.xcresult
+docs/\ntasks/\nscripts/

.tmp/swift-home-release/.npm/_logs/2026-02-27T01_01_02_664Z-debug-0.log

@@ -29,6 +29,18 @@ A skill is a set of local instructions to follow that is stored in a `SKILL.md`
 - Safety and fallback: If a skill can't be applied cleanly (missing files, unclear instructions), state the issue, pick the next-best approach, and continue.
 </INSTRUCTIONS>
 
+# Wax on macOS (MCP Quickstart)
+
+On macOS, use the MCP server for Claude Code tool-calls (fast, long-lived).
+
+## Install (macOS)
+
+### MCP Server (Claude Code)
+
+```bash
+npx -y waxmcp@latest mcp install --scope user
+```
+
 # Wax Agent API Reference
 
 This documentation is specifically for AI Agents (like you) to understand how to interact with the **Wax** memory engine using the `MemoryOrchestrator` interface.
@@ -138,4 +150,3 @@ public struct Item {
 
 **Example System Instruction for Agents using Wax**:
 "You have access to a long-term memory tool called `Wax`. When answering, first check if relevant information exists in memory. If you find relevant context, incorporate it into your answer. If the user provides new important information, save it to memory."
-

.tmp/swift-home-release/.npm/_update-notifier-last-checked

@@ -0,0 +1,36 @@
+# Wax (macOS) - Claude Code Memory
+
+## Install
+
+### MCP Server (Claude Code)
+
+```bash
+npx -y waxmcp@latest mcp install --scope user
+```
+
+## Rules
+
+1. **Session start** — call `wax_session_start`, then `wax_handoff_latest` to resume prior context (use `session_id` for scoped calls)
+2. **Before answering** — call `wax_recall` (or `wax_search` if you need raw ranked hits)
+3. **When you learn something durable** — call `wax_remember` (batch writes, then `wax_flush` to persist)
+4. **When corrected** — store the correction via `wax_remember` (and retract structured facts via `wax_fact_retract` when applicable), then `wax_flush`
+5. **Session end** — call `wax_handoff` (`content`, optional `project`, `pending_tasks`), then `wax_flush`, then `wax_session_end`
+
+## Tools
+
+| Tool | When |
+|------|------|
+| `wax_session_start` | Start a new memory session; use returned `session_id` to scope reads/writes |
+| `wax_session_end` | End the active session |
+| `wax_remember` | Store durable info (preferences, decisions, facts, key notes) |
+| `wax_recall` | Build RAG context for a query (recommended default read path) |
+| `wax_search` | Direct search when you need raw ranked hits (hybrid/text modes) |
+| `wax_flush` | Persist pending writes so they’re searchable and safe on disk |
+| `wax_stats` | Quick health check (store stats, embedder identity, vector search enabled) |
+| `wax_handoff` | End-of-session summary (`content`) + optional `pending_tasks` for continuity |
+| `wax_handoff_latest` | Start-of-session: load the most recent handoff (optionally by `project`) |
+| `wax_entity_upsert` | Create/update a structured entity (knowledge graph) |
+| `wax_entity_resolve` | Resolve entities by alias |
+| `wax_fact_assert` | Assert a structured fact |
+| `wax_fact_retract` | Retract (soft-delete) a structured fact by id |
+| `wax_facts_query` | Query structured facts |