## Phase 126: Kalika Functional Materials & Energy Applications — Batteries, Solar Cells, Thermoelectrics, Catalysis, 2D Materials, MOFs, Polymers, HEAs, Metamaterials & Nuclear Materials

Covers application-specific computational workflows for all major functional
materials classes. This phase integrates capabilities from Phases 116-125 into
domain-specific workflows that materials scientists actually use: predicting
battery voltages from DFT total energies, screening photovoltaic absorbers via
the spectroscopic limited maximum efficiency metric, constructing volcano plots
for catalyst design, generating van der Waals heterostructures with twist angle
control, computing gas adsorption isotherms in MOFs via GCMC, predicting polymer
glass transition temperatures from MD, generating special quasirandom structures
for high-entropy alloys, computing photonic band structures for metamaterials,
and modeling radiation damage cascades in nuclear materials. Each section
produces a self-contained library with types, algorithms, workflows, and tests
that chain together the lower-level engines (DFT, phonons, transport, defects,
surfaces, phase diagrams) into the high-level calculations that drive materials
discovery.

---

### 126.1 Scaffolding & Core Types (`@kalika/functional-materials`)

#### 126.1.1 Project Setup

- [x] **126.1.1.1** Create `libs/kalika/functional-materials/` directory with
      `package.json`, `project.json`, `tsconfig.json`, and `src/index.ts` barrel
      export — add `@kalika/functional-materials` path mapping to
      `tsconfig.base.json`
- [x] **126.1.1.2** Configure build with tsup (TypeScript) and wasm-pack (Rust
      kernels) — dual ESM/CJS output, `.d.ts` generation, Rust crate under
      `crates/functional-materials/` with `napi-rs` bindings for
      performance-critical inner loops (GCMC sampling, SQS generation, cascade
      simulation)
- [x] **126.1.1.3** Set up Vitest test infrastructure with domain-specific test
      helpers: `expectVoltage(v, expected, toleranceV)`,
      `expectEfficiency(eta, expected, tolerancePct)`,
      `expectAdsorption(loading, expected, toleranceMolKg)`,
      `expectZT(zt, expected, tolerance)` — all producing informative failure
      messages with units

#### 126.1.2 Core Material Types

- [x] **126.1.2.1** Define `BatteryMaterial` type: host structure (from Phase
      116 `Structure`), working ion species (`Li` | `Na` | `K` | `Mg` | `Ca` |
      `Zn`), ion sites (fractional coordinates, site energies), redox-active
      species, theoretical capacity (mAh/g), voltage profile (array of
      `{x: number; voltage: number}`), migration barriers (eV per path),
      electronic conductivity classification, and stability window (V vs.
      reference)
- [x] **126.1.2.2** Define `SolarAbsorber` type: structure, band gap (direct and
      indirect, eV), absorption coefficient spectrum (array of
      `{energy: number;     alpha: number}` in eV and cm⁻¹), effective masses
      (electron and hole), defect tolerance metric, Shockley-Queisser efficiency
      limit, spectroscopic limited maximum efficiency (SLME), and stability
      classification (thermodynamic, kinetic, environmental)
- [x] **126.1.2.3** Define `Thermoelectric` type: structure, Seebeck coefficient
      S(T) (μV/K), electrical conductivity σ(T) (S/m), electronic thermal
      conductivity κ_e(T) (W/mK), lattice thermal conductivity κ_L(T) (W/mK),
      power factor S²σ(T), figure of merit ZT(T), optimal carrier concentration
      n_opt(T), and weighted mobility μ_w
- [x] **126.1.2.4** Define `Catalyst` type: surface structure (slab model from
      Phase 122), active site geometry, adsorption energies (map of intermediate
      species to binding energy in eV), reaction energy diagram (array of
      `{step: string; deltaG: number; barrier: number}`), overpotential (V),
      turnover frequency estimate, and selectivity metrics
- [x] **126.1.2.5** Define `TwoDMaterial` type: structure (with vacuum layer
      specification), number of layers, exfoliation energy (meV/atom), in-plane
      lattice parameters, layer group symmetry, band gap (monolayer vs. bulk),
      effective masses, valley degeneracy, magnetic order (if any), and
      topological invariant (Z₂ index)
- [x] **126.1.2.6** Define `MOF` type: node (metal cluster) composition, linker
      SMILES/structure, topology (RCSR three-letter code), unit cell, pore
      descriptors (`largestIncludedSphere`, `largestFreeSphere`,
      `accessibleVolumeFraction`, `accessibleSurfaceArea`), stability metrics
      (decomposition temperature, water stability score), and gas uptake data
      (map of gas species to adsorption isotherm)
- [x] **126.1.2.7** Define `Polymer` type: repeat unit SMILES, degree of
      polymerization, tacticity (`isotactic` | `syndiotactic` | `atactic`),
      glass transition temperature T_g (K), melting temperature T_m (K), density
      (g/cm³), elastic modulus (GPa), dielectric constant, thermal conductivity
      (W/mK), and chain configuration (end-to-end distance, radius of gyration)
- [x] **126.1.2.8** Define `HighEntropyAlloy` type: component elements (5+
      entries with molar fractions), crystal structure (`FCC` | `BCC` | `HCP` |
      `multiphase`), lattice parameter, mixing enthalpy (kJ/mol),
      configurational entropy (J/mol-K), delta parameter (atomic size mismatch),
      VEC (valence electron concentration), yield strength (MPa), hardness
      (GPa), and phase stability classification
- [x] **126.1.2.9** Define `Metamaterial` type: unit cell geometry (2D or 3D),
      constituent materials, filling fraction, effective permittivity tensor,
      effective permeability tensor, photonic/phononic band structure, band gap
      ranges (frequency intervals), and effective refractive index (possibly
      negative)
- [x] **126.1.2.10** Define `NuclearMaterial` type: structure, threshold
      displacement energy (eV per sublattice), Frenkel pair formation energy
      (eV), defect cluster binding energies, swelling coefficient, irradiation
      hardening parameters, and dose-property curves

#### 126.1.3 Shared Utilities

- [x] **126.1.3.1** Implement unit conversion utilities for materials science:
      eV-to-kJ/mol (96.485), mAh/g-to-C/kg, cm⁻¹-to-eV, S/cm-to-S/m, W/mK
      conversions, Angstrom-to-bohr, Ry-to-eV (13.6057), Ha-to-eV (27.2114) —
      with compile-time dimensional analysis via branded types to prevent unit
      mismatches
- [x] **126.1.3.2** Implement physical constants module for functional
      materials: Faraday constant F = 96485.33212 C/mol, Boltzmann constant k_B,
      elementary charge e, Planck constant h, solar spectrum AM1.5G (ASTM
      G173-03, tabulated 280-4000 nm), standard hydrogen electrode potential,
      and vacuum permittivity — all with CODATA 2018 values and uncertainties
- [x] **126.1.3.3** Implement descriptor computation framework: given a
      `Structure` and a list of descriptor functions, compute a feature vector
      for high-throughput screening — including elemental descriptors
      (electronegativity, ionic radius, oxidation state), structural descriptors
      (coordination number, bond lengths, distortion indices), and composition
      descriptors (average atomic mass, electronegativity variance)

---

### 126.2 Battery Materials (`@kalika/battery-materials`)

#### 126.2.1 Voltage Prediction

- [x] **126.2.1.1** Implement intercalation voltage computation: given DFT total
      energies G(Li*{x₂}HostM) and G(Li*{x₁}HostM) at two lithiation levels x₁
      and x₂, and the metallic Li reference energy G(Li*metal), compute the
      average intercalation voltage V = -[G(Li*{x₂}HostM) - G(Li\_{x₁}HostM) -
      (x₂ - x₁)G(Li_metal)] / [(x₂ - x₁)F] where F is the Faraday constant — the
      fundamental equation for predicting battery voltage from first principles
- [x] **126.2.1.2** Implement voltage profile from convex hull: given DFT total
      energies at multiple lithiation levels {x*i, E(Li*{x_i}Host)}, construct
      the convex hull of formation energies vs. composition, identify ground-
      state tie lines, and compute the step-wise voltage profile V(x) — each
      horizontal segment corresponds to a two-phase region between adjacent
      ground states
- [x] **126.2.1.3** Implement voltage profile smoothing for solid-solution
      behavior: when the host exhibits single-phase (solid-solution) behavior
      rather than two-phase reactions, compute the differential voltage dV/dx =
      -dμ_Li/dx from the chemical potential curve, producing a sloping voltage
      profile rather than discrete steps
- [x] **126.2.1.4** Implement multi-ion voltage prediction: extend the
      intercalation voltage framework to Na⁺, K⁺, Mg²⁺, Ca²⁺, and Zn²⁺ ions —
      adjusting the reference energy (Na metal, K metal, Mg metal, Ca metal, Zn
      metal), accounting for the charge state (z = 2 for divalent ions: V = -ΔG
      / [zFΔx]), and handling the different site preferences of larger ions

#### 126.2.2 Capacity and Energy Density

- [x] **126.2.2.1** Implement theoretical capacity computation: C_theor = nF /
      (3.6 × M_w) in mAh/g, where n is the number of ions exchanged per formula
      unit, F is the Faraday constant, and M_w is the molecular weight of the
      fully lithiated (or delithiated) phase — compute for both gravimetric
      (mAh/g) and volumetric (mAh/cm³) using the DFT-relaxed volume
- [x] **126.2.2.2** Implement energy density computation: integrate the voltage
      profile V(x) over capacity to obtain gravimetric energy density (Wh/kg)
      and volumetric energy density (Wh/L) — the key figures of merit for
      practical battery comparison
- [x] **126.2.2.3** Implement irreversible capacity loss estimation: compute
      first-cycle capacity loss from the energy difference between the charged
      and discharged states when structural changes (phase transitions, cation
      ordering, oxygen loss) prevent full reversibility

#### 126.2.3 Ion Migration and Conductivity

- [x] **126.2.3.1** Implement ion migration barrier workflow: given a host
      structure and an ion species, enumerate symmetry-distinct migration paths
      between adjacent ion sites, set up NEB (nudged elastic band) calculations
      (integrating Phase 122 NEB infrastructure), and extract the activation
      barrier E_a for each path — the rate-limiting step for ion transport
- [x] **126.2.3.2** Implement ionic conductivity estimation from migration
      barriers: σ = σ₀ exp(-E_a / k_B T) with pre-exponential factor σ₀
      estimated from attempt frequency (phonon frequency at saddle point), hop
      distance, carrier concentration, and correlation factor — producing
      conductivity vs. temperature Arrhenius plots
- [x] **126.2.3.3** Implement percolation analysis for ion transport: given a
      lattice of ion sites with site energies and migration barriers, determine
      the percolation threshold for long-range ion transport — critical for
      disordered rocksalt cathodes where only a fraction of sites participate in
      diffusion networks
- [x] **126.2.3.4** Implement AIMD-based diffusion coefficient extraction: from
      ab initio molecular dynamics trajectories (Phase 120 integration), compute
      the mean-square displacement MSD(t) for the mobile ion species, extract
      the diffusion coefficient D from the Einstein relation MSD = 6Dt (3D) or
      MSD = 4Dt (2D), and convert to ionic conductivity via the Nernst-Einstein
      relation σ = nq²D / k_B T

#### 126.2.4 Electrode Stability and Interfaces

- [x] **126.2.4.1** Implement electrochemical stability window computation:
      using the grand potential phase diagram approach (Phase 125), determine
      the voltage range over which the electrode or electrolyte material is
      thermodynamically stable against decomposition — the window is defined by
      the first oxidation and first reduction decomposition reactions
- [x] **126.2.4.2** Implement interface stability analysis: given an
      electrode/electrolyte pair, compute the mutual reaction energy by
      constructing a pseudo-binary phase diagram and finding the decomposition
      products with the lowest energy — a negative reaction energy indicates
      thermodynamic instability and interphase formation
- [x] **126.2.4.3** Implement solid electrolyte interphase (SEI) prediction:
      identify likely decomposition products at the electrode/electrolyte
      interface from Phase 125 thermodynamic data, classify them as
      electronically insulating (passivating) or conducting (non-passivating),
      and estimate the interphase impedance contribution
- [x] **126.2.4.4** Implement space charge layer model for solid-state battery
      interfaces: compute the Mott-Schottky space charge profile at a solid
      electrolyte/electrode interface from the difference in electrochemical
      potentials, solving the Poisson-Boltzmann equation self-consistently to
      obtain the depletion width and resistance contribution

#### 126.2.5 Cathode Material Workflows

- [x] **126.2.5.1** Implement layered oxide cathode workflow (NMC/NCA): given
      composition Li(Ni_xMn_yCo_z)O₂, generate the ordered or SQS supercell,
      compute voltage profile, identify phase transitions (H1→M→H2→H3 for
      high-Ni), detect O2 release onset, evaluate Ni/Li anti-site mixing energy,
      and compute cation ordering energy landscape
- [x] **126.2.5.2** Implement spinel cathode workflow (LiMn₂O₄ / LMO): compute
      the two voltage plateaus (~4V and ~3V), quantify the Jahn-Teller
      distortion of Mn³⁺ (tetragonal elongation ratio c/a), evaluate Mn
      dissolution energy into electrolyte, and assess structural stability upon
      deep discharge
- [x] **126.2.5.3** Implement olivine cathode workflow (LiFePO₄ / LFP): compute
      the flat voltage plateau from the two-phase reaction, evaluate 1D Li
      migration along the [010] channel with the curved path barrier, assess
      anti-site defect (Fe on Li site) blocking probability, and compute surface
      energies for particle shape prediction
- [x] **126.2.5.4** Implement disordered rocksalt cathode workflow: generate SQS
      for Li-excess compositions (e.g., Li₁.₂Mn₀.₄Ti₀.₄O₂), perform percolation
      analysis (0-TM channel network with threshold x_Li > 1.09 for FCC),
      compute short-range order parameters, evaluate fluorination effects
      (oxyfluoride), and assess cation migration upon cycling

#### 126.2.6 Anode Material Workflows

- [x] **126.2.6.1** Implement graphite intercalation workflow: compute stage-n
      intercalation energies (stage 1: LiC₆, stage 2: LiC₁₂, etc.), voltage
      profile showing staging transitions, in-plane Li ordering, and volume
      expansion per stage
- [x] **126.2.6.2** Implement silicon lithiation workflow: compute the voltage
      profile for crystalline Si → amorphous Li_xSi (x = 0 to 3.75), evaluate
      the ~300% volume expansion, identify the Li₁₅Si₄ crystalline phase formed
      at full lithiation, and compute the fracture energy for mechanical
      degradation assessment
- [x] **126.2.6.3** Implement conversion anode workflow: for MO + 2Li → M + Li₂O
      type reactions (M = Fe, Co, Ni, Cu, Mn), compute the conversion voltage,
      theoretical capacity, and voltage hysteresis from the difference between
      forward and reverse reaction energies

#### 126.2.7 Solid Electrolyte Screening

- [x] **126.2.7.1** Implement garnet electrolyte workflow (Li₇La₃Zr₂O₁₂ / LLZO):
      compute Li-ion migration barriers in the garnet framework (tetrahedral →
      octahedral → tetrahedral pathway), evaluate Al/Ta/Nb dopant site
      preferences and their effect on Li-ion conductivity, and assess stability
      against Li metal (reduction stability)
- [x] **126.2.7.2** Implement sulfide electrolyte workflow (Li₁₀GeP₂S₁₂ / LGPS):
      compute the 1D Li-ion channel migration barrier, evaluate substitution
      effects (Si, Sn for Ge), assess electrochemical window (narrow:
      ~1.7-2.1V), and compute interface decomposition products with oxide
      cathodes
- [x] **126.2.7.3** Implement NASICON electrolyte workflow: compute Na-ion
      migration barriers in the NASICON framework (Na₁+xZr₂Si*xP*{3-x}O₁₂),
      evaluate the bottleneck size for ion transport, and screen compositions
      for optimal conductivity
- [x] **126.2.7.4** Implement halide electrolyte workflow: compute Li-ion
      migration in Li₃MCl₆ (M = Y, In, Sc) structures, evaluate the effect of
      cation disorder on conductivity, assess oxidation stability (higher than
      sulfides), and screen M-site substitutions
- [x] **126.2.7.5** Implement solid electrolyte screening pipeline: given a
      candidate structure, automatically compute (1) ionic conductivity from
      AIMD, (2) electronic band gap (must be > 5 eV for insulator), (3)
      electrochemical stability window, (4) mechanical modulus (for dendrite
      suppression: G > 2× Li metal), (5) interface stability with target
      electrode — rank candidates by composite score

#### 126.2.8 Advanced Battery Phenomena

- [x] **126.2.8.1** Implement Jahn-Teller distortion analysis: given a structure
      containing Jahn-Teller active ions (Mn³⁺ d⁴, Cu²⁺ d⁹), compute the
      tetragonal distortion magnitude (c/a ratio), the JT stabilization energy,
      and the cooperative JT ordering pattern — critical for understanding
      capacity fade in Mn-based cathodes
- [x] **126.2.8.2** Implement anionic redox analysis: compute the oxygen
      oxidation state and O 2p band center as a function of delithiation,
      identify the onset of oxygen redox (O²⁻ → O⁻), evaluate oxygen
      dimerization (peroxide formation) and O₂ gas release energetics, and
      correlate with voltage hysteresis
- [x] **126.2.8.3** Implement transition metal dissolution analysis: compute the
      dissolution energy of Mn²⁺ (from disproportionation 2Mn³⁺ → Mn²⁺ + Mn⁴⁺)
      into electrolyte, evaluate the effect of surface facet, and estimate
      dissolution rate from the dissolution free energy
- [x] **126.2.8.4** Implement transition metal migration analysis: compute the
      energy barriers for transition metal migration from octahedral sites in
      the TM layer to tetrahedral/octahedral sites in the Li layer — the
      mechanism for impedance rise and voltage fade in layered cathodes
- [x] **126.2.8.5** Implement aqueous battery screening: evaluate candidate
      electrodes for aqueous batteries by checking (1) voltage within water
      stability window (adjusted for pH and overpotential), (2) dissolution
      stability from Pourbaix diagram (Phase 125), (3) proton co-intercalation
      energetics

---

### 126.3 Photovoltaic Materials (`@kalika/photovoltaic-materials`)

#### 126.3.1 Efficiency Limits

- [x] **126.3.1.1** Implement Shockley-Queisser detailed balance limit: given a
      band gap E_g, compute the maximum theoretical efficiency by balancing
      absorbed photon flux (AM1.5G spectrum above E_g) against radiative
      recombination current (blackbody emission at 300K above E_g) — solving
      J_sc - J_0[exp(qV/k_BT) - 1] = 0 for maximum power point V_mpp, I_mpp
- [x] **126.3.1.2** Implement spectroscopic limited maximum efficiency (SLME) —
      Yu-Zunger metric: given the absorption coefficient α(E) from DFT, GW/BSE,
      and optical workflows (Phases 116/118/123), compute the absorptivity a(E)
      = 1 - exp(-2αL) for film thickness L, then modify the SQ calculation to
      use the actual absorption onset (not step function), account for the
      fraction of non-radiative recombination via f_r = exp(-(E_g^da -
      E_g)/k_BT) where E_g^da is the direct-allowed gap — producing a more
      realistic efficiency bound
- [x] **126.3.1.3** Implement multi-junction efficiency limit: for tandem cells
      with N junctions, compute the optimal band gap combination by partitioning
      the solar spectrum and maximizing total power output under
      current-matching constraint (series connection) or independent operation
      (4-terminal) — tabulate optimal gaps for 2J, 3J, 4J configurations
- [x] **126.3.1.4** Implement temperature-dependent efficiency: extend the SQ
      calculation to arbitrary cell temperature T_cell, accounting for band gap
      narrowing with temperature (Varshni relation), increased thermal
      radiation, and reduced V_oc — compute temperature coefficient dη/dT

#### 126.3.2 Absorption and Band Structure

- [x] **126.3.2.1** Implement absorption coefficient computation workflow: chain
      DFT band structure (Phase 116) → optical matrix elements (momentum
      operator) → joint density of states → α(E) = (4π²e²)/(m²cωε₀) ×
      |⟨ψ_c|p|ψ_v⟩|² × JDOS(E) — with scissor correction to match experimental
      or GW gap
- [x] **126.3.2.2** Implement direct vs. indirect gap assessment: from the band
      structure, identify the VBM and CBM k-points, classify as direct (same
      k-point) or indirect (different k-points), compute the direct gap at the
      CBM k-point (relevant for optical absorption), and evaluate the phonon-
      assisted indirect absorption strength
- [x] **126.3.2.3** Implement effective mass computation for carrier transport:
      from the band curvature at VBM and CBM, compute electron and hole
      effective masses (parabolic fit to E(k)), identify anisotropy (m*\_x,
      m*\_y, m*\_z), compute the density-of-states effective mass m*\_DOS =
      (m*\_x × m*\_y × m\*\_z)^{1/3} × N_v^{2/3} where N_v is valley degeneracy
- [x] **126.3.2.4** Implement band gap deformation potential: compute the change
      in band gap under hydrostatic strain (a_v = dE_g/d ln V) and biaxial
      strain — relevant for epitaxial thin films and strained absorbers

#### 126.3.3 Defect Tolerance

- [x] **126.3.3.1** Implement defect tolerance metric: using defect formation
      energies from Phase 122, classify intrinsic defects as shallow (transition
      level within k_BT of band edge) or deep (mid-gap) — a material is
      defect-tolerant if all dominant intrinsic defects are shallow (e.g., CdTe:
      V_Cd is shallow acceptor; MAPbI₃: all dominant defects shallow)
- [x] **126.3.3.2** Implement defect-limited V_oc computation: from the
      Shockley-Read-Hall recombination rate (determined by the deepest dominant
      defect level and its capture cross sections), compute the non-radiative
      recombination current and subtract from the radiative V_oc to get the
      defect-limited open-circuit voltage
- [x] **126.3.3.3** Implement defect-limited efficiency: combine defect-limited
      V_oc with absorption-limited J_sc to compute the realistically achievable
      efficiency accounting for the specific defect chemistry of the absorber
      material

#### 126.3.4 Perovskite Halide Screening

- [x] **126.3.4.1** Implement perovskite screening criteria: for ABX₃ candidate,
      compute Goldschmidt tolerance factor t = (r_A + r_X) / [√2(r_B + r_X)]
      (0.8 < t < 1.0 for stable perovskite), octahedral factor μ = r_B / r_X
      (0.44 < μ < 0.90), and decomposition enthalpy ΔH_d (ABX₃ → AX + BX₂, must
      be negative for stability)
- [x] **126.3.4.2** Implement perovskite band gap tuning: for mixed compositions
      (Cs_xMA_yFA_z)(Pb_aSn_b)(I_pBr_qCl_r)₃, predict the band gap from
      composition using (1) VCA (virtual crystal approximation) for initial
      estimate, (2) SQS supercells for explicit alloy calculations, and (3)
      bowing parameter fitting E_g(x) = xE_g^A + (1-x)E_g^B - bx(1-x)
- [x] **126.3.4.3** Implement mixed-halide instability analysis: compute the
      mixing enthalpy ΔH_mix for I/Br and Br/Cl mixing in perovskites, construct
      the temperature-composition phase diagram (miscibility gap), and estimate
      the threshold illumination intensity for light-induced phase segregation
      (Hoke effect) from the polaron-stabilization energy
- [x] **126.3.4.4** Implement perovskite stability workflow: evaluate (1)
      thermodynamic decomposition to precursors, (2) moisture stability
      (hydration energy), (3) oxygen stability (superoxide formation), (4)
      thermal stability (entropy-driven decomposition temperature), and (5) ion
      migration barriers (vacancy-mediated halide and cation migration)

#### 126.3.5 Other PV Systems

- [x] **126.3.5.1** Implement organic photovoltaic level alignment: given donor
      and acceptor molecules, compute HOMO/LUMO levels (from DFT with functional
      tuning or GW), evaluate the LUMO_D - LUMO_A offset (must exceed exciton
      binding energy for charge separation), compute the maximum V_oc =
      (HOMO_D - LUMO_A)/e - 0.3V (empirical loss), and estimate the
      charge-transfer state energy
- [x] **126.3.5.2** Implement CIGS/CdTe absorber screening: for Cu(In,Ga)Se₂
      alloys, compute band gap vs. Ga/(In+Ga) ratio (tunable 1.0-1.7 eV),
      evaluate Cu vacancy and Se vacancy formation energies, and compute the
      valence band offset at the CdS/CIGS interface
- [x] **126.3.5.3** Implement transparent conducting oxide (TCO) screening: for
      candidate oxides, check (1) band gap > 3.0 eV (visible transparency), (2)
      electron effective mass < 0.5 m_e (high mobility), (3) dopability (shallow
      donor defects with low formation energy), (4) work function alignment with
      absorber — screen for ITO, FTO, AZO alternatives

---

### 126.4 Thermoelectric Materials (`@kalika/thermoelectric-materials`)

#### 126.4.1 ZT Prediction Workflow

- [x] **126.4.1.1** Implement end-to-end ZT prediction pipeline: given a crystal
      structure, chain (1) DFT band structure (Phase 116) → (2) Boltzmann
      transport for S, σ, κ_e vs. carrier concentration and temperature
      (Phase 123) → (3) phonon dispersion and lattice thermal conductivity κ_L
      (Phase 119) → (4) ZT = S²σT / (κ_e + κ_L) at each temperature and doping
      level — producing ZT(T, n) maps
- [x] **126.4.1.2** Implement optimal doping level determination: from the ZT(T,
      n) map, find the carrier concentration n_opt(T) that maximizes ZT at each
      temperature, compute the corresponding Fermi level position, and identify
      real dopant atoms (from defect calculations, Phase 122) that can achieve
      n_opt
- [x] **126.4.1.3** Implement power factor optimization: compute S²σ as a
      function of Fermi level, identify the peak power factor, and decompose
      contributions from each band (valley) — enabling band engineering strategy
      assessment
- [x] **126.4.1.4** Implement weighted mobility metric: μ_w =
      μ₀(m\*\_DOS/m_e)^{3/2} (N_v/1)^{} where μ₀ is the intrinsic mobility and
      N_v the valley degeneracy — a single descriptor for electronic
      thermoelectric quality that separates electronic from thermal
      contributions

#### 126.4.2 Band Engineering Strategies

- [x] **126.4.2.1** Implement band convergence analysis: from the band
      structure, identify nearly degenerate conduction or valence band extrema
      (within 2k_BT), compute their energy offsets, and evaluate the effect of
      strain, alloying, or temperature on bringing multiple valleys to the same
      energy — increasing N_v and thus m\*\_DOS without degrading μ
- [x] **126.4.2.2** Implement resonant level detection: search for impurity-
      induced peaks in the density of states near the Fermi level (Tl in PbTe
      paradigm) by computing the DOS with and without the impurity, identify the
      resonance energy and width, and evaluate the enhancement of the Seebeck
      coefficient from the distorted DOS
- [x] **126.4.2.3** Implement band gap tuning assessment: compute the
      sensitivity of the band gap to alloying composition (e.g.,
      PbTe\_{1-x}Se_x), identify the optimal gap for thermoelectric performance
      (E_g ≈ 6-10 k_BT at the operating temperature to suppress bipolar
      transport), and screen alloy compositions

#### 126.4.3 Phonon Engineering Strategies

- [x] **126.4.3.1** Implement rattler mode identification: from the phonon
      dispersion and atom-projected phonon DOS, identify low-frequency,
      localized modes associated with loosely bound atoms in cages
      (skutterudites, clathrates, filled CoSb₃) — quantify the rattler
      frequency, Einstein temperature, and effect on κ_L through resonant phonon
      scattering
- [x] **126.4.3.2** Implement anharmonicity quantification: compute the mode
      Gruneisen parameters γ_i = -V/(ω_i) × (dω_i/dV) from phonon calculations
      at multiple volumes, evaluate the overall Gruneisen parameter γ = Σ γ_i
      C_i / Σ C_i, and correlate with low κ_L — materials with large γ (> 2)
      like SnSe are intrinsically anharmonic
- [x] **126.4.3.3** Implement nanostructuring effect estimation: using a
      modified Callaway model, compute the reduction in κ_L from grain boundary
      scattering (Casimir limit at grain size d), nanoprecipitate scattering
      (Rayleigh regime for precipitate radius r << λ_phonon), and interface
      scattering in superlattices — estimate the achievable κ_L reduction factor
      for a given nanostructure length scale
- [x] **126.4.3.4** Implement point defect phonon scattering: compute the mass
      variance parameter Γ_M = Σ f_i(1 - M_i/M_avg)² and strain field parameter
      Γ_S for alloys and doped materials, evaluate the κ_L reduction from
      Klemens point defect scattering model, and optimize the alloy composition
      for minimum κ_L

#### 126.4.4 Materials Class Workflows

- [x] **126.4.4.1** Implement Bi₂Te₃ family workflow: compute thermoelectric
      properties for Bi₂Te₃, Bi₂Se₃, Sb₂Te₃, and their alloys (Bi*{2-x}Sb_x Te₃
      for p-type, Bi₂Te*{3-x}Se_x for n-type), including the anisotropic
      transport (in-plane vs. cross-plane), topological surface state
      contribution, and quintuple-layer stacking optimization
- [x] **126.4.4.2** Implement PbTe family workflow: compute properties for PbTe,
      PbSe, PbS, and alloys, evaluate the L-valley vs. Σ-valley convergence
      temperature, Tl/Na resonant level effects, and nanostructuring strategies
      (SrTe nanoprecipitates in PbTe)
- [x] **126.4.4.3** Implement half-Heusler workflow: for XYZ compounds (e.g.,
      NbFeSb, ZrNiSn, TiCoSb), compute the 18-electron stability, band structure
      with heavy-band/light-band features, alloy optimization (e.g.,
      Ti\_{1-x}Zr_xNiSn), and grain boundary resistance
- [x] **126.4.4.4** Implement skutterudite workflow: for CoSb₃-type structures,
      compute unfilled and filled (La, Ce, Yb, Ba fillers) phonon dispersions,
      rattler mode frequencies, filling fraction limits from charge
      compensation, and resulting ZT enhancement
- [x] **126.4.4.5** Implement SnSe workflow: compute the extraordinary
      anharmonicity (Gruneisen parameter > 3), the Pnma-to-Cmcm phase transition
      at ~800K, the dramatic ZT enhancement along the b-axis, and
      polycrystalline vs. single-crystal performance

#### 126.4.5 High-Throughput Screening

- [x] **126.4.5.1** Implement high-throughput thermoelectric screening pipeline:
      given a database of structures, apply sequential filters: (1) band gap in
      optimal range (0.1-1.0 eV), (2) low effective mass (< 2 m_e), (3) multiple
      valley degeneracy (N_v > 2), (4) estimated low κ_L (heavy atoms, complex
      unit cell, large anharmonicity), (5) earth-abundant elements — rank
      candidates by estimated ZT

---

### 126.5 Catalysis Workflows (`@kalika/catalysis`)

#### 126.5.1 Heterogeneous Catalysis Fundamentals

- [x] **126.5.1.1** Implement adsorption energy calculation workflow: given a
      surface slab (Phase 122) and an adsorbate molecule, generate initial
      adsorption geometries (atop, bridge, hollow, subsurface sites), relax each
      with DFT, compute adsorption energy E_ads = E(slab+ads) - E(slab) -
      E(ads_gas), and identify the most stable site — with zero- point energy
      and entropic corrections from vibrational analysis
- [x] **126.5.1.2** Implement reaction energy diagram construction: given a
      multi-step reaction mechanism (list of intermediates and transition
      states), compute the free energy of each state G_i = E_DFT + ZPE +
      ΔH(0→T) - TΔS, plot the free energy diagram, identify the potential-
      determining step (PDS) and rate-determining step (RDS), and compute the
      thermodynamic overpotential η = max(ΔG_i)/e - E_eq
- [x] **126.5.1.3** Implement volcano plot construction: given adsorption
      energies for a set of catalyst surfaces (varying metal or alloy
      composition), plot the activity metric (e.g., -η or log(TOF)) vs. a
      descriptor (e.g., ΔG_O or ΔG_OH), fit the Sabatier volcano shape (two
      linear branches: too-weak and too-strong binding), and identify the
      optimal descriptor value and the closest real materials
- [x] **126.5.1.4** Implement scaling relations validation: for a set of
      adsorbates on multiple surfaces, fit linear scaling relations ΔE_A = α ×
      ΔE_B + β (e.g., ΔE_OOH = 0.84 × ΔE_OH + 3.29 eV for OER), compute R² and
      mean absolute error, identify outliers that break scaling (potential
      catalytic design targets), and use scaling relations to reduce the
      descriptor space
- [x] **126.5.1.5** Implement microkinetic model from DFT barriers: given DFT-
      computed adsorption energies and activation barriers for all elementary
      steps, set up the coupled rate equations (Langmuir-Hinshelwood or
      Eley-Rideal), solve for steady-state surface coverages θ_i, compute the
      turnover frequency TOF = k_RDS × θ_RDS × (1 - θ_products / K_eq), and
      evaluate the apparent activation energy and reaction orders

#### 126.5.2 Electrocatalysis

- [x] **126.5.2.1** Implement computational hydrogen electrode (CHE) method:
      convert DFT energies to electrochemical free energies by referencing the
      proton/electron pair (H⁺ + e⁻) to ½H₂(g) at standard conditions, with the
      electrode potential U shifting each electron transfer step by -eU — the
      standard method for electrocatalysis from DFT
- [x] **126.5.2.2** Implement oxygen evolution reaction (OER) workflow: compute
      the four-step mechanism OH⁻ → OH* → O* → OOH\* → O₂ with free energy
      corrections (ZPE + entropy from Phase 119 vibrations), determine the
      overpotential η_OER = max(ΔG₁, ΔG₂, ΔG₃, ΔG₄)/e - 1.23V, evaluate the OER
      activity for transition metal oxides using the ΔG_O - ΔG_OH descriptor,
      and identify the potential-determining step
- [x] **126.5.2.3** Implement oxygen reduction reaction (ORR) workflow: compute
      the associative pathway (O₂ → OOH* → O* → OH* → H₂O) and dissociative
      pathway (O₂ → 2O* → 2OH\* → 2H₂O), determine the preferred mechanism from
      the O₂ dissociation barrier, compute η_ORR, and screen Pt-alloy and
      non-precious metal catalysts (N-doped carbon, Fe-N-C) using ΔG_OH as
      descriptor
- [x] **126.5.2.4** Implement hydrogen evolution reaction (HER) workflow:
      compute ΔG_H* (hydrogen adsorption free energy including ZPE and entropy)
      on various surfaces, plot the volcano with exchange current density vs.
      ΔG_H* (optimal at ΔG_H\* ≈ 0), screen MoS₂ edge sites, transition metal
      phosphides, and single-atom catalysts
- [x] **126.5.2.5** Implement CO₂ reduction reaction (CO₂RR) workflow: compute
      free energies for multiple product pathways — (1) CO pathway: CO₂ → COOH*
      → CO* → CO(g), (2) formate pathway: CO₂ → HCOO*, (3) further reduction:
      CO* → CHO* → CH₂O* → CH₃O* → CH₃OH or CH₄, (4) C-C coupling: 2CO* → OCCO\*
      → C₂ products — evaluate selectivity from relative barriers of competing
      pathways
- [x] **126.5.2.6** Implement nitrogen reduction reaction (N₂RR) workflow:
      compute the distal mechanism (N₂ → NNH* → NNH₂* → N + NH₃), alternating
      mechanism (N₂ → NNH* → NHNH* → NHNH₂* → NH₂NH₂* → NH₂* + NH₃ → NH₃), and
      enzymatic mechanism, evaluate the competing HER selectivity problem (ΔG_H*
      vs. ΔG_N₂\*), and screen catalysts for N₂RR selectivity over HER
- [x] **126.5.2.7** Implement pH and potential effects: beyond the CHE shift,
      compute pH-dependent free energies using the surface charge model
      (constant potential DFT approximation), account for field effects on
      adsorption energies (Stark tuning slope for CO\*), and model the electric
      double layer effect on barriers
- [x] **126.5.2.8** Implement solvation correction workflow: compute explicit
      solvation effects using ice-like water bilayer models on metal surfaces,
      implicit solvation corrections (VASPsol-type dielectric continuum), and
      the hybrid explicit/implicit approach — apply corrections to all adsorbate
      free energies (OH* stabilized ~0.5 eV, OOH* stabilized ~0.4 eV by water
      hydrogen bonds)

#### 126.5.3 Photocatalysis

- [x] **126.5.3.1** Implement band edge alignment workflow: compute the VBM and
      CBM energies on an absolute scale (relative to vacuum level from slab
      calculation or relative to NHE from empirical alignment), compare with
      water splitting redox potentials (H⁺/H₂ at 0V vs. NHE, O₂/H₂O at 1.23V vs.
      NHE), and check both thermodynamic criteria: CBM above H⁺/H₂ and VBM below
      O₂/H₂O
- [x] **126.5.3.2** Implement pH-dependent band edge diagram: shift band edges
      with pH using the Nernstian relation (59 mV/pH at 298K) for oxide
      photocatalysts with surface hydroxyl groups, plot band edges vs. pH
      alongside redox potentials, and identify the pH range where both water
      splitting half-reactions are thermodynamically favorable
- [x] **126.5.3.3** Implement carrier separation efficiency estimation: from
      effective masses (electron and hole) and dielectric constant, estimate the
      exciton binding energy E_b = 13.6eV × μ\*/ε² (hydrogenic model), compare
      with k_BT to assess spontaneous dissociation, evaluate carrier mobility
      and diffusion length, and estimate the internal quantum efficiency

#### 126.5.4 Advanced Catalysis

- [x] **126.5.4.1** Implement single-atom catalyst (SAC) screening: for M-N₄
      sites in graphene (M = Fe, Co, Ni, Cu, Mn, Cr), compute the formation
      energy (stability against metal clustering), adsorption energies of key
      intermediates, and catalytic activity for ORR/CO₂RR/N₂RR — identify the
      optimal metal center for each reaction
- [x] **126.5.4.2** Implement enzyme-inspired catalyst design: given an
      enzymatic active site geometry (e.g., heme iron in cytochrome c oxidase
      for ORR, FeMo-cofactor for nitrogenase), construct heterogeneous analogs
      (metal-organic frameworks, molecular catalysts on surfaces), compute
      binding energies of key intermediates, and evaluate whether the enzymatic
      selectivity patterns are reproduced

---

### 126.6 Two-Dimensional Materials (`@kalika/two-d-materials`)

#### 126.6.1 2D Material Database and Stability

- [x] **126.6.1.1** Implement 2D material database: curated registry of known
      monolayer materials with structure, space group, band gap, stability
      classification — graphene, h-BN, MoS₂/MoSe₂/WS₂/WSe₂ (TMDs), MXenes (Ti₂C,
      Ti₃C₂, V₂C, etc.), black phosphorus, silicene, germanene, stanene,
      borophene, InSe, GaSe, CrI₃, Fe₃GeTe₂ — with experimental references
- [x] **126.6.1.2** Implement exfoliation energy computation: given a bulk
      layered structure, cleave along the van der Waals gap, compute the
      cleavage energy E_exf = (E_slab - n × E_mono) / (2A) in meV/Å² (or J/m²),
      and classify exfoliability — E_exf < 20 meV/Å² (easily exfoliable, like
      graphite), 20-40 (potentially exfoliable), > 40 (difficult)
- [x] **126.6.1.3** Implement monolayer stability assessment: for a candidate
      monolayer, check (1) dynamical stability from phonon dispersion (no
      imaginary frequencies), (2) thermal stability from AIMD at 300K (no
      reconstruction after 5ps), (3) mechanical stability (positive elastic
      constants C₁₁ > 0, C₁₁C₂₂ - C₁₂² > 0 for 2D)
- [x] **126.6.1.4** Implement 2D-specific DFT settings manager: configure
      calculations with sufficient vacuum (> 15 Å to avoid periodic image
      interaction), dipole correction for polar surfaces, Coulomb truncation for
      charged 2D systems, and k-point sampling appropriate for 2D Brillouin zone
      (dense in-plane, single point out-of-plane)

#### 126.6.2 Van der Waals Heterostructures

- [x] **126.6.2.1** Implement lattice matching algorithm: given two 2D materials
      with lattice parameters (a₁, b₁, γ₁) and (a₂, b₂, γ₂), find commensurate
      supercells that minimize the biaxial strain ε = |a_super₁ - a_super₂| /
      a_avg below a threshold (typically < 2%) — enumerate supercell matrices
      and rank by strain × cell size trade-off
- [x] **126.6.2.2** Implement Moire pattern generation: given two layers with a
      relative twist angle θ, compute the Moire superlattice periodicity L_M = a
      / (2 sin(θ/2)), generate the commensurate supercell (if rational twist
      angle) or the approximant supercell (closest rational), and set up the
      atomic coordinates with correct interlayer registry (AA, AB, BA stacking
      regions)
- [x] **126.6.2.3** Implement twist angle enumeration: for a bilayer system,
      enumerate all commensurate twist angles from the coincidence site lattice
      theory, generate the supercells, and estimate the number of atoms —
      identify computationally tractable angles (< 10000 atoms) and physically
      interesting ones (magic angles, high-symmetry angles)
- [x] **126.6.2.4** Implement interlayer distance optimization: for a
      heterostructure, optimize the interlayer separation using DFT with van der
      Waals functionals (DFT-D3, optB86b-vdW, rVV10), compute the binding energy
      curve E(d), and extract the equilibrium distance d₀ and interlayer binding
      energy
- [x] **126.6.2.5** Implement band alignment in heterostructures: compute the
      band offset (type I, II, or III) between two layers using the vacuum level
      alignment from slab calculations, evaluate charge transfer direction and
      magnitude, and compute the interlayer hybridization gap

#### 126.6.3 Twist Angle Physics

- [x] **126.6.3.1** Implement magic angle estimation for twisted bilayer
      graphene: from the continuum model (Bistritzer-MacDonald), compute the
      Moire band structure as a function of twist angle, identify the magic
      angles where the Fermi velocity vanishes (v\* = v*F[1 - 3(w/(ℏv_F K*θ))²]
      → 0 at θ_magic ≈ 1.1°), and plot bandwidth vs. twist angle
- [x] **126.6.3.2** Implement flat band detection: from the Moire band
      structure, compute the bandwidth W of the low-energy bands, identify flat
      bands (W < 10 meV) where correlation effects dominate (W/U << 1 where U is
      the on-site Hubbard interaction), and map the flat band regions in the
      twist angle parameter space

#### 126.6.4 2D-Specific Properties

- [x] **126.6.4.1** Implement 2D magnetism workflow: for magnetic monolayers
      (CrI₃, Fe₃GeTe₂, MnPS₃, etc.), compute the magnetic ground state (FM vs.
      AFM configurations), exchange coupling constants J from energy mapping
      (E_FM - E_AFM = -zJS²), magnetic anisotropy energy (in-plane vs.
      out-of-plane), and estimate the Curie/Neel temperature from Monte Carlo
      simulation of the 2D Heisenberg/Ising model
- [x] **126.6.4.2** Implement layer-dependent properties: for a given 2D
      material, compute band gap, effective mass, and optical absorption as a
      function of layer number (1L, 2L, 3L, ..., bulk), model the quantum
      confinement effect, and identify the layer number at which bulk behavior
      is recovered
- [x] **126.6.4.3** Implement edge state and nanoribbon workflow: given a 2D
      material and edge termination (zigzag, armchair), construct the nanoribbon
      structure, compute the band structure to identify edge states, evaluate
      edge magnetism (zigzag graphene nanoribbons), and compute the edge energy
      per unit length
- [x] **126.6.4.4** Implement 2D topological insulator screening: compute the Z₂
      topological invariant from DFT band structure with spin-orbit coupling
      (parity method for inversion-symmetric systems, Wilson loop method
      otherwise), identify materials with nontrivial Z₂ = 1, and compute helical
      edge state dispersion from nanoribbon calculations
- [x] **126.6.4.5** Implement valley physics for TMDs: compute the valley-
      dependent Berry curvature Ω(k) at K and K' points, the valley- contrasting
      optical selection rules (σ⁺ at K, σ⁻ at K'), the valley Hall conductivity
      σ_xy^valley = (e²/ℏ) Σ f_n Ω_n, and the spin- valley locking (spin ↑ at K,
      spin ↓ at K' for valence band in MoS₂)

#### 126.6.5 2D Alloys and Functionalization

- [x] **126.6.5.1** Implement 2D alloy generation: for mixed TMDs (e.g.,
      Mo*{1-x}W_xS₂ or MoS*{2(1-x)}Se\_{2x}), generate SQS supercells, compute
      composition-dependent band gap (bowing parameter), and evaluate alloy
      stability (mixing enthalpy, miscibility gap)
- [x] **126.6.5.2** Implement Janus structure generation: create asymmetric 2D
      structures (e.g., MoSSe) with different atoms on top and bottom surfaces,
      compute the intrinsic dipole moment, Rashba spin splitting from broken
      mirror symmetry, and piezoelectric coefficients
- [x] **126.6.5.3** Implement MXene composition screening: for M\_{n+1}X_nT_x
      families (M = Ti, V, Nb, Mo, Cr; X = C, N; T = O, OH, F surface
      terminations), systematically compute electronic structure, work function,
      and surface chemistry — identify compositions optimal for specific
      applications (energy storage, catalysis, electromagnetic shielding)

---

### 126.7 Metal-Organic Frameworks & Porous Materials (`@kalika/porous-materials`)

#### 126.7.1 Structure Representation

- [x] **126.7.1.1** Implement MOF structure representation: decompose a MOF
      crystal structure into its building blocks — inorganic nodes (metal
      clusters: Zn₄O, Zr₆O₄(OH)₄, Cu₂ paddlewheel, etc.), organic linkers (BDC,
      BTC, BPDC, etc. identified by SMILES), and topology (underlying net
      described by RCSR three-letter code: pcu, fcu, sra, etc.) — using
      bond-valence sum analysis to identify node/linker boundaries
- [x] **126.7.1.2** Implement pore analysis suite: compute (1) largest included
      sphere (LIS): largest sphere that fits in the pore, (2) largest free
      sphere (LFS): largest sphere that can diffuse through the framework, (3)
      pore size distribution (PSD) from geometric Voronoi decomposition, (4)
      accessible surface area (probe radius = 1.86 Å for N₂), (5) accessible
      volume fraction, (6) pore dimensionality (0D cage, 1D channel, 2D layer,
      3D interconnected) — algorithms matching Zeo++ methodology
- [x] **126.7.1.3** Implement channel identification and visualization: trace
      connected pore channels through the framework, identify channel direction
      vectors, compute channel diameter profiles, and detect pore windows
      (constrictions connecting cages) with window diameter

#### 126.7.2 Gas Adsorption Simulation

- [x] **126.7.2.1** Implement Grand Canonical Monte Carlo (GCMC) engine: for a
      rigid framework with pre-computed force field parameters, perform GCMC
      sampling (insertion, deletion, translation, rotation moves) at specified
      temperature T and chemical potential μ (converted from pressure P via
      fugacity) — compute ensemble-averaged loading ⟨N⟩ and its uncertainty from
      block averaging. Implement in Rust for performance (millions of MC steps
      required)
- [x] **126.7.2.2** Implement force field assignment for framework-guest
      interactions: Lennard-Jones parameters from UFF (Universal Force Field)
      for framework atoms, TraPPE force field for guest molecules (CO₂, CH₄, N₂,
      H₂, H₂O, C₂H₂, C₂H₄, C₂H₆, C₃H₈, Xe, Kr), with Lorentz- Berthelot
      combining rules, Ewald summation for Coulomb interactions (charges from
      charge equilibration or DFT-derived)
- [x] **126.7.2.3** Implement adsorption isotherm computation: run GCMC at
      multiple pressures (logarithmically spaced from 10⁻⁴ to 100 bar) at fixed
      temperature, collect loading vs. pressure, fit to isotherm models
      (Langmuir, dual-site Langmuir, BET, Toth) for parameterization, and
      convert between excess and absolute adsorption
- [x] **126.7.2.4** Implement Henry's constant computation: from Widom test
      particle insertion (random insertion of ghost molecule, compute
      Boltzmann-weighted average of exp(-ΔE/k_BT)), extract the Henry's constant
      K_H = ⟨exp(-ΔE/k_BT)⟩ / (k_BT × V) in mol/(kg·Pa) — the infinite dilution
      adsorption strength
- [x] **126.7.2.5** Implement isosteric heat of adsorption: compute Q_st from
      GCMC fluctuations Q_st = k_BT - (⟨UN⟩ - ⟨U⟩⟨N⟩) / (⟨N²⟩ - ⟨N⟩²) at each
      pressure point, or from the Clausius-Clapeyron equation applied to
      isotherms at multiple temperatures — the key metric for
      adsorbent-adsorbate interaction strength
- [x] **126.7.2.6** Implement working capacity computation: given adsorption and
      desorption conditions (P_ads, T_ads, P_des, T_des), compute the
      deliverable capacity ΔN = N(P_ads, T_ads) - N(P_des, T_des) — the
      practically relevant quantity for gas storage and separation applications
      (e.g., 65-5.8 bar for ANG methane storage)

#### 126.7.3 Gas Separation

- [x] **126.7.3.1** Implement IAST (Ideal Adsorbed Solution Theory) for mixture
      adsorption: given pure-component isotherms (fitted to analytic models),
      predict mixture adsorption at specified composition and total pressure by
      solving the IAST equations (equal spreading pressure condition π₁*(n₁⁰) =
      π₂*(n₂⁰) = ... = π_mix) — compute component loadings and selectivity S_12
      = (x₁/y₁)/(x₂/y₂)
- [x] **126.7.3.2** Implement CO₂/N₂ separation screening: for carbon capture,
      compute IAST selectivity at flue gas conditions (15% CO₂, 85% N₂ at 1 bar,
      298K), working capacity under vacuum swing (VSA: desorb at 0.1 bar) or
      temperature swing (TSA: desorb at 373K), and regeneration energy — rank
      MOFs by parasitic energy
- [x] **126.7.3.3** Implement gas separation performance metrics: compute the
      adsorbent performance score APS = Δn₁ × S₁₂^{1/2} / (ΔQ_s × t_cycle)
      combining selectivity, working capacity, heat of adsorption (regeneration
      energy proxy), and cycle time — a composite metric for practical
      separation performance

#### 126.7.4 MOF Stability and Design

- [x] **126.7.4.1** Implement water stability screening: compute the hydrolysis
      reaction energy for metal-linker bond cleavage by water (M-O_linker + H₂O
      → M-OH + H-O_linker), classify stability as (1) stable (ΔG > 0), (2)
      kinetically stable (ΔG < 0 but barrier > 1 eV), (3) unstable — screen
      across metal node types (Zr > Al > Cr > Fe > Zn > Cu for carboxylate MOFs)
- [x] **126.7.4.2** Implement linker functionalization screening: for a given
      MOF topology, systematically substitute functional groups on the organic
      linker (-NH₂, -OH, -F, -Cl, -Br, -NO₂, -CH₃, -OCH₃, -CF₃, -SO₃H) and
      compute the effect on (1) pore size, (2) surface area, (3) gas binding
      energy, (4) selectivity — evaluate Hammett-type correlations between
      substituent electronic effects and adsorption properties
- [x] **126.7.4.3** Implement MOF topology-based enumeration: given a target
      topology (e.g., fcu) and a library of compatible nodes and linkers,
      enumerate all possible MOF structures, compute their geometric properties
      (pore size, surface area), and pre-screen for target applications before
      expensive DFT or GCMC calculations

#### 126.7.5 Related Porous Materials

- [x] **126.7.5.1** Implement zeolite framework support: import IZA framework
      types (FAU, MFI, LTA, CHA, BEA, etc.) with standard coordinates, handle
      Si/Al substitutional disorder, compute Bronsted acid site distribution,
      and set up GCMC for gas adsorption in zeolites
- [x] **126.7.5.2** Implement COF (Covalent Organic Framework) support: handle
      2D layered COFs (eclipsed vs. staggered stacking) and 3D COFs, compute
      pore properties, and evaluate stability — COFs use covalent bonds
      (boronate, imine, triazine linkages) rather than metal-ligand coordination
- [x] **126.7.5.3** Implement gas storage application workflows: (1) hydrogen
      storage — compute gravimetric and volumetric capacity at 77K/100bar and
      298K/100bar, evaluate DOE targets (6.5 wt%, 50 g/L), (2) methane storage —
      compute at 298K/65bar adsorption and 5.8bar desorption (ARPA-E target: 315
      cm³(STP)/cm³), (3) CO₂ capture — compute capacity at 0.15bar and
      selectivity over N₂

---

### 126.8 Polymer & Soft Matter Materials (`@kalika/polymer-materials`)

#### 126.8.1 Polymer Structure Generation

- [x] **126.8.1.1** Implement polymer chain representation: define repeat unit
      from SMILES, specify degree of polymerization, tacticity (isotactic,
      syndiotactic, atactic with configurable probability), head-to-tail vs.
      head-to-head regioregularity, and end groups — generate single chains with
      correct stereochemistry using rotational isomeric state (RIS) model for
      backbone torsions
- [x] **126.8.1.2** Implement amorphous polymer cell generation: pack multiple
      polymer chains into a periodic simulation cell using the Theodorou- Suter
      method (modified self-avoiding random walk with intramolecular energy
      bias), achieving target density within 5% — equilibrate with MD using the
      21-step slow-push protocol (compress → relax cycles at ascending
      temperatures then cooling)
- [x] **126.8.1.3** Implement semicrystalline polymer model: generate lamellar
      structures with crystalline regions (chain stems in all-trans
      conformation) separated by amorphous interlamellar regions, specify
      crystallinity fraction, lamellar thickness, and tie chain density —
      relevant for polyethylene, PET, nylon

#### 126.8.2 Thermal Properties

- [x] **126.8.2.1** Implement glass transition temperature T_g from MD: run NPT
      molecular dynamics cooling ramp (e.g., 600K → 100K at 10K/ns), compute
      specific volume V(T), identify T_g from the intersection of linear fits to
      the rubbery (high-T) and glassy (low-T) regimes — validate against
      experimental T_g for standard polymers (PS ~373K, PMMA ~378K, PC ~423K)
- [x] **126.8.2.2** Implement thermal conductivity from MD: use the Green-Kubo
      method (integrate heat flux autocorrelation function) or non-equilibrium
      MD (Muller-Plathe reverse perturbation) to compute thermal conductivity κ
      — amorphous polymers typically κ ≈ 0.1-0.3 W/mK, with size convergence
      checks
- [x] **126.8.2.3** Implement thermal expansion coefficient: from NPT MD at
      multiple temperatures, compute the volumetric thermal expansion
      coefficient α = (1/V)(∂V/∂T)\_P, distinguish between glassy and rubbery
      values (factor of ~3 difference)

#### 126.8.3 Mechanical Properties

- [x] **126.8.3.1** Implement elastic modulus from MD: apply small strain
      deformation (ε < 1%) to the simulation cell, compute the stress response
      from the virial, extract the full elastic stiffness tensor C_ij, and
      derive Young's modulus E, bulk modulus K, shear modulus G, and Poisson's
      ratio ν — compare with fluctuation method (strain fluctuations in NPT
      ensemble)
- [x] **126.8.3.2** Implement stress-strain curve simulation: apply uniaxial
      tensile strain at constant engineering strain rate (10⁷-10⁹ s⁻¹ for MD),
      compute stress vs. strain, identify (1) elastic region (slope = Young's
      modulus), (2) yield point (onset of plastic deformation), (3) strain
      hardening region, (4) failure — extract yield stress, ultimate tensile
      strength, and toughness (integral under curve)
- [x] **126.8.3.3** Implement crazing and cavitation detection: during
      deformation simulations, monitor for void formation (Voronoi volume
      analysis), identify craze fibril formation (elongated voids with
      connecting fibrils), compute the craze stress, and distinguish between
      ductile yielding (shear band) and brittle fracture (craze → crack)

#### 126.8.4 Coarse-Grained Models

- [x] **126.8.4.1** Implement iterative Boltzmann inversion (IBI) for systematic
      coarse-graining: from atomistic MD reference, compute target radial
      distribution functions g_target(r) for CG bead pairs, iteratively refine
      CG potentials U_n+1(r) = U_n(r) + k_BT × ln[g_n(r)/g_target(r)] until
      convergence — producing thermodynamically consistent CG force fields
- [x] **126.8.4.2** Implement force-matching (multiscale coarse-graining): from
      atomistic trajectories, map forces onto CG sites and fit CG pair
      potentials by minimizing χ² = Σ |F_CG - F_mapped|² — producing CG force
      fields that reproduce atomistic forces, not just structure
- [x] **126.8.4.3** Implement Flory-Huggins χ parameter from MD: compute the
      mixing free energy of two polymers from (1) direct MD of mixed vs. pure
      systems, or (2) cohesive energy density approach: χ = V_ref/k_BT × (δ_A -
      δ_B)² where δ is the solubility parameter — predict miscibility (χ <
      χ_critical = 2/N for symmetric blends)

#### 126.8.5 Polymer-Specific Applications

- [x] **126.8.5.1** Implement block copolymer morphology prediction: for AB
      diblock with volume fraction f_A and segregation strength χN, predict the
      equilibrium morphology (spheres, cylinders, gyroid, lamellae) from the
      mean-field phase diagram, compute domain spacing d ~ aN^{2/3}χ^{1/6} in
      the strong segregation limit, and identify order-disorder transition at
      (χN)\_ODT ≈ 10.5
- [x] **126.8.5.2** Implement dielectric constant computation: from MD
      trajectories, compute the static dielectric constant from dipole moment
      fluctuations ε = 1 + (⟨M²⟩ - ⟨M⟩²) / (3ε₀Vk_BT) where M is the total cell
      dipole moment — validate for PE (~2.3), PTFE (~2.1), PET (~3.3), PVDF
      (~8-12)
- [x] **126.8.5.3** Implement polymer electrolyte transport: for PEO-LiTFSI type
      systems, compute Li⁺ transport mechanism from MD (segmental
      motion-assisted hopping vs. vehicular transport), extract Li⁺ diffusion
      coefficient and transference number t⁺ = D⁺/(D⁺ + D⁻), compute ionic
      conductivity, and evaluate the effect of salt concentration and
      temperature
- [x] **126.8.5.4** Implement conjugated polymer electronic structure: for
      pi-conjugated polymers (P3HT, PEDOT, PPV), compute the HOMO-LUMO gap,
      effective conjugation length (gap vs. oligomer length extrapolation),
      reorganization energy for charge transport (Marcus theory: λ =
      E_charged@neutral_geom + E_neutral@charged_geom - 2E_relaxed), and
      hole/electron mobility estimation
- [x] **126.8.5.5** Implement polymer degradation assessment: compute bond
      dissociation energies (BDE) for all backbone bonds, identify the weakest
      bond (determines thermal degradation onset), evaluate oxidative
      degradation from peroxy radical reaction energetics, and hydrolytic
      degradation from ester/amide bond hydrolysis barriers

---

### 126.9 High-Entropy Alloys (`@kalika/high-entropy-alloys`)

#### 126.9.1 Structure Generation

- [x] **126.9.1.1** Implement Special Quasirandom Structure (SQS) generation for
      HEAs: given a target composition (e.g., equimolar CoCrFeMnNi on FCC
      lattice), generate SQS supercells that best reproduce the random alloy
      correlation functions (pair, triplet, quadruplet) — implement the
      stochastic optimization algorithm (Monte Carlo site swapping to minimize Σ
      w_k|Π_k^SQS - Π_k^random|²) in Rust for performance. Support 5+ component
      systems
- [x] **126.9.1.2** Implement lattice distortion quantification: from a relaxed
      SQS supercell, compute the root-mean-square atomic displacement from ideal
      lattice sites RMSD = √(⟨|r_i - r_i^ideal|²⟩), the local lattice strain
      distribution, and element-resolved displacements — quantifying the "severe
      lattice distortion" core effect of HEAs
- [x] **126.9.1.3** Implement short-range order (SRO) analysis: compute the
      Warren-Cowley SRO parameters α_ij = 1 - P_ij/(c_j) for each atomic pair
      (i,j) at each neighbor shell, identify chemical ordering tendencies (α <
      0: attraction, α > 0: repulsion), and compare SQS (α ≈ 0) with
      ordered/clustered configurations

#### 126.9.2 Thermodynamic Properties

- [x] **126.9.2.1** Implement mixing enthalpy computation: from DFT supercell
      calculations, compute ΔH*mix = E(HEA) - Σ x_i E(element_i) per atom, and
      decompose into pairwise contributions using the sub-regular solution model
      ΔH_mix ≈ Σ*{i<j} Ω_ij x_i x_j — validate against Miedema model estimates
- [x] **126.9.2.2** Implement configurational entropy estimation: compute (1)
      ideal configurational entropy S*ideal = -R Σ x_i ln(x_i) (maximum at
      equimolar: R ln(n) for n components), (2) excess entropy from SRO S_excess
      = (k_B/2) Σ*{i,j} z × c_i c_j α_ij ln(1 + α_ij/(c_i c_j)), and (3)
      vibrational entropy contribution from phonon calculations
- [x] **126.9.2.3** Implement phase stability criteria: compute the δ parameter
      (atomic size mismatch) = √(Σ c_i(1 - r_i/r_avg)²), Ω parameter = T_m ×
      ΔS_mix / |ΔH_mix|, and VEC = Σ c_i VEC_i — apply empirical rules: δ < 6.6%
      and Ω > 1.1 for solid solution stability, VEC > 8.0 for FCC, VEC < 6.87
      for BCC
- [x] **126.9.2.4** Implement phase prediction workflow: combine (1) DFT mixing
      enthalpies, (2) CALPHAD phase diagrams (Phase 125), (3) machine-learned
      corrections to predict the stable phases (FCC, BCC, HCP, σ, μ, Laves, B2,
      amorphous) as a function of composition and temperature — validated
      against experimental phase identification

#### 126.9.3 Mechanical Properties

- [x] **126.9.3.1** Implement solid solution strengthening model: compute the
      Varvenne-Leyson-Curtin (VLC) model yield stress for FCC HEAs: τ_y = A × [Σ
      c_i (ΔV_i² + α × Δa_i²)]^{2/3} × {μ, ν, b, w_c}^{1/3} where ΔV_i is the
      misfit volume of element i, requiring DFT-computed atomic volumes in the
      alloy — producing temperature and strain-rate dependent yield stress
- [x] **126.9.3.2** Implement stacking fault energy (SFE) computation for HEAs:
      compute the generalized stacking fault energy (GSFE) surface by rigid
      shearing of SQS supercells along ⟨112⟩{111}, extract the intrinsic SFE
      γ_ISF, unstable SFE γ_USF, and the γ_USF/γ_ISF ratio — critical for
      predicting deformation mechanism (twinning vs. dislocation slip vs.
      transformation)
- [x] **126.9.3.3** Implement hardness estimation: from the yield stress
      (126.9.3.1) and work hardening rate (estimated from SFE: low SFE → high
      work hardening via twinning), compute the Vickers hardness using the Tabor
      relation H_V ≈ 3 × σ_y — compare with experimental nanoindentation data
- [x] **126.9.3.4** Implement elastic property prediction: compute the full
      elastic tensor C_ij for HEA SQS supercells, extract polycrystalline
      averages (Voigt, Reuss, Hill) for bulk modulus K, shear modulus G, Young's
      modulus E, Poisson's ratio ν — evaluate the Cauchy pressure (C₁₂ - C₄₄)
      for ductility assessment and Pugh's ratio (K/G) for brittle-ductile
      classification

#### 126.9.4 Kinetic Properties

- [x] **126.9.4.1** Implement sluggish diffusion assessment: compute vacancy
      formation energies and migration barriers for each element in the HEA
      lattice (using NEB on SQS supercells), evaluate the distribution of
      barriers (broad distribution → sluggish diffusion), and compare effective
      diffusion coefficients with pure metals and conventional alloys
- [x] **126.9.4.2** Implement precipitation and ordering analysis: from cluster
      expansion on the multicomponent lattice, identify ordering tendencies and
      phase separation driving forces, compute the spinodal decomposition
      boundary, and predict precipitate phases (B2, L1₂, σ-phase) and their
      compositions

#### 126.9.5 HEA Class Workflows

- [x] **126.9.5.1** Implement Cantor alloy (CoCrFeMnNi) workflow: generate SQS,
      compute elastic properties, stacking fault energy, yield stress from VLC
      model, magnetic state (paramagnetic from DLM approximation), phase
      stability vs. temperature (Cr-rich σ phase formation below 800°C), and
      corrosion resistance (passivation from Cr content) — the benchmark FCC HEA
- [x] **126.9.5.2** Implement refractory HEA workflow: for TiZrNbMoHf type BCC
      HEAs, compute the BCC stability (VEC ≈ 4.4-5.0), high melting point
      estimate (rule of mixtures + mixing correction), high-temperature strength
      retention, oxidation resistance assessment (Al/Cr addition), and
      density-normalized specific strength
- [x] **126.9.5.3** Implement lightweight HEA screening: screen compositions
      from Al, Ti, V, Cr, Mn, Fe, Co, Ni with density constraint (ρ < 7 g/cm³),
      compute specific strength (σ_y/ρ), phase stability, and mechanical
      properties — targeting aerospace applications

---

### 126.10 Metamaterials & Photonic Crystals (`@kalika/metamaterials`)

#### 126.10.1 Photonic Band Structure

- [x] **126.10.1.1** Implement plane-wave expansion (PWE) method for photonic
      crystals: solve Maxwell's equations in frequency domain for periodic
      dielectric structures, expanding fields in plane waves and solving the
      generalized eigenvalue problem ∇ × (1/ε(r) ∇ × H) = (ω/c)² H — compute
      photonic band structure ω(k) along high-symmetry paths in the Brillouin
      zone. Implement the H-field formulation for Hermitian eigenvalue problem
- [x] **126.10.1.2** Implement photonic band gap identification: from the
      photonic band structure, identify (1) complete photonic band gap (gap for
      all k-points and all polarizations), (2) partial gaps (gap for one
      polarization: TE or TM), (3) directional gaps (gap along specific
      directions) — compute gap-midgap ratio Δω/ω_mid as the figure of merit
- [x] **126.10.1.3** Implement 2D photonic crystal band structure: for in-plane
      propagation in a 2D periodic structure (e.g., triangular lattice of air
      holes in dielectric), decouple TE (E in-plane) and TM (E out-of-plane)
      polarizations, compute both band structures, and identify polarization-
      specific gaps — TM gap for dielectric rods in air, TE gap for air holes in
      dielectric
- [x] **126.10.1.4** Implement 3D photonic crystal support: handle diamond,
      woodpile, inverse opal, and gyroid structures — compute the 3D photonic
      band structure, identify complete 3D band gaps (requires sufficient
      refractive index contrast, typically n > 2.5), and compute the density of
      states

#### 126.10.2 Phononic Band Structure

- [x] **126.10.2.1** Implement elastic wave band structure: solve the elastic
      wave equation ρω²u = ∇·(C:∇u) in periodic composites using the plane- wave
      expansion method, compute phononic band structure for both longitudinal
      and transverse modes, and identify phononic band gaps (frequency ranges
      where no elastic waves propagate)
- [x] **126.10.2.2** Implement acoustic metamaterial band gaps: for locally
      resonant metamaterials (heavy core in soft coating in stiff matrix),
      compute the sub-wavelength band gap from the resonance frequency of the
      internal resonator, evaluate the band gap width and depth, and design the
      resonator parameters for target frequency ranges (typically Hz-kHz for
      acoustic, MHz-GHz for ultrasonic)

#### 126.10.3 Effective Medium Theory

- [x] **126.10.3.1** Implement Maxwell Garnett effective medium: for dilute
      inclusions (volume fraction f < 0.3) of permittivity ε_i in a host matrix
      ε_h, compute the effective permittivity ε_eff using the Maxwell Garnett
      formula: (ε_eff - ε_h)/(ε_eff + 2ε_h) = f(ε_i - ε_h)/(ε_i + 2ε_h) — extend
      to anisotropic inclusions (ellipsoids with depolarization factors) and
      magnetic permeability
- [x] **126.10.3.2** Implement Bruggeman effective medium: for arbitrary volume
      fractions (symmetric treatment of both components), solve the self-
      consistent equation Σ f_i(ε_i - ε_eff)/(ε_i + 2ε_eff) = 0 — handles
      percolation threshold and is valid for larger filling fractions than
      Maxwell Garnett
- [x] **126.10.3.3** Implement frequency-dependent effective properties: combine
      effective medium theory with Drude model (metals) and Lorentz model
      (dielectrics) for constituent materials, compute ε_eff(ω) and μ_eff(ω) as
      functions of frequency, and identify regions of negative ε, negative μ, or
      simultaneously negative ε and μ (left-handed metamaterial)

#### 126.10.4 Metamaterial Design

- [x] **126.10.4.1** Implement negative refractive index verification: for a
      metamaterial design, compute the effective ε(ω) and μ(ω), verify
      simultaneously negative values in a frequency band, compute the effective
      refractive index n = -√(εμ) (choosing the correct branch for negative
      index), and evaluate the figure of merit FOM = |Re(n)|/Im(n) — higher FOM
      means lower losses
- [x] **126.10.4.2** Implement split-ring resonator (SRR) design: compute the
      resonance frequency of SRR from geometry (ring radius, gap width, metal
      width, substrate permittivity), predict the magnetic response μ(ω) near
      resonance, and optimize SRR dimensions for target operating frequency —
      the canonical negative-μ element
- [x] **126.10.4.3** Implement metamaterial unit cell optimization: given a
      target effective property (e.g., n = -1 at specified frequency),
      parameterize the unit cell geometry, and use gradient-free optimization
      (genetic algorithm or Bayesian optimization) to find the geometry that
      best achieves the target — with constraints on fabricability (minimum
      feature size, realizable materials)
- [x] **126.10.4.4** Implement topological photonic crystal design: compute the
      Berry curvature and Chern number of photonic bands (analogous to
      electronic topological insulators), identify topologically nontrivial band
      gaps, and predict the existence of unidirectional edge states (one-way
      waveguides immune to backscattering) — validate by computing edge state
      dispersion in a finite strip geometry
- [x] **126.10.4.5** Implement plasmonic nanostructure simulation: compute the
      optical response of metallic nanoparticles using Mie theory (exact
      solution for spheres: extinction cross-section from size parameter and
      dielectric function), generalized Mie theory for core-shell particles, and
      the discrete dipole approximation (DDA) for arbitrary shapes — identify
      localized surface plasmon resonance (LSPR) wavelength and field
      enhancement

---

### 126.11 Nuclear & Radiation Materials (`@kalika/nuclear-materials`)

#### 126.11.1 Radiation Damage Fundamentals

- [x] **126.11.1.1** Implement threshold displacement energy (TDE) computation:
      run AIMD collision cascades by giving a primary knock-on atom (PKA)
      kinetic energy in a specific crystallographic direction, determine the
      minimum energy required to permanently displace an atom (create a stable
      Frenkel pair) — average over directions to get the effective TDE. Values
      typically 20-90 eV depending on material and sublattice
- [x] **126.11.1.2** Implement Frenkel pair formation energy: compute the
      formation energy of isolated vacancy-interstitial pairs from DFT supercell
      calculations — decompose into vacancy formation energy E_f^V and
      interstitial formation energy E_f^I for each sublattice, compute the
      binding energy to form bound pairs vs. separated defects
- [x] **126.11.1.3** Implement defect cluster stability analysis: compute the
      binding energies of small defect clusters (di-vacancy, tri-vacancy,
      di-interstitial, vacancy-interstitial clusters) — identify stable cluster
      configurations, evaluate the energetics of cluster growth (is adding one
      more defect exothermic?), and determine the critical cluster size for void
      nucleation
- [x] **126.11.1.4** Implement cascade simulation analysis: from AIMD or
      classical MD cascade simulations, count the number of surviving defects
      (Frenkel pairs) as a function of PKA energy, compute the displacement
      efficiency (NRT model: N_d = 0.8 × E_damage / (2 × E_d)), compare with
      actual surviving defects (typically 20-30% of NRT due to in-cascade
      recombination), and classify defect types (isolated, clusters, loops)

#### 126.11.2 Helium and Hydrogen Effects

- [x] **126.11.2.1** Implement helium bubble formation model: compute He
      solution energy in metals (typically > 2 eV, very insoluble), He-vacancy
      binding energy (strong: 1-2 eV per He-V), He clustering energetics (He_n
      V_m cluster stability), and bubble pressure equation of state — model
      bubble nucleation, growth, and the critical He/V ratio for bubble
      stability
- [x] **126.11.2.2** Implement hydrogen embrittlement from DFT: compute H
      solution energies at interstitial sites (octahedral vs. tetrahedral), H
      trapping energies at grain boundaries, dislocations, and vacancies,
      H-enhanced decohesion (HEDE: reduction of grain boundary cohesive energy
      by H segregation), and H-enhanced localized plasticity (HELP: H effect on
      dislocation mobility)
- [x] **126.11.2.3** Implement transmutation product effects: for neutron-
      irradiated materials, compute the production rates of transmutation
      products (e.g., Ni → He + H via (n,α) and (n,p) reactions in stainless
      steel), evaluate their solubility, clustering tendency, and effect on
      mechanical properties — particularly relevant for fusion reactor materials
      at high neutron fluence

#### 126.11.3 Swelling and Microstructure

- [x] **126.11.3.1** Implement void swelling model: from vacancy supersaturation
      (excess vacancies from irradiation minus recombination), compute void
      nucleation rate, growth rate (bias-driven: dislocations preferentially
      absorb interstitials, vacancies accumulate), and saturation — predict
      swelling ΔV/V as a function of dose (dpa), temperature, and alloy
      composition
- [x] **126.11.3.2** Implement radiation-induced segregation (RIS): compute the
      inverse Kirkendall fluxes of alloying elements coupled to irradiation-
      induced point defect fluxes toward sinks (grain boundaries), predict
      enrichment/depletion profiles (Cr depletion at GBs in austenitic steels →
      sensitization to corrosion), and evaluate temperature and dose-rate
      dependence

#### 126.11.4 Nuclear Fuel

- [x] **126.11.4.1** Implement UO₂ point defect workflow: compute formation
      energies of oxygen vacancies (V*O), uranium vacancies (V_U), oxygen
      interstitials (O_i), uranium interstitials (U_i), and Schottky/Frenkel
      defect pairs in UO₂ using DFT+U (U_eff ≈ 4 eV for U 5f electrons) —
      compute defect concentrations as a function of oxygen stoichiometry
      (UO*{2±x})
- [x] **126.11.4.2** Implement fission gas behavior: compute the solution and
      migration energies of Xe and Kr in UO₂ (solution energy ~3-4 eV in
      pre-existing vacancy traps), model fission gas bubble nucleation at grain
      boundaries, compute the re-solution rate from fission fragment impact, and
      predict fission gas release fraction as a function of burnup and
      temperature
- [x] **126.11.4.3** Implement fuel thermal conductivity degradation: from the
      point defect concentrations (126.11.4.1), compute the phonon scattering
      from point defects and fission products, predict the thermal conductivity
      reduction κ(T, burnup) — critical for fuel performance (lower κ → higher
      centerline temperature → positive feedback on gas release)

#### 126.11.5 Cladding Materials

- [x] **126.11.5.1** Implement zircaloy hydride formation workflow: compute the
      hydrogen solution energy in HCP Zr, H diffusion barriers, nucleation
      energy for δ-ZrH₁.₆₆ and γ-ZrH precipitates, hydride orientation
      (circumferential vs. radial — radial is dangerous for cladding integrity),
      and the terminal solid solubility (TSS) vs. temperature
- [x] **126.11.5.2** Implement irradiation growth in Zr alloys: compute the
      anisotropic point defect diffusion in HCP Zr (vacancy migration along ⟨c⟩
      vs. ⟨a⟩), the diffusion anisotropy difference (DAD) model for irradiation
      growth (elongation along ⟨a⟩, contraction along ⟨c⟩), and the effect of
      alloying elements (Sn, Nb, Fe) on growth rate

#### 126.11.6 Plasma-Facing Materials

- [x] **126.11.6.1** Implement tungsten He/H retention model: compute He and H
      solution energies, migration barriers, and trapping energies at vacancies,
      grain boundaries, and dislocations in BCC W — model the buildup of He/H
      inventory under plasma exposure, He bubble formation (fuzz/nanostructure
      at high He fluence), and surface blistering
- [x] **126.11.6.2** Implement tungsten surface erosion: compute the sputtering
      threshold energy for D, T, He bombardment of W surfaces, the sputtering
      yield from binary collision approximation (BCA) or MD, and the surface
      morphology evolution under mixed D-T-He plasma exposure

#### 126.11.7 Structural Materials

- [x] **126.11.7.1** Implement ferritic-martensitic steel defect energetics:
      compute vacancy and self-interstitial formation energies in BCC Fe, the
      effect of alloying elements (Cr, W, V, Ta) on defect energetics,
      solute-defect binding energies (Cr-vacancy binding, important for Cr
      precipitation under irradiation), and dislocation-solute interactions
- [x] **126.11.7.2** Implement dose-dependent property prediction: from DFT
      defect energetics combined with kinetic Monte Carlo (KMC) or rate theory,
      predict the evolution of microstructure (defect cluster size distribution,
      loop density, void density) with irradiation dose (dpa), and convert to
      macroscopic property changes: hardening (ΔH from dispersed barrier
      hardening model), embrittlement (DBTT shift from hardening), and swelling

---

### 126.12 Corrosion & Degradation (`@kalika/corrosion`)

#### 126.12.1 Thermodynamic Corrosion Assessment

- [x] **126.12.1.1** Implement Pourbaix diagram integration: using the Phase 125
      Pourbaix diagram engine, compute the thermodynamically stable phases as a
      function of potential E and pH for a given metal-water system, identify
      the immunity region (metal stable), corrosion region (dissolved ions
      stable), and passivation region (oxide/hydroxide stable) — overlay with
      operating conditions to predict corrosion behavior
- [x] **126.12.1.2** Implement passivation film stability analysis: from DFT,
      compute the formation energy and band gap of passive oxide films (Cr₂O₃ on
      stainless steel, Al₂O₃ on aluminum, TiO₂ on titanium), evaluate their
      thermodynamic stability range from Pourbaix diagram, electronic resistance
      (insulating film blocks electron transfer and thus slows dissolution), and
      mechanical integrity (Pilling-Bedworth ratio: V_oxide / V_metal, should be
      1-2 for protective film)
- [x] **126.12.1.3** Implement galvanic corrosion potential: for a bimetallic
      couple, compute the corrosion potential and corrosion current from mixed
      potential theory (intersection of anodic polarization curve of the active
      metal with cathodic polarization curve of the noble metal), evaluate the
      galvanic series position from DFT-computed dissolution potentials, and
      predict the corrosion rate enhancement factor

#### 126.12.2 Localized Corrosion

- [x] **126.12.2.1** Implement pitting initiation from chloride attack: compute
      the Cl⁻ adsorption energy on passive oxide surfaces, the Cl⁻ substitution
      energy for O²⁻ in the passive film, the resulting local thinning and
      dissolution mechanism, and the critical pitting potential (potential above
      which pits nucleate) — evaluate the effect of alloying elements (Mo, N
      raise pitting resistance in stainless steels: PREN = %Cr + 3.3%Mo + 16%N)
- [x] **126.12.2.2** Implement intergranular corrosion assessment: compute grain
      boundary segregation energies for solute atoms (Cr depletion near carbides
      in sensitized stainless steel), chromium carbide (M₂₃C₆) precipitation
      thermodynamics, the resulting Cr-depleted zone width and depth, and the
      susceptibility to intergranular attack — evaluate stabilization by Ti or
      Nb additions (form TiC/NbC instead of Cr₂₃C₆)

#### 126.12.3 Oxidation and Environmentally Assisted Cracking

- [x] **126.12.3.1** Implement Wagner oxidation theory: compute the parabolic
      oxidation rate constant k_p from defect concentrations and diffusion
      coefficients in the growing oxide scale — k_p = f(D_cation, D_anion,
      D_electron) integrated over the oxide thickness — predict scale thickness
      x = √(k_p × t) as a function of time and temperature, validate against
      experimental oxidation kinetics
- [x] **126.12.3.2** Implement stress corrosion cracking (SCC) susceptibility:
      combine hydrogen embrittlement analysis (126.11.2.2) with stress analysis
      — compute the hydrogen concentration at a crack tip under stress
      (stress-driven diffusion from Oriani equilibrium: C_tip = C_bulk × exp(σ_H
      V_H / 3k_BT)), evaluate the hydrogen-reduced cohesive strength from DFT,
      and determine the threshold stress intensity factor K_ISCC below which SCC
      does not propagate
- [x] **126.12.3.3** Implement oxide scale spallation criterion: compute the
      stored elastic energy in the oxide scale (from thermal expansion mismatch
      strain ε = Δα × ΔT, elastic modulus, and scale thickness), compare with
      the oxide/metal interface adhesion energy (from DFT work of adhesion), and
      predict the critical temperature change or scale thickness for spallation
      — the failure mode of protective oxide scales

---

### 126.13 Cross-Cutting Integration & Testing (`@kalika/functional-materials`)

#### 126.13.1 Multi-Domain Workflows

- [x] **126.13.1.1** Implement battery-corrosion integration: combine battery
      electrode stability analysis (126.2.4) with Pourbaix diagram (126.12.1) to
      assess aqueous battery electrode corrosion — evaluate whether the
      electrode potential during cycling stays within the passivation region or
      enters the corrosion region
- [x] **126.13.1.2** Implement photovoltaic-defect integration: combine SLME
      efficiency computation (126.3.1.2) with defect tolerance assessment
      (126.3.3) into a single screening workflow that ranks absorber candidates
      by realistically achievable efficiency accounting for intrinsic defect
      chemistry
- [x] **126.13.1.3** Implement catalysis-2D integration: combine 2D material
      edge state analysis (126.6.4.3) with catalysis adsorption energy workflows
      (126.5.1.1) to screen 2D material edges for electrocatalytic activity —
      e.g., MoS₂ edge sites for HER
- [x] **126.13.1.4** Implement MOF-catalysis integration: combine MOF pore
      analysis (126.7.1.2) with catalysis reaction energy diagrams (126.5.1.2)
      to evaluate catalytic MOFs — compute adsorption energies at open metal
      sites within MOFs, assess substrate size/shape selectivity from pore
      dimensions, and predict turnover frequency
- [x] **126.13.1.5** Implement HEA-corrosion integration: combine HEA
      composition analysis (126.9.2) with corrosion resistance assessment
      (126.12.1) to screen HEA compositions for corrosion resistance — predict
      passivation behavior from Cr/Al content, evaluate selective dissolution
      from component nobility differences
- [x] **126.13.1.6** Implement nuclear-corrosion integration: combine radiation
      damage defect analysis (126.11.1) with corrosion susceptibility (126.12.2)
      to predict irradiation-assisted stress corrosion cracking (IASCC) — the
      combined effect of radiation-induced segregation (Cr depletion at GBs) and
      irradiation hardening on SCC susceptibility

#### 126.13.2 High-Throughput Screening Infrastructure

- [x] **126.13.2.1** Implement parallel screening pipeline: given a list of
      candidate structures and a domain-specific screening workflow (battery,
      PV, thermoelectric, catalysis, MOF), distribute calculations across
      available compute resources, collect results, apply sequential filters,
      and produce a ranked candidate list with computed properties — support
      checkpointing and restart for long screening campaigns
- [x] **126.13.2.2** Implement screening result database: store computed
      properties from screening workflows in a queryable format (material ID,
      composition, structure hash, computed properties, screening scores,
      workflow provenance), support filtering and ranking by arbitrary property
      combinations, and export to standard formats (CSV, JSON, Materials
      Project-compatible)

#### 126.13.3 Validation and Testing

- [x] **126.13.3.1** Implement battery materials validation suite: test voltage
      prediction against known experimental values — LiCoO₂ (~3.9V), LiFePO₄
      (~3.4V), LiMn₂O₄ (~4.1V), graphite (~0.1V vs. Li) — with tolerance ±0.2V;
      test capacity computation against formula-derived values; test migration
      barrier against literature NEB values
- [x] **126.13.3.2** Implement PV materials validation suite: test SQ limit
      against published values (E_g = 1.34 eV → η = 33.7% at AM1.5G), test SLME
      against Yu-Zunger published results for known absorbers (GaAs, CdTe, CZTS,
      MAPbI₃), test perovskite tolerance factor against known stable/unstable
      compositions
- [x] **126.13.3.3** Implement thermoelectric validation suite: test ZT
      prediction pipeline against known high-ZT materials — Bi₂Te₃ (ZT ≈ 1.0 at
      300K), PbTe (ZT ≈ 2.0 at 800K with nanostructuring), SnSe (ZT ≈ 2.6 at
      923K single crystal) — verify correct temperature dependence trends
- [x] **126.13.3.4** Implement catalysis validation suite: test OER
      overpotential computation against benchmark values — RuO₂ (η ≈ 0.37V),
      IrO₂ (η ≈ 0.56V) — test HER ΔG_H* against known volcano plot data — Pt
      (ΔG_H* ≈ -0.09 eV, near optimal), test scaling relations reproduction
      (OOH* vs. OH* slope ≈ 0.84)
- [x] **126.13.3.5** Implement MOF validation suite: test GCMC against published
      adsorption isotherms for benchmark MOFs — HKUST-1 CO₂ at 298K, MOF-5 H₂ at
      77K, UiO-66 water — test pore analysis against published PSD for known
      frameworks
- [x] **126.13.3.6** Implement polymer validation suite: test T_g prediction
      against experimental values for standard polymers — PS (~373K), PMMA
      (~378K), PC (~423K) — with tolerance ±30K; test elastic modulus against
      experimental ranges; test χ parameter for known miscible/immiscible pairs
- [x] **126.13.3.7** Implement HEA validation suite: test SQS generation
      (correlation functions within 0.01 of random), test mixing enthalpy
      against literature DFT values for Cantor alloy, test VLC yield stress
      against experimental measurements, test phase stability criteria against
      known single-phase vs. multiphase HEAs
- [x] **126.13.3.8** Implement metamaterial validation suite: test photonic band
      structure against MIT Photonic Bands (MPB) reference calculations for
      standard geometries (triangular lattice of rods: TM gap at r/a = 0.2, ε =
      8.9), test Mie theory against analytic solutions for metal spheres, test
      effective medium against exact results in dilute limit
- [x] **126.13.3.9** Implement nuclear materials validation suite: test TDE
      values against recommended ASTM E521 values (Fe: 40 eV, W: 90 eV, Zr: 40
      eV), test Frenkel pair energies against published DFT values, test cascade
      defect counts against NRT model predictions
- [x] **126.13.3.10** Implement corrosion validation suite: test Pourbaix
      diagram boundaries against published Atlas data (Fe-H₂O, Cr-H₂O, Al-H₂O),
      test oxidation rate constants against experimental parabolic kinetics for
      Cr₂O₃-forming alloys, test PREN correlation against experimental pitting
      potential data for stainless steels
