conversant 1.0.18 → 1.0.20

data/lib/conversant/v3/services/lms/job.rb

@@ -4,9 +4,9 @@ module Conversant
   module V3
     module Services
       class LMS
-        # Job management service for live streaming operations
+        # Job management service for live-streaming operations
         #
-        # Provides comprehensive job management functionality for live streaming including:
+        # Provides comprehensive job management functionality for live-streaming including:
         # - Job listing and filtering
         # - Job status tracking
         # - Stream profile information
@@ -61,9 +61,15 @@ module Conversant
           #   - :encoder [String] encoder IP address
           #   - :server [String] execution server
           #   - :manifest [String] manifest URL
-          #   - :profiles [Array<Hash>] array of stream profiles
+          #   - :profiles_count [Integer] number of stream profiles
           #   - :transcoding [Boolean] transcoding enabled
           #   - :gpu [Boolean] GPU acceleration enabled
+          #   - :ha [Boolean] high availability enabled
+          #   - :dvr [Boolean] DVR enabled
+          #   - :dai [Boolean] dynamic ad insertion enabled
+          #   - :encrypted [Boolean] stream encryption enabled
+          #   - :ingest_url [String] RTMP ingest URL
+          #   - :play_domain [String] playback domain
           #
           # @example Get streaming jobs
           #   jobs = lms.job.where(status: 'streaming', limit: 50)
@@ -75,23 +81,19 @@ module Conversant
           #   all_jobs = lms.job.where
           #
           # @since 1.0.0
+          # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
           def where(**params)
             response = JSON.parse(@parent.send(:call, 'GET', "/v4/streams?#{params.to_query}"))
             return nil unless response
 
-            items = response['list'] || response[:list] || []
+            items = [response['list'] || response[:list] || []].flatten.map(&:with_indifferent_access)
 
             items.map do |item|
-              status = item['status']&.to_i || item[:status]&.to_i
-              inbound = item['stream_rtmp_inbound'] || item[:stream_rtmp_inbound]
-
-              profiles = (item['stream_rtmp_outbounds'] || item[:stream_rtmp_outbounds])&.map do |stream|
-                {
-                  preset: stream['preset_name'] || stream[:preset_name],
-                  type: stream['type'] || stream[:type],
-                  profile: build_profile_url(inbound, item, stream)
-                }
-              end
+              status = item[:status]&.to_i
+              inbound = item[:stream_rtmp_inbound]
+              play_domain = item[:play_domain] || item['play_domain']
+              outbounds = item[:stream_rtmp_outbounds] || item['stream_rtmp_outbounds'] || []
+              output_type = outbounds.first && (outbounds.first['type'] || outbounds.first[:type])
 
               {
                 entity: item['osp_id'] || item[:osp_id],
@@ -103,31 +105,44 @@ module Conversant
                 started_at: parse_timestamp(item['started'] || item[:started]),
                 ended_at: parse_timestamp(item['ended'] || item[:ended]),
                 client: inbound && (inbound['client_ip'] || inbound[:client_ip]),
+                ingest_url: inbound&.dig(:push_url) || inbound&.dig('push_url'),
                 encoder: extract_encoder(item),
                 server: item['exec_ta'] || item[:exec_ta],
-                manifest: build_manifest_url(inbound, item, profiles),
-                profiles: profiles || [],
+                manifest: build_manifest_url(play_domain, item, output_type),
+                profiles_count: outbounds.size,
                 transcoding: item['transcoding'] || item[:transcoding],
-                gpu: (item['gpu'] || item[:gpu]) == 'gpu'
+                gpu: (item['gpu'] || item[:gpu]) == 'gpu',
+                ha: item['ha'] || item[:ha],
+                dvr: item['dvr'] || item[:dvr],
+                dai: item['dai'] || item[:dai],
+                encrypted: item[:stream_encrypts]&.any? || item['stream_encrypts']&.any?,
+                play_domain: play_domain
               }
             end
           rescue StandardError => e
             @parent.send(:logger).error "LMS::Job.where error: #{e.message}"
             nil
           end
+          # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
           private
 
           # Parse numeric status code to string
           #
           # @param status [Integer] numeric status code
-          # @return [String, Integer] status string or original code if unknown
+          # @return [String] status string or 'unknown_N' if unknown
           def parse_status(status)
             case status
             when 1 then 'ready'
             when 2 then 'streaming'
+            when 3 then 'stopped'
+            when 4 then 'error'
+            when 5 then 'starting'
+            when 6 then 'stopping'
+            when 7 then 'restarting'
+            when 8 then 'pending'
             when 12 then 'interrupted'
-            else status
+            else "unknown_#{status}"
             end
           end
 
@@ -164,48 +179,23 @@ module Conversant
             end
           end
 
-          # Build profile URL for a stream
-          #
-          # @param inbound [Hash] inbound stream configuration
-          # @param item [Hash] job item hash
-          # @param stream [Hash] stream profile configuration
-          # @return [String, nil] profile URL or nil if inbound is missing
-          def build_profile_url(inbound, item, stream)
-            return nil unless inbound
-
-            domain = inbound['domain'] || inbound[:domain]
-            app = item['app'] || item[:app]
-            stream_name = item['stream'] || item[:stream]
-            preset = stream['preset_name'] || stream[:preset_name]
-            type = stream['type'] || stream[:type]
-
-            "http://#{domain}/#{app}/#{stream_name}-#{preset}#{stream_extension(type)}"
-          end
-
           # Build manifest URL for a job
           #
-          # @param inbound [Hash] inbound stream configuration
+          # @param play_domain [String] playback domain
           # @param item [Hash] job item hash
-          # @param profiles [Array<Hash>] array of stream profiles
-          # @return [String, nil] manifest URL or nil if inbound is missing
-          def build_manifest_url(inbound, item, profiles)
-            return nil unless inbound
+          # @param output_type [String] output stream type ('hls', 'dash')
+          # @return [String, nil] manifest URL or nil if play_domain is missing
+          def build_manifest_url(play_domain, item, output_type)
+            return nil unless play_domain
 
-            domain = inbound['domain'] || inbound[:domain]
             app = item['app'] || item[:app]
             manifest_name = item['manifest_name'] || item[:manifest_name]
+            ext = stream_extension(output_type)
 
-            ext = if profiles&.first
-                    type = profiles.first[:type]
-                    stream_extension(type)
-                  else
-                    ''
-                  end
-
-            "http://#{domain}/#{app}/#{manifest_name}#{ext}"
+            "https://#{play_domain}/#{app}/#{manifest_name}#{ext}"
           end
         end
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/lms/partner/analytics.rb

@@ -263,4 +263,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/lms/partner.rb

@@ -55,4 +55,4 @@ end
 # Load nested analytics class after Partner is defined
 require_relative 'partner/analytics'
 require_relative 'partner/report'
-require_relative 'partner/business'
+require_relative 'partner/business'

data/lib/conversant/v3/services/lms/preset.rb

@@ -54,4 +54,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/lms.rb

@@ -104,8 +104,6 @@ module Conversant
           response.body
         end
 
-        protected
-
         def service_endpoint
           configuration.private_lms_endpoint
         end

data/lib/conversant/v3/services/oss/partner/analytics.rb

@@ -102,4 +102,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/oss/partner.rb

@@ -45,4 +45,4 @@ module Conversant
 end
 
 # Load nested analytics class after Partner is defined
-require_relative 'partner/analytics'
+require_relative 'partner/analytics'

data/lib/conversant/v3/services/oss.rb

@@ -125,4 +125,4 @@ module Conversant
 end
 
 # Load nested service classes after OSS is defined
-require_relative 'oss/partner'
+require_relative 'oss/partner'

data/lib/conversant/v3/services/portal/dashboard.rb

@@ -111,4 +111,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/portal.rb

@@ -84,7 +84,7 @@ module Conversant
                 deleted: item['deleted'],
                 pop: item['pop'],
                 volume: item['volume'],
-                federation: item['federationVolume'],
+                federation: item['federationVolume']
               }
             end.to_json
 

data/lib/conversant/v3/services/vms/analytics.rb

@@ -111,4 +111,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/vms/business.rb

@@ -187,4 +187,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/vms/partner/analytics.rb

@@ -130,4 +130,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/vms/transcoding.rb

@@ -108,7 +108,7 @@ module Conversant
             response = @parent.send(:call, 'GET', "/v2/jobs?#{merged_payload.to_query}")
             return [] if response.nil?
 
-            JSON.parse(response)&.[]("list") || []
+            JSON.parse(response)&.[]('list') || []
           rescue StandardError => e
             logger.error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             []
@@ -163,7 +163,7 @@ module Conversant
             response = @parent.send(:call, 'GET', "/v2/osp/presets?#{merged_payload.to_query}")
             return [] if response.nil?
 
-            JSON.parse(response)&.[]("list") || []
+            JSON.parse(response)&.[]('list') || []
           rescue StandardError => e
             logger.error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             []
@@ -181,4 +181,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3.rb

@@ -33,4 +33,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Conversant
-  VERSION = '1.0.18'
+  VERSION = '1.0.20'
 end

data/plans/templates/bug-fix-template.md

@@ -0,0 +1,69 @@
+# [Bug Fix] Implementation Plan
+
+**Date**: YYYY-MM-DD  
+**Type**: Bug Fix  
+**Priority**: [Critical/High/Medium/Low]  
+**Context Tokens**: <150 words
+
+## Executive Summary
+Brief description of the bug and its impact.
+
+## Issue Analysis
+### Symptoms
+- [ ] Symptom 1
+- [ ] Symptom 2
+
+### Root Cause
+Brief explanation of the underlying cause.
+
+### Evidence
+- **Logs**: Reference to log files (don't include full logs)
+- **Error Messages**: Key error patterns
+- **Affected Components**: List of impacted files/modules
+
+## Context Links
+- **Related Issues**: [GitHub issue numbers]
+- **Recent Changes**: [Relevant commits or PRs]
+- **Dependencies**: [Related systems]
+
+## Solution Design
+### Approach
+High-level fix strategy in 2-3 sentences.
+
+### Changes Required
+1. **File 1** (`path/to/file.ts`): Brief change description
+2. **File 2** (`path/to/file.ts`): Brief change description
+
+### Testing Changes
+- [ ] Update existing tests
+- [ ] Add new test cases
+- [ ] Validate fix doesn't break existing functionality
+
+## Implementation Steps
+1. [ ] Step 1 - file: `path/to/file.ts`
+2. [ ] Step 2 - file: `path/to/file.ts`
+3. [ ] Run test suite
+4. [ ] Validate fix in relevant environments
+
+## Verification Plan
+### Test Cases
+- [ ] Test case 1: Expected behavior
+- [ ] Test case 2: Edge case handling
+- [ ] Regression test: Ensure no new issues
+
+### Rollback Plan
+If the fix causes issues:
+1. Revert commit: `git revert <commit-hash>`
+2. Restore previous behavior in files X, Y, Z
+
+## Risk Assessment
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Risk 1 | Medium | Mitigation plan |
+
+## TODO Checklist
+- [ ] Implement fix
+- [ ] Update tests
+- [ ] Run full test suite
+- [ ] Code review
+- [ ] Deploy and verify

data/plans/templates/feature-implementation-template.md

@@ -0,0 +1,84 @@
+# [Feature Name] Implementation Plan
+
+**Date**: YYYY-MM-DD  
+**Type**: Feature Implementation  
+**Status**: Planning  
+**Context Tokens**: <200 words
+
+## Executive Summary
+Brief 2-3 sentence description of the feature and its business value.
+
+## Context Links
+- **Related Plans**: [List other plan files - no full content]
+- **Dependencies**: [External systems, APIs, existing features]
+- **Reference Docs**: [Link to docs in ./docs directory]
+
+## Requirements
+### Functional Requirements
+- [ ] Requirement 1
+- [ ] Requirement 2
+
+### Non-Functional Requirements  
+- [ ] Performance target
+- [ ] Security requirement
+- [ ] Scalability requirement
+
+## Architecture Overview
+```mermaid
+[Simple component diagram]
+```
+
+### Key Components
+- **Component 1**: Brief description
+- **Component 2**: Brief description
+
+### Data Models
+- **Model 1**: Key fields
+- **Model 2**: Key fields
+
+## Implementation Phases
+
+### Phase 1: [Name] (Est: X days)
+**Scope**: Specific boundaries
+**Tasks**:
+1. [ ] Task 1 - file: `path/to/file.ts`
+2. [ ] Task 2 - file: `path/to/file.ts`
+
+**Acceptance Criteria**:
+- [ ] Criteria 1
+- [ ] Criteria 2
+
+### Phase 2: [Name] (Est: X days)
+[Repeat structure]
+
+## Testing Strategy
+- **Unit Tests**: Specific test coverage targets
+- **Integration Tests**: Key interaction points
+- **E2E Tests**: Critical user flows
+
+## Security Considerations
+- [ ] Security item 1
+- [ ] Security item 2
+
+## Risk Assessment
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Risk 1 | High | Mitigation strategy |
+
+## Quick Reference
+### Key Commands
+```bash
+npm run command
+```
+
+### Configuration Files
+- `config/file.ts`: Purpose
+- `.env.example`: Environment variables
+
+## TODO Checklist
+- [ ] Phase 1 Task 1
+- [ ] Phase 1 Task 2
+- [ ] Phase 2 Task 1
+- [ ] Testing complete
+- [ ] Documentation updated
+- [ ] Code review passed

data/plans/templates/refactor-template.md

@@ -0,0 +1,82 @@
+# [Component/Module] Refactoring Plan
+
+**Date**: YYYY-MM-DD  
+**Type**: Refactoring  
+**Scope**: [Module/Component/System level]  
+**Context Tokens**: <200 words
+
+## Executive Summary
+Brief description of what is being refactored and why.
+
+## Current State Analysis
+### Issues with Current Implementation
+- [ ] Issue 1: Performance bottleneck
+- [ ] Issue 2: Code maintainability
+- [ ] Issue 3: Technical debt
+
+### Metrics (Before)
+- **Performance**: Current benchmarks
+- **Code Quality**: Complexity metrics
+- **Test Coverage**: Current percentage
+
+## Context Links
+- **Affected Modules**: [List without full content]
+- **Dependencies**: [Other systems impacted]
+- **Related Documentation**: [Links to docs]
+
+## Refactoring Strategy
+### Approach
+High-level strategy for the refactoring in 2-3 sentences.
+
+### Architecture Changes
+```mermaid
+[Before/After comparison diagram]
+```
+
+### Key Improvements
+- **Improvement 1**: Brief description
+- **Improvement 2**: Brief description
+
+## Implementation Plan
+
+### Phase 1: Preparation (Est: X days)
+**Scope**: Setup and preparation work
+1. [ ] Create comprehensive tests for current functionality
+2. [ ] Document current behavior
+3. [ ] Identify all dependencies
+
+### Phase 2: Core Refactoring (Est: X days)
+**Scope**: Main refactoring work
+1. [ ] Refactor component A - file: `path/to/file.ts`
+2. [ ] Refactor component B - file: `path/to/file.ts`
+3. [ ] Update integration points
+
+### Phase 3: Integration & Testing (Est: X days)
+**Scope**: Validation and cleanup
+1. [ ] Integration testing
+2. [ ] Performance validation
+3. [ ] Documentation updates
+
+## Backward Compatibility
+- **Breaking Changes**: [List any breaking changes]
+- **Migration Path**: [Steps for users/systems]
+- **Deprecation Timeline**: [If applicable]
+
+## Success Metrics (After)
+- **Performance**: Target improvements
+- **Code Quality**: Target metrics
+- **Test Coverage**: Target percentage
+
+## Risk Assessment
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Breaking changes | High | Comprehensive testing |
+| Performance regression | Medium | Benchmarking |
+
+## TODO Checklist
+- [ ] Phase 1: Preparation complete
+- [ ] Phase 2: Core refactoring complete  
+- [ ] Phase 3: Integration complete
+- [ ] Performance benchmarks validated
+- [ ] Documentation updated
+- [ ] Code review passed

data/plans/templates/template-usage-guide.md

@@ -0,0 +1,58 @@
+# Plan Template Usage Guide
+
+## Template Selection
+
+### Feature Implementation Template
+**Use when**: Adding new functionality, endpoints, services, or modules
+**File**: `feature-implementation-template.md`
+**Size**: Medium to large scope changes
+
+### Bug Fix Template  
+**Use when**: Fixing specific issues, errors, or broken functionality
+**File**: `bug-fix-template.md`
+**Size**: Small to medium scope changes
+
+### Refactoring Template
+**Use when**: Improving code structure, performance, or maintainability without changing functionality
+**File**: `refactor-template.md` 
+**Size**: Medium to large scope changes
+
+## Context Management Best Practices
+
+### Keep Plans Focused
+- **Executive Summary**: Max 3 sentences
+- **Context Links**: Reference files, don't include full content
+- **Tasks**: Max 10 per phase
+- **Context Tokens**: Target <200 words for summaries
+
+### Template Adaptation
+1. Copy the appropriate template to `plans/YYMMDD-feature-name-plan.md`
+2. Replace bracketed placeholders with actual content
+3. Remove sections not relevant to your specific use case
+4. Keep the core structure intact for consistency
+
+### Cross-References Instead of Duplication
+- Link to existing documentation in `./docs/`
+- Reference other plans without copying content
+- Use file paths instead of code blocks where possible
+- Focus on "what" and "why", not detailed "how"
+
+## Quality Checklist
+
+Before finalizing any plan:
+- [ ] Executive summary is clear and concise
+- [ ] Tasks are specific and actionable
+- [ ] File paths are included for implementation tasks
+- [ ] Success criteria are measurable
+- [ ] Context links are used instead of full content
+- [ ] TODO checklist is complete and realistic
+
+## Context Refresh Triggers
+
+Use these templates when:
+- Starting a new development phase
+- Switching between different types of work (feature → bugfix)
+- After major context accumulation (>8000 tokens)
+- When agent handoffs occur
+
+This ensures each plan starts with fresh, focused context optimized for the specific task type.

data/sig/conversant/v3/services/lms.rbs

@@ -9,16 +9,15 @@ module Conversant
           attr_reader parent: LMS
 
           def initialize: (LMS parent) -> void
-          def where: (**untyped params) -> Array[Hash[String, untyped]]
+          def where: (**untyped params) -> Array[Hash[Symbol, untyped]]?
 
           private
 
-          def parse_status: (Integer | String | nil status) -> String
+          def parse_status: (Integer status) -> String
           def parse_timestamp: (Integer | String | nil timestamp) -> DateTime?
           def extract_encoder: (Hash[String | Symbol, untyped] item) -> String
           def stream_extension: (String? type) -> String
-          def build_profile_url: (Hash[String | Symbol, untyped]? inbound, Hash[String | Symbol, untyped] item, Hash[String | Symbol, untyped]? stream) -> String?
-          def build_manifest_url: (Hash[String | Symbol, untyped]? inbound, Hash[String | Symbol, untyped] item, Array[Hash[Symbol, untyped]]? profiles) -> String?
+          def build_manifest_url: (String? play_domain, Hash[String | Symbol, untyped] item, String? output_type) -> String?
         end
 
         # Domain management for LMS

data/sig/conversant/v3.rbs

@@ -29,7 +29,6 @@ module Conversant
 
     # HTTP client module
     module HttpClient
-      LOGIN_URL: String
       PORTAL_SESSION_REDIS_KEY: String
       SSO_GW_SESSION2_REDIS_KEY: String
 
@@ -48,6 +47,7 @@ module Conversant
       def update_cookie_jar: (untyped response) -> void
       def parse_cookie_to_jar: (String cookie_string) -> void
       def extract_form_action: (String html_body) -> String?
+      def login_url: () -> String
       def configuration: () -> Conversant::Configuration
       def redis: () -> untyped
     end