kairos-chain 3.25.2 → 3.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ff49b5dba49e9c78161990be5bbf9bc94252542aeafe636b0c6cd424952ccff
-  data.tar.gz: 816f240e2cea9d045b4ac0c19c622792fe603dc49d2b454ec9409a8a6ab4f74a
+  metadata.gz: efb171bcb7680f795a7132e8d2d68ffb5ca4574d298ca1ea47ac7d44b42398e8
+  data.tar.gz: da787664c3683e38f960da502a395bdde91285550a9af8003b59c2cc5cd5cfef
 SHA512:
-  metadata.gz: aa98790fe6f4b71d1995b6d6a6822692a246c5aff24e3d99c9087ed44e78c9dc92ee19497628335862b1b6c93d156da514a7059bb275116d6e2ee62474e091a2
-  data.tar.gz: d50285be992138c811fb27bf9bf375648bbab801b71f37c9150d980996fc418da9e8bbd0bbaed6b506d19ecb187df932395f0a70f4501772b027c2bea8695581
+  metadata.gz: 1ed8251d8184beed84b8b3d424a32d5e81c667d30f304e90767aa7d80f279291ef2ce18ed129bd1ddc5c527d2ae03b153854c400f1d929f7acc17c50b43e930c
+  data.tar.gz: f386544999d14dff7298ecbfcb2c5939adc593767d2dc10843bc09e2e143bc003f2616dc8f01f463bf22f8b75b3571007c7a4e389477e4401dd486377cab0f18

data/CHANGELOG.md

@@ -4,6 +4,58 @@ All notable changes to the `kairos-chain` gem will be documented in this file.
 
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [3.26.0] - 2026-05-12
+
+### Added — consumer_project_root separation (design v0.2)
+
+Decouples the consumer project root (where `CLAUDE.md` and `.claude/` are written)
+from the data directory (where `.kairos/` lives). Fixes silent projection failure
+when `--data-dir` points outside the consumer workspace
+(see `log/handoff_kairoschain_plugin_projection_bug.md`).
+
+- `KairosMcp.consumer_project_root` accessor + `consumer_project_root_source`
+  provenance (`:explicit_cli`, `:explicit_env`, `:transport_default`, `:absent`).
+- Resolution order: `--project-root` CLI flag → `KAIROS_PROJECT_ROOT` env →
+  per-transport default with plausibility check.
+- Plausibility markers: `CLAUDE.md`, `.git/`, `.claude/`, or prior
+  `.kairos/projection_manifest.json`.
+- `PluginProjector` constructor accepts `data_dir:` kwarg; refuses construction
+  (`CoincidenceRefused`) when project root and data dir resolve to the same
+  real path.
+- `kairos-chain mode project|status` now prints resolved project root + source +
+  data dir.
+- New `--project-root <path>` global flag and `mode` subcommand option.
+- Manifest files (`projection_manifest.json`,
+  `instruction_mode_manifest.json`) now live under `data_dir/`, decoupled from
+  `project_root/.kairos/`.
+
+### Design references
+
+- Design draft v0.2: `log/20260512_consumer_project_root_separation_design_v0.2.md`
+- Multi-LLM review round 1 verdict: REVISE (1/5 APPROVE).
+  Reject log: `log/20260512_consumer_project_root_separation_design_v0.2_reject_log.md`.
+
+### Out of scope (deferred to future releases)
+
+- Multi-consumer routing (Inv 9 invariant declared, implementation deferred —
+  single-consumer only in 3.26.0).
+- Remote HTTP MCP projection delivery: HTTP MCP transport now loud-refuses
+  when no explicit `--project-root` is configured (no more silent failure),
+  but cross-machine artifact delivery is unimplemented. Local HTTP with
+  explicit configuration works.
+- Explicit authorization UX (e.g. `kairos-chain mode authorize`): v0.2 treats
+  explicit designation as implicit authorization.
+
+### Tests
+
+- New `test_consumer_project_root.rb` (18 runs, 43 assertions) covering:
+  default rule per transport, plausibility check, symlink real-path resolution,
+  `PluginProjector` coincidence refusal, and SUSHI-bug regression scenarios.
+- Updated `test_plugin_projector_instruction_mode.rb` for new manifest location.
+- All existing test suites pass (186 total across `test_plugin_projector.rb`,
+  `test_plugin_projector_instruction_mode.rb`, `test_capability.rb`,
+  `test_skillset_manager.rb`, `test_consumer_project_root.rb`).
+
 ## [3.25.2] - 2026-05-07
 
 ### Changed (L1 knowledge: reviewer evaluation feedback loop)

data/bin/kairos-chain

@@ -370,9 +370,18 @@ when 'mode'
                   region from CLAUDE.md. Manifest is cleared.
 
       Options:
-        --data-dir DIR   Override the .kairos/ data directory location.
+        --data-dir DIR       Override the .kairos/ data directory location.
+        --project-root DIR   Consumer project root (where CLAUDE.md and .claude/
+                             are written). Resolution order: --project-root,
+                             KAIROS_PROJECT_ROOT env, then cwd if it contains a
+                             recognizable project marker (CLAUDE.md, .git/,
+                             .claude/, or prior projection manifest).
 
       Notes:
+        - data_dir and consumer project root are decoupled (design v0.2,
+          log/20260512_consumer_project_root_separation_design_v0.2.md).
+          When --data-dir points outside the consumer workspace, you MUST
+          set --project-root (or KAIROS_PROJECT_ROOT) explicitly.
         - The active mode is read from `instructions_mode` in
           .kairos/skills/config.yml. Use `instructions_update` MCP tool
           to change it; then re-run `mode project`.
@@ -394,12 +403,35 @@ when 'mode'
     ARGV.delete_at(idx)
   end
 
+  # v0.2: Honor --project-root if present (consumer project root, distinct from data_dir)
+  if (idx = ARGV.index('--project-root'))
+    KairosMcp.consumer_project_root = File.expand_path(ARGV[idx + 1])
+    ARGV.delete_at(idx + 1)
+    ARGV.delete_at(idx)
+  end
+
   require 'kairos_mcp/skills_config'
   require 'kairos_mcp/plugin_projector'
 
-  project_root = KairosMcp.project_root
+  # v0.2: resolve consumer_project_root via the documented order (CLI → env → cwd default).
+  # CLI-direct transport is implicit here (we are running from the user's shell).
+  project_root = KairosMcp.resolve_consumer_project_root(transport: :cli_direct)
+  if project_root.nil?
+    warn "ERROR: no plausible consumer project root resolved."
+    warn "  Set explicitly with --project-root <path> or KAIROS_PROJECT_ROOT env var,"
+    warn "  or run from a directory containing a recognizable project marker"
+    warn "  (CLAUDE.md, .git/, .claude/, or a prior .kairos/projection_manifest.json)."
+    exit 1
+  end
+
   projector_mode = KairosMcp.projection_mode
-  projector = KairosMcp::PluginProjector.new(project_root, mode: projector_mode)
+  begin
+    projector = KairosMcp::PluginProjector.new(project_root, mode: projector_mode, data_dir: KairosMcp.data_dir)
+  rescue KairosMcp::PluginProjector::CoincidenceRefused => e
+    warn "ERROR: #{e.message}"
+    warn "  Use --project-root <path> to designate a directory distinct from the data directory."
+    exit 1
+  end
 
   case mode_action
   when 'project'
@@ -433,17 +465,21 @@ when 'mode'
     end
 
     puts "Instruction mode projected:"
-    puts "  mode      : #{instructions_mode}#{version ? " v#{version}" : ''}"
-    puts "  source    : #{body_path}"
-    puts "  artifact  : #{result[:artifact_path]}"
-    puts "  size      : #{result[:size_bytes]} bytes"
-    puts "  CLAUDE.md : region #{result[:region_written] ? 'updated' : 'not updated (host file outside project root or unsafe)'}"
+    puts "  mode             : #{instructions_mode}#{version ? " v#{version}" : ''}"
+    puts "  body source      : #{body_path}"
+    puts "  project root     : #{project_root} (source: #{KairosMcp.consumer_project_root_source})"
+    puts "  data dir         : #{KairosMcp.data_dir}"
+    puts "  artifact         : #{result[:artifact_path]}"
+    puts "  size             : #{result[:size_bytes]} bytes"
+    puts "  CLAUDE.md region : #{result[:region_written] ? 'updated' : 'not updated (host file outside project root or unsafe)'}"
     puts ""
     puts "Restart Claude Code to apply (CLAUDE.md @-imports resolve at session start)."
     exit 0
 
   when 'status'
     s = projector.instruction_mode_status
+    puts "Project root        : #{project_root} (source: #{KairosMcp.consumer_project_root_source})"
+    puts "Data dir            : #{KairosMcp.data_dir}"
     if s[:active]
       puts "Instruction mode projection: ACTIVE"
       puts "  mode      : #{s[:mode_name]}#{s[:mode_version] ? " v#{s[:mode_version]}" : ''}"
@@ -481,6 +517,10 @@ OptionParser.new do |opts|
     options[:data_dir] = dir
   end
 
+  opts.on('--project-root DIR', 'Consumer project root for projection artifacts (default: KAIROS_PROJECT_ROOT env, then cwd with plausibility check)') do |dir|
+    options[:project_root] = dir
+  end
+
   opts.on('--http', 'Start in Streamable HTTP mode (default: stdio)') do
     options[:http] = true
   end
@@ -556,6 +596,11 @@ if options[:data_dir]
   KairosMcp.data_dir = File.expand_path(options[:data_dir])
 end
 
+# v0.2: Set consumer_project_root if specified via CLI
+if options[:project_root]
+  KairosMcp.consumer_project_root = File.expand_path(options[:project_root])
+end
+
 # Handle --version
 if options[:version]
   puts "KairosChain MCP Server v#{KairosMcp::VERSION}"

data/lib/kairos_mcp/plugin_projector.rb

@@ -27,14 +27,33 @@ module KairosMcp
     INSTRUCTION_MODE_SIZE_WARN    = 150 * 1024
     INSTRUCTION_MODE_SIZE_REFUSE  = 256 * 1024
 
-    attr_reader :mode, :project_root, :output_root
+    attr_reader :mode, :project_root, :output_root, :data_dir
 
-    def initialize(project_root, mode: :auto)
+    # Construct a PluginProjector.
+    #
+    # @param project_root [String] consumer project root (where .claude/ and CLAUDE.md live)
+    # @param mode [Symbol] :auto, :project, or :plugin
+    # @param data_dir [String, nil] KairosChain data directory. When provided, the
+    #   projector enforces design v0.2 Inv 3: refuses construction when
+    #   real_path(project_root) == real_path(data_dir). When nil, the legacy assumption
+    #   data_dir = project_root/.kairos is used for manifest location (backward-compat).
+    #
+    # @raise [CoincidenceRefused] when project_root and data_dir resolve to the same real path
+    def initialize(project_root, mode: :auto, data_dir: nil)
       @project_root = project_root
+      @data_dir = data_dir || File.join(project_root, '.kairos')
+      enforce_no_coincidence!
       @mode = resolve_mode(mode)
       @output_root = @mode == :plugin ? project_root : File.join(project_root, '.claude')
-      @manifest_path = File.join(project_root, '.kairos', 'projection_manifest.json')
-      @instruction_mode_manifest_path = File.join(project_root, '.kairos', 'instruction_mode_manifest.json')
+      @manifest_path = File.join(@data_dir, 'projection_manifest.json')
+      @instruction_mode_manifest_path = File.join(@data_dir, 'instruction_mode_manifest.json')
+    end
+
+    # Raised when project_root and data_dir resolve to the same real path (design Inv 3).
+    class CoincidenceRefused < StandardError
+      def initialize(path)
+        super("consumer project root and data directory coincide at real path #{path.inspect} (design Inv 3): explicit configuration required")
+      end
     end
 
     # Main entry: project all SkillSet plugin artifacts + L1 knowledge meta skill
@@ -185,6 +204,23 @@ module KairosMcp
       :project
     end
 
+    # Inv 3 enforcement: refuse if project_root and data_dir resolve to the same
+    # real path. Comparison happens post-realpath (design Inv 8). Non-existent
+    # paths fall back to expand_path; coincidence at expand_path level still counts.
+    def enforce_no_coincidence!
+      pr_real = canonicalize(@project_root)
+      dd_real = canonicalize(@data_dir)
+      return unless pr_real && dd_real && pr_real == dd_real
+      raise CoincidenceRefused, pr_real
+    end
+
+    def canonicalize(path)
+      return nil if path.nil?
+      File.realpath(File.expand_path(path))
+    rescue Errno::ENOENT
+      File.expand_path(path)
+    end
+
     # =========================================================================
     # Skill projection
     # =========================================================================

data/lib/kairos_mcp/protocol.rb

@@ -137,12 +137,27 @@ module KairosMcp
 
       # Project plugin artifacts (only if .claude/ exists — avoids creating
       # Claude Code artifacts for non-Claude clients like Cursor or Codex)
-      project_root = KairosMcp.project_root
+      #
+      # Design v0.2: resolve consumer_project_root explicitly. Skip projection if
+      # no plausible root is available (Inv 5: graceful skip). Refuse on coincidence
+      # with data_dir (Inv 3, raised by PluginProjector constructor).
+      project_root = KairosMcp.consumer_project_root
+      if project_root.nil?
+        warn "[PluginProjector] no plausible consumer project root resolved " \
+             "(source: #{KairosMcp.consumer_project_root_source}); projection skipped"
+        return
+      end
+
       mode = KairosMcp.projection_mode
       output_root = mode == :plugin ? project_root : File.join(project_root, '.claude')
       return unless File.directory?(output_root)
 
-      projector = PluginProjector.new(project_root, mode: mode)
+      begin
+        projector = PluginProjector.new(project_root, mode: mode, data_dir: KairosMcp.data_dir)
+      rescue PluginProjector::CoincidenceRefused => e
+        warn "[PluginProjector] #{e.message}; projection skipped"
+        return
+      end
       enabled = manager.enabled_skillsets
       knowledge_entries = collect_knowledge_entries
 
@@ -229,8 +244,9 @@ module KairosMcp
     end
 
     # True if the active instruction mode has been projected for this project.
+    # v0.2: manifest now lives at data_dir level (decoupled from project_root).
     def instruction_mode_projected?(mode)
-      manifest_path = File.join(KairosMcp.project_root, '.kairos', 'instruction_mode_manifest.json')
+      manifest_path = File.join(KairosMcp.data_dir, 'instruction_mode_manifest.json')
       return false unless File.exist?(manifest_path)
       data = JSON.parse(File.read(manifest_path))
       data['mode_name'] == mode && data['region_present']

data/lib/kairos_mcp/version.rb

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

data/lib/kairos_mcp.rb

@@ -276,12 +276,132 @@ module KairosMcp
     end
 
     # =========================================================================
-    # Plugin Projection support
+    # Plugin Projection support — consumer project root
     # =========================================================================
+    #
+    # Design v0.2 (log/20260512_consumer_project_root_separation_design_v0.2.md):
+    # consumer_project_root is decoupled from data_dir. Resolution order:
+    #   1. Explicit setter (CLI flag --project-root)
+    #   2. Environment variable KAIROS_PROJECT_ROOT
+    #   3. Per-transport default with plausibility check:
+    #        stdio_mcp / cli_direct: Dir.pwd if plausible
+    #        http_mcp: no default (returns nil; caller must refuse projection)
+    #
+    # See design §2 (invariants) and §6 (failure taxonomy).
+
+    PLAUSIBILITY_MARKERS = ['CLAUDE.md', '.git', '.claude',
+                            File.join('.kairos', 'projection_manifest.json')].freeze
+
+    # Consumer project root: where projection artifacts (CLAUDE.md, .claude/) are written.
+    # Distinct from data_dir (where KairosChain state lives).
+    #
+    # @return [String, nil] absolute real path, or nil if no plausible root is available
+    def consumer_project_root
+      resolve_consumer_project_root unless defined?(@consumer_project_root_resolved) && @consumer_project_root_resolved
+      @consumer_project_root
+    end
+
+    # Source of the currently resolved consumer_project_root.
+    # @return [Symbol] :explicit_cli, :explicit_env, :transport_default, :absent
+    def consumer_project_root_source
+      consumer_project_root # trigger resolution
+      @consumer_project_root_source || :absent
+    end
+
+    # Explicit setter (used by CLI --project-root flag).
+    # Setting to nil clears any cached resolution.
+    def consumer_project_root=(path)
+      if path.nil?
+        @consumer_project_root = nil
+        @consumer_project_root_source = :absent
+      else
+        @consumer_project_root = real_path(File.expand_path(path))
+        @consumer_project_root_source = :explicit_cli
+      end
+      @consumer_project_root_resolved = true
+    end
+
+    # Reset resolution cache (for testing or re-initialization).
+    def reset_consumer_project_root!
+      @consumer_project_root = nil
+      @consumer_project_root_source = nil
+      @consumer_project_root_resolved = false
+    end
+
+    # Resolve consumer_project_root following the documented order.
+    # @param transport [Symbol] :stdio_mcp, :http_mcp, :cli_direct (default: auto-detect)
+    # @return [String, nil] resolved absolute real path, or nil
+    def resolve_consumer_project_root(transport: nil)
+      # Skip env/default lookup if explicit setter was used
+      if @consumer_project_root_source == :explicit_cli && @consumer_project_root
+        @consumer_project_root_resolved = true
+        return @consumer_project_root
+      end
+
+      transport ||= detect_transport
+
+      # 1. Environment variable
+      if (env_val = ENV['KAIROS_PROJECT_ROOT']) && !env_val.empty?
+        @consumer_project_root = real_path(File.expand_path(env_val))
+        @consumer_project_root_source = :explicit_env
+        @consumer_project_root_resolved = true
+        return @consumer_project_root
+      end
+
+      # 2. Transport default
+      if transport == :http_mcp
+        # HTTP MCP: no default permitted (design §4)
+        @consumer_project_root = nil
+        @consumer_project_root_source = :absent
+        @consumer_project_root_resolved = true
+        return nil
+      end
+
+      # stdio_mcp / cli_direct: cwd default with plausibility
+      candidate = real_path(Dir.pwd)
+      if plausibility_check(candidate)
+        @consumer_project_root = candidate
+        @consumer_project_root_source = :transport_default
+      else
+        @consumer_project_root = nil
+        @consumer_project_root_source = :absent
+      end
+      @consumer_project_root_resolved = true
+      @consumer_project_root
+    end
+
+    # Plausibility predicate (design Inv 6 / §11).
+    # Candidate passes if any recognizable project marker exists at the path.
+    def plausibility_check(path)
+      return false if path.nil? || path.empty?
+      return false unless Dir.exist?(path)
+      PLAUSIBILITY_MARKERS.any? do |marker|
+        candidate = File.join(path, marker)
+        File.exist?(candidate) || Dir.exist?(candidate)
+      end
+    end
+
+    # Resolve a path to its real path (symlinks resolved). Falls back to expand_path
+    # for non-existent paths.
+    def real_path(path)
+      File.realpath(File.expand_path(path))
+    rescue Errno::ENOENT
+      File.expand_path(path)
+    end
+
+    # Detect current transport mode based on runtime state.
+    # @return [Symbol] :http_mcp or :stdio_mcp
+    def detect_transport
+      return :http_mcp if @http_server
+      :stdio_mcp
+    end
 
-    # Project root: parent of .kairos/ data directory
+    # DEPRECATED in v0.2: parent-of-data-dir derivation.
+    # Returns consumer_project_root when available, falling back to File.dirname(data_dir)
+    # only for backward compatibility with internal callers that have not yet been
+    # migrated. New code should use consumer_project_root and handle nil explicitly.
     def project_root
-      File.dirname(data_dir)
+      consumer_project_root || File.dirname(data_dir)
     end
 
     # Determine projection mode for PluginProjector
@@ -289,7 +409,7 @@ module KairosMcp
     # :plugin — writes to plugin root skills/, agents/, hooks/hooks.json
     def projection_mode
       return :plugin if ENV['KAIROS_PROJECTION_MODE'] == 'plugin'
-      root = project_root
+      root = consumer_project_root || File.dirname(data_dir)
       plugin_json = File.join(root, '.claude-plugin', 'plugin.json')
       claude_dir = File.join(root, '.claude')
       return :plugin if File.exist?(plugin_json) && !File.exist?(claude_dir)

data/templates/skillsets/kairos_hook_projector/plugin/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: kairos_hook_projector
+description: >
+  Compile mode_hooks definitions into the plugin_projector pipeline.
+  Use to inspect mode_hooks status (read-only in stage 0).
+---
+
+# Kairos Hook Projector
+
+Rides the existing `plugin_projector` pipeline as a compiler layer:
+mode_hooks YAML → `plugin/hooks.json` → `.claude/settings.json` (via `plugin_projector`).
+
+## Stage
+
+v0.1 stage 0: skeleton + schema + `hooks_status` (read-only). Zero side effect.
+Later stages add compile / project / unproject / composition.
+
+## Design
+
+See `docs/drafts/kairos_hook_projector_design_v0.2_draft.md` (frozen).

data/templates/skillsets/kairos_hook_projector/plugin/hooks.json

@@ -0,0 +1,3 @@
+{
+  "hooks": {}
+}

data/templates/skillsets/kairos_hook_projector/skillset.json

@@ -0,0 +1,21 @@
+{
+  "name": "kairos_hook_projector",
+  "version": "0.1.0",
+  "description": "Compiles mode_hooks definitions into the plugin_projector hook pipeline. Enables deterministic invocation paths for KairosChain MCP tools via Claude Code hooks. v0.1 stage 0: skeleton + schema + read-only status tool, zero side effect on .claude/settings.json. See docs/drafts/kairos_hook_projector_design_v0.2_draft.md.",
+  "author": "Masaomi Hatakeyama",
+  "layer": "L1",
+  "depends_on": [
+    {
+      "name": "plugin_projector"
+    }
+  ],
+  "provides": [
+    "hook_compilation",
+    "mode_hooks_schema",
+    "hooks_status_readonly"
+  ],
+  "tool_classes": [],
+  "config_files": [],
+  "knowledge_dirs": [],
+  "min_core_version": "3.25.0"
+}

data/templates/skillsets/kairos_hook_projector/test/test_skillset_json.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'minitest/autorun'
+require 'json'
+
+class TestKairosHookProjectorSkillsetJson < Minitest::Test
+  SKILLSET_ROOT = File.expand_path('..', __dir__)
+
+  def setup
+    @path = File.join(SKILLSET_ROOT, 'skillset.json')
+    @json = JSON.parse(File.read(@path))
+  end
+
+  def test_skillset_json_parses
+    assert_kind_of Hash, @json
+  end
+
+  def test_name_is_kairos_hook_projector
+    assert_equal 'kairos_hook_projector', @json['name']
+  end
+
+  def test_layer_is_l1
+    assert_equal 'L1', @json['layer']
+  end
+
+  def test_depends_on_plugin_projector
+    deps = @json['depends_on']
+    assert_kind_of Array, deps
+    names = deps.map { |d| d['name'] }
+    assert_includes names, 'plugin_projector'
+  end
+
+  def test_plugin_skill_md_exists
+    skill_md = File.join(SKILLSET_ROOT, 'plugin', 'SKILL.md')
+    assert File.exist?(skill_md), "plugin/SKILL.md must exist"
+  end
+
+  def test_plugin_hooks_json_is_empty_object
+    hooks_json = File.join(SKILLSET_ROOT, 'plugin', 'hooks.json')
+    assert File.exist?(hooks_json), "plugin/hooks.json must exist"
+    parsed = JSON.parse(File.read(hooks_json))
+    assert_equal({ 'hooks' => {} }, parsed,
+                 'stage 0: hooks.json must be {"hooks":{}} — no projections yet')
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kairos-chain
 version: !ruby/object:Gem::Version
-  version: 3.25.2
+  version: 3.26.0
 platform: ruby
 authors:
 - Masaomi Hatakeyama
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-07 00:00:00.000000000 Z
+date: 2026-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -411,6 +411,10 @@ files:
 - templates/skillsets/introspection/tools/introspection_check.rb
 - templates/skillsets/introspection/tools/introspection_health.rb
 - templates/skillsets/introspection/tools/introspection_safety.rb
+- templates/skillsets/kairos_hook_projector/plugin/SKILL.md
+- templates/skillsets/kairos_hook_projector/plugin/hooks.json
+- templates/skillsets/kairos_hook_projector/skillset.json
+- templates/skillsets/kairos_hook_projector/test/test_skillset_json.rb
 - templates/skillsets/knowledge_creator/config/knowledge_creator.yml
 - templates/skillsets/knowledge_creator/knowledge/creation_guide/creation_guide.md
 - templates/skillsets/knowledge_creator/knowledge/quality_criteria/quality_criteria.md