stream_weaver 0.3.0

data/examples/advanced/examples_browser.rb

@@ -0,0 +1,394 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# StreamWeaver Examples Browser
+# Browse, view, and run StreamWeaver examples with syntax highlighting.
+#
+# Run with: streamweaver showcase
+# (Or: ruby examples/advanced/examples_browser.rb)
+
+require_relative "../../lib/stream_weaver"
+
+# Source identifier for tracking apps in service
+SOURCE = "examples_browser"
+
+# Track loaded apps: file_path => app_id (for edit-replace and cleanup)
+LOADED_APPS = {}
+
+# Cleanup all loaded apps on exit
+at_exit do
+  next if LOADED_APPS.empty?
+  puts "\nCleaning up #{LOADED_APPS.size} loaded example(s)..."
+  Object.new.extend(StreamWeaver::ServiceClient).clear_source_via_service(SOURCE)
+end
+
+# Helper module for example discovery
+module ExamplesBrowser
+  include StreamWeaver::ServiceClient
+  require 'fileutils'
+
+  EXAMPLES_ROOT = File.expand_path("../../", __FILE__)
+  PLAYGROUND_ROOT = File.expand_path("../../../examples_playground", __FILE__)
+
+  # Skip the browser itself to avoid inception
+  SKIP_FILES = ["examples_browser.rb"].freeze
+
+  # Directory display order and descriptions
+  DIRECTORIES = {
+    basic: "Basic",
+    agentic: "Agentic",
+    components: "Components",
+    layout: "Layout",
+    styling: "Styling",
+    advanced: "Advanced"
+  }.freeze
+
+  def ensure_playground_exists
+    return if File.directory?(PLAYGROUND_ROOT)
+    FileUtils.cp_r(EXAMPLES_ROOT, PLAYGROUND_ROOT)
+    # Remove the browser itself from playground
+    FileUtils.rm_f(File.join(PLAYGROUND_ROOT, "advanced/examples_browser.rb"))
+  end
+
+  def playground_path(dir_key, filename)
+    File.join(PLAYGROUND_ROOT, dir_key.to_s, filename)
+  end
+
+  def original_path(dir_key, filename)
+    File.join(EXAMPLES_ROOT, dir_key.to_s, filename)
+  end
+
+  def reset_file(dir_key, filename)
+    src = original_path(dir_key, filename)
+    dst = playground_path(dir_key, filename)
+    FileUtils.cp(src, dst)
+  end
+
+  def discover_examples
+    DIRECTORIES.map do |dir_key, label|
+      dir_path = File.join(EXAMPLES_ROOT, dir_key.to_s)
+      next unless File.directory?(dir_path)
+
+      files = Dir.glob(File.join(dir_path, "*.rb"))
+        .map { |f| File.basename(f) }
+        .reject { |f| SKIP_FILES.include?(f) }
+        .sort
+
+      { key: dir_key, label: label, files: files }
+    end.compact
+  end
+
+  def read_file(dir_key, filename)
+    ensure_playground_exists
+    path = playground_path(dir_key, filename)
+    return "" unless File.exist?(path)
+    File.read(path)
+  end
+
+  def file_path(dir_key, filename)
+    ensure_playground_exists
+    playground_path(dir_key, filename)
+  end
+
+  def check_syntax(code)
+    require 'open3'
+    temp_file = "/tmp/sw_syntax_check_#{Process.pid}.rb"
+    File.write(temp_file, code)
+
+    stdout, stderr, status = Open3.capture3("ruby", "-c", temp_file)
+    File.delete(temp_file) rescue nil
+
+    if status.success?
+      { ok: true, message: "Syntax OK" }
+    else
+      error = stderr.gsub(temp_file, "example.rb")
+      { ok: false, message: error.strip }
+    end
+  end
+
+  # Uses ServiceClient for: service_port, open_in_browser, remove_app_via_service
+
+  def run_example_via_service(file_path, name: nil)
+    expanded_path = File.expand_path(file_path)
+
+    # Remove old version if same file was already loaded (edit-replace)
+    if LOADED_APPS[expanded_path]
+      remove_app_via_service(LOADED_APPS[expanded_path][:app_id])
+      LOADED_APPS.delete(expanded_path)
+    end
+
+    # Load via ServiceClient
+    result = load_app_via_service(expanded_path, source: SOURCE, name: name)
+
+    if result[:ok]
+      # Track for cleanup and edit-replace
+      LOADED_APPS[expanded_path] = {
+        app_id: result[:app_id],
+        aliased_url: result[:aliased_url]
+      }
+    end
+
+    result
+  end
+
+  def save_file(dir_key, filename, content)
+    ensure_playground_exists
+    path = playground_path(dir_key, filename)
+    File.write(path, content)
+    { ok: true, message: "Saved #{filename}" }
+  rescue => e
+    { ok: false, message: "Failed to save: #{e.message}" }
+  end
+
+  def all_dir_keys
+    DIRECTORIES.keys
+  end
+end
+
+# CodeMirror 5 CDN URLs
+CODEMIRROR_CSS = "https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.css"
+CODEMIRROR_JS = "https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.js"
+CODEMIRROR_RUBY = "https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/mode/ruby/ruby.min.js"
+
+generated_app = app(
+  "Example Playground",
+  layout: :fluid,
+  theme: :default,
+  stylesheets: [CODEMIRROR_CSS],
+  scripts: [CODEMIRROR_JS, CODEMIRROR_RUBY],
+  components: [ExamplesBrowser]
+) do
+  # Initialize state - derive examples fresh each time (not stored in session)
+  examples = discover_examples
+  state[:expanded_dirs] ||= [:basic]
+  state[:selected_dir] ||= :basic
+  state[:selected_file] ||= examples.first&.dig(:files)&.first
+  state[:error_modal_open] ||= false
+  state[:error_message] ||= ""
+
+  # Track which file is loaded to detect file changes
+  # Only read from file when selection changes (not on every request!)
+  # This preserves edited content when clicking Save/Run/Check
+  loaded_key = "#{state[:selected_dir]}/#{state[:selected_file]}"
+
+  if state[:selected_dir] && state[:selected_file]
+    state[:current_file_path] = file_path(state[:selected_dir], state[:selected_file])
+
+    # Only read from file when selection changes OR content is empty (recovery from bad session state)
+    if state[:loaded_file_key] != loaded_key || state[:code_content].to_s.strip.empty?
+      state[:code_content] = read_file(state[:selected_dir], state[:selected_file])
+      state[:loaded_file_key] = loaded_key
+      # Clear stale status from previous session
+      state[:save_ok] = nil
+      state[:syntax_ok] = nil
+      state[:reset_ok] = nil
+    end
+  else
+    state[:current_file_path] = nil
+    state[:code_content] = ""
+    state[:loaded_file_key] = nil
+  end
+
+  # Main layout
+  div style: "display: flex; gap: 20px;" do
+    # Sidebar - file browser (Finder-style)
+    div style: "width: 220px; flex-shrink: 0;" do
+      # Expand/Collapse all buttons
+      div style: "display: flex; gap: 4px; margin-bottom: 8px;" do
+        small_btn = "padding: 4px 8px; font-size: 11px; background: #fff; border: 1px solid #ccc; border-radius: 4px; cursor: pointer; color: #666;"
+        button "Expand All", style: small_btn do |s|
+          s[:expanded_dirs] = all_dir_keys
+        end
+        button "Collapse All", style: small_btn do |s|
+          s[:expanded_dirs] = []
+        end
+      end
+
+      div style: "background: #f5f5f5; border: 1px solid #e0e0e0; border-radius: 6px; padding: 8px;" do
+        examples.each do |dir|
+          is_expanded = state[:expanded_dirs].include?(dir[:key])
+          disclosure = is_expanded ? "▾" : "▸"
+
+          # Folder row (clickable to expand/collapse)
+          folder_style = "display: block !important; padding: 6px 8px !important; cursor: pointer !important; border-radius: 4px !important; font-weight: 500 !important; color: #333 !important; font-size: 13px !important; border: none !important; background: transparent !important; width: 100% !important; text-align: left !important;"
+          folder_label = "#{disclosure} 📁 #{dir[:label]} (#{dir[:files].length})"
+          button folder_label, style: folder_style do |s|
+            if s[:expanded_dirs].include?(dir[:key])
+              s[:expanded_dirs] = s[:expanded_dirs] - [dir[:key]]
+            else
+              s[:expanded_dirs] = s[:expanded_dirs] + [dir[:key]]
+            end
+          end
+
+          # File list (if expanded)
+          if is_expanded
+            div do
+              dir[:files].each do |filename|
+                is_selected = state[:selected_dir] == dir[:key] && state[:selected_file] == filename
+                bg_color = is_selected ? "#d4e5f7" : "transparent"
+                text_color = is_selected ? "#333" : "#555"
+                file_style = "display: block !important; padding: 5px 8px 5px 28px !important; cursor: pointer !important; border-radius: 4px !important; color: #{text_color} !important; background: #{bg_color} !important; font-size: 13px !important; border: none !important; width: 100% !important; text-align: left !important; overflow: hidden !important; text-overflow: ellipsis !important; white-space: nowrap !important;"
+
+                button filename, style: file_style do |s|
+                  s[:selected_dir] = dir[:key]
+                  s[:selected_file] = filename
+                  # Don't clear last_run_file - keep showing which server is running
+                  s[:syntax_ok] = nil
+                  s[:save_ok] = nil
+                  s[:reset_ok] = nil
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+
+    # Main content
+    div style: "flex: 1; min-width: 0;" do
+      if state[:selected_file]
+        # Header with file path and buttons
+        div style: "display: flex; justify-content: space-between; align-items: center; margin-bottom: 12px;" do
+          div style: "font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, monospace; font-size: 13px; color: #666;" do
+            text "#{state[:selected_dir]}/#{state[:selected_file]}"
+          end
+          div style: "display: flex; gap: 8px;" do
+            secondary_btn = "background: white; border: 1px solid #ccc; color: #333; padding: 8px 16px; border-radius: 6px; font-size: 13px; cursor: pointer;"
+
+            button "Check", style: secondary_btn do |s|
+              result = check_syntax(s[:code_content])
+              if result[:ok]
+                s[:syntax_ok] = true
+                s[:save_ok] = nil
+              else
+                s[:syntax_ok] = false
+                s[:save_ok] = nil
+                s[:error_message] = result[:message]
+                s[:error_modal_open] = true
+              end
+            end
+
+            button "Save", style: secondary_btn do |s|
+              result = check_syntax(s[:code_content])
+              if result[:ok]
+                save_result = save_file(s[:selected_dir], s[:selected_file], s[:code_content])
+                s[:save_ok] = save_result[:ok]
+                s[:syntax_ok] = nil
+              else
+                s[:error_message] = result[:message]
+                s[:error_modal_open] = true
+              end
+            end
+
+            button "Reset", style: secondary_btn do |s|
+              reset_file(s[:selected_dir], s[:selected_file])
+              s[:loaded_file_key] = nil  # Force re-read on next render
+              s[:reset_ok] = true
+              s[:save_ok] = nil
+              s[:syntax_ok] = nil
+            end
+
+            run_btn_style = "background: #CC342D; border: none; color: white; padding: 8px 16px; border-radius: 6px; font-size: 13px; cursor: pointer;"
+            button "▶ Run", style: run_btn_style do |s|
+              result = check_syntax(s[:code_content])
+              if result[:ok]
+                # Auto-save before running so edits take effect
+                save_file(s[:selected_dir], s[:selected_file], s[:code_content])
+                # Load via service API (replaces old version if same file)
+                app_result = run_example_via_service(s[:current_file_path], name: "#{s[:selected_dir]}/#{s[:selected_file]}")
+                if app_result[:ok]
+                  # Auto-open in browser
+                  open_in_browser(app_result[:url])
+                  s[:syntax_ok] = nil
+                  s[:save_ok] = nil
+                else
+                  s[:error_message] = app_result[:error]
+                  s[:error_modal_open] = true
+                end
+              else
+                s[:error_message] = result[:message]
+                s[:error_modal_open] = true
+              end
+            end
+          end
+        end
+
+        # Code editor with syntax highlighting (editable)
+        code_editor :code_content, language: :ruby, readonly: false, height: "500px"
+
+        # Status messages
+        status_style = "margin-top: 8px; padding: 8px 12px; background: #d4edda; color: #155724; border-radius: 4px; font-size: 13px;"
+        if state[:syntax_ok] == true
+          div style: status_style do
+            text "✓ Syntax OK"
+          end
+        end
+
+        if state[:save_ok] == true
+          div style: status_style do
+            text "✓ Saved"
+          end
+        end
+
+        if state[:reset_ok] == true
+          div style: status_style do
+            text "✓ Reset to original"
+          end
+        end
+
+        # Show if current file is loaded in service (can reopen)
+        current_app_info = LOADED_APPS[state[:current_file_path]]
+        if current_app_info
+          running_style = "margin-top: 8px; padding: 8px 12px; background: #e8f5e9; border: 1px solid #81c784; border-radius: 4px; font-size: 13px;"
+          current_app_id = current_app_info[:app_id]
+          aliased_url = current_app_info[:aliased_url]
+          # aliased_url from ServiceClient is already a full URL
+          app_url = aliased_url || "http://localhost:#{service_port}/apps/#{current_app_id}"
+
+          div style: running_style do
+            div style: "display: flex; justify-content: space-between; align-items: center;" do
+              div do
+                text "▶ Running in service"
+                if aliased_url
+                  div style: "font-size: 0.85rem; color: #666; font-family: monospace; margin-top: 2px;" do
+                    text aliased_url
+                  end
+                end
+              end
+              div style: "display: flex; gap: 8px; align-items: center;" do
+                reopen_style = "background: #4caf50; border: none; color: white; padding: 4px 12px; border-radius: 4px; font-size: 13px; cursor: pointer;"
+                button "Reopen ↗", style: reopen_style do |_s|
+                  open_in_browser(app_url)
+                end
+                remove_link_style = "background: transparent; border: none; color: #666; cursor: pointer; font-size: 13px; padding: 2px 8px;"
+                button "Unload", style: remove_link_style do |_s|
+                  remove_app_via_service(current_app_id)
+                end
+              end
+            end
+          end
+        end
+      else
+        div style: "color: #888; padding: 40px; text-align: center;" do
+          text "Select an example from the sidebar to view its code."
+        end
+      end
+    end
+  end
+
+  # Error modal
+  modal :error, title: "Syntax Error", size: :md do
+    div style: "font-family: monospace; white-space: pre-wrap; background: #fee; padding: 1rem; border-radius: 4px; color: #c00; font-size: 13px;" do
+      text state[:error_message]
+    end
+
+    modal_footer do
+      button "Close" do |s|
+        s[:error_modal_open] = false
+      end
+    end
+  end
+end
+
+# Always run - showcase command runs this standalone
+generated_app.run!

data/examples/advanced/teachables_browser.rb

@@ -0,0 +1,261 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Teachables Browser - Visual triage for teachable moments
+#
+# Run: ruby teachables_browser.rb
+# Opens: http://localhost:8080
+
+require_relative '../../lib/stream_weaver'
+require 'json'
+require 'yaml'
+require 'fileutils'
+
+# Configuration
+CULTIV_OS = File.expand_path('~/cultiv-os')
+PENDING_DIR = File.join(CULTIV_OS, 'captures', 'pending')
+APPROVED_DIR = File.join(CULTIV_OS, 'captures', 'approved')
+REJECTED_DIR = File.join(CULTIV_OS, 'captures', 'rejected')
+DEFERRED_DIR = File.join(CULTIV_OS, 'captures', 'deferred')
+
+# Ensure directories exist
+[APPROVED_DIR, REJECTED_DIR, DEFERRED_DIR].each { |d| FileUtils.mkdir_p(d) }
+
+# Helper to load all pending teachables
+def load_pending_teachables
+  candidates = []
+  Dir.glob(File.join(PENDING_DIR, '*.json')).each do |f|
+    data = JSON.parse(File.read(f)) rescue {}
+    (data['candidates'] || []).each do |c|
+      c['_source_file'] = f
+      candidates << c
+    end
+  end
+  candidates
+end
+
+# Helper to move teachable to a directory
+def move_teachable(candidate, to_dir, status, extra = {})
+  source_file = candidate['_source_file']
+  return unless source_file && File.exist?(source_file)
+
+  # Remove from pending JSON
+  data = JSON.parse(File.read(source_file))
+  data['candidates'].reject! { |c| c['id'] == candidate['id'] }
+  File.write(source_file, JSON.pretty_generate(data))
+
+  # Save to target directory
+  candidate.delete('_source_file')
+  candidate['status'] = status
+  candidate['#{status}_at'] = Time.now.iso8601
+  candidate.merge!(extra)
+
+  slug = candidate['id'].gsub(/[^a-zA-Z0-9-]/, '-')[0..50]
+  filepath = File.join(to_dir, "#{Date.today}-#{slug}.yaml")
+  File.write(filepath, candidate.to_yaml)
+  filepath
+end
+
+# Count items in directory
+def count_items(dir)
+  Dir.glob(File.join(dir, '*.yaml')).length
+end
+
+# Audience badge colors
+def audience_style(aud)
+  case aud
+  when 'blog' then :strong
+  when 'team' then :maybe
+  else :skip
+  end
+end
+
+App = app "Teachables Browser" do
+  header "Teachables Browser"
+
+  # Load data
+  all_teachables = load_pending_teachables
+
+  # Stats row
+  columns widths: ['25%', '25%', '25%', '25%'] do
+    column do
+      card do
+        header4 "Pending"
+        text "#{all_teachables.length}"
+      end
+    end
+    column do
+      card do
+        header4 "Approved"
+        text "#{count_items(APPROVED_DIR)}"
+      end
+    end
+    column do
+      card do
+        header4 "Rejected"
+        text "#{count_items(REJECTED_DIR)}"
+      end
+    end
+    column do
+      card do
+        header4 "Deferred"
+        text "#{count_items(DEFERRED_DIR)}"
+      end
+    end
+  end
+
+  # Filters
+  header3 "Filters"
+
+  columns widths: ['33%', '33%', '33%'] do
+    column do
+      text "Audience:"
+      tag_buttons :audience_filter, ["all", "blog", "team", "self"]
+    end
+    column do
+      text "Min External Interest:"
+      select :min_external, ["0", "5", "6", "7", "8", "9"], default: "0"
+    end
+    column do
+      text "Sort by:"
+      select :sort_by, ["external_interest", "novelty", "reusability"], default: "external_interest"
+    end
+  end
+
+  # Apply filters
+  state[:audience_filter] ||= "all"
+  state[:min_external] ||= "0"
+  state[:sort_by] ||= "external_interest"
+
+  filtered = all_teachables.dup
+
+  unless state[:audience_filter] == "all"
+    filtered = filtered.select { |t| t['audience'] == state[:audience_filter] }
+  end
+
+  min_ext = state[:min_external].to_i
+  if min_ext > 0
+    filtered = filtered.select { |t| (t.dig('scores', 'external_interest') || 0) >= min_ext }
+  end
+
+  # Sort
+  sort_field = state[:sort_by]
+  filtered = filtered.sort_by { |t| -(t.dig('scores', sort_field) || 0) }
+
+  # Results header
+  header3 "#{filtered.length} Teachables"
+
+  if filtered.empty?
+    text "No teachables match your filters."
+  else
+    # Display each teachable
+    filtered.each_with_index do |t, idx|
+      card do
+        # Header row with scores and audience
+        columns widths: ['70%', '30%'] do
+          column do
+            header4 t['summary'][0..80] + (t['summary'].length > 80 ? '...' : '')
+          end
+          column do
+            status_badge audience_style(t['audience']), t['audience']
+          end
+        end
+
+        # Metadata row
+        text "Project: #{t['project']} | Session: #{t['session_id'][0..20]}..."
+
+        # Scores
+        scores = t['scores'] || {}
+        md "**Scores:** Novelty: #{scores['novelty']} | Struggle: #{scores['struggle_to_solution']} | Reuse: #{scores['reusability']} | External: #{scores['external_interest']}"
+
+        # Themes
+        themes = (t['themes'] || [])[0..5].join(', ')
+        text "Themes: #{themes}" unless themes.empty?
+
+        # Patterns
+        known = (t.dig('patterns_detected', 'known') || []).join(', ')
+        coined = (t.dig('patterns_detected', 'new_coined') || []).join(', ')
+        text "Known patterns: #{known}" unless known.empty?
+        text "New coined: #{coined}" unless coined.empty?
+
+        # Context (collapsible)
+        collapsible "Context" do
+          md t['context'] || "(no context)"
+        end
+
+        # Action buttons
+        columns widths: ['25%', '25%', '25%', '25%'] do
+          column do
+            button "Approve", style: :primary do |state|
+              filepath = move_teachable(t, APPROVED_DIR, 'approved')
+              state[:last_action] = "Approved: #{t['id']} -> #{filepath}"
+            end
+          end
+          column do
+            button "Reject", style: :secondary do |state|
+              filepath = move_teachable(t, REJECTED_DIR, 'rejected')
+              state[:last_action] = "Rejected: #{t['id']}"
+            end
+          end
+          column do
+            button "Defer", style: :secondary do |state|
+              filepath = move_teachable(t, DEFERRED_DIR, 'deferred')
+              state[:last_action] = "Deferred: #{t['id']}"
+            end
+          end
+          column do
+            button "Promote to Blog" do |state|
+              # Create blog draft
+              title = t['summary'].split(/[.!?]/)[0].strip
+              slug = title.downcase.gsub(/[^a-z0-9]+/, '-')[0..50]
+
+              content = <<~MD
+                ---
+                title: "#{title}"
+                date: #{Date.today}
+                status: draft
+                source_session: #{t['session_id']}
+                themes: #{(t['themes'] || []).join(', ')}
+                ---
+
+                # #{title}
+
+                ## Summary
+
+                #{t['summary']}
+
+                ## Context
+
+                #{t['context']}
+
+                ## Key Insights
+
+                TODO: Extract key insights and expand
+
+                ---
+                *Generated from teachable: #{t['id']}*
+              MD
+
+              blog_dir = File.join(CULTIV_OS, 'blog-drafts')
+              FileUtils.mkdir_p(blog_dir)
+              filepath = File.join(blog_dir, "#{Date.today}-#{slug}.md")
+              File.write(filepath, content)
+
+              # Also approve it
+              move_teachable(t, APPROVED_DIR, 'approved', { promoted_to: 'blog', blog_draft: filepath })
+              state[:last_action] = "Promoted to blog: #{filepath}"
+            end
+          end
+        end
+      end
+    end
+  end
+
+  # Show last action
+  if state[:last_action]
+    header3 "Last Action"
+    text state[:last_action]
+  end
+end
+
+App.run! if __FILE__ == $0