Skip to content

feat: 単一所有者のクラス実体を自動回収する - #180

Draft
milkeclair wants to merge 2 commits into
feat/class-runtimefrom
feat/class-gc
Draft

milkeclair wants to merge 2 commits into
feat/class-runtimefrom
feat/class-gc

Conversation

@milkeclair

@milkeclair milkeclair commented Nov 18, 2026 •

Copy link
Copy Markdown
Owner

やったこと

  • z.cls.new Counter counter は宣言済みの書き込み可能な変数を受け取り、実体の唯一の所有者として登録します。

  • z.cls.owner.move from=counter to=saved で所有権を移せます。移動元や通常の代入でコピーした実体IDは借用参照です。

  • 前回の回収から実体の生成が64件に達すると、次の生成前に、所有者が消えた非実行中の実体を回収します。スクリプトと対話シェルで同じタイミングで動きます。

  • メソッドと属性アクセサーは実体IDを接頭辞として登録します。z.cls.new Counter counter で生成した実体は $counter.increment、${counter}.count.get のように呼び出せます。

動作確認 (方法、事前準備、確認したこと、動画などの資料)

方法:

  • z.t を全件実行し、ls で npm test -- --maxWorkers=2 を実行しました。変更したZshファイルの構文と差分も確認しました。
  • 関数内のループで一時実体を600回生成し、保持された実体数と所有権を移した実体の値を照合しました。

事前準備:

  • WSL Ubuntu・Zsh 5.9・Node.js 24.22.3。クラス実行時を追加する親PR #120の 77224c9 をベースに検証しました。

確認したこと:

  • Zsh 1,592件とLSP 673件が成功しました。クラス診断の feat: クラスをhydrationしメンバー呼び出しを解決 #121 と組み合わせたLSPテストも767件成功しました。
  • 未宣言の代入先、借用参照からの移動、移動後にも実体が使えるケース、実行中の解放保留を確認しました。
  • 600回の生成では、対話・非対話モードとも実体の保持数は最大66件で、移動先から値 10 を読み出せました。

エビデンス:

  • WSL内でZshを対話・非対話モードで起動し、返り値と実体数を直接照合しました。撮影対象の端末画面がないため、結果を本文に記載しています。

その他 (レビュワーへの注意点など)

  • 親PRは #120 です。このPRのレビュー対象は単一所有者、自動回収、実体IDによる呼び出しの差分です。実体IDを展開する呼び出しの診断は feat: クラスをhydrationしメンバー呼び出しを解決 #121 で扱います。
  • 回収は生成時に行います。次の生成を待たずに解放したい場合は z.cls.delete を使えます。

Tie each owner to its variable lifetime and sweep expired instances as allocations continue. Require predeclared destinations and support transferring ownership without relying on prompts, loops, or call framing.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant