karajan-code 2.7.0 → 2.7.2

package/README.md

@@ -23,7 +23,7 @@
 
 ---
 
-> **v2.6.0 released** — Modular orchestrator + infrastructure DI + Valibot config validation. `src/orchestrator.js` split into a thin barrel + `flow-runner.js` + new `StageExecutor` contract under `src/orchestrator/stages/`. `FileSystemService` and `CommandRunner` adapters let tests swap in mocks instead of spawning real subprocesses. Config now validated with Valibot (catches `review_mode` typos, `max_iterations: 0`, bad ports at load time). HU Board auto-start gate simplified to `hu_board.auto_start` alone with a prominent cyan URL banner at pipeline init. Plus: budget comparison (With-KJ vs Without-KJ), rich session journal (decisions / iterations / summary / tree), Brain decisor with intent-driven routing, and Karajan-wide JSDoc typedefs. See [CHANGELOG.md](./CHANGELOG.md) for full history and [MIGRATION-v2.md](./MIGRATION-v2.md) for v1→v2 breaking changes.
+> **v2.7.2 released** — Skills observability: `summary.md` now shows a "Skills Used" section listing the addyosmani slugs resolved per role + OpenSkills installed/recommended, and `kj-tail` v1.37.0 highlights `[skills:*]` events with a 🎯 icon (magenta on success, yellow on graceful-degradation). Carries the full v2.7 feature set: [`addyosmani/agent-skills`](https://github.com/addyosmani/agent-skills) as Karajan's first-source process catalog (20+ lifecycle workflows — TDD, code-review-and-quality, security-and-hardening, performance-optimization, git-workflow-and-versioning, CI/CD, debugging-and-error-recovery, spec-driven-development, planning-and-task-breakdown…) injected per role **before** OpenSkills stack skills, shallow-cloned into `~/.karajan/agent-skills/` and refreshed weekly via `git pull`. SEA platform binaries (`linux-x64`, `darwin-arm64`, `win-x64`) publish correctly again after the v2.7.1 workflow fix. New CLI: `kj skills sync-addyosmani`, `kj skills list-addyosmani`. New config: `skills.sources`, `skills.addyosmani.{enabled,refreshDays,repoUrl}`. See [CHANGELOG.md](./CHANGELOG.md) for full history and [MIGRATION-v2.md](./MIGRATION-v2.md) for v1→v2 breaking changes.
 
 You describe what you want to build. Karajan orchestrates multiple AI agents to plan it, implement it, test it, review it with SonarQube, and iterate. No babysitting required.
 

package/bin/kj-tail

@@ -4,7 +4,7 @@
 
 set -euo pipefail
 
-VERSION="1.36.0"
+VERSION="1.37.0"
 
 # ── Colors ──────────────────────────────────────────────
 RED='\033[0;31m'
@@ -248,6 +248,17 @@ filter_line() {
     return
   fi
 
+  # Skills (addyosmani catalog + OpenSkills marketplace)
+  if [[ "$clean" == *"[skills:"* ]] || [[ "$clean" == *"[skills]"* ]]; then
+    # Highlight failures/unavailability in yellow, successes in magenta
+    if [[ "$clean" == *"unavailable"* ]] || [[ "$clean" == *"would have used"* ]]; then
+      echo -e "${prefix}${YELLOW}  ├─ 🎯 ${clean}${RESET}"
+    else
+      echo -e "${prefix}${MAGENTA}  ├─ 🎯 ${clean}${RESET}"
+    fi
+    return
+  fi
+
   # TDD
   if [[ "$clean" == *"TDD"* ]] || [[ "$clean" == *"tdd"* ]]; then
     echo -e "${prefix}${GREEN}  ├─ 📋 ${clean}${RESET}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "2.7.0",
+  "version": "2.7.2",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",
@@ -61,6 +61,8 @@
   "devDependencies": {
     "@changesets/cli": "^2.30.0",
     "@vitest/coverage-v8": "^4.0.18",
+    "esbuild": "^0.28.0",
+    "postject": "^1.0.0-alpha.6",
     "vitest": "^4.0.0"
   }
 }

package/scripts/build-sea.mjs

@@ -10,7 +10,7 @@
  *   4. Inject the blob into the binary with postject
  *   5. (macOS only) Re-sign the binary with ad-hoc signature
  *
- * Requirements (installed globally or via npx):
+ * Requirements (installed as devDependencies — run `npm ci` first):
  *   - esbuild
  *   - postject
  *

package/src/orchestrator/flow-runner.js

@@ -452,6 +452,14 @@ async function finalizeApprovedSession({ config, gitCtx, task, logger, session,
         finishedAt: new Date().toISOString(),
         brainDecisions: Array.isArray(session.brainDecisions) ? session.brainDecisions.length : 0,
         solomonInvocations: Array.isArray(session.solomonRulings) ? session.solomonRulings.length : 0,
+        // KJC-TSK-0327: surface skill-source decisions in the summary so the
+        // post-mortem shows which process skills (addyosmani) and stack skills
+        // (OpenSkills) actually shaped the role prompts.
+        skills: {
+          addyosmani: session.addyosmaniSkills,
+          installed: session.autoInstalledSkills,
+          recommended: session.skillsRecommended,
+        },
       }, { logger });
       logger.info(`Session journal written to ${journalDir}`);
     } catch (err) {

package/src/session/journal/summary-writer.js

@@ -26,6 +26,10 @@ import path from "node:path";
  * @property {string} [finishedAt]                 - ISO timestamp (optional)
  * @property {number} [solomonInvocations]
  * @property {number} [brainDecisions]
+ * @property {Object} [skills]                        - skill sources used this session (KJC-TSK-0327)
+ * @property {Object} [skills.addyosmani]             - { available, action, resolvedSlugs, reason }
+ * @property {string[]} [skills.installed]            - OpenSkills installed this run (session.autoInstalledSkills)
+ * @property {string[]} [skills.recommended]          - wouldHaveUsed when OpenSkills CLI missing
  */
 
 function esc(text) {
@@ -103,6 +107,48 @@ function renderBreakdownByRole(breakdown) {
   return ["| Role | Tokens | Cost |", "|---|---|---|", ...rows].join("\n");
 }
 
+/**
+ * Render the Skills section: which process skills (addyosmani) were resolved
+ * for the task, which OpenSkills were installed, and which skills would have
+ * helped but couldn't be installed (graceful-degradation path).
+ *
+ * Returns null when no skill activity happened (no addyosmani, no installs,
+ * no recommendations) so the section is elided.
+ */
+function renderSkills(skills) {
+  if (!skills || typeof skills !== "object") return null;
+  const addy = skills.addyosmani;
+  const installed = Array.isArray(skills.installed) ? skills.installed : [];
+  const recommended = Array.isArray(skills.recommended) ? skills.recommended : [];
+
+  const hasAddy = addy && (addy.available === true || addy.available === false);
+  if (!hasAddy && installed.length === 0 && recommended.length === 0) return null;
+
+  const lines = [];
+
+  if (hasAddy) {
+    if (addy.available) {
+      const action = addy.action || "ready";
+      const slugs = Array.isArray(addy.resolvedSlugs) ? addy.resolvedSlugs : [];
+      lines.push(`- **addyosmani/agent-skills** (process, 1st source): ${esc(action)}` +
+        (slugs.length > 0 ? ` — resolved slugs: ${slugs.map((s) => `\`${esc(s)}\``).join(", ")}` : " — no role/task-specific slugs resolved"));
+    } else {
+      const reason = addy.reason ? ` — ${esc(addy.reason)}` : "";
+      lines.push(`- **addyosmani/agent-skills**: unavailable${reason}`);
+    }
+  }
+
+  if (installed.length > 0) {
+    lines.push(`- **OpenSkills installed**: ${installed.map((s) => `\`${esc(s)}\``).join(", ")}`);
+  }
+
+  if (recommended.length > 0) {
+    lines.push(`- **OpenSkills recommended** (CLI missing, would-have-used): ${recommended.map((s) => `\`${esc(s)}\``).join(", ")}`);
+  }
+
+  return lines.join("\n");
+}
+
 function renderJournalLinks(files) {
   if (!Array.isArray(files) || files.length === 0) return "_No additional journal files._";
   return files.map((f) => `- [${esc(f)}](./${f})`).join("\n");
@@ -146,6 +192,11 @@ export function buildSummaryMarkdown(input) {
     sections.push("", "## Budget breakdown (by role)", "", breakdown);
   }
 
+  const skillsSection = renderSkills(input.skills);
+  if (skillsSection) {
+    sections.push("", "## Skills Used", "", skillsSection);
+  }
+
   sections.push("", "## Commits", "", renderCommits(input.commits));
 
   sections.push("", "## Journal files", "", renderJournalLinks(input.files));