selftune 0.2.13 → 0.2.15

package/cli/selftune/index.ts

@@ -29,6 +29,11 @@
  *   selftune hook <name>        — Run a hook by name (prompt-log, session-stop, etc.)
  */
 
+import { CLIError, handleCLIError } from "./utils/cli-error.js";
+
+process.on("uncaughtException", handleCLIError);
+process.on("unhandledRejection", handleCLIError);
+
 const command = process.argv[2];
 
 if (command === "--help" || command === "-h") {
@@ -84,6 +89,7 @@ if (!command) {
   // Show status by default — same as `selftune status`
   const { cliMain: statusMain } = await import("./status.js");
   statusMain();
+  process.exit(0);
 }
 
 // Route to the appropriate subcommand module.
@@ -142,10 +148,11 @@ Run 'selftune ingest <agent> --help' for agent-specific options.`);
         break;
       }
       default:
-        console.error(
-          `Unknown ingest agent: ${sub}\nRun 'selftune ingest --help' for available agents.`,
+        throw new CLIError(
+          `Unknown ingest agent: ${sub}`,
+          "UNKNOWN_COMMAND",
+          "selftune ingest --help",
         );
-        process.exit(1);
     }
     break;
   }
@@ -182,10 +189,11 @@ Run 'selftune grade <subcommand> --help' for subcommand-specific options.`);
           break;
         }
         default:
-          console.error(
-            `Unknown grade mode: ${sub}\nRun 'selftune grade --help' for available modes.`,
+          throw new CLIError(
+            `Unknown grade mode: ${sub}`,
+            "UNKNOWN_COMMAND",
+            "selftune grade --help",
           );
-          process.exit(1);
       }
     }
     break;
@@ -223,10 +231,11 @@ Run 'selftune evolve <subcommand> --help' for subcommand-specific options.`);
           break;
         }
         default:
-          console.error(
-            `Unknown evolve target: ${sub}\nRun 'selftune evolve --help' for available targets.`,
+          throw new CLIError(
+            `Unknown evolve target: ${sub}`,
+            "UNKNOWN_COMMAND",
+            "selftune evolve --help",
           );
-          process.exit(1);
       }
     }
     break;
@@ -289,13 +298,18 @@ Run 'selftune eval <action> --help' for action-specific options.`);
           }));
         } catch (error) {
           const message = error instanceof Error ? error.message : String(error);
-          console.error(`Invalid arguments: ${message}`);
-          console.error("Run 'selftune eval composability --help' for usage.");
-          process.exit(1);
+          throw new CLIError(
+            `Invalid arguments: ${message}`,
+            "INVALID_FLAG",
+            "selftune eval composability --help",
+          );
         }
         if (!values.skill) {
-          console.error("[ERROR] --skill <name> is required.");
-          process.exit(1);
+          throw new CLIError(
+            "--skill <name> is required.",
+            "MISSING_FLAG",
+            "selftune eval composability --skill <name>",
+          );
         }
         const logPath = values["telemetry-log"] ?? TELEMETRY_LOG;
         let telemetry: unknown[];
@@ -316,8 +330,11 @@ Run 'selftune eval <action> --help' for action-specific options.`);
         }
         const rawWindow = values.window as string | undefined;
         if (rawWindow !== undefined && !/^[1-9]\d*$/.test(rawWindow)) {
-          console.error("Invalid --window value. Use a positive integer number of days.");
-          process.exit(1);
+          throw new CLIError(
+            "Invalid --window value. Use a positive integer number of days.",
+            "INVALID_FLAG",
+            "selftune eval composability --skill <name> --window 30",
+          );
         }
         const windowSize = rawWindow === undefined ? undefined : Number(rawWindow);
         const report = analyzeComposability(values.skill, telemetry, windowSize);
@@ -325,10 +342,11 @@ Run 'selftune eval <action> --help' for action-specific options.`);
         break;
       }
       default:
-        console.error(
-          `Unknown eval action: ${sub}\nRun 'selftune eval --help' for available actions.`,
+        throw new CLIError(
+          `Unknown eval action: ${sub}`,
+          "UNKNOWN_COMMAND",
+          "selftune eval --help",
         );
-        process.exit(1);
     }
     break;
   }
@@ -457,10 +475,11 @@ Run 'selftune cron <subcommand> --help' for subcommand-specific options.`);
         break;
       }
       default:
-        console.error(
-          `Unknown cron subcommand: ${sub}\nRun 'selftune cron --help' for available subcommands.`,
+        throw new CLIError(
+          `Unknown cron subcommand: ${sub}`,
+          "UNKNOWN_COMMAND",
+          "selftune cron --help",
         );
-        process.exit(1);
     }
     break;
   }
@@ -505,9 +524,7 @@ Run 'selftune cron <subcommand> --help' for subcommand-specific options.`);
       }));
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      console.error(`Invalid arguments: ${message}`);
-      console.error("Run 'selftune export --help' for usage.");
-      process.exit(1);
+      throw new CLIError(`Invalid arguments: ${message}`, "INVALID_FLAG", "selftune export --help");
     }
     if (values.help) {
       console.log(`selftune export — Export SQLite data to JSONL files
@@ -544,9 +561,7 @@ Options:
       }
     } catch (err: unknown) {
       const message = err instanceof Error ? err.message : String(err);
-      console.error(`Export failed: ${message}`);
-      console.error("Ensure the SQLite database exists. Run 'selftune sync' first if needed.");
-      process.exit(1);
+      throw new CLIError(`Export failed: ${message}`, "OPERATION_FAILED", "selftune sync");
     }
     break;
   }
@@ -590,8 +605,11 @@ Run 'selftune alpha <subcommand> --help' for subcommand-specific options.`);
           }));
         } catch (error) {
           const message = error instanceof Error ? error.message : String(error);
-          console.error(`Invalid arguments: ${message}`);
-          process.exit(1);
+          throw new CLIError(
+            `Invalid arguments: ${message}`,
+            "INVALID_FLAG",
+            "selftune alpha upload --help",
+          );
         }
         if (values.help) {
           console.log(`selftune alpha upload — Run a manual alpha data upload cycle
@@ -619,44 +637,20 @@ Output:
         const identity = readAlphaIdentity(SELFTUNE_CONFIG_PATH);
         if (!identity?.enrolled) {
           const guidance = getAlphaGuidance(identity);
-          console.log(
-            JSON.stringify(
-              {
-                enrolled: false,
-                prepared: 0,
-                sent: 0,
-                failed: 0,
-                skipped: 0,
-                guidance,
-              },
-              null,
-              2,
-            ),
+          throw new CLIError(
+            `[alpha upload] ${guidance.message}`,
+            "OPERATION_FAILED",
+            guidance.next_command,
           );
-          console.error(`[alpha upload] ${guidance.message}`);
-          console.error(`[alpha upload] Next: ${guidance.next_command}`);
-          process.exit(1);
         }
 
         if (!identity.user_id?.trim() || !identity.api_key?.trim()) {
           const guidance = getAlphaGuidance(identity);
-          console.log(
-            JSON.stringify(
-              {
-                enrolled: true,
-                prepared: 0,
-                sent: 0,
-                failed: 0,
-                skipped: 0,
-                guidance,
-              },
-              null,
-              2,
-            ),
+          throw new CLIError(
+            `[alpha upload] ${guidance.message}`,
+            "OPERATION_FAILED",
+            guidance.next_command,
           );
-          console.error(`[alpha upload] ${guidance.message}`);
-          console.error(`[alpha upload] Next: ${guidance.next_command}`);
-          process.exit(1);
         }
 
         const db = getDb();
@@ -742,10 +736,11 @@ Output:
         break;
       }
       default:
-        console.error(
-          `Unknown alpha subcommand: ${sub}\nRun 'selftune alpha --help' for available subcommands.`,
+        throw new CLIError(
+          `Unknown alpha subcommand: ${sub}`,
+          "UNKNOWN_COMMAND",
+          "selftune alpha --help",
         );
-        process.exit(1);
     }
     break;
   }
@@ -767,8 +762,11 @@ Output:
     };
     if (!hookName || !HOOK_MAP[hookName]) {
       const available = Object.keys(HOOK_MAP).join(", ");
-      console.error(`Unknown hook: ${hookName ?? "(none)"}\nAvailable hooks: ${available}`);
-      process.exit(1);
+      throw new CLIError(
+        `Unknown hook: ${hookName ?? "(none)"}. Available: ${available}`,
+        "UNKNOWN_COMMAND",
+        "selftune hook prompt-log",
+      );
     }
     const { resolve, dirname } = await import("node:path");
     const { fileURLToPath } = await import("node:url");
@@ -782,6 +780,5 @@ Output:
     break;
   }
   default:
-    console.error(`Unknown command: ${command}\nRun 'selftune --help' for available commands.`);
-    process.exit(1);
+    throw new CLIError(`Unknown command: ${command}`, "UNKNOWN_COMMAND", "selftune --help");
 }

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

@@ -55,6 +55,7 @@ import type {
   SessionTelemetryRecord,
   TranscriptMetrics,
 } from "../types.js";
+import { CLIError, handleCLIError } from "../utils/cli-error.js";
 import { loadMarker, saveMarker } from "../utils/jsonl.js";
 import { isActionableQueryText } from "../utils/query-filter.js";
 import {
@@ -326,26 +327,36 @@ export function buildCanonicalRecordsFromReplay(session: ParsedSession): Canonic
 
 // --- CLI main ---
 export function cliMain(): void {
-  const { values } = parseArgs({
-    options: {
-      "projects-dir": { type: "string", default: CLAUDE_CODE_PROJECTS_DIR },
-      since: { type: "string" },
-      "dry-run": { type: "boolean", default: false },
-      force: { type: "boolean", default: false },
-      verbose: { type: "boolean", short: "v", default: false },
-    },
-    strict: true,
-  });
+  let values: Record<string, string | boolean | undefined>;
+  try {
+    ({ values } = parseArgs({
+      options: {
+        "projects-dir": { type: "string", default: CLAUDE_CODE_PROJECTS_DIR },
+        since: { type: "string" },
+        "dry-run": { type: "boolean", default: false },
+        force: { type: "boolean", default: false },
+        verbose: { type: "boolean", short: "v", default: false },
+      },
+      strict: true,
+    }));
+  } catch (err) {
+    throw new CLIError(
+      err instanceof Error ? err.message : String(err),
+      "INVALID_FLAG",
+      "selftune ingest claude --since 2026-01-01",
+    );
+  }
 
   const projectsDir = values["projects-dir"] ?? CLAUDE_CODE_PROJECTS_DIR;
   let since: Date | undefined;
   if (values.since) {
     since = new Date(values.since);
     if (Number.isNaN(since.getTime())) {
-      console.error(
-        `Error: Invalid --since date: "${values.since}". Use a valid date format (e.g., 2026-01-01).`,
+      throw new CLIError(
+        `Invalid --since date: "${values.since}"`,
+        "INVALID_FLAG",
+        "selftune ingest claude --since 2026-01-01",
       );
-      process.exit(1);
     }
   }
 
@@ -401,5 +412,9 @@ export function cliMain(): void {
 }
 
 if (import.meta.main) {
-  cliMain();
+  try {
+    cliMain();
+  } catch (err) {
+    handleCLIError(err);
+  }
 }

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

@@ -27,6 +27,11 @@ import { basename, join } from "node:path";
 import { parseArgs } from "node:util";
 
 import { CANONICAL_LOG, QUERY_LOG, SKILL_LOG, TELEMETRY_LOG } from "../constants.js";
+import {
+  writeQueryToDb,
+  writeSessionTelemetryToDb,
+  writeSkillUsageToDb,
+} from "../localdb/direct-write.js";
 import {
   appendCanonicalRecords,
   buildCanonicalExecutionFact,
@@ -44,7 +49,8 @@ import type {
   SessionTelemetryRecord,
   SkillUsageRecord,
 } from "../types.js";
-import { appendJsonl, loadMarker, saveMarker } from "../utils/jsonl.js";
+import { handleCLIError } from "../utils/cli-error.js";
+import { loadMarker, saveMarker } from "../utils/jsonl.js";
 import { extractActionableQueryText } from "../utils/query-filter.js";
 import {
   classifySkillPath,
@@ -490,7 +496,7 @@ export function ingestFile(
       query: prompt,
       source: "codex_rollout",
     };
-    appendJsonl(queryLogPath, queryRecord, "all_queries");
+    writeQueryToDb(queryRecord);
   }
 
   // Write telemetry — explicitly select SessionTelemetryRecord fields
@@ -513,7 +519,7 @@ export function ingestFile(
     output_tokens: parsed.output_tokens,
     rollout_path: parsed.rollout_path,
   };
-  appendJsonl(telemetryLogPath, telemetry, "session_telemetry");
+  writeSessionTelemetryToDb(telemetry);
 
   // Write skill triggers
   for (const skillName of skills) {
@@ -537,7 +543,7 @@ export function ingestFile(
       triggered: true,
       source: isExplicit ? "codex_rollout_explicit" : "codex_rollout",
     };
-    appendJsonl(skillLogPath, skillRecord, "skill_usage");
+    writeSkillUsageToDb(skillRecord);
   }
 
   // --- Canonical normalization records (additive) ---
@@ -712,5 +718,9 @@ export function cliMain(): void {
 }
 
 if (import.meta.main) {
-  cliMain();
+  try {
+    cliMain();
+  } catch (err) {
+    handleCLIError(err);
+  }
 }

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

@@ -11,16 +11,19 @@
  * The wrapper:
  *   1. Runs `codex exec --json <your args>` as a subprocess
  *   2. Streams stdout (JSONL events) to your terminal in real time
- *   3. Parses events and writes to:
- *        ~/.claude/all_queries_log.jsonl
- *        ~/.claude/session_telemetry_log.jsonl
- *        ~/.claude/skill_usage_log.jsonl
+ *   3. Writes to SQLite via writeQueryToDb, writeSessionTelemetryToDb,
+ *      writeSkillUsageToDb (Phase 3: JSONL writes removed)
  */
 
 import { homedir } from "node:os";
 import { join } from "node:path";
 
 import { CANONICAL_LOG, QUERY_LOG, SKILL_LOG, TELEMETRY_LOG } from "../constants.js";
+import {
+  writeQueryToDb,
+  writeSessionTelemetryToDb,
+  writeSkillUsageToDb,
+} from "../localdb/direct-write.js";
 import {
   appendCanonicalRecords,
   buildCanonicalExecutionFact,
@@ -38,7 +41,6 @@ import type {
   SessionTelemetryRecord,
   SkillUsageRecord,
 } from "../types.js";
-import { appendJsonl } from "../utils/jsonl.js";
 import {
   classifySkillPath,
   containsWholeSkillMention,
@@ -240,8 +242,8 @@ export function parseJsonlStream(lines: string[], skillNames: Set<string>): Pars
   };
 }
 
-/** Append the user prompt to all_queries_log.jsonl. */
-export function logQuery(prompt: string, sessionId: string, logPath: string = QUERY_LOG): void {
+/** Write the user prompt to SQLite. */
+export function logQuery(prompt: string, sessionId: string, _logPath: string = QUERY_LOG): void {
   if (!prompt || prompt.length < 4) return;
   const record: QueryLogRecord = {
     timestamp: new Date().toISOString(),
@@ -249,16 +251,16 @@ export function logQuery(prompt: string, sessionId: string, logPath: string = QU
     query: prompt,
     source: "codex",
   };
-  appendJsonl(logPath, record);
+  writeQueryToDb(record);
 }
 
-/** Append session metrics to session_telemetry_log.jsonl. */
+/** Write session metrics to SQLite. */
 export function logTelemetry(
   metrics: Omit<ParsedCodexStream, "thread_id">,
   prompt: string,
   sessionId: string,
   cwd: string,
-  logPath: string = TELEMETRY_LOG,
+  _logPath: string = TELEMETRY_LOG,
 ): void {
   const record: SessionTelemetryRecord = {
     timestamp: new Date().toISOString(),
@@ -269,10 +271,10 @@ export function logTelemetry(
     source: "codex",
     ...metrics,
   };
-  appendJsonl(logPath, record);
+  writeSessionTelemetryToDb(record);
 }
 
-/** Append a skill trigger to skill_usage_log.jsonl. */
+/** Write a skill trigger to SQLite. */
 export function logSkillTrigger(
   skillName: string,
   prompt: string,
@@ -300,7 +302,7 @@ export function logSkillTrigger(
     triggered: true,
     source: "codex",
   };
-  appendJsonl(logPath, record);
+  writeSkillUsageToDb(record);
 }
 
 /** Build canonical records from a wrapper session. */

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

@@ -34,6 +34,11 @@ import {
   SKILL_LOG,
   TELEMETRY_LOG,
 } from "../constants.js";
+import {
+  writeQueryToDb,
+  writeSessionTelemetryToDb,
+  writeSkillUsageToDb,
+} from "../localdb/direct-write.js";
 import {
   appendCanonicalRecords,
   buildCanonicalExecutionFact,
@@ -46,7 +51,7 @@ import {
   deriveSkillInvocationId,
 } from "../normalization.js";
 import type { CanonicalRecord, QueryLogRecord, SkillUsageRecord } from "../types.js";
-import { appendJsonl, loadMarker, saveMarker } from "../utils/jsonl.js";
+import { loadMarker, saveMarker } from "../utils/jsonl.js";
 
 export interface SessionFile {
   agentId: string;
@@ -389,11 +394,25 @@ export function writeSession(
       query: prompt,
       source: session.source,
     };
-    appendJsonl(queryLogPath, queryRecord, "all_queries");
+    writeQueryToDb(queryRecord);
   }
 
-  const { query: _q, ...telemetry } = session;
-  appendJsonl(telemetryLogPath, telemetry, "session_telemetry");
+  // Build a SessionTelemetryRecord-shaped object for SQLite
+  writeSessionTelemetryToDb({
+    timestamp: session.timestamp,
+    session_id: session.session_id,
+    cwd: session.cwd,
+    transcript_path: session.transcript_path,
+    tool_calls: session.tool_calls,
+    total_tool_calls: session.total_tool_calls,
+    bash_commands: session.bash_commands,
+    skills_triggered: session.skills_triggered,
+    assistant_turns: session.assistant_turns,
+    errors_encountered: session.errors_encountered,
+    transcript_chars: session.transcript_chars,
+    last_user_query: session.last_user_query,
+    source: session.source,
+  });
 
   for (const skillName of skills) {
     const skillRecord: SkillUsageRecord = {
@@ -405,7 +424,7 @@ export function writeSession(
       triggered: true,
       source: session.source,
     };
-    appendJsonl(skillLogPath, skillRecord, "skill_usage");
+    writeSkillUsageToDb(skillRecord);
   }
 
   // --- Canonical normalization records (additive) ---

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

@@ -27,6 +27,11 @@ import { basename, join } from "node:path";
 import { parseArgs } from "node:util";
 
 import { CANONICAL_LOG, QUERY_LOG, SKILL_LOG, TELEMETRY_LOG } from "../constants.js";
+import {
+  writeQueryToDb,
+  writeSessionTelemetryToDb,
+  writeSkillUsageToDb,
+} from "../localdb/direct-write.js";
 import {
   appendCanonicalRecords,
   buildCanonicalExecutionFact,
@@ -44,7 +49,7 @@ import type {
   SessionTelemetryRecord,
   SkillUsageRecord,
 } from "../types.js";
-import { appendJsonl, loadMarker, saveMarker } from "../utils/jsonl.js";
+import { loadMarker, saveMarker } from "../utils/jsonl.js";
 
 const XDG_DATA_HOME = process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share");
 const DEFAULT_DATA_DIR = join(XDG_DATA_HOME, "opencode");
@@ -528,7 +533,7 @@ export function writeSession(
       query: prompt,
       source: session.source,
     };
-    appendJsonl(queryLogPath, queryRecord, "all_queries");
+    writeQueryToDb(queryRecord);
   }
 
   const telemetry: SessionTelemetryRecord = {
@@ -546,7 +551,7 @@ export function writeSession(
     last_user_query: session.last_user_query,
     source: session.source,
   };
-  appendJsonl(telemetryLogPath, telemetry, "session_telemetry");
+  writeSessionTelemetryToDb(telemetry);
 
   for (const skillName of skills) {
     const skillRecord: SkillUsageRecord = {
@@ -558,7 +563,7 @@ export function writeSession(
       triggered: true,
       source: session.source,
     };
-    appendJsonl(skillLogPath, skillRecord, "skill_usage");
+    writeSkillUsageToDb(skillRecord);
   }
 
   // --- Canonical normalization records (additive) ---

package/cli/selftune/init.ts

@@ -44,6 +44,7 @@ import {
 import { installAgentFiles } from "./claude-agents.js";
 import { CLAUDE_CODE_HOOK_KEYS, SELFTUNE_CONFIG_DIR, SELFTUNE_CONFIG_PATH } from "./constants.js";
 import type { AgentCommandGuidance, AlphaIdentity, SelftuneConfig } from "./types.js";
+import { CLIError, handleCLIError } from "./utils/cli-error.js";
 import { hookKeyHasSelftuneEntry } from "./utils/hooks.js";
 import { detectAgent } from "./utils/llm-call.js";
 
@@ -692,8 +693,11 @@ export async function cliMain(): Promise<void> {
   try {
     validateAlphaMetadataFlags(values.alpha, values["alpha-email"], values["alpha-name"]);
   } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    throw new CLIError(
+      error instanceof Error ? error.message : String(error),
+      "INVALID_FLAG",
+      "Pass --alpha along with --alpha-email and --alpha-name.",
+    );
   }
 
   // Check for existing config without force
@@ -890,10 +894,11 @@ export async function cliMain(): Promise<void> {
       });
 
       if (!scheduleResult.activated) {
-        console.error(
-          "Failed to activate the autonomous scheduler. Re-run with --schedule-format or use `selftune schedule --install --dry-run` to inspect the generated artifacts first.",
+        throw new CLIError(
+          "Failed to activate the autonomous scheduler.",
+          "OPERATION_FAILED",
+          "Re-run with --schedule-format or use `selftune schedule --install --dry-run` to inspect the generated artifacts first.",
         );
-        process.exit(1);
       }
 
       console.log(
@@ -906,10 +911,11 @@ export async function cliMain(): Promise<void> {
         }),
       );
     } catch (err) {
-      console.error(
+      throw new CLIError(
         `Failed to enable autonomy: ${err instanceof Error ? err.message : String(err)}`,
+        "OPERATION_FAILED",
+        "Re-run with --schedule-format or use `selftune schedule --install --dry-run` to inspect artifacts.",
       );
-      process.exit(1);
     }
   }
 }
@@ -947,7 +953,6 @@ if (isMain) {
       console.error(JSON.stringify(err.payload));
       process.exit(1);
     }
-    console.error(`[FATAL] ${err}`);
-    process.exit(1);
+    handleCLIError(err);
   });
 }