selftune 0.2.9 → 0.2.10

package/cli/selftune/evolution/evolve-body.ts

@@ -25,7 +25,8 @@ import type {
   QueryLogRecord,
   SkillUsageRecord,
 } from "../types.js";
-
+import type { EffortLevel, SubagentCallOptions } from "../utils/llm-call.js";
+import { callViaSubagent } from "../utils/llm-call.js";
 import { appendAuditEntry } from "./audit.js";
 import { checkConstitutionSizeOnly } from "./constitutional.js";
 import { parseSkillSections, replaceBody, replaceSection } from "./deploy-proposal.js";
@@ -57,6 +58,9 @@ export interface EvolveBodyOptions {
   fewShotExamples?: string[];
   gradingResults?: GradingResult[];
   validationModel?: string;
+  teacherEffort?: EffortLevel;
+  /** Run evolution-reviewer subagent as Gate 4 before deployment. */
+  useReviewer?: boolean;
 }
 
 export interface EvolveBodyResult {
@@ -89,6 +93,7 @@ export interface EvolveBodyDeps {
   readEffectiveSkillUsageRecords?: () => SkillUsageRecord[];
   readFileSync?: typeof readFileSync;
   writeFileSync?: (path: string, data: string, encoding: string) => void;
+  callViaSubagent?: (options: SubagentCallOptions) => Promise<string>;
 }
 
 // ---------------------------------------------------------------------------
@@ -110,6 +115,19 @@ function createAuditEntry(
   };
 }
 
+// ---------------------------------------------------------------------------
+// Pipeline defaults — enforced even when the calling agent omits flags
+// ---------------------------------------------------------------------------
+
+/** Default teacher model: Opus 4.6 for highest-quality proposals. */
+const DEFAULT_TEACHER_MODEL = "opus";
+
+/** Default student model: Haiku for cheap, fast validation gates. */
+const DEFAULT_STUDENT_MODEL = "haiku";
+
+/** Default teacher effort: extended thinking for multi-constraint reasoning. */
+const DEFAULT_TEACHER_EFFORT: EffortLevel = "high";
+
 // ---------------------------------------------------------------------------
 // Main orchestrator
 // ---------------------------------------------------------------------------
@@ -124,8 +142,6 @@ export async function evolveBody(
     target,
     teacherAgent,
     studentAgent,
-    teacherModel,
-    studentModel,
     evalSetPath,
     dryRun,
     maxIterations,
@@ -133,6 +149,11 @@ export async function evolveBody(
     fewShotExamples,
   } = options;
 
+  // Apply pipeline defaults for models/effort when not explicitly provided
+  const teacherModel = options.teacherModel ?? DEFAULT_TEACHER_MODEL;
+  const studentModel = options.studentModel ?? DEFAULT_STUDENT_MODEL;
+  const teacherEffort = options.teacherEffort ?? DEFAULT_TEACHER_EFFORT;
+
   // Resolve injectable dependencies
   const _extractFailurePatterns = _deps.extractFailurePatterns ?? extractFailurePatterns;
   const _generateBodyProposal = _deps.generateBodyProposal ?? generateBodyProposal;
@@ -151,6 +172,7 @@ export async function evolveBody(
     });
   const _readFileSync = _deps.readFileSync ?? readFileSync;
   const _writeFileSync = _deps.writeFileSync ?? (await import("node:fs")).writeFileSync;
+  const _callViaSubagent = _deps.callViaSubagent ?? callViaSubagent;
 
   const auditEntries: EvolutionAuditEntry[] = [];
 
@@ -306,6 +328,7 @@ export async function evolveBody(
             skillPath,
             teacherAgent,
             teacherModel,
+            teacherEffort,
           );
         } else {
           proposal = await _generateBodyProposal(
@@ -318,6 +341,7 @@ export async function evolveBody(
             teacherModel,
             fewShotExamples,
             executionContext,
+            teacherEffort,
           );
         }
       } else if (lastProposal && lastValidation) {
@@ -327,6 +351,7 @@ export async function evolveBody(
           lastValidation,
           teacherAgent,
           teacherModel,
+          options.teacherEffort,
         );
       } else {
         break;
@@ -496,7 +521,63 @@ export async function evolveBody(
       }
     }
 
-    // Step 5: Deploy or dry-run
+    // Step 5: Optional evolution-reviewer gate (Gate 4)
+    if (options.useReviewer && lastProposal && lastValidation?.improved) {
+      try {
+        const reviewPrompt = [
+          `Review this ${target} evolution proposal for the "${skillName}" skill.`,
+          ``,
+          `Proposal ID: ${lastProposal.proposal_id}`,
+          `Skill path: ${skillPath}`,
+          `Target: ${target}`,
+          `Confidence: ${lastProposal.confidence}`,
+          `Validation: ${lastValidation.gates_passed}/${lastValidation.gates_total} gates passed`,
+          `Regressions: ${lastValidation.regressions.length > 0 ? lastValidation.regressions.join(", ") : "none"}`,
+          ``,
+          `Original content:`,
+          lastProposal.original_body,
+          ``,
+          `Proposed content:`,
+          lastProposal.proposed_body,
+          ``,
+          `Rationale: ${lastProposal.rationale}`,
+        ].join("\n");
+
+        const reviewOutput = await _callViaSubagent({
+          agentName: "evolution-reviewer",
+          prompt: reviewPrompt,
+          maxTurns: 8,
+          allowedTools: ["Read", "Grep", "Glob", "Bash"],
+        });
+
+        const isRejected = /\bREJECT\b/.test(reviewOutput) && !/\bAPPROVE\b/.test(reviewOutput);
+        recordAudit(
+          lastProposal.proposal_id,
+          isRejected ? "rejected" : "validated",
+          `Evolution reviewer: ${isRejected ? "REJECTED" : "APPROVED"}`,
+        );
+
+        if (isRejected) {
+          return {
+            proposal: lastProposal,
+            validation: lastValidation,
+            deployed: false,
+            auditEntries,
+            reason: `Evolution reviewer rejected proposal: ${reviewOutput.slice(0, 500)}`,
+          };
+        }
+      } catch (reviewError) {
+        // Fail-open: if reviewer crashes, log it and continue to deploy
+        const msg = reviewError instanceof Error ? reviewError.message : String(reviewError);
+        recordAudit(
+          lastProposal.proposal_id,
+          "validated",
+          `Evolution reviewer failed (fail-open): ${msg}`,
+        );
+      }
+    }
+
+    // Step 6: Deploy or dry-run
     if (dryRun) {
       return {
         proposal: lastProposal,
@@ -594,6 +675,8 @@ export async function cliMain(): Promise<void> {
       "task-description": { type: "string" },
       "few-shot": { type: "string" },
       "validation-model": { type: "string" },
+      "teacher-effort": { type: "string", default: "high" },
+      review: { type: "boolean", default: false },
       help: { type: "boolean", default: false },
     },
     strict: true,
@@ -611,8 +694,8 @@ Options:
   --target            Evolution target: body, routing (default: body)
   --teacher-agent     Teacher agent CLI (claude, codex, etc.)
   --student-agent     Student agent CLI for validation
-  --teacher-model     Model flag for teacher agent
-  --student-model     Model flag for student agent
+  --teacher-model     Model flag for teacher agent (default: opus)
+  --student-model     Model flag for student agent (default: haiku)
   --eval-set          Path to eval set JSON
   --dry-run           Validate without deploying
   --max-iterations    Max refinement iterations (default: 3)
@@ -620,6 +703,8 @@ Options:
   --task-description  Optional task description context
   --few-shot          Comma-separated paths to example skill files
   --validation-model  Model for trigger-check validation calls (overrides --student-model for validation)
+  --teacher-effort    Effort level for teacher LLM: low, medium, high, max (default: high)
+  --review            Run evolution-reviewer subagent before deployment (Gate 4)
   --help              Show this help message`);
     process.exit(0);
   }
@@ -669,6 +754,8 @@ Options:
     fewShotExamples,
     gradingResults,
     validationModel: values["validation-model"],
+    teacherEffort: (values["teacher-effort"] as EffortLevel) ?? "high",
+    useReviewer: values.review ?? false,
   });
 
   console.log(JSON.stringify(result, null, 2));

package/cli/selftune/evolution/evolve.ts

@@ -37,7 +37,6 @@ import type {
   SkillUsageRecord,
 } from "../types.js";
 import { parseFrontmatter, replaceFrontmatterDescription } from "../utils/frontmatter.js";
-
 import { createEvolveTUI } from "../utils/tui.js";
 import { appendAuditEntry } from "./audit.js";
 import { checkConstitution } from "./constitutional.js";

package/cli/selftune/evolution/propose-body.ts

@@ -7,7 +7,7 @@
  */
 
 import type { BodyEvolutionProposal, EvolutionTarget, FailurePattern } from "../types.js";
-import { callLlm, stripMarkdownFences } from "../utils/llm-call.js";
+import { type EffortLevel, callLlm, stripMarkdownFences } from "../utils/llm-call.js";
 
 // ---------------------------------------------------------------------------
 // System prompt
@@ -160,6 +160,7 @@ export async function generateBodyProposal(
   modelFlag?: string,
   fewShotExamples?: string[],
   executionContext?: ExecutionContext,
+  effort?: EffortLevel,
 ): Promise<BodyEvolutionProposal> {
   const prompt = buildBodyGenerationPrompt(
     currentContent,
@@ -169,7 +170,7 @@ export async function generateBodyProposal(
     fewShotExamples,
     executionContext,
   );
-  const rawResponse = await callLlm(BODY_GENERATOR_SYSTEM, prompt, agent, modelFlag);
+  const rawResponse = await callLlm(BODY_GENERATOR_SYSTEM, prompt, agent, modelFlag, effort);
   const { proposed_body, rationale, confidence } = parseBodyProposalResponse(rawResponse);
 
   return {

package/cli/selftune/evolution/propose-routing.ts

@@ -6,7 +6,7 @@
  */
 
 import type { BodyEvolutionProposal, EvolutionTarget, FailurePattern } from "../types.js";
-import { callLlm, stripMarkdownFences } from "../utils/llm-call.js";
+import { type EffortLevel, callLlm, stripMarkdownFences } from "../utils/llm-call.js";
 
 // ---------------------------------------------------------------------------
 // System prompt
@@ -139,6 +139,7 @@ export async function generateRoutingProposal(
   skillPath: string,
   agent: string,
   modelFlag?: string,
+  effort?: EffortLevel,
 ): Promise<BodyEvolutionProposal> {
   const prompt = buildRoutingProposalPrompt(
     currentRouting,
@@ -147,7 +148,7 @@ export async function generateRoutingProposal(
     missedQueries,
     skillName,
   );
-  const rawResponse = await callLlm(ROUTING_PROPOSER_SYSTEM, prompt, agent, modelFlag);
+  const rawResponse = await callLlm(ROUTING_PROPOSER_SYSTEM, prompt, agent, modelFlag, effort);
   const { proposed_routing, rationale, confidence } = parseRoutingProposalResponse(rawResponse);
 
   return {

package/cli/selftune/evolution/refine-body.ts

@@ -6,7 +6,7 @@
  */
 
 import type { BodyEvolutionProposal, BodyValidationResult } from "../types.js";
-import { callLlm, stripMarkdownFences } from "../utils/llm-call.js";
+import { type EffortLevel, callLlm, stripMarkdownFences } from "../utils/llm-call.js";
 
 // ---------------------------------------------------------------------------
 // System prompt
@@ -118,6 +118,7 @@ export async function refineBodyProposal(
   validationResult: BodyValidationResult,
   agent: string,
   modelFlag?: string,
+  effort?: EffortLevel,
 ): Promise<BodyEvolutionProposal> {
   const prompt = buildRefinementPrompt(
     proposal.proposed_body,
@@ -126,7 +127,7 @@ export async function refineBodyProposal(
     validationResult.regressions,
   );
 
-  const rawResponse = await callLlm(BODY_REFINER_SYSTEM, prompt, agent, modelFlag);
+  const rawResponse = await callLlm(BODY_REFINER_SYSTEM, prompt, agent, modelFlag, effort);
   const { refined_body, changes_made, confidence } = parseRefinementResponse(rawResponse);
 
   return {

package/cli/selftune/export.ts

@@ -5,6 +5,7 @@
  */
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+
 import { getDb } from "./localdb/db.js";
 import {
   getOrchestrateRuns,

package/cli/selftune/grading/grade-session.ts

@@ -884,6 +884,14 @@ Options:
   }
   writeFileSync(outputPath, JSON.stringify(result, null, 2), "utf-8");
 
+  // Persist to SQLite for upload staging (fail-open)
+  try {
+    const { writeGradingResultToDb } = await import("../localdb/direct-write.js");
+    writeGradingResultToDb(result);
+  } catch {
+    // fail-open: grading file is already written above
+  }
+
   printSummary(result);
   console.log(`\nWrote ${outputPath}`);
 }

package/cli/selftune/hooks/auto-activate.ts

@@ -11,6 +11,7 @@
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+
 import {
   CLAUDE_SETTINGS_PATH,
   EVOLUTION_AUDIT_LOG,

package/cli/selftune/hooks/evolution-guard.ts

@@ -16,8 +16,8 @@
 
 import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
-import { EVOLUTION_AUDIT_LOG, SELFTUNE_CONFIG_DIR } from "../constants.js";
 
+import { EVOLUTION_AUDIT_LOG, SELFTUNE_CONFIG_DIR } from "../constants.js";
 import type { PreToolUsePayload } from "../types.js";
 import { readJsonl } from "../utils/jsonl.js";
 

package/cli/selftune/hooks/prompt-log.ts

@@ -11,6 +11,7 @@
 import { readdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
+
 import { CANONICAL_LOG, QUERY_LOG, SKIP_PREFIXES } from "../constants.js";
 import {
   appendCanonicalRecord,

package/cli/selftune/hooks/session-stop.ts

@@ -9,9 +9,9 @@
  */
 
 import { execSync } from "node:child_process";
-import { closeSync, openSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { CANONICAL_LOG, ORCHESTRATE_LOCK, TELEMETRY_LOG } from "../constants.js";
+import { readFileSync } from "node:fs";
 
+import { CANONICAL_LOG, ORCHESTRATE_LOCK, TELEMETRY_LOG } from "../constants.js";
 import {
   appendCanonicalRecords,
   buildCanonicalExecutionFact,
@@ -25,6 +25,22 @@ import { parseTranscript } from "../utils/transcript.js";
 
 const LOCK_STALE_MS = 30 * 60 * 1000;
 
+interface ReactiveSpawnDeps {
+  spawnOrchestrate?: () => boolean;
+}
+
+function hasFreshOrchestrateLock(lockPath: string): boolean {
+  try {
+    const lockContent = readFileSync(lockPath, "utf8");
+    const lock = JSON.parse(lockContent) as { timestamp?: string };
+    if (typeof lock.timestamp !== "string") return false;
+    const lockAge = Date.now() - new Date(lock.timestamp).getTime();
+    return Number.isFinite(lockAge) && lockAge < LOCK_STALE_MS;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Check for pending improvement signals and spawn a focused orchestrate run
  * in the background if warranted. Fire-and-forget — the hook exits immediately.
@@ -33,6 +49,7 @@ const LOCK_STALE_MS = 30 * 60 * 1000;
  */
 export async function maybeSpawnReactiveOrchestrate(
   lockPath: string = ORCHESTRATE_LOCK,
+  deps: ReactiveSpawnDeps = {},
 ): Promise<boolean> {
   try {
     // Read pending signals from SQLite (dynamic import to reduce hook startup cost)
@@ -42,48 +59,25 @@ export async function maybeSpawnReactiveOrchestrate(
     const pending = queryImprovementSignals(db, false);
     if (pending.length === 0) return false;
 
-    // Atomically claim the lock — openSync with "wx" fails if file exists
-    let fd: number;
-    try {
-      fd = openSync(lockPath, "wx");
-      writeFileSync(fd, JSON.stringify({ timestamp: new Date().toISOString(), pid: process.pid }));
-      closeSync(fd);
-    } catch (lockErr: unknown) {
-      // Lock exists — check if stale
-      if ((lockErr as NodeJS.ErrnoException).code === "EEXIST") {
-        try {
-          const lockContent = readFileSync(lockPath, "utf8");
-          const lock = JSON.parse(lockContent);
-          const lockAge = Date.now() - new Date(lock.timestamp).getTime();
-          if (lockAge < LOCK_STALE_MS) return false; // Active lock, skip
-          // Stale lock — override
-          writeFileSync(
-            lockPath,
-            JSON.stringify({ timestamp: new Date().toISOString(), pid: process.pid }),
-          );
-        } catch {
-          return false; // Can't read lock, skip
-        }
-      } else {
-        return false;
-      }
-    }
+    // Do not pre-claim the orchestrate lock here. The spawned process must
+    // acquire its own lock or it will immediately self-block on startup.
+    if (hasFreshOrchestrateLock(lockPath)) return false;
 
     // Spawn orchestrate in background (fire-and-forget)
     try {
-      const proc = Bun.spawn(["selftune", "orchestrate", "--max-skills", "2"], {
-        stdout: "ignore",
-        stderr: "ignore",
-        stdin: "ignore",
-      });
-      proc.unref();
+      const spawnOrchestrate =
+        deps.spawnOrchestrate ??
+        (() => {
+          const proc = Bun.spawn(["selftune", "orchestrate", "--max-skills", "2"], {
+            stdout: "ignore",
+            stderr: "ignore",
+            stdin: "ignore",
+          });
+          proc.unref();
+          return true;
+        });
+      if (!spawnOrchestrate()) return false;
     } catch {
-      // Spawn failed — release our lock
-      try {
-        unlinkSync(lockPath);
-      } catch {
-        /* ignore */
-      }
       return false;
     }
 

package/cli/selftune/hooks/skill-change-guard.ts

@@ -12,6 +12,7 @@
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname } from "node:path";
+
 import { SESSION_STATE_DIR } from "../constants.js";
 import type { PreToolUsePayload } from "../types.js";
 

package/cli/selftune/hooks/skill-eval.ts

@@ -13,6 +13,7 @@
 
 import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname } from "node:path";
+
 import { CANONICAL_LOG, SKILL_LOG } from "../constants.js";
 import {
   appendCanonicalRecord,
@@ -24,7 +25,6 @@ import {
   getLatestPromptIdentity,
 } from "../normalization.js";
 import type { PostToolUsePayload, SkillUsageRecord } from "../types.js";
-
 import { classifySkillPath } from "../utils/skill-discovery.js";
 import { getLastUserMessage } from "../utils/transcript.js";
 

package/cli/selftune/index.ts

@@ -10,6 +10,7 @@
  *   selftune sync               — Sync source-truth telemetry across supported agents
  *   selftune orchestrate        — Run autonomous core loop (sync → status → evolve → watch)
  *   selftune init               — Initialize agent identity and config
+ *   selftune uninstall          — Clean removal of all selftune data and config
  *   selftune status             — Show skill health summary
  *   selftune watch              — Monitor post-deploy skill health
  *   selftune doctor             — Run health checks
@@ -44,6 +45,7 @@ Commands:
   sync               Sync source-truth telemetry across supported agents
   orchestrate        Run autonomous core loop (sync → status → evolve → watch)
   init               Initialize agent identity and config
+  uninstall          Clean removal of all selftune data and config
   status             Show skill health summary
   watch              Monitor post-deploy skill health
   doctor             Run health checks
@@ -338,6 +340,11 @@ Run 'selftune eval <action> --help' for action-specific options.`);
     await cliMain();
     break;
   }
+  case "uninstall": {
+    const { cliMain } = await import("./uninstall.js");
+    await cliMain();
+    break;
+  }
   case "contribute": {
     const { cliMain } = await import("./contribute/contribute.js");
     await cliMain();
@@ -464,7 +471,7 @@ Run 'selftune cron <subcommand> --help' for subcommand-specific options.`);
   }
   case "sync": {
     const { cliMain } = await import("./sync.js");
-    cliMain();
+    await cliMain();
     break;
   }
   case "workflows": {
@@ -606,9 +613,8 @@ Output:
         const { readAlphaIdentity } = await import("./alpha-identity.js");
         const { getDb } = await import("./localdb/db.js");
         const { runUploadCycle } = await import("./alpha-upload/index.js");
-        const { getSelftuneVersion, readConfiguredAgentType } = await import(
-          "./utils/selftune-meta.js"
-        );
+        const { getSelftuneVersion, readConfiguredAgentType } =
+          await import("./utils/selftune-meta.js");
 
         const identity = readAlphaIdentity(SELFTUNE_CONFIG_PATH);
         if (!identity?.enrolled) {
@@ -670,36 +676,39 @@ Output:
       }
       case "relink": {
         const { SELFTUNE_CONFIG_PATH } = await import("./constants.js");
-        const { readAlphaIdentity, writeAlphaIdentity, generateUserId } = await import(
-          "./alpha-identity.js"
-        );
-        const { requestDeviceCode, pollDeviceCode } = await import("./auth/device-code.js");
+        const { readAlphaIdentity, writeAlphaIdentity, generateUserId } =
+          await import("./alpha-identity.js");
+        const { buildVerificationUrl, pollDeviceCode, requestDeviceCode, tryOpenUrl } =
+          await import("./auth/device-code.js");
         const { chmodSync } = await import("node:fs");
 
         const existingIdentity = readAlphaIdentity(SELFTUNE_CONFIG_PATH);
         process.stderr.write("[alpha relink] Starting device-code authentication flow...\n");
 
         const grant = await requestDeviceCode();
+        const verificationUrlWithCode = buildVerificationUrl(
+          grant.verification_url,
+          grant.user_code,
+        );
 
         console.log(
           JSON.stringify({
             level: "info",
             code: "device_code_issued",
             verification_url: grant.verification_url,
+            verification_url_with_code: verificationUrlWithCode,
             user_code: grant.user_code,
             expires_in: grant.expires_in,
-            message: `Open ${grant.verification_url} and enter code: ${grant.user_code}`,
+            message: `Open ${verificationUrlWithCode} to approve.`,
           }),
         );
 
         // Try to open browser
-        try {
-          const url = `${grant.verification_url}?code=${grant.user_code}`;
-          Bun.spawn(["open", url], { stdout: "ignore", stderr: "ignore" });
+        if (tryOpenUrl(verificationUrlWithCode)) {
           process.stderr.write("[alpha relink] Browser opened. Waiting for approval...\n");
-        } catch {
+        } else {
           process.stderr.write(
-            "[alpha relink] Could not open browser. Visit the URL above manually.\n",
+            `[alpha relink] Could not open browser. Visit ${verificationUrlWithCode} manually.\n`,
           );
         }
 

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

@@ -24,6 +24,7 @@
 import { statSync } from "node:fs";
 import { basename } from "node:path";
 import { parseArgs } from "node:util";
+
 import {
   CANONICAL_LOG,
   CLAUDE_CODE_MARKER,

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

@@ -25,6 +25,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, join } from "node:path";
 import { parseArgs } from "node:util";
+
 import { CANONICAL_LOG, QUERY_LOG, SKILL_LOG, TELEMETRY_LOG } from "../constants.js";
 import {
   appendCanonicalRecords,

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

@@ -19,6 +19,7 @@
 
 import { homedir } from "node:os";
 import { join } from "node:path";
+
 import { CANONICAL_LOG, QUERY_LOG, SKILL_LOG, TELEMETRY_LOG } from "../constants.js";
 import {
   appendCanonicalRecords,

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

@@ -25,6 +25,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, join } from "node:path";
 import { parseArgs } from "node:util";
+
 import {
   CANONICAL_LOG,
   OPENCLAW_AGENTS_DIR,

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

@@ -25,6 +25,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, join } from "node:path";
 import { parseArgs } from "node:util";
+
 import { CANONICAL_LOG, QUERY_LOG, SKILL_LOG, TELEMETRY_LOG } from "../constants.js";
 import {
   appendCanonicalRecords,