selftune 0.2.9 → 0.2.12

package/cli/selftune/utils/frontmatter.ts

@@ -3,6 +3,8 @@
  *
  * Line-based YAML frontmatter parser for SKILL.md files.
  * Extracts name, description, and version without a YAML library.
+ * Also provides `replaceDescription` — the single public API for replacing
+ * a skill's description in SKILL.md (handles both frontmatter and plain markdown).
  */
 
 // ---------------------------------------------------------------------------
@@ -137,16 +139,57 @@ export function parseFrontmatter(content: string): SkillFrontmatter {
 // ---------------------------------------------------------------------------
 
 /**
- * Replace the `description:` field in YAML frontmatter, preserving all other
- * content. If the new description contains special YAML characters, it is
- * written as a folded scalar (`description: >`).
+ * Replace the description between the first `#` heading and the first `##`
+ * heading. If no `##` heading exists, the entire body after the heading is
+ * replaced. Used as fallback when no YAML frontmatter is present.
+ */
+function replaceMarkdownDescription(currentContent: string, newDescription: string): string {
+  const lines = currentContent.split("\n");
+
+  let headingIndex = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].startsWith("# ") && !lines[i].startsWith("## ")) {
+      headingIndex = i;
+      break;
+    }
+  }
+
+  if (headingIndex === -1) {
+    return `${newDescription}\n${currentContent}`;
+  }
+
+  let subHeadingIndex = -1;
+  for (let i = headingIndex + 1; i < lines.length; i++) {
+    if (lines[i].startsWith("## ")) {
+      subHeadingIndex = i;
+      break;
+    }
+  }
+
+  const preamble = headingIndex > 0 ? `${lines.slice(0, headingIndex).join("\n")}\n` : "";
+  const headingLine = lines[headingIndex];
+  const descriptionBlock = newDescription.length > 0 ? `\n${newDescription}\n` : "\n";
+
+  if (subHeadingIndex === -1) {
+    return `${preamble}${headingLine}\n${descriptionBlock}\n`;
+  }
+
+  const afterSubHeading = lines.slice(subHeadingIndex).join("\n");
+  return `${preamble}${headingLine}\n${descriptionBlock}\n${afterSubHeading}`;
+}
+
+/**
+ * Replace a skill's description in SKILL.md.
  *
- * Returns the original content unchanged if no frontmatter is found.
+ * If the file has YAML frontmatter, replaces the `description:` field
+ * (using folded scalar for long/special-char descriptions).
+ * Otherwise, falls back to markdown heading-based replacement.
  */
-export function replaceFrontmatterDescription(content: string, newDescription: string): string {
+export function replaceDescription(content: string, newDescription: string): string {
   const lines = content.split("\n");
 
-  if (lines[0]?.trim() !== "---") return content;
+  // No frontmatter — fall back to markdown heading-based replacement
+  if (lines[0]?.trim() !== "---") return replaceMarkdownDescription(content, newDescription);
 
   let endIdx = -1;
   for (let i = 1; i < lines.length; i++) {
@@ -155,7 +198,7 @@ export function replaceFrontmatterDescription(content: string, newDescription: s
       break;
     }
   }
-  if (endIdx < 0) return content;
+  if (endIdx < 0) return replaceMarkdownDescription(content, newDescription);
 
   // Find and replace the description within frontmatter lines
   const yamlLines = lines.slice(1, endIdx);

package/cli/selftune/utils/jsonl.ts

@@ -14,6 +14,7 @@ import {
   writeFileSync,
 } from "node:fs";
 import { dirname } from "node:path";
+
 import { createLogger } from "./logging.js";
 import type { LogType } from "./schema-validator.js";
 import { validateRecord } from "./schema-validator.js";

package/cli/selftune/utils/llm-call.ts

@@ -123,6 +123,9 @@ function sleep(ms: number): Promise<void> {
 // Call LLM via agent subprocess
 // ---------------------------------------------------------------------------
 
+/** Effort level for Claude CLI (controls thinking depth). Opus 4.6 only for 'max'. */
+export type EffortLevel = "low" | "medium" | "high" | "max";
+
 /** Call LLM via agent subprocess (claude/codex/opencode). Returns raw text. */
 export async function callViaAgent(
   systemPrompt: string,
@@ -130,6 +133,7 @@ export async function callViaAgent(
   agent: string,
   modelFlag?: string,
   retryOpts?: RetryOptions,
+  effort?: EffortLevel,
 ): Promise<string> {
   // Write prompt to temp file to avoid shell quoting issues
   const promptFile = join(tmpdir(), `selftune-llm-${Date.now()}.txt`);
@@ -145,6 +149,9 @@ export async function callViaAgent(
         const resolved = resolveModelFlag(modelFlag);
         cmd.push("--model", resolved);
       }
+      if (effort) {
+        cmd.push("--effort", effort);
+      }
     } else if (agent === "codex") {
       cmd = ["codex", "exec", "--skip-git-repo-check", promptContent];
     } else if (agent === "opencode") {
@@ -173,9 +180,10 @@ export async function callViaAgent(
           env: { ...process.env, CLAUDECODE: "" },
         });
 
-        // Longer timeout for heavier models (sonnet/opus take longer than haiku)
+        // Longer timeout for heavier models and thinking effort levels
         const isLightModel = modelFlag === "haiku" || modelFlag?.includes("haiku");
-        const timeoutMs = isLightModel ? 120_000 : 300_000;
+        const isThinking = effort === "high" || effort === "max";
+        const timeoutMs = isThinking ? 600_000 : isLightModel ? 120_000 : 300_000;
         const timeout = setTimeout(() => proc.kill(), timeoutMs);
         const exitCode = await proc.exited;
         clearTimeout(timeout);
@@ -210,6 +218,125 @@ export async function callViaAgent(
   }
 }
 
+// ---------------------------------------------------------------------------
+// Call LLM via named subagent (multi-turn, agentic)
+// ---------------------------------------------------------------------------
+
+/** Options for calling a named Claude Code subagent. */
+export interface SubagentCallOptions {
+  /** Name of the subagent (synced into ~/.claude/agents/ by selftune init/update). */
+  agentName: string;
+  /** The task prompt for the subagent. */
+  prompt: string;
+  /** Optional system prompt appended to the agent's built-in instructions. */
+  appendSystemPrompt?: string;
+  /** Maximum agentic turns (default: 8). */
+  maxTurns?: number;
+  /** Model override (overrides the agent's frontmatter model). */
+  modelFlag?: string;
+  /** Effort level for thinking depth. */
+  effort?: EffortLevel;
+  /** Retry options. */
+  retryOpts?: RetryOptions;
+  /** Tools the agent is allowed to use without prompting. */
+  allowedTools?: string[];
+}
+
+/**
+ * Call a named Claude Code subagent in print mode. The subagent runs its
+ * multi-turn workflow (reading files, running commands, etc.) and returns
+ * the final text output.
+ *
+ * Unlike callViaAgent(), this does NOT use --bare (agents need discovery)
+ * and passes --agent + --max-turns for agentic multi-turn behavior.
+ * Only supports the claude CLI.
+ */
+export async function callViaSubagent(options: SubagentCallOptions): Promise<string> {
+  const {
+    agentName,
+    prompt,
+    appendSystemPrompt,
+    maxTurns = 8,
+    modelFlag,
+    effort,
+    retryOpts,
+    allowedTools,
+  } = options;
+
+  const cmd: string[] = [
+    "claude",
+    "-p",
+    prompt,
+    "--agent",
+    agentName,
+    "--max-turns",
+    String(maxTurns),
+  ];
+
+  if (appendSystemPrompt) {
+    cmd.push("--append-system-prompt", appendSystemPrompt);
+  }
+  if (modelFlag) {
+    const resolved = resolveModelFlag(modelFlag);
+    cmd.push("--model", resolved);
+  }
+  if (effort) {
+    cmd.push("--effort", effort);
+  }
+  if (allowedTools && allowedTools.length > 0) {
+    cmd.push("--allowedTools", ...allowedTools);
+  }
+  // Skip permissions since this runs non-interactively in a pipeline
+  cmd.push("--dangerously-skip-permissions");
+
+  const maxRetries = retryOpts?.maxRetries ?? DEFAULT_MAX_RETRIES;
+  const initialBackoffMs = retryOpts?.initialBackoffMs ?? DEFAULT_INITIAL_BACKOFF_MS;
+  let lastError: Error | undefined;
+
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    if (attempt > 0) {
+      const backoffMs = initialBackoffMs * 2 ** (attempt - 1);
+      logger.warn(
+        `Retry ${attempt}/${maxRetries} for subagent '${agentName}' after ${backoffMs}ms backoff`,
+      );
+      await sleep(backoffMs);
+    }
+
+    try {
+      const proc = Bun.spawn(cmd, {
+        stdout: "pipe",
+        stderr: "pipe",
+        env: { ...process.env, CLAUDECODE: "" },
+      });
+
+      // Subagents get a generous timeout — they do multi-turn work
+      const isThinking = effort === "high" || effort === "max";
+      const timeoutMs = isThinking ? 600_000 : 300_000;
+      const timeout = setTimeout(() => proc.kill(), timeoutMs);
+      const exitCode = await proc.exited;
+      clearTimeout(timeout);
+
+      if (exitCode !== 0) {
+        const stderr = await new Response(proc.stderr).text();
+        throw new Error(
+          `Subagent '${agentName}' exited with code ${exitCode}.\nstderr: ${stderr.slice(0, 500)}`,
+        );
+      }
+
+      const raw = await new Response(proc.stdout).text();
+      return raw;
+    } catch (err) {
+      lastError = err instanceof Error ? err : new Error(String(err));
+      if (!isTransientError(lastError) || attempt === maxRetries) {
+        throw lastError;
+      }
+      logger.warn(`Transient failure on attempt ${attempt + 1}: ${lastError.message}`);
+    }
+  }
+
+  throw lastError ?? new Error("callViaSubagent: unexpected retry loop exit");
+}
+
 // ---------------------------------------------------------------------------
 // Unified dispatcher
 // ---------------------------------------------------------------------------
@@ -220,9 +347,10 @@ export async function callLlm(
   userPrompt: string,
   agent: string,
   modelFlag?: string,
+  effort?: EffortLevel,
 ): Promise<string> {
   if (!agent) {
     throw new Error("Agent must be specified for callLlm");
   }
-  return callViaAgent(systemPrompt, userPrompt, agent, modelFlag);
+  return callViaAgent(systemPrompt, userPrompt, agent, modelFlag, undefined, effort);
 }

package/cli/selftune/utils/skill-log.ts

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+
 import { REPAIRED_SKILL_LOG, REPAIRED_SKILL_SESSIONS_MARKER, SKILL_LOG } from "../constants.js";
 import type { SkillUsageRecord } from "../types.js";
 import { loadMarker, readJsonl, saveMarker } from "./jsonl.js";

package/cli/selftune/utils/transcript.ts

@@ -4,6 +4,7 @@
 
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { basename, dirname } from "node:path";
+
 import { CLAUDE_CODE_PROJECTS_DIR } from "../constants.js";
 import type { SessionTelemetryRecord, TranscriptMetrics } from "../types.js";
 import { isActionableQueryText } from "./query-filter.js";

package/cli/selftune/utils/trigger-check.ts

@@ -64,7 +64,7 @@ export function buildBatchTriggerCheckPrompt(description: string, queries: strin
  * original query order. Defaults to false for unparseable or missing lines.
  */
 export function parseBatchTriggerResponse(response: string, queryCount: number): boolean[] {
-  const results: boolean[] = new Array(queryCount).fill(false);
+  const results: boolean[] = Array.from({ length: queryCount }, () => false);
   const lines = response.trim().split("\n");
 
   for (const line of lines) {

package/cli/selftune/workflows/skill-md-writer.ts

@@ -36,7 +36,7 @@ export function parseWorkflowsSection(content: string): CodifiedWorkflow[] {
   // Find the end of the section (next ## heading or EOF)
   let sectionEnd = lines.length;
   for (let i = sectionStart; i < lines.length; i++) {
-    if (/^## /.test(lines[i]) && lines[i].trim() !== "## Workflows") {
+    if (lines[i].startsWith("## ") && lines[i].trim() !== "## Workflows") {
       sectionEnd = i;
       break;
     }
@@ -155,7 +155,7 @@ export function appendWorkflow(content: string, workflow: CodifiedWorkflow): str
     // Find the end of the workflows section (next ## heading or EOF)
     let sectionEnd = lines.length;
     for (let i = sectionStart + 1; i < lines.length; i++) {
-      if (/^## /.test(lines[i])) {
+      if (lines[i].startsWith("## ")) {
         sectionEnd = i;
         break;
       }
@@ -210,7 +210,7 @@ export function removeWorkflow(content: string, name: string): string {
   // Find the end of the workflows section
   let sectionEnd = lines.length;
   for (let i = sectionStart + 1; i < lines.length; i++) {
-    if (/^## /.test(lines[i])) {
+    if (lines[i].startsWith("## ")) {
       sectionEnd = i;
       break;
     }
@@ -226,7 +226,7 @@ export function removeWorkflow(content: string, name: string): string {
       // Find the end of this subsection (next ### or ## or sectionEnd)
       subEnd = sectionEnd;
       for (let j = i + 1; j < sectionEnd; j++) {
-        if (/^### /.test(lines[j])) {
+        if (lines[j].startsWith("### ")) {
           subEnd = j;
           break;
         }
@@ -255,7 +255,7 @@ export function removeWorkflow(content: string, name: string): string {
 
   // Check if the workflows section is now empty
   const remaining = [...before.slice(sectionStart + 1), ...after.slice(0, sectionEnd - removeTo)];
-  const hasRemainingWorkflows = remaining.some((l) => /^### /.test(l));
+  const hasRemainingWorkflows = remaining.some((l) => l.startsWith("### "));
 
   if (!hasRemainingWorkflows) {
     // Remove the entire ## Workflows section (heading + any blank lines)

package/cli/selftune/workflows/workflows.ts

@@ -10,6 +10,7 @@
 
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { parseArgs } from "node:util";
+
 import { getDb } from "../localdb/db.js";
 import { querySessionTelemetry, querySkillUsageRecords } from "../localdb/queries.js";
 import type {

package/package.json

@@ -1,41 +1,44 @@
 {
   "name": "selftune",
-  "version": "0.2.9",
+  "version": "0.2.12",
   "description": "Self-improving skills CLI for AI agents",
-  "type": "module",
+  "keywords": [
+    "agent",
+    "bun",
+    "claude-code",
+    "cli",
+    "codex",
+    "eval",
+    "evolution",
+    "grading",
+    "opencode",
+    "self-improving",
+    "selftune",
+    "skill",
+    "telemetry",
+    "typescript"
+  ],
+  "homepage": "https://github.com/selftune-dev/selftune#readme",
+  "bugs": {
+    "url": "https://github.com/selftune-dev/selftune/issues"
+  },
   "license": "MIT",
   "author": "Daniel Petro",
-  "homepage": "https://github.com/selftune-dev/selftune#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/selftune-dev/selftune.git"
   },
-  "bugs": {
-    "url": "https://github.com/selftune-dev/selftune/issues"
-  },
   "funding": {
     "type": "github",
     "url": "https://github.com/sponsors/WellDunDun"
   },
-  "keywords": [
-    "selftune",
-    "skill",
-    "self-improving",
-    "claude-code",
-    "codex",
-    "opencode",
-    "eval",
-    "grading",
-    "evolution",
-    "cli",
-    "agent",
-    "telemetry",
-    "bun",
-    "typescript"
-  ],
   "bin": {
     "selftune": "bin/selftune.cjs"
   },
+  "workspaces": [
+    "packages/*",
+    "apps/*"
+  ],
   "files": [
     "assets/",
     "bin/",
@@ -44,39 +47,40 @@
     "packages/telemetry-contract/",
     "packages/ui/",
     "templates/",
-    ".claude/agents/",
     "skill/",
     "README.md",
     "CHANGELOG.md"
   ],
+  "type": "module",
   "scripts": {
-    "dev": "sh -c 'if lsof -iTCP:7888 -sTCP:LISTEN >/dev/null 2>&1; then if curl -fsS http://localhost:7888/api/health | grep -q selftune-dashboard; then echo \"Using existing dashboard server on 7888\"; cd apps/local-dashboard && bunx vite --strictPort; else echo \"Port 7888 is occupied by a non-selftune service\"; exit 1; fi; else cd apps/local-dashboard && bun run dev; fi'",
+    "dev": "trap 'kill 0' EXIT; bun --watch run cli/selftune/dashboard-server.ts --port 7888 --runtime-mode dev-server & sleep 1 && cd apps/local-dashboard && bunx vite --strictPort",
     "dev:server": "bun --watch run cli/selftune/dashboard-server.ts --port 7888 --runtime-mode dev-server",
     "dev:dashboard": "bun run cli/selftune/index.ts dashboard --port 7888 --no-open",
-    "lint": "bunx @biomejs/biome check .",
-    "lint:fix": "bunx @biomejs/biome check --write .",
+    "lint": "bunx oxlint",
+    "lint:fix": "bunx oxlint --fix",
+    "format": "bunx oxfmt",
+    "format:check": "bunx oxfmt --check",
     "lint:arch": "bun run lint-architecture.ts",
     "test": "bun test tests/ packages/telemetry-contract/",
     "test:fast": "bun test $(find tests -name '*.test.ts' ! -name 'evolve.test.ts' ! -name 'integration.test.ts' ! -name 'dashboard-server.test.ts' ! -path '*/blog-proof/*')",
     "test:slow": "bun test tests/evolution/evolve.test.ts tests/evolution/integration.test.ts tests/monitoring/integration.test.ts tests/dashboard/dashboard-server.test.ts",
     "build:dashboard": "cd apps/local-dashboard && bunx vite build",
+    "prepack": "node scripts/publish-package-json.cjs prepare",
+    "postpack": "node scripts/publish-package-json.cjs restore",
     "link:claude-workspace": "bash scripts/link-claude-workspace.sh",
     "sync-version": "bun run scripts/sync-skill-version.ts",
     "validate:subagents": "bun run scripts/validate-subagent-docs.ts",
     "prepublishOnly": "bun run sync-version && bun run build:dashboard",
     "typecheck:dashboard": "cd apps/local-dashboard && bunx tsc --noEmit",
-    "check": "bun run lint && bun run lint:arch && bun run typecheck:dashboard && bun run test",
+    "check": "bun run lint && bun run format:check && bun run lint:arch && bun run typecheck:dashboard && bun run test",
     "start": "bun run cli/selftune/index.ts --help"
   },
-  "workspaces": [
-    "packages/*",
-    "apps/*"
-  ],
   "dependencies": {
     "@selftune/telemetry-contract": "file:packages/telemetry-contract"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.7",
-    "@types/bun": "^1.1.0"
+    "@types/bun": "^1.1.0",
+    "oxfmt": "^0.41.0",
+    "oxlint": "^1.56.0"
   }
 }

package/packages/telemetry-contract/fixtures/golden.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, test } from "bun:test";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
+
 import { CANONICAL_SCHEMA_VERSION } from "../src/types.js";
 import { isCanonicalRecord } from "../src/validators.js";
 

package/packages/telemetry-contract/package.json

@@ -3,7 +3,6 @@
   "version": "1.0.0",
   "private": true,
   "description": "Canonical telemetry schema, types, and validators for selftune",
-  "type": "module",
   "license": "MIT",
   "author": "Daniel Petro",
   "repository": {
@@ -11,6 +10,7 @@
     "url": "git+https://github.com/selftune-dev/selftune.git",
     "directory": "packages/telemetry-contract"
   },
+  "type": "module",
   "exports": {
     ".": "./index.ts",
     "./schemas": "./src/schemas.ts",

package/packages/telemetry-contract/src/schemas.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+
 import {
   CANONICAL_CAPTURE_MODES,
   CANONICAL_COMPLETION_STATUSES,

package/packages/telemetry-contract/tests/compatibility.test.ts

@@ -1,4 +1,5 @@
 import { describe, expect, test } from "bun:test";
+
 import { completePush } from "../fixtures/complete-push.js";
 import { evidenceOnlyPush } from "../fixtures/evidence-only-push.js";
 import { partialPushNoSessions } from "../fixtures/partial-push-no-sessions.js";

package/packages/ui/README.md

@@ -17,16 +17,16 @@ Add as a workspace dependency:
 Import from subpath exports:
 
 ```tsx
-import { Badge, Button, Card } from "@selftune/ui/primitives"
-import { SkillHealthGrid, EvolutionTimeline } from "@selftune/ui/components"
-import { cn, timeAgo, deriveStatus, STATUS_CONFIG } from "@selftune/ui/lib"
-import type { SkillCard, EvolutionEntry } from "@selftune/ui/types"
+import { Badge, Button, Card } from "@selftune/ui/primitives";
+import { SkillHealthGrid, EvolutionTimeline } from "@selftune/ui/components";
+import { cn, timeAgo, deriveStatus, STATUS_CONFIG } from "@selftune/ui/lib";
+import type { SkillCard, EvolutionEntry } from "@selftune/ui/types";
 ```
 
 Or import everything from the root:
 
 ```tsx
-import { Badge, SkillHealthGrid, cn, type SkillCard } from "@selftune/ui"
+import { Badge, SkillHealthGrid, cn, type SkillCard } from "@selftune/ui";
 ```
 
 ## Exports
@@ -35,44 +35,44 @@ import { Badge, SkillHealthGrid, cn, type SkillCard } from "@selftune/ui"
 
 shadcn/ui components built on [@base-ui/react](https://base-ui.com/):
 
-| Component | Source |
-|-----------|--------|
-| `Badge`, `badgeVariants` | badge.tsx |
-| `Button`, `buttonVariants` | button.tsx |
-| `Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardAction`, `CardContent`, `CardFooter` | card.tsx |
-| `Checkbox` | checkbox.tsx |
-| `Collapsible`, `CollapsibleTrigger`, `CollapsibleContent` | collapsible.tsx |
-| `DropdownMenu`, `DropdownMenuTrigger`, `DropdownMenuContent`, `DropdownMenuItem`, ... | dropdown-menu.tsx |
-| `Label` | label.tsx |
-| `Select`, `SelectTrigger`, `SelectContent`, `SelectItem`, ... | select.tsx |
-| `Table`, `TableHeader`, `TableBody`, `TableRow`, `TableHead`, `TableCell`, ... | table.tsx |
-| `Tabs`, `TabsList`, `TabsTrigger`, `TabsContent` | tabs.tsx |
-| `Tooltip`, `TooltipTrigger`, `TooltipContent`, `TooltipProvider` | tooltip.tsx |
+| Component                                                                                       | Source            |
+| ----------------------------------------------------------------------------------------------- | ----------------- |
+| `Badge`, `badgeVariants`                                                                        | badge.tsx         |
+| `Button`, `buttonVariants`                                                                      | button.tsx        |
+| `Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardAction`, `CardContent`, `CardFooter` | card.tsx          |
+| `Checkbox`                                                                                      | checkbox.tsx      |
+| `Collapsible`, `CollapsibleTrigger`, `CollapsibleContent`                                       | collapsible.tsx   |
+| `DropdownMenu`, `DropdownMenuTrigger`, `DropdownMenuContent`, `DropdownMenuItem`, ...           | dropdown-menu.tsx |
+| `Label`                                                                                         | label.tsx         |
+| `Select`, `SelectTrigger`, `SelectContent`, `SelectItem`, ...                                   | select.tsx        |
+| `Table`, `TableHeader`, `TableBody`, `TableRow`, `TableHead`, `TableCell`, ...                  | table.tsx         |
+| `Tabs`, `TabsList`, `TabsTrigger`, `TabsContent`                                                | tabs.tsx          |
+| `Tooltip`, `TooltipTrigger`, `TooltipContent`, `TooltipProvider`                                | tooltip.tsx       |
 
 ### Domain Components (`@selftune/ui/components`)
 
 Presentational components for selftune dashboard views. No data fetching, no routing — pass data and callbacks as props.
 
-| Component | Description |
-|-----------|-------------|
-| `SkillHealthGrid` | Sortable/filterable data table with drag-and-drop, pagination, and view tabs. Accepts `renderSkillName` prop for custom routing. |
-| `EvolutionTimeline` | Proposal lifecycle timeline grouped by proposal ID, with pass rate deltas. |
-| `ActivityPanel` | Tabbed activity feed (pending proposals, timeline events, unmatched queries). |
-| `EvidenceViewer` | Full evidence trail for a proposal — side-by-side diffs, validation results, iteration rounds. |
-| `SectionCards` | Dashboard metric stat cards (skills count, pass rate, unmatched, sessions, etc.). |
-| `OrchestrateRunsPanel` | Collapsible orchestrate run reports with per-skill action details. |
-| `InfoTip` | Small info icon with tooltip, used to explain metrics. |
+| Component              | Description                                                                                                                      |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `SkillHealthGrid`      | Sortable/filterable data table with drag-and-drop, pagination, and view tabs. Accepts `renderSkillName` prop for custom routing. |
+| `EvolutionTimeline`    | Proposal lifecycle timeline grouped by proposal ID, with pass rate deltas.                                                       |
+| `ActivityPanel`        | Tabbed activity feed (undeployed proposals, timeline events, unmatched queries).                                                 |
+| `EvidenceViewer`       | Full evidence trail for a proposal — side-by-side diffs, validation results, iteration rounds.                                   |
+| `SectionCards`         | Dashboard metric stat cards (skills count, pass rate, unmatched, sessions, etc.).                                                |
+| `OrchestrateRunsPanel` | Collapsible orchestrate run reports with per-skill action details.                                                               |
+| `InfoTip`              | Small info icon with tooltip, used to explain metrics.                                                                           |
 
 ### Utilities (`@selftune/ui/lib`)
 
-| Export | Description |
-|--------|-------------|
-| `cn(...inputs)` | Tailwind class merge utility (clsx + tailwind-merge) |
-| `timeAgo(timestamp)` | Relative time string ("3h ago", "2d ago") |
-| `formatRate(rate)` | Format 0-1 rate as percentage string ("85%") |
-| `deriveStatus(passRate, checks)` | Derive `SkillHealthStatus` from pass rate and check count |
+| Export                           | Description                                                     |
+| -------------------------------- | --------------------------------------------------------------- |
+| `cn(...inputs)`                  | Tailwind class merge utility (clsx + tailwind-merge)            |
+| `timeAgo(timestamp)`             | Relative time string ("3h ago", "2d ago")                       |
+| `formatRate(rate)`               | Format 0-1 rate as percentage string ("85%")                    |
+| `deriveStatus(passRate, checks)` | Derive `SkillHealthStatus` from pass rate and check count       |
 | `sortByPassRateAndChecks(items)` | Sort skill cards by pass rate ascending, then checks descending |
-| `STATUS_CONFIG` | Icon, variant, and label for each `SkillHealthStatus` value |
+| `STATUS_CONFIG`                  | Icon, variant, and label for each `SkillHealthStatus` value     |
 
 ### Types (`@selftune/ui/types`)
 
@@ -107,6 +107,7 @@ This package uses Tailwind v4. The Vite plugin auto-scans imported workspace pac
 Required: `react`, `react-dom`
 
 Optional (only needed by specific components):
+
 - `@dnd-kit/*` — SkillHealthGrid drag-and-drop
 - `@tanstack/react-table` — SkillHealthGrid table
 - `react-markdown` — EvidenceViewer markdown rendering

package/packages/ui/package.json

@@ -3,7 +3,6 @@
   "version": "1.0.0",
   "private": true,
   "description": "Shared UI components for selftune dashboards",
-  "type": "module",
   "license": "MIT",
   "author": "Daniel Petro",
   "repository": {
@@ -11,6 +10,7 @@
     "url": "git+https://github.com/selftune-dev/selftune.git",
     "directory": "packages/ui"
   },
+  "type": "module",
   "exports": {
     ".": "./index.ts",
     "./primitives": "./src/primitives/index.ts",
@@ -30,13 +30,13 @@
     "@types/react-dom": "^19.0.0"
   },
   "peerDependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
     "@dnd-kit/core": "^6.0.0",
     "@dnd-kit/modifiers": "^9.0.0",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.0.0",
     "@tanstack/react-table": "^8.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "react-markdown": "^10.0.0",
     "recharts": "^2.0.0"
   },