Skip to content

[sub-issue] Bootstrap Plexus and migrate terminal gateway for parallel run #93

@endo-ly

Description

@endo-ly

Summary

Plexus repository を先に成立させ、既存 Terminal Gateway 相当機能を移植し、フロントエンドから並行接続で検証できる状態まで持っていく。

この issue は repo 分離の前半フェーズであり、EgoGraph 側の既存実装はまだ削除しない。
削除は親 issue #88 の後半フェーズで別 issue として扱う。

Parent: #88

Scope

  • Phase A: Plexus repository 初期化
  • Phase B: 既存 gateway 機能の移植
  • Phase C: frontend から Plexus 接続での動作確認
  • Phase D: docs / config / deploy の分離準備

In

  • Plexus repo 作成
  • docs/CONCEPT.md 作成
  • README / 開発起動手順整備
  • 既存 gateway/ 相当の terminal 機能移植
  • tmux session list / websocket terminal / snapshot / push の再現
  • frontend から Plexus を接続先として利用できる確認
  • 設定 / deploy / docs の Plexus 側整理
  • repo split / 履歴抽出の方針整理

Out

  • Worker orchestration 実装
  • EgoGraph からの旧実装削除
  • frontend の terminal 機能削除

Working Notes

作業場所

  • 参照元: /root/workspace/ego-graph
  • 新規 repo 作業先: /root/workspace/plexus

初期の調査や比較は EgoGraph 側ターミナルから行ってよいが、実際のファイル作成・git 操作・Plexus 側編集は /root/workspace/plexus で完結させる。

repo 作成方針

  • Plexus は新規 repository として作成する
  • ただし単純コピーではなく、履歴付きで seed を持ち込む
  • まっさら新規実装ではなく、既存 terminal/runtime 実装を土台にする

履歴抽出方針

最低限、以下は履歴付きで持っていく前提で検討する。

  • gateway/
  • frontend の terminal 関連実装

frontend 側は terminal / gateway 接続の履歴も価値が高いため、必要ファイル群を履歴付きで抽出する。

候補:

  • git subtree split
  • git filter-repo

詳細な抽出単位は実施前に確定するが、少なくとも「gateway だけ履歴付き」「frontend はコピペ」は避ける。

frontend 対象の考え方

Plexus 側へ持っていく候補には、少なくとも以下の terminal 関連領域を含めて検討する。

  • frontend/shared/src/commonMain/.../features/terminal
  • terminal repository / domain model / platform 実装
  • terminal 設定 UI
  • terminal 接続に必要な shared 部分

ただし chat 側の shell とは責務を分け、Plexus 側で terminal アプリとして成立する単位に整理する。

Task Breakdown

  • Plexus repository を作成する
  • Plexus の最初の文書として docs/CONCEPT.md を作成する
  • Plexus README と開発起動手順を整備する
  • 履歴付き移行の対象範囲を確定する(gateway / frontend terminal 関連)
  • 履歴抽出方式を決める(git subtree split or git filter-repo
  • 既存 gateway の terminal access 機能を Plexus に移植する
  • frontend terminal 関連実装を Plexus 側へ移す
  • tmux session list / websocket terminal / snapshot / push が Plexus 単体で動くようにする
  • frontend から Plexus を接続先として指定し、基本フローを検証する
  • docs / config / deploy 手順を Plexus 前提に整理する
  • 切り戻し手順を最低限メモ化する

Acceptance Criteria

  • Plexus repo が独立して起動できる
  • docs/CONCEPT.md が存在する
  • 既存 gateway 相当の terminal access 機能が Plexus で動く
  • frontend terminal 依存の必要部分が Plexus 側へ整理されている
  • frontend から Plexus に接続して terminal 利用ができる
  • EgoGraph 側の既存 gateway / terminal 実装をまだ削除せずに並行稼働できる

Notes

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions