feat: add Atomizer HQ multi-agent cluster infrastructure

- 8-agent OpenClaw cluster (Manager, Tech-Lead, Secretary, Auditor, Optimizer, Study-Builder, NX-Expert, Webster) - Orchestration engine: orchestrate.py (sync delegation + handoffs) - Workflow engine: YAML-defined multi-step pipelines - Agent workspaces: SOUL.md, AGENTS.md, MEMORY.md per agent - Shared skills: delegate, orchestrate, atomizer-protocols - Capability registry (AGENTS_REGISTRY.json) - Cluster management: cluster.sh, systemd template - All secrets replaced with env var references
2026-02-15 21:18:18 +00:00
parent d6a1d6eee1
commit 3289a76e19
170 changed files with 24949 additions and 0 deletions
--- a/hq/workspaces/technical-lead/studies/M1_conical_mirror/PHASE0_BREAKDOWN.md
+++ b/hq/workspaces/technical-lead/studies/M1_conical_mirror/PHASE0_BREAKDOWN.md
@@ -0,0 +1,291 @@
+# Phase 0 — Technical Breakdown
+## M1 Conical Primary Mirror — WFE Optimization
+
+| Field | Value |
+|-------|-------|
+| **Study ID** | M1-CONICAL-001 |
+| **Phase** | 0 — Problem Definition |
+| **Author** | Technical Lead 🔧 |
+| **Date** | 2025-07-12 |
+| **Status** | Ready for Optimizer |
+
+---
+
+## 1. Geometry — What Are We Working With
+
+### 1.1 Optical Surface
+| Parameter | Value | Notes |
+|-----------|-------|-------|
+| Type | Conical (conic constant TBD by client) | Near-parabolic likely; conic constant K ≈ −1 |
+| Clear Aperture | 500 mm (∅) | Optical active zone |
+| Substrate Material | Aluminum alloy (likely 6061-T6 or RSA-6061) | High thermal conductivity, CTE ~23.6 µm/m·°C |
+| Mounting Interface | Central bore or 3-point peripheral (TBD) | Kinematic mount assumed |
+
+### 1.2 Structural Architecture (Typical Lightweighted Mirror)
+The mirror assembly consists of three structural zones:
+
+```
+┌──────────────────────────────────┐
+│         Optical Facesheet        │  ← Reflecting surface
+├──────────────────────────────────┤
+│     Lightweighting Core          │  ← Pocket pattern (hex/triangular/arch)
+│     (ribs + pockets)             │
+├──────────────────────────────────┤
+│         Back Facesheet           │  ← Structural closure
+└──────────────────────────────────┘
+         ↕ Mounting features
+```
+
+### 1.3 Key Geometric Assumptions
+- **Open-back vs. closed-back:** Closed-back assumed (back facesheet present) for thermal stability. Open-back is lighter but thermally worse — flag as trade study candidate.
+- **Pocket geometry:** Hexagonal pocket pattern assumed as baseline (best stiffness-to-weight for circular apertures).
+- **Mounting:** 3-point kinematic mount at ~70% radius (minimizes gravity-induced WFE per classical mirror support theory). Exact mount config is a design variable.
+- **Central obscuration:** Assumed present (Cassegrain-family), ~100mm bore — confirm with client.
+
+---
+
+## 2. Design Parameters — What Can We Change
+
+These are the variables the Optimizer will manipulate:
+
+### 2.1 Structural Sizing
+
+| Parameter | Symbol | Suggested Range | Units | Notes |
+|-----------|--------|----------------|-------|-------|
+| Front facesheet thickness | t_f | 3.0 – 8.0 | mm | Below 3mm → print-through risk |
+| Back facesheet thickness | t_b | 2.0 – 6.0 | mm | Can be thinner than front |
+| Rib thickness | t_r | 1.5 – 5.0 | mm | Manufacturing floor ~1.5mm for machined Al |
+| Rib height (core depth) | h_c | 25 – 60 | mm | Drives bending stiffness (∝ h³) |
+| Number of ring ribs | N_ring | 2 – 5 | — | Radial stiffening |
+| Number of circumferential ribs | N_circ | 12 – 36 | — | Must satisfy pocket symmetry |
+| Pocket pattern type | — | {hex, tri, arch} | discrete | Hex = baseline |
+
+### 2.2 Mount Configuration
+
+| Parameter | Symbol | Suggested Range | Units | Notes |
+|-----------|--------|----------------|-------|-------|
+| Mount radial position | r_mount | 0.60 – 0.80 × R | ratio | ~0.7R is classical optimum for uniform plates |
+| Number of mount points | N_mount | 3 or 6 | discrete | 3-point baseline; 6-point for larger mirrors |
+| Mount pad diameter | d_pad | 10 – 25 | mm | Affects local stress concentration |
+| Mount compliance | k_mount | 1e4 – 1e7 | N/m | If flexure-mounted (optional) |
+
+### 2.3 Material Selection (if open)
+
+| Option | E (GPa) | ρ (kg/m³) | CTE (µm/m·°C) | κ (W/m·K) | Notes |
+|--------|---------|-----------|---------------|-----------|-------|
+| Al 6061-T6 | 68.9 | 2700 | 23.6 | 167 | Baseline — standard optical Al |
+| RSA-6061 | 68.9 | 2700 | 23.6 | 167 | Rapid-solidified — superior polishability |
+| Al 7075-T6 | 71.7 | 2810 | 23.4 | 130 | Higher strength, similar stiffness |
+| AlBeMet 162 | 193 | 2071 | 13.9 | 210 | Exotic — 3× specific stiffness, cost flag ⚠️ |
+
+> **Recommendation:** Fix at 6061-T6 unless client opens material as a trade variable.
+
+---
+
+## 3. Objectives — What Are We Optimizing
+
+### 3.1 Primary Objective: Minimize Wavefront Error (WFE)
+
+The WFE is the critical performance metric. We decompose it via **Zernike polynomials** on the optical surface:
+
+| Objective | Metric | Target | Notes |
+|-----------|--------|--------|-------|
+| **RMS WFE (gravity)** | RSS of gravity-induced surface error, rigid-body-removed | < λ/10 RMS @ 632.8nm → **< 63.3 nm RMS** | Under 1G, optical axis horizontal (worst case) |
+| **RMS WFE (thermal)** | RSS of thermally-induced surface error, focus-removed | < λ/10 RMS @ 632.8nm → **< 63.3 nm RMS** | Under 5°C axial gradient |
+| **RMS WFE (combined)** | RSS of gravity + thermal | < λ/10 RMS → **< 63.3 nm** | This is the real target |
+
+### 3.2 Zernike Decomposition Strategy
+
+We extract surface deformations and project onto Zernike basis:
+- **Remove:** Piston (Z₀⁰), Tip/Tilt (Z₁±¹), Defocus (Z₂⁰) — these are correctable by alignment
+- **Retain & Minimize:** Astigmatism (Z₂±²), Coma (Z₃±¹), Trefoil (Z₃±³), Spherical (Z₄⁰), and all higher-order terms
+- **Key concern for lightweighted mirrors:** Trefoil and hexafoil from rib print-through
+
+### 3.3 Secondary Objective: Minimize Mass
+
+| Objective | Target | Hard/Soft |
+|-----------|--------|-----------|
+| Total assembly mass | ≤ 8.0 kg | **Hard** constraint (see §4) |
+| Mass (stretch goal) | ≤ 6.5 kg | Soft — report if achievable without WFE penalty |
+
+> **Note:** For a 500mm ∅ solid Al disk ~50mm thick, mass ≈ 25 kg. We need ~70% lightweighting → this is aggressive but achievable.
+
+### 3.4 Objective Formulation for Optimizer
+
+```
+MINIMIZE:   f(x) = RMS_WFE_combined(x)
+
+SUBJECT TO: g₁(x) = mass(x) ≤ 8.0 kg
+            g₂(x) = σ_max(x) ≤ σ_allow
+            g₃(x) = f₁(x) ≥ f₁_min          (fundamental frequency)
+            g₄(x) = t_f(x) ≥ t_f_min         (manufacturing)
+            ...
+```
+
+---
+
+## 4. Constraints — Hard Limits
+
+### 4.1 Performance Constraints
+
+| Constraint | Value | Rationale |
+|------------|-------|-----------|
+| RMS WFE (total) | ≤ 63.3 nm (λ/10 @ 632.8nm) | Client requirement |
+| Fundamental frequency | ≥ 80 Hz (suggested) | Typical for ground instrument — prevents coupling with support structure. **Confirm with client.** |
+| Peak stress | ≤ 0.5 × σ_yield | Safety factor of 2 on yield (σ_y = 276 MPa for 6061-T6 → σ_allow = 138 MPa) |
+
+### 4.2 Mass & Envelope Constraints
+
+| Constraint | Value | Rationale |
+|------------|-------|-----------|
+| Total mass | ≤ 8.0 kg | Client mass budget — hard limit |
+| Outer diameter | 500 mm (fixed by aperture) | Optical requirement |
+| Total depth (axial) | ≤ 80 mm (suggested) | Package envelope — **confirm with client** |
+
+### 4.3 Manufacturing Constraints
+
+| Constraint | Value | Rationale |
+|------------|-------|-----------|
+| Minimum rib thickness | ≥ 1.5 mm | CNC machinability for Al pocketing |
+| Minimum facesheet thickness | ≥ 3.0 mm | Print-through mitigation during polishing |
+| Minimum pocket corner radius | ≥ 2.0 mm | Tool access |
+| Pocket depth uniformity | All pockets same depth | Simplifies machining, reduces cost |
+
+### 4.4 Thermal Constraints
+
+| Constraint | Value | Rationale |
+|------------|-------|-----------|
+| Operating temperature range | 20°C ± 10°C (assumed) | Standard lab/observatory — **confirm** |
+| Thermal gradient (axial) | 5°C front-to-back | Client spec — drives thermal WFE |
+| Thermal gradient (radial) | 0°C (assumed uniform) | Conservative assumption — **confirm** |
+
+### 4.5 Boundary Condition Notes
+- Gravity load: 1G along optical axis (axial) **AND** 1G lateral (transverse) — both must be checked. Transverse is typically the worst case for primary mirrors.
+- Mount preload: Zero-preload kinematic assumed. If bolted, include preload in analysis.
+
+---
+
+## 5. Solver Requirements — What Analysis Types Are Needed
+
+### 5.1 Analysis Chain
+
+The optimization requires a **multi-physics analysis chain** executed per design iteration:
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│  SOL 101         │     │  SOL 153         │     │  SOL 101         │
+│  Linear Static   │     │  Steady Thermal  │     │  Linear Static   │
+│  (Gravity)       │     │  (Gradient)      │     │  (Thermal Loads) │
+│                  │     │                  │     │                  │
+│  Load: 1G axial  │     │  BC: ΔT = 5°C   │     │  Load: Temp field│
+│  Load: 1G lateral│     │  front-to-back   │     │  from SOL 153    │
+└────────┬─────────┘     └────────┬─────────┘     └────────┬─────────┘
+         │                        │                         │
+         ▼                        └────────────┬────────────┘
+    ┌────────────┐                              ▼
+    │ WFE Extract│                    ┌────────────────┐
+    │ (gravity)  │                    │  WFE Extract    │
+    └────────────┘                    │  (thermal)      │
+         │                            └────────────────┘
+         │                                     │
+         └──────────────┬──────────────────────┘
+                        ▼
+              ┌──────────────────┐
+              │  RSS Combination │
+              │  → Total WFE     │
+              └──────────────────┘
+```
+
+### 5.2 Solver Details
+
+| Solver | Nastran SOL | Purpose | Key Outputs |
+|--------|------------|---------|-------------|
+| **Linear Static (gravity)** | SOL 101 | Surface deformation under 1G (2 subcases: axial + lateral) | Displacement field on optical surface |
+| **Steady-State Thermal** | SOL 153 | Temperature distribution under 5°C gradient | Nodal temperatures |
+| **Linear Static (thermal)** | SOL 101 | Thermo-elastic deformation from SOL 153 temp field | Displacement field on optical surface |
+| **Normal Modes** | SOL 103 | Fundamental frequency check | Eigenvalues, mode shapes |
+| **Design Optimization** | SOL 200 | Nastran-native optimization (if using gradient-based) | Optimal sizing variables |
+
+### 5.3 WFE Extraction Requirements
+
+Post-processing pipeline (per load case):
+
+1. **Extract** optical surface node displacements (UX, UY, UZ)
+2. **Transform** to local optical coordinates (sag direction = Z along optical axis)
+3. **Fit rigid-body motions** (piston, tip, tilt) → remove
+4. **Optionally remove** defocus (client-correctable)
+5. **Project** residual onto Zernike basis through order N ≥ 15 (captures rib print-through harmonics)
+6. **Compute** RMS WFE = sqrt(Σ cₙ²) for non-removed terms
+7. **Report** Zernike coefficients, PV, RMS, and surface error map
+
+> **This is where Atomizer's LAC framework is critical** — the Zernike extraction and parameter monitoring pipeline.
+
+### 5.4 Mesh Requirements
+
+| Requirement | Specification | Rationale |
+|-------------|--------------|-----------|
+| Element type | CQUAD4/CQUAD8 (shells) or CHEXA (solids) | Shells preferred for parametric sizing; solids for accuracy |
+| Optical surface mesh density | ≥ 5 elements per rib cell across | Must resolve print-through quilting |
+| Minimum elements across facesheet thickness | ≥ 3 (if solid) | Through-thickness bending accuracy |
+| Mesh convergence study | **Required** before optimization | Per standard practice — run at 1×, 2×, 4× baseline density |
+| Optical surface node pattern | Regular grid or ring pattern | Clean Zernike fitting requires well-distributed sample points |
+
+### 5.5 Optimization Strategy Recommendation
+
+| Approach | Pros | Cons | Recommendation |
+|----------|------|------|----------------|
+| **SOL 200 (gradient-based)** | Fast convergence, native Nastran | Limited to sizing, requires smooth design space | ✅ **Phase 1 — sizing optimization** |
+| **Surrogate + GA** | Handles discrete variables, global search | Expensive (many FEA calls), needs DOE | ✅ **Phase 2 — if topology/layout changes needed** |
+| **Hybrid (SOL 200 → Surrogate)** | Best of both — fast local + global exploration | Complex setup | ✅ **Phase 3 — refinement** |
+
+**Recommended approach:** Start with SOL 200 for continuous sizing variables (facesheets, ribs, core depth), then move to surrogate-based if discrete layout changes (pocket pattern, mount count) are needed.
+
+---
+
+## 6. Risk Register & Open Items
+
+### 6.1 Technical Risks
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+| Print-through dominates WFE | High | High | Ensure facesheet t_f ≥ 3mm; may need t_f ≥ 5mm |
+| Thermal WFE exceeds budget | Medium | High | Al is thermally well-behaved (high κ, uniform CTE) but 5°C gradient is non-trivial at λ/10 |
+| Mass budget too tight for λ/10 | Medium | High | 8 kg at 500mm with λ/10 is ambitious. ~70% lightweighting needed. May need to trade WFE vs. mass. |
+| Mount-induced distortion | Medium | Medium | Kinematic design critical; include mount pad compliance in model |
+| Mesh-dependent WFE extraction | Low | High | Convergence study is mandatory |
+
+### 6.2 Open Items (Need Client Input)
+
+| # | Question | Default Assumption |
+|---|----------|--------------------|
+| 1 | Conic constant of optical surface? | K = −1 (parabolic) |
+| 2 | Central obscuration diameter? | 100 mm |
+| 3 | Open-back or closed-back preference? | Closed-back |
+| 4 | Gravity vector orientation during operation? | Both axial and lateral checked |
+| 5 | Fundamental frequency requirement? | ≥ 80 Hz |
+| 6 | Axial envelope (total mirror depth)? | ≤ 80 mm |
+| 7 | Material locked to 6061-T6? | Yes |
+| 8 | Is defocus correctable (removable from WFE)? | Yes — remove from budget |
+| 9 | Operating thermal environment details? | 20°C ± 10°C, 5°C axial gradient |
+| 10 | Mount type preference (flexure/pad/bipod)? | 3-point pad, kinematic |
+
+---
+
+## 7. Summary — Optimizer Input Checklist
+
+- [x] Geometry defined (conical, 500mm, Al alloy, lightweighted)
+- [x] Design variables identified with ranges (12 parameters)
+- [x] Objective function defined (minimize RMS WFE, Zernike-decomposed)
+- [x] Constraints enumerated (mass ≤ 8kg, stress, frequency, manufacturing)
+- [x] Solver chain specified (SOL 101 + SOL 153 + SOL 103, optional SOL 200)
+- [x] WFE extraction pipeline defined (rigid-body removal, Zernike projection)
+- [x] Mesh requirements specified
+- [x] Risks flagged
+- [ ] Open items awaiting client input (10 items)
+
+> **This document is ready for the Optimizer to consume.**
+> Open items use conservative defaults — optimization can proceed, with results refined once client clarifies.
+
+---
+
+*Technical Lead 🔧 — Physics is the boss. We just translate.*