@polderlabs/bizar 4.0.0 → 4.2.0

package/bizar-dash/tests/memory-protocol-drift.test.mjs

@@ -0,0 +1,45 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = resolve(__dirname, '..', '..');
+
+function read(rel) {
+  return readFileSync(resolve(REPO_ROOT, rel), 'utf8');
+}
+
+test('memory-protocol SKILL.md has MANDATORY framing at the top', () => {
+  const skill = read('config/skills/memory-protocol/SKILL.md');
+  // The "MANDATORY" badge must appear in the first 10 lines
+  const head = skill.split('\n').slice(0, 10).join('\n');
+  assert.match(head, /MANDATORY/, 'memory-protocol/SKILL.md must mark the protocol as MANDATORY in the first 10 lines');
+});
+
+test('AGENT_BASELINE.md section 5 has MANDATORY marker', () => {
+  const baseline = read('config/agents/_shared/AGENT_BASELINE.md');
+  // Find section 5 header and the next 20 lines
+  const section5Idx = baseline.indexOf('## 5.');
+  assert.ok(section5Idx >= 0, 'AGENT_BASELINE.md must have a section 5');
+  const section5Head = baseline.slice(section5Idx, section5Idx + 600);
+  assert.match(section5Head, /MANDATORY/, 'AGENT_BASELINE.md section 5 must mark memory check as MANDATORY');
+});
+
+test('AGENT_BASELINE.md section 13 has mandatory language', () => {
+  const baseline = read('config/agents/_shared/AGENT_BASELINE.md');
+  const section13Idx = baseline.indexOf('## 13.');
+  assert.ok(section13Idx >= 0, 'AGENT_BASELINE.md must have a section 13');
+  const section13Head = baseline.slice(section13Idx, section13Idx + 3000);
+  // Either the ⚠️ ENFORCED marker we just added, or the existing "mandatory, not optional" line
+  const hasMandatory = /MANDATORY/.test(section13Head) || /mandatory, not optional/i.test(section13Head);
+  assert.ok(hasMandatory, 'AGENT_BASELINE.md section 13 must contain MANDATORY framing or the existing "mandatory, not optional" language');
+});
+
+test('AGENT_BASELINE.md session-start bootstrap commands are present', () => {
+  const baseline = read('config/agents/_shared/AGENT_BASELINE.md');
+  // The actual commands agents must run
+  assert.match(baseline, /bizar memory search/, 'AGENT_BASELINE.md must reference `bizar memory search`');
+  assert.match(baseline, /bizar memory status/, 'AGENT_BASELINE.md must reference `bizar memory status`');
+});

package/cli/banner.mjs

@@ -25,7 +25,7 @@ export function showBanner() {
   console.log(chalk.hex('#6366f1').bold(RUNE_HELM));
   console.log(chalk.hex('#a855f7')('    Norse Pantheon Agent System for opencode'));
   console.log();
-  console.log(chalk.dim('    13 agents · 4 cost tiers · Obsidian vault long-term memory · RTK · Semble · Skills CLI · Mods'));
+  console.log(chalk.dim('    13 agents · 4 cost tiers · Obsidian vault long-term memory · Headroom · Semble · Skills CLI · Mods'));
   console.log();
 }
 

package/cli/bin.mjs

@@ -272,7 +272,7 @@ function showDoctorHelp() {
       • plugin path resolves
       • @polderlabs/bizar-plugin is installed globally
       • core agent files are installed (odin, quick, thor, tyr)
-      • rtk / semble / skills on PATH (lenient — at least one)
+      • headroom / semble / skills on PATH (lenient — at least one)
       • dashboard reachable (skipped if no port file)
       • provider.minimax block + MiniMax model flags are sane
 
@@ -491,8 +491,8 @@ function showDashHelp() {
 function showMemoryHelp() {
   console.log(`
   memory <subcommand>   Manage project memory (local-only or Git-shared Obsidian vault)
-                        Subcommands: init, status, link, unlink, pull, commit, push,
-                        sync, reindex, conflicts, doctor
+                        Subcommands: init, setup, status, link, unlink, write, pull, commit,
+                        push, sync, reindex, conflicts, doctor
   `);
 }
 
@@ -643,7 +643,7 @@ async function main() {
     if (isHelpRequest) showInitHelp();
     else await runInit(process.cwd());
   } else if (args[0] === 'memory') {
-    if (isHelpRequest) showMemoryHelp();
+    if (isHelpRequest && !args[1]) showMemoryHelp();
     else {
       const { runMemory } = await import('./memory.mjs');
       await runMemory(args[1], args.slice(2));

package/cli/bootstrap.mjs

@@ -49,7 +49,7 @@ export function checkSetupStatus() {
  */
 function printSetupBanner() {
   // Use console.log directly to avoid chalk formatting issues in non-TTY
-  console.log('\n  ⚡ First-time setup — Bizar needs to install agents, plugin, RTK, Semble, Skills CLI...\n');
+  console.log('\n  ⚡ First-time setup — Bizar needs to install agents, plugin, Headroom, Semble, Skills CLI...\n');
 }
 
 /**

package/cli/copy.mjs

@@ -341,43 +341,49 @@ export async function installPluginBizar(projectRoot) {
   }
 }
 
-export async function installRtk() {
+export async function installHeadroom() {
   const { execSync } = await import('node:child_process');
 
   const already = await detectRtk();
   if (already) {
-    const spinner = ora({ text: 'Configuring RTK for opencode...', color: 'magenta' }).start();
+    const spinner = ora({ text: 'Configuring Headroom for opencode...', color: 'magenta' }).start();
     try {
-      execSync('rtk init -g --opencode', { stdio: 'pipe' });
-      spinner.succeed(chalk.green('RTK configured for opencode'));
+      execSync('headroom wrap opencode', { stdio: 'pipe' });
+      spinner.succeed(chalk.green('Headroom configured for opencode'));
     } catch {
-      spinner.warn(chalk.yellow('Could not auto-configure RTK — run `rtk init -g --opencode` manually'));
+      spinner.warn(chalk.yellow('Could not auto-configure Headroom — run `headroom wrap opencode` manually'));
     }
     return true;
   }
 
-  const spinner = ora({ text: 'Installing RTK (Rust Token Killer)...', color: 'magenta' }).start();
+  const spinner = ora({ text: 'Installing Headroom (context compressor)...', color: 'magenta' }).start();
 
   if (process.platform === 'win32') {
-    // RTK ships a bash-only installer; no PowerShell equivalent. On
-    // Windows the user must install RTK manually (e.g. via Cargo or
-    // prebuilt binary) and re-run `rtk init -g --opencode`.
-    spinner.fail(chalk.red('Automatic RTK install not supported on Windows. Install manually from https://github.com/rtk-ai/rtk'));
+    spinner.fail(chalk.red('Automatic Headroom install not supported on Windows. Install manually: pip install "headroom-ai[all]"'));
     return false;
   }
 
   try {
     execSync(
-      'curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh',
+      'pip install --user "headroom-ai[all]"',
       { stdio: 'pipe', timeout: 60000 },
     );
-    spinner.text = 'Configuring RTK for opencode...';
-    execSync('rtk init -g --opencode', { stdio: 'pipe' });
-    spinner.succeed(chalk.green('RTK installed and configured for opencode'));
+    spinner.text = 'Configuring Headroom for opencode...';
+    execSync('headroom wrap opencode', { stdio: 'pipe' });
+    spinner.succeed(chalk.green('Headroom installed and configured for opencode'));
     return true;
   } catch {
-    spinner.fail(chalk.red('RTK install failed. Install manually from https://github.com/rtk-ai/rtk'));
-    return false;
+    // Fall back to npm
+    try {
+      execSync('npm install -g headroom-ai', { stdio: 'pipe', timeout: 60000 });
+      spinner.text = 'Configuring Headroom for opencode...';
+      execSync('headroom wrap opencode', { stdio: 'pipe' });
+      spinner.succeed(chalk.green('Headroom installed (npm) and configured for opencode'));
+      return true;
+    } catch {
+      spinner.fail(chalk.red('Headroom install failed. Install manually: pip install "headroom-ai[all]" or npm install -g headroom-ai'));
+      return false;
+    }
   }
 }
 

package/cli/doctor.mjs

@@ -9,8 +9,8 @@
  * result without re-printing the per-check output.
  *
  * The checks are intentionally tolerant: missing optional tools
- * (rtk/semble/skills) don't fail the run, and the dashboard check is
- * skipped silently if no port file exists. The goal is "is your
+ * (headroom/semble/skills) don't fail the run, and the dashboard check
+ * is skipped silently if no port file exists. The goal is "is your
  * install healthy?" not "is every conceivable thing present?".
  *
  * Usage:
@@ -187,13 +187,13 @@ async function checkAgentFilesInstalled() {
 }
 
 /**
- * Lenient: passes if at least one of rtk/semble/skills is on PATH.
+ * Lenient: passes if at least one of headroom/semble/skills is on PATH.
  * These are informational — none of them are strictly required for
  * `bizar doctor` to do its job, and missing them shouldn't fail the
  * overall health report.
  */
 async function checkToolsAvailable() {
-  const tools = ['rtk', 'semble', 'skills'];
+  const tools = ['headroom', 'semble', 'skills'];
   const found = tools.filter(which);
   if (found.length === 0) {
     throw new Error(`none of ${tools.join('/')} on PATH`);

package/cli/doctor.test.mjs

@@ -8,7 +8,7 @@
  * tmpdir, and craft the opencode.json + agents/ directory to drive
  * specific pass/fail outcomes. For checks that depend on global
  * npm-installed packages or external CLIs (e.g. opencode --version,
- * npm root -g, which rtk), we accept that they may pass or fail
+ * npm root -g, which headroom), we accept that they may pass or fail
  * depending on the test environment and just verify the framework
  * returns the right shape.
  */
@@ -116,7 +116,7 @@ describe('runDoctor() shape', () => {
 
   test('silent mode suppresses ALL output when nothing fails', async () => {
     // Build a fully healthy environment. We can't make opencode reachable
-    // or rtk installed without modifying PATH, so we settle for: no failures
+    // or headroom installed without modifying PATH, so we settle for: no failures
     // means no output at all. Since we know some checks will fail in a
     // bare tmpdir, this test is structured to assert the negative case
     // differently: we verify silent+no-fail produces 0 lines.

package/cli/init.mjs

@@ -260,10 +260,10 @@ ${stack.runner ? `- Dev: \`${stack.runner}\`` : ''}
             name: 'memoryMode',
             message: 'Memory backend',
             choices: [
-              { name: 'local-only (vault stays in this project at .obsidian/)', value: 'local-only' },
               { name: 'managed (shared user-level repo at ~/.local/share/bizar/memory/bizar-memory/)', value: 'managed' },
+              { name: 'local-only (vault stays in this project at .obsidian/)', value: 'local-only' },
             ],
-            default: 'local-only',
+            default: 'managed',
           }])).memoryMode;
       const memoryMode = initialMode === 'managed' ? 'managed' : 'local-only';
 

package/cli/install.mjs

@@ -5,8 +5,8 @@ import { join } from 'node:path';
 
 import { showBanner, showPantheon, sectionHeading } from './banner.mjs';
 import { promptComponents, promptInstallMode, promptAgents, promptSkillPacks, promptApiKeys, promptConfirmInstall, promptRestartOpenCode } from './prompts.mjs';
-import { detectOpenCode, detectRtk, detectSemble, detectSkillsCli, detectUv, buildSummary, opencodeAgentsDir, opencodeConfigDir, repoPath } from './utils.mjs';
-import { installAgents, installAgentsMd, installSkill, installOpencodeJson, installBizarFolder, installPluginBizar, installRtk, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
+import { detectOpenCode, detectHeadroom, detectSemble, detectSkillsCli, detectUv, buildSummary, opencodeAgentsDir, opencodeConfigDir, repoPath } from './utils.mjs';
+import { installAgents, installAgentsMd, installSkill, installOpencodeJson, installBizarFolder, installPluginBizar, installHeadroom, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
 
 const AGENT_FILES = [
   'odin.md', 'vor.md', 'frigg.md', 'quick.md',
@@ -554,32 +554,37 @@ export async function runPostInstall() {
   }
   console.log('BizarHarness: agents installed.');
 
-  // Install RTK
-  const rtkPresent = await detectRtk();
-  if (!rtkPresent) {
-    console.log('BizarHarness: installing RTK (token optimizer)...');
+  // Install Headroom
+  const headroomPresent = await detectHeadroom();
+  if (!headroomPresent) {
+    console.log('BizarHarness: installing Headroom (context compressor)...');
     try {
       if (process.platform === 'win32') {
-        // RTK ships a bash-only installer; on Windows the user installs it
-        // manually (e.g. `cargo install --git https://github.com/rtk-ai/rtk`).
-        console.log('BizarHarness: RTK bash installer does not run on Windows. Install manually from https://github.com/rtk-ai/rtk');
+        console.log('BizarHarness: Automatic Headroom install not supported on Windows. Install manually: pip install "headroom-ai[all]"');
       } else {
         execSync(
-          'curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh',
+          'pip install --user "headroom-ai[all]"',
           { stdio: 'pipe', timeout: 60000 },
         );
-        execSync('rtk init -g --opencode', { stdio: 'pipe' });
-        console.log('BizarHarness: RTK installed and configured.');
+        execSync('headroom wrap opencode', { stdio: 'pipe' });
+        console.log('BizarHarness: Headroom installed and configured.');
       }
     } catch {
-      console.log('BizarHarness: RTK install failed. Install manually from https://github.com/rtk-ai/rtk');
+      // Fall back to npm
+      try {
+        execSync('npm install -g headroom-ai', { stdio: 'pipe', timeout: 60000 });
+        execSync('headroom wrap opencode', { stdio: 'pipe' });
+        console.log('BizarHarness: Headroom installed (npm) and configured.');
+      } catch {
+        console.log('BizarHarness: Headroom install failed. Install manually: pip install "headroom-ai[all]" or npm install -g headroom-ai');
+      }
     }
   } else {
     try {
-      execSync('rtk init -g --opencode', { stdio: 'pipe' });
-      console.log('BizarHarness: RTK configured for opencode.');
+      execSync('headroom wrap opencode', { stdio: 'pipe' });
+      console.log('BizarHarness: Headroom configured for opencode.');
     } catch {
-      console.log('BizarHarness: could not configure RTK. Run `rtk init -g --opencode` manually.');
+      console.log('BizarHarness: could not configure Headroom. Run `headroom wrap opencode` manually.');
     }
   }