npm - @polderlabs/bizar - Versions diffs - 4.5.0 → 4.5.2 - Mend

@polderlabs/bizar 4.5.0 → 4.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (77) hide show

package/bizar-dash/dist/assets/__vite-browser-external-BIHI7g3E.js +1 -0
package/bizar-dash/dist/assets/__vite-browser-external-BIHI7g3E.js.map +1 -0
package/bizar-dash/dist/assets/main-B4OfGAwz.js +361 -0
package/bizar-dash/dist/assets/main-B4OfGAwz.js.map +1 -0
package/bizar-dash/dist/assets/main-DAlLdW8I.css +1 -0
package/bizar-dash/dist/assets/{mobile--0FBIKX3.js → mobile-BRhoDOUz.js} +1 -2
package/bizar-dash/dist/assets/{mobile--0FBIKX3.js.map → mobile-BRhoDOUz.js.map} +1 -1
package/bizar-dash/dist/assets/{mobile-OgRp8VIb.js → mobile-lbH6szyX.js} +2 -3
package/bizar-dash/dist/assets/mobile-lbH6szyX.js.map +1 -0
package/bizar-dash/dist/index.html +3 -3
package/bizar-dash/dist/mobile.html +2 -2
package/bizar-dash/skills/bizar/SKILL.md +20 -0
package/bizar-dash/skills/headroom/SKILL.md +94 -0
package/bizar-dash/skills/lightrag/SKILL.md +11 -0
package/bizar-dash/skills/obsidian/SKILL.md +13 -0
package/bizar-dash/src/server/api.mjs +6 -0
package/bizar-dash/src/server/headroom.mjs +647 -0
package/bizar-dash/src/server/memory-lightrag.mjs +281 -6
package/bizar-dash/src/server/memory-obsidian.mjs +230 -0
package/bizar-dash/src/server/memory-store.mjs +151 -0
package/bizar-dash/src/server/mods-loader.mjs +13 -5
package/bizar-dash/src/server/providers-store.mjs +73 -1
package/bizar-dash/src/server/routes/_shared.mjs +17 -0
package/bizar-dash/src/server/routes/chat.mjs +38 -0
package/bizar-dash/src/server/routes/headroom.mjs +126 -0
package/bizar-dash/src/server/routes/lightrag.mjs +6 -2
package/bizar-dash/src/server/routes/memory.mjs +439 -4
package/bizar-dash/src/server/schedules-runner.mjs +4 -4
package/bizar-dash/src/server/server.mjs +55 -37
package/bizar-dash/src/server/watcher.mjs +2 -2
package/bizar-dash/src/web/App.tsx +42 -6
package/bizar-dash/src/web/components/HeadroomSettings.tsx +418 -0
package/bizar-dash/src/web/components/HeadroomStatus.tsx +158 -0
package/bizar-dash/src/web/components/Toast.tsx +1 -1
package/bizar-dash/src/web/components/Topbar.tsx +3 -1
package/bizar-dash/src/web/lib/api.ts +12 -11
package/bizar-dash/src/web/lib/types.ts +16 -0
package/bizar-dash/src/web/main.tsx +1 -0
package/bizar-dash/src/web/styles/chat.css +2 -0
package/bizar-dash/src/web/styles/main.css +52 -23
package/bizar-dash/src/web/styles/memory.css +955 -0
package/bizar-dash/src/web/styles/tasks.css +2 -0
package/bizar-dash/src/web/views/Memory.tsx +141 -0
package/bizar-dash/src/web/views/MiniMaxUsage.tsx +3 -2
package/bizar-dash/src/web/views/Overview.tsx +7 -2
package/bizar-dash/src/web/views/Settings.tsx +32 -1
package/bizar-dash/src/web/views/Skills.tsx +3 -2
package/bizar-dash/src/web/views/Tasks.tsx +4 -3
package/bizar-dash/src/web/views/memory/ConfigPanel.tsx +289 -0
package/bizar-dash/src/web/views/memory/GitSyncPanel.tsx +220 -0
package/bizar-dash/src/web/views/memory/LightragPanel.tsx +307 -0
package/bizar-dash/src/web/views/memory/MemoryOverview.tsx +356 -0
package/bizar-dash/src/web/views/memory/MemoryStatusCard.tsx +160 -0
package/bizar-dash/src/web/views/memory/ObsidianPanel.tsx +642 -0
package/bizar-dash/src/web/views/memory/SemanticSearchPanel.tsx +194 -0
package/bizar-dash/tests/cli-bugfixes.test.mjs +151 -0
package/bizar-dash/tests/frontend-bugfixes.test.mjs +151 -0
package/bizar-dash/tests/headroom-install.test.mjs +173 -0
package/bizar-dash/tests/headroom-settings.test.mjs +126 -0
package/bizar-dash/tests/headroom-status.test.mjs +117 -0
package/bizar-dash/tests/memory-lightrag-extended.test.mjs +162 -0
package/bizar-dash/tests/memory-obsidian.test.mjs +269 -0
package/bizar-dash/tests/memory-tab.test.mjs +322 -0
package/bizar-dash/tests/mod-upgrade.node.test.mjs +1 -1
package/bizar-dash/tests/server-bugfixes.test.mjs +318 -0
package/bizar-dash/tests/submit-feedback.test.mjs +6 -6
package/cli/artifact.mjs +11 -4
package/cli/bin.mjs +211 -12
package/cli/doctor.mjs +5 -3
package/cli/memory.mjs +65 -21
package/cli/provision.mjs +8 -2
package/install.sh +1 -2
package/package.json +3 -3
package/bizar-dash/dist/assets/main-CDFKHzBg.css +0 -1
package/bizar-dash/dist/assets/main-NYFpS2wY.js +0 -312
package/bizar-dash/dist/assets/main-NYFpS2wY.js.map +0 -1
package/bizar-dash/dist/assets/mobile-OgRp8VIb.js.map +0 -1

package/bizar-dash/dist/index.html CHANGED Viewed

@@ -29,10 +29,10 @@
         }
       })();
     </script>
-    <script type="module" crossorigin src="/assets/main-NYFpS2wY.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/mobile-OgRp8VIb.js">
+    <script type="module" crossorigin src="/assets/main-B4OfGAwz.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/mobile-lbH6szyX.js">
     <link rel="stylesheet" crossorigin href="/assets/mobile-CsZQAswA.css">
-    <link rel="stylesheet" crossorigin href="/assets/main-CDFKHzBg.css">
+    <link rel="stylesheet" crossorigin href="/assets/main-DAlLdW8I.css">
   </head>
   <body>
     <div id="root"></div>

package/bizar-dash/dist/mobile.html CHANGED Viewed

@@ -12,8 +12,8 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link rel="stylesheet" href="https://rsms.me/inter/inter.css" />
-    <script type="module" crossorigin src="/assets/mobile--0FBIKX3.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/mobile-OgRp8VIb.js">
+    <script type="module" crossorigin src="/assets/mobile-BRhoDOUz.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/mobile-lbH6szyX.js">
     <link rel="stylesheet" crossorigin href="/assets/mobile-CsZQAswA.css">
   </head>
   <body>

package/bizar-dash/skills/bizar/SKILL.md CHANGED Viewed

@@ -74,6 +74,26 @@ export MINIMAX_API_KEY_3="third-key"
 Rotation triggers on 429 (rate limit), 402 (quota exhausted), 500/502/503/504 (server error). Does NOT trigger on 401 (unauthorized - fix the key).
+## Headroom
+The Bizar dashboard manages Headroom through Settings → Headroom. To check status:
+```bash
+bizar headroom status
+bizar headroom stats
+bizar headroom install
+bizar headroom wrap
+```
+Or via the dashboard API:
+- `GET /api/headroom/status` — live status
+- `GET /api/headroom/stats` — compression stats
+- `POST /api/headroom/install` — install headroom
+- `POST /api/headroom/wrap` — wrap opencode
+- `POST /api/headroom/proxy/start` — start proxy
+Headroom is a context compression layer that sits between opencode and LLM providers, compressing tool outputs, logs, RAG chunks, and conversation history by 60–95%.
 ## Troubleshooting
 ### Odin Self-Handles Instead of Routing

package/bizar-dash/skills/headroom/SKILL.md ADDED Viewed

@@ -0,0 +1,94 @@
+---
+name: headroom
+description: Headroom — context compression layer for AI agents. Routes opencode and other LLM clients through a local proxy that compresses tool outputs, logs, RAG chunks, and conversation history by 60–95%.
+---
+# Headroom
+Headroom is a context compression layer that sits between opencode (or any LLM client) and the upstream provider. It intercepts tool call outputs, conversation history, and RAG chunks and compresses them before they reach the model — typically reducing token usage by 60–95% with no loss in answer quality.
+## When to Use
+- **Token budget is tight**: If a task is approaching the context window limit, Headroom can reclaim 60–90% of the tokens spent on tool outputs.
+- **Long conversations**: The compression is cumulative — the longer the session, the more Headroom saves.
+- **Verbose tool output**: RAG retrieval, file globbing, grep results, and diagnostic output are the highest-value compression targets.
+- **Multi-step implementation**: Large features with many tool calls benefit most.
+## Architecture
+```
+opencode → headroom proxy (localhost:8787) → LLM provider
+             ↓
+        compresses tool outputs, logs, RAG chunks
+        caches responses
+        measures savings
+```
+## Key Concepts
+### Compression ratio
+The fraction of tokens Headroom eliminates. A 0.85 compression ratio means 85% of the tokens were removed before reaching the provider.
+### Wrapped vs unwrapped
+`headroom wrap opencode` modifies `~/.config/opencode/opencode.json` to route traffic through the proxy. `headroom unwrap opencode` restores the original configuration.
+### Proxy vs wrap
+- **Proxy** (`headroom proxy`): The actual HTTP proxy server running on port 8787.
+- **Wrap** (`headroom wrap opencode`): The act of configuring opencode to use the proxy.
+You can run the proxy standalone (`headroom proxy`) and point any OpenAI-compatible client at it. The wrap command is just a convenience for opencode.
+## Dashboard Integration
+The Bizar dashboard manages Headroom through Settings → Headroom:
+- **Status widget**: Shows live proxy status, compression ratio, tokens saved
+- **Controls**: Install, wrap/unwrap, start/stop proxy, open dashboard
+- **Settings**: Auto-install, auto-start, auto-wrap, route-all-providers, port, host, backend, output shaper, telemetry, budget
+API endpoints:
+- `GET /api/headroom/status` — live status
+- `GET /api/headroom/stats?hours=24` — compression statistics
+- `POST /api/headroom/install` — install headroom
+- `POST /api/headroom/wrap` — wrap opencode
+- `POST /api/headroom/unwrap` — unwrap opencode
+- `POST /api/headroom/proxy/start` — start proxy
+- `POST /api/headroom/proxy/stop` — stop proxy
+- `POST /api/headroom/auto-route` — configure all providers to route through the proxy
+CLI:
+```bash
+bizar headroom status   # live status
+bizar headroom stats    # compression stats
+bizar headroom install  # install headroom
+bizar headroom wrap     # wrap opencode
+bizar headroom unwrap   # unwrap
+bizar headroom start    # start proxy
+bizar headroom stop     # stop proxy
+bizar headroom doctor   # health check
+```
+## Environment Variables
+| Variable | Default | Description |
+|---|---|---|
+| `HEADROOM_HOST` | `127.0.0.1` | Proxy bind host |
+| `HEADROOM_PORT` | `8787` | Proxy port |
+| `HEADROOM_OUTPUT_SHAPER` | `0` | Set to `1` to enable output shaping |
+| `HEADROOM_TELEMETRY` | (on) | Set to `off` to disable |
+| `HEADROOM_BUDGET` | `0` | Monthly USD cap (0 = unlimited) |
+| `HEADROOM_CONTEXT_TOOL` | `rtk` | Context tool: `rtk` or `lean-ctx` |
+## Common Gotchas
+1. **Proxy must be running before opencode starts**: If the proxy is down when opencode launches, opencode will fail to make LLM calls. Start the proxy first, or enable `autoStart` in Headroom settings.
+2. **`headroom wrap` edits opencode.json**: The wrap command modifies `~/.config/opencode/opencode.json`. If you use version control for this file, you'll see a diff on every wrap. Use `headroom unwrap` before committing, or ignore the changes.
+3. **Headroom 0.30.0 doesn't have `headroom plan --tokens`**: This command was removed. Use `headroom perf --hours 24` for actual token savings data.
+4. **Token savings are cumulative**: The compression ratio compounds over a session. A 15-step implementation that saves 80% at each step uses roughly the same tokens as a 3-step implementation without Headroom.
+5. **Cache hits**: Headroom caches semantically similar tool calls. Repeated operations (file reads, API probes) can be served from cache entirely, bypassing the LLM.
+6. **Provider baseURL**: When `routeAllProviders` is enabled, the dashboard rewrites provider baseURLs to point at the proxy. If you configure a new provider manually, you may need to update its baseURL to go through the proxy.

package/bizar-dash/skills/lightrag/SKILL.md CHANGED Viewed

@@ -66,6 +66,17 @@ When both Obsidian vault and LightRAG are configured:
 | Related concepts discovery | LightRAG search |
 | Precise location of text | grep + read |
+## Memory tab in the dashboard (v4.7.0+)
+The dashboard's **Memory** tab (sidebar entry between Skills and Settings) surfaces LightRAG controls without leaving the browser:
+- **LightRAG panel** — Start / Stop / Restart / Reindex all / Rebuild graph. Rebuild graph wipes the working dir and re-runs a full reindex (idempotent — safe to re-run).
+- **Stats** — Approximate indexed-chunk count (from `kv_store_*.json`), query count last 24h, and average response time. Stats are tracked in a sidecar JSONL at `<project>/.bizar/memory-cache/lightrag-query-log.jsonl`.
+- **Quick search** — Sends `GET /api/memory/query?q=...&topK=8` and shows the raw LightRAG response.
+- **Semantic search panel** — Cross-source search: runs both LightRAG and Obsidian vault lexical search and merges results, deduped by (source, relPath).
+Open the tab by setting `activeTab = 'memory'` or via the Overview's Memory status card. The LightRAG stats are fetched via `GET /api/memory/lightrag/stats`; the rebuild path uses `POST /api/memory/lightrag/rebuild-graph`.
 ## Common Issues
 ### Empty search results

package/bizar-dash/skills/obsidian/SKILL.md CHANGED Viewed

@@ -48,6 +48,19 @@ Use the memory service to find relevant context before making non-trivial decisi
 When LightRAG is enabled (v4.5.0+), it indexes vault content automatically. Query with `bizar memory search` - this routes to LightRAG for natural-language queries. For simple lookups, direct file reading is faster.
+## Memory tab in the dashboard (v4.7.0+)
+The dashboard has a dedicated **Memory** tab (sidebar entry between Skills and Settings) for working with the vault without leaving the browser:
+- **Overview** — composite health score (vault + LightRAG + git + secrets + schema), with one-click navigation to each subsystem.
+- **Obsidian Vault** — folder tree on the left, note list (newest first), detail pane with body + frontmatter + backlinks. Inline create / edit (markdown editor modal) / delete.
+- **LightRAG** — Start / Stop / Restart / Reindex all / Rebuild graph. Quick search sends a natural-language query and shows the LightRAG response.
+- **Git Sync** — branch / ahead / behind / dirty / clean pills, working-tree diff, Pull / Push / Commit / Fetch + sync.
+- **Semantic Search** — single search input that queries both LightRAG and the Obsidian vault in one shot. Results deduplicated by (source, relPath) and sorted by score.
+- **Config** — grouped forms for LightRAG URL/models, Obsidian path/syncInterval, git repo/remote/branch/autoSync, plus a "Test git connection" button.
+Open the tab programmatically by setting `activeTab = 'memory'`. The Overview page now also surfaces a small Memory status card (health score + LightRAG + vault + git) with a single-click jump.
 ## Common Gotchas
 - The vault is git-tracked but not auto-committed. Commit after meaningful knowledge additions.

package/bizar-dash/src/server/api.mjs CHANGED Viewed

@@ -53,6 +53,7 @@ import { createMiscRouter } from './routes/misc.mjs';
 import { createEnvVarsRouter } from './routes/env-vars.mjs';
 import { createUpdateRouter } from './routes/update.mjs';
 import { createUsageRouter } from './routes/usage.mjs';
+import { createHeadroomRouter } from './routes/headroom.mjs';
 /**
  * @param {object} deps
@@ -132,6 +133,11 @@ export async function createApiRouter({
   router.use(createArtifactsRouter({ state, broadcast, projectRoot }));
   router.use(createMinimaxRouter({ state, broadcast }));
   router.use(createUsageRouter());
+  // v5.0.0 — Headroom context compression endpoints.
+  // Mounted at /api/headroom/* so the mount-prefix stripping works correctly.
+  // Each route handler inside the router is at its bare path (e.g. '/status'),
+  // which becomes '/api/headroom/status' at the top level.
+  router.use('/headroom', createHeadroomRouter());
   router.use(createMiscRouter({ state, broadcast }));
   // /api/auth/* must be reachable WITHOUT the bearer token so a fresh