docs(ti): Phase L implementation plans for ti library-ization

[k-yoshimi]

Phase L plans for the ti module (impurity transport). 8 sub-phases (L-0..L-7) modeled on tr Phase L design (PR #3). L-0 includes regression-test infrastructure (no Phase 0 for ti yet). Tests mandatory; existing ti binary preserved; libtiapi.so added as new target. See individual plan files for details.

---

Note

Low Risk
Documentation-only change adding detailed implementation plans; no runtime, build, or test behavior is modified in this PR.

Overview
Adds a new set of TI library-ization plan documents (docs/superpowers/plans/2026-04-18-ti-library-L0..L7*.md) describing the proposed work to build TI regression baselines, split ti/Makefile source groups, add a C ABI (ti_api/ti_state) and parameter registry, build libtiapi.so, introduce a Python tilib wrapper, and integrate 4-layer tests plus documentation/examples.

This PR only introduces plans/documentation; it does not implement any of the described code or test changes.

^{Reviewed by Cursor Bugbot for commit 78ad1e2. Bugbot is set up for automated code reviews on this repo. Configure here.}

[k-yoshimi]

@cursor review

[k-yoshimi]

Pre-merge review (parent agent + code-reviewer agent)

PR を draft 化 します。merge 前に以下の修正が必要です。

Critical (compile-blocking)

• L-2 ti_api.f90 が USE plinit, ONLY: pl_init および USE equnit, ONLY: eq_init を使用するが、両モジュールの存在を verify するステップなし。MODINCLUDE は path（-I../pl/mod -I../eq/mod）のみで、モジュール名が正しい保証なし。Fallback section は equnit 不在時の対処を述べるが plinit には言及なし。
• L-3 ti_param_registry.f90 で USE plcomm, ONLY: ..., PM, ... だが、実際の ticomm.f90:5 は USE plcomm, pm=>pa（rename）。プランは rename を完全に無視。PM が plcomm で本当にその名前で export されているか未検証。フラジャイル。
• L-0 Task 3 Step 1 の grep pattern DEALLOCATE(v) は実コード IF(ALLOCATED(v)) DEALLOCATE(v) (tiexec.f90:43) にマッチしない。verify-step が silent fail し agent worker をミスリード。

Major

• L-1 classification table が tinclass.f90 / ticdbm.f90 を SRCS_CORE 候補に列挙だが、実 Makefile SRCS には両方とも不在。後続 Step 3 verification と矛盾。
• L-0 Task 4: ti_min.in が namelist + R\nQ\n を一緒に stdin 流す invocation pattern を未検証。ti バイナリの実 menu loop 仕様確認なし。Task 6 Step 6 で fail すれば 4-9 全タスク手戻り。
• L-2 ti_run_c で INTEGER, SAVE :: prepped = 0 を使用。ti_finalize_c でリセットしないので、L-6 sweep test が Tilib() を per-cell 作成すると 2 回目以降 ti_prep が呼ばれない。完全に sweep が壊れる。

Minor

• baseline commit hash (PR test(tr): Phase 0 - regression test infrastructure #2 926b25b4, PR docs(tr): Phase L library-ization design spec #3 c559e06e) 未参照
• L-6 run_tests.sh 改修が pseudocode（具体 diff なし）

修正方針

• L-2 で plinit/equnit モジュール存在確認 grep step を Task 3 前に追加
• L-3 で plcomm の rename に対応（USE plcomm, pa=>pm 等）または USE を見直し
• L-0 grep pattern を IF\(ALLOCATED\(v\)\) DEALLOCATE\(v\) に修正
• L-1 classification table から tinclass/ticdbm を除外（または excluded を明示）
• L-2 ti_finalize_c で prepped = 0 にリセット、または SAVE を排除

修正後 gh pr ready で draft 解除して再レビューします。

[k-yoshimi]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 78ad1e2. Configure here.}