kairos-chain 3.26.0 → 3.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efb171bcb7680f795a7132e8d2d68ffb5ca4574d298ca1ea47ac7d44b42398e8
-  data.tar.gz: da787664c3683e38f960da502a395bdde91285550a9af8003b59c2cc5cd5cfef
+  metadata.gz: 0eb600b698a295c1d826f77fd01e7b557608b8771b1d40593406d6027b345d51
+  data.tar.gz: 6428da295ba73bcb338cfd545510cb14980288d381eac0e64eabaca9941ee354
 SHA512:
-  metadata.gz: 1ed8251d8184beed84b8b3d424a32d5e81c667d30f304e90767aa7d80f279291ef2ce18ed129bd1ddc5c527d2ae03b153854c400f1d929f7acc17c50b43e930c
-  data.tar.gz: f386544999d14dff7298ecbfcb2c5939adc593767d2dc10843bc09e2e143bc003f2616dc8f01f463bf22f8b75b3571007c7a4e389477e4401dd486377cab0f18
+  metadata.gz: 492d3c12ed01371fa093b1504fc137499a4ad1e9fac6168e3ccff8d9c3bbdc5c8b4bdf127bc8bfa6dae70f87f8bf4e8fa94a7ee8c6ecb9acd805193efede861d
+  data.tar.gz: 923e4189b8b60e1d313296513187143b63ea96ae9099e944b4ccb15ee72ec1dca82d6117bc235093dcac57a92eba82f4b6c15921992674edf57ffde2c2aa7a48

data/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to the `kairos-chain` gem will be documented in this file.
 
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [3.27.0] - 2026-05-19
+
+### Added — L1 frontmatter `relations.informed_by` on L2→L1 promotion (design v0.2)
+
+`skills_promote` now auto-attaches an `informed_by` edge to the L1 frontmatter
+`relations` list when promoting from L2, pointing to the source L2 context
+(`v1:<session_id>/<source_name>`). Existing edges of any type are preserved
+verbatim; the edge is omitted (field absent) when ancestor identification is
+not possible. Design: `docs/drafts/l1_informed_by_field_design_v0.2_draft.md`
+(multi-LLM review round 2: 4/5 APPROVE, philosophy-aligned).
+
+- Backward compatible: legacy L1 entries without `relations` continue to load.
+- Idempotent: re-promoting the same source does not duplicate the edge.
+- No backfill of existing L1 entries (Inv 5 — forward-only).
+- Read-side traversal of `informed_by` is deferred to a separate PR.
+
+Tests: `test_informed_by_promotion.rb` (15/15). Regression
+`test_dream_scan_promotion.rb` (30/30).
+
 ## [3.26.0] - 2026-05-12
 
 ### Added — consumer_project_root separation (design v0.2)

data/lib/kairos_mcp/tools/skills_promote.rb

@@ -194,11 +194,18 @@ module KairosMcp
         target_name = args['target_name'] || args['source_name']
         reason = args['reason'] || "Promoted from #{from_layer} to #{to_layer}"
 
+        # Inv 3 (design v0.2): attach informed_by edge for identifiable L2→L1 promotion
+        content_to_write = source_content[:content]
+        if from_layer == 'L2' && to_layer == 'L1'
+          ancestor = build_l2_ancestor_ref(args['session_id'], args['source_name'])
+          content_to_write = inject_informed_by(content_to_write, ancestor) if ancestor
+        end
+
         case to_layer
         when 'L1'
-          promote_to_l1(target_name, source_content[:content], reason)
+          promote_to_l1(target_name, content_to_write, reason)
         when 'L0'
-          promote_to_l0(target_name, source_content[:content], reason)
+          promote_to_l0(target_name, content_to_write, reason)
         end
       end
 
@@ -334,6 +341,38 @@ module KairosMcp
         VALID_TRANSITIONS[from]&.include?(to) || false
       end
 
+      # Build a v1-tagged L2 ancestor reference from session + source name.
+      # Returns nil if either component is missing (Inv 3: identify 不能時は field 不在).
+      def build_l2_ancestor_ref(session_id, source_name)
+        return nil if session_id.nil? || session_id.to_s.empty?
+        return nil if source_name.nil? || source_name.to_s.empty?
+        "v1:#{session_id}/#{source_name}"
+      end
+
+      # Inject an informed_by edge into the frontmatter's `relations` list.
+      # Idempotent: if the same edge already exists, content is returned unchanged.
+      # Preserves any other existing edges and unknown edge types verbatim (Inv 2).
+      def inject_informed_by(content, ancestor_ref)
+        require_relative '../anthropic_skill_parser'
+        frontmatter, body = AnthropicSkillParser.extract_frontmatter(content)
+
+        relations = frontmatter['relations']
+        relations = [] unless relations.is_a?(Array)
+
+        new_edge = { 'type' => 'informed_by', 'target' => ancestor_ref }
+        already_present = relations.any? do |e|
+          e.is_a?(Hash) && e['type'] == 'informed_by' && e['target'] == ancestor_ref
+        end
+        return content if already_present
+
+        frontmatter['relations'] = relations + [new_edge]
+        AnthropicSkillParser.generate_content(frontmatter, body)
+      rescue StandardError => e
+        # Inv 1: absence is valid — never block promotion on a frontmatter mishap.
+        warn "[SkillsPromote] informed_by injection skipped: #{e.message}"
+        content
+      end
+
       def fetch_source_content(args)
         from_layer = args['from_layer']
         source_name = args['source_name']

data/lib/kairos_mcp/version.rb

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

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

@@ -29,6 +29,39 @@ Projection runs automatically:
 
 Run `/reload-plugins` after projection to activate new skills in Claude Code.
 
+## Cross-Project Projection (`kairos-chain mode project`)
+
+Project an instruction mode from one KairosChain data directory into a *different* consumer project root.
+
+### Command shape
+
+```
+kairos-chain mode project \
+  --data-dir   /path/to/source/.kairos \
+  --project-root /path/to/consumer_project
+```
+
+- `--data-dir`: where the mode body is read from (`<data-dir>/skills/<active_mode>.md`).
+- `--project-root`: where `CLAUDE.md` and `.claude/kairos/instruction_mode.md` are written.
+- When `--data-dir` points outside the consumer workspace, `--project-root` is **required** (no plausible cwd default). `data_dir == project_root` is refused (`CoincidenceRefused`, v3.26.0).
+
+### Which mode gets projected
+
+The active mode is **not** chosen by the CLI — it is read from `instructions_mode` in `<data-dir>/skills/config.yml`. If that says `tutorial`, tutorial is projected even when `masa.md` exists in the same `skills/` directory.
+
+To switch the active mode before projecting:
+
+- Preferred: `instructions_update(mode: "masa")` MCP tool (records to blockchain).
+- Direct: edit `instructions_mode:` in `<data-dir>/skills/config.yml`, then re-run `mode project`.
+
+### Drift between config and artifact
+
+`<data-dir>/skills/config.yml` (`instructions_mode`) and `<consumer>/.claude/kairos/instruction_mode.md` can diverge silently if `mode project` is not re-run after a config change. The CLI output line `mode : <name> v<ver>` is the authoritative record of what was last projected — compare it against `instructions_mode` to detect drift.
+
+### After projection
+
+Restart Claude Code in the consumer project. CLAUDE.md `@-imports` resolve only at session start; mid-session edits to the projected artifact do **not** reach Agent tool sub-agents.
+
 ## Available Tools
 
 <!-- AUTO_TOOLS -->

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kairos-chain
 version: !ruby/object:Gem::Version
-  version: 3.26.0
+  version: 3.27.0
 platform: ruby
 authors:
 - Masaomi Hatakeyama
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-12 00:00:00.000000000 Z
+date: 2026-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest