@smartmemory/compose 0.2.48-beta → 0.2.49-beta

package/.claude/skills/compose/SKILL.md

@@ -596,6 +596,8 @@ Authoritative list lives in `compose/.compose-deps.json`. Run `compose doctor` t
 
 The manifest declares 12 external skills/commands across `superpowers:*`, `interface-design:*`, `codex:review`, `refactor`, and `update-docs`. Each entry carries `id`, `required_for`, `install`, `fallback` (or null), and `optional`.
 
+The manifest also has an optional `external_binaries` array for CLI tools (not skills). Today it declares `rtk` ([Rust Token Killer](https://github.com/rtk-ai/rtk), COMP-RTK-INTEROP) — a lossy output compressor compose routes its one LLM-bound `git diff` (the Codex review diff) through when present, degrading byte-identically when absent. `compose doctor` reports binaries alongside skills and surfaces each binary's `recommend` (for rtk: `rtk init -g`, which installs RTK's Claude Code hook so the agent's *own* Bash output is compressed too — the larger token win). Binary entries carry `id`, `detect`, `install`, `recommend` (or null), and `optional`; all are optional and never block the lifecycle.
+
 ### Degrade pattern
 
 At lifecycle entry (Phase 1), run `compose doctor --json`. For each missing dep:

package/.compose-deps.json

@@ -85,5 +85,18 @@
       "fallback": "manual TODO surfaced in implementation report",
       "optional": true
     }
+  ],
+  "external_binaries": [
+    {
+      "id": "rtk",
+      "detect": "rtk --version",
+      "required_for": [
+        "LLM-bound git-diff compression (build review)",
+        "agent Bash output compression via `rtk init -g` hook"
+      ],
+      "install": "brew install rtk  (or: cargo install --git https://github.com/rtk-ai/rtk)",
+      "recommend": "rtk init -g",
+      "optional": true
+    }
   ]
 }

package/bin/compose.js

@@ -81,7 +81,7 @@ function resolveCwdWithWorkspace(args) {
 // --team flag (COMP-TEAMS)
 // ---------------------------------------------------------------------------
 import { parseTeamFlag } from '../lib/team-flag.js';
-import { loadDeps, checkExternalSkills, printDepReport, buildDepReport } from '../lib/deps.js';
+import { loadDeps, checkExternalSkills, printDepReport, buildDepReport, checkExternalBinaries, printBinaryReport, buildBinaryReport } from '../lib/deps.js';
 import { checkLatestVersion } from '../lib/version-check.js';
 
 const [,, cmd, ...args] = process.argv
@@ -271,6 +271,7 @@ function syncSkills(agents) {
   if (deps) {
     const result = checkExternalSkills(deps)
     printDepReport(result)
+    printBinaryReport(checkExternalBinaries(deps))
   }
 }
 
@@ -302,7 +303,8 @@ async function runDoctor(flags = []) {
     // Single top-level JSON document — the deps report and the version block share one root
     // so consumers like `JSON.parse(stdout)` work. (Previously two concatenated objects.)
     const report = buildDepReport(result)
-    console.log(JSON.stringify({ ...report, version: versionInfo }, null, 2))
+    const binaries = buildBinaryReport(checkExternalBinaries(deps))
+    console.log(JSON.stringify({ ...report, binaries, version: versionInfo }, null, 2))
     const allRequiredPresent = result.missing.every(d => d.optional)
     if (strict && !allRequiredPresent) process.exit(1)
     return
@@ -323,6 +325,7 @@ async function runDoctor(flags = []) {
   }
 
   const allRequiredPresent = printDepReport(result, { json: false, verbose })
+  printBinaryReport(checkExternalBinaries(deps))
   if (strict && !allRequiredPresent) process.exit(1)
 }