@geekbeer/minion 3.51.2 → 3.53.1

package/core/stores/page-recipe-store.js

@@ -0,0 +1,143 @@
+/**
+ * Page Recipe Store (SQLite, experimental — v3.53.0)
+ *
+ * Backs POST /api/web/extract. See core/lib/web-extract/extractor.js for the
+ * orchestrator that decides hot vs cold paths.
+ */
+
+const { getDb } = require('../db')
+
+const MAX_FAIL_COUNT = 3
+
+function find({ urlTemplate, domFingerprint }) {
+  const db = getDb()
+  const row = db.prepare(`
+    SELECT url_template, dom_fingerprint, selectors_json, page_type,
+           hit_count, fail_count, last_verified_at, created_at
+    FROM page_recipes
+    WHERE url_template = ? AND dom_fingerprint = ?
+  `).get(urlTemplate, domFingerprint)
+  if (!row) return null
+  return parseRow(row)
+}
+
+function findByTemplate(urlTemplate) {
+  const db = getDb()
+  const rows = db.prepare(`
+    SELECT url_template, dom_fingerprint, selectors_json, page_type,
+           hit_count, fail_count, last_verified_at, created_at
+    FROM page_recipes
+    WHERE url_template = ?
+    ORDER BY last_verified_at DESC NULLS LAST, created_at DESC
+  `).all(urlTemplate)
+  return rows.map(parseRow)
+}
+
+function upsert({ urlTemplate, domFingerprint, selectors, pageType }) {
+  const db = getDb()
+  const json = JSON.stringify(selectors || {})
+  const now = new Date().toISOString()
+  db.prepare(`
+    INSERT INTO page_recipes (url_template, dom_fingerprint, selectors_json, page_type, hit_count, fail_count, last_verified_at, created_at)
+    VALUES (?, ?, ?, ?, 0, 0, ?, ?)
+    ON CONFLICT(url_template, dom_fingerprint) DO UPDATE SET
+      selectors_json = excluded.selectors_json,
+      page_type = excluded.page_type,
+      fail_count = 0,
+      last_verified_at = excluded.last_verified_at
+  `).run(urlTemplate, domFingerprint, json, pageType || null, now, now)
+  return find({ urlTemplate, domFingerprint })
+}
+
+function incrementHit({ urlTemplate, domFingerprint }) {
+  const db = getDb()
+  db.prepare(`
+    UPDATE page_recipes
+    SET hit_count = hit_count + 1
+    WHERE url_template = ? AND dom_fingerprint = ?
+  `).run(urlTemplate, domFingerprint)
+}
+
+function setLastVerified({ urlTemplate, domFingerprint }) {
+  const db = getDb()
+  db.prepare(`
+    UPDATE page_recipes
+    SET last_verified_at = ?, fail_count = 0
+    WHERE url_template = ? AND dom_fingerprint = ?
+  `).run(new Date().toISOString(), urlTemplate, domFingerprint)
+}
+
+/**
+ * Increment fail count. Returns true if the recipe was deleted (>= MAX_FAIL_COUNT).
+ */
+function incrementFail({ urlTemplate, domFingerprint }) {
+  const db = getDb()
+  const row = db.prepare(`
+    SELECT fail_count FROM page_recipes
+    WHERE url_template = ? AND dom_fingerprint = ?
+  `).get(urlTemplate, domFingerprint)
+  if (!row) return false
+  const next = (row.fail_count || 0) + 1
+  if (next >= MAX_FAIL_COUNT) {
+    remove({ urlTemplate, domFingerprint })
+    return true
+  }
+  db.prepare(`
+    UPDATE page_recipes
+    SET fail_count = ?
+    WHERE url_template = ? AND dom_fingerprint = ?
+  `).run(next, urlTemplate, domFingerprint)
+  return false
+}
+
+function remove({ urlTemplate, domFingerprint }) {
+  const db = getDb()
+  const result = db.prepare(`
+    DELETE FROM page_recipes
+    WHERE url_template = ? AND dom_fingerprint = ?
+  `).run(urlTemplate, domFingerprint)
+  return result.changes > 0
+}
+
+function listAll({ limit = 100 } = {}) {
+  const db = getDb()
+  const rows = db.prepare(`
+    SELECT url_template, dom_fingerprint, selectors_json, page_type,
+           hit_count, fail_count, last_verified_at, created_at
+    FROM page_recipes
+    ORDER BY last_verified_at DESC NULLS LAST, created_at DESC
+    LIMIT ?
+  `).all(limit)
+  return rows.map(parseRow)
+}
+
+function parseRow(row) {
+  let selectors = {}
+  try {
+    selectors = JSON.parse(row.selectors_json || '{}')
+  } catch {
+    selectors = {}
+  }
+  return {
+    url_template: row.url_template,
+    dom_fingerprint: row.dom_fingerprint,
+    selectors,
+    page_type: row.page_type,
+    hit_count: row.hit_count,
+    fail_count: row.fail_count,
+    last_verified_at: row.last_verified_at,
+    created_at: row.created_at,
+  }
+}
+
+module.exports = {
+  find,
+  findByTemplate,
+  upsert,
+  incrementHit,
+  incrementFail,
+  setLastVerified,
+  remove,
+  listAll,
+  MAX_FAIL_COUNT,
+}

package/docs/api-reference.md

@@ -696,6 +696,72 @@ PUT `/api/email/inbox/:id` body:
 
 Note: 既読メールは受信後90日で自動削除される。未読メールは保持される。
 
+### Web Page Extraction 🧪 (experimental, v3.53.0〜)
+
+Web ページの読み取り・要約・情報抽出をミニオン内のサブプロセスで完結させ、メインの Claude Code セッションには結果 JSON だけを返すための実験的 API。Playwright MCP で DOM 全体がチャットに流れ込みトークン肥大化を起こす問題への対処として導入。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/web/extract` | URL を抽出済み JSON に変換 (タイトル・本文・主要構造化データ) |
+| GET  | `/api/web/recipes` | キャッシュされたレシピ一覧 (debug) |
+| DELETE | `/api/web/recipes?template=...&fingerprint=...` | レシピを削除 |
+
+**前提条件 (LLM の解決順):**
+1. **primary LLM プラグインが設定されていればそれを使用** (推奨)。`PUT /api/llm/config` で `claude` 等を primary に指定すると、CLI の認証情報 (`~/.claude/.credentials.json`) がそのまま使われる。API キーの別途設定は不要。
+2. primary 未設定で `ANTHROPIC_API_KEY` シークレットが設定されていれば、そちらを fallback として使用 (Anthropic Messages API の tool_use で JSON Schema を強制)。
+3. どちらもなければ 503 (`LLM_UNAVAILABLE`) を返す。
+
+その他の前提:
+- ホスト上で `npx playwright install chromium` を実行済みであること (未実行の場合 503 が返る)
+
+**`POST /api/web/extract` リクエスト:**
+```json
+{
+  "url": "https://example.com/article/123",
+  "hint": "本文と著者を抽出してほしい (任意, 抽出フィールドのヒント)"
+}
+```
+
+**レスポンス (success):**
+```json
+{
+  "success": true,
+  "experimental": true,
+  "url": "https://example.com/article/123",
+  "finalUrl": "https://example.com/article/123",
+  "statusCode": 200,
+  "recipeMode": "cold",
+  "recipeId": "example.com/article/:id#abc123def456",
+  "pageType": "article",
+  "title": "...",
+  "content": "Markdown 本文...",
+  "structured": { "title": "...", "author": "...", "publishedAt": "..." },
+  "selectors": { "title": { "selector": "h1" }, "author": { "selector": "a[rel=author]" } }
+}
+```
+
+**動作:**
+- 初回アクセス (cold): Playwright でレンダリング → Readability で本文抽出 → Anthropic Haiku でセレクタ生成 → SQLite (`page_recipes`) に保存 → セレクタで再抽出して返却
+- 2回目以降 (hot): URL 正規化・テンプレート化 → DOM フィンガープリントで保存済みレシピを照合 → セレクタで抽出のみ (LLM 呼び出しなし)
+- セルフヒール: hot 実行で空結果が返ったら `fail_count++`、3回失敗で破棄して次回 cold 再生成
+
+**URL 正規化ルール:**
+- `utm_*` `fbclid` `gclid` `ref` 等のトラッキングクエリは除去
+- `page` `p` `offset` 等のページネーション値は `:n` プレースホルダ化
+- パスセグメントは数値→`:id`、UUID→`:uuid`、20文字以上の英数字→`:slug` に置換
+- 例: `https://www.lancers.jp/work/proposal/123456?utm_source=foo&page=2` → `lancers.jp/work/proposal/:id?page=:n`
+
+**エラー:**
+- 401: APIトークン不正
+- 400: URL 欠落・不正
+- 502: primary LLM 呼び出し失敗 (`PRIMARY_LLM_FAILED`) / 返却 JSON が parse 不能 (`PRIMARY_LLM_BAD_JSON`)
+- 503: Playwright 未インストール (`PLAYWRIGHT_UNAVAILABLE`) / LLM 未設定 (`LLM_UNAVAILABLE`)
+- 500: 抽出失敗 (タイムアウト等)
+
+**注意 (experimental):**
+- レスポンス形状・URL 正規化ルール・キャッシュスキーマは予告なく変更される可能性がある
+- 認証付きページ (ログイン必須) は対応外。Cookie や対話的操作が必要な場合は Playwright MCP を使用すること
+
 ### Commands
 
 | Method | Endpoint | Description |
@@ -705,6 +771,23 @@ Note: 既読メールは受信後90日で自動削除される。未読メール
 
 Available commands: `restart-agent`, `update-agent`, `restart-display`, `restart-all`, `status-services`
 
+### Admin (HQ → Minion only)
+
+HQ が課金状態の変化に応じてミニオンに直接プッシュするエンドポイント。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/admin/freeze` | ポーラーを停止しHQへの発信を抑止する。Body: `{reason}` |
+| GET  | `/api/admin/state`  | 現在のfrozen状態を取得 |
+
+**Freeze の挙動 (v3.52.0〜):**
+- ミニオン内のグローバル `frozen=true` (in-memory only) を立てる。
+- 各ポーラー (step, dag-step, board-task, thread-watcher, dag-cron, revision-watcher, heartbeat) が `pollOnce()` 直前で `isFrozen()` を確認しスキップ。
+- 共通HTTPクライアント (`core/api.js`, 各pollerの `*Request`) は HQ から `402 billing_frozen` を受信した時点で自動的に `frozen=true` をセット (HQからのpushが届かなくても自己防衛)。
+- 状態は**ディスク永続化されない**。プロセス再起動で自動的にクリアされ、課金復活後の `restart-agent` コマンドで自然に解除される。
+
+復旧は HQ が既存の `POST /api/command { command: "restart-agent" }` をプッシュすることで行う (専用 unfreeze エンドポイントは無い)。
+
 ---
 
 ## HQ API Endpoints (https://<HQ_URL>)

package/docs/task-guides.md

@@ -4,6 +4,64 @@
 
 ---
 
+## Webページの読み取り・要約 🧪 (experimental, v3.53.0〜)
+
+ユーザーから「このURLを要約して」「このページの情報を抽出して」「このページの一覧を取ってきて」と依頼された場合の手順。
+
+### まずローカルAPIを試す
+
+```bash
+curl -X POST http://localhost:8080/api/web/extract \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"url": "対象URL", "hint": "何を抽出したいか短く (任意)"}' | jq
+```
+
+返ってきた JSON の `title` `content` `structured` を使って要約・回答を作成する。`structured` には初回アクセス時に LLM が選んだフィールドが入る。
+
+このAPIは内部で Playwright + Readability を回して **メインセッションには結果 JSON だけ返す** ため、Playwright MCP を使うときに起きていたチャットコンテキストのトークン肥大化が回避できる。
+
+### Playwright MCP を使うべき場面
+
+`/api/web/extract` で対応できないのは以下のケース。このときだけ `mcp__playwright__*` を使う:
+
+- ログイン必須ページ (Cookie/2FA 等の認証必要)
+- フォーム入力・複数ページ遷移を伴う操作
+- ボタンクリック→動的に追加されるコンテンツの取得
+- Lancers コンペ応募など、明らかに対話的操作が必要なフロー
+
+**単純な閲覧・抽出用途では MCP を使わない。**
+
+### よくあるパターン
+
+| ユーザー依頼 | 推奨手段 |
+|--------------|----------|
+| 「このQiita記事を要約」 | `/api/web/extract` |
+| 「Lancersコンペの一覧を取得」 | `/api/web/extract` |
+| 「このプロダクトページから価格を抽出」 | `/api/web/extract` |
+| 「ログインしてダッシュボード操作」 | Playwright MCP |
+| 「フォームを送信」 | Playwright MCP |
+| 「複数ページ巡回して全件取得」 | `/api/web/extract` をループ呼び出し (各ページに対して) |
+
+### キャッシュの確認・破棄 (debug)
+
+```bash
+# キャッシュ済みレシピ一覧
+curl -H "Authorization: Bearer $API_TOKEN" http://localhost:8080/api/web/recipes | jq
+
+# 特定のレシピを削除 (壊れたセレクタを強制再生成させたい場合)
+curl -X DELETE -H "Authorization: Bearer $API_TOKEN" \
+  "http://localhost:8080/api/web/recipes?template=lancers.jp/work/proposal/:id&fingerprint=abc123def456"
+```
+
+### 失敗時の対処
+
+- `503 PLAYWRIGHT_UNAVAILABLE` → ホスト側で `npx playwright install chromium` を実行 (sudo 不要)
+- `503 LLM_UNAVAILABLE` → primary LLM 未設定。`PUT /api/llm/config -d '{"primary":"claude"}'` で primary を指定するか、fallback として `PUT /api/secrets/ANTHROPIC_API_KEY` で API キーを投入
+- `502 PRIMARY_LLM_BAD_JSON` → primary LLM が JSON 形式で返さなかった。プラグインの認証状態を `GET /api/llm/plugins` で確認し、必要なら別 plugin を primary にする
+- `500 extract timeout` → ページが重すぎる/JSレンダリング待ちが長すぎる。Playwright MCP に切り替えて手動操作
+
+---
+
 ## スキルの修正
 
 ### 1. ローカルのスキルを編集する

package/linux/routes/chat.js

@@ -362,6 +362,29 @@ async function buildContextPrefix(message, context, sessionId, workspaceId, refe
     )
   }
 
+  // Web page extraction guidance (experimental, v3.53.0)
+  if (!sessionId) {
+    const port = require('../../core/config').config.AGENT_PORT
+    parts.push(
+      '[Webページ読み取りについて 🧪 experimental]',
+      'Webページの読み取り・要約・情報抽出が必要なときは、まず以下のローカルAPIを試すこと:',
+      '',
+      '```bash',
+      `curl -X POST http://localhost:${port}/api/web/extract \\`,
+      '  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \\',
+      '  -d \'{"url": "対象URL", "hint": "抽出したい内容を短く"}\'',
+      '```',
+      '',
+      'このAPIは内部で Playwright + Readability を回し、抽出済みJSONだけを返すため、',
+      'DOM全体がチャットに流れ込んでトークン肥大化することを防げる。',
+      '初回アクセスで学習したセレクタはSQLiteにキャッシュされ、2回目以降はLLM呼び出しなしで抽出される。',
+      '',
+      'Playwright MCP (`mcp__playwright__*`) は **ログイン・フォーム入力・複数画面の対話操作**が必要な場合のみ使用する。',
+      '単純な閲覧・要約・一覧取得用途ではMCPを使わない。',
+      ''
+    )
+  }
+
   // File output guidance — always inject on new sessions
   if (!sessionId) {
     parts.push(
@@ -770,6 +793,11 @@ function streamViaLegacyLlmCommand(res, prompt, sessionId, workspaceId, original
     child.on('close', async (code) => {
       activeChatChild = null
 
+      console.log(`[Chat] child closed: code=${code}, response=${fullResponse.length}chars, turns=${turnCount}, stderr=${stderrBuffer.length}bytes, session=${resolvedSessionId}`)
+      if (stderrBuffer.trim()) {
+        console.log(`[Chat] final stderr (tail 500): ${stderrBuffer.slice(-500)}`)
+      }
+
       // Store messages in chat-store
       if (resolvedSessionId) {
         // If this was a new session, also store the user message now
@@ -782,11 +810,15 @@ function streamViaLegacyLlmCommand(res, prompt, sessionId, workspaceId, original
         }
       }
 
-      // If exit code is non-zero and no response was generated, send error
-      if (code !== 0 && !fullResponse) {
+      if (code !== 0) {
         const errorMsg = stderrBuffer.trim() || `Claude CLI exited with code ${code}`
-        console.error(`[Chat] CLI failed (exit ${code}): ${errorMsg}`)
-        const errorEvent = JSON.stringify({ type: 'error', error: errorMsg })
+        console.error(`[Chat] CLI failed (exit ${code}, partial=${!!fullResponse}): ${errorMsg}`)
+        const errorEvent = JSON.stringify({
+          type: 'error',
+          error: errorMsg,
+          partial: !!fullResponse,
+          exit_code: code,
+        })
         res.write(`data: ${errorEvent}\n\n`)
       }
 

package/linux/server.js

@@ -74,6 +74,7 @@ const { skillRoutes } = require('../core/routes/skills')
 const { workflowRoutes } = require('../core/routes/workflows')
 const { routineRoutes } = require('../core/routes/routines')
 const { authRoutes } = require('../core/routes/auth')
+const { adminRoutes } = require('../core/routes/admin')
 const { variableRoutes } = require('../core/routes/variables')
 const { memoryRoutes } = require('../core/routes/memory')
 const { dailyLogRoutes } = require('../core/routes/daily-logs')
@@ -84,6 +85,7 @@ const { todoRoutes } = require('../core/routes/todos')
 const { emailRoutes } = require('../core/routes/emails')
 const { daemonRoutes } = require('../core/routes/daemons')
 const { llmRoutes } = require('../core/routes/llm')
+const { webRoutes } = require('../core/routes/web')
 
 // Linux-specific routes
 const { commandRoutes, getProcessManager, getAllowedCommands } = require('./routes/commands')
@@ -286,6 +288,7 @@ async function registerAllRoutes(app) {
   await app.register(workflowRoutes, { workflowRunner })
   await app.register(routineRoutes, { routineRunner })
   await app.register(authRoutes)
+  await app.register(adminRoutes)
   await app.register(variableRoutes)
   await app.register(memoryRoutes)
   await app.register(dailyLogRoutes)
@@ -296,6 +299,7 @@ async function registerAllRoutes(app) {
   await app.register(emailRoutes)
   await app.register(daemonRoutes, { heartbeatStatus: () => ({ running: !!heartbeatTimer, last_beat_at: lastBeatAt }) })
   await app.register(llmRoutes)
+  await app.register(webRoutes)
 
   // Linux-specific routes
   await app.register(commandRoutes)

package/mac/server.js

@@ -72,6 +72,7 @@ const { todoRoutes } = require('../core/routes/todos')
 const { emailRoutes } = require('../core/routes/emails')
 const { daemonRoutes } = require('../core/routes/daemons')
 const { llmRoutes } = require('../core/routes/llm')
+const { webRoutes } = require('../core/routes/web')
 
 // macOS-specific routes
 const { commandRoutes, getProcessManager, getAllowedCommands } = require('./routes/commands')
@@ -284,6 +285,7 @@ async function registerAllRoutes(app) {
   await app.register(emailRoutes)
   await app.register(daemonRoutes, { heartbeatStatus: () => ({ running: !!heartbeatTimer, last_beat_at: lastBeatAt }) })
   await app.register(llmRoutes)
+  await app.register(webRoutes)
 
   // macOS-specific routes
   await app.register(commandRoutes)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "3.51.2",
+  "version": "3.53.1",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {
@@ -33,13 +33,17 @@
     "db:migration:new": "node scripts/new-migration.js"
   },
   "dependencies": {
+    "@mozilla/readability": "^0.5.0",
     "croner": "^9.0.0",
     "fastify": "^5.2.2",
+    "linkedom": "^0.18.0",
+    "turndown": "^7.2.0",
     "ws": "^8.0.0"
   },
   "optionalDependencies": {
     "better-sqlite3": "^11.0.0",
-    "node-pty": "^1.0.0"
+    "node-pty": "^1.0.0",
+    "playwright": "^1.48.0"
   },
   "engines": {
     "node": ">=22.0.0"

package/rules/core.md

@@ -103,7 +103,35 @@ minion-cli --version                      # バージョン確認
 
 `http://localhost:8080` — 認証: `Authorization: Bearer $API_TOKEN`
 
-主なカテゴリ: Health, Skills, Workflows, Executions, Terminal, Files, Commands, Permissions
+主なカテゴリ: Health, Skills, Workflows, Executions, Terminal, Files, Commands, Permissions, Admin (HQ-pushed freeze), Web Extraction (experimental)
+
+#### Web Page Extraction 🧪 (experimental, v3.53.0〜)
+
+Webページの読み取り・要約・情報抽出には、**Playwright MCP より先に** ローカルAPI `POST /api/web/extract` を試すこと。
+
+このAPIは内部でヘッドレスブラウザ→本文クリーン (Readability) →セレクタ抽出 (LLMサブプロセスで自動学習) →JSON 返却までを完結させる。**メインセッションに巨大な DOM が流れ込まないため、トークン肥大化やセッション終了を防げる。**
+
+```bash
+curl -X POST http://localhost:8080/api/web/extract \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"url": "https://example.com/article/123", "hint": "本文と著者を抽出"}'
+```
+
+レシピは初回アクセス時に LLM (Haiku) で生成・SQLite (`page_recipes` テーブル) に保存され、2回目以降の構造的に同じページでは LLM 呼び出しなしで抽出される。
+
+Playwright MCP (`mcp__playwright__*`) は **フォーム入力・クリック・複数画面遷移など対話的な操作**が必要な場合のみ使用すること。単に「ページを読む」目的では MCP を使わない。
+
+**実験的機能**: レスポンス形状は予告なく変わる可能性がある。要件: (1) primary LLM 設定済み (`PUT /api/llm/config` で `claude` 等を選択、`hq llm primary <name>` でも可) または `ANTHROPIC_API_KEY` シークレット設定済み、(2) ホスト上で `npx playwright install chromium` 実行済み。primary LLM が設定されていれば API キー不要 (Claude Code CLI の認証情報を再利用)。
+
+詳細仕様は `~/.minion/docs/api-reference.md` の「Web Page Extraction」セクション、ユースケースは `~/.minion/docs/task-guides.md` の「Webページの読み取り・要約」を参照。
+
+#### Billing-Driven Freeze (v3.52.0〜)
+
+ユーザーの決済が `past_due` に陥ると、HQ から `POST /api/admin/freeze` がプッシュされ、ミニオン全ポーラーが停止する。
+- 状態は in-memory のみ (frozen.json などのディスクファイルは存在しない)。
+- HQ への発信中に `402 billing_frozen` を受けた場合も自動的にfrozen化される (HQ pushが届かなくても自己防衛)。
+- 復旧は HQ が `restart-agent` コマンドをプッシュ → プロセス再起動 → in-memory フラグが消えて自動再開。
+- API仕様は `~/.minion/docs/api-reference.md` の「Admin」セクション参照。
 
 #### Permission Management
 

package/win/routes/chat.js

@@ -423,6 +423,29 @@ async function buildContextPrefix(message, context, sessionId, workspaceId, refe
     )
   }
 
+  // Web page extraction guidance (experimental, v3.53.0)
+  if (!sessionId) {
+    const port = require('../../core/config').config.AGENT_PORT
+    parts.push(
+      '[Webページ読み取りについて 🧪 experimental]',
+      'Webページの読み取り・要約・情報抽出が必要なときは、まず以下のローカルAPIを試すこと:',
+      '',
+      '```bash',
+      `curl -X POST http://localhost:${port}/api/web/extract \\`,
+      '  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \\',
+      '  -d \'{"url": "対象URL", "hint": "抽出したい内容を短く"}\'',
+      '```',
+      '',
+      'このAPIは内部で Playwright + Readability を回し、抽出済みJSONだけを返すため、',
+      'DOM全体がチャットに流れ込んでトークン肥大化することを防げる。',
+      '初回アクセスで学習したセレクタはSQLiteにキャッシュされ、2回目以降はLLM呼び出しなしで抽出される。',
+      '',
+      'Playwright MCP (`mcp__playwright__*`) は **ログイン・フォーム入力・複数画面の対話操作**が必要な場合のみ使用する。',
+      '単純な閲覧・要約・一覧取得用途ではMCPを使わない。',
+      ''
+    )
+  }
+
   // File output guidance — always inject on new sessions
   if (!sessionId) {
     parts.push(
@@ -790,6 +813,12 @@ function streamViaLegacyLlmCommand(res, prompt, sessionId, workspaceId, original
 
     child.on('close', async (code) => {
       activeChatChild = null
+
+      console.log(`[Chat] child closed: code=${code}, response=${fullResponse.length}chars, turns=${turnCount}, stderr=${stderrBuffer.length}bytes, session=${resolvedSessionId}`)
+      if (stderrBuffer.trim()) {
+        console.log(`[Chat] final stderr (tail 500): ${stderrBuffer.slice(-500)}`)
+      }
+
       if (resolvedSessionId) {
         if (!sessionId) {
           await chatStore.addMessage(resolvedSessionId, { role: 'user', content: originalMessage || prompt }, undefined, workspaceId)
@@ -798,9 +827,15 @@ function streamViaLegacyLlmCommand(res, prompt, sessionId, workspaceId, original
           await chatStore.addMessage(resolvedSessionId, { role: 'assistant', content: fullResponse }, turnCount, workspaceId)
         }
       }
-      if (code !== 0 && !fullResponse) {
+      if (code !== 0) {
         const errorMsg = stderrBuffer.trim() || `Claude CLI exited with code ${code}`
-        res.write(`data: ${JSON.stringify({ type: 'error', error: errorMsg })}\n\n`)
+        console.error(`[Chat] CLI failed (exit ${code}, partial=${!!fullResponse}): ${errorMsg}`)
+        res.write(`data: ${JSON.stringify({
+          type: 'error',
+          error: errorMsg,
+          partial: !!fullResponse,
+          exit_code: code,
+        })}\n\n`)
       }
 
       const session = await chatStore.load(workspaceId)

package/win/server.js

@@ -57,6 +57,7 @@ const { skillRoutes } = require('../core/routes/skills')
 const { workflowRoutes } = require('../core/routes/workflows')
 const { routineRoutes } = require('../core/routes/routines')
 const { authRoutes } = require('../core/routes/auth')
+const { adminRoutes } = require('../core/routes/admin')
 const { variableRoutes } = require('../core/routes/variables')
 const { memoryRoutes } = require('../core/routes/memory')
 const { dailyLogRoutes } = require('../core/routes/daily-logs')
@@ -66,6 +67,7 @@ const { todoRoutes } = require('../core/routes/todos')
 const { emailRoutes } = require('../core/routes/emails')
 const { daemonRoutes } = require('../core/routes/daemons')
 const { llmRoutes } = require('../core/routes/llm')
+const { webRoutes } = require('../core/routes/web')
 
 // Validate configuration
 validate()
@@ -221,6 +223,7 @@ async function registerRoutes(app) {
   await app.register(workflowRoutes, { workflowRunner })
   await app.register(routineRoutes, { routineRunner })
   await app.register(authRoutes)
+  await app.register(adminRoutes)
   await app.register(variableRoutes)
   await app.register(memoryRoutes)
   await app.register(dailyLogRoutes)
@@ -230,6 +233,7 @@ async function registerRoutes(app) {
   await app.register(emailRoutes)
   await app.register(daemonRoutes, { heartbeatStatus: () => ({ running: !!heartbeatTimer, last_beat_at: lastBeatAt }) })
   await app.register(llmRoutes)
+  await app.register(webRoutes)
 
   // Shutdown endpoint — allows detached restart/update scripts to trigger
   // graceful shutdown (offline heartbeat) before force-killing the process.