@geekbeer/minion 3.9.0 → 3.11.0

package/core/api.js

@@ -87,8 +87,8 @@ async function sendHeartbeat(data) {
 }
 
 /**
- * Create a thread (project-scoped or workspace-scoped) on HQ.
- * @param {object} data - { project_id?, scope?, category?, title, content, thread_type?, mentions?, context? }
+ * Create a thread on HQ (workspace-scoped, optionally linked to projects).
+ * @param {object} data - { project_id?, project_ids?, category?, title, content, thread_type?, mentions?, context? }
  * @returns {Promise<{ thread: object }>}
  */
 async function createThread(data) {
@@ -100,11 +100,12 @@ async function createThread(data) {
 
 /**
  * Get open threads accessible to this minion.
- * @param {'project' | 'workspace' | 'all'} [scope='all'] - Filter by scope
+ * @param {string} [projectId] - Optional project ID to filter by
  * @returns {Promise<{ threads: object[] }>}
  */
-async function getOpenThreads(scope = 'all') {
-  return request(`/threads/open?scope=${scope}`)
+async function getOpenThreads(projectId) {
+  const params = projectId ? `?project_id=${projectId}` : ''
+  return request(`/threads/open${params}`)
 }
 
 /**

package/core/lib/thread-watcher.js

@@ -2,7 +2,7 @@
  * Project Thread Watcher
  *
  * Polling daemon that monitors open help/discussion threads in the minion's
- * projects. Uses LLM to decide whether to participate in conversations.
+ * workspace. Uses LLM to decide whether to participate in conversations.
  *
  * Token-saving strategies:
  * 1. Read tracking: only evaluate threads with new messages since last check
@@ -68,7 +68,7 @@ async function getMyProjects() {
  *
  * @param {object} thread
  * @param {object[]} messages - Only new messages to check
- * @param {string} myRole - This minion's role in the project
+ * @param {string} myRole - This minion's role in the relevant project (or 'engineer' default)
  * @returns {boolean}
  */
 function isMentioned(thread, messages, myRole) {
@@ -130,14 +130,20 @@ async function pollOnce() {
  * Process a single thread: check for new activity and evaluate if needed.
  */
 async function processThread(thread, myProjects, now) {
-  // For workspace threads, create a synthetic project context
-  // For project threads, find role via membership
-  let myProject
-  if (thread.scope === 'workspace') {
-    myProject = { id: null, name: 'Workspace', role: 'engineer' }
-  } else {
-    myProject = myProjects.find(p => p.id === thread.project_id)
-    if (!myProject) return // Not a member
+  // Determine role from linked projects (use first matching project)
+  let myRole = 'engineer'
+  let projectContext = null
+  const linkedProjects = thread.linked_projects || []
+
+  if (linkedProjects.length > 0) {
+    for (const lp of linkedProjects) {
+      const myProject = myProjects.find(p => p.id === lp.id)
+      if (myProject) {
+        myRole = myProject.role || 'engineer'
+        projectContext = myProject
+        break
+      }
+    }
   }
 
   const state = readState.get(thread.id) || { lastMessageCount: 0, lastEvalAt: 0 }
@@ -172,7 +178,7 @@ async function processThread(thread, myProjects, now) {
   readState.set(thread.id, { ...state, lastMessageCount: messageCount })
 
   // Check mentions first (no LLM needed to decide relevance)
-  const mentioned = isMentioned(thread, newMessages, myProject.role)
+  const mentioned = isMentioned(thread, newMessages, myRole)
 
   // If not mentioned and cooldown not expired, skip LLM evaluation
   if (!mentioned && now - state.lastEvalAt < EVAL_COOLDOWN_MS) {
@@ -187,14 +193,14 @@ async function processThread(thread, myProjects, now) {
   }
 
   // LLM evaluation
-  await evaluateWithLlm(thread, detail.thread, messages, newMessages, myProject, mentioned)
+  await evaluateWithLlm(thread, detail.thread, messages, newMessages, myRole, projectContext, mentioned)
   readState.set(thread.id, { lastMessageCount: messageCount, lastEvalAt: now })
 }
 
 /**
  * Use LLM to evaluate thread and potentially respond.
  */
-async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMessages, myProject, mentioned) {
+async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMessages, myRole, projectContext, mentioned) {
   // Build conversation context (limit to last 20 messages to control tokens)
   const recentMessages = allMessages.slice(-20)
   const messageHistory = recentMessages
@@ -218,10 +224,21 @@ async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMess
     ctx.attempted_resolution ? `試行済み: ${ctx.attempted_resolution}` : '',
   ].filter(Boolean).join('\n')
 
-  const isWorkspace = threadDetail.scope === 'workspace'
-  const scopeContext = isWorkspace
-    ? `あなたはワークスペースのメンバー（ID: ${config.MINION_ID}）です。\nこれはプロジェクトに属さないワークスペーススレッドです（カテゴリ: ${threadDetail.category || 'general'}）。`
-    : `あなたはプロジェクト「${myProject.name}」のチームメンバー（ロール: ${myProject.role}、ID: ${config.MINION_ID}）です。`
+  // Build scope context from linked projects
+  const linkedProjects = threadDetail.linked_projects || []
+  let scopeContext
+  if (projectContext) {
+    scopeContext = `あなたはプロジェクト「${projectContext.name}」のチームメンバー（ロール: ${myRole}、ID: ${config.MINION_ID}）です。`
+  } else if (linkedProjects.length > 0) {
+    const projectNames = linkedProjects.map(p => p.name).join(', ')
+    scopeContext = `あなたはワークスペースのメンバー（ID: ${config.MINION_ID}）です。\nこのスレッドは以下のプロジェクトに紐づいています: ${projectNames}`
+  } else {
+    scopeContext = `あなたはワークスペースのメンバー（ID: ${config.MINION_ID}）です。\nこれはプロジェクトに紐づかないワークスペーススレッドです（カテゴリ: ${threadDetail.category || 'general'}）。`
+  }
+
+  const roleGuidance = projectContext
+    ? `- 自分のロール（${myRole}）に関連する話題か`
+    : '- ワークスペーススレッドではすべてのミニオンが参加可能。自分が貢献できる場合は積極的に参加する'
 
   const prompt = `${scopeContext}
 以下のスレッドに対して、あなたが返信すべきかどうかを判断し、返信する場合はその内容を生成してください。
@@ -247,7 +264,7 @@ ${messageHistory || '(メッセージなし)'}
 判断基準:
 - 自分が起票したスレッドの場合、他のメンバーの回答を待つべき（追加情報がある場合を除く）
 - メンション対象が特定のロールやミニオンに限定されている場合、自分が対象でなければ静観する
-${isWorkspace ? '- ワークスペーススレッドではすべてのミニオンが参加可能。自分が貢献できる場合は積極的に参加する' : `- 自分のロール（${myProject.role}）に関連する話題か`}
+${roleGuidance}
 - 自分が貢献できる知見や意見があるか
 - 既に十分な回答がある場合は重複を避ける
 - 人間に聞くべき場合は @user メンションを含めて返信する
@@ -289,13 +306,17 @@ ${isWorkspace ? '- ワークスペーススレッドではすべてのミニオ
     if (parsed.todo && parsed.todo.title) {
       try {
         const todoStore = require('../stores/todo-store')
+        // Use first linked project ID if available
+        const linkedProjectId = (threadSummary.linked_projects && threadSummary.linked_projects.length > 0)
+          ? threadSummary.linked_projects[0].id
+          : null
         todoStore.add({
           title: parsed.todo.title,
           priority: parsed.todo.priority || 'normal',
           due_at: parsed.todo.due_at || null,
           source_type: 'thread',
           source_id: threadSummary.id,
-          project_id: threadSummary.project_id || null,
+          project_id: linkedProjectId,
         })
         console.log(`[ThreadWatcher] Created TODO from thread: "${parsed.todo.title}"`)
       } catch (err) {
@@ -309,17 +330,20 @@ ${isWorkspace ? '- ワークスペーススレッドではすべてのミニオ
 
 /**
  * Fallback: memory-only matching when LLM is not available.
+ * Uses linked projects to search for relevant memories.
  */
 async function fallbackMemoryMatch(thread) {
   try {
-    // Workspace threads have no project_id — skip memory matching
-    if (!thread.project_id) return
+    const linkedProjects = thread.linked_projects || []
+    if (linkedProjects.length === 0) return
 
+    // Search memories from the first linked project
+    const projectId = linkedProjects[0].id
     const ctx = thread.context || {}
     const category = ctx.category || ''
     const searchParam = category ? `&category=${category}` : ''
     const memData = await api.request(
-      `/project-memories?project_id=${thread.project_id}${searchParam}`
+      `/project-memories?project_id=${projectId}${searchParam}`
     )
 
     if (!memData.memories || memData.memories.length === 0) return

package/docs/api-reference.md

@@ -287,27 +287,26 @@ GET `/api/daemons/status` response:
 
 ### Threads (スレッド)
 
-プロジェクト内またはワークスペースレベルのコミュニケーションチャネル。ブロッカー共有やチーム議論に使う。
+ワークスペースレベルのコミュニケーションチャネル。ブロッカー共有やチーム議論に使う。
 リクエストは HQ にプロキシされる。
 
-**2つのスコープ:**
-- **Project** (`scope: "project"`): プロジェクトに紐づくスレッド。`project_id` 必須。プロジェクトメンバーが参加。
-- **Workspace** (`scope: "workspace"`): プロジェクトに属さないスレッド。ルーティンのブロッカー、全体連絡等。オーナーの全ミニオンが参加。
+すべてのスレッドはワークスペースに所属し、プロジェクトへの紐づけは多対多（`thread_project_links`）で管理される。
+1つのスレッドを複数プロジェクトにリンクしたり、プロジェクトに紐づけずにワークスペース全体のスレッドとして使うこともできる。
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/threads` | オープンスレッド一覧（プロジェクト+ワークスペース） |
+| GET | `/api/threads` | オープンスレッド一覧 |
 | POST | `/api/threads` | スレッドを起票（初回メッセージを同時作成） |
 | GET | `/api/threads/:id` | スレッド詳細 + メッセージ一覧 |
 | POST | `/api/threads/:id/messages` | スレッドにメッセージを投稿 |
 | POST | `/api/threads/:id/resolve` | スレッドを解決済みにする |
 | POST | `/api/threads/:id/cancel` | スレッドをキャンセル |
-| DELETE | `/api/threads/:id` | スレッドを完全削除（project: PMのみ、workspace: オーナーの全ミニオン） |
+| DELETE | `/api/threads/:id` | スレッドを完全削除 |
 
-POST `/api/threads` body (プロジェクトスレッド — ヘルプ):
+POST `/api/threads` body (プロジェクト紐づきヘルプスレッド):
 ```json
 {
-  "project_id": "uuid",
+  "project_ids": ["uuid"],
   "thread_type": "help",
   "title": "ランサーズの2FA認証コードが必要",
   "content": "ログイン時に2段階認証を要求された。メールで届く6桁コードの入力が必要。",
@@ -322,7 +321,6 @@ POST `/api/threads` body (プロジェクトスレッド — ヘルプ):
 POST `/api/threads` body (ワークスペーススレッド — ルーティンのブロッカー):
 ```json
 {
-  "scope": "workspace",
   "category": "general",
   "thread_type": "help",
   "title": "朝作業ルーティン: APIキーの期限切れ",
@@ -335,10 +333,10 @@ POST `/api/threads` body (ワークスペーススレッド — ルーティン
 }
 ```
 
-POST `/api/threads` body (プロジェクトスレッド — ディスカッション):
+POST `/api/threads` body (プロジェクト紐づきディスカッション):
 ```json
 {
-  "project_id": "uuid",
+  "project_ids": ["uuid"],
   "thread_type": "discussion",
   "title": "デプロイ手順の確認",
   "content": "本番デプロイ前にステージングで確認するフローに変えたい。意見ある？",
@@ -348,19 +346,19 @@ POST `/api/threads` body (プロジェクトスレッド — ディスカッシ
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
-| `scope` | string | No | `project`（デフォルト）or `workspace` |
-| `project_id` | string | scope=project時 Yes | プロジェクト UUID |
-| `category` | string | No | ワークスペーススレッドのカテゴリ: `general`（デフォルト）, `ops`, `standup` |
+| `project_id` | string | No | リンクするプロジェクトUUID（単一、後方互換） |
+| `project_ids` | string[] | No | リンクするプロジェクトUUID（複数対応） |
+| `category` | string | No | カテゴリ: `general`（デフォルト）, `ops`, `standup` |
 | `thread_type` | string | No | `help`（デフォルト）or `discussion` |
 | `title` | string | Yes | スレッドの要約 |
 | `content` | string | Yes | スレッド本文（thread_messagesの最初のメッセージとして保存） |
 | `mentions` | string[] | No | メンション対象。形式: `role:engineer`, `role:pm`, `minion:<minion_id>`, `user` |
 | `context` | object | No | 任意のメタデータ（category, urgency, workflow_execution_id等） |
 
-**scope の使い分け:**
-- ワークフロー実行中（プロジェクトあり）→ `scope: "project"` + `project_id`
-- ルーティン実行中（プロジェクトなし）→ `scope: "workspace"`
-- プロジェクト外の一般的な質問・報告 → `scope: "workspace"` + `category`
+**プロジェクト紐づけの使い分け:**
+- ワークフロー実行中（プロジェクトあり）→ `project_ids: ["uuid"]`
+- ルーティン実行中（プロジェクトなし）→ `project_ids` を省略
+- プロジェクト外の一般的な質問・報告 → `project_ids` を省略 + `category`
 
 **thread_type の違い:**
 - `help`: ブロッカー解決。`resolve` で解決
@@ -447,8 +445,8 @@ POST `/api/project-memories` body:
 **推奨ワークフロー:**
 1. ブロッカー発生 → プロジェクトコンテキストの場合は `GET /api/project-memories?project_id=...&category=auth&search=2fa` で既知の知見を検索
 2. 該当あり → 知見に基づいて自己解決 or 即エスカレーション
-3. 該当なし → `POST /api/threads` でブロッカー起票（プロジェクトなら `scope: "project"` + `project_id`、ルーティンなら `scope: "workspace"`）
-4. 解決後 → プロジェクトスレッドの場合は `POST /api/project-memories` で知見を蓄積
+3. 該当なし → `POST /api/threads` でブロッカー起票（プロジェクトありなら `project_ids: ["uuid"]`、なしなら省略）
+4. 解決後 → プロジェクト紐づきスレッドの場合は `POST /api/project-memories` で知見を蓄積
 
 ### Email
 
@@ -909,8 +907,8 @@ Response:
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| POST | `/api/minion/threads` | スレッドを起票（scope, category対応。初回メッセージを同時作成） |
-| GET | `/api/minion/threads/open` | 未解決スレッド一覧（`?scope=all\|project\|workspace`） |
+| POST | `/api/minion/threads` | スレッドを起票（project_ids, category対応。初回メッセージを同時作成） |
+| GET | `/api/minion/threads/open` | 未解決スレッド一覧（`?project_id=uuid` で絞り込み可） |
 | GET | `/api/minion/threads/:id` | スレッド詳細 + メッセージ一覧 |
 | POST | `/api/minion/threads/:id/messages` | スレッドにメッセージを投稿 |
 | PATCH | `/api/minion/threads/:id/resolve` | スレッドを解決済みにする。Body: `{resolution}` |

package/docs/environment-setup.md

@@ -162,6 +162,86 @@ URL ベースの MCP サーバーは `url` フィールドで指定する（`com
 
 ---
 
+## WSL セッション（Windows ミニオン限定）
+
+Windows ミニオンで WSL（Windows Subsystem for Linux）内の Docker やリポジトリ操作を行うための機能。
+
+### 概要
+
+minion-agent は LocalSystem (Session 0) で動作するため、ユーザー単位の WSL ディストリビューションに直接アクセスできない。WSL セッションサーバーがユーザーセッションで別プロセスとして動作し、minion-agent がリクエストをプロキシする。
+
+### 前提条件
+
+- WSL 2 がインストール済み（`wsl --install` で導入可能）
+- Linux ディストリビューション（Ubuntu 等）がセットアップ済み
+- Docker Desktop for Windows がインストール済み（WSL 2 バックエンド有効）
+- ターゲットユーザーがログイン中（schtasks ONLOGON でサーバーが起動するため）
+
+### セットアップ
+
+`minion-cli setup` を実行すると、WSL が検出された場合に自動で登録される。手動で確認・起動する場合:
+
+```powershell
+# WSL セッションサーバーの状態確認
+schtasks /Query /TN "MinionWSL" /FO LIST
+
+# 手動起動（テスト用）
+schtasks /Run /TN "MinionWSL"
+
+# ヘルスチェック
+curl http://localhost:7682/api/wsl/health
+```
+
+### 使い方
+
+#### ターミナルセッション
+
+```bash
+# WSL ターミナルセッション作成
+curl -X POST http://localhost:8080/api/terminal/create \
+  -H "Authorization: Bearer $API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "wsl-dev", "type": "wsl"}'
+
+# コマンド送信
+curl -X POST http://localhost:8080/api/terminal/send \
+  -H "Authorization: Bearer $API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"session": "wsl-dev", "input": "docker compose up -d", "enter": true}'
+
+# WSL セッションサーバーの稼働状態確認
+curl http://localhost:8080/api/terminal/wsl/status \
+  -H "Authorization: Bearer $API_TOKEN"
+```
+
+#### チャット（WSL モード）
+
+チャット API に `wsl_mode: true` を追加すると、Claude Code CLI がユーザーセッションで実行され、`wsl` コマンドを直接使用できる。
+
+```bash
+curl -X POST http://localhost:8080/api/chat \
+  -H "Authorization: Bearer $API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"message": "WSL内でリポジトリをクローンしてDockerを起動して", "wsl_mode": true}'
+```
+
+### ポート構成
+
+| ポート | サービス | 備考 |
+|--------|---------|------|
+| 7682 | WSL session server (HTTP API) | localhost のみ |
+| 7683 | WSL session server (WebSocket) | localhost のみ、ttyd プロトコル |
+
+### トラブルシューティング
+
+| 問題 | 原因 | 対処 |
+|------|------|------|
+| WSL session server is not running | ユーザーが未ログイン | RDP/コンソールでログイン |
+| WSL not detected during setup | WSL 未インストール | `wsl --install` を実行後 `minion-cli setup` を再実行 |
+| Connection refused on port 7682 | サーバー異常終了 | `schtasks /Run /TN "MinionWSL"` で再起動 |
+
+---
+
 ## パッケージのインストール
 
 スキルが `requires.packages` で宣言したパッケージは、対応するパッケージマネージャーの list コマンドで検出される。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "3.9.0",
+  "version": "3.11.0",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {

package/rules/core.md

@@ -198,10 +198,10 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
 
 2-b. 該当なし or 自己解決不可 → ヘルプスレッドを起票
 
-   ■ ワークフロー実行中（プロジェクトあり）→ プロジェクトスレッド:
+   ■ ワークフロー実行中（プロジェクトあり）→ プロジェクト紐づきスレッド:
    POST /api/threads
    {
-     "project_id": "...",
+     "project_ids": ["..."],
      "thread_type": "help",
      "title": "問題の要約（1行）",
      "content": "状況の詳細説明",
@@ -215,7 +215,6 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
    ■ ルーティン実行中（プロジェクトなし）→ ワークスペーススレッド:
    POST /api/threads
    {
-     "scope": "workspace",
      "category": "general",
      "thread_type": "help",
      "title": "問題の要約（1行）",
@@ -229,7 +228,7 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
 
 3. スレッドの返信を待つ（thread_watcher が自動監視）
 
-4. 解決後 → プロジェクトスレッドの場合はプロジェクトメモリーに知見を保存
+4. 解決後 → プロジェクト紐づきスレッドの場合はプロジェクトメモリーに知見を保存
    POST /api/project-memories
    {
      "project_id": "...",
@@ -240,13 +239,13 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
    }
 ```
 
-### スレッドスコープの使い分け
+### スレッドのプロジェクト紐づけ
 
-| 状況 | スコープ | 説明 |
-|------|---------|------|
-| ワークフロー実行中のブロッカー | `scope: "project"` (デフォルト) | `project_id` 必須。プロジェクトメンバーが参加 |
-| ルーティン実行中のブロッカー | `scope: "workspace"` | `project_id` 不要。オーナーの全ミニオンが参加 |
-| プロジェクト外の一般的な質問・報告 | `scope: "workspace"` | カテゴリ: `general`, `ops`, `standup` |
+| 状況 | 設定 | 説明 |
+|------|------|------|
+| ワークフロー実行中のブロッカー | `project_ids: ["uuid"]` | プロジェクトに紐づけ。プロジェクトビューに表示される |
+| ルーティン実行中のブロッカー | `project_ids` を省略 | プロジェクトに紐づけない。ワークスペース全体に表示 |
+| プロジェクト外の一般的な質問・報告 | `project_ids` を省略 + `category` | カテゴリ: `general`, `ops`, `standup` |
 
 ### メンションの使い分け
 

package/win/bin/wsl-session-entry.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * WSL Session Server Entry Point
+ *
+ * Designed to be launched via schtasks ONLOGON so it runs in the
+ * target user's interactive session (not LocalSystem/Session 0).
+ *
+ * Reads configuration from .minion/.env, sets up environment,
+ * then starts the WSL session server.
+ */
+
+const fs = require('fs')
+const path = require('path')
+
+// ---------------------------------------------------------------------------
+// Resolve HOME_DIR from .minion/.env or environment
+// ---------------------------------------------------------------------------
+
+function loadEnvFile(envPath) {
+  if (!fs.existsSync(envPath)) return {}
+  const env = {}
+  for (const line of fs.readFileSync(envPath, 'utf-8').split('\n')) {
+    const trimmed = line.trim()
+    if (!trimmed || trimmed.startsWith('#')) continue
+    const eqIdx = trimmed.indexOf('=')
+    if (eqIdx < 0) continue
+    const key = trimmed.slice(0, eqIdx).trim()
+    let value = trimmed.slice(eqIdx + 1).trim()
+    // Strip surrounding quotes
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1)
+    }
+    env[key] = value
+  }
+  return env
+}
+
+// Determine HOME_DIR: prefer .minion/.env, fallback to env vars
+const homeDir = process.env.HOME || process.env.USERPROFILE || ''
+const dataDir = path.join(homeDir, '.minion')
+const envFile = path.join(dataDir, '.env')
+const envVars = loadEnvFile(envFile)
+
+// Apply env vars that aren't already set
+for (const [key, value] of Object.entries(envVars)) {
+  if (!(key in process.env)) process.env[key] = value
+}
+
+// Ensure HOME/USERPROFILE are set
+if (!process.env.HOME) process.env.HOME = homeDir
+if (!process.env.USERPROFILE) process.env.USERPROFILE = homeDir
+
+// ---------------------------------------------------------------------------
+// Extend PATH (same logic as server.js)
+// ---------------------------------------------------------------------------
+
+try {
+  const { buildExtendedPath } = require('../../core/lib/platform')
+  process.env.PATH = buildExtendedPath(homeDir)
+} catch (err) {
+  console.warn('[WSL-Entry] Could not extend PATH:', err.message)
+}
+
+// Load minion secrets into process.env
+try {
+  const variableStore = require('../../core/stores/variable-store')
+  const minionEnv = variableStore.buildEnv()
+  for (const [key, value] of Object.entries(minionEnv)) {
+    if (!(key in process.env)) process.env[key] = value
+  }
+  console.log(`[WSL-Entry] Loaded ${Object.keys(minionEnv).length} minion secrets`)
+} catch (err) {
+  console.warn('[WSL-Entry] Could not load minion secrets:', err.message)
+}
+
+// ---------------------------------------------------------------------------
+// Start the server
+// ---------------------------------------------------------------------------
+
+console.log(`[WSL-Entry] HOME_DIR: ${homeDir}`)
+console.log(`[WSL-Entry] PID: ${process.pid}`)
+
+const { startServer } = require('../wsl-session-server')
+
+startServer().catch((err) => {
+  console.error('[WSL-Entry] Failed to start WSL session server:', err)
+  process.exit(1)
+})

package/win/minion-cli.ps1

@@ -800,6 +800,35 @@ function Invoke-Setup {
         Write-Detail "TightVNC registered as logon task (user session, not service)"
     }
 
+    # Step 9b: Register WSL session server (runs in user session for WSL access)
+    $wslServerJs = Join-Path $minionPkgDir 'win\bin\wsl-session-entry.js'
+    if (Test-Path $wslServerJs) {
+        # Generate shared auth token for minion-agent <-> wsl-session-server communication
+        $wslTokenFile = Join-Path $DataDir '.wsl-session-token'
+        if (-not (Test-Path $wslTokenFile)) {
+            $wslToken = [System.Guid]::NewGuid().ToString('N')
+            [System.IO.File]::WriteAllText($wslTokenFile, $wslToken)
+            Write-Detail "WSL session token generated"
+        } else {
+            Write-Detail "WSL session token already exists"
+        }
+
+        $wslAvailable = $false
+        if (Get-Command wsl.exe -ErrorAction SilentlyContinue) {
+            $wslAvailable = $true
+        }
+
+        if ($wslAvailable) {
+            Remove-ScheduledTaskSilent "MinionWSL"
+            $wslTR = "'$nodePath' '$wslServerJs'"
+            schtasks /Create /TN "MinionWSL" /TR $wslTR /SC ONLOGON /RL HIGHEST /F | Out-Null
+            Write-Detail "WSL session server registered as logon task (user session)"
+        } else {
+            Write-Warn "WSL not detected. WSL session server not registered."
+            Write-Detail "Install WSL and re-run setup to enable WSL sessions."
+        }
+    }
+
     # Step 10: Setup websockify (runs as LocalSystem, paired with VNC)
     Write-Step 9 $totalSteps "Setting up websockify..."
     [array]$wsCmd = Get-WebsockifyCommand
@@ -949,6 +978,7 @@ function Invoke-Setup {
     $fwRules = @(
         @{ Name = 'Minion Agent'; Port = 8080 },
         @{ Name = 'Minion Terminal'; Port = 7681 },
+        @{ Name = 'Minion WSL Terminal'; Port = 7683 },
         @{ Name = 'Minion VNC'; Port = 6080 }
     )
     foreach ($rule in $fwRules) {
@@ -1096,6 +1126,10 @@ function Invoke-Uninstall {
         }
     }
 
+    # Remove WSL session server logon task
+    Remove-ScheduledTaskSilent "MinionWSL"
+    Write-Detail "WSL session server logon task removed"
+
     # Remove VNC logon task and legacy NSSM service
     Remove-ScheduledTaskSilent "MinionVNC"
     Invoke-Nssm stop minion-vnc