prompt_objects 0.5.0 → 0.7.0

data/tools/thread-explorer.html

@@ -298,6 +298,7 @@ button { font-family:var(--mono); cursor:pointer; }
 
 // --- State ---
 let treeData = null;
+let envData = [];       // root-level env data entries
 let events = [];        // flattened event sequence
 let actors = [];        // ordered actor names
 let poNames = new Set();
@@ -310,7 +311,7 @@ let activeFilters = new Set(); // PO name filters
 let allNodes = {};      // id -> node for quick lookup
 
 const COLORS = ['#33ff66','#ffaa33','#33ddff','#dd55ff','#ff6699','#33ffcc','#ffdd44','#88aaff','#ff8844','#99ff33'];
-const STRUCTURAL_TOOLS = new Set(['create_capability','add_capability','request_capability','remove_capability','modify_prompt','create_po','delete_primitive','ask_human']);
+const STRUCTURAL_TOOLS = new Set(['create_capability','add_capability','request_capability','remove_capability','modify_prompt','create_po','delete_primitive']);
 
 // --- DOM refs ---
 const dropZone = document.getElementById('drop-zone');
@@ -335,6 +336,7 @@ function loadFile(file) {
 
 function loadData(data) {
   treeData = data;
+  envData = data.env_data || [];
   allNodes = {};
   indexNodes(data);
   poNames = extractPONames(data);
@@ -503,9 +505,11 @@ function renderHeader() {
   const usage = sumUsageTree(treeData);
   const nEvents = events.length;
   const nSessions = Object.keys(allNodes).length;
+  const envCount = envData.length;
   document.getElementById('h-stats').innerHTML =
     `<span><span class="v">${nSessions}</span> sessions</span>`+
     `<span><span class="v">${nEvents}</span> events</span>`+
+    (envCount > 0 ? `<span style="color:var(--amber)"><span class="v">${envCount}</span> env data</span>` : '')+
     `<span><span class="v">${fmtNum(usage.input)}</span> in</span>`+
     `<span><span class="v">${fmtNum(usage.output)}</span> out</span>`;
 }
@@ -817,6 +821,29 @@ function renderDetail() {
   html += `<div class="stats"><span><span class="v">${fmtNum(usage.input)}</span> in</span><span><span class="v">${fmtNum(usage.output)}</span> out</span></div>`;
   html += `</div>`;
 
+  // Env Data section (only on root session when env_data exists)
+  if (type === 'root' && envData.length > 0) {
+    html += '<div style="padding:8px 16px 0">';
+    html += '<div style="font-size:10px;text-transform:uppercase;letter-spacing:0.5px;color:var(--amber);margin-bottom:6px;font-weight:600">Env Data</div>';
+    envData.forEach(entry => {
+      const eKey = esc(entry.key);
+      const eDesc = esc(entry.short_description||'');
+      const eBy = esc(entry.stored_by||'');
+      const eVal = typeof entry.value === 'string' ? esc(entry.value) : esc(JSON.stringify(entry.value,null,2));
+      html += `<div class="tc">`;
+      html += `<div class="tc-head" onclick="toggleTc(this)" style="border-left:2px solid var(--amber)">`;
+      html += `<span class="chv">&#9654;</span>`;
+      html += `<span class="tc-name" style="color:var(--amber)">${eKey}</span>`;
+      html += `<span class="tc-label">${eDesc}</span>`;
+      html += `<span class="tc-label" style="margin-left:auto">by ${eBy}</span>`;
+      html += `</div>`;
+      html += `<div class="tc-body">`;
+      html += `<div class="tc-section"><div class="tc-section-label">Value</div><pre style="color:var(--amber)">${eVal}</pre></div>`;
+      html += `</div></div>`;
+    });
+    html += '</div>';
+  }
+
   // Messages
   html += '<div class="messages">';
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prompt_objects
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Scott Werner
@@ -196,75 +196,46 @@ description: A framework where markdown files with LLM-backed behavior act as fi
 email:
 - scott@sublayer.com
 executables:
+- poop
 - prompt_objects
 - prompt_objects_mcp
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- CLAUDE.md
-- Gemfile
-- Gemfile.lock
-- IMPLEMENTATION_PLAN.md
 - LICENSE
 - README.md
-- Rakefile
-- design-doc-v2.md
+- exe/poop
 - exe/prompt_objects
 - exe/prompt_objects_mcp
-- frontend/.gitignore
-- frontend/index.html
-- frontend/package-lock.json
-- frontend/package.json
-- frontend/postcss.config.js
-- frontend/src/App.tsx
-- frontend/src/canvas/CanvasView.tsx
-- frontend/src/canvas/ForceLayout.ts
-- frontend/src/canvas/SceneManager.ts
-- frontend/src/canvas/canvasStore.ts
-- frontend/src/canvas/constants.ts
-- frontend/src/canvas/controls/CameraControls.ts
-- frontend/src/canvas/edges/MessageArc.ts
-- frontend/src/canvas/inspector/InspectorPanel.tsx
-- frontend/src/canvas/inspector/POInspector.tsx
-- frontend/src/canvas/inspector/ToolCallInspector.tsx
-- frontend/src/canvas/nodes/PONode.ts
-- frontend/src/canvas/nodes/ToolCallNode.ts
-- frontend/src/canvas/types.ts
-- frontend/src/components/ContextMenu.tsx
-- frontend/src/components/Inspector.tsx
-- frontend/src/components/MarkdownMessage.tsx
-- frontend/src/components/MethodList.tsx
-- frontend/src/components/ModelSelector.tsx
-- frontend/src/components/NotificationPanel.tsx
-- frontend/src/components/ObjectList.tsx
-- frontend/src/components/PaneSlot.tsx
-- frontend/src/components/SourcePane.tsx
-- frontend/src/components/SystemBar.tsx
-- frontend/src/components/Transcript.tsx
-- frontend/src/components/UsagePanel.tsx
-- frontend/src/components/Workspace.tsx
-- frontend/src/components/index.ts
-- frontend/src/hooks/useResize.ts
-- frontend/src/hooks/useWebSocket.ts
-- frontend/src/index.css
-- frontend/src/main.tsx
-- frontend/src/store/index.ts
-- frontend/src/types/index.ts
-- frontend/tailwind.config.js
-- frontend/tsconfig.json
-- frontend/vite.config.ts
 - lib/prompt_objects.rb
 - lib/prompt_objects/capability.rb
 - lib/prompt_objects/cli.rb
+- lib/prompt_objects/cli/diagnostics_command.rb
+- lib/prompt_objects/cli/env_command.rb
+- lib/prompt_objects/cli/events_command.rb
+- lib/prompt_objects/cli/explore_command.rb
+- lib/prompt_objects/cli/helpers.rb
+- lib/prompt_objects/cli/message_command.rb
+- lib/prompt_objects/cli/repl_command.rb
+- lib/prompt_objects/cli/serve_command.rb
 - lib/prompt_objects/connectors/base.rb
 - lib/prompt_objects/connectors/mcp.rb
+- lib/prompt_objects/domain/records.rb
 - lib/prompt_objects/environment.rb
 - lib/prompt_objects/environment/exporter.rb
 - lib/prompt_objects/environment/git.rb
 - lib/prompt_objects/environment/importer.rb
 - lib/prompt_objects/environment/manager.rb
 - lib/prompt_objects/environment/manifest.rb
+- lib/prompt_objects/execution/blocking_executor.rb
+- lib/prompt_objects/execution/context.rb
+- lib/prompt_objects/execution/contracts.rb
+- lib/prompt_objects/execution/permit_pool.rb
+- lib/prompt_objects/execution/policy.rb
+- lib/prompt_objects/execution/resource_lock_manager.rb
+- lib/prompt_objects/execution/runner.rb
+- lib/prompt_objects/execution/scheduler.rb
 - lib/prompt_objects/human_queue.rb
 - lib/prompt_objects/llm/anthropic_adapter.rb
 - lib/prompt_objects/llm/factory.rb
@@ -281,40 +252,58 @@ files:
 - lib/prompt_objects/mcp/tools/respond_to_request.rb
 - lib/prompt_objects/mcp/tools/send_message.rb
 - lib/prompt_objects/message_bus.rb
+- lib/prompt_objects/operations/diagnostics.rb
+- lib/prompt_objects/operations/retention.rb
+- lib/prompt_objects/operations/run_trace_builder.rb
 - lib/prompt_objects/primitive.rb
 - lib/prompt_objects/primitives/http_get.rb
 - lib/prompt_objects/primitives/list_files.rb
 - lib/prompt_objects/primitives/read_file.rb
+- lib/prompt_objects/primitives/think.rb
 - lib/prompt_objects/primitives/write_file.rb
 - lib/prompt_objects/prompt_object.rb
 - lib/prompt_objects/registry.rb
+- lib/prompt_objects/repositories/artifact_repository.rb
+- lib/prompt_objects/repositories/base_repository.rb
+- lib/prompt_objects/repositories/definition_repository.rb
+- lib/prompt_objects/repositories/env_data_repository.rb
+- lib/prompt_objects/repositories/event_repository.rb
+- lib/prompt_objects/repositories/message_repository.rb
+- lib/prompt_objects/repositories/run_repository.rb
+- lib/prompt_objects/repositories/thread_repository.rb
+- lib/prompt_objects/repositories/tool_execution_repository.rb
+- lib/prompt_objects/repositories/workspace_session_repository.rb
 - lib/prompt_objects/server.rb
 - lib/prompt_objects/server/api/routes.rb
 - lib/prompt_objects/server/app.rb
 - lib/prompt_objects/server/file_watcher.rb
-- lib/prompt_objects/server/public/assets/index-D1myxE0l.js
-- lib/prompt_objects/server/public/assets/index-DdCcwC-Z.css
+- lib/prompt_objects/server/public/assets/index-BjKlODDD.js
+- lib/prompt_objects/server/public/assets/index-w3fpIb5c.css
 - lib/prompt_objects/server/public/index.html
 - lib/prompt_objects/server/websocket_handler.rb
+- lib/prompt_objects/service.rb
 - lib/prompt_objects/session/store.rb
 - lib/prompt_objects/universal/add_capability.rb
-- lib/prompt_objects/universal/add_primitive.rb
-- lib/prompt_objects/universal/ask_human.rb
 - lib/prompt_objects/universal/create_capability.rb
-- lib/prompt_objects/universal/create_primitive.rb
+- lib/prompt_objects/universal/delete_env_data.rb
 - lib/prompt_objects/universal/delete_primitive.rb
+- lib/prompt_objects/universal/dispatch_po.rb
+- lib/prompt_objects/universal/get_env_data.rb
+- lib/prompt_objects/universal/get_run_status.rb
+- lib/prompt_objects/universal/join_runs.rb
 - lib/prompt_objects/universal/list_capabilities.rb
-- lib/prompt_objects/universal/list_primitives.rb
+- lib/prompt_objects/universal/list_env_data.rb
 - lib/prompt_objects/universal/modify_primitive.rb
 - lib/prompt_objects/universal/modify_prompt.rb
 - lib/prompt_objects/universal/remove_capability.rb
+- lib/prompt_objects/universal/render_artifact.rb
 - lib/prompt_objects/universal/request_primitive.rb
-- lib/prompt_objects/universal/think.rb
+- lib/prompt_objects/universal/set_env_data.rb
 - lib/prompt_objects/universal/verify_primitive.rb
+- lib/prompt_objects/version.rb
 - objects/coordinator.md
 - objects/greeter.md
 - objects/reader.md
-- prompt_objects.gemspec
 - templates/arc-agi-1/manifest.yml
 - templates/arc-agi-1/objects/data_manager.md
 - templates/arc-agi-1/objects/observer.md
@@ -328,22 +317,142 @@ files:
 - templates/arc-agi-1/primitives/load_arc_task.rb
 - templates/arc-agi-1/primitives/render_grid.rb
 - templates/arc-agi-1/primitives/test_solution.rb
-- templates/basic/.gitignore
+- templates/arc-agi-3/manifest.yml
+- templates/arc-agi-3/objects/analyst.md
+- templates/arc-agi-3/objects/player.md
+- templates/arc-agi-3/objects/strategist.md
+- templates/arc-agi-3/primitives/action_log.rb
+- templates/arc-agi-3/primitives/arc3_api.rb
+- templates/arc-agi-3/primitives/arc3_scorecard.rb
+- templates/arc-agi-3/primitives/frame_diff.rb
+- templates/arc-agi-3/primitives/frame_info.rb
+- templates/arc-agi-3/primitives/render_frame.rb
 - templates/basic/manifest.yml
 - templates/basic/objects/basic.md
-- templates/developer/.gitignore
+- templates/chiptune/extras/sonic_pi_boot.rb
+- templates/chiptune/manifest.yml
+- templates/chiptune/objects/conductor.md
+- templates/chiptune/objects/sonic_pi.md
+- templates/chiptune/objects/voice_bass.md
+- templates/chiptune/objects/voice_lead.md
+- templates/chiptune/objects/voice_pad.md
+- templates/chiptune/objects/voice_perc.md
+- templates/chiptune/primitives/play_note.rb
+- templates/chiptune/primitives/play_sequence.rb
+- templates/chiptune/primitives/query_sonic_pi.rb
+- templates/chiptune/primitives/set_synth.rb
+- templates/chiptune/primitives/set_tempo.rb
+- templates/chiptune/primitives/stop_voice.rb
+- templates/chiptune/primitives/support/osc_bridge.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/LICENSE
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/address_pattern.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/broadcast_client.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/bundle.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/client.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/core_ext/time.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/em_server.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/message.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/network_packet.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_argument.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_packet.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_types.rb
+- templates/chiptune/vendor/osc-ruby-1.1.5/lib/osc-ruby/server.rb
 - templates/developer/manifest.yml
 - templates/developer/objects/code_reviewer.md
 - templates/developer/objects/coordinator.md
 - templates/developer/objects/debugger.md
-- templates/empty/.gitignore
 - templates/empty/manifest.yml
-- templates/empty/objects/.gitkeep
 - templates/empty/objects/assistant.md
-- templates/minimal/.gitignore
 - templates/minimal/manifest.yml
 - templates/minimal/objects/assistant.md
-- templates/writer/.gitignore
+- templates/music-beginner/README.md
+- templates/music-beginner/extras/README.md
+- templates/music-beginner/extras/sonic_pi_boot.rb
+- templates/music-beginner/manifest.yml
+- templates/music-beginner/objects/conductor.md
+- templates/music-beginner/objects/engine_setup.md
+- templates/music-beginner/objects/voice_bass.md
+- templates/music-beginner/objects/voice_keys.md
+- templates/music-beginner/objects/voice_pad.md
+- templates/music-beginner/objects/voice_percussion.md
+- templates/music-beginner/objects/voice_texture.md
+- templates/music-beginner/primitives/play_pattern.rb
+- templates/music-beginner/primitives/query_music_engine.rb
+- templates/music-beginner/primitives/set_instrument.rb
+- templates/music-beginner/primitives/set_tempo.rb
+- templates/music-beginner/primitives/set_voice_level.rb
+- templates/music-beginner/primitives/stop_voice.rb
+- templates/music-beginner/primitives/support/osc_bridge.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/LICENSE
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/address_pattern.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/broadcast_client.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/bundle.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/client.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/core_ext/time.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/em_server.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/message.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/network_packet.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_argument.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_packet.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_types.rb
+- templates/music-beginner/vendor/osc-ruby-1.1.5/lib/osc-ruby/server.rb
+- templates/music-pro/extras/AUDITION.md
+- templates/music-pro/extras/sonic_pi_boot.rb
+- templates/music-pro/manifest.yml
+- templates/music-pro/objects/conductor.md
+- templates/music-pro/objects/sonic_pi.md
+- templates/music-pro/objects/voice_harmony.md
+- templates/music-pro/objects/voice_rhythm.md
+- templates/music-pro/objects/voice_texture.md
+- templates/music-pro/primitives/define_patch.rb
+- templates/music-pro/primitives/query_music_engine.rb
+- templates/music-pro/primitives/set_live_pattern.rb
+- templates/music-pro/primitives/set_tempo.rb
+- templates/music-pro/primitives/stop_voice.rb
+- templates/music-pro/primitives/support/music_protocol.rb
+- templates/music-pro/primitives/support/osc_bridge.rb
+- templates/music-pro/primitives/trigger_event.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/LICENSE
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/address_pattern.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/broadcast_client.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/bundle.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/client.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/core_ext/time.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/em_server.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/message.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/network_packet.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_argument.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_packet.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_types.rb
+- templates/music-pro/vendor/osc-ruby-1.1.5/lib/osc-ruby/server.rb
+- templates/music/extras/sonic_pi_boot.rb
+- templates/music/manifest.yml
+- templates/music/objects/conductor.md
+- templates/music/objects/sonic_pi.md
+- templates/music/primitives/play_note.rb
+- templates/music/primitives/play_sequence.rb
+- templates/music/primitives/query_sonic_pi.rb
+- templates/music/primitives/set_synth.rb
+- templates/music/primitives/set_tempo.rb
+- templates/music/primitives/stop_voice.rb
+- templates/music/primitives/support/osc_bridge.rb
+- templates/music/vendor/osc-ruby-1.1.5/LICENSE
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/address_pattern.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/broadcast_client.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/bundle.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/client.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/core_ext/time.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/em_server.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/message.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/network_packet.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_argument.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_packet.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/osc_types.rb
+- templates/music/vendor/osc-ruby-1.1.5/lib/osc-ruby/server.rb
 - templates/writer/manifest.yml
 - templates/writer/objects/coordinator.md
 - templates/writer/objects/editor.md
@@ -354,8 +463,9 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/works-on-your-machine/prompt_objects
-  source_code_uri: https://github.com/works-on-your-machine/prompt_objects
+  source_code_uri: https://github.com/works-on-your-machine/prompt_objects/tree/v0.7.0
   changelog_uri: https://github.com/works-on-your-machine/prompt_objects/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -370,7 +480,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.7
 specification_version: 4
 summary: LLM-backed entities as first-class autonomous objects
 test_files: []

data/CLAUDE.md

@@ -1,176 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-**PromptObjects** is a Ruby framework where markdown files with LLM-backed behavior act as first-class autonomous entities. The core insight: **everything is a capability**—primitives (Ruby code) and Prompt-Objects (markdown files) share the same interface, differing only in interpretation complexity.
-
-**Current Status**: v0.5.0 — The core framework is fully implemented and functional. The original 6-phase implementation plan is complete. Active development is focused on visualization, developer experience, and exploring new primitives. See `CHANGELOG.md` for release history and `design-doc-v2.md` / `IMPLEMENTATION_PLAN.md` for original design context.
-
-## Architecture
-
-```
-RUNTIME (Environment)
-├── CAPABILITY REGISTRY
-│   ├── PRIMITIVES (Ruby) - deterministic interpretation
-│   ├── PROMPT-OBJECTS (Markdown) - semantic interpretation via LLM
-│   └── UNIVERSAL CAPABILITIES - available to all POs automatically
-├── MESSAGE BUS - routes messages, logs to SQLite for replay
-├── SESSION STORE (SQLite) - persistent conversation threads, delegation tracking
-├── HUMAN QUEUE - non-blocking ask_human requests
-├── WEB SERVER (Sinatra + WebSocket) - serves React frontend
-└── MCP SERVER - exposes POs as tools via Model Context Protocol
-```
-
-### Unified Capability Interface
-Both primitives and Prompt-Objects implement:
-```ruby
-class Capability
-  def name          # string identifier
-  def description   # what this capability does
-  def receive(message, context:)  # handle message, return response
-end
-```
-
-### Prompt-Object Structure
-Markdown files with two parts:
-- **Frontmatter (YAML)**: Configuration (name, description, capabilities)
-- **Body (Markdown)**: Identity and behavior (becomes LLM system prompt)
-
-Example:
-```markdown
----
-name: reader
-description: Helps people understand files
-capabilities:
-  - read_file
-  - list_files
----
-
-# Reader
-## Identity
-You are a careful, thoughtful file reader...
-```
-
-### Universal Capabilities
-Available to all Prompt-Objects automatically (no frontmatter declaration needed):
-- `ask_human` - pause for human input/confirmation
-- `think` - internal reasoning (not shown to human)
-- `create_capability` / `add_capability` / `remove_capability` - self-modification
-- `list_capabilities` / `list_primitives` - introspection
-- `create_primitive` / `add_primitive` / `delete_primitive` / `verify_primitive` / `modify_primitive` / `request_primitive` - primitive management
-- `modify_prompt` - rewrite own system prompt at runtime
-
-### PO-to-PO Delegation
-When a PO calls another PO, the system creates an isolated delegation thread in the target PO. The caller's context is tracked so messages show correct provenance. Delegation start/complete events are broadcast via WebSocket for real-time UI updates.
-
-## Technology Stack
-
-- **Ruby** (>= 3.2, tested through Ruby 4) - core implementation
-- **LLM APIs** - OpenAI, Anthropic, Gemini, Ollama, OpenRouter (adapter pattern via `LLM::Factory`)
-- **Sinatra** - web server for REST API and static file serving
-- **faye-websocket** - real-time WebSocket communication
-- **React + TypeScript** - web frontend (dashboard, chat, capabilities panel)
-- **Three.js** - spatial canvas visualization (force-directed PO graph)
-- **SQLite** - session persistence and event log storage
-- **MCP** - Model Context Protocol server mode
-
-## File Structure
-
-```
-prompt_objects/
-├── exe/prompt_objects              # CLI entrypoint
-├── lib/
-│   ├── prompt_objects.rb           # Main entry, requires all modules
-│   └── prompt_objects/
-│       ├── environment.rb          # Runtime container (registry, bus, LLM, sessions)
-│       ├── capability.rb           # Base capability interface
-│       ├── prompt_object.rb        # PO implementation (LLM conversation loop)
-│       ├── primitive.rb            # Primitive tool wrapper
-│       ├── loader.rb               # Parses frontmatter + body from .md files
-│       ├── registry.rb             # Capability registration and lookup
-│       ├── message_bus.rb          # Message routing, logging, SQLite persistence
-│       ├── human_queue.rb          # Non-blocking human interaction queue
-│       ├── cli.rb                  # CLI command definitions
-│       ├── server.rb               # Web server setup
-│       ├── server/
-│       │   ├── app.rb              # Sinatra application
-│       │   ├── api/routes.rb       # REST API endpoints
-│       │   ├── websocket_handler.rb # WebSocket event handling
-│       │   └── file_watcher.rb     # Live .md file change detection
-│       ├── llm/
-│       │   ├── factory.rb          # Provider/model selection
-│       │   ├── response.rb         # Unified response object
-│       │   ├── pricing.rb          # Token cost calculation
-│       │   ├── openai_adapter.rb   # OpenAI + Ollama + OpenRouter
-│       │   ├── anthropic_adapter.rb
-│       │   └── gemini_adapter.rb
-│       ├── primitives/             # Built-in: read_file, list_files, write_file, http_get
-│       ├── universal/              # 14 universal capabilities (see list above)
-│       ├── connectors/             # Interface adapters (base, mcp)
-│       ├── mcp/                    # MCP server and tool definitions
-│       ├── session/
-│       │   └── store.rb            # SQLite session/thread persistence
-│       └── environment/
-│           ├── manager.rb          # Create/list/clone environments
-│           ├── manifest.rb         # Environment metadata (manifest.yml)
-│           ├── git.rb              # Auto-commit integration
-│           ├── exporter.rb         # Environment export
-│           └── importer.rb         # Environment import
-├── frontend/                       # React + TypeScript web UI
-│   └── src/
-│       ├── App.tsx
-│       ├── components/             # Dashboard, chat, capabilities panel
-│       ├── canvas/                 # Three.js spatial visualization
-│       ├── hooks/                  # WebSocket, state management hooks
-│       ├── store/                  # Frontend state
-│       └── types/                  # TypeScript type definitions
-├── objects/                        # Default POs: greeter, reader, coordinator
-├── templates/                      # Environment templates (basic, developer, writer, arc-agi-1, etc.)
-├── tools/                          # Development tooling
-└── test/                           # Unit and integration tests
-```
-
-## Key Concepts
-
-- **Semantic Binding**: Natural language → capability call (visible in message log)
-- **PO↔PO Communication**: Prompt-Objects call each other as capabilities through isolated delegation threads
-- **Self-Modification**: POs can create new POs and primitives at runtime (with human approval)
-- **Human-in-the-Loop**: POs use `ask_human` to pause and queue notifications; human responds asynchronously via the web UI
-- **Environments**: Isolated collections of POs with their own sessions, git history, and configuration. Created from templates via CLI.
-- **Thread Export**: Conversation threads (including delegation chains) exportable as Markdown or JSON
-
-## Development
-
-```bash
-# Install dependencies
-bundle install
-cd frontend && npm install && cd ..
-
-# Run tests
-bundle exec rake test
-
-# Serve an environment with web UI
-prompt_objects serve <env-name> --open
-
-# Environment management
-prompt_objects env create <name> --template basic
-prompt_objects env list
-prompt_objects env info <name>
-```
-
-## Releases
-
-Always tag releases. Pushing a version tag triggers the Discord notification workflow (`.github/workflows/discord-release.yml`), which extracts the matching section from `CHANGELOG.md` and posts it.
-
-```bash
-# 1. Update version in prompt_objects.gemspec
-# 2. Add changelog entry under ## [X.Y.Z] - YYYY-MM-DD
-# 3. Commit: "Release vX.Y.Z — short description"
-# 4. Tag and push:
-git tag vX.Y.Z
-git push && git push origin vX.Y.Z
-# 5. Publish gem:
-gem build prompt_objects.gemspec && gem push prompt_objects-X.Y.Z.gem
-```

data/Gemfile

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in prompt_objects.gemspec
-gemspec
-
-# Ruby 3.4+ compatibility - base64 moved out of stdlib
-gem "base64"
-