@iowarp/clio-coder 0.4.0 → 0.4.1

package/dist/doctor-QOA5FNY5.js

@@ -1,313 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  MUX_METHOD_MIN_PROTOCOL,
-  describeYaziProfile,
-  detectMux,
-  inspectCurrentYaziProfile,
-  resolveSocketCandidates,
-  userYaziConfigDir,
-  yaziProfileDir
-} from "./chunk-HZHHCK24.js";
-import "./chunk-VO67MWHC.js";
-import {
-  formatDoctorReport,
-  isUninitializedHome,
-  runDoctor,
-  runDoctorFleetChecks,
-  runDoctorInteropChecks,
-  runDoctorModelChecks,
-  runDoctorRuntimeChecks
-} from "./chunk-W5VSYASO.js";
-import "./chunk-BKFM6EJV.js";
-import "./chunk-LCGCVYZ4.js";
-import "./chunk-3DPEIQKN.js";
-import {
-  runEventJournalRoot
-} from "./chunk-IQ7KR472.js";
-import "./chunk-VYMXRQI6.js";
-import "./chunk-FEFIFZTL.js";
-import "./chunk-SUW5DORT.js";
-import {
-  describeResolution,
-  toolStatus,
-  toolStatuses
-} from "./chunk-QSNYB6ZV.js";
-import {
-  findPinnedTool
-} from "./chunk-QDC3K2U3.js";
-import "./chunk-RAPCMZL4.js";
-import "./chunk-K6BSR66V.js";
-import "./chunk-XPLRXC72.js";
-import "./chunk-NEKRRTYW.js";
-import "./chunk-SP2RXXYO.js";
-import "./chunk-2OQE55CK.js";
-import "./chunk-2ANTL7MR.js";
-import {
-  printError
-} from "./chunk-VPKWYKEY.js";
-import "./chunk-5TSRNF4G.js";
-import "./chunk-P3FOHJT4.js";
-import "./chunk-76ONBSIA.js";
-import "./chunk-R346GLFC.js";
-import "./chunk-IHXBNWMM.js";
-import {
-  readSettings
-} from "./chunk-VFA6GDY5.js";
-import "./chunk-BBVJUZHB.js";
-import "./chunk-FQ4SKYE4.js";
-import "./chunk-6EJMN2Y3.js";
-import "./chunk-IWHMRKLL.js";
-import "./chunk-GXNLGKAB.js";
-import "./chunk-LL4KHSZI.js";
-import "./chunk-4ZG3XFUR.js";
-import "./chunk-BBVYXMFO.js";
-import "./chunk-SST6Z5JA.js";
-import "./chunk-IKCO5N3L.js";
-import "./chunk-3I7MS7N2.js";
-import "./chunk-APJ265NV.js";
-import {
-  resolveClioDirs
-} from "./chunk-BYP5D4HI.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-NUGM5KR6.js";
-import "./chunk-YXLYO42X.js";
-import {
-  init_esm_shims
-} from "./chunk-3R73A4XB.js";
-
-// src/cli/doctor.ts
-init_esm_shims();
-
-// src/cli/doctor-panes.ts
-init_esm_shims();
-import { accessSync, constants, mkdirSync } from "node:fs";
-var PANE_HOST_TOOL_ID = "herdr";
-var REQUIRED_PROTOCOL = Math.max(...Object.values(MUX_METHOD_MIN_PROTOCOL));
-function journalWritabilityFinding(root = runEventJournalRoot()) {
-  try {
-    mkdirSync(root, { recursive: true });
-    accessSync(root, constants.W_OK);
-    return { ok: true, name: "panes journal dir", detail: `${root} is writable` };
-  } catch (error) {
-    return {
-      ok: true,
-      level: "warn",
-      name: "panes journal dir",
-      detail: `${root} is not writable (${error instanceof Error ? error.message : String(error)}); \`clio-coder fleet view\` will have no transcript to follow`
-    };
-  }
-}
-async function panesFindings(env = process.env) {
-  let enabled = "off";
-  try {
-    enabled = readSettings().panes.enabled;
-  } catch {
-  }
-  if (enabled === "off") {
-    return [
-      {
-        ok: true,
-        name: "panes mode",
-        detail: "off by choice (panes.enabled=off); start `clio-coder --with-panes` for one session, or set panes.enabled=auto"
-      },
-      journalWritabilityFinding()
-    ];
-  }
-  const { detection, client } = await detectMux({ enabled, env });
-  await client?.close().catch(() => void 0);
-  const candidates = detection.candidates.length > 0 ? detection.candidates : resolveSocketCandidates(env);
-  const findings = [
-    {
-      ok: true,
-      level: detection.mode === "none" ? "warn" : "ok",
-      name: "panes mode",
-      detail: `${detection.mode} (panes.enabled=${enabled}); ${detection.reason}`
-    },
-    {
-      ok: true,
-      level: detection.socketPath === null ? "warn" : "ok",
-      name: "panes socket",
-      detail: detection.socketPath === null ? `no socket answered; tried ${candidates.length > 0 ? candidates.join(", ") : "no candidates"}` : `${detection.socketPath} answered a ping`
-    }
-  ];
-  const server = detection.server;
-  findings.push({
-    ok: true,
-    level: server === null || server.protocol < REQUIRED_PROTOCOL ? "warn" : "ok",
-    name: "panes protocol",
-    detail: server === null ? `unknown; Clio's optional methods need protocol ${REQUIRED_PROTOCOL} or newer` : `server ${server.version}, protocol ${server.protocol}; Clio's optional methods need ${REQUIRED_PROTOCOL} (${server.protocol >= REQUIRED_PROTOCOL ? "satisfied" : "toasts and agent focus fall back"})`
-  });
-  const entry = findPinnedTool(PANE_HOST_TOOL_ID);
-  findings.push(
-    entry === null ? {
-      ok: true,
-      level: "warn",
-      name: "panes binary",
-      detail: `${PANE_HOST_TOOL_ID} is not in the pinned tool registry`
-    } : {
-      ok: true,
-      level: toolStatus(entry).resolution.source === "none" ? "warn" : "ok",
-      name: "panes binary",
-      detail: describeResolution(toolStatus(entry))
-    }
-  );
-  findings.push(journalWritabilityFinding());
-  return findings;
-}
-
-// src/cli/doctor-state-size.ts
-init_esm_shims();
-import { lstatSync, readdirSync } from "node:fs";
-import { join } from "node:path";
-function stateStorageFinding(stateDir = resolveClioDirs().state) {
-  let names;
-  try {
-    names = readdirSync(stateDir);
-  } catch (error) {
-    return {
-      ok: false,
-      name: "state storage",
-      detail: `${stateDir} could not be measured: ${error instanceof Error ? error.message : String(error)}`
-    };
-  }
-  let total = 0;
-  let largest = null;
-  for (const name of names.sort()) {
-    const measured = measureEntry(join(stateDir, name));
-    if (measured.error !== null) {
-      return { ok: false, name: "state storage", detail: measured.error };
-    }
-    total += measured.bytes;
-    if (largest === null || measured.bytes > largest.bytes) largest = { name, bytes: measured.bytes };
-  }
-  return {
-    ok: true,
-    name: "state storage",
-    detail: largest === null ? `${formatBytes(total)} (${total.toLocaleString("en-US")} bytes); largest contributor none` : `${formatBytes(total)} (${total.toLocaleString("en-US")} bytes); largest contributor ${largest.name} at ${formatBytes(largest.bytes)} (${largest.bytes.toLocaleString("en-US")} bytes)`
-  };
-}
-function measureEntry(path) {
-  let stats;
-  try {
-    stats = lstatSync(path);
-  } catch (error) {
-    return {
-      bytes: 0,
-      error: `${path} could not be inspected: ${error instanceof Error ? error.message : String(error)}`
-    };
-  }
-  if (!stats.isDirectory() || stats.isSymbolicLink()) return { bytes: stats.size, error: null };
-  let names;
-  try {
-    names = readdirSync(path);
-  } catch (error) {
-    return { bytes: 0, error: `${path} could not be listed: ${error instanceof Error ? error.message : String(error)}` };
-  }
-  let bytes = 0;
-  for (const name of names) {
-    const child = measureEntry(join(path, name));
-    if (child.error !== null) return child;
-    bytes += child.bytes;
-  }
-  return { bytes, error: null };
-}
-function formatBytes(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  const units = ["KiB", "MiB", "GiB", "TiB"];
-  let value = bytes;
-  let unit = -1;
-  do {
-    value /= 1024;
-    unit += 1;
-  } while (value >= 1024 && unit < units.length - 1);
-  return `${value.toFixed(value >= 10 ? 1 : 2)} ${units[unit]}`;
-}
-
-// src/cli/doctor-toolchain.ts
-init_esm_shims();
-function yaziProfileFinding() {
-  try {
-    const profile = inspectCurrentYaziProfile();
-    return {
-      ok: true,
-      name: "yazi managed profile",
-      detail: describeYaziProfile(profile),
-      level: profile.state === "current" ? "ok" : "warn"
-    };
-  } catch (error) {
-    return {
-      ok: true,
-      name: "yazi managed profile",
-      level: "warn",
-      detail: `${yaziProfileDir()} could not be inspected (${error instanceof Error ? error.message : String(error)}); user config ${userYaziConfigDir()} is separate and untouched`
-    };
-  }
-}
-function toolchainFindings() {
-  const tools = toolStatuses().map((status) => ({
-    ok: true,
-    name: `external tool ${status.id}`,
-    // The rejection and the remedy both live inside the shared resolution
-    // sentence, so this row and `clio-coder tools status` cannot describe the
-    // same machine differently.
-    detail: describeResolution(status),
-    level: status.resolution.source === "none" ? "warn" : "ok"
-  }));
-  return [...tools, yaziProfileFinding()];
-}
-
-// src/cli/doctor.ts
-var HELP = `clio-coder doctor [--fix] [--json]
-
-Diagnose Clio Coder state without creating files. On a home Clio has never
-written to, doctor says so in one row and exits 0. Use --fix to repair structure:
-missing directories, missing template files, and credential permissions.
-Settings are validated directly against the current schema.
-Pass --json to emit a machine-readable report on stdout.
-`;
-async function runDoctorCommand(args = []) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(HELP);
-    return 0;
-  }
-  const fix = args.includes("--fix");
-  const json = args.includes("--json");
-  const unknown = args.find((arg) => arg !== "--fix" && arg !== "--json");
-  if (unknown) {
-    printError(`unknown flag: ${unknown}`);
-    process.stderr.write(HELP);
-    return 2;
-  }
-  const untouched = !fix && isUninitializedHome();
-  const findings = runDoctor({ fix });
-  const storageChecks = untouched ? [] : [stateStorageFinding()];
-  const runtimeChecks = await runDoctorRuntimeChecks();
-  const modelChecks = await runDoctorModelChecks();
-  const interopChecks = untouched ? [] : await runDoctorInteropChecks();
-  const fleetChecks = untouched ? [] : await runDoctorFleetChecks();
-  const toolChecks = untouched ? [] : toolchainFindings();
-  const paneChecks = untouched ? [] : await panesFindings();
-  const all = [
-    ...findings,
-    ...storageChecks,
-    ...runtimeChecks,
-    ...modelChecks,
-    ...interopChecks,
-    ...fleetChecks,
-    ...toolChecks,
-    ...paneChecks
-  ];
-  const ok = all.every((f) => f.ok);
-  if (json) {
-    process.stdout.write(`${JSON.stringify({ ok, fix, findings: all }, null, 2)}
-`);
-  } else {
-    process.stdout.write(`${formatDoctorReport(all)}
-`);
-  }
-  return ok ? 0 : 1;
-}
-export {
-  runDoctorCommand
-};
-//# sourceMappingURL=doctor-QOA5FNY5.js.map

package/src/engine/apis/degraded-inference.ts

@@ -1,95 +0,0 @@
-/**
- * Degraded-inference watchdog for local runtimes.
- *
- * A local server whose weights or KV cache spilled to CPU does not fail: it
- * answers, at roughly a hundredth of the speed, and the operator sees only a
- * spinner. The observed case was 2m18s of streaming for 25 tokens with no
- * indication that anything was wrong. This watchdog turns that silence into a
- * notice: once a prediction has run past a grace period, a sustained token rate
- * below the floor is reported once per turn, along with what is resident on the
- * target so the cause is visible in the same line.
- *
- * The watchdog observes; it never cancels a turn. A slow model is still a
- * working model, and the operator decides whether to abort.
- */
-
-/** Wall-clock a prediction gets before its rate is judged. */
-export const DEGRADED_GRACE_MS = 30_000;
-/** Sustained output tokens per second below which inference is reported as degraded. */
-export const DEGRADED_FLOOR_TOKENS_PER_SECOND = 2;
-
-export interface DegradedInferenceReport {
-	elapsedMs: number;
-	tokens: number;
-	tokensPerSecond: number;
-}
-
-export interface DegradedInferenceOptions {
-	/** Called at most once, when the observed rate stays under the floor past the grace period. */
-	onDegraded: (report: DegradedInferenceReport) => void;
-	graceMs?: number;
-	floorTokensPerSecond?: number;
-	/** Sampling interval; the watchdog checks the rate this often. */
-	pollMs?: number;
-	now?: () => number;
-	setTimer?: (fn: () => void, ms: number) => { cancel: () => void };
-}
-
-export interface DegradedInferenceWatchdog {
-	/** Record generated tokens (output plus reasoning; both are work the server did). */
-	addTokens: (count: number) => void;
-	/** Test seam: evaluate the rate now instead of waiting for the next poll. */
-	check: () => void;
-	stop: () => void;
-}
-
-function defaultTimer(fn: () => void, ms: number): { cancel: () => void } {
-	const handle = setInterval(fn, ms);
-	handle.unref?.();
-	return { cancel: () => clearInterval(handle) };
-}
-
-/**
- * Start watching a prediction's token rate. Call {@link
- * DegradedInferenceWatchdog.addTokens} as fragments arrive and `stop()` when the
- * turn ends, in a `finally`, so a failed turn never leaves a timer behind.
- */
-export function startDegradedInferenceWatchdog(options: DegradedInferenceOptions): DegradedInferenceWatchdog {
-	const now = options.now ?? Date.now;
-	const graceMs = options.graceMs ?? DEGRADED_GRACE_MS;
-	const floor = options.floorTokensPerSecond ?? DEGRADED_FLOOR_TOKENS_PER_SECOND;
-	const pollMs = options.pollMs ?? 5_000;
-	const startedAt = now();
-	let tokens = 0;
-	let reported = false;
-	let stopped = false;
-
-	const check = (): void => {
-		if (reported || stopped) return;
-		const elapsedMs = now() - startedAt;
-		if (elapsedMs < graceMs) return;
-		const tokensPerSecond = tokens / (elapsedMs / 1000);
-		if (tokensPerSecond >= floor) return;
-		reported = true;
-		timer.cancel();
-		try {
-			options.onDegraded({ elapsedMs, tokens, tokensPerSecond });
-		} catch {
-			// A notice sink failure must never escape into the turn it describes.
-		}
-	};
-
-	const timer = (options.setTimer ?? defaultTimer)(check, pollMs);
-
-	return {
-		addTokens: (count) => {
-			if (Number.isFinite(count) && count > 0) tokens += count;
-		},
-		check,
-		stop: () => {
-			if (stopped) return;
-			stopped = true;
-			timer.cancel();
-		},
-	};
-}