selftune 0.2.22 → 0.2.24

package/cli/selftune/index.ts

@@ -3,7 +3,7 @@
  * selftune CLI entry point.
  *
  * Usage:
- *   selftune ingest <agent>     — Ingest agent sessions (claude, codex, opencode, openclaw, wrap-codex)
+ *   selftune ingest <agent>     — Ingest agent sessions (claude, codex, opencode, openclaw, pi, wrap-codex)
  *   selftune grade [mode]       — Grade skill sessions (auto, baseline)
  *   selftune evolve [target]    — Evolve skill descriptions (body, rollback)
  *   selftune eval <action>      — Evaluation tools (generate, unit-test, import, composability, family-overlap)
@@ -21,21 +21,24 @@
  *   selftune contribute         — Export anonymized skill data for community
  *   selftune contributions      — Manage creator-directed sharing preferences
  *   selftune creator-contributions — Manage creator-side contribution configs
- *   selftune workflows          — Discover and manage multi-skill workflows
+ *   selftune workflows          — Discover workflows and scaffold workflow skills
  *   selftune quickstart         — Guided onboarding: init, ingest, status, and suggestions
  *   selftune repair-skill-usage — Rebuild trustworthy skill usage from transcripts
  *   selftune export             — Export SQLite data to JSONL snapshots
  *   selftune export-canonical   — Export canonical telemetry for downstream ingestion
  *   selftune recover            — Recover SQLite from legacy/exported JSONL
  *   selftune telemetry          — Manage anonymous usage analytics (status, enable, disable)
+ *   selftune registry <sub>    — Team skill distribution (push, install, sync, status, rollback, history, list)
  *   selftune alpha <subcommand> — Alpha program management (upload)
  *   selftune hook <name>        — Run a hook by name (prompt-log, session-stop, etc.)
  *   selftune codex <subcommand> — Codex platform hooks (hook, install)
  *   selftune opencode <sub>     — OpenCode platform hooks (hook, install)
  *   selftune cline <subcommand> — Cline platform hooks (hook, install)
+ *   selftune pi <subcommand>    — Pi platform hooks (hook, install)
  */
 
 import { CLIError, handleCLIError } from "./utils/cli-error.js";
+import { PUBLIC_COMMAND_SURFACES, renderCommandHelp } from "./command-surface.js";
 
 process.on("uncaughtException", handleCLIError);
 process.on("unhandledRejection", handleCLIError);
@@ -49,7 +52,7 @@ Usage:
   selftune <command> [options]
 
 Commands:
-  ingest <agent>     Ingest agent sessions (claude, codex, opencode, openclaw, wrap-codex)
+  ingest <agent>     Ingest agent sessions (claude, codex, opencode, openclaw, pi, wrap-codex)
   grade [mode]       Grade skill sessions (auto, baseline)
   evolve [target]    Evolve skill descriptions (body, rollback)
   eval <action>      Evaluation tools (generate, unit-test, import, composability, family-overlap)
@@ -67,25 +70,27 @@ Commands:
   contribute         Export anonymized skill data for community
   contributions      Manage creator-directed sharing preferences
   creator-contributions Manage creator-side contribution configs
-  workflows          Discover and manage multi-skill workflows
+  workflows          Discover workflows and scaffold workflow skills
   quickstart         Guided onboarding: init, ingest, status, and suggestions
   repair-skill-usage Rebuild trustworthy skill usage from transcripts
   export             Export SQLite data to JSONL snapshots
   export-canonical   Export canonical telemetry for downstream ingestion
   recover            Recover SQLite from legacy/exported JSONL
+  registry <sub>    Team skill distribution (push, install, sync, status, rollback, history, list)
   alpha <subcommand> Alpha program management (upload)
   telemetry          Manage anonymous usage analytics (status, enable, disable)
   hook <name>        Run a hook by name (prompt-log, session-stop, etc.)
   codex <sub>        Codex platform hooks (hook, install)
   opencode <sub>     OpenCode platform hooks (hook, install)
   cline <sub>        Cline platform hooks (hook, install)
+  pi <sub>           Pi platform hooks (hook, install)
 
 Run 'selftune <command> --help' for command-specific options.`);
   process.exit(0);
 }
 
 // Fast-path commands (real-time hooks) — skip analytics and auto-update to minimize latency
-const FAST_COMMANDS: ReadonlySet<string> = new Set(["hook", "codex", "opencode", "cline"]);
+const FAST_COMMANDS: ReadonlySet<string> = new Set(["hook", "codex", "opencode", "cline", "pi"]);
 
 // Track command usage (lazy import — skip for hooks and --help to avoid loading crypto/os)
 if (command && !FAST_COMMANDS.has(command) && command !== "--help" && command !== "-h") {
@@ -129,6 +134,7 @@ Agents:
   codex        Ingest Codex rollout logs (experimental)
   opencode     Ingest OpenCode sessions (experimental)
   openclaw     Ingest OpenClaw sessions (experimental)
+  pi           Ingest Pi sessions (experimental)
   wrap-codex   Wrap codex exec with real-time telemetry (experimental)
 
 Run 'selftune ingest <agent> --help' for agent-specific options.`);
@@ -157,6 +163,11 @@ Run 'selftune ingest <agent> --help' for agent-specific options.`);
         cliMain();
         break;
       }
+      case "pi": {
+        const { cliMain } = await import("./ingestors/pi-ingest.js");
+        cliMain();
+        break;
+      }
       case "wrap-codex": {
         const { cliMain } = await import("./ingestors/codex-wrapper.js");
         await cliMain();
@@ -217,12 +228,12 @@ Run 'selftune grade <subcommand> --help' for subcommand-specific options.`);
   case "evolve": {
     const sub = process.argv[2];
     if (sub === "--help" || sub === "-h") {
-      console.log(`selftune evolve — Evolve skill descriptions
+      console.log(`${renderCommandHelp(PUBLIC_COMMAND_SURFACES.evolve)}
 
-Usage:
-  selftune evolve [options]            Run description evolution
-  selftune evolve body [options]       Evolve full body or routing table
-  selftune evolve rollback [options]   Rollback a previous evolution
+Subcommands:
+  selftune evolve body [options]              Evolve full body or routing table
+  selftune evolve rollback [options]          Rollback a previous evolution
+  selftune evolve apply-proposal [options]    Apply an approved contributor proposal
 
 Run 'selftune evolve <subcommand> --help' for subcommand-specific options.`);
       process.exit(0);
@@ -245,6 +256,11 @@ Run 'selftune evolve <subcommand> --help' for subcommand-specific options.`);
           await cliMain();
           break;
         }
+        case "apply-proposal": {
+          const { cliMain } = await import("./evolution/apply-proposal.js");
+          await cliMain();
+          break;
+        }
         default:
           throw new CLIError(
             `Unknown evolve target: ${sub}`,
@@ -271,6 +287,12 @@ Actions:
   composability  Analyze skill co-occurrence conflicts
   family-overlap Detect sibling-skill overlap and consolidation pressure
 
+Recommended creator loop:
+  1. selftune eval generate --skill <name>
+  2. selftune eval unit-test --skill <name> --generate --skill-path <path>
+  3. selftune evolve --skill <name> --skill-path <path> --dry-run --validation-mode replay
+  4. selftune grade baseline --skill <name> --skill-path <path>
+
 Run 'selftune eval <action> --help' for action-specific options.`);
       process.exit(0);
     }
@@ -327,7 +349,8 @@ Run 'selftune eval <action> --help' for action-specific options.`);
             "selftune eval composability --skill <name>",
           );
         }
-        const logPath = values["telemetry-log"] ?? TELEMETRY_LOG;
+        const logPath =
+          typeof values["telemetry-log"] === "string" ? values["telemetry-log"] : TELEMETRY_LOG;
         let telemetry: unknown[];
         if (logPath === TELEMETRY_LOG) {
           try {
@@ -353,7 +376,19 @@ Run 'selftune eval <action> --help' for action-specific options.`);
           );
         }
         const windowSize = rawWindow === undefined ? undefined : Number(rawWindow);
-        const report = analyzeComposability(values.skill, telemetry, windowSize);
+        const skillName = typeof values.skill === "string" ? values.skill : undefined;
+        if (!skillName) {
+          throw new CLIError(
+            "--skill <name> is required.",
+            "MISSING_FLAG",
+            "selftune eval composability --skill <name>",
+          );
+        }
+        const report = analyzeComposability(
+          skillName,
+          telemetry as import("./types.js").SessionTelemetryRecord[],
+          windowSize,
+        );
         console.log(JSON.stringify(report, null, 2));
         break;
       }
@@ -620,6 +655,11 @@ Options:
     await cliMain();
     break;
   }
+  case "registry": {
+    const { cliMain } = await import("./registry/index.js");
+    await cliMain();
+    break;
+  }
   case "alpha": {
     const sub = process.argv[2];
     if (!sub || sub === "--help" || sub === "-h") {
@@ -705,7 +745,7 @@ Output:
           userId: identity.user_id,
           agentType: readConfiguredAgentType(SELFTUNE_CONFIG_PATH, "unknown"),
           selftuneVersion: getSelftuneVersion(),
-          dryRun: values["dry-run"] ?? false,
+          dryRun: values["dry-run"] === true,
           apiKey: identity.api_key,
         });
 
@@ -828,9 +868,12 @@ Output:
 
   case "codex":
   case "opencode":
-  case "cline": {
+  case "cline":
+  case "pi": {
     const platform = command;
-    const displayName = { codex: "Codex", opencode: "OpenCode", cline: "Cline" }[platform];
+    const displayName = { codex: "Codex", opencode: "OpenCode", cline: "Cline", pi: "Pi" }[
+      platform
+    ];
     const sub = process.argv[2];
     if (!sub || sub === "--help" || sub === "-h") {
       console.log(`selftune ${platform} — ${displayName} platform hooks

package/cli/selftune/ingestors/claude-replay.ts

@@ -347,13 +347,15 @@ export function cliMain(): void {
     );
   }
 
-  const projectsDir = values["projects-dir"] ?? CLAUDE_CODE_PROJECTS_DIR;
+  const projectsDir =
+    typeof values["projects-dir"] === "string" ? values["projects-dir"] : CLAUDE_CODE_PROJECTS_DIR;
   let since: Date | undefined;
-  if (values.since) {
-    since = new Date(values.since);
+  const sinceValue = typeof values.since === "string" ? values.since : undefined;
+  if (sinceValue) {
+    since = new Date(sinceValue);
     if (Number.isNaN(since.getTime())) {
       throw new CLIError(
-        `Invalid --since date: "${values.since}"`,
+        `Invalid --since date: "${sinceValue}"`,
         "INVALID_FLAG",
         "selftune ingest claude --since 2026-01-01",
       );
@@ -376,32 +378,35 @@ export function cliMain(): void {
   );
 
   if (since) {
-    console.log(`  Filtering to sessions from ${values.since} onward.`);
+    console.log(`  Filtering to sessions from ${sinceValue} onward.`);
   }
 
   let ingestedCount = 0;
   let skippedCount = 0;
 
+  const dryRun = values["dry-run"] === true;
+  const verbose = values.verbose === true;
+
   for (const transcriptFile of pending) {
     const session = parseSession(transcriptFile);
     if (session === null) {
-      if (values.verbose) {
+      if (verbose) {
         console.log(`  SKIP (empty/no queries): ${basename(transcriptFile)}`);
       }
       skippedCount += 1;
       continue;
     }
 
-    if (values.verbose || values["dry-run"]) {
-      console.log(`  ${values["dry-run"] ? "[DRY] " : ""}Ingesting: ${basename(transcriptFile)}`);
+    if (verbose || dryRun) {
+      console.log(`  ${dryRun ? "[DRY] " : ""}Ingesting: ${basename(transcriptFile)}`);
     }
 
-    writeSession(session, values["dry-run"]);
+    writeSession(session, dryRun);
     newIngested.add(transcriptFile);
     ingestedCount += 1;
   }
 
-  if (!values["dry-run"]) {
+  if (!dryRun) {
     saveMarker(CLAUDE_CODE_MARKER, new Set([...alreadyIngested, ...newIngested]));
   }
 

package/cli/selftune/ingestors/codex-wrapper.ts

@@ -87,7 +87,7 @@ export function extractPromptFromArgs(args: string[]): string {
 }
 
 export interface ParsedCodexStream {
-  thread_id: string;
+  thread_id?: string;
   tool_calls: Record<string, number>;
   total_tool_calls: number;
   bash_commands: string[];
@@ -96,7 +96,7 @@ export interface ParsedCodexStream {
   errors_encountered: number;
   input_tokens: number;
   output_tokens: number;
-  agent_summary: string;
+  agent_summary?: string;
   transcript_chars: number;
 }
 
@@ -475,7 +475,7 @@ export async function cliMain(): Promise<void> {
     // Parse and log
     const metrics = parseJsonlStream(collectedLines, skillNames);
     const actualThreadId = metrics.thread_id;
-    const sessionId = actualThreadId !== "unknown" ? actualThreadId : threadId;
+    const sessionId = actualThreadId && actualThreadId !== "unknown" ? actualThreadId : threadId;
 
     const { thread_id: _, ...metricsWithoutThread } = metrics;
 

package/cli/selftune/ingestors/opencode-ingest.ts

@@ -210,7 +210,7 @@ export function readSessionsFromSqlite(
 
   // Get sessions
   let whereClause = "";
-  const queryParams: unknown[] = [];
+  const queryParams: number[] = [];
   if (sinceTs) {
     whereClause = "WHERE created > ?";
     queryParams.push(Math.floor(sinceTs * 1000));
@@ -239,7 +239,7 @@ export function readSessionsFromSqlite(
     try {
       msgRows = db
         .query(`SELECT * FROM ${safeMessagesTable} WHERE session_id = ? ORDER BY created ASC`)
-        .all(sessionRow.id) as Array<Record<string, unknown>>;
+        .all(String(sessionRow.id)) as Array<Record<string, unknown>>;
     } catch {
       continue;
     }