language-operator 0.1.35 → 0.1.36

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5dc7f8d30b6d4029cd6be018e1cb78a2f3779e3b5e06a49c85648822edc304b
-  data.tar.gz: b6477ee7aa7a734465b5575aa2e872c9faa0a12f0fa5e840f75da3a3b5919350
+  metadata.gz: dab6721a2a81cadf3c5a252b082c77cbe3dc9262480355637c4971e0bde231f3
+  data.tar.gz: b11d038d3928f29fdb91e09e859e04112f4f46d846556e8582ff33ee37c074ae
 SHA512:
-  metadata.gz: c09b107879c42051385607177fc0327aa6bdfb47f5911ff5d1632b5f5079b08ba92cd3525bb4e97d984e69fa74cd1bca4eca5cebac4a1b3a1a290ff699ce1b97
-  data.tar.gz: c4715a300429d64d660f918d2776dd03e1e5d712cbb8a256405a88712f537349f43cc8bb46077bddad5f80767aa5be8b695fa6f5563d85f9f260c624211a9dd0
+  metadata.gz: 1b0ec3258b68eeb7469f8e6679dfb6f691465c404bc3c2a99c9fd99156ed96bd0e06279d0100ed495f13b134128a875e57eb3d50013139c36bb9cff23edf398b
+  data.tar.gz: fcb46362bb7ef404b990ca17e061416f1da10a10d5e7c9b65188292797f8ea96b6a4f5e9d67f73587e891a225dae7d76bcb3c34500ec64b192e6d06c5d57b18b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    language-operator (0.1.35)
+    language-operator (0.1.36)
       k8s-ruby (~> 0.17)
       mcp (~> 0.4)
       opentelemetry-exporter-otlp (~> 0.27)

data/lib/language_operator/templates/schema/agent_dsl_openapi.yaml

@@ -2,7 +2,7 @@
 :openapi: 3.0.3
 :info:
   :title: Language Operator Agent API
-  :version: 0.1.35
+  :version: 0.1.36
   :description: HTTP API endpoints exposed by Language Operator reactive agents
   :contact:
     :name: Language Operator

data/lib/language_operator/templates/schema/agent_dsl_schema.json

@@ -3,7 +3,7 @@
   "$id": "https://github.com/language-operator/language-operator-gem/schema/agent-dsl.json",
   "title": "Language Operator Agent DSL",
   "description": "Schema for defining autonomous AI agents using the Language Operator DSL",
-  "version": "0.1.35",
+  "version": "0.1.36",
   "type": "object",
   "properties": {
     "name": {

data/lib/language_operator/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LanguageOperator
-  VERSION = '0.1.35'
+  VERSION = '0.1.36'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: language-operator
 version: !ruby/object:Gem::Version
-  version: 0.1.35
+  version: 0.1.36
 platform: ruby
 authors:
 - James Ryan
@@ -524,16 +524,6 @@ files:
 - lib/language_operator/ux/quickstart.rb
 - lib/language_operator/validators.rb
 - lib/language_operator/version.rb
-- requirements/ARCHITECTURE.md
-- requirements/SCRATCH.md
-- requirements/dsl.md
-- requirements/features
-- requirements/personas
-- requirements/proposals
-- requirements/tasks/challenge.md
-- requirements/tasks/iterate.md
-- requirements/tasks/optimize.md
-- requirements/tasks/tag.md
 - synth/001/Makefile
 - synth/001/agent.rb
 - synth/001/agent.yaml

data/requirements/ARCHITECTURE.md

@@ -1 +0,0 @@
-../../ARCHITECTURE.md

data/requirements/SCRATCH.md

@@ -1,153 +0,0 @@
-# Knowledge Base
-
-Living document of critical insights, patterns, and gotchas for this codebase.
-
-## DSL Architecture (v1 - Current)
-
-**Core Model:** Task/Main (imperative, replacing declarative workflow/step)
-
-**Key Components:**
-- `TaskDefinition`: Organic functions with stable contracts (inputs/outputs), evolving implementations (neural→symbolic)
-- `MainDefinition`: Imperative entry point using Ruby control flow + `execute_task()`
-- `TypeSchema`: 7-type system (string, integer, number, boolean, array, hash, any)
-
-**Migration Strategy:**
-- DSL v0 (workflow/step) marked deprecated but fully functional
-- Both models supported in schema generation for backward compatibility
-- Deprecation clearly noted in descriptions, safe methods updated
-
-## Testing Patterns
-
-**RSpec Best Practices:**
-- Use single-quoted heredocs (`<<~'RUBY'`) when testing code with interpolation to avoid context issues
-- RuboCop requires uppercase annotation keywords with colon+space (e.g., `# TODO: fix`)
-- Symbol hash keys: Use `.keys.first.to_s` or `.values.first` for pattern properties, not direct string access
-
-**Parser Gem Quirks:**
-- Very forgiving - accepts syntax variations Ruby rejects
-- Makes syntax error testing difficult (2 pending tests skipped for this reason)
-- AST validation works well for semantic checks, less so for syntactic ones
-
-## Schema Generation
-
-**JSON Schema Patterns:**
-- `patternProperties` for flexible parameter validation without enumeration
-- Regex patterns as keys validate both names and types dynamically
-- Always include `examples` for complex schemas (aids understanding)
-
-## Security (AST Validator)
-
-**Safe Methods Lists:**
-- DSL v1: `task`, `main`, `execute_task`, `inputs`, `outputs`, `instructions`
-- DSL v0: Removed `workflow`, `step`, `depends_on`, `prompt`
-- Helpers: Added `TypeCoercion` for validation
-
-**Blocked Patterns:**
-- System execution: `system`, `exec`, `spawn`, `fork`
-- Dynamic evaluation: `eval`, `instance_eval`, `class_eval`, `send`
-- File operations: Direct `File` access, dangerous IO
-- Works in both task blocks and main blocks
-
-## Critical File Map
-
-| File | Purpose | Complexity |
-|------|---------|------------|
-| `lib/language_operator/dsl/schema.rb` | JSON Schema generation (DSL→schema) | High (1100+ lines) |
-| `lib/language_operator/dsl/task_definition.rb` | Task contract+validation | Medium (316 lines) |
-| `lib/language_operator/dsl/main_definition.rb` | Main block execution | Low (115 lines) |
-| `lib/language_operator/agent/task_executor.rb` | Neural/symbolic task execution | Medium (233 lines) |
-| `lib/language_operator/agent/safety/ast_validator.rb` | Code security validation | High |
-| `spec/language_operator/dsl/schema_spec.rb` | Schema test coverage (186 tests) | High |
-| `spec/language_operator/agent/task_executor_spec.rb` | Task executor tests (19 tests) | Medium |
-
-## Current Status
-
-**Completed (2025-11-14):**
-- ✅ Issue #26: Schema generation for task/main model
-- ✅ Issue #25: AST validator updated for DSL v1
-- ✅ Issues #21-23: TaskDefinition, MainDefinition, TypeCoercion implemented
-- ✅ Issue #28: TaskExecutor for task execution runtime
-- ✅ Issue #32 (partial): DependencyGraph and ParallelExecutor for implicit parallelism
-
-**Test Suite Health:**
-- 135 examples, 0 failures, 2 pending (syntax error tests)
-- 186 schema-specific tests, all passing
-- 19 TaskExecutor tests, all passing
-- 20 DependencyGraph tests, all passing
-- 11 ParallelExecutor tests, all passing
-- RuboCop clean
-
-## Task Execution (DSL v1)
-
-**Neural Task Flow:**
-1. TaskExecutor builds prompt from task instructions + inputs + output schema
-2. LLM called via `agent.send_message` with full tool access
-3. Response parsed as JSON (supports ```json blocks or raw objects)
-4. Outputs validated against schema via TaskDefinition#validate_outputs
-5. Fail fast on any error (critical for re-synthesis)
-
-**Symbolic Task Flow:**
-1. TaskExecutor calls TaskDefinition#call with inputs and self as context
-2. TaskDefinition validates inputs, executes code block, validates outputs
-3. Context provides `execute_task`, `execute_llm`, `execute_tool` helpers
-4. Fail fast on any error
-
-**Runtime Wiring:**
-- Agent module detects DSL v1 (main block) vs v0 (workflow)
-- Autonomous mode: `execute_main_block` creates TaskExecutor, calls MainDefinition
-- Scheduled mode: `Scheduler#start_with_main` creates TaskExecutor, schedules main
-- MainDefinition receives TaskExecutor as execution context via instance_exec
-
-## Parallel Execution (DSL v1)
-
-**Architecture:**
-- DependencyGraph: AST-based analysis extracts task dependencies from main block
-- ParallelExecutor: Level-based execution using Concurrent::FixedThreadPool
-- Default pool size: 4 threads (configurable)
-
-**How It Works:**
-1. Parse main block code to extract `execute_task` calls
-2. Build dependency graph based on variable flow (which tasks use outputs from which other tasks)
-3. Assign execution levels via topological sort
-4. Execute each level in parallel (all tasks in level run concurrently)
-5. Wait for level completion before starting next level
-
-**Performance:**
-- Measured 2x speedup for I/O-bound parallel tasks
-- Thread pool handles > pool size tasks gracefully
-- Fail-fast error handling (collects all errors, raises RuntimeError)
-
-**Current Status (2025-11-14):**
-- ✅ DependencyGraph: Complete and tested (20 tests)
-- ✅ ParallelExecutor: Complete and tested (11 tests)
-- ⚠️  Integration: Partial - blocked on variable-to-result mapping
-
-**Blocking Issue:**
-The fundamental challenge is mapping variable names from code to task results:
-```ruby
-# User code:
-s1 = execute_task(:fetch1)
-merged = execute_task(:merge, inputs: { s1: s1 })
-
-# ParallelExecutor passes: { fetch1: {...} }
-# But merge expects: { s1: {...} }
-```
-
-**Solution Options:**
-1. Enhanced AST analysis (complex, 2-3 days)
-2. Naming convention: var name = task name (simple, 1 day)
-3. Explicit dependency DSL (medium, 1-2 days)
-4. Defer to follow-up issue (pragmatic, 0 days)
-
-**Recommendation:** Option 4 - defer integration, ship infrastructure
-
-## Quick Wins / Common Gotchas
-
-1. **Hash Key Access:** Ruby symbols ≠ strings. Always check key types in tests.
-2. **Heredoc Interpolation:** Use `'RUBY'` (single quotes) to prevent RSpec context leakage.
-3. **Pattern Properties:** Schema validation via regex - powerful for type systems.
-4. **Migration-Friendly:** Keep deprecated features functional with clear warnings.
-5. **Parser Tolerance:** Don't rely on parser for syntax validation - it's too forgiving.
-6. **Tool Execution:** Tools accessed via LLM interface, not direct RPC (execute_tool → execute_llm)
-7. **Error Wrapping:** TaskExecutor wraps errors in RuntimeError with task context for debugging
-8. **Concurrent Ruby Futures:** Use `future.wait` + `future.rejected?` to check status, not `rescue` around `future.value`

data/requirements/features

@@ -1 +0,0 @@
-../../requirements/features

data/requirements/personas

@@ -1 +0,0 @@
-../../requirements/personas

data/requirements/proposals

@@ -1 +0,0 @@
-../../requirements/proposals

data/requirements/tasks/challenge.md

@@ -1,9 +0,0 @@
-You are the public face, the user interface, of an extremely ambitious project called the Language Operator.
-
-It synthesizes code *in production* securely from any arbitrary instructions written in plain text.
-
-Read ../language-operator/README.md to understand your significance.
-
-In that light, I challenge you to ensure that we're matching that vision in quality and supporting the full power of its CRDs.
-
-Dive into this code, maybe into the language-operator itself.  What can **this gem** do better at?

data/requirements/tasks/iterate.md

@@ -1,35 +0,0 @@
-# Task
-
-## Prerequisites
-
-Please read the following context files:
-
-* Persona: requirements/personas/ruby-engineer.md
-* Feature Spec: requirements/proposals/dsl-v1.md
-* Scratch: requirements/SCRATCH.md
-
-## Persona
-
-**CRITICAL**: Adopt the ruby-engineer persona while executing these instructions, please.
-
-## Instructions
-
-Follow these directions closely:
-
-1. Use the `gh` tool to find the top issue for this repository (language-operator/language-operator-gem) with the "ready" label.
-2. Investigate if it's valid, or a mis-use of the intended feature.
-3. **CRITICAL:** Switch to plan mode, and propose an implementation plan.  Await my feedback.
-4. Add your implementation plan as a comment on the issue.
-5. Implement your plan.
-6. Run existing tests, and add new ones if necessary.  Remember to include CI. Remember the linter and that bundler will fail if it's out of sync with its lockfile.
-7. **CRITICAL:** Test the actual functionality manually before committing. If it's a CLI command, run it. If it's library code, test it in the appropriate context. Never commit untested code.
-8. Commit the change with a semantic, ONE LINE message, like 'feat: create task_definition structure'.
-9. **CRITICAL:** Halt while CI runs and await my feedback.
-10. Add resolution details as a comment on the GitHub issue.
-11. Resolve the GitHub issue.
-
-Consider if you need to update requirements/SCRATCH.md for the next run.
-
-## Output
-
-An implementation, test coverage, updated CI, and a closed ticket.

data/requirements/tasks/optimize.md

@@ -1,30 +0,0 @@
-
-# Task
-
-## Name
-
-Optimize
-
-## Inputs
-
-- :persona string - the persona to adopt when executing this task (default: ruby-engineer)
-
-## Persona
-
-Adopt the `requirements/personas/:persona.md` persona while executing these instructions, please.
-
-## Instructions
-
-Suggest an improvement that could improve the quality of the codebase or developer experience.  Things like:
-- opportunities to reduce lines of code
-- DRYing up code
-- Dead code paths
-- Duplicate utility implementations
-- Magic strings
-- Other forms of tech debt
-
-An important thing to consider is that this code has been written by different agents with different contexts, who may not have been aware of overall patterns.  These kinds of optimizations are high priority.
-
-## Output
-
-Propose ONE high-impact optimization or refactor.

data/requirements/tasks/tag.md

@@ -1,5 +0,0 @@
-Time to release a new version!
-
-1. Update the patch version in lib/language_operator/version.rb and re-run bundler to update the lockfile.
-2. Commit the version with the message "vX.Y.Z" and push to origin.
-3. Tag the new version and push to origin with the --tags argument.