igniter 0.5.1 → 0.5.2

data/bin/igniter-stack

@@ -1,94 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "optparse"
-
-options = {
-  port: 4567,
-  host: "0.0.0.0",
-  requires: [],
-  config: nil,
-  minimal: false,
-  profile: nil
-}
-
-global = OptionParser.new do |opts|
-  opts.banner = <<~BANNER
-    igniter-stack — stack scaffold and HTTP server toolkit for Igniter
-
-    Usage:
-      igniter-stack start [options]
-      igniter-stack new APP_NAME [--minimal] [--profile dashboard|cluster|playground]
-
-  BANNER
-
-  opts.on("--port PORT", Integer, "Port to listen on (default: 4567)") { |v| options[:port] = v }
-  opts.on("--host HOST",          "Host to bind to (default: 0.0.0.0)") { |v| options[:host] = v }
-  opts.on("--require FILE",       "Require a file (can be used multiple times)") { |v| options[:requires] << v }
-  opts.on("--config FILE",        "Load a server config file") { |v| options[:config] = v }
-  opts.on("--minimal",            "Skip demo scaffold — only create directory structure") { options[:minimal] = true }
-  opts.on("--profile NAME",       "Scaffold profile (e.g. dashboard, cluster, playground)") { |v| options[:profile] = v }
-  opts.on("-h", "--help", "Show this help") do
-    puts opts
-    exit
-  end
-  opts.on("-v", "--version", "Show version") do
-    require "igniter/core/version"
-    puts "igniter-stack #{Igniter::VERSION}"
-    exit
-  end
-end
-
-global.parse!
-
-command = ARGV.shift || "start"
-
-case command
-when "start"
-  options[:requires].each { |f| require File.expand_path(f) }
-  load File.expand_path(options[:config]) if options[:config]
-
-  require "igniter/server"
-  require "igniter/core/version"
-
-  Igniter::Server.start(port: options[:port], host: options[:host])
-
-when "new"
-  app_name = ARGV.shift
-  if app_name.nil? || app_name.strip.empty?
-    warn "Usage: igniter-stack new APP_NAME"
-    exit 1
-  end
-
-  if File.exist?(app_name)
-    warn "Error: '#{app_name}' already exists"
-    exit 1
-  end
-
-  require "igniter/app/scaffold_pack"
-
-  mode = options[:minimal] ? " (minimal)" : ""
-  puts "Creating Igniter stack '#{app_name}'#{mode}..."
-  generator_class =
-    case options[:profile].to_s.strip
-    when "", "default", "base"
-      Igniter::App::Generator
-    when "dashboard"
-      Igniter::App::Generators::Dashboard
-    when "cluster"
-      Igniter::App::Generators::Cluster
-    when "playground"
-      Igniter::App::Generators::Playground
-    else
-      warn "Unknown scaffold profile: #{options[:profile].inspect}"
-      warn "Available profiles: dashboard, cluster, playground"
-      exit 1
-    end
-
-  generator_class.new(app_name, minimal: options[:minimal]).generate
-
-else
-  warn "Unknown command: #{command}"
-  warn "Available commands: start, new"
-  exit 1
-end

data/examples/agent_orchestration.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
-require "igniter"
-require "igniter/extensions/provenance"
-
-class ReviewQueueAdapter
-  def call(node:, inputs:, execution: nil) # rubocop:disable Lint/UnusedMethodArgument
-    {
-      status: :pending,
-      payload: {
-        queue: :review,
-        requested_name: inputs.fetch(:name)
-      },
-      agent_trace: {
-        adapter: :queue,
-        mode: :call,
-        via: node.agent_name,
-        message: node.message_name,
-        outcome: :deferred,
-        reason: :awaiting_review
-      }
-    }
-  end
-
-  def cast(node:, inputs:, execution: nil) # rubocop:disable Lint/UnusedMethodArgument
-    {
-      status: :succeeded,
-      output: nil,
-      agent_trace: {
-        adapter: :queue,
-        mode: :cast,
-        via: node.agent_name,
-        message: node.message_name,
-        outcome: :sent
-      }
-    }
-  end
-end
-
-class AgentOrchestrationContract < Igniter::Contract
-  runner :inline, agent_adapter: ReviewQueueAdapter.new
-
-  define do
-    input :name, type: :string
-
-    agent :approval,
-          via: :reviewer,
-          message: :review,
-          inputs: { name: :name }
-
-    agent :notify,
-          via: :reviewer,
-          message: :remember,
-          mode: :cast,
-          inputs: { name: :name }
-
-    output :approval
-    output :notify
-  end
-end
-
-contract = AgentOrchestrationContract.new(name: "Alice")
-approval = contract.result.approval
-plan = contract.orchestration_plan
-report = contract.diagnostics.to_h
-trace = contract.lineage(:approval).trace.value
-
-puts "contract_status=#{report[:status]}"
-puts "approval_pending=#{trace[:pending]}"
-puts "approval_token=#{approval.token}"
-puts "notify=#{contract.result.notify.inspect}"
-puts "attention_nodes=#{plan[:attention_nodes].inspect}"
-puts "actions=#{plan[:by_action].inspect}"
-puts "agents=#{report[:agents].slice(:total, :pending, :succeeded, :failed).inspect}"
-puts "lineage_reason=#{trace.dig(:agent_trace, :reason)}"

data/examples/agents.rb

@@ -1,151 +0,0 @@
-# frozen_string_literal: true
-
-# Agents — stateful actors with supervision and continuous contract loops
-#
-# Demonstrates:
-#   - Igniter::Agent       — stateful message-driven actor
-#   - Igniter::Supervisor  — one_for_one supervision with restart budget
-#   - Igniter::Registry    — looking up agents by name
-#   - Igniter::StreamLoop  — continuous contract tick-loop
-#
-# Run: ruby examples/agents.rb
-
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
-require "igniter"
-require "igniter/core"
-require "igniter-agents"
-
-# ── Contract used by the stream loop ─────────────────────────────────────────
-
-class ThresholdContract < Igniter::Contract
-  define do
-    input :value,     type: :numeric
-    input :threshold, type: :numeric
-
-    compute :status, depends_on: %i[value threshold] do |value:, threshold:|
-      value > threshold ? :alert : :normal
-    end
-
-    output :status
-  end
-end
-
-# ── Counter Agent ─────────────────────────────────────────────────────────────
-
-class CounterAgent < Igniter::Agent
-  initial_state counter: 0, history: []
-
-  on :increment do |state:, payload:, **|
-    by        = payload.fetch(:by, 1)
-    new_count = state[:counter] + by
-    state.merge(
-      counter: new_count,
-      history: (state[:history] + [new_count]).last(10)
-    )
-  end
-
-  on :reset do |state:, **|
-    state.merge(counter: 0, history: [])
-  end
-
-  # Returns the current count to sync callers
-  on :count do |state:, **|
-    state[:counter]
-  end
-
-  # Returns the last N history entries
-  on :history do |state:, payload:, **|
-    state[:history].last(payload.fetch(:n, 5))
-  end
-end
-
-# ── Logger Agent ──────────────────────────────────────────────────────────────
-
-class LoggerAgent < Igniter::Agent
-  initial_state entries: []
-
-  on :log do |state:, payload:, **|
-    ts    = Time.now.strftime("%H:%M:%S")
-    entry = "[#{ts}] #{payload[:message]}"
-    state.merge(entries: (state[:entries] + [entry]).last(100))
-  end
-
-  on :dump do |state:, **|
-    state[:entries]
-  end
-end
-
-# ── Supervisor ────────────────────────────────────────────────────────────────
-
-class AppSupervisor < Igniter::Supervisor
-  strategy     :one_for_one
-  max_restarts 3, within: 10
-
-  children do |c|
-    c.worker :counter, CounterAgent
-    c.worker :logger,  LoggerAgent
-  end
-end
-
-# ── Run: Supervised agents ────────────────────────────────────────────────────
-
-puts "=== Supervised agents ==="
-
-sup     = AppSupervisor.start
-counter = sup.child(:counter)
-logger  = sup.child(:logger)
-
-counter.send(:increment, by: 5)
-counter.send(:increment, by: 3)
-
-total = counter.call(:count)
-puts "counter=#{total}"
-
-logger.send(:log, message: "Counter reached #{total}")
-
-counter.send(:reset)
-counter.send(:increment, by: 10)
-
-new_total = counter.call(:count)
-puts "after_reset=#{new_total}"
-
-hist = counter.call(:history, { n: 5 })
-puts "history=#{hist.inspect}"
-
-# ── Run: Registry ─────────────────────────────────────────────────────────────
-
-puts "\n=== Registry lookup ==="
-
-named_ref = CounterAgent.start(name: :named_counter)
-Igniter::Registry.find(:named_counter).send(:increment, by: 42)
-puts "named_counter=#{named_ref.call(:count)}"
-named_ref.stop
-Igniter::Registry.unregister(:named_counter)
-
-# ── Run: StreamLoop ───────────────────────────────────────────────────────────
-
-puts "\n=== Stream loop ==="
-
-statuses = []
-
-stream = Igniter::StreamLoop.new(
-  contract: ThresholdContract,
-  tick_interval: 0.05,
-  inputs: { value: 20.0, threshold: 25.0 },
-  on_result: ->(result) { statuses << result.status }
-)
-
-stream.start
-sleep(0.15)                            # ~3 ticks at :normal
-stream.update_inputs(value: 30.0)
-sleep(0.15)                            # ~3 ticks at :alert
-stream.stop
-
-puts "statuses_sample=#{statuses.uniq.sort.inspect}"
-
-# ── Teardown ──────────────────────────────────────────────────────────────────
-
-log_entries = logger.call(:dump)
-puts "\nlog_entries=#{log_entries.size}"
-sup.stop
-puts "done=true"

data/examples/async_store.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
-require "igniter"
-require "tmpdir"
-
-class AsyncQuoteExecutor < Igniter::Executor
-  input :order_total, type: :numeric
-
-  def call(order_total:)
-    defer(token: "quote-#{order_total}", payload: { kind: "pricing_quote" })
-  end
-end
-
-class AsyncPricingContract < Igniter::Contract
-  run_with runner: :store
-
-  define do
-    input :order_total, type: :numeric
-
-    compute :quote_total, depends_on: [:order_total], call: AsyncQuoteExecutor
-
-    compute :gross_total, depends_on: [:quote_total] do |quote_total:|
-      quote_total * 1.2
-    end
-
-    output :gross_total
-  end
-end
-
-Dir.mktmpdir("igniter-example-store") do |dir|
-  original_store = Igniter.execution_store
-  Igniter.execution_store = Igniter::Runtime::Stores::FileStore.new(root: dir)
-
-  contract = AsyncPricingContract.new(order_total: 100)
-  deferred = contract.result.gross_total
-  execution_id = contract.execution.events.execution_id
-
-  puts "pending_token=#{deferred.token}"
-  puts "stored_execution_id=#{execution_id}"
-  puts "pending_status=#{contract.result.pending?}"
-
-  resumed = AsyncPricingContract.resume_from_store(execution_id, token: deferred.token, value: 150)
-  puts "resumed_gross_total=#{resumed.result.gross_total}"
-ensure
-  Igniter.execution_store = original_store
-end

data/examples/basic_pricing.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
-require "igniter"
-
-class PriceContract < Igniter::Contract
-  define do
-    input :order_total, type: :numeric
-    input :country, type: :string
-
-    compute :vat_rate, depends_on: [:country] do |country:|
-      country == "UA" ? 0.2 : 0.0
-    end
-
-    compute :gross_total, depends_on: %i[order_total vat_rate] do |order_total:, vat_rate:|
-      order_total * (1 + vat_rate)
-    end
-
-    output :gross_total
-  end
-end
-
-contract = PriceContract.new(order_total: 100, country: "UA")
-
-puts "gross_total=#{contract.result.gross_total}"
-contract.update_inputs(order_total: 150)
-puts "updated_gross_total=#{contract.result.gross_total}"

data/examples/collection.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
-require "igniter"
-
-class TechnicianContract < Igniter::Contract
-  define do
-    input :technician_id
-    input :name
-
-    compute :summary, with: %i[technician_id name] do |technician_id:, name:|
-      { id: technician_id, name: name }
-    end
-
-    output :summary
-  end
-end
-
-class TechnicianBatchContract < Igniter::Contract
-  define do
-    input :technician_inputs, type: :array
-
-    collection :technicians,
-      with: :technician_inputs,
-      each: TechnicianContract,
-      key: :technician_id,
-      mode: :collect
-
-    output :technicians
-  end
-end
-
-contract = TechnicianBatchContract.new(
-  technician_inputs: [
-    { technician_id: 1, name: "Anna" },
-    { technician_id: 2, name: "Mike" }
-  ]
-)
-
-result = contract.result.technicians
-
-puts "keys=#{result.keys.inspect}"
-puts "items=#{result.to_h.inspect}"

data/examples/collection_partial_failure.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
-require "igniter"
-
-class TechnicianAvailabilityContract < Igniter::Contract
-  define do
-    input :technician_id
-    input :active
-
-    guard :active_technician, with: :active, eq: true, message: "Technician inactive"
-
-    compute :summary, with: %i[technician_id active_technician] do |technician_id:, active_technician:|
-      active_technician
-      { id: technician_id, status: "available" }
-    end
-
-    output :summary
-  end
-end
-
-class TechnicianAvailabilityBatchContract < Igniter::Contract
-  define do
-    input :technician_inputs, type: :array
-
-    collection :technicians,
-      with: :technician_inputs,
-      each: TechnicianAvailabilityContract,
-      key: :technician_id,
-      mode: :collect
-
-    output :technicians
-  end
-end
-
-contract = TechnicianAvailabilityBatchContract.new(
-  technician_inputs: [
-    { technician_id: 1, active: true },
-    { technician_id: 2, active: false },
-    { technician_id: 3, active: true }
-  ]
-)
-
-result = contract.result.technicians
-
-puts "summary=#{result.summary.inspect}"
-puts "items_summary=#{result.items_summary.inspect}"
-puts "failed_items=#{result.failed_items.inspect}"
-puts "---"
-puts contract.diagnostics_text

data/examples/composition.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
-require "igniter"
-
-class PriceContract < Igniter::Contract
-  define do
-    input :order_total, type: :numeric
-    input :country, type: :string
-
-    compute :vat_rate, depends_on: [:country] do |country:|
-      country == "UA" ? 0.2 : 0.0
-    end
-
-    compute :gross_total, depends_on: %i[order_total vat_rate] do |order_total:, vat_rate:|
-      order_total * (1 + vat_rate)
-    end
-
-    output :gross_total
-  end
-end
-
-class CheckoutContract < Igniter::Contract
-  define do
-    input :order_total, type: :numeric
-    input :country, type: :string
-
-    compose :pricing, contract: PriceContract, inputs: {
-      order_total: :order_total,
-      country: :country
-    }
-
-    output :pricing
-  end
-end
-
-contract = CheckoutContract.new(order_total: 100, country: "UA")
-
-puts "pricing=#{contract.result.to_h.inspect}"