@plures/runebook 0.4.0

package/integrations/nvim-runebook.lua

@@ -0,0 +1,140 @@
+-- RuneBook Neovim plugin (Lua version)
+-- Place this file in ~/.config/nvim/lua/runebook.lua or ~/.config/nvim/plugin/runebook.lua
+
+local M = {}
+
+local status_file = vim.fn.expand('~/.runebook/agent-status.json')
+local suggestions_file = vim.fn.expand('~/.runebook/suggestions.json')
+
+-- Simple JSON parser for reading status (minimal implementation)
+local function read_json_file(filepath)
+  local file = io.open(filepath, 'r')
+  if not file then
+    return nil
+  end
+  
+  local content = file:read('*all')
+  file:close()
+  
+  -- Use vim.json if available (Neovim 0.10+)
+  if vim.json then
+    local ok, data = pcall(vim.json.decode, content)
+    if ok then
+      return data
+    end
+  end
+  
+  -- Fallback: simple parsing for status field
+  local status = content:match('"status"%s*:%s*"([^"]*)"')
+  local high_priority = content:match('"highPriorityCount"%s*:%s*([0-9]+)')
+  local suggestion_count = content:match('"suggestionCount"%s*:%s*([0-9]+)')
+  
+  if status then
+    return {
+      status = status,
+      highPriorityCount = high_priority and tonumber(high_priority) or 0,
+      suggestionCount = suggestion_count and tonumber(suggestion_count) or 0,
+    }
+  end
+  
+  return nil
+end
+
+-- Get top suggestion
+function M.get_top_suggestion()
+  local file = io.open(suggestions_file, 'r')
+  if not file then
+    return nil
+  end
+  
+  local content = file:read('*all')
+  file:close()
+  
+  -- Use vim.json if available
+  if vim.json then
+    local ok, data = pcall(vim.json.decode, content)
+    if ok and data.suggestions and #data.suggestions > 0 then
+      -- Sort by priority and return top
+      table.sort(data.suggestions, function(a, b)
+        local priority_order = { high = 3, medium = 2, low = 1 }
+        local a_prio = priority_order[a.priority] or 0
+        local b_prio = priority_order[b.priority] or 0
+        if a_prio ~= b_prio then
+          return a_prio > b_prio
+        end
+        return a.timestamp > b.timestamp
+      end)
+      return data.suggestions[1]
+    end
+  end
+  
+  -- Fallback: simple extraction
+  local title = content:match('"title"%s*:%s*"([^"]*)"')
+  local priority = content:match('"priority"%s*:%s*"([^"]*)"')
+  
+  if title then
+    return {
+      title = title,
+      priority = priority or 'low',
+    }
+  end
+  
+  return nil
+end
+
+-- Show suggestion in command line
+function M.show_suggestion()
+  local suggestion = M.get_top_suggestion()
+  if not suggestion then
+    vim.notify('No suggestions available', vim.log.levels.INFO)
+    return
+  end
+  
+  local symbol = suggestion.priority == 'high' and '⚠' 
+              or suggestion.priority == 'medium' and '▲' 
+              or '•'
+  
+  local text = string.format('%s %s', symbol, suggestion.title)
+  if suggestion.description then
+    text = text .. '\n' .. suggestion.description
+  end
+  
+  vim.notify(text, vim.log.levels.INFO, { title = 'RuneBook Suggestion' })
+end
+
+-- Display in virtual text (optional)
+function M.update_virtual_text()
+  if not vim.api.nvim_buf_is_valid(0) then
+    return
+  end
+  
+  local ns = vim.api.nvim_create_namespace('runebook')
+  vim.api.nvim_buf_clear_namespace(0, ns, 0, -1)
+  
+  local suggestion = M.get_top_suggestion()
+  if suggestion then
+    local symbol = suggestion.priority == 'high' and '⚠' 
+                or suggestion.priority == 'medium' and '▲' 
+                or '•'
+    local text = string.format('%s %s', symbol, suggestion.title)
+    
+    -- Show at end of first line
+    vim.api.nvim_buf_set_extmark(0, ns, 0, -1, {
+      virt_text = {{ text, 'Comment' }},
+      virt_text_pos = 'eol',
+    })
+  end
+end
+
+-- Create command
+vim.api.nvim_create_user_command('RunebookSuggestion', M.show_suggestion, {
+  desc = 'Show RuneBook suggestion',
+})
+
+-- Optional: Auto-update virtual text on buffer enter
+-- vim.api.nvim_create_autocmd('BufEnter', {
+--   callback = M.update_virtual_text,
+-- })
+
+return M
+

package/integrations/tmux-status.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# RuneBook tmux status line integration
+# Add this to your ~/.tmux.conf:
+#   set -g status-right '#(bash ~/.runebook/integrations/tmux-status.sh)'
+
+RUNebook_CLI="${RUNebook_CLI:-runebook}"
+STATUS_FILE="$HOME/.runebook/agent-status.json"
+
+if [ ! -f "$STATUS_FILE" ]; then
+  echo ""
+  exit 0
+fi
+
+# Read status from JSON file
+STATUS=$(cat "$STATUS_FILE" 2>/dev/null | grep -o '"status":"[^"]*"' | cut -d'"' -f4)
+SUGGESTION_COUNT=$(cat "$STATUS_FILE" 2>/dev/null | grep -o '"suggestionCount":[0-9]*' | cut -d':' -f2)
+HIGH_PRIORITY=$(cat "$STATUS_FILE" 2>/dev/null | grep -o '"highPriorityCount":[0-9]*' | cut -d':' -f2)
+
+if [ -z "$STATUS" ]; then
+  echo ""
+  exit 0
+fi
+
+case "$STATUS" in
+  "idle")
+    SYMBOL="●"
+    COLOR="#[fg=green]"
+    ;;
+  "analyzing")
+    SYMBOL="⟳"
+    COLOR="#[fg=yellow]"
+    ;;
+  "issues_found")
+    SYMBOL="⚠"
+    COLOR="#[fg=red]"
+    if [ -n "$HIGH_PRIORITY" ] && [ "$HIGH_PRIORITY" -gt 0 ]; then
+      TEXT="${HIGH_PRIORITY}"
+    fi
+    ;;
+  *)
+    echo ""
+    exit 0
+    ;;
+esac
+
+if [ -z "$TEXT" ]; then
+  TEXT=""
+fi
+
+echo "${COLOR}${SYMBOL}${TEXT}#[fg=default]"
+

package/integrations/vim-runebook.vim

@@ -0,0 +1,77 @@
+" RuneBook Vim/Neovim plugin
+" Minimal plugin to display last suggestion
+" Place this file in ~/.vim/plugin/ or ~/.config/nvim/plugin/
+
+if exists('g:loaded_runebook')
+  finish
+endif
+let g:loaded_runebook = 1
+
+let s:status_file = expand('~/.runebook/agent-status.json')
+let s:suggestions_file = expand('~/.runebook/suggestions.json')
+
+" Get top suggestion
+function! s:GetTopSuggestion()
+  if !filereadable(s:suggestions_file)
+    return ''
+  endif
+  
+  try
+    let content = readfile(s:suggestions_file)
+    let json_str = join(content, '')
+    " Simple JSON parsing for suggestions array
+    " This is a minimal implementation - for production, use a proper JSON parser
+    let suggestions = matchstr(json_str, '"suggestions"\s*:\s*\[.*\]')
+    if empty(suggestions)
+      return ''
+    endif
+    
+    " Extract first suggestion title (simplified)
+    let title = matchstr(suggestions, '"title"\s*:\s*"\([^"]*\)"', 0, 1)
+    let priority = matchstr(suggestions, '"priority"\s*:\s*"\([^"]*\)"', 0, 1)
+    
+    if empty(title)
+      return ''
+    endif
+    
+    let symbol = priority ==# 'high' ? '⚠' : priority ==# 'medium' ? '▲' : '•'
+    return symbol . ' ' . title
+  catch
+    return ''
+  endtry
+endfunction
+
+" Display suggestion in command line
+function! RunebookShowSuggestion()
+  let suggestion = s:GetTopSuggestion()
+  if empty(suggestion)
+    echo 'No suggestions available'
+  else
+    echo suggestion
+  endif
+endfunction
+
+" Command to show suggestion
+command! RunebookSuggestion call RunebookShowSuggestion()
+
+" Optional: Show suggestion in virtual text (Neovim only)
+if has('nvim')
+  function! s:UpdateVirtualText()
+    if !exists('b:runebook_ns')
+      let b:runebook_ns = nvim_create_namespace('runebook')
+    endif
+    
+    " Clear existing virtual text
+    call nvim_buf_clear_namespace(0, b:runebook_ns, 0, -1)
+    
+    let suggestion = s:GetTopSuggestion()
+    if !empty(suggestion)
+      " Show at end of first line
+      call nvim_buf_set_virtual_text(0, b:runebook_ns, 0, [[suggestion, 'Comment']], {})
+    endif
+  endfunction
+  
+  " Auto-update on buffer enter (optional)
+  " autocmd BufEnter * call s:UpdateVirtualText()
+endif
+

package/integrations/wezterm-status-simple.lua

@@ -0,0 +1,48 @@
+-- RuneBook WezTerm right-status integration (simplified version)
+-- Add this to your ~/.config/wezterm/wezterm.lua:
+--
+--   wezterm.on('update-right-status', function(window, pane)
+--     local status_file = wezterm.home_dir .. '/.runebook/agent-status.json'
+--     local file = io.open(status_file, 'r')
+--     if not file then
+--       window:set_right_status('')
+--       return
+--     end
+--     
+--     local content = file:read('*all')
+--     file:close()
+--     
+--     -- Simple JSON parsing (for status field only)
+--     local status = content:match('"status"%s*:%s*"([^"]*)"')
+--     local high_priority = content:match('"highPriorityCount"%s*:%s*([0-9]+)')
+--     
+--     local symbol = ''
+--     local color = ''
+--     local text = ''
+--     
+--     if status == 'idle' then
+--       symbol = '●'
+--       color = '#00ff00'
+--     elseif status == 'analyzing' then
+--       symbol = '⟳'
+--       color = '#ffff00'
+--     elseif status == 'issues_found' then
+--       symbol = '⚠'
+--       color = '#ff0000'
+--       if high_priority then
+--         text = high_priority
+--       end
+--     end
+--     
+--     if symbol ~= '' then
+--       window:set_right_status(wezterm.format({
+--         { Foreground = { Color = color } },
+--         { Text = symbol .. text },
+--         { Foreground = { Color = '#ffffff' } },
+--         { Text = ' ' },
+--       }))
+--     else
+--       window:set_right_status('')
+--     end
+--   end)
+

package/integrations/wezterm-status.lua

@@ -0,0 +1,76 @@
+-- RuneBook WezTerm right-status integration
+-- Add this to your ~/.config/wezterm/wezterm.lua:
+--   local runebook_status = require('integrations/wezterm-status')
+--   config.set_wezterm_config(runebook_status)
+
+local wezterm = require 'wezterm'
+local json = require 'json'
+
+local function get_agent_status()
+  local status_file = wezterm.home_dir .. '/.runebook/agent-status.json'
+  local file = io.open(status_file, 'r')
+  
+  if not file then
+    return nil
+  end
+  
+  local content = file:read('*all')
+  file:close()
+  
+  local ok, data = pcall(json.decode, content)
+  if not ok then
+    return nil
+  end
+  
+  return data
+end
+
+local function format_status(status_data)
+  if not status_data then
+    return ''
+  end
+  
+  local status = status_data.status or 'idle'
+  local symbol = ''
+  local color = ''
+  local text = ''
+  
+  if status == 'idle' then
+    symbol = '●'
+    color = '#00ff00'
+  elseif status == 'analyzing' then
+    symbol = '⟳'
+    color = '#ffff00'
+  elseif status == 'issues_found' then
+    symbol = '⚠'
+    color = '#ff0000'
+    local high_priority = status_data.highPriorityCount or 0
+    if high_priority > 0 then
+      text = tostring(high_priority)
+    end
+  end
+  
+  if symbol == '' then
+    return ''
+  end
+  
+  return wezterm.format({
+    { Foreground = { Color = color } },
+    { Text = symbol .. text },
+    { Foreground = { Color = '#ffffff' } },
+    { Text = ' ' },
+  })
+end
+
+wezterm.on('update-right-status', function(window, pane)
+  local status_data = get_agent_status()
+  local status_text = format_status(status_data)
+  
+  window:set_right_status(status_text)
+end)
+
+return {
+  get_agent_status = get_agent_status,
+  format_status = format_status,
+}
+

package/nixos-module.nix

@@ -0,0 +1,156 @@
+{ config, lib, pkgs, ... }:
+
+with lib;
+
+let
+  cfg = config.services.runebook-agent;
+  
+  # Configuration file path
+  configDir = "/var/lib/runebook-agent";
+  configFile = "${configDir}/agent-config.json";
+  observerConfigFile = "${configDir}/observer-config.json";
+  
+  # Service script
+  serviceScript = pkgs.writeShellScript "runebook-agent-service" ''
+    #!/usr/bin/env bash
+    set -euo pipefail
+    
+    # Ensure config directory exists
+    mkdir -p ${configDir}
+    
+    # Initialize config files if they don't exist
+    if [ ! -f ${configFile} ]; then
+      cat > ${configFile} <<EOF
+    {
+      "enabled": ${if cfg.enable then "true" else "false"},
+      "captureEvents": ${if cfg.captureEvents then "true" else "false"},
+      "analyzePatterns": ${if cfg.analyzePatterns then "true" else "false"},
+      "suggestImprovements": ${if cfg.suggestImprovements then "true" else "false"},
+      "storagePath": "${cfg.dataDir}",
+      "maxEvents": ${toString cfg.maxEvents},
+      "retentionDays": ${toString cfg.retentionDays}
+    }
+    EOF
+    fi
+    
+    if [ ! -f ${observerConfigFile} ]; then
+      cat > ${observerConfigFile} <<EOF
+    {
+      "enabled": ${if cfg.enable then "true" else "false"},
+      "redactSecrets": true,
+      "usePluresDB": false,
+      "chunkSize": 4096,
+      "maxEvents": ${toString cfg.maxEvents},
+      "retentionDays": ${toString cfg.retentionDays},
+      "storagePath": "${cfg.dataDir}"
+    }
+    EOF
+    fi
+    
+    # Set up environment
+    export HOME=${configDir}
+    export XDG_CONFIG_HOME=${configDir}
+    export XDG_DATA_HOME=${configDir}
+    
+    # Inject secrets from environment/agenix/sops if available
+    # OpenAI key must be provided via environment variable
+    if [ -n "''${OPENAI_API_KEY:-}" ]; then
+      export OPENAI_API_KEY
+    fi
+    
+    # Run the agent in background mode
+    # Note: The actual agent runs as a shell hook, so this service
+    # mainly ensures the configuration is set up correctly.
+    # For a true background service, you would need to implement
+    # a daemon mode in the CLI.
+    
+    # For now, we'll just ensure the config is ready
+    # The agent will be activated via shell hooks when enabled
+    exec sleep infinity
+  '';
+  
+in {
+  options.services.runebook-agent = {
+    enable = mkEnableOption "RuneBook agent service";
+    
+    captureEvents = mkOption {
+      type = types.bool;
+      default = true;
+      description = "Enable event capture";
+    };
+    
+    analyzePatterns = mkOption {
+      type = types.bool;
+      default = true;
+      description = "Enable pattern analysis";
+    };
+    
+    suggestImprovements = mkOption {
+      type = types.bool;
+      default = true;
+      description = "Enable suggestion generation";
+    };
+    
+    dataDir = mkOption {
+      type = types.str;
+      default = "/var/lib/runebook-agent/data";
+      description = "Data directory for agent storage";
+    };
+    
+    maxEvents = mkOption {
+      type = types.int;
+      default = 10000;
+      description = "Maximum number of events to store";
+    };
+    
+    retentionDays = mkOption {
+      type = types.int;
+      default = 30;
+      description = "Number of days to retain events";
+    };
+    
+    openaiApiKey = mkOption {
+      type = types.nullOr types.str;
+      default = null;
+      description = ''
+        OpenAI API key (if using LLM features).
+        WARNING: This will be stored in the Nix store if set here.
+        Prefer using environment variables, agenix, or sops-nix instead.
+      '';
+    };
+  };
+  
+  config = mkIf cfg.enable {
+    systemd.user.services.runebook-agent = {
+      description = "RuneBook Agent Service";
+      wantedBy = [ "default.target" ];
+      
+      serviceConfig = {
+        Type = "simple";
+        ExecStart = "${serviceScript}";
+        Restart = "on-failure";
+        RestartSec = "5s";
+        
+        # Security settings
+        PrivateTmp = true;
+        ProtectSystem = "strict";
+        ProtectHome = "read-only";
+        ReadWritePaths = [ configDir cfg.dataDir ];
+        
+        # Environment
+        Environment = [
+          "HOME=${configDir}"
+          "XDG_CONFIG_HOME=${configDir}"
+          "XDG_DATA_HOME=${configDir}"
+        ] ++ optional (cfg.openaiApiKey != null) "OPENAI_API_KEY=${cfg.openaiApiKey}";
+      };
+    };
+    
+    # Create data directory
+    systemd.tmpfiles.rules = [
+      "d ${configDir} 0755 root root -"
+      "d ${cfg.dataDir} 0755 root root -"
+    ];
+  };
+}
+

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@plures/runebook",
+  "version": "0.4.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/plures/runebook.git"
+  },
+  "bugs": {
+    "url": "https://github.com/plures/runebook/issues"
+  },
+  "homepage": "https://github.com/plures/runebook#readme",
+  "description": "A reactive, canvas-native computing environment that merges terminals, notebooks, and web components",
+  "type": "module",
+  "keywords": [
+    "tauri",
+    "svelte",
+    "desktop-app",
+    "reactive",
+    "canvas",
+    "terminal",
+    "notebook",
+    "workflow",
+    "visual-programming",
+    "node-based"
+  ],
+  "author": "Plures",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+    "tauri": "tauri",
+    "version:check": "node scripts/check-versions.cjs",
+    "agent": "tsx src/cli/index.ts",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "test:e2e": "playwright test",
+    "test:all": "npm run test && npm run test:e2e"
+  },
+  "bin": {
+    "runebook": "./dist/cli/index.js"
+  },
+  "license": "MIT",
+  "workspaces": [
+    "packages/*"
+  ],
+  "dependencies": {
+    "@plures/design-dojo": "^0.1.0",
+    "@plures/praxis": "^1.2.13",
+    "@tauri-apps/api": "^2.9.1",
+    "@tauri-apps/plugin-opener": "^2.5.2",
+    "@types/js-yaml": "^4.0.9",
+    "js-yaml": "^4.1.1",
+    "pluresdb": "^1.3.1"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.50.1",
+    "@sveltejs/adapter-static": "^3.0.10",
+    "@sveltejs/kit": "^2.49.2",
+    "@sveltejs/vite-plugin-svelte": "^6.2.1",
+    "@tauri-apps/cli": "^2.9.6",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "svelte": "^5.46.1",
+    "svelte-check": "^4.3.5",
+    "tsx": "^4.7.0",
+    "typescript": "~5.6.3",
+    "vite": "^6.4.1",
+    "vitest": "^2.0.0"
+  }
+}

package/packages/design-dojo/index.js

@@ -0,0 +1,4 @@
+/**
+ * @plures/design-dojo
+ * Design tokens and UI component library for the Plures ecosystem.
+ */

package/packages/design-dojo/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@plures/design-dojo",
+  "version": "0.1.0",
+  "description": "Design tokens and UI component library for the Plures ecosystem",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./tokens.css": "./tokens.css"
+  },
+  "files": [
+    "index.js",
+    "tokens.css"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}