@plures/runebook 0.4.0

package/packages/design-dojo/tokens.css

@@ -0,0 +1,69 @@
+/**
+ * @plures/design-dojo — design tokens
+ *
+ * Defines the global CSS custom properties (design tokens) used across
+ * all Plures applications and components.
+ */
+
+:root {
+  /* ── Surface ───────────────────────────────────────────────── */
+  --surface-1: #1a1a2e;
+  --surface-2: #16213e;
+  --surface-3: #0f3460;
+  --surface-4: #533483;
+
+  /* ── Text ──────────────────────────────────────────────────── */
+  --text-1: #e0e0e0;
+  --text-2: #a0a0b0;
+  --text-3: #606070;
+
+  /* ── Brand / Accent ────────────────────────────────────────── */
+  --brand: #00d4ff;
+  --brand-2: #7b2fff;
+  --accent: #ff6b6b;
+
+  /* ── Status ────────────────────────────────────────────────── */
+  --success: #4caf50;
+  --warning: #ff9800;
+  --error: #f44336;
+  --info: #2196f3;
+
+  /* ── Border ────────────────────────────────────────────────── */
+  --border-color: rgba(255, 255, 255, 0.1);
+  --border-color-strong: rgba(255, 255, 255, 0.25);
+
+  /* ── Spacing ───────────────────────────────────────────────── */
+  --space-1: 0.25rem;
+  --space-2: 0.5rem;
+  --space-3: 1rem;
+  --space-4: 1.5rem;
+  --space-5: 2rem;
+  --space-6: 3rem;
+
+  /* ── Radius ────────────────────────────────────────────────── */
+  --radius-1: 2px;
+  --radius-2: 4px;
+  --radius-3: 8px;
+  --radius-4: 16px;
+  --radius-round: 9999px;
+
+  /* ── Typography ─────────────────────────────────────────────── */
+  --font-sans: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --font-mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', ui-monospace, monospace;
+  --font-size-0: 0.75rem;
+  --font-size-1: 0.875rem;
+  --font-size-2: 1rem;
+  --font-size-3: 1.25rem;
+  --font-size-4: 1.5rem;
+  --font-size-5: 2rem;
+
+  /* ── Shadow ────────────────────────────────────────────────── */
+  --shadow-1: 0 1px 2px rgba(0, 0, 0, 0.4);
+  --shadow-2: 0 4px 8px rgba(0, 0, 0, 0.5);
+  --shadow-3: 0 8px 24px rgba(0, 0, 0, 0.6);
+
+  /* ── Transition ─────────────────────────────────────────────── */
+  --transition-fast: 100ms ease;
+  --transition-base: 200ms ease;
+  --transition-slow: 400ms ease;
+}

package/playwright.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './e2e',
+  retries: process.env.CI ? 1 : 0,
+  use: {
+    trace: 'retain-on-failure',
+    screenshot: 'only-on-failure',
+  },
+  webServer: {
+    command: 'npm run build && npm run preview -- --host 127.0.0.1 --port 4173',
+    port: 4173,
+    reuseExistingServer: !process.env.CI,
+    timeout: 180_000,
+  },
+});

package/scripts/check-versions.cjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Script to verify that all version numbers are synchronized across the project
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function getPackageJsonVersion() {
+  const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+  return pkg.version;
+}
+
+function getCargoTomlVersion() {
+  const cargo = fs.readFileSync('src-tauri/Cargo.toml', 'utf8');
+  const match = cargo.match(/^version = "(.+)"$/m);
+  return match ? match[1] : null;
+}
+
+function getTauriConfVersion() {
+  const config = JSON.parse(fs.readFileSync('src-tauri/tauri.conf.json', 'utf8'));
+  return config.version;
+}
+
+function main() {
+  const packageVersion = getPackageJsonVersion();
+  const cargoVersion = getCargoTomlVersion();
+  const tauriVersion = getTauriConfVersion();
+
+  console.log('Version Check:');
+  console.log('--------------');
+  console.log(`package.json:           ${packageVersion}`);
+  console.log(`src-tauri/Cargo.toml:   ${cargoVersion}`);
+  console.log(`src-tauri/tauri.conf.json: ${tauriVersion}`);
+  console.log('');
+
+  const allMatch = packageVersion === cargoVersion && packageVersion === tauriVersion;
+
+  if (allMatch) {
+    console.log('✅ All versions are synchronized!');
+    process.exit(0);
+  } else {
+    console.error('❌ Version mismatch detected!');
+    console.error('');
+    console.error('Run the following commands to fix:');
+    console.error('1. Update package.json to the correct version');
+    console.error('2. Run: npm install');
+    console.error('3. Run the version-bump workflow from GitHub Actions');
+    process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  try {
+    main();
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { getPackageJsonVersion, getCargoTomlVersion, getTauriConfVersion };

package/scripts/demo.sh

@@ -0,0 +1,220 @@
+#!/usr/bin/env bash
+# RuneBook Ambient Agent Mode - "Zero to Hero" Demo Script
+# This script demonstrates the full workflow from enabling the agent to viewing analysis results
+
+set -e  # Exit on error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Helper functions
+print_step() {
+    echo -e "\n${BLUE}=== $1 ===${NC}\n"
+}
+
+print_success() {
+    echo -e "${GREEN}✓ $1${NC}"
+}
+
+print_error() {
+    echo -e "${RED}✗ $1${NC}"
+}
+
+print_info() {
+    echo -e "${YELLOW}ℹ $1${NC}"
+}
+
+wait_for_user() {
+    echo -e "\n${YELLOW}Press Enter to continue...${NC}"
+    read -r
+}
+
+# Check prerequisites
+check_prerequisites() {
+    print_step "Checking Prerequisites"
+    
+    if ! command -v node &> /dev/null; then
+        print_error "Node.js is not installed"
+        exit 1
+    fi
+    print_success "Node.js found"
+    
+    if ! command -v npm &> /dev/null; then
+        print_error "npm is not installed"
+        exit 1
+    fi
+    print_success "npm found"
+    
+    if ! command -v nix &> /dev/null; then
+        print_warning "Nix is not installed - some demo commands may not work"
+    else
+        print_success "Nix found"
+    fi
+}
+
+# Step 1: Enable Agent
+enable_agent() {
+    print_step "Step 1: Enabling Ambient Agent Mode"
+    
+    print_info "Enabling agent..."
+    npm run agent enable || {
+        print_error "Failed to enable agent"
+        exit 1
+    }
+    print_success "Agent enabled"
+    
+    print_info "Checking agent status..."
+    npm run agent status
+    wait_for_user
+}
+
+# Step 2: Run failing commands
+run_failing_commands() {
+    print_step "Step 2: Running Failing Nix Commands"
+    
+    print_info "These commands will fail intentionally to demonstrate error capture and analysis"
+    
+    # Command 1: Missing attribute
+    print_info "Running: nix build .#cursor (will fail - missing attribute)"
+    nix build .#cursor 2>&1 || true
+    sleep 1
+    
+    # Command 2: Flake-parts template path
+    print_info "Running: nix flake init -t flake-parts#devShells (may fail - template path)"
+    nix flake init -t flake-parts#devShells 2>&1 || true
+    sleep 1
+    
+    # Command 3: Build environment (may fail)
+    print_info "Running: nix build (may fail - build environment)"
+    nix build 2>&1 || true
+    sleep 1
+    
+    print_success "Commands executed (failures are expected)"
+    wait_for_user
+}
+
+# Step 3: View captured events
+view_events() {
+    print_step "Step 3: Viewing Captured Events"
+    
+    print_info "Showing last 10 events..."
+    npm run agent events 10
+    wait_for_user
+}
+
+# Step 4: Analyze last failure
+analyze_failure() {
+    print_step "Step 4: Analyzing Last Failure"
+    
+    print_info "Analyzing the most recent command failure..."
+    npm run analyze last || {
+        print_error "Analysis failed or no failures found"
+        print_info "This is okay if no failures were captured"
+    }
+    wait_for_user
+}
+
+# Step 5: View suggestions
+view_suggestions() {
+    print_step "Step 5: Viewing Suggestions"
+    
+    print_info "Showing all current suggestions..."
+    npm run agent suggestions
+    wait_for_user
+}
+
+# Step 6: Inspect memory (if PluresDB available)
+inspect_memory() {
+    print_step "Step 6: Inspecting Memory Storage"
+    
+    print_info "Attempting to inspect cognitive memory..."
+    npm run memory inspect || {
+        print_info "PluresDB not available - this is okay, using in-memory storage"
+        print_info "To use PluresDB, start it with: pluresdb --port 34567"
+    }
+    wait_for_user
+}
+
+# Step 7: View statistics
+view_statistics() {
+    print_step "Step 7: Viewing Agent Statistics"
+    
+    print_info "Showing agent status and statistics..."
+    npm run agent status
+    wait_for_user
+}
+
+# Step 8: Observer mode (optional)
+observer_demo() {
+    print_step "Step 8: Observer Mode (Optional)"
+    
+    print_info "Enabling observer for detailed event capture..."
+    npm run observer enable || {
+        print_info "Observer enable failed - continuing anyway"
+    }
+    
+    print_info "Showing observer status..."
+    npm run observer status || {
+        print_info "Observer status failed - continuing anyway"
+    }
+    
+    print_info "To tail events in real-time, run: npm run observer events tail"
+    wait_for_user
+}
+
+# Step 9: Cleanup (optional)
+cleanup_demo() {
+    print_step "Step 9: Cleanup (Optional)"
+    
+    print_info "You can clear old events with: npm run agent clear [days]"
+    print_info "Example: npm run agent clear 7  (clears events older than 7 days)"
+    
+    read -p "Clear events now? (y/N): " -n 1 -r
+    echo
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        print_info "Clearing events older than 30 days..."
+        npm run agent clear 30 || {
+            print_error "Failed to clear events"
+        }
+    else
+        print_info "Skipping cleanup"
+    fi
+    wait_for_user
+}
+
+# Main demo flow
+main() {
+    echo -e "${GREEN}"
+    echo "╔════════════════════════════════════════════════════════════╗"
+    echo "║  RuneBook Ambient Agent Mode - Zero to Hero Demo           ║"
+    echo "╚════════════════════════════════════════════════════════════╝"
+    echo -e "${NC}"
+    
+    check_prerequisites
+    enable_agent
+    run_failing_commands
+    view_events
+    analyze_failure
+    view_suggestions
+    inspect_memory
+    view_statistics
+    observer_demo
+    cleanup_demo
+    
+    print_step "Demo Complete!"
+    echo -e "${GREEN}Thank you for trying RuneBook Ambient Agent Mode!${NC}"
+    echo ""
+    echo "Next steps:"
+    echo "  - Read docs/demo.md for detailed walkthrough"
+    echo "  - Check README.md for full feature list"
+    echo "  - Explore ANALYSIS_LADDER.md for analysis details"
+    echo ""
+}
+
+# Run main function
+main
+

package/shell.nix

@@ -0,0 +1,31 @@
+# Development shell for RuneBook
+# Usage: nix-shell
+
+{ pkgs ? import <nixpkgs> {} }:
+
+pkgs.mkShell {
+  buildInputs = with pkgs; [
+    nodejs_20
+    rustc
+    cargo
+    pkg-config
+    openssl
+    webkitgtk_4_1
+    librsvg
+    tauri-cli
+  ];
+
+  shellHook = ''
+    echo "RuneBook Development Environment"
+    echo "Node.js: $(node --version)"
+    echo "Rust: $(rustc --version)"
+    echo ""
+    echo "Available commands:"
+    echo "  npm install    - Install dependencies"
+    echo "  npm run dev    - Start development server"
+    echo "  npm run build  - Build the application"
+    echo "  npm test       - Run tests"
+    echo "  npm run agent  - Run agent CLI"
+  '';
+}
+

package/src/app.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" href="%sveltekit.assets%/favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Tauri + SvelteKit + Typescript App</title>
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>