prompt_objects 0.6.0 → 0.7.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prompt_objects
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Scott Werner
@@ -196,73 +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
 - LICENSE
 - README.md
-- Rakefile
+- 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/EnvDataPane.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
@@ -279,45 +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-DEPawnfZ.js
-- lib/prompt_objects/server/public/assets/index-oMrRce1m.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_env_data.rb
-- lib/prompt_objects/universal/list_primitives.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/store_env_data.rb
-- lib/prompt_objects/universal/think.rb
-- lib/prompt_objects/universal/update_env_data.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
@@ -331,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
@@ -357,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
@@ -373,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,177 +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 `docs/archive/` 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 (Falcon + async-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
-- `store_env_data` / `get_env_data` / `list_env_data` / `update_env_data` / `delete_env_data` - thread-scoped shared key-value store for delegation chains
-
-### 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`)
-- **Falcon** - async HTTP server for REST API and static file serving
-- **async-websocket** - real-time WebSocket communication
-- **React + TypeScript** - web frontend (Smalltalk System Browser-inspired multi-pane UI)
-- **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/             # SystemBar, ObjectList, Inspector, Workspace, Transcript
-│       ├── 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"
-

data/Rakefile

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-require "rake/testtask"
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
-  t.warning = false
-end
-
-Rake::TestTask.new("test:unit") do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/unit/**/*_test.rb"]
-  t.warning = false
-end
-
-Rake::TestTask.new("test:integration") do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/integration/**/*_test.rb"]
-  t.warning = false
-end
-
-desc "Run tests (default)"
-task default: :test

data/frontend/.gitignore

@@ -1,3 +0,0 @@
-node_modules/
-dist/
-.DS_Store

data/frontend/index.html

@@ -1,17 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <link rel="preconnect" href="https://cdn.jsdelivr.net" crossorigin />
-    <link href="https://cdn.jsdelivr.net/fontsource/fonts/geist@latest/latin-400-normal.woff2" as="font" type="font/woff2" crossorigin />
-    <link href="https://cdn.jsdelivr.net/npm/geist@1/dist/fonts/geist-sans/style.css" rel="stylesheet" />
-    <link href="https://cdn.jsdelivr.net/npm/geist@1/dist/fonts/geist-mono/style.css" rel="stylesheet" />
-    <title>PromptObjects</title>
-  </head>
-  <body class="bg-po-bg text-po-text-primary font-ui">
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>