入口と接続のしくみ

接続の流れ

fuga-api は、起動中の Fuga の窓口へ、次の順で接続します。

1. ~/.kamui-arena/eb/<scope>/current.json から、起動中の Fuga を探す。
2. current.json が指す場所の endpoint.json を読み、接続先と token を得る。
3. 同じパソコンの UNIX ソケットへ、1 行 1 JSON の形で要求を送り、返事を受け取る。

Fuga が起動していないと、status、receipt、submit などは、BACKEND_NOT_FOUND か BACKEND_NOT_RUNNING を返します。goals は保存されたゴールを表示しますが、実行中のタスクの情報は空になります。

token について

endpoint.json には、接続に使う token（秘密の値）が入っています。

token は人に渡さず、貼り付けもしないでください。

fuga-api は、endpoint.json が本人だけに読めるファイルであることを確かめてから使います。

Fuga が正常に終了すると、endpoint.json は消えます。

見つからないときの表示

--arena-root <dir> は Fuga の保存先（既定は ~/.kamui-arena）を、--scope <scope> は接続先を指定します。