igniter 0.5.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (657) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +3 -3
  3. data/README.md +162 -624
  4. data/bin/igniter-stack +94 -0
  5. data/docs/README.md +62 -0
  6. data/examples/README.md +74 -349
  7. data/examples/agent_orchestration.rb +76 -0
  8. data/examples/agents.rb +2 -1
  9. data/examples/catalog.rb +412 -0
  10. data/examples/consensus.rb +13 -11
  11. data/examples/dataflow.rb +3 -2
  12. data/examples/distributed_workflow.rb +1 -1
  13. data/examples/effects.rb +10 -9
  14. data/examples/incremental.rb +4 -3
  15. data/examples/introspection.rb +49 -0
  16. data/examples/invariants.rb +4 -3
  17. data/examples/llm_tools.rb +18 -18
  18. data/examples/mesh.rb +16 -14
  19. data/examples/mesh_discovery.rb +41 -21
  20. data/examples/mesh_gossip.rb +19 -17
  21. data/examples/reactive_auditing.rb +50 -0
  22. data/examples/run.rb +163 -0
  23. data/lib/igniter/monorepo_packages.rb +17 -0
  24. data/lib/igniter/stack.rb +5 -0
  25. data/lib/igniter.rb +33 -17
  26. data/packages/igniter-agents/README.md +22 -0
  27. data/{lib → packages/igniter-agents/lib}/igniter/agent/ref.rb +1 -0
  28. data/{lib → packages/igniter-agents/lib}/igniter/agent/runner.rb +12 -0
  29. data/{lib → packages/igniter-agents/lib}/igniter/agent.rb +6 -0
  30. data/{lib → packages/igniter-agents/lib}/igniter/agents/proactive_agent.rb +1 -1
  31. data/packages/igniter-agents/lib/igniter/agents.rb +23 -0
  32. data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/chain_agent.rb +4 -2
  33. data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/critic_agent.rb +4 -2
  34. data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/evaluator_agent.rb +4 -2
  35. data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/evolution_agent.rb +4 -2
  36. data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/observer_agent.rb +4 -2
  37. data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/planner_agent.rb +4 -2
  38. data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/router_agent.rb +4 -2
  39. data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/ai/agents}/self_reflection_agent.rb +4 -2
  40. data/packages/igniter-agents/lib/igniter/ai/agents.rb +25 -0
  41. data/{lib → packages/igniter-agents/lib}/igniter/registry.rb +2 -0
  42. data/packages/igniter-agents/lib/igniter/runtime/registry_agent_adapter.rb +102 -0
  43. data/{lib → packages/igniter-agents/lib}/igniter/supervisor.rb +3 -0
  44. data/packages/igniter-agents/lib/igniter-agents.rb +7 -0
  45. data/packages/igniter-ai/README.md +20 -0
  46. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/config.rb +1 -1
  47. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/context.rb +2 -2
  48. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/executor.rb +14 -14
  49. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/providers/anthropic.rb +5 -5
  50. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/providers/base.rb +1 -1
  51. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/providers/ollama.rb +4 -4
  52. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/providers/openai.rb +5 -5
  53. data/{lib/igniter → packages/igniter-ai/lib/igniter/ai}/skill/feedback.rb +4 -4
  54. data/{lib/igniter → packages/igniter-ai/lib/igniter/ai}/skill/output_schema.rb +6 -6
  55. data/packages/igniter-ai/lib/igniter/ai/skill/runtime_contract.rb +87 -0
  56. data/packages/igniter-ai/lib/igniter/ai/skill.rb +107 -0
  57. data/packages/igniter-ai/lib/igniter/ai/tool_registry.rb +79 -0
  58. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/transcription/providers/assemblyai.rb +8 -8
  59. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/transcription/providers/base.rb +3 -3
  60. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/transcription/providers/deepgram.rb +3 -3
  61. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/transcription/providers/openai.rb +3 -3
  62. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/transcription/transcriber.rb +6 -6
  63. data/{lib/igniter/integrations/llm → packages/igniter-ai/lib/igniter/ai}/transcription/transcript_result.rb +1 -1
  64. data/{lib/igniter/integrations/llm.rb → packages/igniter-ai/lib/igniter/ai.rb} +18 -15
  65. data/packages/igniter-ai/lib/igniter-ai.rb +3 -0
  66. data/packages/igniter-app/README.md +19 -0
  67. data/packages/igniter-app/lib/igniter/app/app_config.rb +43 -0
  68. data/packages/igniter-app/lib/igniter/app/app_host.rb +56 -0
  69. data/packages/igniter-app/lib/igniter/app/app_host_config.rb +27 -0
  70. data/packages/igniter-app/lib/igniter/app/app_host_pack.rb +13 -0
  71. data/{lib/igniter/application → packages/igniter-app/lib/igniter/app}/autoloader.rb +2 -2
  72. data/packages/igniter-app/lib/igniter/app/cluster_app_host.rb +95 -0
  73. data/packages/igniter-app/lib/igniter/app/cluster_app_host_config.rb +78 -0
  74. data/packages/igniter-app/lib/igniter/app/credentials/config_loader.rb +152 -0
  75. data/packages/igniter-app/lib/igniter/app/credentials/credential.rb +48 -0
  76. data/packages/igniter-app/lib/igniter/app/credentials/credential_policy.rb +38 -0
  77. data/packages/igniter-app/lib/igniter/app/credentials/events/credential_event.rb +179 -0
  78. data/packages/igniter-app/lib/igniter/app/credentials/events.rb +12 -0
  79. data/packages/igniter-app/lib/igniter/app/credentials/lease_request.rb +153 -0
  80. data/packages/igniter-app/lib/igniter/app/credentials/policies/ephemeral_lease_policy.rb +35 -0
  81. data/packages/igniter-app/lib/igniter/app/credentials/policies/local_only_policy.rb +33 -0
  82. data/packages/igniter-app/lib/igniter/app/credentials/policies.rb +13 -0
  83. data/packages/igniter-app/lib/igniter/app/credentials/store.rb +21 -0
  84. data/packages/igniter-app/lib/igniter/app/credentials/stores/file_store.rb +114 -0
  85. data/packages/igniter-app/lib/igniter/app/credentials/trail.rb +254 -0
  86. data/packages/igniter-app/lib/igniter/app/credentials.rb +20 -0
  87. data/packages/igniter-app/lib/igniter/app/dev_output_sync.rb +4 -0
  88. data/packages/igniter-app/lib/igniter/app/diagnostics/app_host_contributor.rb +71 -0
  89. data/packages/igniter-app/lib/igniter/app/diagnostics/cluster_app_host_contributor.rb +97 -0
  90. data/packages/igniter-app/lib/igniter/app/diagnostics/credential_contributor.rb +66 -0
  91. data/packages/igniter-app/lib/igniter/app/diagnostics/evolution_contributor.rb +74 -0
  92. data/packages/igniter-app/lib/igniter/app/diagnostics/ignite_contributor.rb +121 -0
  93. data/packages/igniter-app/lib/igniter/app/diagnostics/loader_contributor.rb +68 -0
  94. data/packages/igniter-app/lib/igniter/app/diagnostics/orchestration_contributor.rb +200 -0
  95. data/packages/igniter-app/lib/igniter/app/diagnostics/runtime_contributor.rb +68 -0
  96. data/packages/igniter-app/lib/igniter/app/diagnostics/scheduler_contributor.rb +72 -0
  97. data/packages/igniter-app/lib/igniter/app/diagnostics/sdk_contributor.rb +284 -0
  98. data/packages/igniter-app/lib/igniter/app/diagnostics.rb +62 -0
  99. data/packages/igniter-app/lib/igniter/app/evolution/approval_decision.rb +115 -0
  100. data/packages/igniter-app/lib/igniter/app/evolution/approval_request.rb +36 -0
  101. data/packages/igniter-app/lib/igniter/app/evolution/plan.rb +72 -0
  102. data/packages/igniter-app/lib/igniter/app/evolution/planner.rb +85 -0
  103. data/packages/igniter-app/lib/igniter/app/evolution/result.rb +45 -0
  104. data/packages/igniter-app/lib/igniter/app/evolution/runner.rb +102 -0
  105. data/packages/igniter-app/lib/igniter/app/evolution/store.rb +21 -0
  106. data/packages/igniter-app/lib/igniter/app/evolution/stores/file_store.rb +241 -0
  107. data/packages/igniter-app/lib/igniter/app/evolution/trail.rb +108 -0
  108. data/packages/igniter-app/lib/igniter/app/evolution.rb +11 -0
  109. data/packages/igniter-app/lib/igniter/app/filesystem_loader_adapter.rb +21 -0
  110. data/packages/igniter-app/lib/igniter/app/generator.rb +636 -0
  111. data/packages/igniter-app/lib/igniter/app/generators/cluster.rb +1367 -0
  112. data/packages/igniter-app/lib/igniter/app/generators/dashboard.rb +152 -0
  113. data/packages/igniter-app/lib/igniter/app/generators/playground.rb +1227 -0
  114. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/README.md.erb +37 -0
  115. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/app.rb.erb +19 -0
  116. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/contexts/home_context.rb.erb +54 -0
  117. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/frontend/application.js.erb +3 -0
  118. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/spec/dashboard_app_spec.rb.erb +79 -0
  119. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/support/stack_overview.rb.erb +23 -0
  120. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/web/handlers/home_handler.rb.erb +27 -0
  121. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/web/views/home_page.arb.erb +44 -0
  122. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/web/views/home_page.rb.erb +56 -0
  123. data/packages/igniter-app/lib/igniter/app/generators/templates/dashboard/web/views/layout.arb.erb +17 -0
  124. data/packages/igniter-app/lib/igniter/app/host_adapter.rb +26 -0
  125. data/packages/igniter-app/lib/igniter/app/host_config.rb +40 -0
  126. data/packages/igniter-app/lib/igniter/app/host_registry.rb +43 -0
  127. data/packages/igniter-app/lib/igniter/app/loader_adapter.rb +15 -0
  128. data/packages/igniter-app/lib/igniter/app/loader_pack.rb +8 -0
  129. data/packages/igniter-app/lib/igniter/app/loader_registry.rb +39 -0
  130. data/packages/igniter-app/lib/igniter/app/observability/operator_action_handler.rb +147 -0
  131. data/packages/igniter-app/lib/igniter/app/observability/operator_console_handler.rb +747 -0
  132. data/packages/igniter-app/lib/igniter/app/observability/operator_overview_handler.rb +350 -0
  133. data/packages/igniter-app/lib/igniter/app/observability.rb +5 -0
  134. data/packages/igniter-app/lib/igniter/app/observability_pack.rb +71 -0
  135. data/packages/igniter-app/lib/igniter/app/operator/dispatcher.rb +40 -0
  136. data/packages/igniter-app/lib/igniter/app/operator/handler_registry.rb +40 -0
  137. data/packages/igniter-app/lib/igniter/app/operator/handler_result.rb +67 -0
  138. data/packages/igniter-app/lib/igniter/app/operator/handlers/base.rb +79 -0
  139. data/packages/igniter-app/lib/igniter/app/operator/handlers/ignite_handler.rb +108 -0
  140. data/packages/igniter-app/lib/igniter/app/operator/handlers/orchestration_handler.rb +33 -0
  141. data/packages/igniter-app/lib/igniter/app/operator/handlers.rb +5 -0
  142. data/packages/igniter-app/lib/igniter/app/operator/lifecycle_contract.rb +55 -0
  143. data/packages/igniter-app/lib/igniter/app/operator/policy.rb +157 -0
  144. data/packages/igniter-app/lib/igniter/app/operator.rb +17 -0
  145. data/packages/igniter-app/lib/igniter/app/orchestration/action_result_builder.rb +65 -0
  146. data/packages/igniter-app/lib/igniter/app/orchestration/followup_request.rb +36 -0
  147. data/packages/igniter-app/lib/igniter/app/orchestration/handler_registry.rb +58 -0
  148. data/packages/igniter-app/lib/igniter/app/orchestration/handlers.rb +106 -0
  149. data/packages/igniter-app/lib/igniter/app/orchestration/inbox.rb +283 -0
  150. data/packages/igniter-app/lib/igniter/app/orchestration/inbox_query.rb +293 -0
  151. data/packages/igniter-app/lib/igniter/app/orchestration/lane_registry.rb +100 -0
  152. data/packages/igniter-app/lib/igniter/app/orchestration/operator_query.rb +449 -0
  153. data/packages/igniter-app/lib/igniter/app/orchestration/plan.rb +68 -0
  154. data/packages/igniter-app/lib/igniter/app/orchestration/planner.rb +89 -0
  155. data/packages/igniter-app/lib/igniter/app/orchestration/policies.rb +125 -0
  156. data/packages/igniter-app/lib/igniter/app/orchestration/policy_registry.rb +63 -0
  157. data/packages/igniter-app/lib/igniter/app/orchestration/result.rb +43 -0
  158. data/packages/igniter-app/lib/igniter/app/orchestration/routing_registry.rb +43 -0
  159. data/packages/igniter-app/lib/igniter/app/orchestration/runner.rb +50 -0
  160. data/packages/igniter-app/lib/igniter/app/orchestration/runtime_event_query.rb +205 -0
  161. data/packages/igniter-app/lib/igniter/app/orchestration/runtime_overview_builder.rb +286 -0
  162. data/packages/igniter-app/lib/igniter/app/orchestration/runtime_query_overview_builder.rb +20 -0
  163. data/packages/igniter-app/lib/igniter/app/orchestration/runtime_result_builder.rb +23 -0
  164. data/packages/igniter-app/lib/igniter/app/orchestration.rb +113 -0
  165. data/packages/igniter-app/lib/igniter/app/runtime.rb +4 -0
  166. data/packages/igniter-app/lib/igniter/app/runtime_context.rb +101 -0
  167. data/packages/igniter-app/lib/igniter/app/runtime_pack.rb +16 -0
  168. data/packages/igniter-app/lib/igniter/app/scaffold_pack.rb +6 -0
  169. data/{lib/igniter/application → packages/igniter-app/lib/igniter/app}/scheduler.rb +2 -2
  170. data/packages/igniter-app/lib/igniter/app/scheduler_adapter.rb +17 -0
  171. data/packages/igniter-app/lib/igniter/app/scheduler_pack.rb +8 -0
  172. data/packages/igniter-app/lib/igniter/app/scheduler_registry.rb +39 -0
  173. data/packages/igniter-app/lib/igniter/app/stack.rb +1726 -0
  174. data/packages/igniter-app/lib/igniter/app/stack_pack.rb +3 -0
  175. data/packages/igniter-app/lib/igniter/app/threaded_scheduler_adapter.rb +35 -0
  176. data/packages/igniter-app/lib/igniter/app/yml_loader.rb +43 -0
  177. data/packages/igniter-app/lib/igniter/app.rb +2367 -0
  178. data/packages/igniter-app/lib/igniter/ignite/bootstrap_agent.rb +334 -0
  179. data/packages/igniter-app/lib/igniter/ignite/bootstrap_target.rb +79 -0
  180. data/packages/igniter-app/lib/igniter/ignite/deployment_intent.rb +82 -0
  181. data/packages/igniter-app/lib/igniter/ignite/ignition_agent.rb +1011 -0
  182. data/packages/igniter-app/lib/igniter/ignite/ignition_plan.rb +83 -0
  183. data/packages/igniter-app/lib/igniter/ignite/ignition_report.rb +144 -0
  184. data/packages/igniter-app/lib/igniter/ignite/store.rb +19 -0
  185. data/packages/igniter-app/lib/igniter/ignite/stores/file_store.rb +112 -0
  186. data/packages/igniter-app/lib/igniter/ignite/trail.rb +215 -0
  187. data/packages/igniter-app/lib/igniter/ignite.rb +11 -0
  188. data/packages/igniter-app/lib/igniter-app.rb +5 -0
  189. data/packages/igniter-cluster/README.md +9 -0
  190. data/packages/igniter-cluster/lib/igniter/cluster/agent_route_resolver.rb +58 -0
  191. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/consensus/cluster.rb +8 -4
  192. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/consensus/errors.rb +3 -1
  193. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/consensus/executors.rb +3 -1
  194. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/consensus/node.rb +3 -1
  195. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/consensus/read_query.rb +5 -3
  196. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/consensus/state_machine.rb +4 -2
  197. data/packages/igniter-cluster/lib/igniter/cluster/consensus.rb +18 -0
  198. data/packages/igniter-cluster/lib/igniter/cluster/diagnostics/governance_contributor.rb +90 -0
  199. data/packages/igniter-cluster/lib/igniter/cluster/diagnostics/identity_contributor.rb +98 -0
  200. data/packages/igniter-cluster/lib/igniter/cluster/diagnostics/routing_contributor.rb +674 -0
  201. data/packages/igniter-cluster/lib/igniter/cluster/diagnostics.rb +24 -0
  202. data/packages/igniter-cluster/lib/igniter/cluster/events/envelope.rb +136 -0
  203. data/packages/igniter-cluster/lib/igniter/cluster/events/hook_support.rb +33 -0
  204. data/packages/igniter-cluster/lib/igniter/cluster/events/log.rb +102 -0
  205. data/packages/igniter-cluster/lib/igniter/cluster/events/projection_feed.rb +98 -0
  206. data/packages/igniter-cluster/lib/igniter/cluster/events/read_model_projector.rb +32 -0
  207. data/packages/igniter-cluster/lib/igniter/cluster/events.rb +131 -0
  208. data/packages/igniter-cluster/lib/igniter/cluster/governance/admission_decision.rb +41 -0
  209. data/packages/igniter-cluster/lib/igniter/cluster/governance/admission_policy.rb +66 -0
  210. data/packages/igniter-cluster/lib/igniter/cluster/governance/admission_queue.rb +88 -0
  211. data/packages/igniter-cluster/lib/igniter/cluster/governance/admission_request.rb +62 -0
  212. data/packages/igniter-cluster/lib/igniter/cluster/governance/admission_workflow.rb +214 -0
  213. data/packages/igniter-cluster/lib/igniter/cluster/governance/checkpoint.rb +141 -0
  214. data/packages/igniter-cluster/lib/igniter/cluster/governance/compaction_record.rb +33 -0
  215. data/packages/igniter-cluster/lib/igniter/cluster/governance/stores/checkpoint_store.rb +89 -0
  216. data/packages/igniter-cluster/lib/igniter/cluster/governance/stores/file_store.rb +249 -0
  217. data/packages/igniter-cluster/lib/igniter/cluster/governance/trail.rb +164 -0
  218. data/packages/igniter-cluster/lib/igniter/cluster/governance.rb +12 -0
  219. data/packages/igniter-cluster/lib/igniter/cluster/identity/capability_attestation.rb +114 -0
  220. data/packages/igniter-cluster/lib/igniter/cluster/identity/manifest.rb +139 -0
  221. data/packages/igniter-cluster/lib/igniter/cluster/identity/node_identity.rb +106 -0
  222. data/packages/igniter-cluster/lib/igniter/cluster/identity.rb +5 -0
  223. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/mesh/announcer.rb +37 -4
  224. data/packages/igniter-cluster/lib/igniter/cluster/mesh/checkpoint_gossip.rb +60 -0
  225. data/packages/igniter-cluster/lib/igniter/cluster/mesh/config.rb +146 -0
  226. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/mesh/discovery.rb +7 -2
  227. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/mesh/errors.rb +10 -5
  228. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/mesh/gossip.rb +19 -4
  229. data/packages/igniter-cluster/lib/igniter/cluster/mesh/mesh_ql.rb +470 -0
  230. data/packages/igniter-cluster/lib/igniter/cluster/mesh/node_observation.rb +281 -0
  231. data/packages/igniter-cluster/lib/igniter/cluster/mesh/observation_query.rb +284 -0
  232. data/packages/igniter-cluster/lib/igniter/cluster/mesh/peer.rb +51 -0
  233. data/packages/igniter-cluster/lib/igniter/cluster/mesh/peer_capacity_report.rb +42 -0
  234. data/packages/igniter-cluster/lib/igniter/cluster/mesh/peer_identity_envelope.rb +158 -0
  235. data/packages/igniter-cluster/lib/igniter/cluster/mesh/peer_metadata.rb +122 -0
  236. data/packages/igniter-cluster/lib/igniter/cluster/mesh/peer_registry.rb +81 -0
  237. data/packages/igniter-cluster/lib/igniter/cluster/mesh/placement_decision.rb +64 -0
  238. data/packages/igniter-cluster/lib/igniter/cluster/mesh/placement_planner.rb +154 -0
  239. data/packages/igniter-cluster/lib/igniter/cluster/mesh/placement_policy.rb +103 -0
  240. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/mesh/poller.rb +19 -4
  241. data/packages/igniter-cluster/lib/igniter/cluster/mesh/rebalance_plan.rb +66 -0
  242. data/packages/igniter-cluster/lib/igniter/cluster/mesh/rebalance_planner.rb +153 -0
  243. data/packages/igniter-cluster/lib/igniter/cluster/mesh/repair_loop.rb +169 -0
  244. data/packages/igniter-cluster/lib/igniter/cluster/mesh/router.rb +306 -0
  245. data/packages/igniter-cluster/lib/igniter/cluster/mesh/workload_signal.rb +46 -0
  246. data/packages/igniter-cluster/lib/igniter/cluster/mesh/workload_tracker.rb +215 -0
  247. data/packages/igniter-cluster/lib/igniter/cluster/mesh.rb +452 -0
  248. data/packages/igniter-cluster/lib/igniter/cluster/ownership/claim.rb +69 -0
  249. data/packages/igniter-cluster/lib/igniter/cluster/ownership/errors.rb +19 -0
  250. data/packages/igniter-cluster/lib/igniter/cluster/ownership/owner_client.rb +76 -0
  251. data/packages/igniter-cluster/lib/igniter/cluster/ownership/registry.rb +98 -0
  252. data/packages/igniter-cluster/lib/igniter/cluster/ownership/resolver.rb +62 -0
  253. data/packages/igniter-cluster/lib/igniter/cluster/ownership.rb +81 -0
  254. data/packages/igniter-cluster/lib/igniter/cluster/projection_store.rb +62 -0
  255. data/packages/igniter-cluster/lib/igniter/cluster/rag/chunk.rb +49 -0
  256. data/packages/igniter-cluster/lib/igniter/cluster/rag/fanout_retriever.rb +93 -0
  257. data/packages/igniter-cluster/lib/igniter/cluster/rag/knowledge_shard.rb +140 -0
  258. data/packages/igniter-cluster/lib/igniter/cluster/rag/net_http_adapter.rb +85 -0
  259. data/packages/igniter-cluster/lib/igniter/cluster/rag/ranker.rb +46 -0
  260. data/packages/igniter-cluster/lib/igniter/cluster/rag/retrieval_query.rb +30 -0
  261. data/packages/igniter-cluster/lib/igniter/cluster/rag/retrieval_result.rb +77 -0
  262. data/packages/igniter-cluster/lib/igniter/cluster/rag.rb +38 -0
  263. data/packages/igniter-cluster/lib/igniter/cluster/remote_adapter.rb +101 -0
  264. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/bootstrapper.rb +3 -1
  265. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/bootstrappers/gem.rb +11 -4
  266. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/bootstrappers/git.rb +9 -2
  267. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/bootstrappers/tarball.rb +8 -2
  268. data/packages/igniter-cluster/lib/igniter/cluster/replication/capability_query.rb +675 -0
  269. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/expansion_plan.rb +5 -3
  270. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/expansion_planner.rb +41 -29
  271. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/manifest.rb +3 -1
  272. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/network_topology.rb +44 -17
  273. data/packages/igniter-cluster/lib/igniter/cluster/replication/node_profile.rb +134 -0
  274. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/reflective_replication_agent.rb +50 -29
  275. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/replication_agent.rb +4 -2
  276. data/{lib/igniter → packages/igniter-cluster/lib/igniter/cluster}/replication/ssh_session.rb +3 -1
  277. data/packages/igniter-cluster/lib/igniter/cluster/replication.rb +38 -0
  278. data/packages/igniter-cluster/lib/igniter/cluster/routed_agent_adapter.rb +79 -0
  279. data/packages/igniter-cluster/lib/igniter/cluster/routing_plan_executor.rb +427 -0
  280. data/packages/igniter-cluster/lib/igniter/cluster/routing_plan_result.rb +38 -0
  281. data/packages/igniter-cluster/lib/igniter/cluster/trust/admission_plan.rb +34 -0
  282. data/packages/igniter-cluster/lib/igniter/cluster/trust/admission_planner.rb +76 -0
  283. data/packages/igniter-cluster/lib/igniter/cluster/trust/admission_result.rb +34 -0
  284. data/packages/igniter-cluster/lib/igniter/cluster/trust/admission_runner.rb +125 -0
  285. data/packages/igniter-cluster/lib/igniter/cluster/trust/trust_assessment.rb +37 -0
  286. data/packages/igniter-cluster/lib/igniter/cluster/trust/trust_store.rb +58 -0
  287. data/packages/igniter-cluster/lib/igniter/cluster/trust/verifier.rb +80 -0
  288. data/packages/igniter-cluster/lib/igniter/cluster/trust.rb +9 -0
  289. data/packages/igniter-cluster/lib/igniter/cluster.rb +71 -0
  290. data/packages/igniter-cluster/lib/igniter-cluster.rb +3 -0
  291. data/packages/igniter-core/README.md +21 -0
  292. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/capabilities.rb +3 -1
  293. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/compiled_graph.rb +40 -2
  294. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validation_pipeline.rb +1 -0
  295. data/packages/igniter-core/lib/igniter/core/compiler/validators/agent_validator.rb +142 -0
  296. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validators/dependencies_validator.rb +40 -1
  297. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler.rb +1 -0
  298. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/contract.rb +76 -6
  299. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dataflow.rb +7 -7
  300. data/packages/igniter-core/lib/igniter/core/diagnostics/agent_contributor.rb +241 -0
  301. data/packages/igniter-core/lib/igniter/core/diagnostics/capability_contributor.rb +162 -0
  302. data/packages/igniter-core/lib/igniter/core/diagnostics/orchestration_contributor.rb +75 -0
  303. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/diagnostics/report.rb +81 -6
  304. data/packages/igniter-core/lib/igniter/core/diagnostics.rb +58 -0
  305. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dsl/contract_builder.rb +163 -6
  306. data/packages/igniter-core/lib/igniter/core/dto/record.rb +189 -0
  307. data/packages/igniter-core/lib/igniter/core/dto.rb +8 -0
  308. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/effect.rb +4 -0
  309. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/errors.rb +26 -3
  310. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/introspection/graph_formatter.rb +32 -1
  311. data/packages/igniter-core/lib/igniter/core/extensions/introspection/plan_formatter.rb +85 -0
  312. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/introspection/runtime_formatter.rb +26 -0
  313. data/packages/igniter-core/lib/igniter/core/extensions/invariants.rb +70 -0
  314. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/incremental.rb +4 -4
  315. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/memorable.rb +1 -1
  316. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/stores/sqlite.rb +5 -3
  317. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory.rb +11 -11
  318. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/metrics/prometheus_exporter.rb +1 -1
  319. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/metrics.rb +8 -8
  320. data/packages/igniter-core/lib/igniter/core/model/agent_interaction_contract.rb +172 -0
  321. data/packages/igniter-core/lib/igniter/core/model/agent_node.rb +86 -0
  322. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/branch_node.rb +37 -1
  323. data/packages/igniter-core/lib/igniter/core/model/remote_node.rb +91 -0
  324. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model.rb +2 -0
  325. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/node_cache.rb +1 -1
  326. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/property_testing.rb +8 -8
  327. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/provenance/builder.rb +30 -1
  328. data/packages/igniter-core/lib/igniter/core/runtime/agent_adapter.rb +41 -0
  329. data/packages/igniter-core/lib/igniter/core/runtime/agent_result_contract.rb +91 -0
  330. data/packages/igniter-core/lib/igniter/core/runtime/agent_route.rb +60 -0
  331. data/packages/igniter-core/lib/igniter/core/runtime/agent_route_resolver.rb +26 -0
  332. data/packages/igniter-core/lib/igniter/core/runtime/agent_session.rb +922 -0
  333. data/packages/igniter-core/lib/igniter/core/runtime/agent_session_query.rb +379 -0
  334. data/packages/igniter-core/lib/igniter/core/runtime/agent_transport.rb +30 -0
  335. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/cache.rb +6 -3
  336. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/deferred_result.rb +27 -1
  337. data/packages/igniter-core/lib/igniter/core/runtime/execution.rb +913 -0
  338. data/packages/igniter-core/lib/igniter/core/runtime/job_worker.rb +39 -0
  339. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/node_state.rb +4 -2
  340. data/packages/igniter-core/lib/igniter/core/runtime/orchestration_overview.rb +213 -0
  341. data/packages/igniter-core/lib/igniter/core/runtime/orchestration_runtime_state.rb +176 -0
  342. data/packages/igniter-core/lib/igniter/core/runtime/orchestration_transition_query.rb +208 -0
  343. data/packages/igniter-core/lib/igniter/core/runtime/planner.rb +301 -0
  344. data/packages/igniter-core/lib/igniter/core/runtime/proxy_agent_adapter.rb +124 -0
  345. data/packages/igniter-core/lib/igniter/core/runtime/remote_adapter.rb +26 -0
  346. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/resolver.rb +250 -57
  347. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/result.rb +2 -0
  348. data/packages/igniter-core/lib/igniter/core/runtime/stores/sqlite_store.rb +155 -0
  349. data/packages/igniter-core/lib/igniter/core/runtime/stream_result.rb +171 -0
  350. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime.rb +15 -0
  351. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/temporal.rb +1 -1
  352. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/tool/discoverable.rb +3 -3
  353. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/tool.rb +6 -2
  354. data/{lib/igniter → packages/igniter-core/lib/igniter/core}/version.rb +1 -1
  355. data/packages/igniter-core/lib/igniter/core.rb +23 -0
  356. data/packages/igniter-core/lib/igniter-core.rb +3 -0
  357. data/packages/igniter-extensions/README.md +21 -0
  358. data/packages/igniter-extensions/lib/igniter/extensions/auditing.rb +3 -0
  359. data/{lib → packages/igniter-extensions/lib}/igniter/extensions/capabilities.rb +1 -1
  360. data/{lib → packages/igniter-extensions/lib}/igniter/extensions/content_addressing.rb +1 -1
  361. data/{lib → packages/igniter-extensions/lib}/igniter/extensions/dataflow.rb +1 -1
  362. data/{lib → packages/igniter-extensions/lib}/igniter/extensions/differential.rb +1 -1
  363. data/{lib → packages/igniter-extensions/lib}/igniter/extensions/execution_report.rb +1 -1
  364. data/{lib → packages/igniter-extensions/lib}/igniter/extensions/incremental.rb +1 -1
  365. data/packages/igniter-extensions/lib/igniter/extensions/introspection.rb +3 -0
  366. data/packages/igniter-extensions/lib/igniter/extensions/invariants.rb +3 -0
  367. data/{lib → packages/igniter-extensions/lib}/igniter/extensions/provenance.rb +1 -1
  368. data/packages/igniter-extensions/lib/igniter/extensions/reactive.rb +3 -0
  369. data/{lib → packages/igniter-extensions/lib}/igniter/extensions/saga.rb +1 -1
  370. data/packages/igniter-extensions/lib/igniter/extensions.rb +8 -0
  371. data/packages/igniter-extensions/lib/igniter-extensions.rb +3 -0
  372. data/packages/igniter-frontend/README.md +224 -0
  373. data/packages/igniter-frontend/lib/igniter/frontend/app.rb +90 -0
  374. data/packages/igniter-frontend/lib/igniter/frontend/app_access.rb +36 -0
  375. data/packages/igniter-frontend/lib/igniter/frontend/arbre/component.rb +120 -0
  376. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/action_group.rb +53 -0
  377. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/badge.rb +91 -0
  378. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/boolean.rb +53 -0
  379. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/breadcrumbs.rb +71 -0
  380. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/card.rb +114 -0
  381. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/conversation_panel.rb +61 -0
  382. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/datetime.rb +42 -0
  383. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/display_value_support.rb +38 -0
  384. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/empty_state.rb +39 -0
  385. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/event_list.rb +44 -0
  386. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/filters.rb +183 -0
  387. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/indicator.rb +59 -0
  388. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/json_panel.rb +36 -0
  389. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/key_value_list.rb +40 -0
  390. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/loading_state.rb +43 -0
  391. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/metric_grid.rb +37 -0
  392. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/number.rb +53 -0
  393. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/page_header.rb +53 -0
  394. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/pagination.rb +143 -0
  395. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/panel.rb +67 -0
  396. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/percentage.rb +79 -0
  397. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/resource_list.rb +38 -0
  398. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/scenario_card.rb +48 -0
  399. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/shell_columns.rb +67 -0
  400. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/sidebar_shell.rb +106 -0
  401. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/table_with.rb +203 -0
  402. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/tabs.rb +147 -0
  403. data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/viz.rb +185 -0
  404. data/packages/igniter-frontend/lib/igniter/frontend/arbre/page.rb +74 -0
  405. data/packages/igniter-frontend/lib/igniter/frontend/arbre/raw_text_node.rb +40 -0
  406. data/packages/igniter-frontend/lib/igniter/frontend/arbre/template_page.rb +243 -0
  407. data/packages/igniter-frontend/lib/igniter/frontend/arbre.rb +48 -0
  408. data/packages/igniter-frontend/lib/igniter/frontend/arbre_page.rb +7 -0
  409. data/packages/igniter-frontend/lib/igniter/frontend/assets.rb +101 -0
  410. data/packages/igniter-frontend/lib/igniter/frontend/builder.rb +124 -0
  411. data/packages/igniter-frontend/lib/igniter/frontend/component.rb +24 -0
  412. data/packages/igniter-frontend/lib/igniter/frontend/components.rb +7 -0
  413. data/packages/igniter-frontend/lib/igniter/frontend/context.rb +53 -0
  414. data/packages/igniter-frontend/lib/igniter/frontend/form_builder.rb +63 -0
  415. data/packages/igniter-frontend/lib/igniter/frontend/handler.rb +92 -0
  416. data/packages/igniter-frontend/lib/igniter/frontend/javascript.rb +353 -0
  417. data/packages/igniter-frontend/lib/igniter/frontend/page.rb +24 -0
  418. data/packages/igniter-frontend/lib/igniter/frontend/request.rb +61 -0
  419. data/packages/igniter-frontend/lib/igniter/frontend/response.rb +67 -0
  420. data/packages/igniter-frontend/lib/igniter/frontend/tailwind/realtime/adapters.rb +226 -0
  421. data/packages/igniter-frontend/lib/igniter/frontend/tailwind/realtime/presets.rb +147 -0
  422. data/packages/igniter-frontend/lib/igniter/frontend/tailwind/realtime.rb +259 -0
  423. data/packages/igniter-frontend/lib/igniter/frontend/tailwind/surfaces.rb +1074 -0
  424. data/packages/igniter-frontend/lib/igniter/frontend/tailwind/ui.rb +1438 -0
  425. data/packages/igniter-frontend/lib/igniter/frontend/tailwind.rb +180 -0
  426. data/packages/igniter-frontend/lib/igniter/frontend/version.rb +9 -0
  427. data/packages/igniter-frontend/lib/igniter/frontend.rb +35 -0
  428. data/packages/igniter-frontend/lib/igniter-frontend.rb +3 -0
  429. data/packages/igniter-rails/README.md +96 -0
  430. data/packages/igniter-rails/lib/igniter/plugins/rails/generators/contract/templates/contract.rb.tt +22 -0
  431. data/packages/igniter-rails/lib/igniter/plugins/rails/generators/install/templates/igniter.rb.tt +16 -0
  432. data/packages/igniter-rails/lib/igniter-rails.rb +3 -0
  433. data/packages/igniter-schema-rendering/README.md +27 -0
  434. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/page.rb +35 -0
  435. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/patcher.rb +47 -0
  436. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/renderer.rb +268 -0
  437. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/schema.rb +172 -0
  438. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/store.rb +53 -0
  439. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/submission_normalizer.rb +117 -0
  440. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/submission_processor.rb +91 -0
  441. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/submission_validator.rb +62 -0
  442. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering/version.rb +9 -0
  443. data/packages/igniter-schema-rendering/lib/igniter/schema_rendering.rb +20 -0
  444. data/packages/igniter-schema-rendering/lib/igniter-schema-rendering.rb +3 -0
  445. data/packages/igniter-sdk/README.md +25 -0
  446. data/packages/igniter-sdk/lib/igniter/sdk/channels/base.rb +84 -0
  447. data/packages/igniter-sdk/lib/igniter/sdk/channels/delivery_result.rb +61 -0
  448. data/packages/igniter-sdk/lib/igniter/sdk/channels/message.rb +101 -0
  449. data/packages/igniter-sdk/lib/igniter/sdk/channels/telegram.rb +161 -0
  450. data/packages/igniter-sdk/lib/igniter/sdk/channels/webhook.rb +213 -0
  451. data/packages/igniter-sdk/lib/igniter/sdk/channels.rb +17 -0
  452. data/packages/igniter-sdk/lib/igniter/sdk/data/store.rb +31 -0
  453. data/packages/igniter-sdk/lib/igniter/sdk/data/stores/file.rb +113 -0
  454. data/packages/igniter-sdk/lib/igniter/sdk/data/stores/in_memory.rb +63 -0
  455. data/packages/igniter-sdk/lib/igniter/sdk/data/stores/sqlite.rb +144 -0
  456. data/packages/igniter-sdk/lib/igniter/sdk/data.rb +34 -0
  457. data/packages/igniter-sdk/lib/igniter/sdk/tools/agent_bootstrap_tool.rb +151 -0
  458. data/packages/igniter-sdk/lib/igniter/sdk/tools/local_workflow_selector_tool.rb +269 -0
  459. data/packages/igniter-sdk/lib/igniter/sdk/tools/system_discovery_tool.rb +198 -0
  460. data/packages/igniter-sdk/lib/igniter/sdk/tools.rb +9 -0
  461. data/packages/igniter-sdk/lib/igniter/sdk.rb +86 -0
  462. data/packages/igniter-sdk/lib/igniter-sdk.rb +3 -0
  463. data/packages/igniter-server/README.md +9 -0
  464. data/packages/igniter-server/lib/igniter/server/agent_session_store.rb +98 -0
  465. data/packages/igniter-server/lib/igniter/server/agent_transport.rb +95 -0
  466. data/packages/igniter-server/lib/igniter/server/app_host.rb +3 -0
  467. data/{lib → packages/igniter-server/lib}/igniter/server/client.rb +96 -6
  468. data/packages/igniter-server/lib/igniter/server/config.rb +70 -0
  469. data/packages/igniter-server/lib/igniter/server/handlers/agent_message_handler.rb +107 -0
  470. data/packages/igniter-server/lib/igniter/server/handlers/agent_session_handler.rb +125 -0
  471. data/packages/igniter-server/lib/igniter/server/handlers/manifest_handler.rb +77 -0
  472. data/{lib → packages/igniter-server/lib}/igniter/server/handlers/metrics_handler.rb +1 -1
  473. data/{lib → packages/igniter-server/lib}/igniter/server/handlers/peers_handler.rb +38 -17
  474. data/{lib → packages/igniter-server/lib}/igniter/server/http_server.rb +91 -15
  475. data/{lib → packages/igniter-server/lib}/igniter/server/rack_app.rb +27 -2
  476. data/packages/igniter-server/lib/igniter/server/remote_adapter.rb +27 -0
  477. data/packages/igniter-server/lib/igniter/server/router.rb +291 -0
  478. data/{lib → packages/igniter-server/lib}/igniter/server/server_logger.rb +3 -1
  479. data/{lib → packages/igniter-server/lib}/igniter/server.rb +58 -1
  480. data/packages/igniter-server/lib/igniter-server.rb +3 -0
  481. metadata +631 -282
  482. data/docs/API_V2.md +0 -537
  483. data/docs/APPLICATION_V1.md +0 -253
  484. data/docs/ARCHITECTURE_V2.md +0 -317
  485. data/docs/BACKLOG.md +0 -166
  486. data/docs/BRANCHES_V1.md +0 -213
  487. data/docs/CAPABILITIES_V1.md +0 -207
  488. data/docs/COLLECTIONS_V1.md +0 -303
  489. data/docs/CONSENSUS_V1.md +0 -477
  490. data/docs/CONTENT_ADDRESSING_V1.md +0 -221
  491. data/docs/DATAFLOW_V1.md +0 -274
  492. data/docs/DISTRIBUTED_CONTRACTS_V1.md +0 -493
  493. data/docs/EXECUTION_MODEL_V2.md +0 -324
  494. data/docs/IGNITER_CONCEPTS.md +0 -81
  495. data/docs/LLM_V1.md +0 -335
  496. data/docs/MESH_V1.md +0 -732
  497. data/docs/NODE_CACHE_V1.md +0 -324
  498. data/docs/PATTERNS.md +0 -411
  499. data/docs/PROACTIVE_AGENTS_V1.md +0 -293
  500. data/docs/SERVER_V1.md +0 -512
  501. data/docs/SKILLS_V1.md +0 -213
  502. data/docs/STORE_ADAPTERS.md +0 -154
  503. data/docs/TEMPORAL_V1.md +0 -174
  504. data/docs/TOOLS_V1.md +0 -347
  505. data/docs/TRANSCRIPTION_V1.md +0 -403
  506. data/lib/igniter/agents.rb +0 -56
  507. data/lib/igniter/application/app_config.rb +0 -32
  508. data/lib/igniter/application/generator.rb +0 -157
  509. data/lib/igniter/application/yml_loader.rb +0 -39
  510. data/lib/igniter/application.rb +0 -174
  511. data/lib/igniter/consensus.rb +0 -58
  512. data/lib/igniter/diagnostics.rb +0 -8
  513. data/lib/igniter/extensions/introspection/plan_formatter.rb +0 -55
  514. data/lib/igniter/extensions/invariants.rb +0 -116
  515. data/lib/igniter/extensions/mesh.rb +0 -31
  516. data/lib/igniter/integrations/agents.rb +0 -18
  517. data/lib/igniter/mesh/config.rb +0 -45
  518. data/lib/igniter/mesh/peer.rb +0 -21
  519. data/lib/igniter/mesh/peer_registry.rb +0 -51
  520. data/lib/igniter/mesh/router.rb +0 -109
  521. data/lib/igniter/mesh.rb +0 -85
  522. data/lib/igniter/model/remote_node.rb +0 -42
  523. data/lib/igniter/replication/node_role.rb +0 -42
  524. data/lib/igniter/replication/role_registry.rb +0 -73
  525. data/lib/igniter/replication.rb +0 -54
  526. data/lib/igniter/runtime/execution.rb +0 -416
  527. data/lib/igniter/runtime/job_worker.rb +0 -18
  528. data/lib/igniter/runtime/planner.rb +0 -126
  529. data/lib/igniter/server/config.rb +0 -34
  530. data/lib/igniter/server/handlers/manifest_handler.rb +0 -34
  531. data/lib/igniter/server/router.rb +0 -108
  532. data/lib/igniter/skill.rb +0 -218
  533. data/lib/igniter/tool_registry.rb +0 -144
  534. /data/{lib → packages/igniter-agents/lib}/igniter/agent/mailbox.rb +0 -0
  535. /data/{lib → packages/igniter-agents/lib}/igniter/agent/message.rb +0 -0
  536. /data/{lib → packages/igniter-agents/lib}/igniter/agent/state_holder.rb +0 -0
  537. /data/{lib → packages/igniter-agents/lib}/igniter/agents/observability/metrics_agent.rb +0 -0
  538. /data/{lib → packages/igniter-agents/lib}/igniter/agents/pipeline/batch_processor_agent.rb +0 -0
  539. /data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/agents/proactive}/alert_agent.rb +0 -0
  540. /data/{lib/igniter/agents/ai → packages/igniter-agents/lib/igniter/agents/proactive}/health_check_agent.rb +0 -0
  541. /data/{lib → packages/igniter-agents/lib}/igniter/agents/reliability/retry_agent.rb +0 -0
  542. /data/{lib → packages/igniter-agents/lib}/igniter/agents/scheduling/cron_agent.rb +0 -0
  543. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/graph_compiler.rb +0 -0
  544. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/type_resolver.rb +0 -0
  545. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validation_context.rb +0 -0
  546. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validator.rb +0 -0
  547. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validators/await_validator.rb +0 -0
  548. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validators/callable_validator.rb +0 -0
  549. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validators/outputs_validator.rb +0 -0
  550. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validators/remote_validator.rb +0 -0
  551. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validators/type_compatibility_validator.rb +0 -0
  552. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/compiler/validators/uniqueness_validator.rb +0 -0
  553. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/content_addressing.rb +0 -0
  554. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dataflow/aggregate_operators.rb +0 -0
  555. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dataflow/aggregate_state.rb +0 -0
  556. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dataflow/diff.rb +0 -0
  557. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dataflow/diff_state.rb +0 -0
  558. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dataflow/incremental_collection_result.rb +0 -0
  559. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dataflow/window_filter.rb +0 -0
  560. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/diagnostics/auditing/report/console_formatter.rb +0 -0
  561. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/diagnostics/auditing/report/markdown_formatter.rb +0 -0
  562. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/diagnostics/introspection/formatters/mermaid_formatter.rb +0 -0
  563. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/diagnostics/introspection/formatters/text_tree_formatter.rb +0 -0
  564. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/differential/divergence.rb +0 -0
  565. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/differential/formatter.rb +0 -0
  566. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/differential/report.rb +0 -0
  567. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/differential/runner.rb +0 -0
  568. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/differential.rb +0 -0
  569. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dsl/schema_builder.rb +0 -0
  570. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/dsl.rb +0 -0
  571. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/effect_registry.rb +0 -0
  572. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/events/bus.rb +0 -0
  573. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/events/event.rb +0 -0
  574. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/events.rb +0 -0
  575. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/execution_report/builder.rb +0 -0
  576. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/execution_report/formatter.rb +0 -0
  577. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/execution_report/node_entry.rb +0 -0
  578. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/execution_report/report.rb +0 -0
  579. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/execution_report.rb +0 -0
  580. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/executor.rb +0 -0
  581. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/executor_registry.rb +0 -0
  582. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/auditing/timeline.rb +0 -0
  583. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/auditing.rb +0 -0
  584. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/introspection.rb +0 -0
  585. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/reactive/engine.rb +0 -0
  586. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/reactive/matcher.rb +0 -0
  587. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/reactive/reaction.rb +0 -0
  588. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions/reactive.rb +0 -0
  589. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/extensions.rb +0 -0
  590. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/fingerprint.rb +0 -0
  591. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/incremental/formatter.rb +0 -0
  592. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/incremental/result.rb +0 -0
  593. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/incremental/tracker.rb +0 -0
  594. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/invariant.rb +0 -0
  595. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/agent_memory.rb +0 -0
  596. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/episode.rb +0 -0
  597. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/fact.rb +0 -0
  598. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/reflection_cycle.rb +0 -0
  599. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/reflection_record.rb +0 -0
  600. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/store.rb +0 -0
  601. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/memory/stores/in_memory.rb +0 -0
  602. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/metrics/collector.rb +0 -0
  603. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/metrics/snapshot.rb +0 -0
  604. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/aggregate_node.rb +0 -0
  605. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/await_node.rb +0 -0
  606. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/collection_node.rb +0 -0
  607. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/composition_node.rb +0 -0
  608. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/compute_node.rb +0 -0
  609. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/effect_node.rb +0 -0
  610. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/graph.rb +0 -0
  611. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/input_node.rb +0 -0
  612. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/node.rb +0 -0
  613. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/model/output_node.rb +0 -0
  614. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/property_testing/formatter.rb +0 -0
  615. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/property_testing/generators.rb +0 -0
  616. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/property_testing/result.rb +0 -0
  617. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/property_testing/run.rb +0 -0
  618. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/property_testing/runner.rb +0 -0
  619. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/provenance/lineage.rb +0 -0
  620. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/provenance/node_trace.rb +0 -0
  621. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/provenance/text_formatter.rb +0 -0
  622. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/provenance.rb +0 -0
  623. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/collection_result.rb +0 -0
  624. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/input_validator.rb +0 -0
  625. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/invalidator.rb +0 -0
  626. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/runner_factory.rb +0 -0
  627. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/runners/inline_runner.rb +0 -0
  628. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/runners/store_runner.rb +0 -0
  629. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/runners/thread_pool_runner.rb +0 -0
  630. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/stores/active_record_store.rb +0 -0
  631. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/stores/file_store.rb +0 -0
  632. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/stores/memory_store.rb +0 -0
  633. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime/stores/redis_store.rb +0 -0
  634. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/saga/compensation.rb +0 -0
  635. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/saga/compensation_record.rb +0 -0
  636. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/saga/executor.rb +0 -0
  637. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/saga/formatter.rb +0 -0
  638. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/saga/result.rb +0 -0
  639. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/saga.rb +0 -0
  640. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/stream_loop.rb +0 -0
  641. /data/{lib/igniter → packages/igniter-core/lib/igniter/core}/type_system.rb +0 -0
  642. /data/{lib/igniter/integrations → packages/igniter-rails/lib/igniter/plugins}/rails/cable_adapter.rb +0 -0
  643. /data/{lib/igniter/integrations → packages/igniter-rails/lib/igniter/plugins}/rails/contract_job.rb +0 -0
  644. /data/{lib/igniter/integrations → packages/igniter-rails/lib/igniter/plugins}/rails/generators/contract/contract_generator.rb +0 -0
  645. /data/{lib/igniter/integrations → packages/igniter-rails/lib/igniter/plugins}/rails/generators/install/install_generator.rb +0 -0
  646. /data/{lib/igniter/integrations → packages/igniter-rails/lib/igniter/plugins}/rails/railtie.rb +0 -0
  647. /data/{lib/igniter/integrations → packages/igniter-rails/lib/igniter/plugins}/rails/webhook_concern.rb +0 -0
  648. /data/{lib/igniter/integrations → packages/igniter-rails/lib/igniter/plugins}/rails.rb +0 -0
  649. /data/{lib → packages/igniter-server/lib}/igniter/server/handlers/base.rb +0 -0
  650. /data/{lib → packages/igniter-server/lib}/igniter/server/handlers/contracts_handler.rb +0 -0
  651. /data/{lib → packages/igniter-server/lib}/igniter/server/handlers/event_handler.rb +0 -0
  652. /data/{lib → packages/igniter-server/lib}/igniter/server/handlers/execute_handler.rb +0 -0
  653. /data/{lib → packages/igniter-server/lib}/igniter/server/handlers/health_handler.rb +0 -0
  654. /data/{lib → packages/igniter-server/lib}/igniter/server/handlers/liveness_handler.rb +0 -0
  655. /data/{lib → packages/igniter-server/lib}/igniter/server/handlers/readiness_handler.rb +0 -0
  656. /data/{lib → packages/igniter-server/lib}/igniter/server/handlers/status_handler.rb +0 -0
  657. /data/{lib → packages/igniter-server/lib}/igniter/server/registry.rb +0 -0
@@ -1,7 +1,8 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Igniter
4
- module Replication
4
+ module Cluster
5
+ module Replication
5
6
  # Analyses network topology + episodic memory to produce an ExpansionPlan.
6
7
  #
7
8
  # Two modes of operation:
@@ -10,42 +11,43 @@ module Igniter
10
11
  #
11
12
  # Rule-based heuristics (applied in order):
12
13
  # 1. Retire nodes marked unhealthy in the topology.
13
- # 2. Spawn a new node for each required role absent from the topology.
14
+ # 2. Spawn a new node for each required capability query absent from the topology.
14
15
  # 3. Annotate the rationale when recent replication failures exceed the threshold.
15
- # 4. Honour :scale_signal episodes (content: "scale_out:<role>").
16
+ # 4. Honour :scale_signal episodes (content: "scale_out:<capability>[+<capability>]").
16
17
  #
17
18
  # LLM mode receives topology snapshot + recent episodes and expects the
18
19
  # executor to return { actions: [...], rationale: "..." }.
19
20
  #
20
21
  # @example Rule-based
21
22
  # topology = NetworkTopology.new
22
- # topology.register(node_id: "x", host: "10.0.0.1", role: :worker)
23
+ # topology.register(node_id: "x", host: "10.0.0.1", capabilities: [:local_llm])
23
24
  #
24
25
  # planner = ExpansionPlanner.new(
25
- # topology: topology,
26
- # required_roles: [:worker, :coordinator],
27
- # host_pool: ["10.0.0.2"]
26
+ # topology: topology,
27
+ # required_capabilities: [[:local_llm], %i[container_runtime local_llm]],
28
+ # host_pool: ["10.0.0.2"]
28
29
  # )
29
30
  # plan = planner.plan
30
- # # plan.actions => [{ action: :replicate_role, role: :coordinator, host: "10.0.0.2" }]
31
+ # # plan.actions => [{ action: :replicate_capabilities, query: { all_of: [:container_runtime, :local_llm] }, host: "10.0.0.2" }]
31
32
  class ExpansionPlanner
32
33
  DEFAULT_FAILURE_THRESHOLD = 3
33
34
 
34
35
  # @param topology [NetworkTopology] current node topology
35
36
  # @param memory [AgentMemory, nil] episodic memory (optional)
36
- # @param required_roles [Array<Symbol>] roles that must always be present
37
+ # @param required_capabilities [Array<CapabilityQuery, Array<Symbol>, Hash, Symbol>]
38
+ # capability slices that must always be present
37
39
  # @param failure_threshold [Integer] replication failures before warning
38
40
  # @param host_pool [Array<String>] candidate hosts for new nodes
39
41
  # @param llm [#call, nil] optional LLM executor
40
- def initialize(topology:, memory: nil, required_roles: [],
42
+ def initialize(topology:, memory: nil, required_capabilities: [],
41
43
  failure_threshold: DEFAULT_FAILURE_THRESHOLD,
42
44
  host_pool: [], llm: nil)
43
- @topology = topology
44
- @memory = memory
45
- @required_roles = Array(required_roles).map(&:to_sym)
46
- @failure_threshold = failure_threshold
47
- @host_pool = host_pool.dup
48
- @llm = llm
45
+ @topology = topology
46
+ @memory = memory
47
+ @required_capabilities = Array(required_capabilities).map { |query| CapabilityQuery.normalize(query) }
48
+ @failure_threshold = failure_threshold
49
+ @host_pool = host_pool.dup
50
+ @llm = llm
49
51
  end
50
52
 
51
53
  # Produce an ExpansionPlan.
@@ -62,7 +64,7 @@ module Igniter
62
64
  rationale = []
63
65
 
64
66
  retire_unhealthy(actions, rationale)
65
- ensure_required_roles(actions, rationale)
67
+ ensure_required_capabilities(actions, rationale)
66
68
  check_failure_signal(rationale)
67
69
  apply_scale_signals(actions, rationale)
68
70
 
@@ -77,16 +79,16 @@ module Igniter
77
79
  end
78
80
  end
79
81
 
80
- def ensure_required_roles(actions, rationale)
81
- @required_roles.each do |role|
82
- next unless @topology.needs_role?(role)
82
+ def ensure_required_capabilities(actions, rationale)
83
+ @required_capabilities.each do |query|
84
+ next unless @topology.needs_capability_query?(query)
83
85
 
84
86
  host = next_available_host
85
87
  if host
86
- actions << { action: :replicate_role, role: role, host: host }
87
- rationale << "role :#{role} absent; targeting #{host}"
88
+ actions << { action: :replicate_capabilities, query: query.to_h, host: host }
89
+ rationale << "capability query #{query.label.inspect} absent; targeting #{host}"
88
90
  else
89
- rationale << "role :#{role} absent but no available host in pool"
91
+ rationale << "capability query #{query.label.inspect} absent but no available host in pool"
90
92
  end
91
93
  end
92
94
  end
@@ -105,14 +107,14 @@ module Igniter
105
107
  return unless @memory
106
108
 
107
109
  @memory.recent(last: 10, type: :scale_signal).each do |ep|
108
- m = ep.content.to_s.match(/\Ascale_out:(\w+)\z/)
110
+ m = ep.content.to_s.match(/\Ascale_out:([@\w+,-]+)\z/)
109
111
  next unless m
110
112
 
111
- role = m[1].to_sym
113
+ query = parse_scale_query(m[1])
112
114
  host = next_available_host
113
115
  if host
114
- actions << { action: :replicate_role, role: role, host: host }
115
- rationale << "scale_signal requests :#{role} at #{host}"
116
+ actions << { action: :replicate_capabilities, query: query.to_h, host: host }
117
+ rationale << "scale_signal requests #{query.label.inspect} at #{host}"
116
118
  end
117
119
  end
118
120
  end
@@ -122,12 +124,12 @@ module Igniter
122
124
  result = @llm.call(
123
125
  topology: @topology.nodes.map { |n|
124
126
  { node_id: n.node_id, host: n.host,
125
- role: n.role, healthy: n.healthy }
127
+ capabilities: n.capabilities, tags: n.tags, healthy: n.healthy }
126
128
  },
127
129
  episodes: episodes.map { |e|
128
130
  { type: e.type, content: e.content, outcome: e.outcome }
129
131
  },
130
- required_roles: @required_roles,
132
+ required_capabilities: @required_capabilities.map(&:to_h),
131
133
  host_pool: @host_pool
132
134
  )
133
135
  ExpansionPlan.new(actions: Array(result[:actions]), rationale: result[:rationale])
@@ -137,6 +139,16 @@ module Igniter
137
139
  used = @topology.nodes.map(&:host).to_set
138
140
  @host_pool.find { |h| !used.include?(h) }
139
141
  end
142
+
143
+ def parse_scale_query(signature)
144
+ body, tag_part = signature.split("@", 2)
145
+
146
+ CapabilityQuery.new(
147
+ all_of: body.to_s.split("+").reject(&:empty?),
148
+ tags: tag_part.to_s.split("+").reject(&:empty?)
149
+ )
150
+ end
151
+ end
140
152
  end
141
153
  end
142
154
  end
@@ -3,7 +3,8 @@
3
3
  require "securerandom"
4
4
 
5
5
  module Igniter
6
- module Replication
6
+ module Cluster
7
+ module Replication
7
8
  # Self-description of a running Igniter instance, used during replication.
8
9
  #
9
10
  # Call Manifest.current to capture the current process's metadata.
@@ -41,5 +42,6 @@ module Igniter
41
42
  }
42
43
  end
43
44
  end
45
+ end
44
46
  end
45
47
  end
@@ -1,7 +1,8 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Igniter
4
- module Replication
4
+ module Cluster
5
+ module Replication
5
6
  # Thread-safe in-memory registry of known nodes in the deployment network.
6
7
  #
7
8
  # Updated by ReflectiveReplicationAgent as nodes are spawned, heartbeat-ed,
@@ -9,14 +10,22 @@ module Igniter
9
10
  #
10
11
  # @example
11
12
  # topology = NetworkTopology.new
12
- # topology.register(node_id: "abc", host: "10.0.0.2", role: :worker)
13
- # topology.nodes(role: :worker) # => [NodeEntry]
14
- # topology.needs_role?(:coordinator) # => true
13
+ # topology.register(node_id: "abc", host: "10.0.0.2", capabilities: %i[local_llm container_runtime])
14
+ # topology.nodes(capability: :local_llm) # => [NodeEntry]
15
+ # topology.needs_capability_query?([:local_llm, :container_runtime]) # => false
15
16
  class NetworkTopology
16
17
  # Mutable record for a single live node (mutated only inside the Mutex).
17
- NodeEntry = Struct.new(:node_id, :host, :role,
18
+ NodeEntry = Struct.new(:node_id, :host, :profile,
18
19
  :registered_at, :last_seen_at, :healthy,
19
- keyword_init: true)
20
+ keyword_init: true) do
21
+ def capabilities
22
+ profile&.capabilities || []
23
+ end
24
+
25
+ def tags
26
+ profile&.tags || []
27
+ end
28
+ end
20
29
 
21
30
  def initialize
22
31
  @nodes = {}
@@ -27,14 +36,17 @@ module Igniter
27
36
  #
28
37
  # @param node_id [String]
29
38
  # @param host [String]
30
- # @param role [Symbol, nil]
39
+ # @param profile [NodeProfile, nil]
40
+ # @param capabilities [Array<Symbol>]
41
+ # @param tags [Array<Symbol>]
31
42
  # @return [NodeEntry]
32
- def register(node_id:, host:, role: nil)
43
+ def register(node_id:, host:, profile: nil, capabilities: [], tags: [])
33
44
  now = Time.now
45
+ profile ||= NodeProfile.new(capabilities: capabilities, tags: tags)
34
46
  entry = NodeEntry.new(
35
47
  node_id: node_id,
36
48
  host: host,
37
- role: role&.to_sym,
49
+ profile: profile,
38
50
  registered_at: now,
39
51
  last_seen_at: now,
40
52
  healthy: true
@@ -79,23 +91,37 @@ module Igniter
79
91
  @mutex.synchronize { @nodes.delete(node_id) }
80
92
  end
81
93
 
82
- # Return nodes, optionally filtered by role.
94
+ # Return nodes, optionally filtered by capability or query.
83
95
  #
84
- # @param role [Symbol, nil]
96
+ # @param capability [Symbol, String, nil]
97
+ # @param query [CapabilityQuery, Array<Symbol>, Hash, Symbol, String, nil]
85
98
  # @return [Array<NodeEntry>]
86
- def nodes(role: nil)
99
+ def nodes(capability: nil, query: nil)
87
100
  @mutex.synchronize do
88
101
  entries = @nodes.values.dup
89
- role ? entries.select { |e| e.role == role.to_sym } : entries
102
+ entries = entries.select { |e| e.capabilities.include?(capability.to_sym) } if capability
103
+ if query
104
+ normalized = CapabilityQuery.normalize(query)
105
+ entries = entries.select { |e| normalized.matches_profile?(e.profile) }
106
+ end
107
+ entries
90
108
  end
91
109
  end
92
110
 
93
- # True when no healthy node with the given role exists.
111
+ # True when no healthy node with the given capability exists.
94
112
  #
95
- # @param role [Symbol, String]
113
+ # @param capability [Symbol, String]
96
114
  # @return [Boolean]
97
- def needs_role?(role)
98
- nodes(role: role).none?(&:healthy)
115
+ def needs_capability?(capability)
116
+ nodes(capability: capability).none?(&:healthy)
117
+ end
118
+
119
+ # True when no healthy node satisfies the capability query.
120
+ #
121
+ # @param query [CapabilityQuery, Array<Symbol>, Hash, Symbol, String]
122
+ # @return [Boolean]
123
+ def needs_capability_query?(query)
124
+ nodes(query: query).none?(&:healthy)
99
125
  end
100
126
 
101
127
  # Count of healthy nodes across all roles.
@@ -119,5 +145,6 @@ module Igniter
119
145
  @mutex.synchronize { @nodes.keys.dup }
120
146
  end
121
147
  end
148
+ end
122
149
  end
123
150
  end
@@ -0,0 +1,134 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Igniter
4
+ module Cluster
5
+ module Replication
6
+ # Immutable snapshot of a node's observable runtime traits.
7
+ #
8
+ # Profiles bridge host discovery and cluster replication: a node can inspect
9
+ # its environment, derive capability coordinates, and advertise which
10
+ # capability queries it can currently satisfy.
11
+ class NodeProfile
12
+ DEFAULT_CAPABILITY_MAP = {
13
+ "ruby" => :ruby,
14
+ "bundle" => :ruby,
15
+ "rake" => :ruby,
16
+ "rspec" => :ruby,
17
+ "git" => :source_control,
18
+ "curl" => :http_client,
19
+ "wget" => :http_client,
20
+ "jq" => :json_cli,
21
+ "sqlite3" => :data_store,
22
+ "psql" => :data_store,
23
+ "redis-cli" => :data_store,
24
+ "python3" => :python,
25
+ "pip3" => :python,
26
+ "node" => :javascript,
27
+ "npm" => :javascript,
28
+ "yarn" => :javascript,
29
+ "pnpm" => :javascript,
30
+ "docker" => :container_runtime,
31
+ "docker-compose" => :container_runtime,
32
+ "ffmpeg" => :media_processing,
33
+ "ollama" => :local_llm,
34
+ "pio" => :embedded,
35
+ "arduino-cli" => :embedded,
36
+ "esptool.py" => :embedded,
37
+ "make" => :native_build,
38
+ "gcc" => :native_build,
39
+ "clang" => :native_build
40
+ }.freeze
41
+
42
+ attr_reader :hostname, :platform, :os, :cpu, :utilities,
43
+ :capabilities, :tags, :metadata
44
+
45
+ def self.from_discovery(snapshot, capabilities: [], tags: [],
46
+ capability_map: DEFAULT_CAPABILITY_MAP)
47
+ utility_candidates = Array(snapshot.dig(:paths, :utility_candidates))
48
+ discovered = utility_candidates.filter_map do |entry|
49
+ next unless entry[:present]
50
+
51
+ entry[:name].to_s
52
+ end
53
+
54
+ discovered |= Array(snapshot.dig(:paths, :discovered_executables)).map(&:to_s)
55
+ derived_capabilities = discovered.flat_map { |name| Array(capability_map[name]) }
56
+
57
+ new(
58
+ hostname: snapshot.dig(:host, :hostname),
59
+ platform: snapshot.dig(:host, :platform),
60
+ os: snapshot.dig(:host, :os),
61
+ cpu: snapshot.dig(:host, :cpu),
62
+ utilities: discovered,
63
+ capabilities: derived_capabilities + Array(capabilities),
64
+ tags: inferred_tags(snapshot) + Array(tags),
65
+ metadata: { generated_at: snapshot[:generated_at] }
66
+ )
67
+ end
68
+
69
+ def self.inferred_tags(snapshot)
70
+ tags = []
71
+ os = snapshot.dig(:host, :os).to_s.downcase
72
+ cpu = snapshot.dig(:host, :cpu).to_s
73
+
74
+ tags << :darwin if os.include?("darwin")
75
+ tags << :linux if os.include?("linux")
76
+ tags << cpu.tr("-", "_").to_sym unless cpu.empty?
77
+
78
+ ruby_engine = snapshot.dig(:runtime, :ruby, :engine).to_s
79
+ tags << ruby_engine.to_sym unless ruby_engine.empty?
80
+ tags
81
+ end
82
+
83
+ def initialize(hostname: nil, platform: nil, os: nil, cpu: nil,
84
+ utilities: [], capabilities: [], tags: [], metadata: {})
85
+ @hostname = hostname&.to_s
86
+ @platform = platform&.to_s
87
+ @os = os&.to_s
88
+ @cpu = cpu&.to_s
89
+ @utilities = Array(utilities).map(&:to_s).uniq.sort.freeze
90
+ @capabilities = Array(capabilities).map(&:to_sym).uniq.sort.freeze
91
+ @tags = Array(tags).map(&:to_sym).uniq.sort.freeze
92
+ @metadata = normalize_metadata(metadata).freeze
93
+ freeze
94
+ end
95
+
96
+ def capability?(capability)
97
+ @capabilities.include?(capability.to_sym)
98
+ end
99
+
100
+ def tag?(tag)
101
+ @tags.include?(tag.to_sym)
102
+ end
103
+
104
+ def to_h
105
+ {
106
+ hostname: @hostname,
107
+ platform: @platform,
108
+ os: @os,
109
+ cpu: @cpu,
110
+ utilities: @utilities,
111
+ capabilities: @capabilities,
112
+ tags: @tags,
113
+ metadata: @metadata
114
+ }
115
+ end
116
+
117
+ private
118
+
119
+ def normalize_metadata(value)
120
+ case value
121
+ when Hash
122
+ value.each_with_object({}) do |(key, nested), memo|
123
+ memo[key.to_sym] = normalize_metadata(nested)
124
+ end
125
+ when Array
126
+ value.map { |item| normalize_metadata(item) }
127
+ else
128
+ value
129
+ end
130
+ end
131
+ end
132
+ end
133
+ end
134
+ end
@@ -5,26 +5,28 @@ require_relative "replication_agent"
5
5
  require_relative "network_topology"
6
6
  require_relative "expansion_plan"
7
7
  require_relative "expansion_planner"
8
- require_relative "role_registry"
8
+ require_relative "capability_query"
9
+ require_relative "node_profile"
9
10
 
10
11
  module Igniter
11
- module Replication
12
+ module Cluster
13
+ module Replication
12
14
  # ReplicationAgent extended with episodic memory, self-reflection, and
13
15
  # topology-aware network expansion.
14
16
  #
15
17
  # == Additional message types
16
18
  #
17
- # :assess_network — run ExpansionPlanner; execute replicate_role/retire_node actions
19
+ # :assess_network — run ExpansionPlanner; execute replicate_capabilities/retire_node actions
18
20
  # :reflect — run a ReflectionCycle over recent episodes; store summary in state
19
21
  # :register_node — register a remote node in the local NetworkTopology
20
22
  # :node_heartbeat — update last_seen_at for a known node
21
- # :signal_scale — emit a :scale_signal episode (e.g. from load monitors)
23
+ # :signal_scale — emit a :scale_signal episode for a capability query
22
24
  #
23
25
  # == State keys (in addition to inherited :events)
24
26
  #
25
27
  # :topology — NetworkTopology instance (created lazily on first access)
26
28
  # :host_pool — Array<String> of candidate hosts
27
- # :required_roles — Array<Symbol> of roles that must always be present
29
+ # :required_capabilities — Array<CapabilityQuery-ish> that must always be present
28
30
  # :last_plan — Hash from the most recent ExpansionPlan
29
31
  # :last_reflection — String summary from the most recent reflection cycle
30
32
  #
@@ -38,21 +40,19 @@ module Igniter
38
40
  # Call +auto_assess(every: N)+ to schedule periodic topology assessment.
39
41
  #
40
42
  # @example
41
- # RoleRegistry.define(:worker, env_overrides: { "POOL" => "4" })
42
- #
43
43
  # class MyAgent < ReflectiveReplicationAgent
44
44
  # enable_class_memory
45
45
  # auto_assess every: 60
46
46
  # end
47
47
  #
48
48
  # ref = MyAgent.start(initial_state: {
49
- # topology: NetworkTopology.new,
50
- # required_roles: [:worker],
51
- # host_pool: ["10.0.0.2", "10.0.0.3"]
49
+ # topology: NetworkTopology.new,
50
+ # required_capabilities: [[:local_llm]],
51
+ # host_pool: ["10.0.0.2", "10.0.0.3"]
52
52
  # })
53
53
  # ref.call(:assess_network)
54
54
  class ReflectiveReplicationAgent < ReplicationAgent
55
- initial_state topology: nil, host_pool: [], required_roles: [],
55
+ initial_state topology: nil, host_pool: [], required_capabilities: [],
56
56
  last_plan: nil, last_reflection: nil
57
57
 
58
58
  # ── Class-level memory ─────────────────────────────────────────────────────
@@ -63,7 +63,7 @@ module Igniter
63
63
  # @param store [Memory::Store, nil] backing store; defaults to global default
64
64
  # @return [void]
65
65
  def enable_class_memory(store: nil)
66
- require "igniter/memory"
66
+ require "igniter/core/memory"
67
67
  @class_memory_store = store || Igniter::Memory.default_store
68
68
  @class_memory_enabled = true
69
69
  end
@@ -153,10 +153,13 @@ module Igniter
153
153
 
154
154
  on :register_node do |state:, payload:, **|
155
155
  topology = state[:topology] || NetworkTopology.new
156
+ agent = new
157
+ profile = payload[:profile] || agent.send(:build_profile_from_payload, payload)
158
+
156
159
  topology.register(
157
160
  node_id: payload.fetch(:node_id),
158
161
  host: payload.fetch(:host),
159
- role: payload[:role]
162
+ profile: profile
160
163
  )
161
164
  state.merge(topology: topology)
162
165
  end
@@ -167,10 +170,10 @@ module Igniter
167
170
  end
168
171
 
169
172
  on :signal_scale do |state:, payload:, **|
170
- role = payload.fetch(:role)
173
+ query = CapabilityQuery.normalize(payload[:query] || payload[:capabilities] || payload.fetch(:capability))
171
174
  class_memory&.record(
172
175
  type: :scale_signal,
173
- content: "scale_out:#{role}",
176
+ content: "scale_out:#{query.compact_signature}",
174
177
  outcome: nil
175
178
  )
176
179
  state
@@ -187,18 +190,18 @@ module Igniter
187
190
  def run_assess_network(state, payload)
188
191
  topology = state[:topology] || NetworkTopology.new
189
192
  planner = ExpansionPlanner.new(
190
- topology: topology,
191
- memory: self.class.class_memory,
192
- required_roles: Array(payload[:required_roles] || state[:required_roles]),
193
- host_pool: Array(payload[:host_pool] || state[:host_pool])
193
+ topology: topology,
194
+ memory: self.class.class_memory,
195
+ required_capabilities: Array(payload[:required_capabilities] || state[:required_capabilities]),
196
+ host_pool: Array(payload[:host_pool] || state[:host_pool])
194
197
  )
195
198
 
196
199
  plan = planner.plan
197
200
 
198
201
  plan.actions.each do |action|
199
202
  case action[:action]
200
- when :replicate_role
201
- run_replicate_role(action, topology)
203
+ when :replicate_capabilities
204
+ run_replicate_capabilities(action, topology)
202
205
  when :retire_node
203
206
  topology.remove(node_id: action[:node_id])
204
207
  deliver(:node_retired, node_id: action[:node_id], host: action[:host])
@@ -214,25 +217,43 @@ module Igniter
214
217
  state.merge(topology: topology, last_plan: plan.to_h)
215
218
  end
216
219
 
217
- # Execute a :replicate_role action: call run_replicate + register in topology.
220
+ # Execute a :replicate_capabilities action: call run_replicate + register in topology.
218
221
  #
219
222
  # @param action [Hash]
220
223
  # @param topology [NetworkTopology]
221
- def run_replicate_role(action, topology)
222
- role_obj = RoleRegistry.registered?(action[:role]) ? RoleRegistry.fetch(action[:role]) : nil
223
- env = role_obj&.env_overrides || {}
224
-
224
+ def run_replicate_capabilities(action, topology)
225
225
  run_replicate(
226
226
  host: action.fetch(:host),
227
227
  user: action.fetch(:user, "deploy"),
228
228
  strategy: action.fetch(:strategy, :git),
229
- env: env,
229
+ env: action.fetch(:env, {}),
230
230
  bootstrapper_options: action.fetch(:bootstrapper_options, {})
231
231
  )
232
232
 
233
- topology.register(node_id: SecureRandom.uuid, host: action[:host], role: action[:role])
234
- deliver(:role_replicated, host: action[:host], role: action[:role])
233
+ query = CapabilityQuery.normalize(action.fetch(:query))
234
+ profile = NodeProfile.new(capabilities: query.all_of, tags: query.tags)
235
+ topology.register(node_id: SecureRandom.uuid, host: action[:host], profile: profile)
236
+ deliver(:capabilities_replicated, host: action[:host], query: query.to_h)
237
+ end
238
+
239
+ def build_profile_from_payload(payload)
240
+ return payload[:profile] if payload[:profile].is_a?(NodeProfile)
241
+
242
+ discovery = payload[:discovery]
243
+ if discovery
244
+ NodeProfile.from_discovery(
245
+ discovery,
246
+ capabilities: Array(payload[:capabilities]),
247
+ tags: Array(payload[:tags])
248
+ )
249
+ else
250
+ NodeProfile.new(
251
+ capabilities: Array(payload[:capabilities]),
252
+ tags: Array(payload[:tags])
253
+ )
254
+ end
235
255
  end
236
256
  end
257
+ end
237
258
  end
238
259
  end
@@ -1,9 +1,10 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require_relative "../agent"
3
+ require "igniter/agent"
4
4
 
5
5
  module Igniter
6
- module Replication
6
+ module Cluster
7
+ module Replication
7
8
  # Agent that handles :replicate messages to deploy Igniter to remote servers.
8
9
  #
9
10
  # In production, start via ReplicationAgent.start and send messages through
@@ -83,5 +84,6 @@ module Igniter
83
84
  deliver(:replication_failed, host: payload[:host], error: e.message)
84
85
  end
85
86
  end
87
+ end
86
88
  end
87
89
  end
@@ -3,7 +3,8 @@
3
3
  require "open3"
4
4
 
5
5
  module Igniter
6
- module Replication
6
+ module Cluster
7
+ module Replication
7
8
  # Thin subprocess wrapper over the +ssh+ and +scp+ CLI tools.
8
9
  #
9
10
  # Provides exec/exec! for running remote commands and upload! for
@@ -73,5 +74,6 @@ module Igniter
73
74
  opts
74
75
  end
75
76
  end
77
+ end
76
78
  end
77
79
  end
@@ -0,0 +1,38 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative "replication/manifest"
4
+ require_relative "replication/ssh_session"
5
+ require_relative "replication/bootstrapper"
6
+ require_relative "replication/bootstrappers/git"
7
+ require_relative "replication/bootstrappers/gem"
8
+ require_relative "replication/bootstrappers/tarball"
9
+ require_relative "replication/replication_agent"
10
+ require_relative "replication/capability_query"
11
+ require_relative "replication/node_profile"
12
+ require_relative "replication/network_topology"
13
+ require_relative "replication/expansion_plan"
14
+ require_relative "replication/expansion_planner"
15
+ require_relative "replication/reflective_replication_agent"
16
+
17
+ module Igniter
18
+ module Cluster
19
+ # Deployment and self-replication capabilities for clustered nodes.
20
+ module Replication
21
+ ReplicationError = Class.new(Igniter::Error) unless const_defined?(:ReplicationError, false)
22
+
23
+ BOOTSTRAPPERS = {
24
+ git: Bootstrappers::Git,
25
+ gem: Bootstrappers::Gem,
26
+ tarball: Bootstrappers::Tarball
27
+ }.freeze unless const_defined?(:BOOTSTRAPPERS, false)
28
+
29
+ def self.bootstrapper_for(strategy, **options)
30
+ klass = BOOTSTRAPPERS.fetch(strategy.to_sym) do
31
+ raise ArgumentError,
32
+ "Unknown bootstrapper: #{strategy}. Available: #{BOOTSTRAPPERS.keys.join(", ")}"
33
+ end
34
+ klass.new(**options)
35
+ end
36
+ end
37
+ end
38
+ end