kairos-chain 3.80.0 → 3.81.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2c2d4657c313e3452dbdfaa619a7949d9682961fe4e9ccc15e772ff580f300a
-  data.tar.gz: f276e35c55991a4ea269309e7ff6f2a94208a4e86967dc9754685a258525645c
+  metadata.gz: 0bc251869ebf7ce64e94fbae5baf21ef0eea655b6d1c42d55dfb2f7ee7c2ccc0
+  data.tar.gz: aea009fc75974ff42a05e2bc54a352c19b1192157b9fe8eefa311ae9fd096c65
 SHA512:
-  metadata.gz: d10d880b482015c17e13014e432bf383cb8003f947ce1caabc4f3f24e775228facb81f042466917f530aa4c4018443cb33567c7fd8ba41c2e3a56149a4db2417
-  data.tar.gz: 2f4b29826187f483df3a95d601623f587e28eb5575670a235706c4bc7bc8bbc73d285f3ab60f9012fd0ae391a36f294c6a28866fb9a777d60bd1b361c7e9e987
+  metadata.gz: 498212b88feb4e563e745be00467f8e206aff2c2103761c12d21695a1829201f2edae98295f61e2aaf6695f9d5e82be4f9f24a2c3ff10e868965a8cc1f1eae91
+  data.tar.gz: efe4a6d07531e77648bd175452e72036a0261d0bfb3b426b5f571b54b14a1f3f1695acc3b7d0136b64f04c33eac0e9c04dcebfb58481373af0ddbed355a8d1c4

data/CHANGELOG.md

@@ -4,6 +4,44 @@ All notable changes to the `kairos-chain` gem will be documented in this file.
 
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [3.81.0] - 2026-08-27
+
+### Changed
+
+- **`project_manager` ships its L2 comparison in Ruby, 0.7.0 -> 0.8.0.** The
+  three hook-side scripts move from Python to Ruby (`pm_l2_report.rb`,
+  `l2_scan.rb`, and the ported test), and the SessionStart hook it contributes
+  now invokes `ruby` rather than `python3`. python3 was never guaranteed on a
+  host the gem ships to; the interpreter the rest of the SkillSet already runs
+  on is. The port itself was committed before this release (`1ec9bd5`) and is
+  unchanged here — 505 execution comparisons over 101 input classes with zero
+  undeclared differences, 100 unit runs / 485 assertions green, 6/6 mutations
+  killed.
+
+  The version move is the load-bearing part of this release. Without it
+  `skillset upgrade` compares versions, finds them equal, reports UNCHANGED and
+  copies nothing, so an instance would take the new gem and keep the Python
+  scripts while the projected hook still names them.
+
+- **`project_manager/plugin/hooks.json`: the bare `ruby` is now a ruling, not
+  an open question.** The comment block previously said the resolution was
+  undecided and named two candidates — the projector embedding an absolute
+  interpreter path, or this file checking `RUBY_VERSION`. Neither ships
+  (operator ruling, 2026-08-27). The comment now records why each was declined:
+  an embedded path has to be written by the projector, which turns an
+  interpreter choice into a core change and pins every host to one machine's
+  layout; a version check in this file trades the loud failure for a quiet one;
+  and `rbenv exec` fails outright wherever rbenv is absent — a Docker ruby
+  image, a homebrew install, asdf — which is strictly worse than the bare form,
+  since those hosts run the bare form fine.
+
+  Resolution therefore stays with the host's PATH, and the residual risk is
+  stated rather than hidden: `/usr/bin/ruby` 2.6.10 fails this script at parse
+  time with a 43-line syntax error and writes no page (measured). That failure
+  is visible at session start rather than silent, and the visibility is what
+  makes the bare form acceptable rather than merely convenient. The command
+  string is unchanged by this release; only the comment moved.
+
 ## [3.80.0] - 2026-08-27
 
 ### Changed

data/lib/kairos_mcp/version.rb

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

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

@@ -64,7 +64,7 @@ Prefer the sub-agent for "what needs attention?", at session start, and for sche
 
 ## The session-start L2 comparison
 
-`scripts/pm_l2_report.py` compares the memo against the L2 context store and writes one HTML page,
+`scripts/pm_l2_report.rb` compares the memo against the L2 context store and writes one HTML page,
 to `<data dir>/log/pm_l2_report.html`. `plugin/hooks.json` declares it as a `SessionStart` hook.
 
 **Read-only by having no aim, not by checking one.** There is no output-path argument, so nothing
@@ -72,14 +72,11 @@ can point a write at the memo, the mapping, an L2 context, or `config/pm.yml`. A
 took `-o` and guarded it by comparing resolved paths; that guard failed three ways — a case-only
 difference on a case-insensitive filesystem, a hardlink, and any read input it did not know about —
 and each failure destroyed the memo while the run printed that nothing had been written to it.
-Deleting the argument closed all three. `sys.dont_write_bytecode` is set around the derivation
-import for the same reason a second guard was not added: a `.pyc` inside the SkillSet sits inside
-`Skillset#all_file_hashes` and therefore inside `content_hash`, the value recorded on chain.
+Deleting the argument closed all three.
 
-**Paths come from this file's own location**, three levels up from `scripts/`, not from the name
-`.kairos`. `l2_scan` derives its own by appending that literal, which reported a populated instance
-as empty on every session whenever the data dir had been relocated, so its four path constants are
-re-pointed after import.
+**Paths come from each file's own location**, three levels up from `scripts/`, not from the name
+`.kairos`. Both files derive their own; appending that literal reported a populated instance as
+empty on every session whenever the data dir had been relocated under another name.
 
 **Nothing is trusted to have a type.** `pm_item` writes `due` and `touched_at` through with no check
 beyond a JSON type, and this SkillSet's own Ruby suite writes the integer `20260701` to both. Dates
@@ -140,13 +137,28 @@ the headline figures shrank without saying so.
 
 ### Tests
 
-`test/test_pm_l2_report.py`. The bar is mutation, not redness against an older commit: breaking a
-guard by one line must make the suite red. An audit of an earlier version applied 65 one-line
-mutations and 36 survived, so guards are now exercised through `main()` in a subprocess, fixtures
-are checked not to satisfy their own assertion, aggregation is tested with several items, and
-messages and exit codes are asserted by content. Of the 30 mutations that map to a reported finding,
-29 are killed; the survivor is equivalent (deleting the absent-derivation branch leaves the generic
-handler producing the same message, exit code and absence of a traceback).
+`test/test_pm_l2_report.rb` (minitest, 75 cases). The bar is mutation, not redness against an older
+commit: breaking a guard by one line must make the suite red. Guards are exercised through `main` in
+a subprocess, fixtures are checked not to satisfy their own assertion, aggregation is tested with
+several items, and messages and exit codes are asserted by content.
+
+The 2026-08-20 port to Ruby was audited that way twice, and the second audit is the one worth
+recording. The author's own harness ran 36 mutations and killed 36. Reviewers then ran 12 chosen to
+be disjoint from it and **11 survived** — the harness was not wrong, it was self-authored and
+therefore blind in exactly the places its author was. Ten distinct guards were unheld. The
+structural cause: `L2Scan.derive`, `report` and `main` — 112 of `l2_scan.rb`'s lines — had never
+been called by either suite, so every mutation there survived by construction, and three real
+defects were hiding in that region. All ten are now killed, and `derive`, `report` and
+`marker_string` have their own cases.
+
+Some cases pin measured Ruby/Python differences rather than a design constraint, and each names the
+measurement in place. `\w` is ASCII-only in Ruby, which dropped a Japanese tag out of the haystack.
+`String#split`'s limit counts parts where Python's `maxsplit` counted splits, which made a whole
+document its own frontmatter. `File.read(encoding:)` tags an encoding without validating it, where
+Python's `open(encoding=)` decoded and raised — so a memo with one bad byte could write a page that
+was not valid UTF-8 at exit 0. `sort_by` is unstable where Python's `sorted` is stable, and only
+once two distinct key values are present: a first attempt at that case used forty rows of one delta
+and passed against an unstable sort.
 
 Nothing runs this suite automatically — `rake test` collects Ruby files only.
 

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

@@ -23,7 +23,24 @@
     "into exit 0 with empty output, which is indistinguishable from a session",
     "where nothing had drifted. The script now handles its own absences and",
     "reports each in one line on stdout, so what is left uncaught is a genuine",
-    "defect and should be visible. Measured at 0.18s over 1172 contexts.",
+    "defect and should be visible. Measured at 0.27s over 1192 contexts.",
+    "",
+    "ruby, not python3. python3 was not guaranteed on any host the gem ships",
+    "to. The bare `ruby` is not guaranteed either, and saying otherwise here",
+    "would be false: /usr/bin/ruby 2.6.10 fails on this script with a 43-line",
+    "syntax error and writes no page (measured). The bare form ships anyway,",
+    "ruled 2026-08-27 after both alternatives were measured and each costs",
+    "more than it buys. An embedded absolute path has to be written by the",
+    "projector, which turns an interpreter choice into a core change and pins",
+    "every host to the layout this one happens to have. A version check in",
+    "this file trades the loud failure above for a quiet one. `rbenv exec`",
+    "fails outright wherever rbenv is absent -- a Docker ruby image, a",
+    "homebrew install, asdf -- which is strictly worse than the bare form,",
+    "since those hosts run the bare form fine. So resolution stays with the",
+    "host's PATH. When a host resolves it wrong the result is a visible",
+    "syntax error at session start, not a silent empty page, and that",
+    "visibility is what makes the bare form acceptable rather than merely",
+    "convenient. Ported 2026-08-20, ruled 2026-08-27.",
     "",
     "The command does not begin with kairos-, so projection prints one",
     "non-standard-command warning. That is the projector asking a human to look,",
@@ -36,7 +53,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 \"${KAIROS_DATA_DIR:-$CLAUDE_PROJECT_DIR/.kairos}/skillsets/project_manager/scripts/pm_l2_report.py\" --quiet",
+            "command": "ruby \"${KAIROS_DATA_DIR:-$CLAUDE_PROJECT_DIR/.kairos}/skillsets/project_manager/scripts/pm_l2_report.rb\" --quiet",
             "timeout": 20
           }
         ]