kairos-chain 3.12.0 → 3.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e4f14b45f5ece26ac4279095f818d8772efcf5ae0d1dfb95924e2f69a2c2bcc
-  data.tar.gz: a51ac4d001f7e5c5c17491fdb168da11b04d17502972d80d1119ac99f2243acf
+  metadata.gz: 59afbb969508bd1ec45bb4d35f28cd70cc84516d88ba5dc047c07f056bc70a0b
+  data.tar.gz: 8dff4c368684c5de32a6691fe2c7c2edf0adbed7a3114211ee4343583ae5b67a
 SHA512:
-  metadata.gz: 0cb3cba2544bbb1244945199b783db04da81573dfde6d45d8c1c46d0c310e0fe26e9c521b7983263e66ec2d363c5614f630336ecdd10af056ca3ea9cb8b5ccf6
-  data.tar.gz: 64ef0f93ebc9922c5acc8bbc6f0733734e9be5445c810f51f1c2b4f55c975764f39277bf07d48a5d1477010fdb7b1c7dfe9452f88bcf3db0ed8bbd1339caf3f9
+  metadata.gz: 93131bc0d3ced8749a875ed0a316ec1107ef6a9ecfed61cb5a6f111c2bad6b5331884bc55d2669b2223730c8153c4754bc2209c5d39adf374dc4fba2272eb515
+  data.tar.gz: a2358fedff75942a10b73223c8b2e43f6d8f68b3d976be256c580682363e4cf3eae7052ce68f2707f04454cbf2317e46e8f28319d28b82aa789ed7849d353d32

data/CHANGELOG.md

@@ -4,6 +4,92 @@ All notable changes to the `kairos-chain` gem will be documented in this file.
 
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [3.14.0] - 2026-04-12
+
+### Added
+
+- **SkillSet Plugin Projection** — Self-referential dual-mode Claude Code integration.
+  Projects SkillSet artifacts (skills, agents, hooks) to `.claude/` structure.
+  - **PluginProjector** (`plugin_projector.rb`, ~430 lines): dual-mode (Project + Plugin),
+    atomic writes, digest-based no-op, manifest tracking, stale cleanup
+  - **Ruby introspection**: `<!-- AUTO_TOOLS -->` marker dynamically generates tool docs
+  - **L1 knowledge meta skill**: `<!-- AUTO_KNOWLEDGE_LIST -->` projects knowledge catalog
+  - **Self-referential SkillSet**: `plugin_projector` projects its own SKILL.md and hooks
+  - **Auto-init + auto-install**: first MCP connection initializes `.kairos/` and installs
+    9 core SkillSets (no external dependencies)
+  - **Auto-generate `.mcp.json`**: `kairos-chain init` creates MCP config with absolute paths
+  - **Plugin artifacts for 3 SkillSets**: agent (SKILL.md + monitor agent),
+    skillset_exchange (SKILL.md + reviewer agent + hooks), skillset_creator (SKILL.md)
+  - **Scaffold `has_plugin` option**: `sc_scaffold` generates `plugin/` directory
+  - **Auto-projection on upgrade**: `system_upgrade apply` and `skillset upgrade --apply`
+    trigger re-projection after SkillSet changes
+  - **Security**: SAFE_NAME_PATTERN, safe_path boundary checks, ALLOWED_HOOK_COMMANDS warning,
+    atomic writes for settings.json auto-reload safety
+  - **30 tests**, 3-LLM reviewed (Claude Opus 4.6 + Codex GPT-5.4 + Cursor Composer-2)
+
+- **2-step setup**: `kairos-chain init` + `claude` (no manual system_upgrade needed)
+
+### Changed
+
+- **Seed `skills/kairos-chain/SKILL.md`**: revised to delegate per-SkillSet workflow details
+  to individual SKILL.md files (agent, skillset_exchange, etc.)
+- **`collect_knowledge_entries`**: extracted to `KairosMcp` module (shared by protocol.rb,
+  plugin_project tool, and CLI)
+- **Core SkillSets**: auto-install limited to 9 SkillSets without external dependencies
+  (excludes multiuser/PostgreSQL, hestia/networking, etc.)
+
+### Fixed
+
+- **`.mcp.json` absolute paths**: relative `--data-dir` paths caused MCP connection failures
+  when Claude Code resolved from different working directory
+- **Non-Claude clients**: projection skipped when `.claude/` directory doesn't exist,
+  preventing unintended artifact creation for Cursor/Codex
+
+## [3.13.0] - 2026-04-02
+
+### Added
+
+- **Complexity-driven review for Agent auto mode** — New Gate 5.5a/b (pre-ACT) and
+  Gate 6.5 (post-ACT) in the Agent autonomous OODA loop.
+  - **Structural complexity assessment** with 7 signals: `high_risk`, `many_steps`,
+    `design_scope`, `l0_change`, `core_files`, `multi_file`, `state_mutation`
+  - **LLM self-assessment merge**: DECIDE prompt requests `complexity_hint`; merge rule
+    caps LLM at structural + 1 level (prevents over-reporting)
+  - **Gate 5.5a**: L0 changes always checkpoint with multi-LLM review prompt generation
+  - **Gate 5.5b**: High complexity triggers Persona Assembly review (inner retry loop
+    with max re-DECIDE attempts, risk/loop/complexity re-checks per revision)
+  - **Gate 6.5**: Medium complexity runs post-ACT lightweight advisory review
+  - Low complexity: no overhead (unchanged flow)
+  - Parse failures default to REVISE (never silent APPROVE)
+  - Persona definitions loaded from L1 knowledge with hardcoded fallback
+  - Configuration: `complexity_review` section in `agent.yml` (personas, retries,
+    L0 checkpoint policy, post-ACT toggle)
+  - New `review` phase config in `agent.yml` (max_llm_calls, max_tool_calls)
+  - Session: `save_review_result`, `load_review_result`, `save_progress_amendment`
+  - Tests: 37 new (complexity assessment, persona review parsing, config, session, prompts)
+
+### Fixed
+
+- **`llm_call.rb` eager adapter loading** — All provider adapters were unconditionally
+  required at startup, crashing with `LoadError` when optional gems (`faraday`,
+  `aws-sdk`) were not installed. Now lazy-loads adapters in `build_adapter()`;
+  only `claude_code_adapter` and base modules loaded at startup.
+- **`claude_code_adapter` recursive MCP server loading** — `claude -p` subprocess
+  loaded `.mcp.json` and spawned additional MCP server instances, causing deadlocks
+  (stdio) or port conflicts (HTTP). Fixed with `--mcp-config '{"mcpServers":{}}'`
+  and `--no-session-persistence`.
+- **`claude_code_adapter` missing timeout** — `Open3.capture3` had no timeout,
+  risking indefinite hangs. Wrapped with `Timeout.timeout` (default 120s,
+  configurable via `timeout_seconds` in `llm_client.yml`).
+
+### Design Process
+
+- Complexity review design: 2R x 2 LLMs (Claude Team, Cursor Composer) → APPROVED
+- Complexity review impl: R1 x 3 LLMs (Claude Team, Cursor, Codex) → fixes applied
+  - Codex found off-by-one in retry counter and cycle number (both fixed)
+  - R2 (Claude Team) → APPROVED
+- llm_client fixes: reported by SUSHI self-maintenance MCP project, verified in upstream
+
 ## [3.12.0] - 2026-04-02
 
 ### Added

data/bin/kairos-chain

@@ -143,6 +143,24 @@ when 'skillset'
         puts "Updated #{r[:name]}: v#{r[:from]} -> v#{r[:to]} (#{r[:files_updated]} files)"
       end
       puts "Done. #{results.size} SkillSet(s) upgraded."
+
+      # Re-project plugin artifacts if any SkillSets changed
+      if results.any?
+        begin
+          require 'kairos_mcp/plugin_projector'
+          project_root = KairosMcp.project_root
+          mode = KairosMcp.projection_mode
+          projector = KairosMcp::PluginProjector.new(project_root, mode: mode)
+          enabled = manager.enabled_skillsets
+          knowledge = KairosMcp.collect_knowledge_entries
+          if projector.project_if_changed!(enabled, knowledge_entries: knowledge)
+            puts "Plugin artifacts projected. Run /reload-plugins in Claude Code."
+          end
+        rescue => e
+          # Non-fatal: projection is optional
+          $stderr.puts "Plugin projection skipped: #{e.message}"
+        end
+      end
     else
       puts "SkillSet upgrades available:"
       puts ""

data/bin/kairos-plugin-project

@@ -0,0 +1,57 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# CLI script for plugin projection.
+# Used by Claude Code hooks and manual invocation.
+#
+# Usage:
+#   kairos-plugin-project                   # Full projection
+#   kairos-plugin-project --if-changed      # Skip if digest unchanged
+#   kairos-plugin-project --json            # Output additionalContext JSON
+#   kairos-plugin-project --status          # Show projection status
+#   kairos-plugin-project --verify          # Verify projected files
+
+require_relative '../lib/kairos_mcp'
+require_relative '../lib/kairos_mcp/plugin_projector'
+require_relative '../lib/kairos_mcp/skillset_manager'
+
+project_root = KairosMcp.project_root
+mode = KairosMcp.projection_mode
+projector = KairosMcp::PluginProjector.new(project_root, mode: mode)
+
+if ARGV.include?('--status')
+  require 'json'
+  puts JSON.pretty_generate(projector.status)
+  exit 0
+end
+
+if ARGV.include?('--verify')
+  require 'json'
+  result = projector.verify
+  puts JSON.pretty_generate(result)
+  exit(result[:valid] ? 0 : 1)
+end
+
+manager = KairosMcp::SkillSetManager.new
+enabled = manager.enabled_skillsets
+knowledge_entries = KairosMcp.collect_knowledge_entries
+
+json_mode = ARGV.include?('--json')
+
+if ARGV.include?('--if-changed')
+  changed = projector.project_if_changed!(enabled, knowledge_entries: knowledge_entries)
+  if changed
+    if json_mode
+      puts '{"additionalContext": "Plugin projection updated. Run /reload-plugins to activate new skills."}'
+    else
+      $stderr.puts "Plugin projection updated. Run /reload-plugins to activate new skills."
+    end
+  end
+else
+  projector.project!(enabled, knowledge_entries: knowledge_entries)
+  if json_mode
+    puts '{"additionalContext": "Plugin projection complete. Run /reload-plugins to activate."}'
+  else
+    $stderr.puts "Plugin projection complete."
+  end
+end

data/lib/kairos_mcp/initializer.rb

@@ -2,6 +2,7 @@
 
 require 'fileutils'
 require 'digest'
+require 'json'
 require 'yaml'
 require 'time'
 require_relative '../kairos_mcp'
@@ -51,7 +52,8 @@ module KairosMcp
       copy_templates
       copy_knowledge_templates
       write_meta
-      
+      generate_mcp_json unless @quiet
+
       log ""
       log "KairosChain data directory initialized successfully!"
       log ""
@@ -61,7 +63,7 @@ module KairosMcp
       log "  kairos-chain                          # stdio mode (for Claude Code / Cursor)"
       log "  kairos-chain --http                   # HTTP mode (for remote)"
       log ""
-      print_mcp_config
+      print_mcp_config unless @generated_mcp_json
     end
 
     private
@@ -190,6 +192,59 @@ module KairosMcp
       log "  }"
     end
 
+    # Generate .mcp.json in the project root (parent of .kairos/)
+    def generate_mcp_json
+      @generated_mcp_json = false
+      project_root = File.dirname(@data_dir)
+      mcp_json_path = File.join(project_root, '.mcp.json')
+      data_dir_absolute = File.expand_path(@data_dir)
+
+      mcp_content = JSON.pretty_generate({
+        "mcpServers" => {
+          "kairos-chain" => {
+            "command" => "kairos-chain",
+            "args" => ["--data-dir", data_dir_absolute]
+          }
+        }
+      })
+
+      if File.exist?(mcp_json_path)
+        existing = File.read(mcp_json_path)
+        if existing.include?('kairos-chain')
+          log "  .mcp.json: kairos-chain already configured (skipped)"
+          @generated_mcp_json = true
+          return
+        end
+
+        # .mcp.json exists but doesn't have kairos-chain
+        $stderr.puts ""
+        $stderr.puts "  .mcp.json already exists at: #{mcp_json_path}"
+        $stderr.puts "  Add kairos-chain MCP server to it? (y/N): "
+        answer = $stdin.gets&.strip
+        if answer&.downcase == 'y'
+          begin
+            existing_json = JSON.parse(existing)
+            existing_json['mcpServers'] ||= {}
+            existing_json['mcpServers']['kairos-chain'] = {
+              'command' => 'kairos-chain',
+              'args' => ['--data-dir', data_dir_absolute]
+            }
+            File.write(mcp_json_path, JSON.pretty_generate(existing_json) + "\n")
+            log "  .mcp.json: kairos-chain added to existing configuration"
+            @generated_mcp_json = true
+          rescue JSON::ParserError
+            log "  .mcp.json: invalid JSON, skipping. Please add kairos-chain manually."
+          end
+        else
+          log "  .mcp.json: skipped. Add kairos-chain manually (see below)."
+        end
+      else
+        File.write(mcp_json_path, mcp_content + "\n")
+        log "  .mcp.json: created with kairos-chain MCP server configuration"
+        @generated_mcp_json = true
+      end
+    end
+
     def relative_path(path)
       path.sub("#{@data_dir}/", '')
     end