@soleri/cli 9.8.0 → 9.10.0

package/dist/commands/vault.js

@@ -0,0 +1,66 @@
+/**
+ * Vault CLI — export vault entries as browsable markdown files.
+ *
+ * `soleri vault export`                     — export to ./knowledge/vault/
+ * `soleri vault export --path ~/obsidian`   — export to custom directory
+ * `soleri vault export --domain arch`       — filter by domain
+ */
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { detectAgent } from '../utils/agent-context.js';
+import * as log from '../utils/logger.js';
+import { SOLERI_HOME } from '@soleri/core';
+export function registerVault(program) {
+    const vault = program.command('vault').description('Vault knowledge management');
+    vault
+        .command('export')
+        .description('Export vault entries as browsable markdown files')
+        .option('--path <dir>', 'Output directory (default: ./knowledge/)')
+        .option('--domain <name>', 'Filter by domain')
+        .action(async (opts) => {
+        const agent = detectAgent();
+        if (!agent) {
+            log.fail('Not in a Soleri agent project', 'Run from an agent directory');
+            process.exit(1);
+        }
+        const outputDir = opts.path ? resolve(opts.path) : resolve('knowledge');
+        // Find vault DB — check new path first, then legacy
+        const newDbPath = join(SOLERI_HOME, agent.agentId, 'vault.db');
+        const legacyDbPath = join(SOLERI_HOME, '..', `.${agent.agentId}`, 'vault.db');
+        const vaultDbPath = existsSync(newDbPath)
+            ? newDbPath
+            : existsSync(legacyDbPath)
+                ? legacyDbPath
+                : null;
+        if (!vaultDbPath) {
+            log.fail('Vault DB not found', 'Run the agent once to initialize its vault database.');
+            process.exit(1);
+        }
+        // Dynamic import to avoid loading better-sqlite3 unless needed
+        const { Vault } = await import('@soleri/core');
+        const vaultInstance = new Vault(vaultDbPath);
+        try {
+            log.heading('Vault Export');
+            if (opts.domain) {
+                const { syncEntryToMarkdown } = await import('@soleri/core');
+                const entries = vaultInstance.list({ limit: 10000, domain: opts.domain });
+                let synced = 0;
+                for (const entry of entries) {
+                    await syncEntryToMarkdown(entry, outputDir);
+                    synced++;
+                }
+                log.pass(`Exported ${synced} entries from domain "${opts.domain}"`, `${outputDir}/vault/`);
+            }
+            else {
+                const { syncAllToMarkdown } = await import('@soleri/core');
+                const result = await syncAllToMarkdown(vaultInstance, outputDir);
+                log.pass(`Exported ${result.synced} entries (${result.skipped} unchanged)`, `${outputDir}/vault/`);
+            }
+        }
+        finally {
+            vaultInstance.close();
+        }
+    });
+}
+//# sourceMappingURL=vault.js.map

package/dist/commands/vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/commands/vault.ts"],"names":[],"mappings":"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"}

package/dist/hook-packs/rtk/README.md

@@ -0,0 +1,31 @@
+# RTK Hook Pack
+
+Reduces LLM token usage by 60-90% by routing shell commands through [RTK](https://github.com/rtk-ai/rtk), a Rust-based CLI proxy that compresses verbose command output.
+
+## How it works
+
+A PreToolUse hook intercepts Bash commands and rewrites them through RTK:
+
+```
+git status  →  rtk git status  →  "M 3 files" (instead of 15 lines)
+npm test    →  rtk npm test    →  "2 failed" (instead of 200+ lines)
+```
+
+RTK supports 70+ commands across git, JS/TS, Python, Go, Ruby, Docker, and file operations.
+
+## Prerequisites
+
+- [RTK](https://github.com/rtk-ai/rtk) >= 0.23.0 (`brew install rtk-ai/tap/rtk` or `cargo install rtk`)
+- `jq` (usually pre-installed on macOS/Linux)
+
+## Install
+
+```bash
+soleri hooks add-pack rtk
+```
+
+## Uninstall
+
+```bash
+soleri hooks remove-pack rtk
+```

package/dist/hook-packs/rtk/manifest.json

@@ -0,0 +1,24 @@
+{
+  "name": "rtk",
+  "version": "1.0.0",
+  "description": "RTK token compression — rewrites shell commands through RTK proxy to reduce LLM token usage by 60-90%",
+  "hooks": [],
+  "scripts": [
+    {
+      "name": "rtk-rewrite",
+      "file": "rtk-rewrite.sh",
+      "targetDir": "hooks"
+    }
+  ],
+  "lifecycleHooks": [
+    {
+      "event": "PreToolUse",
+      "matcher": "Bash",
+      "type": "command",
+      "command": "sh ~/.claude/hooks/rtk-rewrite.sh",
+      "timeout": 10,
+      "statusMessage": "RTK: compressing output..."
+    }
+  ],
+  "scaffoldDefault": false
+}

package/dist/hook-packs/rtk/scripts/rtk-rewrite.sh

@@ -0,0 +1,70 @@
+#!/bin/sh
+# RTK Rewrite — PreToolUse command rewriter (Soleri Hook Pack: rtk)
+# Intercepts Bash commands and rewrites them through RTK proxy for token compression.
+# RTK (https://github.com/rtk-ai/rtk) reduces LLM token usage by 60-90%.
+# Dependencies: jq, rtk (>= 0.23.0)
+# POSIX sh compatible.
+
+set -eu
+
+# ── Dependency checks ──────────────────────────────────────────────
+
+WARN_FLAG="${HOME}/.soleri/.rtk-warned"
+
+warn_once() {
+  # Warn at most once per day (86400 seconds)
+  if [ -f "$WARN_FLAG" ]; then
+    # Get file mtime — try macOS stat, then Linux stat, fallback to 0
+    FILE_MTIME=0
+    if stat -f %m "$WARN_FLAG" >/dev/null 2>&1; then
+      FILE_MTIME=$(stat -f %m "$WARN_FLAG")
+    elif stat -c %Y "$WARN_FLAG" >/dev/null 2>&1; then
+      FILE_MTIME=$(stat -c %Y "$WARN_FLAG")
+    fi
+    NOW=$(date +%s)
+    WARN_AGE=$(( NOW - FILE_MTIME ))
+    [ "$WARN_AGE" -lt 86400 ] && return
+  fi
+  mkdir -p "$(dirname "$WARN_FLAG")"
+  echo "$1" >&2
+  touch "$WARN_FLAG"
+}
+
+if ! command -v jq >/dev/null 2>&1; then
+  warn_once "[soleri:rtk] jq not found — RTK hook disabled. Install: https://stedolan.github.io/jq/"
+  exit 0
+fi
+
+if ! command -v rtk >/dev/null 2>&1; then
+  warn_once "[soleri:rtk] rtk not found — RTK hook disabled. Install: https://github.com/rtk-ai/rtk"
+  exit 0
+fi
+
+# ── Read stdin JSON ────────────────────────────────────────────────
+
+INPUT=$(cat)
+
+# Extract command from Claude Code PreToolUse JSON
+CMD=$(printf '%s' "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null)
+if [ -z "$CMD" ]; then
+  exit 0
+fi
+
+# ── Rewrite via RTK ────────────────────────────────────────────────
+
+# Ask RTK if it can compress this command.
+# Exit codes: 0 = rewritten, 1 = no match (pass through), 2+ = error
+REWRITTEN=$(rtk rewrite "$CMD" 2>/dev/null) || exit 0
+
+# If RTK returned empty or same command, pass through
+if [ -z "$REWRITTEN" ] || [ "$REWRITTEN" = "$CMD" ]; then
+  exit 0
+fi
+
+# ── Return rewritten command ───────────────────────────────────────
+
+# Build updatedInput from original tool_input with rewritten command
+UPDATED_INPUT=$(printf '%s' "$INPUT" | jq -c --arg cmd "$REWRITTEN" '.tool_input | .command = $cmd')
+
+# Output Claude Code hookSpecificOutput contract
+printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow","permissionDecisionReason":"RTK token compression","updatedInput":%s}}' "$UPDATED_INPUT"

package/dist/main.js

@@ -1,4 +1,9 @@
 #!/usr/bin/env node
+const [major] = process.versions.node.split('.').map(Number);
+if (major < 18) {
+    console.error(`\n  Soleri requires Node.js 18 or later.\n  You have v${process.versions.node}.\n  Upgrade at https://nodejs.org\n`);
+    process.exit(1);
+}
 import { createRequire } from 'node:module';
 import { Command } from 'commander';
 import { registerCreate } from './commands/create.js';
@@ -20,6 +25,7 @@ import { registerSkills } from './commands/skills.js';
 import { registerAgent } from './commands/agent.js';
 import { registerTelegram } from './commands/telegram.js';
 import { registerStaging } from './commands/staging.js';
+import { registerVault } from './commands/vault.js';
 import { registerYolo } from './commands/yolo.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
@@ -76,6 +82,7 @@ registerSkills(program);
 registerAgent(program);
 registerTelegram(program);
 registerStaging(program);
+registerVault(program);
 registerYolo(program);
 program.parse();
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/cli",
-  "version": "9.8.0",
+  "version": "9.10.0",
   "description": "Developer CLI for creating and managing Soleri AI agents.",
   "keywords": [
     "agent",

package/src/__tests__/hook-packs.test.ts

@@ -23,9 +23,9 @@ describe('hook-packs', () => {
   });
 
   describe('registry', () => {
-    it('should list all 9 built-in packs', () => {
+    it('should list all 10 built-in packs', () => {
       const packs = listPacks();
-      expect(packs.length).toBe(9);
+      expect(packs.length).toBe(10);
       const names = packs.map((p) => p.name).sort();
       expect(names).toEqual([
         'a11y',
@@ -34,6 +34,7 @@ describe('hook-packs', () => {
         'flock-guard',
         'full',
         'marketing-research',
+        'rtk',
         'safety',
         'typescript-safety',
         'yolo-safety',
@@ -263,4 +264,64 @@ describe('hook-packs', () => {
       expect(installed).toContain('yolo-safety');
     });
   });
+
+  describe('rtk pack', () => {
+    it('should get rtk pack with script and lifecycle hook', () => {
+      const pack = getPack('rtk');
+      expect(pack).not.toBeNull();
+      expect(pack!.manifest.name).toBe('rtk');
+      expect(pack!.manifest.hooks).toEqual([]);
+      expect(pack!.manifest.scripts).toHaveLength(1);
+      expect(pack!.manifest.scripts![0].name).toBe('rtk-rewrite');
+      expect(pack!.manifest.scripts![0].file).toBe('rtk-rewrite.sh');
+      expect(pack!.manifest.scripts![0].targetDir).toBe('hooks');
+      expect(pack!.manifest.lifecycleHooks).toHaveLength(1);
+      expect(pack!.manifest.lifecycleHooks![0].event).toBe('PreToolUse');
+      expect(pack!.manifest.lifecycleHooks![0].matcher).toBe('Bash');
+      expect(pack!.manifest.lifecycleHooks![0].command).toBe('sh ~/.claude/hooks/rtk-rewrite.sh');
+    });
+
+    it('should install rtk pack with script and lifecycle hook', () => {
+      const result = installPack('rtk');
+      expect(result.installed).toEqual([]);
+      expect(result.scripts).toHaveLength(1);
+      expect(result.scripts[0]).toBe('hooks/rtk-rewrite.sh');
+      expect(result.lifecycleHooks).toHaveLength(1);
+      expect(result.lifecycleHooks[0]).toBe('PreToolUse:Bash');
+      const claudeDir = join(tempHome, '.claude');
+      expect(existsSync(join(claudeDir, 'hooks', 'rtk-rewrite.sh'))).toBe(true);
+      const settings = JSON.parse(readFileSync(join(claudeDir, 'settings.json'), 'utf-8'));
+      expect(settings.hooks.PreToolUse).toHaveLength(1);
+      expect(settings.hooks.PreToolUse[0].matcher).toBe('Bash');
+      expect(settings.hooks.PreToolUse[0].hooks[0].command).toBe(
+        'sh ~/.claude/hooks/rtk-rewrite.sh',
+      );
+      expect(settings.hooks.PreToolUse[0]._soleriPack).toBe('rtk');
+    });
+
+    it('should remove rtk pack including script and lifecycle hook', () => {
+      installPack('rtk');
+      const result = removePack('rtk');
+      expect(result.scripts).toHaveLength(1);
+      expect(result.lifecycleHooks).toHaveLength(1);
+      const claudeDir = join(tempHome, '.claude');
+      expect(existsSync(join(claudeDir, 'hooks', 'rtk-rewrite.sh'))).toBe(false);
+      const settings = JSON.parse(readFileSync(join(claudeDir, 'settings.json'), 'utf-8'));
+      expect(settings.hooks.PreToolUse).toBeUndefined();
+    });
+
+    it('should be idempotent for rtk lifecycle hooks', () => {
+      installPack('rtk');
+      const result2 = installPack('rtk');
+      expect(result2.lifecycleHooks).toEqual([]);
+      const claudeDir = join(tempHome, '.claude');
+      const settings = JSON.parse(readFileSync(join(claudeDir, 'settings.json'), 'utf-8'));
+      expect(settings.hooks.PreToolUse).toHaveLength(1);
+    });
+
+    it('should not be scaffoldDefault', () => {
+      const pack = getPack('rtk');
+      expect(pack!.manifest.scaffoldDefault).toBe(false);
+    });
+  });
 });

package/src/__tests__/install.test.ts

@@ -0,0 +1,88 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdirSync, rmSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { toPosix } from '../commands/install.js';
+
+// Mock @clack/prompts to suppress console output during tests
+vi.mock('@clack/prompts', () => ({
+  log: {
+    success: vi.fn(),
+    error: vi.fn(),
+    warn: vi.fn(),
+    info: vi.fn(),
+  },
+}));
+
+describe('toPosix', () => {
+  it('converts backslashes to forward slashes', () => {
+    expect(toPosix('C:\\Users\\foo\\agent.yaml')).toBe('C:/Users/foo/agent.yaml');
+  });
+
+  it('leaves forward slashes unchanged', () => {
+    expect(toPosix('/home/user/agent.yaml')).toBe('/home/user/agent.yaml');
+  });
+
+  it('handles mixed separators', () => {
+    expect(toPosix('C:\\Users/foo\\bar/agent.yaml')).toBe('C:/Users/foo/bar/agent.yaml');
+  });
+
+  it('handles empty string', () => {
+    expect(toPosix('')).toBe('');
+  });
+});
+
+describe('installClaude path normalization', () => {
+  let tempDir: string;
+  let originalHome: string;
+
+  beforeEach(() => {
+    tempDir = join(tmpdir(), `cli-install-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+    originalHome = process.env.HOME ?? '';
+    // Point homedir() to our temp dir so ~/.claude.json lands there
+    process.env.HOME = tempDir;
+    // Windows uses USERPROFILE instead of HOME
+    process.env.USERPROFILE = tempDir;
+  });
+
+  afterEach(() => {
+    process.env.HOME = originalHome;
+    if (originalHome) process.env.USERPROFILE = originalHome;
+    rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it('should not contain backslashes in written config paths (file-tree agent)', async () => {
+    // Dynamic import to pick up the mocked homedir
+    const { installClaude } = await import('../commands/install.js');
+
+    // Simulate a Windows-style path
+    const fakeAgentDir = 'C:\\Users\\testuser\\my-agent';
+    installClaude('test-agent', fakeAgentDir, true);
+
+    const configPath = join(tempDir, '.claude.json');
+    const raw = readFileSync(configPath, 'utf-8');
+
+    // The raw JSON should not contain any backslash-based paths
+    // (backslashes in JSON would appear as \\ in the raw string)
+    const config = JSON.parse(raw);
+    const entry = config.mcpServers['test-agent'];
+    for (const arg of entry.args as string[]) {
+      expect(arg).not.toContain('\\');
+    }
+  });
+
+  it('should not contain backslashes in written config paths (legacy agent)', async () => {
+    const { installClaude } = await import('../commands/install.js');
+
+    const fakeAgentDir = 'C:\\Users\\testuser\\my-agent';
+    installClaude('test-agent', fakeAgentDir, false);
+
+    const configPath = join(tempDir, '.claude.json');
+    const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    const entry = config.mcpServers['test-agent'];
+    for (const arg of entry.args as string[]) {
+      expect(arg).not.toContain('\\');
+    }
+  });
+});

package/src/__tests__/rtk-rewrite.test.ts

@@ -0,0 +1,223 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { execSync, spawnSync } from 'node:child_process';
+import { join, dirname } from 'node:path';
+import { mkdtempSync, rmSync, existsSync, symlinkSync, readdirSync, mkdirSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+
+const SCRIPTS_DIR = join(__dirname, '..', 'hook-packs', 'rtk', 'scripts');
+const SCRIPT = join(SCRIPTS_DIR, 'rtk-rewrite.sh').replace(/\\/g, '/');
+
+function makePayload(command: string, extra?: Record<string, unknown>): string {
+  return JSON.stringify({
+    tool_name: 'Bash',
+    tool_input: { command, ...extra },
+  });
+}
+
+function runHook(
+  command: string,
+  extra?: Record<string, unknown>,
+): { stdout: string; stderr: string; exitCode: number } {
+  try {
+    const payload = makePayload(command, extra);
+    const result = execSync(`printf '%s' '${payload.replace(/'/g, "'\\''")}' | sh '${SCRIPT}'`, {
+      encoding: 'utf-8',
+      stdio: 'pipe',
+    });
+    return { stdout: result, stderr: '', exitCode: 0 };
+  } catch (err: any) {
+    return { stdout: err.stdout ?? '', stderr: err.stderr ?? '', exitCode: err.status ?? 1 };
+  }
+}
+
+// RTK and jq must be installed to run these tests.
+const hasRtk = (() => {
+  try {
+    execSync('command -v rtk', { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+})();
+
+const hasJq = (() => {
+  try {
+    execSync('command -v jq', { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+})();
+
+const isWindows = process.platform === 'win32';
+
+describe.skipIf(isWindows || !hasRtk || !hasJq)('rtk-rewrite hook script', () => {
+  it('rewrites git status to rtk git status', () => {
+    const { stdout, exitCode } = runHook('git status');
+    expect(exitCode).toBe(0);
+    expect(stdout.trim()).not.toBe('');
+
+    const output = JSON.parse(stdout.trim());
+    expect(output.hookSpecificOutput).toBeDefined();
+    expect(output.hookSpecificOutput.hookEventName).toBe('PreToolUse');
+    expect(output.hookSpecificOutput.permissionDecision).toBe('allow');
+    expect(output.hookSpecificOutput.updatedInput).toBeDefined();
+    expect(output.hookSpecificOutput.updatedInput.command).toBe('rtk git status');
+  });
+
+  it('preserves original tool_input fields in updatedInput', () => {
+    const { stdout } = runHook('git diff', { description: 'Show diff', timeout: 60000 });
+    const output = JSON.parse(stdout.trim());
+    expect(output.hookSpecificOutput.updatedInput.description).toBe('Show diff');
+    expect(output.hookSpecificOutput.updatedInput.timeout).toBe(60000);
+    expect(output.hookSpecificOutput.updatedInput.command).toBe('rtk git diff');
+  });
+
+  it('passes through non-rewritable commands (exit 0, no output)', () => {
+    const { stdout, exitCode } = runHook('echo hello');
+    expect(exitCode).toBe(0);
+    expect(stdout.trim()).toBe('');
+  });
+
+  it('passes through empty command', () => {
+    const { stdout, exitCode } = runHook('');
+    expect(exitCode).toBe(0);
+    expect(stdout.trim()).toBe('');
+  });
+
+  it('rewrites ls commands', () => {
+    const { stdout } = runHook('ls -la');
+    const output = JSON.parse(stdout.trim());
+    expect(output.hookSpecificOutput.updatedInput.command).toMatch(/^rtk (ls|read)/);
+  });
+
+  it('rewrites git log commands', () => {
+    const { stdout } = runHook('git log --oneline -5');
+    const output = JSON.parse(stdout.trim());
+    expect(output.hookSpecificOutput.updatedInput.command).toContain('rtk git log');
+  });
+});
+
+/**
+ * Build a PATH string that excludes specific commands by creating shadow
+ * directories with symlinks to everything except the hidden commands.
+ */
+function buildPathWithout(hide: string[]): string {
+  const originalDirs = (process.env.PATH || '').split(':');
+  const resultDirs: string[] = [];
+
+  for (const dir of originalDirs) {
+    if (!existsSync(dir)) continue;
+
+    // Check if this dir contains any of the commands we want to hide
+    const hasHidden = hide.some((cmd) => existsSync(join(dir, cmd)));
+
+    if (!hasHidden) {
+      resultDirs.push(dir);
+      continue;
+    }
+
+    // Create a shadow dir with symlinks to everything except hidden commands
+    const shadowDir = mkdtempSync(join(tmpdir(), 'rtk-shadow-'));
+    shadowDirsToCleanup.push(shadowDir);
+
+    try {
+      const entries = readdirSync(dir);
+      for (const entry of entries) {
+        if (hide.includes(entry)) continue;
+        const src = join(dir, entry);
+        const dst = join(shadowDir, entry);
+        try {
+          symlinkSync(src, dst);
+        } catch {
+          // Skip entries that fail (broken symlinks, permission issues)
+        }
+      }
+    } catch {
+      // If we can't read the dir, skip it
+      continue;
+    }
+
+    resultDirs.push(shadowDir);
+  }
+
+  return resultDirs.join(':');
+}
+
+// Track shadow dirs for cleanup
+let shadowDirsToCleanup: string[] = [];
+
+describe.skipIf(isWindows)('rtk-rewrite dependency warnings', () => {
+  let tempHome: string;
+
+  beforeEach(() => {
+    tempHome = mkdtempSync(join(tmpdir(), 'rtk-warn-test-'));
+    shadowDirsToCleanup = [];
+  });
+
+  afterEach(() => {
+    rmSync(tempHome, { recursive: true, force: true });
+    for (const d of shadowDirsToCleanup) {
+      rmSync(d, { recursive: true, force: true });
+    }
+    shadowDirsToCleanup = [];
+  });
+
+  function runWithMissingDep(hide: string[]): {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+  } {
+    const payload = makePayload('git status');
+    const restrictedPath = buildPathWithout(hide);
+
+    const result = spawnSync(
+      'sh',
+      ['-c', `printf '%s' '${payload.replace(/'/g, "'\\''")}' | sh '${SCRIPT}'`],
+      {
+        encoding: 'utf-8',
+        stdio: 'pipe',
+        env: {
+          PATH: restrictedPath,
+          HOME: tempHome,
+          TERM: process.env.TERM || 'xterm',
+        },
+      },
+    );
+
+    return {
+      stdout: result.stdout ?? '',
+      stderr: result.stderr ?? '',
+      exitCode: result.status ?? 1,
+    };
+  }
+
+  it('warns on stderr when jq is missing', () => {
+    const { stdout, stderr, exitCode } = runWithMissingDep(['jq']);
+    expect(exitCode).toBe(0);
+    expect(stdout.trim()).toBe('');
+    expect(stderr).toContain('[soleri:rtk] jq not found');
+    expect(stderr).toContain('RTK hook disabled');
+  });
+
+  it('warns on stderr when rtk is missing', () => {
+    if (!hasJq) return; // jq must be present for the rtk check to be reached
+    const { stdout, stderr, exitCode } = runWithMissingDep(['rtk']);
+    expect(exitCode).toBe(0);
+    expect(stdout.trim()).toBe('');
+    expect(stderr).toContain('[soleri:rtk] rtk not found');
+    expect(stderr).toContain('RTK hook disabled');
+  });
+
+  it('suppresses warning on second run within same day', () => {
+    // First run — should warn
+    const first = runWithMissingDep(['jq']);
+    expect(first.exitCode).toBe(0);
+    expect(first.stderr).toContain('[soleri:rtk] jq not found');
+
+    // Second run — flag file exists and is fresh, should suppress
+    const second = runWithMissingDep(['jq']);
+    expect(second.exitCode).toBe(0);
+    expect(second.stderr.trim()).toBe('');
+  });
+});

package/src/__tests__/scaffold-git-e2e.test.ts

@@ -53,6 +53,10 @@ describe('scaffold + git init (E2E)', () => {
     const initResult = await gitInit(agentDir);
     expect(initResult.ok).toBe(true);
 
+    // Ensure git config is set (CI runners may not have global user.name/user.email)
+    gitCommand(agentDir, 'config', 'user.name', 'Test');
+    gitCommand(agentDir, 'config', 'user.email', 'test@test.local');
+
     const commitResult = await gitInitialCommit(agentDir, 'feat: scaffold agent "test-agent"');
     expect(commitResult.ok).toBe(true);
 
@@ -80,6 +84,9 @@ describe('scaffold + git init (E2E)', () => {
     const agentDir = result.agentDir;
 
     await gitInit(agentDir);
+    // Ensure git config is set (CI runners may not have global user.name/user.email)
+    gitCommand(agentDir, 'config', 'user.name', 'Test');
+    gitCommand(agentDir, 'config', 'user.email', 'test@test.local');
     await gitInitialCommit(agentDir, 'feat: scaffold agent "test-agent"');
 
     const trackedFiles = gitCommand(agentDir, 'ls-files');