kairos-chain 2.3.1 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e8935769926dfd8587c4c2c7fbb2e21cbc5b68b354b6837adba6dd58860e3eb
-  data.tar.gz: 16ebe9f8141a3be43e9c33b7566f74ef4962f18a30c441967642bae4f2e09150
+  metadata.gz: 52819cfdb42eed0ec8b3c0789cd19b44458dfb5446f24beb25d2ef21df7d6d75
+  data.tar.gz: 0bdfc0afa6c20c8a6b93fd348e0fbe99ccdfe81a950c158127ef526d28287c7a
 SHA512:
-  metadata.gz: 447c01e56eab57ac93784805cb05b9d9c3e81ce10277a8936efb2ad2a932eafa8d01b64c3084e4c03747ee6aa4075bed6615c4b137207e764dd4d55d6763c058
-  data.tar.gz: a3b16ccd244acdff5abe65ebd2bb265f01209fe0c6cc71eeeaaede80e0d34da5e7c417eacca442f97cd2f172530bf8e070388db0e2011ad137e1f609dad3e9d0
+  metadata.gz: 5144b19067b3a7361581312ccb2d99c0b137c8b6d2291c40b762149232f3bf42fa8ae365c28ba3580b36acda43d9e914d7e0de14c1ca5c4231213c49d565a314
+  data.tar.gz: 81d99fb9024bf56b4c3080a6c61def85d98ccb91169d14071a23aeee02cc080701077098be547a6aede583f554f4ccd3a6050b11d2927a32543cc5a14d0e8381

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.4.0] - 2026-03-03
+
+### Added
+
+- **Dynamic Persona Suggestion** (`skills_promote` command: `"suggest"`): New 2-step workflow where the LLM analyzes source content and suggests optimal personas (type and count) before running Persona Assembly. Generates a structured suggestion template with content preview, available personas, and YAML response format.
+
+- **Custom Persona Support**: Both `skills_promote` and `skills_audit` now accept arbitrary custom persona names in the `personas` parameter. The LLM infers roles from persona names and context when no pre-defined definition exists.
+
+- **Improved Unknown Persona Handling**:
+  - `skills_promote`: Unknown personas now show "(custom persona — no pre-defined definition. Infer role from name and evaluate accordingly.)" instead of "(definition not found)"
+  - `skills_audit`: Unknown personas get a rich template with humanized name, inferred focus, and key insight fields
+
+---
+
+## [2.3.1] - 2026-03-03
+
+### Fixed
+
+- **Tutorial mode activation**: Mark `kairos_tutorial.md` as ACTIVE when tutorial mode is set
+- **SystemUpgrade**: Add missing `require 'fileutils'` and resolve gem-internal template paths
+
+---
+
 ## [2.3.0] - 2026-03-03
 
 ### Added
@@ -261,6 +284,9 @@ This project follows [Semantic Versioning](https://semver.org/).
 - Skill promotion with Persona Assembly
 - Tool guide and metadata system
 
+[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
 [2.2.0]: https://github.com/masaomi/KairosChain_2026/compare/v2.1.0...v2.2.0
 [2.0.5]: https://github.com/masaomi/KairosChain_2026/compare/v2.0.4...v2.0.5
 [2.0.4]: https://github.com/masaomi/KairosChain_2026/compare/v2.0.3...v2.0.4

data/lib/kairos_mcp/tools/instructions_update.rb

@@ -131,7 +131,8 @@ module KairosMcp
           builtin = PROTECTED_FILES.include?(basename)
           active = (mode == current_mode) ||
                    (current_mode == 'developer' && basename == 'kairos.md') ||
-                   (current_mode == 'user' && basename == 'kairos_quickguide.md')
+                   (current_mode == 'user' && basename == 'kairos_quickguide.md') ||
+                   (current_mode == 'tutorial' && basename == 'kairos_tutorial.md')
           { file: basename, mode: mode, size: File.size(f), builtin: builtin, active: active }
         end
 

data/lib/kairos_mcp/tools/skills_audit.rb

@@ -114,7 +114,7 @@ module KairosMcp
             personas: {
               type: 'array',
               items: { type: 'string' },
-              description: 'Personas for assembly (default: ["archivist", "guardian", "promoter"])'
+              description: 'Personas for assembly (default: ["archivist", "guardian", "promoter"]). Pre-defined: archivist, guardian, promoter. Custom persona names are also accepted — the LLM will infer the role from the name and context.'
             },
             facilitator: {
               type: 'string',
@@ -882,11 +882,15 @@ module KairosMcp
             - **Candidates**: [Specific items ready for promotion]
           TEMPLATE
         else
+          # Custom persona: generate a descriptive template inferring role from name
+          humanized = persona.to_s.split(/[_\-]/).map(&:capitalize).join(' ')
           <<~TEMPLATE
-            
-            #### #{persona}
+
+            #### #{persona} (#{humanized} — Custom Persona)
+            - **Inferred focus**: Based on the name "#{persona}", evaluate from this perspective
             - **Position**: [SUPPORT / OPPOSE / NEUTRAL]
-            - **Assessment**: [Evaluation]
+            - **Assessment**: [Evaluation from the #{humanized} perspective]
+            - **Key insight**: [What unique perspective does this role bring?]
           TEMPLATE
         end
       end

data/lib/kairos_mcp/tools/skills_promote.rb

@@ -54,6 +54,10 @@ module KairosMcp
           {
             title: 'Check promotion requirements',
             code: 'skills_promote(command: "status", from_layer: "L1", to_layer: "L0")'
+          },
+          {
+            title: 'Suggest optimal personas for content',
+            code: 'skills_promote(command: "suggest", source_name: "my_context", from_layer: "L2", to_layer: "L1", session_id: "session_123")'
           }
         ]
       end
@@ -68,8 +72,8 @@ module KairosMcp
           properties: {
             command: {
               type: 'string',
-              description: 'Command: "analyze" (with assembly), "promote" (direct promotion), or "status" (check promotion requirements)',
-              enum: %w[analyze promote status]
+              description: 'Command: "analyze" (with assembly), "promote" (direct promotion), "status" (check requirements), or "suggest" (LLM suggests optimal personas for content)',
+              enum: %w[analyze promote status suggest]
             },
             source_name: {
               type: 'string',
@@ -100,7 +104,7 @@ module KairosMcp
             personas: {
               type: 'array',
               items: { type: 'string' },
-              description: 'Personas to use for assembly (default: ["kairos"]). Available: kairos, conservative, radical, pragmatic, optimistic, skeptic'
+              description: 'Personas to use for assembly (default: ["kairos"]). Pre-defined: kairos, conservative, radical, pragmatic, optimistic, skeptic. Custom persona names are also accepted — the LLM will infer the role from the name and context. Use command: "suggest" to get context-aware recommendations.'
             },
             assembly_mode: {
               type: 'string',
@@ -134,6 +138,8 @@ module KairosMcp
           handle_promote(arguments)
         when 'status'
           handle_status(arguments)
+        when 'suggest'
+          handle_suggest(arguments)
         else
           text_content("Unknown command: #{command}")
         end
@@ -225,6 +231,85 @@ module KairosMcp
         text_content(output)
       end
 
+      # Suggest optimal personas based on source content analysis
+      def handle_suggest(args)
+        validation = validate_promotion_args(args)
+        return text_content("Error: #{validation[:error]}") unless validation[:valid]
+
+        source_content = fetch_source_content(args)
+        return text_content("Error: #{source_content[:error]}") if source_content[:error]
+
+        persona_definitions = load_persona_definitions
+        definitions_text = persona_definitions[:definitions] || default_persona_definitions
+
+        content_preview = source_content[:content].lines.first(30).join
+        content_preview += "\n...(truncated)" if source_content[:content].lines.size > 30
+
+        output = <<~MD
+          ## Persona Suggestion Request
+
+          ### Promotion Context
+
+          | Field | Value |
+          |-------|-------|
+          | **Source** | #{args['source_name']} (#{args['from_layer']}) |
+          | **Target** | #{args['target_name'] || args['source_name']} (#{args['to_layer']}) |
+
+          ### Source Content Preview
+
+          ```
+          #{content_preview}
+          ```
+
+          ### Available Pre-defined Personas
+
+          #{definitions_text}
+
+          ---
+
+          ### Instructions
+
+          Based on the source content above, please suggest the optimal persona combination for evaluating this promotion. Consider:
+
+          1. **Content domain**: What expertise areas does this content touch? (e.g., genomics, security, philosophy, infrastructure)
+          2. **Risk level**: How significant is this promotion? (L2→L1 is lower risk than L1→L0)
+          3. **Persona selection**: Choose from pre-defined personas above, or propose new custom personas with clear role descriptions
+          4. **Persona count**: Suggest 2-5 personas depending on complexity
+
+          ### Response Format
+
+          Please respond with:
+
+          ```yaml
+          suggested_personas:
+            - name: "persona_name"
+              reason: "Why this persona is relevant"
+            - name: "another_persona"
+              reason: "Why this persona is relevant"
+          recommended_mode: "oneshot"  # or "discussion" for complex/high-risk promotions
+          rationale: "Brief explanation of why this combination is optimal"
+          ```
+
+          ### Next Step
+
+          After reviewing the suggestion, run:
+
+          ```
+          skills_promote(
+            command: "analyze",
+            source_name: "#{args['source_name']}",
+            from_layer: "#{args['from_layer']}",
+            to_layer: "#{args['to_layer']}",
+            #{args['session_id'] ? "session_id: \"#{args['session_id']}\"," : ''}
+            personas: ["suggested_persona_1", "suggested_persona_2", ...],
+            assembly_mode: "suggested_mode"
+          )
+          ```
+        MD
+
+        text_content(output)
+      end
+
       def validate_promotion_args(args)
         source_name = args['source_name']
         from_layer = args['from_layer']
@@ -466,7 +551,7 @@ module KairosMcp
           if match
             "**#{persona}**:\n#{match[1].strip.lines.first(5).join}"
           else
-            "**#{persona}**: (definition not found)"
+            "**#{persona}**: (custom persona — no pre-defined definition. Infer role from name and evaluate accordingly.)"
           end
         end
 

data/lib/kairos_mcp/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kairos-chain
 version: !ruby/object:Gem::Version
-  version: 2.3.1
+  version: 2.4.0
 platform: ruby
 authors:
 - Masa Hatakeyama
@@ -269,7 +269,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
+rubygems_version: 3.3.26
 signing_key:
 specification_version: 4
 summary: KairosChain - Memory-driven agent framework with blockchain auditability