> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fim.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ロードマップ

> FIM One の機能ロードマップとバージョン計画。

> Goal: Build an **all-in-one agent platform for Global × China enterprises** — delivered through three progressive modes: Standalone (portal assistant), Copilot (embedded in host system), Hub (central cross-system orchestration).
>
> Principles: **Provider-agnostic** (no vendor lock-in), **minimal-abstraction**, **protocol-first**, **connector-first** (integration is the core value).

## 製品ビジョン

FIM One は、3つの段階的なデリバリーモードに対応する**オールインワンエージェントプラットフォーム**です。

```
Standalone   → Your own AI assistant (Portal)
Copilot      → AI embedded in a host system (iframe / widget / embed)
Hub          → Central cross-system orchestration (Portal / API)
```

**クロスシステムオーケストレーションが主要な差別化要因です。** エンタープライズクライアントは、ERP、CRM、OA、財務、HR などのレガシーシステムを保有しており、これらを AI を通じて相互に連携させる必要があります。

```mermaid theme={null}
flowchart LR
  subgraph Sources["Source Systems"]
    ERP["ERP<br/>(SAP/Kingdee)"]
    CRM["CRM<br/>(Salesforce)"]
    OA["OA<br/>(Seeyon/Weaver)"]
    DB["Custom DB<br/>(PG/MySQL)"]
  end

  subgraph Hub["FIM One Agent Core"]
    A["Agent A: Finance Audit"]
    B["Agent B: Contract Review"]
    C["Agent C: Approval Assist"]
    D["Agent D: Data Reporting"]
  end

  subgraph Targets["Notification Targets"]
    T1["Lark / Slack"]
    T2["Email / WeCom"]
    T3["Teams / Webhook"]
    T4["Any API"]
  end

  subgraph Delivery["Delivery"]
    Portal["Portal (UI)"]
    API["API (headless)"]
    Embed["iframe (embed)"]
  end

  ERP --> A --> T1
  CRM --> B --> T2
  OA --> C --> T3
  DB --> D --> T4
  Hub --> Delivery
```

**GTM パス：ランド・アンド・エクスパンド**

| ステップ   | モード           | 実行内容                        |
| ------ | ------------- | --------------------------- |
| ランド    | Copilot       | 1つのシステムに組み込み、そのUI内で価値を実証    |
| エクスパンド | Copilot → Hub | より多くのシステムに展開。Hub モードでそれらを統合 |

## Known Issues

本番環境で再現可能だが、まだ修正されていない追跡中のバグ。各エントリは症状、疑わしい影響範囲、および回避策（ある場合）を記載しています。修正がスコープ化され、スケジュール化されると、アイテムはバージョンセクションに移動します。

* **Playground の停止と再試行で、ページ更新で常にクリアされる一時的なビジュアルアーティファクトが表示されます。** 3 つの同時レンダリングソース — `activeConversation.messages`（DB スナップショット）、SSE `messages` ストリーム、および楽観的な `pendingQuery` プレースホルダー — が単一の派生状態に統合されていないため、「再試行」をクリックしてからペアのアシスタント応答が到着するまでの間、UI は (a) 事前ストリームウィンドウで同じクエリを 2 回簡潔にレンダリングしたり、(b) `hasLiveMessages` が true で、スナップショットが再読み込みされる前に再試行履歴から以前の孤立したユーザーバブルをドロップしたり、(c) SSE「完了」イベントと次の `selectConversation` 更新の間の狭いウィンドウでちらつく可能性があります。**データは決して失われません** — すべてのユーザーメッセージ（中止された再試行を含む）は `conversation.messages` に永続化され、`normalize_alternating_messages` 経由で次の LLM 呼び出しに引き継がれ、`48ba08c6` レンダリング修正で導入された `HistoryTurn.orphanUserContents` 経由で更新後に正しくレンダリングされます。文脈として、Claude 自身の Web UI は同様のクラスのバグを示しており、応答の途中で停止してすぐにフォローアップクエリを送信すると、フォローアップが最初のクエリの兄弟編集ブランチとしてフォークされることがあり、新しいターンとして追加されるのではなく、これは楽観的 UI + SSE + 永続化履歴設計における既知の難しい問題であり、FIM One 固有の欠陥ではありません。適切な修正には、3 つのレンダリングソースを単一の派生状態に統合する必要があります。より広い Playground ステートマシンリファクタリングまで延期されています。

## Backlog (Low Priority) {/* dev: dev/dag-evidence-fidelity.md */}

遅延強化——ブロッキングなし；マッチングシナリオが表示される場合のみ取り上げてください。

* [ ] **DAG evidence gets its own truncation budget**, decoupled from `DAG_ANALYZER_TRUNCATION`, so source evidence isn't re-clipped by the summary budget before the analyzer/synthesis verify against it.
* [ ] **Structure-aware evidence truncation** (head+tail / keep lists & tables) so long enumerations survive the cap instead of silently losing their tail.
* [ ] **Port the source-fidelity guideline into the ReAct fallback synthesis prompt** so total/severity mislabels are caught in ReAct too, not only in DAG.

## 出荷済みバージョン

### v0.1 (2026-02-22) — MVP: ReAct + DAG Planner

* ReActAgent（ツール付き：calculator、python\_exec、web\_search）
* DAG Planner（LLMが依存グラフを生成）
* Portal UI（ストリーミング + KaTeX対応）

### v0.2 (2026-02-24) — Multi-Model + Memory

* リトライ / レート制限 / 使用状況追跡
* ネイティブ関数呼び出し（JSON のみの解析なし）
* マルチモデルサポート（fast + main LLM）
* メモリ: WindowMemory、SummaryMemory
* SSE ストリーミング対応の FastAPI バックエンド

### v0.3 (2026-02-25) — Web Tools + MCP

* Webツール（web\_search、web\_fetch）via Jina/Tavily/Brave
* ファイル操作ツール
* MCPクライアント（標準ツール統合）
* ツール自動検出 + カテゴリ
* クリックスクロール対応のDAG可視化
* Docker内でのコード実行（`--network=none`）

### v0.4 (2026-02-25) — マルチターン + エージェント

* マルチターン会話 (DbMemory)
* ツールステップ折りたたみUI
* HTTPリクエスト + シェル実行ツール
* エージェント管理 (作成、設定、公開)
* JWT認証
* エージェント単位の実行モード + 温度制御

### v0.5 (2026-02-28) — Full RAG + Grounded Gen

* Full RAG パイプライン (embedding + vector store + FTS + RRF + reranker)
* Grounded Generation (citations、confidence scores)
* Knowledge base ドキュメント管理 (CRUD、search、retry、schema migration)
* ContextGuard + pinned messages (token budget manager)
* DbMemory persistence + LLM Compact
* DAG Re-Planning (up to 3 rounds)

### v0.6 (2026-03-01) — Connector Platform

* **Connector CRUD**: create, read, update, delete
* **ConnectorToolAdapter**: converts Connector → BaseTool
* **Per-user credentials**: AES-GCM encryption
* **確認闸門**: write operation approval
* **監査ログ**: all tool calls recorded
* **Circuit breaker**: graceful degradation on failures
* **ユーティリティツール**: email\_send, json\_transform, template\_render, text\_utils
* **埋め込みオプション**: Jina, OpenAI, custom providers

### v0.7 (2026-03-06) — Admin Platform + Multi-Tenant

* **Admin Platform**: ユーザー管理、ロール切り替え、パスワードリセット、アカウント有効化/無効化
* **招待制登録**: 3つのモード（オープン/招待/無効）+ 招待コードCRUD
* **ストレージ管理**: ユーザーごとのディスク使用量、クリア、孤立ファイルのクリーンアップ
* **会話モデレーション**: 管理者による一覧表示/削除
* **ユーザーごとの強制ログアウト**: すべてのトークンを無効化
* **API ヘルスダッシュボード**: システム統計、コネクタメトリクス
* **初回セットアップウィザード**: ガイド付き管理者アカウント作成
* **Personal Center**: ユーザーごとのグローバル指示、言語設定
* **JWT 認証**: トークンベースの SSE 認証、会話の所有権
* **Global MCP servers**: 管理者がプロビジョニング、すべてのセッションで読み込み
* **後方互換性**: registration\_enabled → registration\_mode 自動マイグレーション

### v0.7.x (2026-03-07 to 2026-03-12) — Stability + Refinements

* 招待コード管理
* ユーザーごとのクォータ (429 強制実行)
* 構造化監査ログ
* 機密ワードフィルタリング
* 管理者ログイン履歴
* 管理者ファイルブラウザ
* 強化された管理者ビュー (model\_name、tools、kb\_ids フィールド)
* Docker Compose デプロイメント (単一イメージ、名前付きボリューム)
* OAuth 自動検出 (window\.location から)
* 拡張思考 / 推論サポート (`LLM_REASONING_EFFORT`、`LLM_REASONING_BUDGET_TOKENS`) — OpenAI o シリーズ、Gemini 2.5+、Claude 対応
* 管理者ツール単位の有効/無効切り替え (無効なツールはチャット実行時に除外)
* MCP サーバー管理を Connectors ページに移動
* デュアルデータベースサポート: SQLite (ゼロコンフィグデフォルト) + PostgreSQL (本番環境); Docker Compose が PostgreSQL を自動プロビジョニング
* モデル設定ドキュメントページ (プロバイダーごとの拡張思考セットアップ付き)
* SSE Protocol v2: リアルタイム回答ストリーミング (`delta_reasoning`、`usage` フィールド、`done`/`suggestions`/`title`/`end` イベント分割); SQLite プール サイズ 5 -> 20
* AI Builder 拡張: 7 つの新しいビルダーツール (GetSettings、TestConnection、ImportOpenAPI (コネクタ向け); ListConnectors、AddConnector、RemoveConnector、SetModel (エージェント向け))、エージェント上の `is_builder` フラグ、ビルダープロンプト自動更新、SSRF ガード
* SSE v2 フロントエンド: ストリーミングドット パルスカーソル、DAG 再計画ラウンドスナップショット (折りたたみ可能カード)、DAG レイアウト (ステップ状態から分離)
* AI Builder コンセプトドキュメントページ (コネクタおよびエージェントビルダーガイド付き)
* 組織システム: 完全な CRUD とロールベースメンバーシップ (所有者/管理者/メンバー)、管理者管理 UI
* 3 段階リソース可視性 (個人/組織/グローバル) — エージェント、コネクタ、ナレッジベース、MCP サーバー
* すべてのリソースタイプの公開/非公開 API; 公開エージェントの所有者委譲
* 管理者設定可視性エンドポイント (クローン・トゥ・グローバルを置き換え); 統一された `build_visibility_filter()` クエリヘルパー
* データベースコネクタ (フェーズ 1-3): PG/MySQL/Oracle/SQL Server + 中国レガシー DB への直接 SQL アクセス; スキーマ内省、AI 注釈、読み取り専用クエリ実行、暗号化された認証情報、コネクタごと 3 ツール (`list_tables`、`describe_table`、`query`)
* **評価センター**: 定量的エージェント品質ベンチマーク — テストデータセット CRUD (プロンプト + 期待される動作 + アサーション)、評価実行 (並列実行 + LLM グレーダー + ケースごとの合格/不合格/レイテンシ/トークン結果)、自動ポーリング付き結果ビューア; マイグレーション `r8t0v2x4z567`
* 3 つのモデルロール (General/Fast/Reasoning) — ティアごとの環境設定分離; 高速モデルはメインモデル設定を継承しない
* `StepOutput` データクラス (プレーンテキストステップ結果を置き換え) — 構造化データとアーティファクト受け渡し
* DAG 実行用ツールキャッシュ — 実行ごとに同一ツール呼び出しをキャッシュ (非同期ロック スタンピード防止付き) (`DAG_TOOL_CACHE`)
* ステップごとの LLM 検証 (失敗時 1 回再試行) (`DAG_STEP_VERIFICATION`)
* 自動ルーティング: 高速 LLM がクエリを ReAct または DAG に分類; `/api/auto` エンドポイント; フロントエンド 3 方向モード切り替え (`AUTO_ROUTING`)
* [x] ~~**Shadow Market Organization + Resource Subscriptions**~~: 組み込み Market org (シャドウ、自動参加なし) が Platform org を置き換え; リソースはマーケットプレイス閲覧経由で発見され明示的にサブスクライブ (プルモデル); Market API (共有リソースへのサブスクリプション); Market への公開は常にレビュー必須; リソースサブスクリプションテーブル; グローバル可視性を置き換える org ベースリソース共有
* [x] ~~**Agent Auto-discovery and Sub-agent Binding**~~: エージェント上の `discoverable` フラグ; `sub_agent_ids` ホワイトリスト; CallAgentTool (スペシャリストエージェントへのタスク委譲)
* [x] ~~**MCP Server Credentials + Per-User Override**~~: `mcp_server_credentials` テーブル; `PUT /api/mcp-servers/{id}/my-credentials` エンドポイント; 認証情報フォールバック動作用 `allow_fallback` フラグ
* [x] ~~**Connector/KB Toggle**~~: `POST /api/connectors/{id}/toggle` および `POST /api/knowledge-bases/{id}/toggle` (リソースの一時停止/再開)
* [x] ~~**Standalone KB Conversations**~~: 会話上の `kb_ids` フィールド (エージェントバインディングなしの直接 KB チャット)

### v0.8 (2026-03-20) — Connector Declarative Config + Progressive Disclosure

* [x] **Database connectors**: direct SQL access (PostgreSQL, MySQL, Oracle) *(shipped in v0.7.x — Phase 1-3)*
* [x] **RBAC**: per-user/role connector access control *(shipped in v0.7.x — org system + three-tier visibility)*
* [x] **Connector credential encryption + per-user override**: `connector_credentials` table, Fernet encryption via `CREDENTIAL_ENCRYPTION_KEY`, `allow_fallback` flag, `GET/PUT/DELETE /my-credentials` endpoints, per-user credential resolution in chat tool loading
* [x] **Publish review UI**: Org-level publish review system — review toggle per org, ReviewsSheet with approve/reject workflow, status badges on resource cards, review notice in publish dialog, resubmit for rejected resources
* [x] **Connector Progressive Disclosure (Phase 1-2)**: single `ConnectorMetaTool` replaces per-action tools; system prompt receives lightweight **stubs** only (name + 1-line description, \~30 tokens/connector vs \~250 tokens/action); agent calls `discover(connector)` to load full action schema on demand — schema only loads when the model selects a connector, keeping the prompt prefix stable for caching. Follows the deferred tool-loading pattern common in modern agent frameworks. `execute` subcommand; feature flag for backward compatibility.
* [x] **Agent Skill System + Compact Instructions**: On-demand skill loading for agent instructions — `Skill` model (name, content/SOP, optional scripts) attached to agents; referenced in system prompt by name only (\~10 tokens/skill); agent calls `read_skill(name)` to load full content on demand. Reduces per-conversation instruction token cost by \~80% while allowing richer SOP libraries. Counterpart to ConnectorMetaTool's progressive disclosure applied at the instruction level. Enables the "指令 + 工具 + 技能" differentiation story. Also adds `compact_instructions` field to Agent model — per-agent compression priority list injected into `ContextGuard` when compacting (e.g., "preserve order IDs and amounts, drop raw API responses"), replacing the current static generic prompt. Follows the Compact Instructions convention widely adopted in modern agent frameworks.
* [x] **Connector import/export**: share connector templates
* [x] **Connector fork**: clone + customize existing connectors
* [x] **Workflow Phase 2 Nodes**: Iterator, Loop, VariableAggregator, ParameterExtractor, ListOperation, Transform, DocumentExtractor, QuestionUnderstanding, HumanIntervention — 9 advanced node types with full frontend + backend + 150 new tests (275 total). Node retry with exponential backoff, safe expression evaluation. Stats panel with success rate bar. 12 built-in templates. Pane context menu (Paste, Select All, Fit View, Auto Layout).
* [x] **Workflow Phase 3 Nodes: SubWorkflow + ENV** — 2 new node types (25 nodes total), 14 new tests (306 total), 14 built-in templates. SubWorkflow: full DB-backed nested workflow executor with target workflow selection, variable mapping, and configurable depth limit to prevent infinite recursion. ENV: reads encrypted environment variables with key picker and fallback defaults. Full frontend (node components, config panels, palette entries, minimap colors). Per-node execution statistics panel (success rates, durations, failure counts sorted worst-first). `getNodeStats` API client + `NodeStatEntry` type. Keyboard shortcuts dialog (`?` key).
* [x] **Workflow Scheduled Triggers**: Per-workflow cron configuration with timezone, default inputs, and next-run-at calculation. Preset cron buttons, 30 trigger tests.
* [x] **Workflow API Triggers**: Public per-workflow API keys (`wf_` prefix) for external execution without user auth, with rate limiting. API key management dialog with generate/regenerate/revoke, trigger URL, and cURL/JS examples.
* [x] **Workflow Batch Execution**: `POST /batch-run` with up to 100 input sets, configurable parallelism (1-10), collapsible per-item results, JSON export. 14 batch execution tests.
* [x] **Workflow Execution Log Viewer**: Real-time chronological SSE event stream in the run panel with timestamps, color-coded badges, and event type filter toggles.
* [x] **Workflow Run Stats**: Backend batch-fetches run counts and success rates via GROUP BY subquery; frontend displays stats on workflow cards with color-coded success rate indicators.
* [x] **Workflow Scheduler Daemon**: Background async service polling every 60s for due cron-based workflows. Croniter timezone support, semaphore concurrency, `last_scheduled_at` tracking, webhook delivery. 14 tests.
* [x] **Workflow Import Conflict Resolver**: Detects unresolved agent/connector/KB/MCP references during import. Batch DB queries with visibility filtering, frontend toast warnings. 17 tests.
* [x] **Workflow Test-Node Execution**: Isolated single-node testing with mock variables, integrated into editor (config panel Test button + context menu). 23 tests.
* [x] **Workflow Version Diff**: Side-by-side blueprint comparison with node/edge change detection, color-coded indicators (added/removed/modified).
* [x] **Workflow Run Management**: Delete individual runs (`DELETE /runs/{run_id}`) and clear all completed runs (`DELETE /runs`), with frontend confirmation dialogs.
* [x] **Workflow Run Replay Overlay**: "View on Canvas" button in run history to overlay past execution results on the canvas, showing per-node status and output without re-executing.
* [x] **Workflow Favorites/Pinning**: Star/pin workflows to the top of the list with localStorage persistence.
* [x] **Workflow Run History Export**: Export run history as JSON file download with full run metadata and per-node results.
* [x] **Admin Workflows Management**: Admin panel tab for managing all workflows across users — list, toggle active/inactive, delete with confirmation. Batch endpoints for delete, toggle, and publish with audit logging.
* [x] **Workflow Templates System**: `WorkflowTemplate` ORM model with admin CRUD, public listing/clone API, and 5 seed templates auto-inserted on first startup.
* [x] **Workflow Inline Validation Badges**: Real-time per-node `ValidationBadge` on canvas with error/warning tooltips for immediate visual feedback during editing.
* [x] **Workflow Execution Trace Viewer**: Timeline-based trace viewer Sheet with engine `trace_level` parameter and per-node variable snapshots for step-through debugging.
* [x] **Workflow Rate Limiting and Timeout**: Per-user `WorkflowRateLimiter` (sliding window 10 runs/min, 3 concurrent) and default 10-minute global run timeout.
* [x] **Workflow Blueprint System**: Visual workflow editor for designing and executing multi-step automation blueprints — `Workflow` / `WorkflowRun` ORM models, full CRUD + SSE execution API, import/export, duplicate, blueprint validation endpoint, `WorkflowEngine` with topological sort + semaphore-based concurrency + condition branching and 12 node types (Start, End, LLM, ConditionBranch, QuestionClassifier, Agent, KnowledgeRetrieval, Connector, HTTPRequest, VariableAssign, TemplateTransform, CodeExecution), `VariableStore` with `{{node_id.output}}` interpolation and `env.*` namespace, error strategies per node (STOP\_WORKFLOW / CONTINUE / FAIL\_BRANCH) with per-node timeout and advanced config UI, React Flow v12 visual editor with drag-and-drop palette + node config panel + variable picker combobox + add-node-on-edge + auto-layout (ELK.js) + run history sheet, Dify-style compact node design with ring-based run status styling and animated edge transitions, 4 built-in starter templates (Simple LLM Chain, Conditional Router, Knowledge-Augmented QA, HTTP API Pipeline) with template picker dialog and `GET /templates` + `POST /from-template` API, stats endpoint, `?run=true` URL param auto-open, subprocess-based code execution security, 105-test suite (templates, eval namespace flattening, blueprint validation warnings, node/edge deletion, import/export/duplicate, deadlock detection, multi-condition branching)
* [x] **Operation audit**: detailed logging of who did what — admin review log audit tab added (publish review trail per org/resource)
* [x] **Semantic Schema Annotations**: extend connector schema fields with `semantic_tag`, `description`, and `pii` flags; annotations surfaced in LLM tool descriptions so the agent understands field intent without guessing from column names

### v0.8.1 (2026-03-29) — プログレッシブディスクロージャー成熟度 + ReAct強化

* DB コネクタ（`DatabaseMetaTool`）、MCP サーバー（`MCPServerMetaTool`）、オンデマンドツール読み込み（`request_tools` メタツール）のプログレッシブディスクロージャー
* DAG 品質全面改善（5 つの改善：モデルアップグレード、スキル自動検出、引用検証、構造化コンテンツ保持、ドメイン対応ルーティング）
* ReAct でのドメインモデルエスカレーション（専門ドメインが推論モデルに自動エスカレーション）
* モデル別ネイティブ関数呼び出しトグル（`tool_choice_enabled`）
* ReAct サイクル検出（決定論的な重複ツール呼び出し防止）
* ReAct 完了チェックリスト（ツール使用時の事前回答検証）
* リソースフォークフェーズ 1（系統追跡付き MCP サーバー + スキルフォークエンドポイント）
* ワークフロー接続依存関係自動サブスクライブ（再帰的なサブワークフロー依存関係解決）
* プリビルトソリューションテンプレート（初回登録時にマーケットにシード済みの 8 つの業種別ソリューション）
* 管理者通知改善（タイムゾーン対応、マスタースイッチ、SMTP Reply-To）
* ターンごとのトークン予算サーキットブレーカー（`REACT_MAX_TURN_TOKENS`）
* 一元化されたツール切り詰め、動的システムプロンプト予算配分
* ファイル添付ダウンロード、重複メッセージ送信修正

### v0.8.2 (2026-04-10) — エージェントコア強化 + ビジョンドキュメント

* **エージェントコア フェーズ 0** — コンパクトプロンプトが9セクション構造化フォーマットにアップグレード；空のツール結果保護（`(no output)` の代わりに説明的メッセージ）；ループ防止プロンプト + サイクル検出閾値を2に低下；ドメイン分類器 + プリフライトDB設定解決の並列化（リクエストあたり400～1100ms削減）；SSE `end` イベントが回答直後に送信、タイトル/提案はバックグラウンドタスクに移動
* **エージェントコア フェーズ 1（コンテキスト アンチブロート）** — `MicroCompact` ルールベースの古いツール結果クリーンアップ（最後の6件を保持）；`REACT_TOOL_RESULT_BUDGET=40000` 集計上限；コンテキストオーバーフロー時のリアクティブコンパクト（クラッシュの代わりに自動的に予算の50%にコンパクト化して再試行）
* **エージェントコア フェーズ 2（速度）** — キーワードベースのツール事前選択（明らかなマッチではLLM呼び出しをスキップ、200～500ms削減）；`SharedHttpClient` LLM接続プーリング；200トークン以上の回答では完了チェックをスキップ；`FallbackLLM` がプライマリ+高速をラップし、429/503/529/接続エラーで自動フェイルオーバー
* **インテリジェントドキュメント処理（ビジョン対応）** — 適応的ドキュメント処理：PDFページはビジョン対応モデル（GPT-4o、Claude 3/4、Gemini）向けにPyMuPDFで画像としてレンダリング、テキストのみフォールバックはpdfplumberで実行。モデルごとの `supports_vision` フラグ。`DOCUMENT_PROCESSING_MODE`、`DOCUMENT_VISION_DPI`、`DOCUMENT_VISION_MAX_PAGES` 経由のモード。DOCX/PPTX埋め込み画像抽出。会話ターン間のマルチターンビジョン永続化。スマートPDF処理（テキスト豊富なページはテキスト+画像を抽出；スキャンされたページはフルページPNGとしてレンダリング）。`--network=none` コード実行用の一般的なデータサイエンスパッケージを含むプリビルトサンドボックスイメージ（`Dockerfile.sandbox`）
* **リソースフォーク完了** — エージェント / コネクタ / ワークフロー フォークエンドポイント追加、5タイプ系統追跡完成（KBフォーク削除——本質的にユーザーローカル）
* **ファイル整合性ガードレール** — システムプロンプトルールはターゲットファイルが読み取り不可の場合、エージェントが無関係なファイルコンテンツを代替することを防止；アップロードされたファイルはメッセージコンテキストに `file_id` を含み、直接 `read_uploaded_file` アクセスが可能

### v0.8.3 (2026-04-16) — ユニバーサルドキュメント変換 + エージェントコア フェーズ 3

* **ユニバーサルドキュメント変換（`convert_to_markdown` + OCR）** — Microsoft MarkItDown をラップした組み込みエージェントツール。PDF、Word、Excel、PowerPoint、HTML、JSON、CSV、XML、ZIP、EPUB、Outlook .msg、画像、オーディオ、YouTube URL を Markdown に変換します。`LiteLLMOpenAIShim` は任意のビジョン対応 LLM（Claude、Gemini、Bedrock、Azure）経由で OCR を有効にします。ビジョン対応 RAG インジェスチョンとテキストのみのフォールバック（回帰なし）。`LLM_SUPPORTS_VISION` 環境変数でオプトアウト可能
* **エージェントコア フェーズ 3（ランタイム不変性の強化）** — 会話復旧（ぶら下がり `tool_use` の自動修復）；構造化コンパクトワークカード（圧縮ラウンド全体での `WorkCard` 型マージ）；ターンレベルプロファイラー（`REACT_TURN_PROFILE_ENABLED`）；ユーザーごとのレート制限（`LLM_RATE_LIMIT_PER_USER`）；`tool_calls` を含む空のコンテンツアシスタントメッセージはドロップされなくなりました

### v0.8.4 (2026-04-17) — プロンプトキャッシュ + 推論正確性

* **システムプロンプトセクションレジストリとキャッシュブレークポイント** — メモ化された `PromptRegistry` はシステムプロンプトを安定したプレフィックス + 動的サフィックスに分割します。キャッシュ対応プロバイダー（Claude、Bedrock Anthropic、Vertex Claude）は、プレフィックスに `cache_control: {"type": "ephemeral"}` を受け取り、ターンあたりの入力トークン削減率は約60～80%です。キャッシュ非対応プロバイダーは単一の連結メッセージを取得します（動作変更なし）
* **プロンプトキャッシュの可観測性** — `cache_read_input_tokens` と `cache_creation_input_tokens` は `UsageSummary` → `TurnProfiler` → `done_payload.cache` フィールドを通じて追跡されます。ターンごとに構造化された `turn_cache` ログ行。リレーキャッシュ正当性プローブとしても機能します
* **会話復旧MVP** — 合成 `tool_result` 行は中断されたターン後に永続化されます。`POST /chat/resume` はモノトニックカーソルからキャッシュされたSSEイベントを再生します。フロントエンド `useSseResume` フックは指数バックオフ（300ms → 1s → 3s、最大3回試行）で自動的に再接続し、「再接続中…」インジケーターを表示します
* **署名付き思考ブロック永続化** — `reasoning_content` + Anthropic `signature` は `metadata_["thinking"]` に永続化され、後続のターンで再生されます。Claude 4マルチターン会話でのHTTP 400署名不一致を修正します
* **プロバイダー対応の推論再生ポリシー** — `core/prompt/reasoning.py` の集中化された `reasoning_replay_policy()` はプロバイダーファミリーごとにシリアル化をゲートします。Claudeは署名付きの思考ブロックを再生します。DeepSeek-R1/Qwen-QwQ/Gemini-thinking/o系列は、アウトバウンドで `reasoning_content` をドロップします（以前はリークしており、プロバイダーKVキャッシュを破損させ、APIドキュメントに違反していました）

### v0.8.5 (2026-04-23) — Channel Integration + Hook System + Contributor i18n

* **Feishu Channel (Phase 1 subset)** — Org-scoped `Channel` リソースと Fernet 暗号化認証情報；`FeishuChannel` はインタラクティブカード送信 + コールバック（署名検証 + URL チャレンジ）をサポート；Settings → Channels 管理 UI（リスト、ダーティ状態保護付きの作成/編集、コピー可能なコールバック URL 付きの詳細、テスト送信）；CRUD API（`/api/channels`）とイベントコールバックエンドポイント（`/api/channels/{id}/callback`）。2026-04-24 路演向けに早期リリース
* **Agent Hook System（ReAct + DAG ランタイムで稼働中）** — `src/fim_one/core/hooks/` 内の `PreToolUseHook` / `PostToolUseHook` 抽象化；`model_config_json` で `hooks.class_hooks` を宣言するエージェントは、チャットセッションごとにフックがインスタンス化および登録されます。最初のコンシューマー `FeishuGateHook` は、エージェントが `requires_confirmation=True` ツールを呼び出すときにリンクされた Feishu グループに承認/却下カードを投稿し、実行をブロックし、判定に基づいて再開または中止します
* **設定可能な確認ゲート（インラインまたはチャネル）** — すべてのエージェントは承認セクションを取得し、3 つのルーティングモード（自動 / インラインのみ / チャネルのみ）、承認者スコープセレクター（イニシエーター / 所有者 / 組織内の誰でも）、ツール単位のオーバーライド、および明示的な承認チャネルピッカーがあります。自動モードは、チャネルがリンクされていない場合、インラインの承認カードに適切にフォールバックします。`POST /api/confirmations/{id}/respond` は Feishu webhook との単一の決定記録パスを共有します
* **エージェント単位のタスク完了通知** — 長時間実行される ReAct または DAG エージェントは、タスク完了時に組織のチャネルにサマリーカードをプッシュできます。汎用アウトバウンド通知パターンの最初のコンシューマー
* **Hook Approval Playground** — Channels 詳細シートには「Test Approval Flow」アクションがあり、完全な本番パス（本物の `ConfirmationRequest` 行、実際の Feishu コールバック、ステータス遷移）を実行します——本番フックが使用するのと同じコードパス
* **Contributor フレンドリーな i18n CI フォールバック** — `.github/workflows/i18n-sync.yml` は PR マージ後にマスター上で EN → ZH/JA/KO/DE/FR に翻訳し、`[skip ci]` で自動コミットします；貢献者はもはやローカルで `LLM_API_KEY` を必要としません。プリコミットロケール編集ガードは生成されたロケールファイルへの手動編集を拒否します（正当な翻訳修正のための `ALLOW_LOCALE_EDIT=1` オーバーライド）。スモークテストプッシュで検証済み
* **Exa 統合ドキュメント** — 専用の Integrations セクションと、完全な Exa 検索サーフェス（neural / fast / deep-reasoning / instant）、フィルタリング、コンテンツ取得、および 3 つのチューニング済みプリセットをカバーする第一級の Exa ページ
* **Xinchuang (信創) データベースサポート** — Database Connector は PostgreSQL/MySQL と並んで KingbaseES (人大金仓)、HighGo (瀚高)、DM8 (达梦) をリストします。PG 互換ドライバーは `asyncpg` を再利用；DM8 は `dmPython` を使用します。`scripts/test_xinchuang_dbs.py` は CLI からのライブ接続を検証します
* **Channels + Hook System アーキテクチャドキュメント** — `docs/architecture/hook-system.mdx` は 3 つのフックポイントを説明し、FeishuGateHook をエンドツーエンドで説明します；既存のアーキテクチャページはクロスリンク；README は Messaging Channels を第一級の機能としてリストします
* **強化** — 重複する Feishu コールバッククリックは二重決定の代わりに置換カードを生成；並行コールバッククリックは条件付き `UPDATE ... WHERE status='pending'` 行数チェックで解決；保留中の承認は `CHANNEL_CONFIRMATION_TTL_MINUTES`（デフォルト 24h）後にバックグラウンドスイーパーで自動有効期限切れ；Settings → Channels は組織ロールを尊重（メンバーは読み取り専用 UI を表示）；並行ツール呼び出しアグリゲーターは、すべてのデルタに対して `index=0` を再利用するプロバイダーを処理；セッション有効期限リダイレクトはクエリ文字列を保持

### v0.8.6 (2026-05-08) — Stripe 請求 + 改善

* [x] Stripe 請求 MVP — Free + Pro ティア; Checkout、Customer Portal、webhook ライフサイクル; `/settings?tab=billing`; 管理者プラン/サブスクリプション CRUD; クォータ強制は各ユーザーのプランを尊重
* [x] 管理者制御の請求機能フラグ — `system_settings.billing_enabled` は Stripe パイプライン全体をゲートするため、Stripe 認証情報のないプライベートデプロイメントは機能しない支払い UX を表示しません
* [x] ユーザーごとの無制限クォータ — 空は グローバルデフォルトを継承、`0` は無制限を付与; 以前は両方が同じ状態に折りたたまれていました
* [x] 翻訳用語集を単一の情報源として — `scripts/translation-glossary.md` はロケール別ルールを統合; pre-commit は生成されたロケールファイルへの手動編集を無条件に拒否
* [x] ライセンス + 準拠法を FIM Labs Pte. Ltd. (シンガポール) に移行; SIAC 仲裁は英語; 新しいトップレベル `NOTICE` ファイル
* [x] Playground フォローアップ提案を復元、エージェントごとのオプトイン
* [x] 安定性修正 — strict-alternation プロバイダー履歴、並列ツール呼び出し境界検出、無制限エージェント確認フロー、チャネルロールゲーティング、再試行重複抑制、拒否後の言い換えなし

### v0.8.7 (2026-06-10) — セキュリティ強化 + ガードレール v0 + 請求の正確性

* [x] JWT トークンタイプ制限 — 同じ署名のトークン（temp/refresh/ticket）が API と SSE エンドポイントを認証できる 2FA バイパスを修正
* [x] OAuth 強化 — メール自動リンクはプロバイダー検証済みメール（アカウント乗っ取り対策）が必須に；OAuth リフレッシュトークンはハッシュ化して保存され、セッションローテーションが機能
* [x] コンテンツガードレール v0 — 入出力トリップワイヤーレイヤー（`core/agent/guardrail`）；ジェイルブレイク検出器と最大長出力ガードレールを搭載、環境変数で設定可能
* [x] `file_ops.apply_patch` — V4A 差分パッチ（ファジー空白マッチング対応）、`find_replace` を補完
* [x] 請求サイクルの正確性 — クォータはサブスクリプション記念日にリセット（カレンダー月ではなく）；更新は Stripe の信頼できるルックアップで期間を進める；使用状況表示は強制ウィンドウに合わせる
* [x] 信頼性の改善 — 疑似プロトコルツール呼び出しリークを回答から削除；調整可能な HTTP キープアライブで `APIConnectionError` バーストを終了；API キー使用統計は読み取り専用リクエストで永続化
* [x] 請求タブのビジュアルオーバーホール — フルワイド、他の設定タブと一貫性を保つ

### v0.8.8 (2026-06-22) — SSRF強化 + 信頼性と推論の修正

* [x] SSRF強化 — ブロックリストがIPv4マップIPv6（`::ffff:` インスタンスメタデータバイパス）をアンラップ；MCP SSE/Streamable-HTTPサーバーURLはSSRF検証を作成時と接続時に実施
* [x] LLM信頼性 — 共有HTTPプールはLiteLLMクライアントキャッシュ削除後に自己修復；チャットはストリームを即座に送信（履歴はバックグラウンドで折りたたみ、フル再読み込みなし）
* [x] Anthropic適応思考プロトコル（Opus 4.6+/Sonnet 4.6/Fable 5対応） — 拡張思考は旧固定予算パラメータの4.7/4.8での400エラーを解決；OpenAIプロキシ誤ルーティングで警告
* [x] 推論詳細がエンドツーエンドで保持 — 真の最終回答がそのままストリーム配信；圧縮、コンテキスト再構築、サブエージェントステップを経ても保持（ロッシーな再合成なし）
* [x] PreToolUse強制フック — エラー時にフェイルクローズ；クラッシュした確認闸門はもう呼び出しをサイレント許可しない；非強制フックは`fail_open`経由でフェイルオープンを維持
* [x] Force-logoutタイムスタンプ比較をUTC変換で正規化 + Docker Compose `POSTGRES_*` 認証情報オーバーライド（デフォルトの`fim:fim`は非搭載）

### v0.8.9 (2026-07-08) — モジュール スリムダウン + 共有の収束 + 承認の強化

* [x] スキルとワークフロー — 管理者モジュールフラグの背後にソフトシェルフ化（デフォルトオフ）、コアのみブート、削除なし、管理者 → 設定 → モジュールから復元可能
* [x] 共有の収束 — KB共有を削除（KBは共有エージェント経由でのみ他者に到達）、DBコネクタは共有不可 + 生SQL所有者のみ、ワークフロービルダーは参照のみの9ノードに削減
* [x] Feishu承認の強化 — カードクリックは承認者アイデンティティを強制、コールバック署名は失敗クローズ + 暗号化エンベロープは復号化、承認は意図しないチャットにルーティングされない
* [x] 使用時アクセス再確認 — 共有MCP サーバーとバインド済みKBは実行ごとに再検証、組織を離れるとサブスクリプションと保存済み認証情報は即座に失効
* [x] エージェントループの強化 — プランボード、バックグラウンドツール、段階的DAG再計画 + チェックポイント再開、圧縮はツールペアリング維持、切り詰め継続、529/504リトライ
* [x] `run_workflow` エージェントツール + ワークフロー正確性 — エージェントノードは完全なエージェントを実行、確認ゲートは失敗クローズ、コネクタ呼び出しはアクセス確認と監査ログ
* [x] アカウント削除の統一 — 管理者とセルフサービスは1つのパージルーチンを通じて、すべてのレコードとディスク上ファイルをカバー、組織所有者は最初に所有権を譲渡する必要がある
* [x] 所有者認証情報フォールバックはオプトイン化（破壊的変更） — コネクタ/MCP サーバーはデフォルト `allow_fallback` オフ、既存行は反転、認証情報がないノーフォールバックリソースはツールセットから非表示
* [x] Webhook/cronワークフロー実行は所有者のトークンクォータに制限 — 無制限の無料LLMトリガーパスは閉鎖
* [x] リソースバインディングは可視性で統一 — サブスクライブ済みコネクタ/KB/MCP サーバーはエージェントにバインド可能、ワークフローコネクタステップは実行者のアクセスを強制
* [x] 会話ワークスペースはチャットに配線 — `workspace://` 超大型ツール結果のオフロード、予算切り詰め救済、圧縮前トランスクリプトスナップショット

## 計画されたバージョン

2026-07-08に再計画：FIM Oneはエージェントランタイムです——1つのカーネル（ReActエンジン、認証情報、確認ゲート、監査、マルチテナント組織）が複数の配信サーフェスの背後にあります：Web UI、API、JS埋め込み、MCP出力。すべてのサーフェスは認証、認証情報、承認、メータリングのための同じアセンブリレイヤーを再利用します：より多くのフロントエンド、ロジックはありません。短期的な方向性はデータQ\&A（ChatBI）スライスへの収束であり、プラットフォームではなくシナリオを販売することです。{/* dev: dev/replan-2026-07.md */}

### v0.9 — Connector Fences + Scenario Onboarding

**目標**: ポストリデュース資産が完全なデータQ\&A製品に組み立てられます——読み取り専用DBコネクタ + フェンス + 承認ゲート + IM エントリ。Tier-1フェンスがセキュリティ負債を製品機能に変えます。

#### DB Connector Fences — Tier 1, three PRs {/* dev: dev/connector-rbac/00-overview.md */}

* [ ] PII列の難読化（`ConnectorScopeGuard` PreToolUseフック）
* [ ] スキーマの可視性——テーブル/列の許可・拒否リスト + 動詞ブロッキング（読み取り専用の強制）
* [ ] フェンスの監査可能性——`ConnectorCallLog`内の`caller_user_id`、`effective_credential_source`、`scope_rules_applied`
* [ ] フックごとの設定パススルー（`{"name", "config"}`スキーマ）——ScopeGuardルールのキャリア {/* dev: dev/hook-system.md */}
* [x] 委譲全体での承認ゲート——`call_agent`とワークフロー`AGENT`ノードはエージェント自身のフックを実行（なしではなく）

#### シナリオオンボーディング

* [ ] 初回実行は空のワークベンチではなく、シナリオテンプレート（solution\_seeds）から開始する
* [ ] ドキュメントランディングページは、モジュールリファレンスではなく、3つの縦型シナリオストーリーで始まる
* [ ] 配信されたエンゲージメントごとに1つのシナリオテンプレートを抽出する——競争優位性はシナリオアセット×配信速度である

### v0.10 — Two Mouths: JS Embed + IM Inbound {/* dev: dev/im-channels.md */}

**Goal**: 最も販売可能な2つの配信サーフェス、同じカーネルとアセンブリレイヤー上で実現。

* [ ] JS bubble / iframe embed — ホストシステムへの単一スニペット; 匿名訪問者のアイデンティティと課金属性はビルド前に決定
* [ ] Feishu inbound @mention — エージェントがグループ内に存在: データクエリ、ファイル承認、フロー追跡
* [ ] アウトバウンドパターン: 障害アラート、予算警告、スケジュール済みダイジェスト、エスカレーション、監査レシート
* [ ] Feishuに続くWeCom / DingTalkチャネル

### 保留中 — 信号门控

不要在没有触发器的情况下启动这些功能（见重新规划 §3）：MCP 网关等待 ≥2 个主动的"在我的智能体中挂载你的工具"请求；通道化等待实现者提出许可问题；IdP/OrgSync 等待客户拉取；其余的等待需要它们的已交付参与。

* [ ] MCP 网关输出 — 反向暴露连接器发现/执行为下游智能体的 MCP 工具
* [ ] 通道化 / 白标启用 — 商业许可证路径已就位
* [ ] 身份提供商模块 + 通道精简 — Feishu SSO、组织图同步 {/* dev: dev/connector-rbac/07-identity-providers.md */}
* [ ] 连接器授权第 2 层（要求按用户凭证、密钥绑定健康检查）+ 第 3 层（登录票证交换） {/* dev: dev/connector-rbac/00-overview.md */}
* [ ] 公共 API 第 2 阶段 — 按密钥速率限制/配额、版本控制、SDK、开发者门户 {/* dev: dev/public-api-phase2.md */}
* [ ] 可观测性 — 智能体追踪层（追踪/跨度模型、时间线查看器、OTel 导出）+ 指标仪表板 {/* dev: dev/agent-trace-layer.md */}
* [ ] 智能体工作区剩余部分 — 交接笔记、文件浏览器 UI、跨会话回忆、压缩段（智能体读回的可搜索磁盘摘要） {/* dev: dev/agent-workspace.md */}
* [ ] 护栏 v1 — 离题过滤、PII 编辑器输出护栏、按智能体护栏配置 UI
* [ ] 钩子系统扩展 — 内置钩子、`SessionStart` + 用户 YAML 钩子 {/* dev: dev/hook-system.md */}
* [ ] 连接器平台深度 — 渐进式披露第 3-4 阶段、YAML/JSON 连接器配置、数据库连接器第 4 阶段（Oracle / SQL Server / GBase）、MCP 连接池
* [ ] 提示词缓存后续 — Gemini 上下文缓存适配器、按智能体 `cache_ttl` {/* dev: dev/prompt-cache-followups.md */}
* [ ] 热中流 DAG 恢复 — SSE 重新连接重新附加到运行中的轮次（冷重试-恢复已发布） {/* dev: dev/incremental-dag.md */}
* [ ] 生态系统 — 计划/事件触发的智能体、工作流触发身份可观测性、按工作流 `credential_policy`、数据库架构高级构建器、沙箱加固 v2

### v0.9 プリプラン出荷済み

* [x] ~~認証とセキュリティ: JWT トークンタイプ制限 + OAuth 修正 (v0.8.7); PG タイムゾーン対応タイムスタンプ (v0.8.6); 強制ログアウト UTC + `POSTGRES_*` オーバーライド + SSRF IPv6 マップ修正 (v0.8.8); オーナーフォールバック オプトイン + 可視性統一バインディング + webhook/cron メーリング (v0.8.9)~~

* [x] ~~プロバイダー互換性: Anthropic 適応推論 + 共有 LLM プール自己修復 (v0.8.8)~~

* [x] ~~コンテンツガードレール v0: トリップワイヤレイヤー + ジェイルブレイク検出器 (v0.8.7)~~ {/* dev: dev/archive/openai-agents-insights.md */}

* [x] ~~フック システム: スケルトン + FeishuGateHook + 承認演練場 + ReAct/DAG ランタイム (v0.8.5); PreToolUse 強制フェイルクローズ (v0.8.8)~~

* [x] ~~Feishu 通道 Phase 1 + タスク完了通知 (v0.8.5)~~

* [x] ~~`run_workflow` 智能体ツール (v0.8.9); 推論詳細エンドツーエンド保持 (v0.8.8); ワークスペース ツール出力オフロード チャットに配線 (v0.8.9)~~

* [x] ~~智能体ループ強化: プランボード、LLM コール復元力、バックグラウンドツール、段階的 DAG 再プラン + チェックポイント再開、圧縮ツールペアリング (v0.8.9)~~ {/* dev: dev/incremental-dag.md */}

* [x] ~~サーキットブレーカー、ワークフロー実行保持クリーンアップ、ワークフロー バージョン差分サマリー~~ *(v0.8 / v0.8.1)*

* [x] ~~DAG 品質オーバーホール、ドメインモデル エスカレーション、モデルごと NFC トグル~~ *(v0.8.1)*

* [x] ~~DatabaseMetaTool、MCPServerMetaTool、オンデマンド `request_tools`~~ *(v0.8.1)*

* [x] ~~ワークフロー接続依存関係 自動サブスクライブ、ワークフロー実エグゼキューター~~ *(v0.8.1)*

* [x] ~~ReAct サイクル検出、完了チェックリスト~~ *(v0.8.1)*

* [x] ~~プリビルト ソリューション テンプレート (8 垂直バンドル)、リソース フォーク (MCP/スキル/智能体/コネクタ/ワークフロー)~~ *(v0.8.1)*

* [x] ~~ビジョン ドキュメント処理 (PDF / DOCX / PPTX)、MarkItDown OCR~~ *(v0.8.2 / v0.8.3)*

* [x] ~~スマート ファイル コンテンツ インジェクション + `read_uploaded_file`~~ *(v0.8)*

* [x] ~~智能体 コア Phase 3: 会話復旧 MVP、コンパクト ワーク カード、ターン プロファイラー、ユーザーごと レート制限~~ *(v0.8.3)*

* [x] ~~会話再開 MVP、システムプロンプト レジストリ + キャッシュ、思考ブロック 永続化、推論リプレイ ポリシー、キャッシュ 可観測性~~ *(v0.8.4)*

### v1.0 — ホットプラグ + 埋め込み可能

**目標**: ゼロ再起動のコネクタ追加、パッケージエコシステム、および埋め込み配信。

* [ ] **コネクタプログレッシブディスクロージャー（フェーズ5）**: **セマンティックガイド付きツール選択**（クエリからのエンティティ抽出 → オントロジーレジストリルックアップ → コネクタセット削減；50以上のコネクタデプロイメント向けに90%以上のトークン削減）；バッチ/ETLコネクタ向けスケールモード；CLIスタイルのユニバーサル`connector <name> <action> <params>`インターフェース

* [ ] **クロスコネクタエンティティアライメント（オントロジーレジストリ）** — *2026-04-21にダウングレード：オンデマンドカスタム配信、コア機能ではない*：共有エンティティタイプ（Customer、Order、Asset）をコネクタ全体のフィールドマッピングで定義；DAGPlannerが自動的にクロスシステムJOINキーを解決；ハードコードされたフィールド名なしでクロスコネクタクエリ（例：「Salesforceの顧客でShopifyで注文した」）を有効化

* [ ] **ホットプラグコネクタ**: OpenAPI仕様をアップロード、AIが設定を生成、5分で稼働（再起動なし）

* [x] ~~**マーケットプレイス再設計フェーズ1 — ソリューション + コンポーネント**~~：2層マーケットモデル（ソリューション：Agent/Skill/Workflow；コンポーネント：Connector/MCPサーバー）；スコープセレクタ（グローバルマーケット / org）；統一サブスクリプションモデル（org自動表示削除）；マーケットスコープからKB削除；データマイグレーションが既存orgメンバーのサブスクリプションをバックフィル

* [ ] **マーケットパッケージシステム**：マーケットプレイス向けの配布可能なリソースバンドル — タイプごとの「マーケットプレイス」を統一パッケージングレイヤーに置き換え。`fim-package.yaml`マニフェストは以下を宣言：メタデータ（名前、バージョン、説明、作成者、ライセンス、タグ、`min_fim_version`）、エントリーポイント（プライマリSkillまたはAgent）、リソースリスト（agents、skills、connectors、KBs、MCPサーバー、workflows）と設定参照、パッケージ間依存関係（semverレンジ）、必須認証情報（インストール時収集用のコネクタ参照にマップ）、およびデフォルト値付きのユーザー設定可能変数。**2つの消費モード**：（1）**install** — すべてのリソースをバッチ作成 + ID置換によって内部参照を自動配線；インストールはソースにリンク（バージョン更新通知用）；`POST /api/market/packages/{id}/install`；（2）**fork** — ユーザー所有の編集可能なコピーとしてクローン（更新リンクなし）（これはテンプレートモード）；`POST /api/market/packages/{id}/fork`。追加エンドポイント：公開（`POST /api/market/packages`レビューワークフロー付き）、アンインストール（`DELETE /packages/{id}/uninstall`依存関係チェック + 変更リソース確認付き）、バージョン履歴（`GET /packages/{id}/versions`）、アップグレード（`POST /packages/{id}/upgrade`リソースごとの差分プレビュー付き）。ネストされたパッケージ要件向けの依存関係リゾルバー（競合検出付き）。`PackageInstallation`テーブルはユーザーごとのインストール済みパッケージを追跡（アンインストール/アップグレード用のリソースIDマッピング付き）。**個別リソース公開と共存** — パッケージは構成レイヤー、置き換えではない；単一のコネクタはスタンドアロンで公開可能。例：依存関係ツリー：`Package: contract-review` → `Skill: contract-review`（エントリーポイント） → `Agent: contract-analyst` + `Agent: risk-scorer` → `KB: legal-clauses` + `Connector: docusign-api` + `MCP: pdf-extractor` + `Workflow: contract-approval-flow`

* [ ] **クリエータープログラム**：マーケットプレイス収益化レイヤー — ポートフォリオページ付きクリエータープロフィール、パッケージごとの分析（インストール、フォーク、アクティブユーザー、評価/レビュー）、パッケージが新規サブスクリプションを促進する場合のアフィリエイトコミッション追跡。価格設定、購入フロー、承認ワークフロー付きの有料パッケージティア。インストール傾向、収益レポート、ユーザーフィードバック付きのクリエータダッシュボード。プログラマティックパッケージ公開用の公開クリエータAPI（パッケージ作成者向けCI/CD）。コミュニティ機能：パッケージコメント、Q\&A、バージョンごとのチェンジログ

* [ ] **埋め込み可能ウィジェット**: `<script src="fim-one.js">`をホストページに注入

* [ ] **ページコンテキスト注入**：ウィジェットがホストページコンテキスト（現在のID、URL、DOMセレクタ）を読み取る

* [ ] **高度なトリガー**：Webhookインバウンドイベント；スケジュール済みジョブの強化（マルチタイムゾーン、カレンダー対応）

* [ ] **バッチ実行**：DAG経由で1000以上のアイテムを処理

* [ ] **エンタープライズセキュリティ**：IPホワイトリスト、保存時暗号化、SSO

* [ ] **KB高度なエディタ**：大規模ナレッジベースを管理するパワーユーザー向けビルダーモードエージェント — 一括URL取り込み、重複検出、ギャップ分析、ドキュメントライフサイクル管理；既存KB AIチャットをReActツールループで拡張

* [ ] **Stripe請求（v1 MVP — Proサブスクリプション）**：Free + Pro 2層サブスクリプション（月次トークンクォータ付き）。Stripe Checkout（ホスト型）+ Customer Portal（セルフサービス）+ Webhookドリブンライフサイクル（`checkout.session.completed` / `customer.subscription.updated|deleted` / `invoice.payment_succeeded|failed`）。クォータ枯渇時のソフトキャップ（HTTP 402 + アップグレードプロンプト）— v1では超過料金なし。ユーザーごとの請求のみ；Org/Teamサブスクリプションはv3に延期。前提条件：
  * [x] ~~**データモデル + SDKグラウンドワーク**（P1）— `billing_plans` / `subscriptions` / `stripe_webhook_events`テーブル、ORMモデル、Stripe SDKシングルトン、Free + Proシード~~ *（v0.8.6で出荷）*
  * [x] ~~**バックエンドAPI + Webhookハンドラ**（P2）— `/api/billing/*` + `/api/webhooks/stripe`（署名検証 + べき等性付き）；プラン対応クォータ；時間ごとのライフサイクルスイープ~~ *（v0.8.6で出荷）*
  * [x] ~~**フロントエンド請求タブ + 402アップグレードダイアログ**（P3）— `/settings?tab=billing`クォータ表示、アップグレードCTA、`past_due`バナー、ストリーム中の402ダイアログ~~ *（v0.8.6で出荷）*
  * [x] ~~**管理者プラン管理**（P4）— `admin/billing/{plans,subscriptions}` CRUD~~ *（v0.8.6で出荷）*
  * [x] ~~**管理者制御請求機能フラグ**（P5）— `system_settings.billing_enabled`がStripeパイプラインをゲート；べき等的な有効化がFree+Proをシード、デフォルトプランポインタを設定、ユーザーをバックフィル；有効化後のトグルオン/オフは純粋なフラグフリップ~~ *（v0.8.6で出荷）*
  * [ ] **調整 + e2e + 本番稼働**（P6）— 夜間`subscriptions` ↔ `stripe.Subscription.list()`調整スクリプト（見落とされたWebhook回復用）；フルスタックハッピーパス/キャンセル中期/過去期限回帰テスト；テストモード`stripe_price_id`からライブ`price_id`に切り替え；ステージングで実際のカードでスモークテスト。

* [ ] **チームプラン（Stripeシート）** — `stripe.Subscription.quantity`経由のシートごとの価格設定、Organization メンバーシップとの統合。企業が1つのチーム全体プランをNシートでサブスクライブ可能；クォータと機能フラグは個別ユーザーではなくシートグループを通じて解決。v1.0 Stripe MVPと既存Organizationモデルに基づいて構築。

* [ ] **非請求デプロイメント向けのグループレベルトークンクォータ** — Stripeなしのエンタープライズ/プライベートデプロイメントは組織レベルのトークン予算を設定。クォータチェーンは`override > group > plan > default`に拡張；グループ解決は`max(user_quota, group_quota)`を使用するため、個別VIPはチームキャップに制約されない。チームプランと同時にランディングするため、同じプリミティブが請求対象とセルフホスト型トポロジの両方に対応。

**影響**：エンタープライズはFIM Oneをゼロからマルチシステムオーケストレーションに数日でデプロイ。パッケージシステムはクリエータエコシステムを作成 — ソリューション作成者は複合バンドル（Skill + Agents + Connectors + KBs + Workflows）を公開、エンタープライズはワンクリックでインストール、クリエータは採用から収益を得る。インストール/フォーク二重性は「そのまま使用」と「テンプレートからカスタマイズ」の両方のユースケースを単一メカニズムでカバー。

## 凍結機能（リリース済み、メンテナンスのみ）

[直交性戦略](/strategy/orthogonality-strategy)に従い、これらの機能はリリース済みで動作していますが、新しい機能は追加されません（バグ修正のみ）：

| 機能                             | バージョン            | 凍結理由                                                                                                                                                                                  |
| ------------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ReAct Agent                    | v0.1、v0.9        | モデルがネイティブツール呼び出し機能を備えるようになった。ループ中の自己反省（v0.9）により、長いチェーンでの目標ドリフトを防止。ツール観察合成品質が向上（8K文字、`REACT_TOOL_OBS_TRUNCATION`で設定可能）                                                                 |
| DAG Planning / Re-Planning     | v0.1、v0.5、v0.7.5 | モデルの推論能力が向上中；分解がシングルショット化。ステップごとの検証がv0.7.5でリリース（`DAG_STEP_VERIFICATION`）。強化：カスケード障害伝播、検証者ステータス修正、プランナーツール説明、完全なリプラン履歴、ホワイトリストベースのツールキャッシュ。14個のエンジン定数がENV変数として公開——追加の計画プリミティブは予定されていない |
| Memory（Window、Summary、Compact） | v0.2、v0.5        | コンテキストウィンドウが拡大中（200K以上）；外部メモリ管理の必要性が低下                                                                                                                                                |
| RAG pipeline                   | v0.5             | プロバイダーがネイティブ検索を構築中（OpenAI file\_search、Gemini Search Grounding）                                                                                                                       |
| Grounded Generation            | v0.5             | モデルが引用精度を向上中；5段階パイプラインは収益逓減                                                                                                                                                           |
| ContextGuard / Pinned Messages | v0.5             | 現状のままリリース；新機能なし                                                                                                                                                                       |

## 検討中（無期限延期）

直交性戦略に基づき、以下は高い実装コストと吸収リスクに直面しています：

| 機能                                | 延期理由                                                                                                                                                                                                       |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| マルチエージェントオーケストレーション（深い階層）         | プロバイダーがネイティブに構築中（OpenAI Swarm、Google A2A、類似のマルチエージェント提供）。FIM Oneの CallAgentTool は1段階の委譲ケースをカバー；イベントトリガーのバックグラウンドエージェントはv0.9のScheduled Jobsでカバー                                                             |
| エージェント自己修正スキル（手続き型メモリ）            | 実行中にエージェントが独自の `skill.md` を更新する——高い複雑性、セキュリティ/監査の表面積が大きい。Agent Skill System（v0.8）のリリース後に再評価。企業顧客が自己改善エージェントを明示的にリクエストした場合は再検討                                                                              |
| ~~エージェントワークスペース（ツール出力ファイルオフロード）~~ | v0.9に昇格。価値は**選択的読み取り**であり、コンテキスト容量ではない——フレームワーク横断検証で確認済み。元の延期理由（「200K+ウィンドウが緊急性を低下させる」）は誤りでした                                                                                                              |
| クロスセッション長期メモリ                     | コンテキストウィンドウが急速に拡大中（200K–2M）；プロバイダーがビルトインメモリを追加中（OpenAI memory、Gemini context caching）；実装コストが高い割に差別化価値が低下。企業顧客が明示的にリクエストした場合に再評価                                                                            |
| メモリライフサイクル（TTL、クォータ）              | クロスセッションメモリに依存；一緒に延期                                                                                                                                                                                       |
| アクティブコンテキスト圧縮ツール（エージェントトリガー）      | ContextGuard（v0.5）で明示的に凍結。200K+のコンテキストウィンドウが価値を低下させます。コンテキストコストが主要な企業の不満になるまで再検討しません                                                                                                                       |
| ブラウザオートメーション / コンピュータユース          | 高い保守コスト（DOM変更、アンチボット、サンドボックス）。業界がコンピュータユースモード（Anthropic、OpenAI Operator、Google Mariner）とMCPブラウザツール（Puppeteer/Playwright MCP）に収束中。MCP統合経由で利用；自社構築しない。安定したComputer Use MCPスタンダードが出現した場合に再評価                  |
| Web Push通知                        | Service Worker + VAPID経由のブラウザネイティブプッシュ。IM Channel Integration（v0.8）と重複（Lark/Slack/WeCom/Emailなどの企業向けチャネルをカバー）。IMプッシュの方が企業価値が高い；Web Pushはポータルのみユーザー向けの追加機能。IM Channelリリース後に再評価——ユーザーがIM対応外のブラウザ通知をリクエストした場合 |
| マルチユーザーワークフロー協調編集                 | 同じワークフロー設計図のリアルタイム共同編集（Figma/Notion形式）、カーソル認識、競合解決、ノード単位のロック機能。高い実装コスト（CRDT / OT、プレゼンスインフラ）、今日の「1編集者のみ+バージョン差分」モデルに対する企業需要が不明確。複数企業が明示的に共有ライブ編集をリクエストした場合に再評価                                              |
| ノード単位ワークフロー実行権限（実行時RBAC）          | 単一ワークフロー実行内の細粒度認可——例えば「ノードXは実行に `finance_approver` ロールが必要」。現在の認可はワークフローレベル（誰がトリガーできるか）とコネクタレベル（どの認証情報が実行するか）；ノード単位RBACは第3の軸を追加し、実装複雑性が高い割に活発な顧客リクエストがない                                                    |
| 組織間ワークフロー共有とライブ更新                 | 別の組織からワークフローをサブスクライブし、再フォークなしでアップストリーム更新を受け取る。現在のサブスクライブ=フォーク（スナップショット）のため、アップストリーム変更は伝播しない。ライブ更新にはアップストリーム互換スキーマ進化+競合解決が必要；保守コストが高い。企業が「子会社間でのワークフロー共有」をリクエストした場合に再評価                                     |

## バージョンとモードの対応関係

| Version       | Standalone | Copilot   | Hub        | Notes                                                   |
| ------------- | ---------- | --------- | ---------- | ------------------------------------------------------- |
| **v0.1–v0.3** | Working    | Not yet   | Not yet    | ポータルのみ、シングルユーザー                                         |
| **v0.4**      | Working    | Not yet   | Not yet    | マルチ会話、エージェント管理                                          |
| **v0.5**      | Working    | Not yet   | Not yet    | ナレッジベース + RAG                                           |
| **v0.6**      | Working    | Possible  | Possible   | コネクタ提供; Copilot/Hubは手動配線で可能                             |
| **v0.7**      | Working    | Ready     | Ready      | 管理プラットフォーム; マルチテナント認証; 本番環境対応                           |
| **v0.8**      | Working    | Ready     | Optimized  | RBAC + システムごとの監査ログ; オンボーディング容易化                         |
| **v0.9**      | Working    | Ready     | Production | 可観測性、パフォーマンス、堅牢化                                        |
| **v1.0**      | Working    | Optimized | Enterprise | パッケージシステム、クリエイタープログラム、ホットプラグ、埋め込み可能ウィジェット、webhook、バッチ処理 |

## Resource Allocation (v0.8–v1.0)

The Orthogonality Strategy shapes where effort goes:

| Category                                                       | Allocation | Versions  | Why                                                                                |
| -------------------------------------------------------------- | ---------- | --------- | ---------------------------------------------------------------------------------- |
| **Connector Platform** (v0.6+)                                 | 50%        | Ongoing   | Core differentiation; no absorption risk                                           |
| **Enterprise Features** (RBAC, audit, security, observability) | 30%        | v0.8–v1.0 | Boring but durable; production requirement. Agent Trace Layer is commercial anchor |
| **Agent Intelligence** (Skill System, scheduled agents)        | 15%        | v0.8–v0.9 | 指令+工具+スキル差別化ストーリー；低吸収リスク——フレームワークはパターンを検証しますが、エンタープライズSOPは顧客固有です                   |
| **v0.1–v0.5 maintenance**                                      | 5%         | Ongoing   | Bug fixes only; no new features                                                    |

## メトリック駆動型マイルストーン

成功は以下のメトリックで測定されます：

| メトリック                   | v0.7 目標   | v0.8 目標      | v1.0 目標       |
| ----------------------- | --------- | ------------ | ------------- |
| デプロイされたコネクタ             | 5         | 20+          | 100+          |
| エンタープライズ顧客              | 1–2       | 5–10         | 20+           |
| 平均コネクタセットアップ時間          | 2週間       | 2日           | 5分（ホットプラグ）    |
| トークン効率（DAG vs ReAct のみ） | 30% 削減    | 40% 削減       | 50% 削減        |
| アップタイム SLA              | 99.5%     | 99.9%        | 99.95%        |
| サポートチケットテーマ             | 統合、セットアップ | コネクタカスタムロジック | ホットプラグ、スケーリング |

## 未解決の質問 / TBD

* **マーケットプレイスのモデレーション**: コミュニティパッケージと個別リソースをどのように検証するか？パッケージ設定内の認証情報漏洩を自動スキャンするか？(v1.0)
* **トークンエコノミクス**: マルチユーザー、マルチエージェントシナリオの価格設定方法は？(v1.0)
* **パッケージのバージョニング**: インストール済みパッケージの破壊的変更——マイグレーションスクリプト付きの自動アップグレード、それとも更新ごとの手動承認？依存関係のダイヤモンド問題の解決方法は？(v1.0)
* **パッケージの価格設定**: 無料層と有料層、Creator Programのコミッション率、決済プロバイダーの統合は？(v1.0)
* **パッケージの認証情報UX**: インストール時の認証情報収集——ウィザード形式のステップバイステップか、それとも遅延セットアップか？同じコネクタータイプを使用するパッケージ間での認証情報共有は？(v1.0)
* **テレメトリのオプトアウト**: プライバシー設定をどのように尊重するか？(v0.8)
* **コネクターのバージョニング**: コネクターAPIの破壊的変更をどのように管理するか？(v0.8)
* **レート制限**: ユーザーごとのワークフローレート制限は実装済み（スライディングウィンドウ 10回/分、3並行）。コネクターごと、エージェントごとのレート制限はTBD (v0.9)
* **コネクター認可階層の選択**: 管理者は特定のアップストリームシステムにどの階層が適用されるかをどのように発見するか？自動プローブ（ユーザーごとのAPIキーを試す → ログインチケットにフォールバック → 共有DBにフォールバック）か、それともコネクター仕様での明示的な宣言か？「このコネクターは階層2をサポートしているが、管理者は階層1で運用することを選択した」をUIで表現し、非技術的な管理者を混乱させないようにするには？(v0.9)
* **IntegrationとConnectorの二重性**: Feishuバインディングが同時にSSO提供者とAPI呼び出し表面である場合、設定でそれをどのように提示するか？3つのトグル付きの1つのオブジェクト、それとも認証情報を共有する3つの個別バインディングか？アンインストールセマンティクスへの影響（SSOを取り消すとコネクターが停止するか？）(v0.9)