Luaエントリ種別

Luaベースエントリの設定：関数、プロセス、ワークフロー、ライブラリ。

エントリ種別

種別	説明
`function.lua`	ステートレス関数、オンデマンド実行
`process.lua`	状態を持つ長時間実行アクター
`workflow.lua`	耐久性のあるワークフロー（Temporal）
`library.lua`	他のエントリにインポートされる共有コード
`module.lua`	モジュール表面（複数メソッドのライブラリ）

各種別には事前コンパイル済みのバイトコード対応版（function.lua.bc、library.lua.bc、process.lua.bc、workflow.lua.bc）があり、wippy pack --bytecode によって生成されます。作成者は .lua エントリを書き、バイトコード種別はパック時に自動生成されます。

共通フィールド

すべてのLuaエントリは以下のフィールドを共有：

フィールド	必須	説明
`name`	yes	名前空間内で一意の名前
`kind`	yes	上記のLua種別の1つ
`source`	yes	Luaファイルパス（`file://path.lua`）
`method`	function/process/workflow	エクスポートする関数（ライブラリでは使用しない）
`modules`	no	`require()`で許可されるモジュール
`imports`	no	ローカルモジュールとしての他のエントリ
`meta`	no	検索可能なメタデータ

function.lua

オンデマンドで呼び出されるステートレス関数。各呼び出しは独立。

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  modules:
    - http
    - json

用途：HTTPハンドラ、データ変換、ユーティリティ。

process.lua

メッセージ間で状態を維持する長時間実行アクター。メッセージパッシングで通信。

- name: worker
  kind: process.lua
  source: file://worker.lua
  method: main
  modules:
    - process
    - sql

用途：バックグラウンドワーカー、サービスデーモン、ステートフルアクター。

スーパーバイズされたサービスとして実行：

- name: worker_service
  kind: process.service
  process: app:worker
  host: app:processes
  lifecycle:
    auto_start: true
    restart:
      max_attempts: 10

workflow.lua

再起動に耐えるdurableワークフロー。状態はTemporalに永続化。

- name: order_processor
  kind: workflow.lua
  source: file://order_workflow.lua
  method: main
  modules:
    - workflow
    - time

用途：マルチステップビジネスプロセス、長時間実行オーケストレーション。

library.lua

他のエントリにインポートできる共有コード。

- name: helpers
  kind: library.lua
  source: file://helpers.lua
  modules:
    - json
    - base64

他のエントリはimportsで参照：

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  imports:
    helpers: app.lib:helpers

Luaコード内で：

local helpers = require("helpers")
helpers.format_date(timestamp)

モジュール

modulesフィールドはrequire()でロードできるモジュールを制御：

modules:
  - http
  - json
  - sql
  - process

channel、print、subscribe、unsubscribe は Lua のグローバルとしてロードされ、modules: に記載する必要はありません。

リストされたモジュールのみ利用可能。これにより：

セキュリティ：システムモジュールへのアクセスを防止
明示的な依存関係：コードが必要とするものが明確
決定論性：ワークフローは決定論的モジュールのみ取得

利用可能なモジュールについてはLuaランタイムを参照。

インポート

他のエントリをローカルモジュールとしてインポート：

imports:
  utils: app.lib:utils       # require("utils")
  auth: app.auth:helpers     # require("auth")

キーはLuaコード内のモジュール名になります。値はエントリID（namespace:name）。

プール設定

関数の実行プールを設定：

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  pool:
    type: adaptive    # デフォルト
    size: 4           # 初期ワーカー数
    max_size: 16      # エラスティックプールの上限

フィールド	プール	説明
`type`	すべて	スケジューラ実装（下表参照）
`size`	static, lazy, adaptive	初期ワーカー数
`workers`	engine v2	ワーカースレッド数
`buffer`	static, adaptive	タスクキュー容量（デフォルト `workers * 64`）
`warm_start`	adaptive	起動時にエントリを事前コンパイル
`max_size`	lazy, adaptive	エラスティック拡張の上限（デフォルト 16）

タイプ	動作
`inline`	呼び出し元のゴルーチンで同期実行。最低レイテンシ、呼び出し間に分離なし。
`lazy`	アイドル時はワーカーなし、オンデマンドで生成、アイドルで破棄。
`static`	チャンネルベースの固定サイズプール。安定負荷で予測可能。
`adaptive`	自動スケーリングプール — 負荷時に拡大、アイドル時に縮小。デフォルト。

メタデータ

ルーティングと発見にmetaを使用：

- name: api_handler
  kind: function.lua
  meta:
    type: handler
    version: "2.0"
    tags: [api, users]
  source: file://api.lua
  method: handle
  modules:
    - http
    - json

メタデータはレジストリで検索可能：

local registry = require("registry")
local handlers = registry.find({type = "handler"})