cue-ai 0.4.0 → 0.5.0

package/src/commands/migrate.ts

@@ -0,0 +1,100 @@
+/**
+ * `cue migrate` — auto-migrate profiles when schema changes.
+ */
+
+import { existsSync, readFileSync, writeFileSync, readdirSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+
+const REPO_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const PROFILES_DIR = join(REPO_ROOT, "profiles");
+const CURRENT_SCHEMA_VERSION = 2;
+
+interface Migration {
+  from: number;
+  to: number;
+  description: string;
+  migrate: (profile: Record<string, any>) => Record<string, any>;
+}
+
+const MIGRATIONS: Migration[] = [
+  {
+    from: 1, to: 2,
+    description: "Add explicit schema_version field; normalize skills.local to object format",
+    migrate: (profile) => {
+      profile.schema_version = 2;
+      // Normalize skills.local strings to { id: string } objects
+      if (profile.skills?.local) {
+        profile.skills.local = profile.skills.local.map((s: any) =>
+          typeof s === "string" ? s : s
+        );
+      }
+      return profile;
+    },
+  },
+];
+
+export async function run(args: string[]): Promise<number> {
+  if (args.includes("-h") || args.includes("--help")) {
+    process.stdout.write(`cue migrate — auto-migrate profiles to latest schema
+
+Usage:
+  cue migrate              Check which profiles need migration
+  cue migrate --apply      Apply migrations
+  cue migrate --profile <name>  Migrate specific profile
+`);
+    return 0;
+  }
+
+  const apply = args.includes("--apply");
+  const profileIdx = args.indexOf("--profile");
+  const targetProfile = profileIdx >= 0 ? args[profileIdx + 1] : null;
+
+  const profiles = targetProfile ? [targetProfile] :
+    readdirSync(PROFILES_DIR).filter(d =>
+      !d.startsWith("_") && existsSync(join(PROFILES_DIR, d, "profile.yaml"))
+    );
+
+  let needsMigration = 0;
+  let migrated = 0;
+
+  for (const name of profiles) {
+    const yamlPath = join(PROFILES_DIR, name, "profile.yaml");
+    if (!existsSync(yamlPath)) continue;
+
+    const content = readFileSync(yamlPath, "utf8");
+    const profile = parseYaml(content);
+    const version = profile.schema_version ?? 1;
+
+    if (version >= CURRENT_SCHEMA_VERSION) continue;
+
+    needsMigration++;
+    const applicable = MIGRATIONS.filter(m => m.from >= version && m.to <= CURRENT_SCHEMA_VERSION);
+
+    if (!apply) {
+      process.stdout.write(`  ${name}: v${version} → v${CURRENT_SCHEMA_VERSION} (${applicable.length} migration(s))\n`);
+      for (const m of applicable) {
+        process.stdout.write(`    • ${m.description}\n`);
+      }
+    } else {
+      let current = profile;
+      for (const m of applicable) {
+        current = m.migrate(current);
+      }
+      writeFileSync(yamlPath, stringifyYaml(current));
+      migrated++;
+      process.stdout.write(`  ✅ ${name}: migrated to v${CURRENT_SCHEMA_VERSION}\n`);
+    }
+  }
+
+  if (needsMigration === 0) {
+    process.stdout.write("  ✅ All profiles are up to date.\n");
+  } else if (!apply) {
+    process.stdout.write(`\n  ${needsMigration} profile(s) need migration. Run: cue migrate --apply\n`);
+  } else {
+    process.stdout.write(`\n  ✅ Migrated ${migrated} profile(s).\n`);
+  }
+
+  return 0;
+}

package/src/commands/optimizer.ts

@@ -31,10 +31,10 @@ function getSkillUsage(): Map<string, number> {
   const projectsDir = join(homedir(), ".claude", "projects");
   try {
     // Use grep to scan all session jsonl files for SKILL.md reads
-    const res = spawnSync("grep", ["-roh", "skills/[a-z][a-z0-9-]*/SKILL.md", projectsDir], {
+    const res = spawnSync("grep", ["-roh", "--include=*.jsonl", "-m", "500", "skills/[a-z][a-z0-9-]*/SKILL.md", projectsDir], {
       stdio: ["ignore", "pipe", "pipe"],
       encoding: "utf8",
-      timeout: 10000,
+      timeout: 3000,
     });
     if (res.status === 0 && res.stdout) {
       for (const line of res.stdout.split("\n")) {

package/src/commands/replay-whatif.ts

@@ -0,0 +1,142 @@
+/**
+ * `cue replay --what-if <profile>` — simulate a past session with a different profile.
+ * Shows which tool calls would have been available/missing.
+ */
+
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+
+import { loadProfile } from "../lib/profile-loader";
+
+const REPO_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const SKILLS_ROOT = join(REPO_ROOT, "resources", "skills", "skills");
+
+export async function run(args: string[]): Promise<number> {
+  if (args.includes("-h") || args.includes("--help")) {
+    process.stdout.write(`cue replay — replay a session with a different profile
+
+Usage:
+  cue replay --what-if <profile>   Simulate last session with a different profile
+  cue replay --what-if <profile> --session <path>   Specific session file
+
+Shows which skills/tools would have been available or missing.
+`);
+    return 0;
+  }
+
+  const whatIfIdx = args.indexOf("--what-if");
+  const targetProfile = whatIfIdx >= 0 ? args[whatIfIdx + 1] : null;
+  const sessionIdx = args.indexOf("--session");
+  const sessionPath = sessionIdx >= 0 ? args[sessionIdx + 1] : null;
+
+  if (!targetProfile) {
+    process.stderr.write("Usage: cue replay --what-if <profile>\n");
+    return 1;
+  }
+
+  // Load target profile
+  let profile;
+  try { profile = await loadProfile(targetProfile); } catch (e) {
+    process.stderr.write(`Cannot load profile "${targetProfile}": ${e}\n`);
+    return 1;
+  }
+
+  const profileSkills = new Set(profile.skills.local.map(s => s.id));
+  const profileMcps = new Set(profile.mcps.map(m => m.id));
+
+  // Find session to replay
+  let sessFile = sessionPath;
+  if (!sessFile) {
+    const projectsDir = join(homedir(), ".claude", "projects");
+    if (!existsSync(projectsDir)) {
+      process.stderr.write("No session files found in ~/.claude/projects/\n");
+      return 1;
+    }
+    // Find most recent session (limit scan)
+    let latest = { path: "", mtime: 0 };
+    const allDirs = readdirSync(projectsDir);
+    for (const dir of allDirs.slice(-20)) { // only last 20 project dirs
+      const fullDir = join(projectsDir, dir);
+      try {
+        if (!statSync(fullDir).isDirectory()) continue;
+        const files = readdirSync(fullDir).filter(f => f.endsWith(".jsonl"));
+        for (const f of files.slice(-3)) { // only last 3 per dir
+          const p = join(fullDir, f);
+          const mt = statSync(p).mtimeMs;
+          if (mt > latest.mtime) latest = { path: p, mtime: mt };
+        }
+      } catch {}
+    }
+    sessFile = latest.path;
+  }
+
+  if (!sessFile || !existsSync(sessFile)) {
+    process.stderr.write("No session file found.\n");
+    return 1;
+  }
+
+  // Parse session for skill/tool references
+  const content = readFileSync(sessFile, "utf8");
+  const lines = content.split("\n").filter(Boolean);
+
+  const skillRefs = new Set<string>();
+  const toolCalls = new Set<string>();
+
+  for (const line of lines) {
+    try {
+      const msg = JSON.parse(line);
+      // Skill references
+      const text = JSON.stringify(msg);
+      const refs = text.match(/skills\/([a-z][a-z0-9-]*(?:\/[a-z][a-z0-9-]*)?)\/SKILL\.md/g);
+      if (refs) for (const r of refs) skillRefs.add(r.replace("skills/", "").replace("/SKILL.md", ""));
+
+      // Tool calls
+      if (msg.type === "assistant" && Array.isArray(msg.message?.content)) {
+        for (const block of msg.message.content) {
+          if (block.type === "tool_use") toolCalls.add(block.name);
+        }
+      }
+    } catch {}
+  }
+
+  // Analyze
+  const bold = (s: string) => `\x1b[1m${s}\x1b[0m`;
+  const green = (s: string) => `\x1b[32m${s}\x1b[0m`;
+  const red = (s: string) => `\x1b[31m${s}\x1b[0m`;
+  const dim = (s: string) => `\x1b[2m${s}\x1b[0m`;
+
+  const available = [...skillRefs].filter(s => profileSkills.has(s));
+  const missing = [...skillRefs].filter(s => !profileSkills.has(s));
+
+  process.stdout.write(`\n  🔄 What-if: replaying with ${bold(targetProfile)}\n\n`);
+  process.stdout.write(`  Session: ${dim(sessFile.split("/").slice(-2).join("/"))}\n`);
+  process.stdout.write(`  Skills referenced: ${skillRefs.size}  Tools called: ${toolCalls.size}\n\n`);
+
+  if (available.length > 0) {
+    process.stdout.write(`  ${green("✓")} Available in ${targetProfile} (${available.length}):\n`);
+    for (const s of available.slice(0, 5)) process.stdout.write(`    ✓ ${s}\n`);
+    if (available.length > 5) process.stdout.write(`    ${dim(`+${available.length - 5} more`)}\n`);
+  }
+
+  if (missing.length > 0) {
+    process.stdout.write(`\n  ${red("✗")} Missing from ${targetProfile} (${missing.length}):\n`);
+    for (const s of missing.slice(0, 5)) process.stdout.write(`    ✗ ${s}\n`);
+    if (missing.length > 5) process.stdout.write(`    ${dim(`+${missing.length - 5} more`)}\n`);
+  }
+
+  const coverage = skillRefs.size > 0 ? Math.round((available.length / skillRefs.size) * 100) : 100;
+  process.stdout.write(`\n  Coverage: ${coverage}% of referenced skills available in ${targetProfile}\n`);
+
+  if (coverage === 100) {
+    process.stdout.write(`  ${green("✓")} This profile would have worked perfectly for this session.\n`);
+  } else if (coverage >= 80) {
+    process.stdout.write(`  ${dim("Most skills covered. Minor gaps.")} \n`);
+  } else {
+    process.stdout.write(`  ${red("⚠")} Significant skill gaps — this profile may not be suitable.\n`);
+  }
+
+  process.stdout.write("\n");
+  return 0;
+}

package/src/commands/replay.ts

@@ -50,6 +50,12 @@ function findSession(id: string): string | null {
 }
 
 export async function run(args: string[]): Promise<number> {
+  // Route --what-if to the dedicated what-if module
+  if (args.includes("--what-if")) {
+    const { run: runWhatIf } = await import("./replay-whatif");
+    return runWhatIf(args);
+  }
+
   const json = args.includes("--json");
   const profileIdx = args.indexOf("--profile");
   const targetProfile = profileIdx >= 0 ? args[profileIdx + 1] : null;

package/src/commands/score.ts

@@ -0,0 +1,304 @@
+/**
+ * `cue score` — profile efficiency score (A+ to F) with SVG badge.
+ *
+ * Scoring:
+ *   - Token budget (lower = better): 40% weight
+ *   - Skill usage rate (higher = better): 35% weight
+ *   - No unused skills (fewer = better): 25% weight
+ *
+ * Output:
+ *   - Terminal: colored grade + breakdown
+ *   - --badge: SVG file (tokscale-inspired dark card)
+ *   - --markdown: one-liner for README
+ */
+
+import { existsSync, readFileSync, writeFileSync, readdirSync, statSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+
+import { loadProfile, listProfiles } from "../lib/profile-loader";
+import { resolveProfileForCwd } from "../lib/cwd-resolver";
+
+const REPO_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const SKILLS_ROOT = join(REPO_ROOT, "resources", "skills", "skills");
+
+function estimateTokens(text: string): number {
+  return Math.ceil(text.length / 4);
+}
+
+function getSkillTokens(id: string): number {
+  const path = join(SKILLS_ROOT, id, "SKILL.md");
+  try { return estimateTokens(readFileSync(path, "utf8")); } catch { return 0; }
+}
+
+function getSkillUsage(profileName: string, skillIds: string[]): { used: Set<string>; total: number } {
+  const projectsDir = join(homedir(), ".claude", "projects");
+  const used = new Set<string>();
+  if (!existsSync(projectsDir)) return { used, total: 0 };
+
+  const slugs = skillIds.map(id => id.split("/").pop()!);
+  const cutoff = Date.now() - 30 * 24 * 60 * 60 * 1000; // last 30 days
+
+  try {
+    const dirs = readdirSync(projectsDir).filter(d => {
+      try { return statSync(join(projectsDir, d)).isDirectory(); } catch { return false; }
+    });
+    outer:
+    for (const dir of dirs) {
+      const fullDir = join(projectsDir, dir);
+      const files = readdirSync(fullDir)
+        .filter(f => f.endsWith(".jsonl"))
+        .map(f => ({ name: f, mtime: statSync(join(fullDir, f)).mtimeMs }))
+        .filter(f => f.mtime > cutoff)
+        .sort((a, b) => b.mtime - a.mtime)
+        .slice(0, 5); // only check 5 most recent per project dir
+
+      for (const f of files) {
+        try {
+          // Read only first 50KB of each file to check for skill refs
+          const fd = require("node:fs").openSync(join(fullDir, f.name), "r");
+          const buf = Buffer.alloc(50_000);
+          const bytesRead = require("node:fs").readSync(fd, buf, 0, 50_000, 0);
+          require("node:fs").closeSync(fd);
+          const content = buf.toString("utf8", 0, bytesRead);
+
+          for (let i = 0; i < slugs.length; i++) {
+            if (content.includes(slugs[i]!)) used.add(skillIds[i]!);
+          }
+        } catch {}
+        if (used.size === skillIds.length) break outer;
+      }
+    }
+  } catch {}
+  return { used, total: skillIds.length };
+}
+
+interface ScoreResult {
+  profile: string;
+  grade: string;
+  score: number; // 0-100
+  tokens: number;
+  skillCount: number;
+  usedSkills: number;
+  unusedSkills: number;
+  usageRate: number;
+  tokenScore: number;
+  usageScore: number;
+  unusedScore: number;
+}
+
+function computeScore(profileName: string, profile: any): ScoreResult {
+  const skillIds = profile.skills.local.map((s: any) => s.id);
+  const tokens = skillIds.reduce((sum: number, id: string) => sum + getSkillTokens(id), 0) + 200;
+  const { used } = getSkillUsage(profileName, skillIds);
+  const usedCount = used.size;
+  const unusedCount = skillIds.length - usedCount;
+  const usageRate = skillIds.length > 0 ? usedCount / skillIds.length : 1;
+
+  // Token score: 100 at ≤2k, 0 at ≥50k (linear)
+  const tokenScore = Math.max(0, Math.min(100, 100 - ((tokens - 2000) / 480)));
+
+  // Usage score: 100 at 100% usage, 0 at 0%
+  const usageScore = Math.round(usageRate * 100);
+
+  // Unused penalty: 100 at 0 unused, 0 at 10+ unused
+  const unusedScore = Math.max(0, Math.min(100, 100 - (unusedCount * 10)));
+
+  const score = Math.round(tokenScore * 0.4 + usageScore * 0.35 + unusedScore * 0.25);
+
+  const grade = score >= 95 ? "A+" : score >= 90 ? "A" : score >= 85 ? "A-"
+    : score >= 80 ? "B+" : score >= 75 ? "B" : score >= 70 ? "B-"
+    : score >= 65 ? "C+" : score >= 60 ? "C" : score >= 55 ? "C-"
+    : score >= 50 ? "D+" : score >= 45 ? "D" : "F";
+
+  return {
+    profile: profileName, grade, score, tokens,
+    skillCount: skillIds.length, usedSkills: usedCount,
+    unusedSkills: unusedCount, usageRate,
+    tokenScore, usageScore, unusedScore,
+  };
+}
+
+function gradeColor(grade: string): string {
+  if (grade.startsWith("A")) return "#3FB950";
+  if (grade.startsWith("B")) return "#58A6FF";
+  if (grade.startsWith("C")) return "#D29922";
+  if (grade.startsWith("D")) return "#F85149";
+  return "#F85149";
+}
+
+function generateBadgeSvg(result: ScoreResult): string {
+  const color = gradeColor(result.grade);
+  const date = new Date().toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric" });
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<svg width="460" height="162" viewBox="0 0 460 162" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="cue profile score for ${result.profile}">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="460" y2="162" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#0D1117"/>
+      <stop offset="1" stop-color="#010409"/>
+    </linearGradient>
+    <radialGradient id="glow" cx="0.82" cy="0.12" r="0.55">
+      <stop offset="0" stop-color="${color}" stop-opacity="0.07"/>
+      <stop offset="1" stop-color="${color}" stop-opacity="0"/>
+    </radialGradient>
+    <linearGradient id="score-grad" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="${color}"/>
+      <stop offset="1" stop-color="${color}" stop-opacity="0.6"/>
+    </linearGradient>
+    <linearGradient id="divider-grad" x1="18" y1="0" x2="442" y2="0" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#30363D" stop-opacity="0"/>
+      <stop offset="0.5" stop-color="#30363D" stop-opacity="0.6"/>
+      <stop offset="1" stop-color="#30363D" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="acc-tokens" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0.15" stop-color="#58A6FF" stop-opacity="0.9"/>
+      <stop offset="1" stop-color="#58A6FF" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="acc-usage" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0.15" stop-color="#3FB950" stop-opacity="0.9"/>
+      <stop offset="1" stop-color="#3FB950" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="acc-grade" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0.15" stop-color="${color}" stop-opacity="0.9"/>
+      <stop offset="1" stop-color="${color}" stop-opacity="0"/>
+    </linearGradient>
+    <clipPath id="card-clip">
+      <rect width="460" height="162" rx="16"/>
+    </clipPath>
+  </defs>
+  <rect width="460" height="162" rx="16" fill="url(#bg)"/>
+  <rect x="0.5" y="0.5" width="459" height="161" rx="15.5" fill="none" stroke="#30363D"/>
+  <rect width="460" height="162" rx="16" fill="url(#glow)" clip-path="url(#card-clip)"/>
+  <text x="18" y="26" fill="#8B949E" font-size="12" font-weight="600" font-family="Segoe UI, sans-serif" letter-spacing="0.03em">cue score</text>
+  <text x="18" y="44" fill="#E6EDF3" font-size="15" font-weight="700" font-family="Segoe UI, sans-serif">${result.profile}</text>
+  <text x="${18 + (result.profile.length * 9) + 10}" y="44" fill="#8B949E" font-size="13" font-family="Segoe UI, sans-serif">${result.skillCount} skills · ${result.tokens.toLocaleString()} tokens</text>
+  <rect x="374" y="14" width="68" height="28" rx="14" fill="rgba(${grade2rgb(result.grade)},0.1)" stroke="rgba(${grade2rgb(result.grade)},0.3)"/>
+  <text x="408" y="33" fill="${color}" font-size="16" font-weight="800" font-family="Segoe UI, sans-serif" text-anchor="middle">${result.grade}</text>
+  <rect x="18" y="54" width="424" height="1" fill="url(#divider-grad)"/>
+  <rect x="18" y="64" width="136" height="58" rx="10" fill="rgba(22,27,34,0.6)" stroke="rgba(48,54,61,0.6)"/>
+  <rect x="18" y="74" width="2.5" height="38" rx="1.25" fill="url(#acc-tokens)"/>
+  <text x="32" y="84" fill="#8B949E" font-size="11" font-weight="600" font-family="Segoe UI, sans-serif" letter-spacing="0.03em">Token Budget</text>
+  <text x="32" y="110" fill="#58A6FF" font-size="22" font-weight="800" font-family="Segoe UI, sans-serif">${formatTokens(result.tokens)}</text>
+  <rect x="162" y="64" width="136" height="58" rx="10" fill="rgba(22,27,34,0.6)" stroke="rgba(48,54,61,0.6)"/>
+  <rect x="162" y="74" width="2.5" height="38" rx="1.25" fill="url(#acc-usage)"/>
+  <text x="176" y="84" fill="#8B949E" font-size="11" font-weight="600" font-family="Segoe UI, sans-serif" letter-spacing="0.03em">Skill Usage</text>
+  <text x="176" y="110" fill="#3FB950" font-size="22" font-weight="800" font-family="Segoe UI, sans-serif">${Math.round(result.usageRate * 100)}%</text>
+  <rect x="306" y="64" width="136" height="58" rx="10" fill="rgba(22,27,34,0.6)" stroke="rgba(48,54,61,0.6)"/>
+  <rect x="306" y="74" width="2.5" height="38" rx="1.25" fill="url(#acc-grade)"/>
+  <text x="320" y="84" fill="#8B949E" font-size="11" font-weight="600" font-family="Segoe UI, sans-serif" letter-spacing="0.03em">Score</text>
+  <text x="320" y="110" fill="${color}" font-size="22" font-weight="800" font-family="Segoe UI, sans-serif">${result.score}/100</text>
+  <text x="18" y="148" fill="#8B949E" font-size="11" font-family="Segoe UI, sans-serif">${date}</text>
+  <text x="442" y="148" fill="#8B949E" font-size="11" font-family="Segoe UI, sans-serif" text-anchor="end">github.com/recodeee/cue</text>
+</svg>`;
+}
+
+function grade2rgb(grade: string): string {
+  if (grade.startsWith("A")) return "63,185,80";
+  if (grade.startsWith("B")) return "88,166,255";
+  if (grade.startsWith("C")) return "210,153,34";
+  return "248,81,73";
+}
+
+function formatTokens(n: number): string {
+  if (n >= 1_000_000) return (n / 1_000_000).toFixed(1) + "M";
+  if (n >= 1_000) return (n / 1_000).toFixed(1) + "K";
+  return String(n);
+}
+
+export async function run(args: string[]): Promise<number> {
+  if (args.includes("-h") || args.includes("--help")) {
+    process.stdout.write(`cue score — profile efficiency score with SVG badge
+
+Usage:
+  cue score                    Score active profile
+  cue score --profile <name>   Score specific profile
+  cue score --all              Score all profiles
+  cue score --badge <path>     Generate SVG badge file
+  cue score --markdown         Output README badge markdown
+  cue score --json             Machine-readable output
+`);
+    return 0;
+  }
+
+  const json = args.includes("--json");
+  const all = args.includes("--all");
+  const markdown = args.includes("--markdown");
+  const badgeIdx = args.indexOf("--badge");
+  const badgePath = badgeIdx >= 0 ? args[badgeIdx + 1] : null;
+  const profileIdx = args.indexOf("--profile");
+  let profileName = profileIdx >= 0 ? args[profileIdx + 1] : args.find(a => !a.startsWith("-"));
+
+  if (!profileName && !all) {
+    try { profileName = await resolveProfileForCwd(process.cwd()); } catch {}
+    if (!profileName) {
+      process.stderr.write("No active profile. Use --profile <name> or --all.\n");
+      return 1;
+    }
+  }
+
+  if (all) {
+    const profiles = await listProfiles();
+    const results: ScoreResult[] = [];
+    for (const name of profiles) {
+      try {
+        const profile = await loadProfile(name);
+        results.push(computeScore(name, profile));
+      } catch {}
+    }
+    results.sort((a, b) => b.score - a.score);
+
+    if (json) {
+      process.stdout.write(JSON.stringify(results, null, 2) + "\n");
+      return 0;
+    }
+
+    process.stdout.write("🏆 Profile Scores\n\n");
+    for (const r of results) {
+      const color = r.grade.startsWith("A") ? "\x1b[32m" : r.grade.startsWith("B") ? "\x1b[34m"
+        : r.grade.startsWith("C") ? "\x1b[33m" : "\x1b[31m";
+      process.stdout.write(`  ${color}${r.grade.padEnd(3)}\x1b[0m ${r.profile.padEnd(20)} ${String(r.score).padStart(3)}/100  ${formatTokens(r.tokens).padStart(6)} tokens  ${Math.round(r.usageRate * 100)}% usage\n`);
+    }
+    return 0;
+  }
+
+  const profile = await loadProfile(profileName!);
+  const result = computeScore(profileName!, profile);
+
+  if (json) {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    return 0;
+  }
+
+  if (markdown) {
+    const color = gradeColor(result.grade).replace("#", "");
+    process.stdout.write(`![cue score](https://img.shields.io/badge/cue_score-${result.grade}-${color}?style=flat-square)\n`);
+    return 0;
+  }
+
+  if (badgePath) {
+    const svg = generateBadgeSvg(result);
+    writeFileSync(badgePath, svg);
+    process.stdout.write(`✅ Badge saved to ${badgePath}\n`);
+    return 0;
+  }
+
+  // Terminal output
+  const color = result.grade.startsWith("A") ? "\x1b[32m" : result.grade.startsWith("B") ? "\x1b[34m"
+    : result.grade.startsWith("C") ? "\x1b[33m" : "\x1b[31m";
+
+  process.stdout.write(`\n  ${color}${result.grade}\x1b[0m  \x1b[1m${result.profile}\x1b[0m  (${result.score}/100)\n\n`);
+  process.stdout.write(`  Token budget:  ${formatTokens(result.tokens).padStart(6)}  (score: ${Math.round(result.tokenScore)}/100)\n`);
+  process.stdout.write(`  Skill usage:   ${Math.round(result.usageRate * 100)}%`.padEnd(20) + `(score: ${result.usageScore}/100)\n`);
+  process.stdout.write(`  Unused skills: ${result.unusedSkills}`.padEnd(20) + `(score: ${result.unusedScore}/100)\n\n`);
+
+  if (result.unusedSkills > 0) {
+    process.stdout.write(`  💡 Remove ${result.unusedSkills} unused skill(s) to improve your score.\n`);
+    process.stdout.write(`     Run: cue skills audit\n`);
+  }
+
+  process.stdout.write(`\n  Badge: cue score --badge docs/assets/score.svg\n`);
+  process.stdout.write(`  README: cue score --markdown\n\n`);
+  return 0;
+}