kairos-chain 2.4.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 52819cfdb42eed0ec8b3c0789cd19b44458dfb5446f24beb25d2ef21df7d6d75
-  data.tar.gz: 0bdfc0afa6c20c8a6b93fd348e0fbe99ccdfe81a950c158127ef526d28287c7a
+  metadata.gz: 4bb1a479485b0eeb8315806b9cb6b657aab0999da825b028c1bd164d29d7683a
+  data.tar.gz: f0c41de78a0b1a83bd0826b71e7847a80549f5f3ce91673acaefcafd322b9c23
 SHA512:
-  metadata.gz: 5144b19067b3a7361581312ccb2d99c0b137c8b6d2291c40b762149232f3bf42fa8ae365c28ba3580b36acda43d9e914d7e0de14c1ca5c4231213c49d565a314
-  data.tar.gz: 81d99fb9024bf56b4c3080a6c61def85d98ccb91169d14071a23aeee02cc080701077098be547a6aede583f554f4ccd3a6050b11d2927a32543cc5a14d0e8381
+  metadata.gz: 86afd61254c72f559565196bf3caa53f547b5f3483ae5562cbedac0ddaa9d56970ec19aa54eaed3278f338e2ca930ab5c7dcd9d6acbe681f61b0bc0d197ae706
+  data.tar.gz: d8de0bb6abda6c4e1837c3976a1e85a4b2784d8e8619afda40434c64b1365733ca69666b5de981c87ec3f296667192e9b7a3d573a0301108c2fd7c3408e55b7e

data/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to the `kairos-chain` gem will be documented in this file.
 
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [2.5.0] - 2026-03-03
+
+### Added
+
+- **Cross-Instance Knowledge Discovery**: KairosChain instances connected to a Meeting Place can now publish knowledge gaps as "needs" to the SkillBoard. Other agents browsing the board can discover these needs and offer relevant knowledge.
+  - `skills_audit(command: "export_needs")`: New audit command to package knowledge gaps for cross-instance sharing
+  - `meeting_publish_needs`: New Hestia MCP tool to publish needs to the Meeting Place board (requires explicit `opt_in: true`)
+  - `SkillBoard#post_need` / `remove_needs`: In-memory need entries (session-only, no persistence — DEE compliant)
+  - `POST /place/v1/board/needs`: New HTTP endpoint to publish knowledge needs
+  - `DELETE /place/v1/board/needs`: New HTTP endpoint to remove published needs
+  - `browse(type: 'need')`: Filter board entries to show only knowledge needs
+  - Needs are automatically cleaned up on agent unregister
+
+- **Knowledge Acquisition Policy — Cross-Instance Extension**: Tutorial template Acquisition Behavior now includes opt-in cross-instance knowledge needs publishing guidance
+
+- **L1 Knowledge Updates**: Updated `hestiachain_meeting_place` (EN/JP), `kairoschain_usage` (EN/JP), `kairoschain_operations` (EN/JP), `persona_definitions` with cross-instance discovery, proactive tool usage, and dynamic persona suggestion documentation
+
+### Fixed
+
+- **PlaceRouter query string parsing**: Added missing `require 'uri'` — `parse_query` was silently failing due to `NameError` on `URI.decode_www_form`, causing all browse query parameters (`type`, `search`, `limit`) to be ignored
+
+---
+
 ## [2.4.0] - 2026-03-03
 
 ### Added
@@ -284,6 +307,7 @@ This project follows [Semantic Versioning](https://semver.org/).
 - Skill promotion with Persona Assembly
 - Tool guide and metadata system
 
+[2.5.0]: https://github.com/masaomi/KairosChain_2026/compare/v2.4.0...v2.5.0
 [2.4.0]: https://github.com/masaomi/KairosChain_2026/compare/v2.3.1...v2.4.0
 [2.3.1]: https://github.com/masaomi/KairosChain_2026/compare/v2.3.0...v2.3.1
 [2.3.0]: https://github.com/masaomi/KairosChain_2026/compare/v2.2.0...v2.3.0

data/lib/kairos_mcp/tools/skills_audit.rb

@@ -4,6 +4,7 @@ require_relative 'base_tool'
 require_relative '../knowledge_provider'
 require_relative '../context_manager'
 require_relative '../dsl_skills_provider'
+require_relative '../skills_config'
 require_relative '../kairos'
 
 module KairosMcp
@@ -38,7 +39,7 @@ module KairosMcp
         }
       }.freeze
 
-      READONLY_COMMANDS = %w[check conflicts stale dangerous recommend].freeze
+      READONLY_COMMANDS = %w[check conflicts stale dangerous recommend gaps export_needs].freeze
       WRITE_COMMANDS = %w[archive unarchive].freeze
 
       def name
@@ -47,7 +48,8 @@ module KairosMcp
 
       def description
         'Audit knowledge health across L0/L1/L2 layers. Check for conflicts, staleness, ' \
-        'dangerous patterns, and get promotion/archive recommendations. ' \
+        'dangerous patterns, get promotion/archive recommendations, and detect knowledge gaps ' \
+        'defined by custom instruction mode policies. ' \
         'Archive operations require human approval (approved: true).'
       end
 
@@ -56,7 +58,7 @@ module KairosMcp
       end
 
       def usecase_tags
-        %w[audit health check recommend archive stale dangerous L0 L1 L2]
+        %w[audit health check recommend archive stale dangerous gaps needs meeting knowledge-policy L0 L1 L2]
       end
 
       def examples
@@ -76,6 +78,18 @@ module KairosMcp
           {
             title: 'Archive stale knowledge',
             code: 'skills_audit(command: "archive", target: "old_guide", reason: "No longer relevant", approved: true)'
+          },
+          {
+            title: 'Check knowledge gaps for current mode',
+            code: 'skills_audit(command: "gaps")'
+          },
+          {
+            title: 'Check knowledge gaps for specific mode',
+            code: 'skills_audit(command: "gaps", mode_name: "genomics_expert")'
+          },
+          {
+            title: 'Export knowledge needs for Meeting Place sharing',
+            code: 'skills_audit(command: "export_needs")'
           }
         ]
       end
@@ -143,6 +157,10 @@ module KairosMcp
             include_archived: {
               type: 'boolean',
               description: 'Include archived items in results (default: false)'
+            },
+            mode_name: {
+              type: 'string',
+              description: 'Instruction mode name (for gaps command). Defaults to current active mode.'
             }
           },
           required: ['command']
@@ -192,6 +210,10 @@ module KairosMcp
                    run_dangerous_check(layer, args)
                  when 'recommend'
                    run_recommendations(layer, args)
+                 when 'gaps'
+                   run_gaps_check(args)
+                 when 'export_needs'
+                   run_export_needs(args)
                  end
 
         output << result
@@ -895,6 +917,214 @@ module KairosMcp
         end
       end
 
+      # =========================================================================
+      # Knowledge Gaps
+      # =========================================================================
+
+      def run_gaps_check(args)
+        mode = args['mode_name'] || current_mode_name
+        content = load_instruction_content(mode)
+
+        unless content
+          return "## Knowledge Gaps Report\n\n" \
+                 "Could not load instruction file for mode `#{mode}`.\n" \
+                 "Ensure the mode exists and has a corresponding `.md` file in the skills directory."
+        end
+
+        baseline = parse_baseline_knowledge(content)
+
+        unless baseline && !baseline.empty?
+          return "## Knowledge Gaps Report\n\n" \
+                 "**Mode**: `#{mode}`\n\n" \
+                 "No Knowledge Acquisition Policy found in this mode's instructions.\n\n" \
+                 "To add one, include a `## Knowledge Acquisition Policy` section with a " \
+                 "`### Baseline Knowledge` subsection listing required L1 entries:\n\n" \
+                 "```markdown\n" \
+                 "## Knowledge Acquisition Policy\n\n" \
+                 "### Baseline Knowledge\n\n" \
+                 "Required L1 knowledge entries for this mode.\n\n" \
+                 "- `entry_name` — Description of what this knowledge covers\n" \
+                 "```"
+        end
+
+        # Compare against existing L1 knowledge
+        provider = KnowledgeProvider.new
+        existing = provider.list.map { |item| item[:name] }
+
+        present = []
+        missing = []
+        baseline.each do |entry|
+          if existing.include?(entry[:name])
+            present << entry
+          else
+            missing << entry
+          end
+        end
+
+        output = ["## Knowledge Gaps Report\n"]
+        output << "**Mode**: `#{mode}`"
+        output << "**Baseline entries**: #{baseline.size}"
+        output << "**Present**: #{present.size}"
+        output << "**Missing**: #{missing.size}\n"
+
+        if missing.empty?
+          output << "### All Baseline Knowledge Present\n"
+          output << "All required L1 knowledge entries for this mode are available."
+        else
+          output << "### Missing Entries\n"
+          missing.each do |entry|
+            output << "- `#{entry[:name]}` — #{entry[:description]}"
+          end
+
+          output << "\n### Suggested Actions\n"
+          output << "Create the missing entries using `knowledge_update`:\n"
+          missing.each do |entry|
+            output << "```"
+            output << "knowledge_update(command: \"create\", name: \"#{entry[:name]}\", " \
+                       "description: \"#{entry[:description]}\", " \
+                       "content: \"# #{entry[:name]}\\n\\nTODO: Add content\", " \
+                       "tags: [\"baseline\"])"
+            output << "```\n"
+          end
+        end
+
+        if present.any?
+          output << "### Present Entries\n"
+          present.each do |entry|
+            output << "- `#{entry[:name]}` — #{entry[:description]}"
+          end
+        end
+
+        output.join("\n")
+      end
+
+      def parse_baseline_knowledge(content)
+        # Find the Knowledge Acquisition Policy section
+        policy_match = content.match(/^##\s+Knowledge Acquisition Policy\s*$/i)
+        return nil unless policy_match
+
+        # Extract from ### Baseline Knowledge subsection
+        baseline_match = content.match(/^###\s+Baseline Knowledge\s*\n(.*?)(?=^###|\z)/im)
+        return nil unless baseline_match
+
+        baseline_text = baseline_match[1]
+        entries = []
+
+        # Parse lines matching: - `name` — description (supports —, --, :, -)
+        baseline_text.scan(/^-\s+`([^`]+)`\s*(?:—|--|:|-)\s*(.+)$/) do |name, description|
+          entries << { name: name.strip, description: description.strip }
+        end
+
+        entries
+      end
+
+      def current_mode_name
+        SkillsConfig.load['instructions_mode'] || 'tutorial'
+      end
+
+      def load_instruction_content(mode_name)
+        path = case mode_name
+               when 'developer'
+                 KairosMcp.md_path
+               when 'user'
+                 KairosMcp.quickguide_path
+               when 'tutorial'
+                 KairosMcp.tutorial_path
+               when 'none'
+                 nil
+               else
+                 File.join(KairosMcp.skills_dir, "#{mode_name}.md")
+               end
+
+        return nil unless path && File.exist?(path)
+
+        File.read(path)
+      end
+
+      # =========================================================================
+      # Export Needs (Cross-Instance Knowledge Discovery)
+      # =========================================================================
+
+      def run_export_needs(args)
+        mode = args['mode_name'] || current_mode_name
+        content = load_instruction_content(mode)
+
+        unless content
+          return "## Export Needs Report\n\n" \
+                 "Could not load instruction file for mode `#{mode}`.\n" \
+                 "No knowledge needs to export."
+        end
+
+        baseline = parse_baseline_knowledge(content)
+
+        unless baseline && !baseline.empty?
+          return "## Export Needs Report\n\n" \
+                 "**Mode**: `#{mode}`\n\n" \
+                 "No Knowledge Acquisition Policy found — no needs to export."
+        end
+
+        # Find missing entries (gaps)
+        provider = KnowledgeProvider.new
+        existing = provider.list.map { |item| item[:name] }
+        missing = baseline.reject { |entry| existing.include?(entry[:name]) }
+
+        if missing.empty?
+          return "## Export Needs Report\n\n" \
+                 "**Mode**: `#{mode}`\n\n" \
+                 "All baseline knowledge is present. No needs to export."
+        end
+
+        # Build exportable needs structure
+        needs_data = build_knowledge_needs(mode, missing)
+
+        # Check Meeting Place connection
+        connection_file = File.join(KairosMcp.storage_dir, 'meeting_connection.json')
+        connected = File.exist?(connection_file)
+
+        output = ["## Export Needs Report\n"]
+        output << "**Mode**: `#{mode}`"
+        output << "**Missing entries**: #{missing.size}"
+        output << "**Meeting Place connected**: #{connected}\n"
+
+        output << "### Exportable Needs\n"
+        needs_data[:needs].each do |need|
+          output << "- `#{need[:name]}` — #{need[:description]}"
+        end
+
+        if connected
+          output << "\n### Next Step\n"
+          output << "Publish these needs to the Meeting Place board:\n"
+          output << "```"
+          output << "meeting_publish_needs(opt_in: true)"
+          output << "```"
+        else
+          output << "\n### Not Connected\n"
+          output << "Connect to a Meeting Place first using `meeting_connect(url: \"...\")`, "
+          output << "then use `meeting_publish_needs(opt_in: true)` to publish."
+        end
+
+        output.join("\n")
+      end
+
+      def build_knowledge_needs(mode_name, missing_entries = nil)
+        if missing_entries.nil?
+          content = load_instruction_content(mode_name)
+          return { agent_mode: mode_name, needs: [], published_at: nil, session_only: true } unless content
+
+          baseline = parse_baseline_knowledge(content) || []
+          provider = KnowledgeProvider.new
+          existing = provider.list.map { |item| item[:name] }
+          missing_entries = baseline.reject { |entry| existing.include?(entry[:name]) }
+        end
+
+        {
+          agent_mode: mode_name,
+          needs: missing_entries.map { |entry| { name: entry[:name], description: entry[:description] } },
+          published_at: Time.now.utc.iso8601,
+          session_only: true
+        }
+      end
+
       # =========================================================================
       # Helpers
       # =========================================================================

data/lib/kairos_mcp/version.rb

@@ -1,4 +1,4 @@
 module KairosMcp
-  VERSION = "2.4.0"
+  VERSION = "2.5.0"
   CHANGELOG_URL = "https://github.com/masaomi/KairosChain_2026/blob/main/CHANGELOG.md"
 end

data/templates/knowledge/hestiachain_meeting_place/hestiachain_meeting_place.md

@@ -1,14 +1,14 @@
 ---
 name: hestiachain_meeting_place
 description: "HestiaChain Meeting Place — user guide for agent discovery, skill exchange, and trust anchoring"
-version: 2.0
+version: 2.1
 layer: L1
 tags: [documentation, readme, hestia, meeting-place, p2p, deployment, trust-anchor]
 readme_order: 4.5
 readme_lang: en
 ---
 
-## HestiaChain Meeting Place (v2.0.0)
+## HestiaChain Meeting Place (v2.5.0)
 
 ### What is HestiaChain?
 
@@ -29,9 +29,9 @@ KairosChain (MCP Server)
       ├── chain/         ← Trust anchor (self-contained, no external gem dependency)
       ├── PlaceRouter    ← /place/v1/* HTTP endpoints
       ├── AgentRegistry  ← Agent registration with JSON persistence
-      ├── SkillBoard     ← Skill discovery (random sampling, no ranking)
+      ├── SkillBoard     ← Skill + knowledge needs discovery (random sampling, no ranking)
       ├── HeartbeatManager ← TTL-based liveness with fadeout recording
-      └── tools/         ← 6 MCP tools
+      └── tools/         ← 7 MCP tools
 ```
 
 A KairosChain instance with the hestia SkillSet is simultaneously an MCP server, a P2P agent, a Meeting Place host, and a participant in other Meeting Places. This embodies the DEE principle of subject-object undifferentiation (主客未分).
@@ -85,6 +85,8 @@ curl -s -H "Authorization: Bearer $TOKEN" \
 | POST | `/place/v1/unregister` | Bearer | Unregister an agent |
 | GET | `/place/v1/agents` | Bearer | List registered agents |
 | GET | `/place/v1/board/browse` | Bearer | Browse skill board (random order) |
+| POST | `/place/v1/board/needs` | Bearer | Publish knowledge needs to board |
+| DELETE | `/place/v1/board/needs` | Bearer | Remove published knowledge needs |
 | GET | `/place/v1/keys/:id` | Bearer | Retrieve agent's public key |
 
 ### MCP Tools
@@ -97,6 +99,26 @@ curl -s -H "Authorization: Bearer $TOKEN" \
 | `record_observation` | Record subjective observation of interaction |
 | `meeting_place_start` | Start the Meeting Place, initialize components |
 | `meeting_place_status` | Show Meeting Place configuration and status |
+| `meeting_publish_needs` | Publish knowledge gaps to board (explicit opt-in required) |
+
+### Cross-Instance Knowledge Discovery
+
+Agents can publish their knowledge gaps (needs) to the Meeting Place board, enabling other agents to discover and offer relevant knowledge.
+
+**Workflow:**
+
+1. Run `skills_audit(command: "gaps")` to detect missing baseline knowledge
+2. Run `skills_audit(command: "export_needs")` to preview exportable needs
+3. Run `meeting_publish_needs(opt_in: true)` to publish needs to the board
+4. Other agents browsing with `browse(type: 'need')` can discover these needs
+5. Agents decide locally whether to offer knowledge (no automated matching)
+
+**DEE Compliance:**
+- Needs are session-only (in-memory, no persistence)
+- No aggregation, ranking, or popularity metrics
+- Explicit opt-in required (`opt_in: true`)
+- Random sampling for browse results (D3)
+- Each agent decides independently whether to respond (D5)
 
 ### Trust Anchor: Chain Migration
 
@@ -118,7 +140,7 @@ HestiaChain implements the Decentralized Event Exchange (DEE) protocol:
 - **PhilosophyDeclaration**: Agents declare their exchange philosophy (observable, not enforceable). Only the hash is recorded on chain.
 - **ObservationLog**: Agents record subjective observations. Multiple agents can have different observations of the same interaction — "meaning coexists."
 - **Fadeout**: When an agent's heartbeat expires, this is recorded as a first-class event (not an error). Silent departure is a natural part of the protocol.
-- **Random Sampling**: The SkillBoard returns skills in random order. There is no ranking, no scoring, no popularity metric.
+- **Random Sampling**: The SkillBoard returns skills and knowledge needs in random order. There is no ranking, no scoring, no popularity metric.
 
 ### EC2 Deployment
 

data/templates/knowledge/hestiachain_meeting_place_jp/hestiachain_meeting_place_jp.md

@@ -1,14 +1,14 @@
 ---
 name: hestiachain_meeting_place_jp
 description: "HestiaChain Meeting Place — エージェント探索・スキル交換・信頼アンカーのユーザーガイド"
-version: 2.0
+version: 2.1
 layer: L1
 tags: [documentation, readme, hestia, meeting-place, p2p, deployment, trust-anchor]
 readme_order: 4.5
 readme_lang: jp
 ---
 
-## HestiaChain Meeting Place (v2.0.0)
+## HestiaChain Meeting Place (v2.5.0)
 
 ### HestiaChain とは
 
@@ -29,9 +29,9 @@ KairosChain (MCP Server)
       ├── chain/         ← 信頼アンカー（自己完結型、外部 gem 依存なし）
       ├── PlaceRouter    ← /place/v1/* HTTP エンドポイント
       ├── AgentRegistry  ← JSON 永続化によるエージェント登録
-      ├── SkillBoard     ← スキル発見（ランダムサンプリング、ランキングなし）
+      ├── SkillBoard     ← スキル＋知識ニーズ発見（ランダムサンプリング、ランキングなし）
       ├── HeartbeatManager ← TTL ベースの生存確認と退場記録
-      └── tools/         ← 6 MCP ツール
+      └── tools/         ← 7 MCP ツール
 ```
 
 hestia SkillSet を持つ KairosChain インスタンスは、MCP サーバー、P2P エージェント、Meeting Place ホスト、他の Meeting Place の参加者を同時に兼ねます。これは DEE プロトコルの「主客未分」原則を体現しています。
@@ -85,6 +85,8 @@ curl -s -H "Authorization: Bearer $TOKEN" \
 | POST | `/place/v1/unregister` | Bearer | エージェント登録解除 |
 | GET | `/place/v1/agents` | Bearer | 登録エージェント一覧 |
 | GET | `/place/v1/board/browse` | Bearer | スキルボード閲覧（ランダム順） |
+| POST | `/place/v1/board/needs` | Bearer | 知識ニーズをボードに公開 |
+| DELETE | `/place/v1/board/needs` | Bearer | 公開した知識ニーズを削除 |
 | GET | `/place/v1/keys/:id` | Bearer | エージェントの公開鍵取得 |
 
 ### MCP ツール
@@ -97,6 +99,26 @@ curl -s -H "Authorization: Bearer $TOKEN" \
 | `record_observation` | インタラクションの主観的観察を記録 |
 | `meeting_place_start` | Meeting Place を起動、コンポーネント初期化 |
 | `meeting_place_status` | Meeting Place の設定とステータスを表示 |
+| `meeting_publish_needs` | 知識ギャップをボードに公開（明示的 opt-in 必須） |
+
+### クロスインスタンス知識発見
+
+エージェントは自身の知識ギャップ（ニーズ）を Meeting Place ボードに公開できます。他のエージェントがブラウズ中にニーズを発見し、関連知識を提供できます。
+
+**ワークフロー:**
+
+1. `skills_audit(command: "gaps")` でベースライン知識の不足を検出
+2. `skills_audit(command: "export_needs")` でエクスポート可能なニーズをプレビュー
+3. `meeting_publish_needs(opt_in: true)` でニーズをボードに公開
+4. 他のエージェントが `browse(type: 'need')` でニーズを発見
+5. 各エージェントがローカルに知識提供の判断を行う（自動マッチングなし）
+
+**DEE 準拠:**
+- ニーズはセッション限り（インメモリ、永続化なし）
+- 集計・ランキング・人気指標なし
+- 明示的 opt-in 必須（`opt_in: true`）
+- ブラウズ結果はランダムサンプリング（D3）
+- 各エージェントが独立に判断（D5）
 
 ### 信頼アンカー：チェーン移行
 
@@ -118,7 +140,7 @@ HestiaChain は Decentralized Event Exchange（DEE）プロトコルを実装し
 - **PhilosophyDeclaration**: エージェントが交換哲学を宣言（観察可能、強制不可）。ハッシュのみチェーンに記録
 - **ObservationLog**: エージェントが主観的観察を記録。同じインタラクションに対して複数のエージェントが異なる観察を持てる —「意味は合意されない。意味は共存する」
 - **Fadeout**: エージェントの心拍が期限切れになると、これはエラーではなく第一級イベントとして記録される。静かな退場はプロトコルの自然な一部
-- **ランダムサンプリング**: SkillBoard はスキルをランダム順で返す。ランキング、スコアリング、人気指標は存在しない
+- **ランダムサンプリング**: SkillBoard はスキルと知識ニーズをランダム順で返す。ランキング、スコアリング、人気指標は存在しない
 
 ### EC2 デプロイ
 

data/templates/knowledge/kairoschain_operations/kairoschain_operations.md

@@ -1,7 +1,7 @@
 ---
 name: kairoschain_operations
 description: "Future roadmap, deployment, and operations guide"
-version: 1.1
+version: 1.2
 layer: L1
 tags: [documentation, readme, operations, deployment, roadmap, backup]
 readme_order: 5
@@ -26,8 +26,11 @@ The following development phases have been completed on the `feature/skillset-pl
 | **Phase 4.pre** | Authentication + Hardening | Admin token rotation, session-based auth for P2P endpoints |
 | **Phase 4A** | HestiaChain Foundation | Self-contained trust anchor SkillSet, DEE protocol (PhilosophyDeclaration, ObservationLog), chain migration (4 stages), 4 MCP tools, 77 test assertions |
 | **Phase 4B** | Meeting Place Server | PlaceRouter, AgentRegistry, SkillBoard, HeartbeatManager, 6 HTTP endpoints, 2 MCP tools, 70 test assertions |
+| **v2.3.0** | Tutorial Mode + Proactive Tools | Behavioral gradient instruction mode, existing project fast-track, Knowledge Acquisition Policy |
+| **v2.4.0** | Dynamic Persona Suggestion | 2-step suggest→assembly workflow, custom persona names, improved unknown persona handling |
+| **v2.5.0** | Cross-Instance Knowledge Discovery | SkillBoard knowledge needs, `meeting_publish_needs` tool, `export_needs` audit command, DEE-compliant session-only needs |
 
-Test results: 356 passed, 0 failed (v2.0.0).
+Test results: 356+ passed, 0 failed (v2.5.0).
 
 ### Near-term
 

data/templates/knowledge/kairoschain_operations_jp/kairoschain_operations_jp.md

@@ -26,8 +26,11 @@ readme_lang: jp
 | **Phase 4.pre** | 認証 + 堅牢化 | Admin トークンローテーション、P2Pエンドポイントのセッションベース認証 |
 | **Phase 4A** | HestiaChain Foundation | 自己完結型信頼アンカーSkillSet、DEEプロトコル（PhilosophyDeclaration、ObservationLog）、チェーン移行（4ステージ）、4 MCPツール、77テストアサーション |
 | **Phase 4B** | Meeting Placeサーバー | PlaceRouter、AgentRegistry、SkillBoard、HeartbeatManager、6 HTTPエンドポイント、2 MCPツール、70テストアサーション |
+| **v2.3.0** | チュートリアルモード + プロアクティブツール | 行動勾配インストラクションモード、既存プロジェクト高速トラック、Knowledge Acquisition Policy |
+| **v2.4.0** | 動的ペルソナ提案 | 2ステップ suggest→assembly ワークフロー、カスタムペルソナ名、未知ペルソナハンドリング改善 |
+| **v2.5.0** | クロスインスタンス知識発見 | SkillBoard知識ニーズ、`meeting_publish_needs`ツール、`export_needs`監査コマンド、DEE準拠セッション限りニーズ |
 
-テスト結果: 356テスト通過、0失敗（v2.0.0）。
+テスト結果: 356+テスト通過、0失敗（v2.5.0）。
 
 ### 近期
 

data/templates/knowledge/kairoschain_usage/kairoschain_usage.md

@@ -1,7 +1,7 @@
 ---
 name: kairoschain_usage
 description: "KairosChain tools reference, usage patterns, and evolution workflow"
-version: 1.1
+version: 1.2
 layer: L1
 tags: [documentation, readme, usage, tools, workflow, examples]
 readme_order: 3
@@ -252,6 +252,8 @@ Commands:
 - `conflicts`: Detect potential contradictions between knowledge
 - `dangerous`: Detect patterns conflicting with L0 safety
 - `recommend`: Get promotion and archive recommendations
+- `gaps`: Check knowledge gaps defined by Knowledge Acquisition Policy in instruction modes
+- `export_needs`: Package knowledge gaps as shareable needs for cross-instance discovery via Meeting Place
 - `archive`: Archive L1 knowledge (human approval required)
 - `unarchive`: Restore from archive (human approval required)
 

data/templates/knowledge/kairoschain_usage_jp/kairoschain_usage_jp.md

@@ -252,6 +252,8 @@ cp -r skills/versions skills/backups/versions_$(date +%Y%m%d)
 - `conflicts`: 知識間の潜在的矛盾を検出
 - `dangerous`: L0安全性と矛盾するパターンを検出
 - `recommend`: 昇格とアーカイブの推奨を取得
+- `gaps`: Knowledge Acquisition Policyで定義された知識ギャップを検出
+- `export_needs`: 知識ギャップをMeeting Placeでの共有用にパッケージ化
 - `archive`: L1知識をアーカイブ（人間の承認が必要）
 - `unarchive`: アーカイブから復元（人間の承認が必要）
 

data/templates/knowledge/persona_definitions/persona_definitions.md

@@ -1,7 +1,7 @@
 ---
 name: persona_definitions
 description: Default persona definitions for Persona Assembly during skill promotion and audit decisions
-version: "1.2"
+version: "1.3"
 layer: L1
 tags: [meta, personas, assembly, promotion, audit, decision-making, facilitator]
 ---
@@ -242,6 +242,15 @@ The assembly produces a discussion summary with:
 
 **Important:** The assembly output is advisory only. Human judgment remains the final authority, especially for L0 promotions.
 
+### Dynamic Persona Suggestion (v2.4.0+)
+
+Use `skills_promote(command: "suggest")` to have the LLM analyze source content and suggest optimal personas before running Persona Assembly. The 2-step workflow:
+
+1. **Suggest**: LLM analyzes the content and recommends persona types and count
+2. **Assembly**: Run the assembly with the suggested (or modified) persona set
+
+Custom persona names are fully supported — the LLM infers the role from the name and context when no pre-defined definition exists.
+
 ### Customizing Personas
 
 Users can modify this knowledge to:

data/templates/skills/kairos_tutorial.md

@@ -73,6 +73,10 @@ them as naturally as you would use a notebook.
   to check if relevant L1 knowledge exists before answering from scratch.
 - **When the user asks about capabilities**: Call `tool_guide(command: "catalog")`
   to give accurate, current information.
+- **Knowledge gaps (custom modes only)**: If the active mode has a Knowledge
+  Acquisition Policy, call `skills_audit(command: "gaps")` silently to check
+  for missing baseline knowledge. If gaps are found, inform the user briefly
+  and offer to create the missing entries.
 
 ### When Few or No L2 Contexts Exist
 
@@ -183,6 +187,53 @@ Minimum requirements for L1 knowledge (kept intentionally low):
 Quality improves over time through audit suggestions. Do not block initial promotion
 for perfectionism.
 
+## Knowledge Acquisition Policy (Custom Modes)
+
+When creating a custom instruction mode (including via fast-track), include a
+Knowledge Acquisition Policy section to define what L1 knowledge the mode requires.
+This enables automatic gap detection at session start.
+
+### Template
+
+```markdown
+## Knowledge Acquisition Policy
+
+### Baseline Knowledge
+
+Required L1 knowledge entries for this mode.
+
+- `entry_name` — Description of what this knowledge covers
+- `another_entry` — Description of another required knowledge area
+
+### Active Monitoring
+
+Topics and sources to track for knowledge updates.
+
+- Source or topic to monitor (frequency)
+
+### Acquisition Behavior
+
+- **On session start**: Check baseline entries against L1 knowledge. Report gaps.
+- **On gap found**: Propose creating the missing L1 entry with a draft outline.
+- **Frequency**: Check baseline every session.
+- **Cross-instance (opt-in)**: When connected to a Meeting Place, you may
+  publish knowledge needs to the board using `meeting_publish_needs(opt_in: true)`.
+  Other agents browsing the board may discover and offer relevant knowledge.
+```
+
+### Format Rules
+
+- Start the section with `## Knowledge Acquisition Policy`
+- List baseline entries under `### Baseline Knowledge` using: `` - `name` — description ``
+- Separators between name and description: `—`, `--`, `:`, or `-` are all accepted
+- `### Active Monitoring` and `### Acquisition Behavior` are LLM-facing guidance
+  (not parsed programmatically)
+
+### Usage
+
+Run `skills_audit(command: "gaps")` to check the current mode's baseline against
+existing L1 knowledge. Missing entries are reported with suggested creation commands.
+
 ## Progressive Concept Introduction
 
 Introduce KairosChain concepts only when they become relevant:

data/templates/skillsets/hestia/lib/hestia/place_router.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'json'
+require 'uri'
 
 module Hestia
   # PlaceRouter handles Meeting Place HTTP endpoints under /place/v1/*.
@@ -102,6 +103,10 @@ module Hestia
         handle_list_agents(env)
       when ['GET', '/place/v1/board/browse']
         handle_browse(env)
+      when ['POST', '/place/v1/board/needs']
+        handle_post_needs(env)
+      when ['DELETE', '/place/v1/board/needs']
+        handle_delete_needs(env)
       else
         # Check for /place/v1/keys/:id pattern
         if request_method == 'GET' && path.start_with?('/place/v1/keys/')
@@ -215,6 +220,9 @@ module Hestia
 
       result = @registry.unregister(agent_id)
 
+      # Clean up any posted needs for this agent
+      @skill_board.remove_needs(agent_id)
+
       # Record fade-out observation if trust anchor available
       # (agent explicitly leaving = graceful fadeout)
 
@@ -241,6 +249,49 @@ module Hestia
       json_response(200, result)
     end
 
+    # POST /place/v1/board/needs — Bearer token required
+    # Publish knowledge needs to the board (session-only, in-memory)
+    def handle_post_needs(env)
+      body = parse_body(env)
+      agent_id = body['agent_id']
+      agent_name = body['agent_name'] || 'Unknown Agent'
+      agent_mode = body['agent_mode'] || 'unknown'
+      needs = body['needs'] || []
+
+      unless agent_id
+        return json_response(400, { error: 'missing_agent_id', message: 'agent_id is required' })
+      end
+
+      @skill_board.post_need(
+        agent_id: agent_id,
+        agent_name: agent_name,
+        agent_mode: agent_mode,
+        needs: needs.map { |n| { name: n['name'], description: n['description'] } }
+      )
+
+      json_response(200, {
+        status: 'published',
+        agent_id: agent_id,
+        needs_count: needs.size,
+        session_only: true
+      })
+    end
+
+    # DELETE /place/v1/board/needs — Bearer token required
+    # Remove all needs posted by an agent
+    def handle_delete_needs(env)
+      body = parse_body(env)
+      agent_id = body['agent_id']
+
+      unless agent_id
+        return json_response(400, { error: 'missing_agent_id', message: 'agent_id is required' })
+      end
+
+      @skill_board.remove_needs(agent_id)
+
+      json_response(200, { status: 'removed', agent_id: agent_id })
+    end
+
     # GET /place/v1/keys/:id — Bearer token required
     def handle_get_key(path)
       agent_id = path.sub('/place/v1/keys/', '')

data/templates/skillsets/hestia/lib/hestia/skill_board.rb

@@ -13,6 +13,32 @@ module Hestia
 
     def initialize(registry:)
       @registry = registry
+      @posted_needs = []
+    end
+
+    # Post knowledge needs for an agent (session-only, no persistence — DEE compliant).
+    # Overwrites existing needs for the same agent_id.
+    #
+    # @param agent_id [String] The agent's unique identifier
+    # @param agent_name [String] Human-readable agent name
+    # @param agent_mode [String] The agent's instruction mode
+    # @param needs [Array<Hash>] List of { name:, description: } hashes
+    def post_need(agent_id:, agent_name:, agent_mode:, needs:)
+      @posted_needs.reject! { |n| n[:agent_id] == agent_id }
+      @posted_needs << {
+        agent_id: agent_id,
+        agent_name: agent_name,
+        agent_mode: agent_mode,
+        needs: needs,
+        published_at: Time.now.utc.iso8601
+      }
+    end
+
+    # Remove all needs posted by an agent (called on unregister cleanup).
+    #
+    # @param agent_id [String] The agent's unique identifier
+    def remove_needs(agent_id)
+      @posted_needs.reject! { |n| n[:agent_id] == agent_id }
     end
 
     # Browse available skills across all registered agents.
@@ -79,6 +105,22 @@ module Hestia
         }
       end
 
+      # Add need entries from posted needs (session-only, in-memory)
+      @posted_needs.each do |posted|
+        posted[:needs].each do |need|
+          entries << {
+            agent_id: posted[:agent_id],
+            agent_name: posted[:agent_name],
+            name: need[:name],
+            format: 'need',
+            description: need[:description],
+            agent_mode: posted[:agent_mode],
+            tags: ['knowledge_need'],
+            published_at: posted[:published_at]
+          }
+        end
+      end
+
       entries
     end
   end

data/templates/skillsets/hestia/skillset.json

@@ -12,7 +12,8 @@
     "KairosMcp::SkillSets::Hestia::Tools::PhilosophyAnchor",
     "KairosMcp::SkillSets::Hestia::Tools::RecordObservation",
     "KairosMcp::SkillSets::Hestia::Tools::MeetingPlaceStart",
-    "KairosMcp::SkillSets::Hestia::Tools::MeetingPlaceStatus"
+    "KairosMcp::SkillSets::Hestia::Tools::MeetingPlaceStatus",
+    "KairosMcp::SkillSets::Hestia::Tools::MeetingPublishNeeds"
   ],
   "config_files": ["config/hestia.yml"],
   "knowledge_dirs": ["knowledge/hestia_meeting_place"]

data/templates/skillsets/hestia/tools/meeting_publish_needs.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'uri'
+require 'json'
+
+module KairosMcp
+  module SkillSets
+    module Hestia
+      module Tools
+        # Publish knowledge needs to a Meeting Place board.
+        #
+        # DEE compliance:
+        # - Requires explicit opt_in: true (no silent publishing)
+        # - Needs are session-only (in-memory on the Place, no persistence)
+        # - No aggregation or ranking of needs (D3, D5)
+        class MeetingPublishNeeds < KairosMcp::Tools::BaseTool
+          def name
+            'meeting_publish_needs'
+          end
+
+          def description
+            'Publish knowledge needs (gaps) to a Meeting Place board. ' \
+            'Other agents browsing the board can discover and offer relevant knowledge. ' \
+            'Requires explicit opt-in and an active Meeting Place connection.'
+          end
+
+          def category
+            :meeting_place
+          end
+
+          def usecase_tags
+            %w[hestia meeting needs knowledge gaps cross-instance board publish]
+          end
+
+          def related_tools
+            %w[skills_audit meeting_connect meeting_place_status]
+          end
+
+          def input_schema
+            {
+              type: 'object',
+              properties: {
+                opt_in: {
+                  type: 'boolean',
+                  description: 'Explicit opt-in to publish knowledge needs. Must be true.'
+                },
+                mode_name: {
+                  type: 'string',
+                  description: 'Instruction mode name to check gaps for (defaults to current active mode)'
+                }
+              },
+              required: ['opt_in']
+            }
+          end
+
+          def call(arguments)
+            unless arguments['opt_in'] == true
+              return text_content(JSON.pretty_generate({
+                error: 'opt_in_required',
+                message: 'Publishing knowledge needs requires explicit opt-in. ' \
+                         'Call with opt_in: true to confirm.'
+              }))
+            end
+
+            # Load connection state
+            connection_file = File.join(KairosMcp.storage_dir, 'meeting_connection.json')
+            unless File.exist?(connection_file)
+              return text_content(JSON.pretty_generate({
+                error: 'not_connected',
+                message: 'No active Meeting Place connection. Use meeting_connect first.'
+              }))
+            end
+
+            connection = JSON.parse(File.read(connection_file), symbolize_names: true)
+            unless connection[:connected]
+              return text_content(JSON.pretty_generate({
+                error: 'not_connected',
+                message: 'Meeting Place connection is not active. Reconnect using meeting_connect.'
+              }))
+            end
+
+            place_url = connection[:url] || connection.dig(:meeting_place, :url)
+            agent_id = connection[:self_agent_id]
+
+            unless place_url && agent_id
+              return text_content(JSON.pretty_generate({
+                error: 'invalid_connection',
+                message: 'Connection state is missing url or agent_id. Reconnect using meeting_connect.'
+              }))
+            end
+
+            # Compute knowledge needs using skills_audit logic
+            audit_tool = KairosMcp::Tools::SkillsAudit.new
+            mode_name = arguments['mode_name'] || audit_tool.send(:current_mode_name)
+            needs_data = audit_tool.send(:build_knowledge_needs, mode_name)
+
+            if needs_data[:needs].empty?
+              return text_content(JSON.pretty_generate({
+                status: 'no_needs',
+                mode: mode_name,
+                message: 'All baseline knowledge is present. Nothing to publish.'
+              }))
+            end
+
+            # Read session token from connection state
+            session_token = connection[:session_token]
+
+            # POST needs to the Meeting Place board
+            mmp_config = ::MMP.load_config rescue {}
+            agent_name = mmp_config.dig('identity', 'name') || 'KairosChain Instance'
+
+            post_body = {
+              agent_id: agent_id,
+              agent_name: agent_name,
+              agent_mode: mode_name,
+              needs: needs_data[:needs]
+            }
+
+            result = http_post(
+              "#{place_url}/place/v1/board/needs",
+              post_body,
+              session_token
+            )
+
+            if result
+              text_content(JSON.pretty_generate({
+                status: 'published',
+                mode: mode_name,
+                needs_count: needs_data[:needs].size,
+                needs: needs_data[:needs],
+                place_url: place_url,
+                session_only: true,
+                hint: 'Needs are visible to other agents browsing the board. ' \
+                      'They will be removed when you disconnect.'
+              }))
+            else
+              text_content(JSON.pretty_generate({
+                error: 'publish_failed',
+                message: 'Failed to publish needs to Meeting Place. ' \
+                         'The Place may be unreachable or the session may have expired.',
+                place_url: place_url
+              }))
+            end
+          rescue StandardError => e
+            text_content(JSON.pretty_generate({
+              error: 'unexpected_error',
+              message: e.message
+            }))
+          end
+
+          private
+
+          def http_post(url, body, token = nil)
+            uri = URI.parse(url)
+            http = Net::HTTP.new(uri.host, uri.port)
+            http.use_ssl = uri.scheme == 'https'
+            req = Net::HTTP::Post.new(uri.path)
+            req['Content-Type'] = 'application/json'
+            req['Authorization'] = "Bearer #{token}" if token
+            req.body = JSON.generate(body)
+            response = http.request(req)
+            response.is_a?(Net::HTTPSuccess) ? JSON.parse(response.body, symbolize_names: true) : nil
+          rescue StandardError
+            nil
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kairos-chain
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors:
 - Masa Hatakeyama
@@ -221,6 +221,7 @@ files:
 - templates/skillsets/hestia/tools/chain_migrate_status.rb
 - templates/skillsets/hestia/tools/meeting_place_start.rb
 - templates/skillsets/hestia/tools/meeting_place_status.rb
+- templates/skillsets/hestia/tools/meeting_publish_needs.rb
 - templates/skillsets/hestia/tools/philosophy_anchor.rb
 - templates/skillsets/hestia/tools/record_observation.rb
 - templates/skillsets/mmp/config/meeting.yml
@@ -269,7 +270,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: KairosChain - Memory-driven agent framework with blockchain auditability