arch(level1-merged): integrate ws-1 + ws-2 + ws-3 + ws-3.5

Cargo.toml

@@ -1,5 +1,5 @@
 [workspace]
-members = [".", "crates/ironclaw_common", "crates/ironclaw_host_api", "crates/ironclaw_storage", "crates/ironclaw_filesystem", "crates/ironclaw_memory", "crates/ironclaw_events", "crates/ironclaw_event_projections", "crates/ironclaw_reborn_event_store", "crates/ironclaw_extensions", "crates/ironclaw_processes", "crates/ironclaw_dispatcher", "crates/ironclaw_scripts", "crates/ironclaw_mcp", "crates/ironclaw_wasm", "crates/ironclaw_capabilities", "crates/ironclaw_secrets", "crates/ironclaw_network", "crates/ironclaw_host_runtime", "crates/ironclaw_runtime_policy", "crates/ironclaw_authorization", "crates/ironclaw_run_state", "crates/ironclaw_approvals", "crates/ironclaw_resources", "crates/ironclaw_trust", "crates/ironclaw_turns", "crates/ironclaw_threads", "crates/ironclaw_loop_support", "crates/ironclaw_reborn", "crates/ironclaw_reborn_config", "crates/ironclaw_reborn_composition", "crates/ironclaw_reborn_cli", "crates/ironclaw_conversations", "crates/ironclaw_product_adapters", "crates/ironclaw_product_workflow", "crates/ironclaw_product_adapter_registry", "crates/ironclaw_wasm_product_adapters", "crates/ironclaw_telegram_v2_adapter", "crates/ironclaw_outbound", "crates/ironclaw_architecture", "crates/ironclaw_safety", "crates/ironclaw_skills", "crates/ironclaw_llm", "crates/ironclaw_engine", "crates/ironclaw_gateway", "crates/ironclaw_tui"]
+members = [".", "crates/ironclaw_common", "crates/ironclaw_host_api", "crates/ironclaw_storage", "crates/ironclaw_filesystem", "crates/ironclaw_memory", "crates/ironclaw_events", "crates/ironclaw_event_projections", "crates/ironclaw_reborn_event_store", "crates/ironclaw_extensions", "crates/ironclaw_processes", "crates/ironclaw_dispatcher", "crates/ironclaw_scripts", "crates/ironclaw_mcp", "crates/ironclaw_wasm", "crates/ironclaw_capabilities", "crates/ironclaw_secrets", "crates/ironclaw_network", "crates/ironclaw_host_runtime", "crates/ironclaw_runtime_policy", "crates/ironclaw_authorization", "crates/ironclaw_run_state", "crates/ironclaw_approvals", "crates/ironclaw_resources", "crates/ironclaw_trust", "crates/ironclaw_turns", "crates/ironclaw_agent_loop", "crates/ironclaw_threads", "crates/ironclaw_loop_support", "crates/ironclaw_reborn", "crates/ironclaw_reborn_config", "crates/ironclaw_reborn_composition", "crates/ironclaw_reborn_cli", "crates/ironclaw_conversations", "crates/ironclaw_product_adapters", "crates/ironclaw_product_workflow", "crates/ironclaw_product_adapter_registry", "crates/ironclaw_wasm_product_adapters", "crates/ironclaw_telegram_v2_adapter", "crates/ironclaw_outbound", "crates/ironclaw_architecture", "crates/ironclaw_safety", "crates/ironclaw_skills", "crates/ironclaw_llm", "crates/ironclaw_engine", "crates/ironclaw_gateway", "crates/ironclaw_tui"]
 exclude = [
     "channels-src/discord",
     "channels-src/feishu",

crates/ironclaw_agent_loop/CLAUDE.md

@@ -0,0 +1,21 @@
+# ironclaw_agent_loop guardrails
+
+- Owns "what an agent loop is": strategy traits, the `AgentLoopPlanner` facade,
+  the `AgentLoopExecutor` trait + canonical impl, and `LoopExecutionState`.
+- Stays one layer above `ironclaw_turns` (which owns runner-facing turn
+  contracts). Depends on `ironclaw_turns` for `LoopRunContext`, `LoopExit`,
+  `LoopXxxPort` traits, and ref types.
+- Does NOT depend on `ironclaw_reborn`. The framework crate has no knowledge
+  of `AgentLoopDriver`; that bridge lives in `PlannedDriver` in
+  `ironclaw_reborn`.
+- Stores refs, cursors, counters, versions, and safe summaries only. Never
+  raw prompts, raw model output, raw tool input, secrets, host paths, provider
+  errors, or stack traces in `LoopExecutionState` or any strategy slot.
+- Strategies are `&self`-only; `LoopExecutionState` is value-immutable. All
+  mutation happens by the executor swapping a strategy's returned slot into
+  the next whole state. There is no `&mut LoopExecutionState` API.
+- New strategies, slots, and outcome enums must land typed (no string keys,
+  no `serde_json::Value` interior in long-lived state). Per
+  `.claude/rules/types.md`.
+- Master spec: `docs/reborn/agent-loop-skeleton.md`. Workstream briefs:
+  `docs/reborn/agent-loop-briefs/`.

crates/ironclaw_agent_loop/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "ironclaw_agent_loop"
+version = "0.1.0"
+edition = "2024"
+rust-version = "1.92"
+description = "Agent-loop framework state and strategy contracts for IronClaw Reborn"
+authors = ["NEAR AI <support@near.ai>"]
+license = "MIT OR Apache-2.0"
+homepage = "https://github.com/nearai/ironclaw"
+repository = "https://github.com/nearai/ironclaw"
+publish = false
+
+[dependencies]
+async-trait = "0.1"
+blake3 = "1"
+ironclaw_host_api = { path = "../ironclaw_host_api", version = "0.1.0" }
+ironclaw_turns = { path = "../ironclaw_turns", version = "0.1.0" }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+serde_jcs = "0.2"
+thiserror = "2"

crates/ironclaw_agent_loop/src/families/mod.rs

@@ -0,0 +1,44 @@
+use std::sync::Arc;
+
+use crate::family::{
+    ComponentDigest, ComponentIdentity, LoopFamily, LoopFamilyId, LoopFamilyPlanner,
+};
+
+struct DefaultLoopFamilyPlanner;
+
+impl LoopFamilyPlanner for DefaultLoopFamilyPlanner {}
+
+/// Stable digest: SHA-256 of
+/// `ironclaw_agent_loop.default_family.v1:planner=DefaultLoopFamilyPlanner;schema=component_identity_v1;family_id=default`.
+///
+/// Update this digest when the default family composition, planner behavior, or
+/// identity schema changes in a replay-relevant way.
+pub const DEFAULT_FAMILY_DIGEST: ComponentDigest = ComponentDigest([
+    0xf5, 0xa3, 0x2b, 0xd7, 0x15, 0x2f, 0xf4, 0x9a, 0x2b, 0xb7, 0x92, 0xee, 0x97, 0xe2, 0xa4, 0x54,
+    0x35, 0x4f, 0x0d, 0xab, 0x6a, 0x81, 0xcc, 0x3a, 0xbe, 0x35, 0xe9, 0x33, 0x55, 0xc9, 0x2a, 0xcf,
+]);
+
+/// The default loop family: the text-tool-use baseline once the planner and
+/// executor workstreams land.
+pub fn default() -> LoopFamily {
+    LoopFamily::new(
+        LoopFamilyId::DEFAULT,
+        ComponentIdentity::from_static("default", DEFAULT_FAMILY_DIGEST),
+        Arc::new(DefaultLoopFamilyPlanner),
+    )
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn default_family_has_default_identity() {
+        let family = default();
+
+        assert_eq!(family.id(), &LoopFamilyId::DEFAULT);
+        assert_eq!(family.version().id, "default");
+        assert_ne!(family.version().digest, ComponentDigest([0; 32]));
+        assert_eq!(family.version().digest, DEFAULT_FAMILY_DIGEST);
+    }
+}