language-operator 0.0.1 → 0.1.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc1890d41e08f23d06230234f5a77672ecb5139721f8744d66e9dab3f2d1ce52
-  data.tar.gz: 140fb96f5ce0ba1329c41ec1bfdaa072655ffd42e3d959acd72d9343b526651e
+  metadata.gz: eb53d7e9ca7cceedb04334c17bcfde8c976f94916c2da54c35de1dee3884444e
+  data.tar.gz: 0b71cd8e346ae4a058806e5db91165a1a5cd24c63bd9b68fd361b430cd333131
 SHA512:
-  metadata.gz: 3c20e8cabe5b84004ae06d0e54435b36de48500e953739c93222d324e2ee98b9654f50cb8b6005c2492224dc5635b84bbea72a4019cfe21375aa159c74590e4d
-  data.tar.gz: 1b125cd94f4d382b73cba3ca17aa3e92ab5b50b0e897099f2e8da6e677ddc438019df6d424e38466e1802649b4d8a365b2696f6379047c97f05aa0f3e28565cf
+  metadata.gz: 85349b922729847281abeadcf0bc27a0abff89034c97ffe01d0c8b1adfd97db104622c9f9bb4a9f16e65b90e9ad22dd6c6ede84c61714e210b2da72b3c7050e0
+  data.tar.gz: d2daaeb57d6ce2fbe50e231980d306e5b5bd4b592cade3bbf3a92df15b3733db53b6f12c693c68af5ee82d27f5f6902aab724c80ef589d0ed7733719018469df

data/.rubocop.yml

@@ -0,0 +1,125 @@
+# RuboCop configuration for language-operator gem
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.2
+  SuggestExtensions: false
+  Exclude:
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'bin/bump-version'
+    - 'lib/language_operator/cli/templates/**/*'
+
+# Metrics
+Metrics/BlockLength:
+  Max: 30
+  Exclude:
+    - 'spec/**/*'
+    - 'Rakefile'
+    - '*.gemspec'
+    - 'test_*.rb'
+    - 'examples/**/*'
+
+Metrics/MethodLength:
+  Max: 35
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/language_operator/dsl/**/*'
+    - 'lib/language_operator/cli/**/*'
+    - 'lib/language_operator/client/**/*'
+    - 'lib/language_operator/agent/**/*'
+
+Metrics/AbcSize:
+  Max: 35
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/language_operator/dsl/**/*'
+    - 'lib/language_operator/cli/**/*'
+    - 'lib/language_operator/client/**/*'
+    - 'lib/language_operator/agent/**/*'
+
+Metrics/ClassLength:
+  Max: 175
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/language_operator/cli/**/*'
+    - 'lib/language_operator/agent/**/*'
+    - 'lib/language_operator/kubernetes/**/*'
+
+Metrics/ModuleLength:
+  Max: 150
+  Exclude:
+    - 'spec/**/*'
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/language_operator/dsl/**/*'
+    - 'lib/language_operator/cli/**/*'
+
+Metrics/PerceivedComplexity:
+  Max: 15
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/language_operator/dsl/**/*'
+    - 'lib/language_operator/cli/**/*'
+
+Metrics/ParameterLists:
+  Max: 8
+  CountKeywordArgs: false
+
+# Lint
+Lint/DuplicateMethods:
+  Exclude:
+    - 'lib/language_operator/dsl/**/*'
+
+Lint/DuplicateBranch:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  AllowUnusedKeywordArguments: true
+
+Lint/UnusedBlockArgument:
+  AllowUnusedKeywordArguments: true
+
+# Style
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+Style/OptionalBooleanParameter:
+  Enabled: false
+
+Style/EmptyElse:
+  Enabled: false
+
+# Gemspec
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+# Naming
+Naming/AccessorMethodName:
+  Enabled: false
+
+Naming/MethodParameterName:
+  Exclude:
+    - 'examples/**/*'
+    - 'lib/language_operator/agent/webhook_authenticator.rb'
+
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/language_operator/agent/webhook_authenticator.rb'
+
+# Layout
+Layout/LineLength:
+  Max: 155
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'

data/CHANGELOG.md

@@ -0,0 +1,88 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- **Schema Version Method**: Added `LanguageOperator::Dsl::Schema.version` method that returns the current schema version (linked to gem version)
+- **Schema Versioning Documentation**: Added comprehensive `docs/dsl/SCHEMA_VERSION.md` documenting versioning policy, semantic version semantics for schema changes, compatibility rules, and deprecation policy
+- **Schema Export CLI Commands**: New `aictl system schema` command for exporting DSL schema
+  - Export as JSON Schema v7 (default): `aictl system schema`
+  - Export as YAML: `aictl system schema --format yaml`
+  - Export as OpenAPI 3.0.3 spec: `aictl system schema --format openapi`
+  - Show version only: `aictl system schema --version`
+- **Synthesis Template Management**: New `aictl system synthesis-template` command for managing code generation templates
+  - Export agent synthesis template: `aictl system synthesis-template`
+  - Export persona distillation template: `aictl system synthesis-template --type persona`
+  - Export with JSON/YAML metadata: `aictl system synthesis-template --format json --with-schema`
+  - Validate template syntax: `aictl system synthesis-template --validate`
+- **Template Validation**: New `aictl system validate-template` command for validating synthesis templates
+  - Validate custom templates: `aictl system validate-template --template /path/to/template.tmpl`
+  - Validate bundled templates: `aictl system validate-template --type agent`
+  - AST-based validation against DSL schema
+  - Detailed violation reporting with line numbers
+- **Synthesis Testing**: New `aictl system test-synthesis` command for testing agent code generation
+  - Test synthesis from natural language: `aictl system test-synthesis --instructions "Monitor GitHub issues"`
+  - Dry-run mode to preview prompts: `--dry-run`
+  - Automatic temporal intent detection (scheduled vs autonomous)
+  - LLM-powered code generation with validation
+- **Schema Artifacts**: Auto-generated schema artifacts stored in `lib/language_operator/templates/schema/`
+  - `agent_dsl_schema.json` - Complete JSON Schema v7 specification
+  - `agent_dsl_openapi.yaml` - OpenAPI 3.0.3 API documentation
+  - `CHANGELOG.md` - Schema version history
+- **Safe Methods API**: New public methods on `LanguageOperator::Dsl::Schema`
+  - `Schema.safe_agent_methods` - Returns array of safe agent DSL methods
+  - `Schema.safe_tool_methods` - Returns array of safe tool DSL methods
+  - `Schema.safe_helper_methods` - Returns array of safe helper methods
+- Schema version method includes YARD documentation with examples
+- Tests added for schema version access and validation
+- Integration tests for all new CLI commands
+
+### Changed
+- **GitHub Migration**: Migrated project from self-hosted Forgejo to GitHub
+  - Repository now hosted at: https://github.com/language-operator/language-operator-gem
+  - Updated all infrastructure references to use public GitHub resources
+  - Container images now use GitHub Container Registry (ghcr.io)
+  - Helm charts now use GitHub Pages (https://language-operator.github.io/charts)
+  - Tool registry now uses GitHub raw content URLs
+  - Migrated CI/CD from Forgejo workflows to GitHub Actions
+  - Better community access and collaboration
+
+### Security
+- **Removed hardcoded API token** from tool registry configuration
+- Token authentication now uses environment variables (`GITHUB_TOKEN`)
+- Improved security posture by eliminating embedded credentials
+
+### Changed (Previous)
+- **Gem Hosting Migration**: Switched primary gem hosting from self-hosted Forgejo registry to RubyGems.org
+  - RubyGems.org is now the primary publishing target for better discoverability and easier installation
+  - Forgejo registry remains as an optional fallback (publishes if `REGISTRY_TOKEN` secret is configured)
+  - Updated CI workflow to prioritize RubyGems.org publishing
+  - Added installation instructions and RubyGems badge to README.md
+  - Users can now install via: `gem install language-operator`
+- **License**: Updated gemspec license from MIT to FSL-1.1-Apache-2.0 to match LICENSE file
+- **Repository Cleanup**: Removed `.rspec_status` from version control (already in .gitignore)
+
+## [0.1.0] - 2025-11-05
+
+### Added
+- Initial release of language-operator Ruby gem
+- `aictl` CLI tool for managing AI agents on Kubernetes
+- DSL for defining agents, tools, and workflows
+- Support for MCP (Model Context Protocol) servers
+- Integration with multiple LLM providers (Anthropic, OpenAI, etc.)
+- Kubernetes resource management for LanguageAgent, LanguageModel, and LanguagePersona CRDs
+- Agent lifecycle management (create, list, describe, delete, logs, pause, resume)
+- Tool scaffolding and management
+- Persona management for agent behavior customization
+- Cluster configuration and context switching
+- Comprehensive test suite with unit and e2e tests
+- RuboCop linting configuration
+- Makefile for common development tasks
+
+[Unreleased]: https://github.com/langop/language-operator/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/langop/language-operator/releases/tag/v0.1.0

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in language-operator.gemspec
+gemspec
+
+gem 'pry', '~> 0.14', group: :development

data/Gemfile.lock

@@ -0,0 +1,284 @@
+PATH
+  remote: .
+  specs:
+    language-operator (0.1.31)
+      k8s-ruby (~> 0.17)
+      mcp (~> 0.4)
+      opentelemetry-exporter-otlp (~> 0.27)
+      opentelemetry-instrumentation-http (~> 0.23)
+      opentelemetry-instrumentation-rack (~> 0.24)
+      opentelemetry-sdk (~> 1.4)
+      parser (~> 3.0)
+      pastel (~> 0.8)
+      puma (~> 6.0)
+      rack (~> 3.0)
+      rackup (~> 2.0)
+      rouge (~> 4.0)
+      ruby_llm (~> 1.8)
+      ruby_llm-mcp (~> 0.1)
+      rufus-scheduler (~> 3.9)
+      thor (~> 1.3)
+      tty-prompt (~> 0.23)
+      tty-spinner (~> 0.9)
+      tty-table (~> 0.12)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (3.3.1)
+    coderay (1.1.3)
+    concurrent-ruby (1.3.5)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    diff-lcs (1.6.2)
+    dry-configurable (1.3.0)
+      dry-core (~> 1.1)
+      zeitwerk (~> 2.6)
+    dry-core (1.1.0)
+      concurrent-ruby (~> 1.0)
+      logger
+      zeitwerk (~> 2.6)
+    dry-inflector (1.2.0)
+    dry-logic (1.6.0)
+      bigdecimal
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.1)
+      zeitwerk (~> 2.6)
+    dry-struct (1.8.0)
+      dry-core (~> 1.1)
+      dry-types (~> 1.8, >= 1.8.2)
+      ice_nine (~> 0.11)
+      zeitwerk (~> 2.6)
+    dry-types (1.8.3)
+      bigdecimal (~> 3.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0)
+      dry-inflector (~> 1.0)
+      dry-logic (~> 1.4)
+      zeitwerk (~> 2.6)
+    et-orbi (1.4.0)
+      tzinfo
+    event_stream_parser (1.0.0)
+    excon (0.112.0)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-multipart (1.1.1)
+      multipart-post (~> 2.0)
+    faraday-net_http (3.4.1)
+      net-http (>= 0.5.0)
+    faraday-retry (2.3.2)
+      faraday (~> 2.0)
+    fugit (1.12.1)
+      et-orbi (~> 1.4)
+      raabro (~> 1.4)
+    google-protobuf (4.33.0)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.33.0-x86_64-linux-gnu)
+      bigdecimal
+      rake (>= 13)
+    googleapis-common-protos-types (1.22.0)
+      google-protobuf (~> 4.26)
+    hashdiff (1.2.1)
+    http-2 (1.1.1)
+    httpx (1.6.3)
+      http-2 (>= 1.0.0)
+    ice_nine (0.11.2)
+    json (2.15.2)
+    json-schema (5.2.2)
+      addressable (~> 2.8)
+      bigdecimal (~> 3.1)
+    json_rpc_handler (0.1.1)
+    jsonpath (1.1.5)
+      multi_json
+    k8s-ruby (0.17.2)
+      base64
+      dry-configurable
+      dry-struct
+      dry-types
+      excon (~> 0.71)
+      hashdiff (~> 1.0)
+      jsonpath (~> 1.1)
+      recursive-open-struct (~> 1.1, >= 1.1.3)
+      yajl-ruby (~> 1.4)
+      yaml-safe_load_stream3
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    marcel (1.1.0)
+    mcp (0.4.0)
+      json-schema (>= 4.1)
+      json_rpc_handler (~> 0.1)
+    method_source (1.1.0)
+    multi_json (1.17.0)
+    multipart-post (2.4.1)
+    net-http (0.7.0)
+      uri
+    nio4r (2.7.5)
+    opentelemetry-api (1.7.0)
+    opentelemetry-common (0.23.0)
+      opentelemetry-api (~> 1.0)
+    opentelemetry-exporter-otlp (0.31.1)
+      google-protobuf (>= 3.18)
+      googleapis-common-protos-types (~> 1.3)
+      opentelemetry-api (~> 1.1)
+      opentelemetry-common (~> 0.20)
+      opentelemetry-sdk (~> 1.10)
+      opentelemetry-semantic_conventions
+    opentelemetry-instrumentation-base (0.25.0)
+      opentelemetry-api (~> 1.7)
+      opentelemetry-common (~> 0.21)
+      opentelemetry-registry (~> 0.1)
+    opentelemetry-instrumentation-http (0.27.0)
+      opentelemetry-instrumentation-base (~> 0.25)
+    opentelemetry-instrumentation-rack (0.29.0)
+      opentelemetry-instrumentation-base (~> 0.25)
+    opentelemetry-registry (0.4.0)
+      opentelemetry-api (~> 1.1)
+    opentelemetry-sdk (1.10.0)
+      opentelemetry-api (~> 1.1)
+      opentelemetry-common (~> 0.20)
+      opentelemetry-registry (~> 0.2)
+      opentelemetry-semantic_conventions
+    opentelemetry-semantic_conventions (1.36.0)
+      opentelemetry-api (~> 1.0)
+    ostruct (0.6.3)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    prism (1.6.0)
+    pry (0.15.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (6.0.2)
+    puma (6.6.1)
+      nio4r (~> 2.0)
+    raabro (1.4.0)
+    racc (1.8.1)
+    rack (3.2.4)
+    rack-test (2.2.0)
+      rack (>= 1.3)
+    rackup (2.2.1)
+      rack (>= 3)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    recursive-open-struct (1.3.1)
+      ostruct
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rouge (4.6.1)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (1.81.7)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.47.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    ruby_llm (1.9.1)
+      base64
+      event_stream_parser (~> 1)
+      faraday (>= 1.10.0)
+      faraday-multipart (>= 1)
+      faraday-net_http (>= 1)
+      faraday-retry (>= 1)
+      marcel (~> 1.0)
+      ruby_llm-schema (~> 0.2.1)
+      zeitwerk (~> 2)
+    ruby_llm-mcp (0.7.0)
+      httpx (~> 1.4)
+      json-schema (~> 5.0)
+      ruby_llm (~> 1.9)
+      zeitwerk (~> 2)
+    ruby_llm-schema (0.2.1)
+    rufus-scheduler (3.9.2)
+      fugit (~> 1.1, >= 1.11.1)
+    strings (0.2.1)
+      strings-ansi (~> 0.2)
+      unicode-display_width (>= 1.5, < 3.0)
+      unicode_utils (~> 1.4)
+    strings-ansi (0.2.0)
+    thor (1.4.0)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.2)
+    tty-spinner (0.9.3)
+      tty-cursor (~> 0.7)
+    tty-table (0.12.0)
+      pastel (~> 0.8)
+      strings (~> 0.2.0)
+      tty-screen (~> 0.8)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.6.0)
+    unicode_utils (1.4.0)
+    uri (1.1.1)
+    webmock (3.26.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+    wisper (2.0.1)
+    yajl-ruby (1.4.3)
+    yaml-safe_load_stream3 (0.1.2)
+    yard (0.9.37)
+    zeitwerk (2.7.3)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  language-operator!
+  pry (~> 0.14)
+  rack-test (~> 2.1)
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.60)
+  rubocop-performance (~> 1.20)
+  webmock (~> 3.23)
+  yard (~> 0.9.37)
+
+BUNDLED WITH
+   2.6.9