selftune 0.1.4 → 0.2.0

package/cli/selftune/activation-rules.ts

@@ -0,0 +1,171 @@
+/**
+ * Default activation rules for the auto-activate hook.
+ *
+ * Each rule evaluates session context and returns a suggestion string
+ * (or null if the rule doesn't fire). Rules must be pure functions
+ * that read from the filesystem — no network calls, no imports from
+ * evolution/monitoring/grading layers.
+ */
+
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import type { ActivationContext, ActivationRule } from "./types.js";
+import { readJsonl } from "./utils/jsonl.js";
+
+// ---------------------------------------------------------------------------
+// Rule: post-session diagnostic
+// ---------------------------------------------------------------------------
+
+const postSessionDiagnostic: ActivationRule = {
+  id: "post-session-diagnostic",
+  description: "Suggest `selftune last` when session has >2 unmatched queries",
+  evaluate(ctx: ActivationContext): string | null {
+    // Count queries for this session
+    const queries = readJsonl<{ session_id: string; query: string }>(ctx.query_log_path);
+    const sessionQueries = queries.filter((q) => q.session_id === ctx.session_id);
+
+    if (sessionQueries.length === 0) return null;
+
+    // Count skill usages for this session (skill log is in the same dir as query log)
+    const skillLogPath = join(dirname(ctx.query_log_path), "skill_usage_log.jsonl");
+    const skillUsages = existsSync(skillLogPath)
+      ? readJsonl<{ session_id: string }>(skillLogPath).filter(
+          (s) => s.session_id === ctx.session_id,
+        )
+      : [];
+
+    const unmatchedCount = sessionQueries.length - skillUsages.length;
+
+    if (unmatchedCount > 2) {
+      return `Run \`selftune last\` — ${unmatchedCount} unmatched queries detected in this session.`;
+    }
+
+    return null;
+  },
+};
+
+// ---------------------------------------------------------------------------
+// Rule: grading threshold breach
+// ---------------------------------------------------------------------------
+
+const gradingThresholdBreach: ActivationRule = {
+  id: "grading-threshold-breach",
+  description: "Suggest `selftune evolve` when session pass rate < 0.6",
+  evaluate(ctx: ActivationContext): string | null {
+    // Look for grading results in the selftune dir
+    const gradingDir = join(ctx.selftune_dir, "grading");
+    if (!existsSync(gradingDir)) return null;
+
+    try {
+      const files = readdirSync(gradingDir).filter(
+        (f) => f.startsWith("result-") && f.endsWith(".json"),
+      );
+
+      for (const file of files) {
+        const content = readFileSync(join(gradingDir, file), "utf-8");
+        const result = JSON.parse(content) as {
+          session_id: string;
+          summary?: { pass_rate: number };
+        };
+
+        if (result.session_id === ctx.session_id && result.summary) {
+          if (result.summary.pass_rate < 0.6) {
+            return `Run \`selftune evolve\` — session pass rate is ${(result.summary.pass_rate * 100).toFixed(0)}% (below 60% threshold).`;
+          }
+        }
+      }
+    } catch {
+      // fail-open
+    }
+
+    return null;
+  },
+};
+
+// ---------------------------------------------------------------------------
+// Rule: stale evolution
+// ---------------------------------------------------------------------------
+
+const staleEvolution: ActivationRule = {
+  id: "stale-evolution",
+  description:
+    "Suggest `selftune evolve` when no evolution in >7 days and pending false negatives exist",
+  evaluate(ctx: ActivationContext): string | null {
+    const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
+
+    // Check last evolution timestamp
+    const auditEntries = readJsonl<{ timestamp: string; action: string }>(
+      ctx.evolution_audit_log_path,
+    );
+
+    if (auditEntries.length === 0) {
+      // No evolution has ever run — check for false negatives
+      return checkFalseNegatives(ctx)
+        ? "Run `selftune evolve` — no evolution history found and pending false negatives exist."
+        : null;
+    }
+
+    const lastEntry = auditEntries[auditEntries.length - 1];
+    const lastTimestamp = new Date(lastEntry.timestamp).getTime();
+    const ageMs = Date.now() - lastTimestamp;
+
+    if (ageMs > SEVEN_DAYS_MS && checkFalseNegatives(ctx)) {
+      return `Run \`selftune evolve\` — no evolution in >7 days and pending false negatives detected.`;
+    }
+
+    return null;
+  },
+};
+
+function checkFalseNegatives(ctx: ActivationContext): boolean {
+  const fnPath = join(ctx.selftune_dir, "false-negatives", "pending.json");
+  if (!existsSync(fnPath)) return false;
+
+  try {
+    const data = JSON.parse(readFileSync(fnPath, "utf-8"));
+    return Array.isArray(data) && data.length > 0;
+  } catch {
+    return false;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Rule: regression detected
+// ---------------------------------------------------------------------------
+
+const regressionDetected: ActivationRule = {
+  id: "regression-detected",
+  description: "Suggest `selftune rollback` when watch snapshot shows regression",
+  evaluate(ctx: ActivationContext): string | null {
+    const snapshotPath = join(ctx.selftune_dir, "monitoring", "latest-snapshot.json");
+    if (!existsSync(snapshotPath)) return null;
+
+    try {
+      const snapshot = JSON.parse(readFileSync(snapshotPath, "utf-8")) as {
+        regression_detected: boolean;
+        skill_name?: string;
+        pass_rate?: number;
+      };
+
+      if (snapshot.regression_detected) {
+        const skillInfo = snapshot.skill_name ? ` for skill "${snapshot.skill_name}"` : "";
+        return `Run \`selftune rollback\` — regression detected${skillInfo}.`;
+      }
+    } catch {
+      // fail-open
+    }
+
+    return null;
+  },
+};
+
+// ---------------------------------------------------------------------------
+// Exported defaults
+// ---------------------------------------------------------------------------
+
+export const DEFAULT_RULES: ActivationRule[] = [
+  postSessionDiagnostic,
+  gradingThresholdBreach,
+  staleEvolution,
+  regressionDetected,
+];

package/cli/selftune/badge/badge-data.ts

@@ -0,0 +1,108 @@
+/**
+ * Badge data computation for selftune skill health badges.
+ *
+ * Maps SkillStatus into display-ready BadgeData with color coding,
+ * trend arrows, and formatted messages. Pure functions, zero deps.
+ */
+
+import type { SkillStatus, StatusResult } from "../status.js";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface BadgeData {
+  label: string;
+  passRate: number | null;
+  trend: "up" | "down" | "stable" | "unknown";
+  status: "HEALTHY" | "WARNING" | "CRITICAL" | "UNKNOWN";
+  color: string;
+  message: string;
+}
+
+export type BadgeFormat = "svg" | "markdown" | "url";
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+export const BADGE_THRESHOLDS = {
+  /** Above this → green */
+  GREEN: 0.8,
+  /** At or above this → yellow; below → red */
+  YELLOW: 0.6,
+} as const;
+
+export const BADGE_COLORS = {
+  GREEN: "#4c1",
+  YELLOW: "#dfb317",
+  RED: "#e05d44",
+  GRAY: "#9f9f9f",
+} as const;
+
+export const TREND_ARROWS: Record<BadgeData["trend"], string> = {
+  up: "\u2191",
+  down: "\u2193",
+  stable: "\u2192",
+  unknown: "",
+};
+
+// ---------------------------------------------------------------------------
+// computeBadgeData
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert a SkillStatus into display-ready badge data.
+ *
+ * Color thresholds:
+ *  - green  (#4c1)    passRate > 0.8
+ *  - yellow (#dfb317) passRate 0.6 - 0.8 (inclusive)
+ *  - red    (#e05d44) passRate < 0.6
+ *  - gray   (#9f9f9f) passRate is null (no data)
+ */
+export function computeBadgeData(skill: SkillStatus): BadgeData {
+  const { passRate, trend, status } = skill;
+
+  let color: string;
+  let message: string;
+
+  if (passRate === null) {
+    color = BADGE_COLORS.GRAY;
+    message = "no data";
+  } else {
+    if (passRate > BADGE_THRESHOLDS.GREEN) {
+      color = BADGE_COLORS.GREEN;
+    } else if (passRate >= BADGE_THRESHOLDS.YELLOW) {
+      color = BADGE_COLORS.YELLOW;
+    } else {
+      color = BADGE_COLORS.RED;
+    }
+
+    const pct = `${Math.round(passRate * 100)}%`;
+    const arrow = TREND_ARROWS[trend];
+    message = arrow ? `${pct} ${arrow}` : pct;
+  }
+
+  return {
+    label: "Skill Health",
+    passRate,
+    trend,
+    status,
+    color,
+    message,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// findSkillBadgeData
+// ---------------------------------------------------------------------------
+
+/**
+ * Find a skill by name in a StatusResult and return its BadgeData,
+ * or null if the skill is not found.
+ */
+export function findSkillBadgeData(result: StatusResult, name: string): BadgeData | null {
+  const skill = result.skills.find((s) => s.name === name);
+  if (!skill) return null;
+  return computeBadgeData(skill);
+}

package/cli/selftune/badge/badge-svg.ts

@@ -0,0 +1,212 @@
+/**
+ * SVG renderer and format router for selftune skill health badges.
+ *
+ * Generates shields.io flat-style SVG badges using template literals.
+ * Uses a per-character width table for Verdana 11px text width estimation.
+ * Zero external dependencies, pure functions only.
+ */
+
+import type { BadgeData, BadgeFormat } from "./badge-data.js";
+
+// ---------------------------------------------------------------------------
+// Character width table (Verdana 11px)
+// ---------------------------------------------------------------------------
+
+const CHAR_WIDTHS: Record<string, number> = {
+  " ": 3.3,
+  "!": 3.3,
+  "%": 7.3,
+  "(": 3.6,
+  ")": 3.6,
+  "+": 7.3,
+  "-": 3.9,
+  ".": 3.3,
+  "/": 3.6,
+  "0": 6.6,
+  "1": 6.6,
+  "2": 6.6,
+  "3": 6.6,
+  "4": 6.6,
+  "5": 6.6,
+  "6": 6.6,
+  "7": 6.6,
+  "8": 6.6,
+  "9": 6.6,
+  ":": 3.3,
+  A: 7.5,
+  B: 7.5,
+  C: 7.2,
+  D: 7.8,
+  E: 6.8,
+  F: 6.3,
+  G: 7.8,
+  H: 7.8,
+  I: 3.0,
+  J: 5.0,
+  K: 7.2,
+  L: 6.2,
+  M: 8.9,
+  N: 7.8,
+  O: 7.8,
+  P: 6.6,
+  Q: 7.8,
+  R: 7.2,
+  S: 7.2,
+  T: 6.5,
+  U: 7.8,
+  V: 7.2,
+  W: 10.0,
+  X: 6.8,
+  Y: 6.5,
+  Z: 6.8,
+  a: 6.2,
+  b: 6.6,
+  c: 5.6,
+  d: 6.6,
+  e: 6.2,
+  f: 3.6,
+  g: 6.6,
+  h: 6.6,
+  i: 2.8,
+  j: 2.8,
+  k: 6.2,
+  l: 2.8,
+  m: 10.0,
+  n: 6.6,
+  o: 6.6,
+  p: 6.6,
+  q: 6.6,
+  r: 3.9,
+  s: 5.6,
+  t: 3.6,
+  u: 6.6,
+  v: 6.2,
+  w: 8.9,
+  x: 5.9,
+  y: 5.9,
+  z: 5.6,
+  "\u2191": 6.6,
+  "\u2193": 6.6,
+  "\u2192": 6.6,
+};
+
+const DEFAULT_CHAR_WIDTH = 6.8;
+
+// ---------------------------------------------------------------------------
+// Logo constants
+// ---------------------------------------------------------------------------
+
+const LOGO_SIZE = 14;
+const LOGO_PAD = 3; // gap between logo and text
+const LOGO_EXTRA = LOGO_SIZE + LOGO_PAD; // 17px added to label section
+
+const LOGO_SVG_BASE64 =
+  "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNTAiIGhlaWdodD0iMjUwIiB2aWV3Qm94PSIwIDAgMjUwIDI1MCIgZmlsbD0ibm9uZSI+CjxwYXRoIGQ9Ik0gMTkwLjE2LDMxLjQ5IEMgMTg3LjkxLDI5Ljg4IDE4NC41MSwzMi4xOSAxODUuODgsMzUuMTYgQyAxODYuMzEsMzYuMTEgMTg3LjA4LDM2LjU0IDE4Ny43MSwzNy4wMSBDIDIxOC43NSw1OS44NiAyMzcuNjMsOTIuNzEgMjM3LjYzLDEyOC44MiBDIDIzNy42MywxNzUuOTkgMjA1LjEyLDIxOC41NiAxNTMuODIsMjM0LjY5IEMgMTQ5Ljg5LDIzNS45MyAxNTAuOTEsMjQxLjcxIDE1NC45MSwyNDAuNjYgQyAyMDUuOTgsMjI2Ljk2IDI0My4wMSwxODEuOTQgMjQzLDEyOC40NSBDIDI0Mi45OSw5MC44NyAyMjMuNDcsNTYuMTggMTkwLjE2LDMxLjQ5IFoiIGZpbGw9IiNmZmYiLz4KPHBhdGggZD0iTSAxMjUuMTksMjQzLjkxIEMgMTM4LjA4LDI0My45MSAxNDcuMTgsMjM2LjQ0IDE1MS4yMSwyMjUuMDEgQyAxOTMuNzIsMjE3Ljc5IDIyNi45OCwxODQuMDIgMjI2Ljk4LDE0MC44MSBDIDIyNi45OCwxMjEuMTcgMjE5LjgyLDEwMy43OCAyMDkuOTMsODcuMDQgQyAxOTEuNDIsNTUuNDUgMTY1LjE1LDM0LjcyIDExNy43MSwyOC42NSBDIDExMi45MSwyOC4wNCAxMTMuNzcsMzQuMzUgMTE3LjE5LDM0LjgyIEMgMTYxLjY3LDM5LjMzIDE4NS44NCw1Ni43MSAyMDMuNzYsODYuNDIgQyAyMTMuODcsMTAzLjY4IDIyMC42OCwxMTkuNjEgMjIwLjY4LDE0MC44MSBDIDIyMC42OCwxNzkuOTYgMTkwLjgxLDIxMS45NSAxNDguNzEsMjE5LjE2IEMgMTQ3LjExLDIxOS40NyAxNDYuMjcsMjIwLjMyIDE0NS45MiwyMjEuOCBDIDE0Mi45NSwyMzEuMTEgMTM1LjcyLDIzOC4wMiAxMjUuMTksMjM3LjY2IEMgNjQuNDgsMjM3LjY2IDExLjY3LDE5MS42MSAxMS42NywxMjcuNTEgQyAxMS42Nyw3OS42MSA0NC44MiwzNi4zOCA5My44OSwyNy43NyBMIDk0LjExLDI3LjczIEwgOTQuMzgsMjYuNjQgQyA5Ny4wNCwxNi42MSAxMDQuNTcsMTEuODIgMTE0LjE5LDExLjgyIEMgMTM0LjEyLDEzLjM2IDE1Mi45MSwxOC4xNSAxNzAuNDgsMjYuMDggQyAxNzEuOTIsMjYuNzggMTczLjgxLDI3LjA5IDE3NC43NiwyNS41OSBDIDE3Ni4wNSwyMy43MiAxNzUuMzEsMjEuMDcgMTczLjAxLDIwLjM0IEMgMTU0Ljc4LDExLjk2IDEzNy4yMSw3LjE3IDExNC40Nyw2IEggMTEzLjUyIEMgMTAxLjkxLDYgOTMuNDYsMTIuMTYgODkuNDksMjEuNzggQyA0Mi4zNiwzMS4yNiA2LjE3LDc0Ljc2IDYuMTcsMTI4LjA4IEMgNi4xNywxOTAuMDUgNTcuOTIsMjQzLjkxIDEyNS4xOSwyNDMuOTEgWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNIDkzLjY3LDQwLjY0IEMgMTAwLjUxLDUyLjA3IDEwOS41NCw1MS4zMyAxMTQuMDUsNTIuMTcgQyAxMjguNzIsNTMuOTEgMTQxLjQ4LDU1Ljc4IDE1Ny4zOCw2Mi4xNiBDIDE2Mi43Miw2NC40NyAxNjIuMjksNTguMTkgMTU5LjE4LDU3LjAxIEMgMTQ1LjExLDUxLjMzIDEzMi40OCw0OS43OSAxMTEuMzEsNDcuNDggQyAxMDEuODMsNDYuMjkgOTUuNDUsNDEuMTggOTMuNzUsMzIuODEgQyA1NS4yMSwzOS40NiAyMi4wNiw3Mi4xNyAyMi4wNiwxMTIuNDggQyAyMi4wNiwxMzEuOTggMzAuMzYsMTQ5LjgyIDQzLjI2LDE2NC40OSBDIDQ2LjIzLDE2Ny41OSA1MC4xOSwxNjQuMTMgNDguMzIsMTYxLjAyIEMgMzYuMjEsMTQ1LjU0IDI4LjQyLDEyOS43OCAyOC40MiwxMTIuNCBDIDI4LjQyLDc5LjExIDU0LjkxLDQ4LjM2IDg5LjkxLDQwLjM2IEMgOTAuNzYsNDAuMTUgOTEuMDQsMzkuODcgOTEuNjIsNDAuMDEgQyA5Mi42Miw0MC4wMSA5My4wNCwzOS42NSA5My42Nyw0MC42NCBaIiBmaWxsPSIjZmZmIi8+CjxwYXRoIGQ9Ik0gMTUyLjcyLDgyLjc3IEMgMTI2LjYxLDgyLjc3IDExMy4wNyw5OS40NCAxMDMuMDEsMTE5LjMzIEMgMTAwLjU2LDEyMy4zNiAxMDMuNzQsMTI1LjAzIDEwNS42MSwxMjMuOTIgQyAxMDcuMTUsMTIzLjIyIDEwNy44OSwxMjEuMDUgMTA4LjczLDExOS42MSBDIDExOC4yMiwxMDIuMTYgMTMwLjMzLDg4LjU2IDE1Mi43Miw4OC41NiBDIDE4MS42Miw4OC41NiAyMDEuOTEsMTE2LjAxIDIwMS45MSwxNDcuMzEgQyAyMDEuOTEsMTc1LjEyIDE4My40NywxOTkuOTYgMTUyLjUxLDIwNS43NSBDIDE1MS44NCwyMDUuOTYgMTUxLjYzLDIwNi4wMyAxNTEuNTYsMjA1LjU0IEMgMTQ3Ljc0LDE5NS4zNyAxMzkuMzYsMTg4LjE1IDEyOC4wNywxODYuNDggQyAxMTMuMiwxODQuMjQgMTAxLjIzLDE4Mi4zNiA4My44LDE3Ni44MSBDIDc5LjMsMTc1LjQ4IDc3LjkxLDE4Mi4zNiA4Mi40MSwxODMuMDkgQyA5Ny4yMSwxODcuNDYgMTA4LjA5LDE4OS40NyAxMjYuMjUsMTkyLjY1IEMgMTM2Ljc4LDE5NC4zMSAxNDUuNDEsMjAxLjcxIDE0Ny4xMSwyMTAuOTUgQyAxNDcuNzQsMjEzLjA1IDE0OS4xMywyMTMuNDEgMTUwLjE1LDIxMy4yNiBDIDE4My43NSwyMDguNjEgMjA4LjI2LDE4MC45MyAyMDguMjYsMTQ3LjI0IEMgMjA4LjI2LDExNS4wNiAxODYuOTQsODIuNzcgMTUyLjcyLDgyLjc3IFoiIGZpbGw9IiNmZmYiLz4KPHBhdGggZD0iTSAxMjkuNzcsMTA1LjIxIEMgMTIyLjkzLDExMi4wNSAxMTguOTcsMTIyLjczIDExMy43NywxMzAuNDEgQyAxMTEuMzEsMTMzLjQ1IDExNC41NiwxMzYuNjMgMTE3LjQ2LDEzNC40NiBDIDEyMy43NSwxMjYuMjMgMTI3LjQzLDExNS42MiAxMzUuMTUsMTA4LjcxIEMgMTM4LjIyLDEwNS44MSAxMzQuNzMsMTAxLjA5IDEyOS43NywxMDUuMjEgWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNIDEzNi43OCwxMjAuMzEgQyAxMjcuNzEsMTM2LjcxIDEyMC4xMiwxNTQuOTEgOTMuNzQsMTU0LjkxIEMgNjYuMDcsMTU0LjkxIDQ3Ljc2LDEyOC41MyA0Ny43NiwxMDQuNzggQyA0Ny43Niw4NC40NyA1OC41Nyw2Ni4wOCA3Ny42Niw1Ni4yNSBDIDgyLjIzLDU0LjIxIDc5Ljg1LDQ3Ljc2IDc1LjM0LDQ5LjkzIEMgNTQuNzcsNTkuNzIgNDIuMDEsODAuMTEgNDIuMDEsMTA0LjcxIEMgNDIuMDEsMTMxLjc3IDYxLjg2LDE2MS4zMSA5My42NywxNjEuMzEgQyAxMTQuNzcsMTYxLjMxIDEyOC45MSwxNDcuMjQgMTM5Ljg2LDEyNC4wNiBDIDE0Mi43NiwxMjAuNDUgMTM5LjE1LDExNy43MyAxMzYuNzgsMTIwLjMxIFoiIGZpbGw9IiNmZmYiLz4KPHBhdGggZD0iTSAzMC43MywxNTQuNyBDIDI3Ljc2LDE1Mi45NyAyMy44NywxNTUuOTMgMjUuNDEsMTU4Ljc2IEMgNDEuNzMsMTg4LjM2IDY4Ljk0LDE5OS43OSAxMDUuNzUsMjA2LjQxIEMgMTEyLjI1LDIwNy42NiAxMjIuMDcsMjA4Ljc1IDEyMy40NiwyMDkuMDMgQyAxMjguMDcsMjA5Ljk1IDEyOC4wNywyMjAuMTggMTIxLjc4LDIyMC4xOCBDIDEwNy42NCwyMTguOTQgOTIuMDYsMjE1Ljk4IDc2LjIzLDIxMS4zMyBDIDcyLjEzLDIxMC4yNCA3MS4wNCwyMTYuNjkgNzUuMjcsMjE3LjY0IEMgOTAuNDEsMjIyLjIyIDEwMy45NSwyMjQuNzQgMTIwLjQ3LDIyNi41NCBDIDEzMy43MywyMjYuNTQgMTM2LjU2LDIwOS4wMyAxMjYuMDMsMjAzLjM4IEMgMTIzLjc1LDIwMi4xMyAxMjIuNzMsMjAyLjU2IDExMi4wNCwyMDAuNzYgQyA3OC4wOSwxOTUuMDQgNTQuMDYsMTg4Ljk4IDMyLjEyLDE1NS42NSBDIDMxLjc3LDE1NS4yMyAzMS4yOCwxNTQuOTEgMzAuNzMsMTU0LjcgWiIgZmlsbD0iI2ZmZiIvPgo8L3N2Zz4=";
+
+// ---------------------------------------------------------------------------
+// Text width estimation
+// ---------------------------------------------------------------------------
+
+function measureText(text: string): number {
+  let width = 0;
+  for (const ch of text) {
+    width += CHAR_WIDTHS[ch] ?? DEFAULT_CHAR_WIDTH;
+  }
+  return width;
+}
+
+// ---------------------------------------------------------------------------
+// SVG escaping
+// ---------------------------------------------------------------------------
+
+function escapeXml(text: string): string {
+  return text
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
+}
+
+// ---------------------------------------------------------------------------
+// renderBadgeSvg
+// ---------------------------------------------------------------------------
+
+/**
+ * Render a shields.io flat-style SVG badge from BadgeData.
+ *
+ * Layout: [label (gray #555)] [value (colored)]
+ * Each half has 10px padding on each side, 1px gap between halves.
+ */
+export function renderBadgeSvg(data: BadgeData): string {
+  const labelText = data.label;
+  const valueText = data.message;
+
+  const labelTextWidth = measureText(labelText);
+  const valueTextWidth = measureText(valueText);
+
+  // 10px padding on each side of text + logo space in label
+  const labelWidth = Math.round(labelTextWidth + 20 + LOGO_EXTRA);
+  const valueWidth = Math.round(valueTextWidth + 20);
+  const totalWidth = labelWidth + 1 + valueWidth; // 1px gap
+
+  const labelTextX = (labelWidth + LOGO_EXTRA) / 2;
+  const valueX = labelWidth + 1 + valueWidth / 2;
+
+  const height = 20;
+  const labelColor = "#555";
+  const valueColor = data.color;
+
+  const escapedLabel = escapeXml(labelText);
+  const escapedValue = escapeXml(valueText);
+
+  return `<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="${totalWidth}" height="${height}" role="img" aria-label="${escapedLabel}: ${escapedValue}">
+  <linearGradient id="b" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="a">
+    <rect width="${totalWidth}" height="${height}" rx="3" fill="#fff"/>
+  </clipPath>
+  <g clip-path="url(#a)">
+    <rect width="${labelWidth}" height="${height}" fill="${labelColor}"/>
+    <rect x="${labelWidth + 1}" width="${valueWidth}" height="${height}" fill="${valueColor}"/>
+    <rect width="${totalWidth}" height="${height}" fill="url(#b)"/>
+  </g>
+  <image x="3" y="3" width="${LOGO_SIZE}" height="${LOGO_SIZE}" xlink:href="${LOGO_SVG_BASE64}"/>
+  <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11">
+    <text x="${labelTextX}" y="15" fill="#010101" fill-opacity=".3">${escapedLabel}</text>
+    <text x="${labelTextX}" y="14">${escapedLabel}</text>
+    <text x="${valueX}" y="15" fill="#010101" fill-opacity=".3">${escapedValue}</text>
+    <text x="${valueX}" y="14">${escapedValue}</text>
+  </g>
+</svg>`;
+}
+
+// ---------------------------------------------------------------------------
+// formatBadgeOutput
+// ---------------------------------------------------------------------------
+
+/**
+ * Route badge data to the requested output format.
+ *
+ * - "svg"      local SVG string via renderBadgeSvg
+ * - "markdown" shields.io markdown image link
+ * - "url"      shields.io badge URL
+ */
+export function formatBadgeOutput(data: BadgeData, skillName: string, format: BadgeFormat): string {
+  if (format === "svg") {
+    return renderBadgeSvg(data);
+  }
+
+  const label = encodeURIComponent(data.label);
+  const message = encodeURIComponent(data.message);
+  const color = data.color.replace("#", "");
+  const url = `https://img.shields.io/badge/${label}-${message}-${color}`;
+
+  if (format === "markdown") {
+    return `![Skill Health: ${skillName}](${url})`;
+  }
+
+  return url;
+}

package/cli/selftune/badge/badge.ts

@@ -0,0 +1,103 @@
+#!/usr/bin/env bun
+/**
+ * selftune badge -- Generate skill health badges for READMEs.
+ *
+ * Usage:
+ *   selftune badge --skill <name> [--format svg|markdown|url] [--output <path>]
+ */
+
+import { writeFileSync } from "node:fs";
+import { parseArgs } from "node:util";
+import { EVOLUTION_AUDIT_LOG, QUERY_LOG, SKILL_LOG, TELEMETRY_LOG } from "../constants.js";
+import { doctor } from "../observability.js";
+import { computeStatus } from "../status.js";
+import type {
+  EvolutionAuditEntry,
+  QueryLogRecord,
+  SessionTelemetryRecord,
+  SkillUsageRecord,
+} from "../types.js";
+import { readJsonl } from "../utils/jsonl.js";
+import type { BadgeFormat } from "./badge-data.js";
+import { findSkillBadgeData } from "./badge-data.js";
+import { formatBadgeOutput } from "./badge-svg.js";
+
+const HELP = `selftune badge \u2014 Generate skill health badges
+
+Usage: selftune badge --skill <name> [options]
+
+Options:
+  --skill <name>    Skill name (required)
+  --format <type>   Output format: svg, markdown, url (default: svg)
+  --output <path>   Write to file instead of stdout
+  --help            Show this help`;
+
+const VALID_FORMATS = new Set<BadgeFormat>(["svg", "markdown", "url"]);
+
+export function cliMain(): void {
+  const { values } = parseArgs({
+    args: process.argv.slice(2),
+    options: {
+      skill: { type: "string" },
+      format: { type: "string" },
+      output: { type: "string" },
+      help: { type: "boolean" },
+    },
+    strict: true,
+  });
+
+  if (values.help) {
+    console.log(HELP);
+    return;
+  }
+
+  if (!values.skill) {
+    console.error("Error: --skill is required\n");
+    console.error(HELP);
+    process.exit(1);
+  }
+
+  if (values.format && !VALID_FORMATS.has(values.format as BadgeFormat)) {
+    console.error(`Error: invalid format '${values.format}'. Must be one of: svg, markdown, url\n`);
+    console.error(HELP);
+    process.exit(1);
+  }
+
+  const format: BadgeFormat =
+    values.format && VALID_FORMATS.has(values.format as BadgeFormat)
+      ? (values.format as BadgeFormat)
+      : "svg";
+
+  // Read log files
+  const telemetry = readJsonl<SessionTelemetryRecord>(TELEMETRY_LOG);
+  const skillRecords = readJsonl<SkillUsageRecord>(SKILL_LOG);
+  const queryRecords = readJsonl<QueryLogRecord>(QUERY_LOG);
+  const auditEntries = readJsonl<EvolutionAuditEntry>(EVOLUTION_AUDIT_LOG);
+
+  // Run doctor for system health
+  const doctorResult = doctor();
+
+  // Compute status
+  const result = computeStatus(telemetry, skillRecords, queryRecords, auditEntries, doctorResult);
+
+  // Find skill badge data
+  const badgeData = findSkillBadgeData(result, values.skill);
+  if (!badgeData) {
+    console.error(`Skill not found: ${values.skill}`);
+    process.exit(1);
+  }
+
+  // Generate output
+  const output = formatBadgeOutput(badgeData, values.skill, format);
+
+  if (values.output) {
+    writeFileSync(values.output, output, "utf-8");
+    console.log(`Badge written to ${values.output}`);
+  } else {
+    console.log(output);
+  }
+}
+
+if (import.meta.main) {
+  cliMain();
+}

package/cli/selftune/constants.ts

@@ -15,6 +15,12 @@ export const SKILL_LOG = join(LOG_DIR, "skill_usage_log.jsonl");
 export const QUERY_LOG = join(LOG_DIR, "all_queries_log.jsonl");
 export const EVOLUTION_AUDIT_LOG = join(LOG_DIR, "evolution_audit_log.jsonl");
 
+/** Evolution memory directory — human-readable session context that survives resets. */
+export const MEMORY_DIR = join(SELFTUNE_CONFIG_DIR, "memory");
+export const CONTEXT_PATH = join(MEMORY_DIR, "context.md");
+export const PLAN_PATH = join(MEMORY_DIR, "plan.md");
+export const DECISIONS_PATH = join(MEMORY_DIR, "decisions.md");
+
 /** Tool names Claude Code uses. */
 export const KNOWN_TOOLS = new Set([
   "Read",
@@ -62,4 +68,72 @@ export const REQUIRED_FIELDS: Record<string, Set<string>> = {
 };
 
 /** Agent CLI candidates in detection order. */
-export const AGENT_CANDIDATES = ["claude", "codex", "opencode"] as const;
+export const AGENT_CANDIDATES = ["claude", "codex", "opencode", "openclaw"] as const;
+
+/** Path for user-defined activation rule overrides. */
+export const ACTIVATION_RULES_PATH = join(SELFTUNE_CONFIG_DIR, "activation-rules.json");
+
+/** Per-session state file pattern (interpolate session_id). */
+export const SESSION_STATE_DIR = SELFTUNE_CONFIG_DIR;
+
+/** Build a session state file path from a session ID. */
+export function sessionStatePath(sessionId: string): string {
+  // Sanitize session ID to be filesystem-safe
+  const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, "_");
+  return join(SESSION_STATE_DIR, `session-state-${safe}.json`);
+}
+
+/** Claude Code settings file path. */
+export const CLAUDE_SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
+
+/** Path to Claude Code projects directory containing session transcripts. */
+export const CLAUDE_CODE_PROJECTS_DIR = join(homedir(), ".claude", "projects");
+
+/** Marker file tracking which Claude Code sessions have been ingested. */
+export const CLAUDE_CODE_MARKER = join(homedir(), ".claude", "claude_code_ingested_sessions.json");
+
+/** OpenClaw agents directory containing session data. */
+export const OPENCLAW_AGENTS_DIR = join(homedir(), ".openclaw", "agents");
+
+/** Marker file tracking which OpenClaw sessions have been ingested. */
+export const OPENCLAW_INGEST_MARKER = join(SELFTUNE_CONFIG_DIR, "openclaw-ingest-marker.json");
+
+/** Default output directory for contribution bundles. */
+export const CONTRIBUTIONS_DIR = join(SELFTUNE_CONFIG_DIR, "contributions");
+
+// ---------------------------------------------------------------------------
+// Sanitization constants (for contribute command)
+// ---------------------------------------------------------------------------
+
+/** Regex patterns for detecting secrets that must be redacted. */
+export const SECRET_PATTERNS = [
+  /sk-[a-zA-Z0-9]{20,}/g, // OpenAI / Anthropic API keys
+  /ghp_[a-zA-Z0-9]{36,}/g, // GitHub personal access tokens
+  /gho_[a-zA-Z0-9]{36,}/g, // GitHub OAuth tokens
+  /github_pat_[a-zA-Z0-9_]{22,}/g, // GitHub fine-grained PATs
+  /AKIA[A-Z0-9]{16}/g, // AWS access key IDs
+  /xoxb-[a-zA-Z0-9-]+/g, // Slack bot tokens
+  /xoxp-[a-zA-Z0-9-]+/g, // Slack user tokens
+  /xoxs-[a-zA-Z0-9-]+/g, // Slack session tokens
+  /eyJ[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}/g, // JWTs
+  /npm_[a-zA-Z0-9]{36}/g, // npm tokens
+  /pypi-[a-zA-Z0-9]{36,}/g, // PyPI tokens
+] as const;
+
+/** Regex for file paths (Unix and Windows). */
+export const FILE_PATH_PATTERN = /(?:\/[\w.-]+){2,}|[A-Z]:\\[\w\\.-]+/g;
+
+/** Regex for email addresses. */
+export const EMAIL_PATTERN = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g;
+
+/** Regex for IP addresses (v4). */
+export const IP_PATTERN = /\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/g;
+
+/** Regex for camelCase/PascalCase identifiers longer than 8 chars (aggressive mode). */
+export const IDENTIFIER_PATTERN = /\b[a-z][a-zA-Z0-9]{8,}\b|\b[A-Z][a-zA-Z0-9]{8,}\b/g;
+
+/** Regex for import/require/from module paths (aggressive mode). */
+export const MODULE_PATTERN = /(?:import|require|from)\s+["']([^"']+)["']/g;
+
+/** Max query length for aggressive sanitization. */
+export const AGGRESSIVE_MAX_QUERY_LENGTH = 200;