kairos-chain 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd1f1f107f160749a056ce1a4ba7220ea115fdd55aab7c0045f9e957ab4f7d1e
-  data.tar.gz: a7720c953c2cd0dbc8b9a41fa49667aa87133fb040e30a241b6e4caa70d7c388
+  metadata.gz: 5fd71b1e5a02a3c56628d6af5a0e45eba34b8e345c44d82dd58be023e8eb9f2e
+  data.tar.gz: d8f57a9f80bd3338d7c329aca088b6f0185da9c21f4558c4fabab8c571e54872
 SHA512:
-  metadata.gz: 02eb1c6f9f97233e4833c0504e80feaac5a780494183c9a057db9f3c72e9f62a4120b8eb79149729800bef760bed8f7944e3a8abfc907a753ad5fea159e22634
-  data.tar.gz: 59a58fa969a9bd6d7f6e197f028e2455632ec491a54faac77d745b6bd110180d264485c739a4291ba0de8e312b609cc2f2cd4a13e82397306d37f92a4a1f3e08
+  metadata.gz: 3aa8ae7abfdbbf2c7353ab223cf2b1ed472225ce636c6ce698fb8c899d10d74347cbccbf0163c7e4775228496ff5ba75afcc7728e764cda0615f676979a03783
+  data.tar.gz: 30eebdc840a2c65c8321bacd9610899fc89d15c47ee86dd4912db619ca3ad6405ca1fa6f15ef8d14efea5791e01061ff20b7ea82233841a63e97495c1851fd63

data/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to the `kairos-chain` gem will be documented in this file.
 
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [2.0.1] - 2026-02-23
+
+### Added
+
+- **MCP Instructions**: `instructions` field in `initialize` response delivers
+  KairosChain philosophy or quick guide to LLM on connection
+  - `instructions_mode` config: `developer` (full kairos.md), `user` (quick guide), `none`
+  - New template: `kairos_quickguide.md` — concise user-facing operational guide
+- **L0-A Philosophy**: Added PHILOSOPHY-001 (Generative Principle) and
+  PHILOSOPHY-005 (Five Propositions) to `kairos.md`
+- **Agent Instruction Sync**: `scripts/sync_agent_instructions.sh` syncs CLAUDE.md
+  to `.cursor/rules/kairos.mdc` for Cursor IDE support
+- **Test**: Initialize instructions test (Test 0) in `test_local.rb`
+
 ## [2.0.0] - 2026-02-23
 
 ### Breaking Changes

data/lib/kairos_mcp/protocol.rb

@@ -1,5 +1,6 @@
 require 'json'
 require_relative 'tool_registry'
+require_relative 'skills_config'
 require_relative 'version'
 
 module KairosMcp
@@ -59,7 +60,7 @@ module KairosMcp
       @tool_registry.set_workspace(roots)
       @initialized = true
 
-      {
+      result = {
         protocolVersion: protocol_version,
         capabilities: {
           tools: {
@@ -72,6 +73,42 @@ module KairosMcp
           version: KairosMcp::VERSION
         }
       }
+
+      # Add instructions based on config mode (developer/user/none)
+      instructions = load_instructions
+      result[:instructions] = instructions if instructions
+
+      result
+    end
+
+    # Load instructions based on instructions_mode in config.yml
+    #
+    # @return [String, nil] Instructions text or nil
+    def load_instructions
+      mode = SkillsConfig.load['instructions_mode'] || 'user'
+
+      path = case mode
+             when 'developer'
+               KairosMcp.md_path           # Full philosophy (kairos.md)
+             when 'user'
+               KairosMcp.quickguide_path   # Quick guide (kairos_quickguide.md)
+             when 'none'
+               nil
+             else
+               KairosMcp.quickguide_path   # Default to user mode
+             end
+
+      return nil unless path
+
+      read_if_exists(path)
+    end
+
+    # Read file content if it exists
+    #
+    # @param path [String] File path
+    # @return [String, nil] File content or nil
+    def read_if_exists(path)
+      File.exist?(path) ? File.read(path) : nil
     end
 
     def handle_tools_list

data/lib/kairos_mcp/version.rb

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

data/lib/kairos_mcp.rb

@@ -13,20 +13,22 @@ module KairosMcp
   # Format: [template_relative_path, data_dir_accessor_symbol]
   #
   TEMPLATE_FILES = [
-    ['skills/kairos.rb',         :dsl_path],
-    ['skills/kairos.md',         :md_path],
-    ['skills/config.yml',        :skills_config_path],
-    ['config/safety.yml',        :safety_config_path],
-    ['config/tool_metadata.yml', :tool_metadata_path]
+    ['skills/kairos.rb',              :dsl_path],
+    ['skills/kairos.md',              :md_path],
+    ['skills/kairos_quickguide.md',   :quickguide_path],
+    ['skills/config.yml',             :skills_config_path],
+    ['config/safety.yml',             :safety_config_path],
+    ['config/tool_metadata.yml',      :tool_metadata_path]
   ].freeze
 
   # File type classification for upgrade conflict resolution
   TEMPLATE_FILE_TYPES = {
-    'skills/kairos.rb'         => :l0_dsl,
-    'skills/kairos.md'         => :l0_doc,
-    'skills/config.yml'        => :config_yaml,
-    'config/safety.yml'        => :config_yaml,
-    'config/tool_metadata.yml' => :config_yaml
+    'skills/kairos.rb'              => :l0_dsl,
+    'skills/kairos.md'              => :l0_doc,
+    'skills/kairos_quickguide.md'   => :l0_doc,
+    'skills/config.yml'             => :config_yaml,
+    'config/safety.yml'             => :config_yaml,
+    'config/tool_metadata.yml'      => :config_yaml
   }.freeze
 
   # =========================================================================
@@ -85,6 +87,11 @@ module KairosMcp
       File.join(skills_dir, 'kairos.md')
     end
 
+    # L0 skills quick guide file path (user-facing instructions)
+    def quickguide_path
+      File.join(skills_dir, 'kairos_quickguide.md')
+    end
+
     # L0 skills config file path
     def skills_config_path
       File.join(skills_dir, 'config.yml')

data/templates/skills/config.yml

@@ -4,6 +4,12 @@
 # General settings
 enabled: true
 evolution_enabled: false
+
+# Instructions mode: Controls what context is sent to LLM on MCP connection
+#   developer: Full philosophy (kairos.md) - for KairosChain contributors
+#   user: Quick guide only (kairos_quickguide.md) - for general users (default)
+#   none: No instructions - minimal context window usage
+instructions_mode: user
 max_evolutions_per_session: 3
 require_human_approval: true
 

data/templates/skills/kairos.md

@@ -2,6 +2,8 @@
 
 | Section ID | Title | Use When |
 |------------|-------|----------|
+| PHILOSOPHY-001 | Generative Principle | Understanding the single principle from which KairosChain's architecture flows |
+| PHILOSOPHY-005 | Five Propositions | Understanding the core propositions that summarize KairosChain's design |
 | PHILOSOPHY-010 | Core Philosophy | Understanding Kairos's fundamental vision |
 | PHILOSOPHY-020 | Minimum-Nomic | Understanding the change constraint principle |
 | PRINCIPLE-010 | Safety Principles | Understanding safety invariants |
@@ -11,6 +13,34 @@
 
 ---
 
+## [PHILOSOPHY-001] Generative Principle: Structural Self-Referentiality
+
+KairosChain's entire architecture flows from one principle:
+
+> **Meta-level operations are expressed in the same structure as base-level operations.**
+
+This is why Ruby (DSL/AST) was chosen. "Defining a Skill" and "defining the evolution rules for a Skill" use the same language, syntax, and runtime. This structural correspondence is the foundation of self-referentiality, and all other properties of KairosChain germinate from it.
+
+Self-referentiality is not a design choice but an existential condition: without definitional closure at L0, the system would be "a program following configuration" rather than "an entity that defines its own conditions of existence."
+
+---
+
+## [PHILOSOPHY-005] Five Propositions
+
+The following five propositions summarize the philosophical structure of KairosChain. They are not axioms from which everything is derived, but patterns whose recursive application at different levels produces different properties.
+
+1. **Self-referentiality and metacognition as generative seed** — A pattern whose recursive application at different levels produces different properties. Intentionally asymmetric: strongest at L0 governance core, pragmatically open at infrastructure level ("sufficient self-referentiality"). Self-referentiality is structural (L0 defining itself); metacognition is cognitive (self_inspection evaluating the system's own state). Both dimensions are core.
+
+2. **Dual integrity guarantee** — Prevention (approval_workflow's 5-layer validation) + structural impossibility (a contradictory self-referential system cannot operate). The latter holds within legitimate operation paths only.
+
+3. **Structure opens possibility space; design realizes it** — Self-referential structure automatically enables recursive extension. Individual SkillSets (MMP, HestiaChain) are engineered, but the *possibility* of expressing meta-capabilities as SkillSets is a structural consequence, not a design decision.
+
+4. **Circular integration of process and result** — Operation, evolution, and recording are functionally separated but ontologically unified through the same Skill structure. Time is Kairos (qualitative moment), not Chronos (quantitative flow).
+
+5. **Partial autopoiesis** — Self-production loop closes at the governance/capability-definition level; depends on external substrates (Ruby VM, filesystem) at the execution level. The question is "at which abstraction level does the loop close?" — not "is it complete?"
+
+---
+
 ## [PHILOSOPHY-010] Core Philosophy
 
 ### The Core Insight

data/templates/skills/kairos_quickguide.md

@@ -0,0 +1,34 @@
+# KairosChain Quick Guide
+
+KairosChain is a Meta Ledger for AI capability evolution.
+It manages knowledge in 3 layers with different levels of control.
+
+## Layers
+
+- **L2 (context/)** — Free scratchpad. Start here. No approval needed, no recording.
+- **L1 (knowledge/)** — Project knowledge. Lightweight hash recording on blockchain.
+- **L0 (skills/)** — System governance rules. Requires human approval. Fully recorded.
+
+**Rule of thumb:** If unsure where to put something, use L2 first. Promote to L1 later if it proves valuable.
+
+## Getting Started
+
+| Goal | Tool | Example |
+|------|------|---------|
+| Save notes or ideas | `context_save` | `context_save(session_id: "my_session", name: "idea", content: "...")` |
+| List project knowledge | `knowledge_list` | `knowledge_list()` |
+| Update knowledge | `knowledge_update` | `knowledge_update(name: "conventions", content: "...")` |
+| Browse all tools | `tool_guide` | `tool_guide(command: "catalog")` |
+| Check system health | `chain_status` | `chain_status()` |
+
+## Safety Notes
+
+- L0 changes require explicit human approval — the system will prompt you
+- `core_safety` skill is immutable and cannot be modified
+- All L0 and L1 changes are automatically recorded on the blockchain
+- Evolution (L0 self-modification) is disabled by default
+
+## Learn More
+
+Use `skills_list` and `skills_get` to read KairosChain's full philosophy.
+Use `tool_guide(command: "workflow")` to see common workflow patterns.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kairos-chain
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Masa Hatakeyama
@@ -180,6 +180,7 @@ files:
 - templates/skills/config.yml
 - templates/skills/kairos.md
 - templates/skills/kairos.rb
+- templates/skills/kairos_quickguide.md
 - templates/skills/versions/.gitkeep
 - templates/skillsets/hestia/config/hestia.yml
 - templates/skillsets/hestia/knowledge/hestia_meeting_place/hestia_meeting_place.md