feat(plugins): closeout — email-log nav + reconciliation cron + PluginBuilder compat

.claude/settings.json

@@ -1,8 +1,14 @@
 {
   "hooks": {
-    "userPromptSubmitHook": {
-      "command": "echo '\n\n---\n\n📋 TESTING REMINDER: After completing this task, create and run E2E tests to verify the changes work correctly. Tests should go in tests/e2e/ using Playwright.\n\n---\n'",
-      "description": "Remind Claude to create E2E tests for all changes"
-    }
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '\n\n---\n\n📋 TESTING REMINDER: After completing this task, create and run E2E tests to verify the changes work correctly. Tests should go in tests/e2e/ using Playwright.\n\n---\n'"
+          }
+        ]
+      }
+    ]
   }
 }

.codegraph/.gitignore

@@ -0,0 +1,16 @@
+# CodeGraph data files
+# These are local to each machine and should not be committed
+
+# Database
+*.db
+*.db-wal
+*.db-shm
+
+# Cache
+cache/
+
+# Logs
+*.log
+
+# Hook markers
+.dirty

.github/workflows/publish.yml

@@ -0,0 +1,59 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Dry run (npm publish --dry-run)'
+        required: false
+        default: false
+        type: boolean
+
+jobs:
+  publish:
+    name: Build and Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build core
+        run: npm run build:core
+
+      - name: Type check
+        run: npm run type-check
+
+      - name: Publish @sonicjs-cms/core
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          if [ "${{ inputs.dry_run }}" = "true" ]; then
+            npm publish --workspace=@sonicjs-cms/core --provenance --access public --dry-run
+          else
+            npm publish --workspace=@sonicjs-cms/core --provenance --access public
+          fi
+
+      - name: Publish create-sonicjs
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          if [ "${{ inputs.dry_run }}" = "true" ]; then
+            npm publish --workspace=create-sonicjs --provenance --access public --dry-run
+          else
+            npm publish --workspace=create-sonicjs --provenance --access public
+          fi

.gitignore

@@ -8,6 +8,7 @@ node_modules/
 /build
 # Package dist artifacts — generated by build, never committed
 packages/*/dist/
+packages/*/build
 
 # Development
 .wrangler/
@@ -84,4 +85,7 @@ coverage/
 test-install/my-sonicjs-app/node_modules/
 test-install/my-sonicjs-app/.wrangler/
 test-install/my-sonicjs-app/.dev.vars
-test-install/my-sonicjs-app/package-lock.json
+test-install/my-sonicjs-app/package-lock.json
+
+# Codegraph index (local, auto-generated)
+.codegraph/

.husky/pre-commit

@@ -3,6 +3,3 @@ npm run lint --workspace=@sonicjs-cms/core
 
 echo "Running type checks..."
 npm run type-check
-
-echo "Running unit tests..."
-npm test

AGENTS.md

@@ -2,6 +2,49 @@
 
 These instructions mirror the workflow Claude Code already follows in Conductor so every coding agent behaves consistently.
 
+## Token-Efficient Tooling (use FIRST, before grep/Read sprees)
+
+This repo is indexed by **codegraph** (684 files, 5693 nodes). Use it as the default code-lookup tool. Hook also rewrites shell commands via **rtk** for 60-90% bash savings. Default response mode is **caveman** for terse output.
+
+### Decision tree — code exploration
+
+| Intent | Tool | Why |
+|--------|------|-----|
+| "How does X work / where does X live / trace flow X→Y" | `mcp__codegraph__codegraph_explore` | ONE call returns verbatim source grouped by file. Replaces many Read/Grep. |
+| "Just the location of symbol named X" | `mcp__codegraph__codegraph_search` | Cheapest — name + path only. |
+| "What calls this / what does this call / blast radius" | `codegraph_callers` / `codegraph_callees` / `codegraph_impact` | Edges already indexed; grep can't follow dynamic dispatch. |
+| Pinpoint known file edit | `Read` + `Edit` | Codegraph not needed for known path. |
+| Truly open-ended cross-cutting search | `Agent` w/ `Explore` or `cavecrew-investigator` | Compressed output, protects main context. |
+
+**Rule:** Before any 3+ Grep/Read combo for "where is X", call `codegraph_explore` first. Treat codegraph as a pre-built index — don't re-run searches it already answers.
+
+### rtk (Rust Token Killer)
+
+- Bash commands auto-rewritten by hook — transparent, 0 overhead. No action needed.
+- `rtk gain` to audit savings; `rtk discover` to find missed opportunities.
+- Don't bypass rtk with raw shell unless debugging.
+
+### caveman mode
+
+- Active by default (full). Drops articles/filler. Code blocks, commits, security warnings stay normal.
+- Toggle: `/caveman lite|full|ultra`, off via "stop caveman".
+
+### Delegation — cavecrew subagents
+
+Use when scope is bounded AND output would bloat main context:
+- `cavecrew-investigator` — read-only locator ("where is X / what calls Y / map this dir"). ~60% smaller tool result vs vanilla Explore.
+- `cavecrew-builder` — surgical 1-2 file edit (typo, single-fn rewrite, mechanical rename). Refuses 3+ files.
+- `cavecrew-reviewer` — diff/PR review, one line per finding.
+
+Skip cavecrew for: known-path edits, multi-file features, anything codegraph answers in one call.
+
+### Anti-patterns (token waste)
+
+- ❌ Running `grep -r` across the repo when `codegraph_search` would answer.
+- ❌ Reading 5+ files to understand a flow — `codegraph_explore` returns the relevant slice.
+- ❌ Spawning a subagent just to read one known file.
+- ❌ Verbose narration. Caveman mode handles that — keep updates to one sentence.
+
 ## Project Structure & Stack
 - Monorepo managed with npm workspaces. Core Hono + Workers code, routes, middleware, templates, plugins, utils, and DB lives in `packages/core/src`.
 - Shared templates/components: `packages/templates/`. CLI scaffolder: `packages/create-app/`. Helper scripts: `packages/scripts/`.

docs/ai/CLAUDE.md

@@ -11,6 +11,19 @@ This project is a Cloudflare-native headless CMS built with **Hono.js** and Type
 - **Frontend**: HTMX + HTML for admin interface
 - **Deployment**: Wrangler CLI
 
+## Token-Efficient Tooling (REQUIRED before grep/Read sprees)
+
+Repo indexed by **codegraph**. Bash auto-proxied by **rtk**. Default reply mode **caveman**.
+
+- **Code lookup**: call `mcp__codegraph__codegraph_explore` FIRST for any "how does X work / trace flow / where is X used" question. ONE call returns verbatim source grouped by file — replaces 5-20 Grep/Read calls.
+- **Symbol location only**: `codegraph_search`.
+- **Call graph / impact**: `codegraph_callers`, `codegraph_callees`, `codegraph_impact`.
+- **Bash**: hook rewrites to `rtk <cmd>` automatically. `rtk gain` to audit savings.
+- **Replies**: caveman mode (full) — drop articles/filler. Code/commits/security warnings stay normal. Toggle `/caveman` or "stop caveman".
+- **Subagent delegation** (compressed output, ~60% smaller results): `cavecrew-investigator` (locate), `cavecrew-builder` (1-2 file edit), `cavecrew-reviewer` (diff review).
+
+Anti-patterns: `grep -r` across repo when codegraph answers; reading 5+ files to learn a flow; spawning subagent for a known file; verbose narration.
+
 ## Development Workflow
 
 1. **Plan First**: Read the codebase, understand the problem, and write a plan to project-plan.md
@@ -57,59 +70,12 @@ This project uses Claude's memory MCP server to maintain context across sessions
 - **Team Knowledge**: Shared memory means consistent AI assistance for all developers
 - **Learning**: Memory improves over time as more context is added
 
-## Recent Development Updates (December 2024)
-
-### Glass Morphism Design System Implementation
-
-The admin interface has been completely redesigned using a glass morphism design pattern for a modern, cohesive look.
-
-#### Design Components
-- **Backdrop Effects**: `backdrop-blur-md bg-black/20` for glass effect
-- **Borders**: `border border-white/10` for subtle definition
-- **Shadows**: `shadow-xl` for depth and layering
-- **Corners**: `rounded-xl` for modern appearance
-- **Spacing**: `space-y-6` for consistent layout rhythm
-
-#### Implemented Pages
-1. **Settings Page** (`admin-settings.template.ts`):
-   - Comprehensive tabbed interface (General, Appearance, Security, Notifications, Storage)
-   - Interactive JavaScript for tab switching and form handling
-   - Bulk save functionality and reset options
-   - Full glass morphism styling
-
-2. **Collections Pages**:
-   - **List Page**: Glass header, enhanced table, improved empty state, quick actions section
-   - **Form Page**: Glass breadcrumbs, consistent form styling, updated action buttons
-
-3. **Content List Page**: Updated with glass morphism styling and improved button interactions
-
-4. **Media Library**: Already implemented with glass morphism design patterns
-
-#### Navigation Updates
-- Added Settings link to admin sidebar
-- Updated icon consistency across navigation items
-- Proper navigation highlighting for current page
-
-#### Design Patterns Established
-- **Headers**: Glass cards with title, description, and primary actions
-- **Tables**: Glass containers with enhanced styling and hover effects
-- **Forms**: Glass backgrounds with consistent input styling
-- **Buttons**: Gradient buttons with glass hover effects
-- **Empty States**: Centered content with gradient icons and compelling CTAs
-- **Quick Actions**: Grid layouts with hover animations
-
-### Development Approach
-
-When working on new admin pages or components:
-1. Follow the established glass morphism patterns
-2. Use consistent spacing (`space-y-6`) between sections
-3. Apply glass backgrounds to major containers
-4. Use gradient buttons for primary actions
-5. Include hover effects and transitions for interactivity
-6. Maintain consistent typography and color usage
-
-### File Structure for Glass Morphism
-- All admin page templates in `src/templates/pages/admin-*.template.ts`
-- Shared layout in `src/templates/layouts/admin-layout-v2.template.ts`
-- Component templates in `src/templates/components/`
-- Route handlers in `src/routes/admin.ts`
+## Admin UI
+
+Glass morphism design system. Reference existing admin templates for patterns:
+- Pages: `packages/core/src/templates/pages/admin-*.template.ts`
+- Layout: `packages/core/src/templates/layouts/admin-layout-v2.template.ts`
+- Components: `packages/core/src/templates/components/`
+- Routes: `packages/core/src/routes/admin.ts`
+
+Use `codegraph_explore` to inspect current patterns before building new pages.