@rainy-updates/cli 0.5.6 → 0.6.0

package/dist/output/github.js

@@ -34,6 +34,16 @@ export async function writeGitHubOutput(filePath, result) {
         `cache_backend=${result.summary.cacheBackend ?? ""}`,
         `degraded_sources=${(result.summary.degradedSources ?? []).join(",")}`,
         `ga_ready=${result.summary.gaReady === true ? "1" : "0"}`,
+        `dependency_health_score=${result.summary.dependencyHealthScore ?? ""}`,
+        `primary_finding_code=${result.summary.primaryFindingCode ?? ""}`,
+        `primary_finding_category=${result.summary.primaryFindingCategory ?? ""}`,
+        `next_action_reason=${result.summary.nextActionReason ?? ""}`,
+        `suggested_command=${result.summary.suggestedCommand ?? ""}`,
+        `decision_plan=${result.summary.decisionPlan ?? ""}`,
+        `interactive_surface=${result.summary.interactiveSurface ?? ""}`,
+        `queue_focus=${result.summary.queueFocus ?? ""}`,
+        `verification_state=${result.summary.verificationState ?? "not-run"}`,
+        `verification_failures=${result.summary.verificationFailures ?? 0}`,
         `fix_pr_applied=${result.summary.fixPrApplied === true ? "1" : "0"}`,
         `fix_pr_branches_created=${result.summary.fixPrBranchesCreated}`,
         `fix_pr_branch=${result.summary.fixBranchName ?? ""}`,

package/dist/output/sarif.js

@@ -1,6 +1,4 @@
 import { readFileSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
 export function createSarifReport(result) {
     const dependencyRuleId = "rainy-updates/dependency-update";
     const runtimeRuleId = "rainy-updates/runtime-error";
@@ -46,7 +44,9 @@ export function createSarifReport(result) {
             runId: result.summary.runId,
         },
     }));
-    const errorResults = [...result.errors].sort((a, b) => a.localeCompare(b)).map((error) => ({
+    const errorResults = [...result.errors]
+        .sort((a, b) => a.localeCompare(b))
+        .map((error) => ({
         ruleId: runtimeRuleId,
         level: "error",
         message: {
@@ -66,12 +66,16 @@ export function createSarifReport(result) {
                             {
                                 id: dependencyRuleId,
                                 shortDescription: { text: "Dependency update available" },
-                                fullDescription: { text: "A dependency has a newer version according to configured target." },
+                                fullDescription: {
+                                    text: "A dependency has a newer version according to configured target.",
+                                },
                             },
                             {
                                 id: runtimeRuleId,
                                 shortDescription: { text: "Dependency resolution error" },
-                                fullDescription: { text: "The resolver could not fetch or parse package metadata." },
+                                fullDescription: {
+                                    text: "The resolver could not fetch or parse package metadata.",
+                                },
                             },
                         ],
                     },
@@ -101,6 +105,10 @@ export function createSarifReport(result) {
                     monitorPackages: result.summary.monitorPackages ?? 0,
                     degradedSources: result.summary.degradedSources ?? [],
                     cacheBackend: result.summary.cacheBackend,
+                    dependencyHealthScore: result.summary.dependencyHealthScore,
+                    primaryFindingCode: result.summary.primaryFindingCode,
+                    primaryFindingCategory: result.summary.primaryFindingCategory,
+                    nextActionReason: result.summary.nextActionReason,
                 },
             },
         ],
@@ -111,15 +119,11 @@ function getToolVersion() {
     if (TOOL_VERSION_CACHE)
         return TOOL_VERSION_CACHE;
     try {
-        const currentFile = fileURLToPath(import.meta.url);
-        const packageJsonPath = path.resolve(path.dirname(currentFile), "../../package.json");
-        const content = readFileSync(packageJsonPath, "utf8");
-        const parsed = JSON.parse(content);
-        TOOL_VERSION_CACHE = parsed.version ?? "0.0.0";
-        return TOOL_VERSION_CACHE;
+        const packageJson = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
+        TOOL_VERSION_CACHE = packageJson.version ?? "0.0.0";
     }
     catch {
         TOOL_VERSION_CACHE = "0.0.0";
-        return TOOL_VERSION_CACHE;
     }
+    return TOOL_VERSION_CACHE;
 }

package/dist/parsers/package-json.js

@@ -1,4 +1,3 @@
-import { promises as fs } from "node:fs";
 import path from "node:path";
 const DEPENDENCY_KINDS = [
     "dependencies",
@@ -11,13 +10,12 @@ export function getPackageJsonPath(cwd) {
 }
 export async function readManifest(cwd) {
     const filePath = getPackageJsonPath(cwd);
-    const content = await fs.readFile(filePath, "utf8");
-    return JSON.parse(content);
+    return (await Bun.file(filePath).json());
 }
 export async function writeManifest(cwd, manifest) {
     const filePath = getPackageJsonPath(cwd);
     const content = JSON.stringify(manifest, null, 2) + "\n";
-    await fs.writeFile(filePath, content, "utf8");
+    await Bun.write(filePath, content);
 }
 export function collectDependencies(manifest, includeKinds) {
     const deps = [];

package/dist/pm/detect.d.ts

@@ -1 +1,3 @@
-export declare function detectPackageManager(cwd: string): Promise<"npm" | "pnpm" | "unknown">;
+import type { DetectedPackageManager, SelectedPackageManager, SupportedPackageManager } from "../types/index.js";
+export declare function detectPackageManager(cwd: string): Promise<DetectedPackageManager>;
+export declare function resolvePackageManager(requested: SelectedPackageManager, detected: DetectedPackageManager, fallback?: SupportedPackageManager): SupportedPackageManager;

package/dist/pm/detect.js

@@ -1,20 +1,32 @@
-import { access } from "node:fs/promises";
 import path from "node:path";
+const PACKAGE_MANAGER_LOCKFILES = [
+    ["bun.lock", "bun"],
+    ["bun.lockb", "bun"],
+    ["pnpm-lock.yaml", "pnpm"],
+    ["package-lock.json", "npm"],
+    ["npm-shrinkwrap.json", "npm"],
+    ["yarn.lock", "yarn"],
+];
 export async function detectPackageManager(cwd) {
-    const pnpmLock = path.join(cwd, "pnpm-lock.yaml");
-    const npmLock = path.join(cwd, "package-lock.json");
-    try {
-        await access(pnpmLock);
-        return "pnpm";
-    }
-    catch {
-        // noop
+    for (const [lockfile, packageManager] of PACKAGE_MANAGER_LOCKFILES) {
+        if (await fileExists(path.join(cwd, lockfile))) {
+            return packageManager;
+        }
     }
+    return "unknown";
+}
+export function resolvePackageManager(requested, detected, fallback = "npm") {
+    if (requested !== "auto")
+        return requested;
+    if (detected !== "unknown")
+        return detected;
+    return fallback;
+}
+async function fileExists(filePath) {
     try {
-        await access(npmLock);
-        return "npm";
+        return await Bun.file(filePath).exists();
     }
     catch {
-        return "unknown";
+        return false;
     }
 }

package/dist/pm/install.d.ts

@@ -1 +1,2 @@
-export declare function installDependencies(cwd: string, packageManager: "auto" | "npm" | "pnpm", detected: "npm" | "pnpm" | "unknown"): Promise<void>;
+import type { DetectedPackageManager, SelectedPackageManager } from "../types/index.js";
+export declare function installDependencies(cwd: string, packageManager: SelectedPackageManager, detected: DetectedPackageManager): Promise<void>;

package/dist/pm/install.js

@@ -1,21 +1,20 @@
-import { spawn } from "node:child_process";
+import { resolvePackageManager } from "./detect.js";
 export async function installDependencies(cwd, packageManager, detected) {
-    const selected = packageManager === "auto" ? (detected === "unknown" ? "npm" : detected) : packageManager;
-    const command = selected;
+    const command = resolvePackageManager(packageManager, detected);
     const args = ["install"];
-    await new Promise((resolve, reject) => {
-        const child = spawn(command, args, {
+    try {
+        const proc = Bun.spawn([command, ...args], {
             cwd,
-            stdio: "inherit",
-            shell: process.platform === "win32",
+            stdin: "inherit",
+            stdout: "inherit",
+            stderr: "inherit",
         });
-        child.on("exit", (code) => {
-            if (code === 0) {
-                resolve();
-                return;
-            }
-            reject(new Error(`${command} ${args.join(" ")} failed with exit code ${code ?? "unknown"}`));
-        });
-        child.on("error", reject);
-    });
+        const code = await proc.exited;
+        if (code !== 0) {
+            throw new Error(`${command} ${args.join(" ")} failed with exit code ${code}`);
+        }
+    }
+    catch (err) {
+        throw err instanceof Error ? err : new Error(String(err));
+    }
 }

package/dist/registry/npm.js

@@ -1,8 +1,7 @@
-import { promises as fs } from "node:fs";
-import os from "node:os";
 import path from "node:path";
-import process from "node:process";
 import { asyncPool } from "../utils/async-pool.js";
+import { getHomeDir } from "../utils/runtime-paths.js";
+import { getRuntimeCwd, readEnv } from "../utils/runtime.js";
 const DEFAULT_TIMEOUT_MS = 8000;
 const USER_AGENT = "@rainy-updates/cli";
 const DEFAULT_REGISTRY = "https://registry.npmjs.org/";
@@ -52,7 +51,9 @@ export class NpmRegistryClient {
             catch (error) {
                 lastError = String(error);
                 if (attempt < retries) {
-                    const backoffMs = error instanceof RetryableRegistryError ? error.waitMs : computeBackoffMs(attempt);
+                    const backoffMs = error instanceof RetryableRegistryError
+                        ? error.waitMs
+                        : computeBackoffMs(attempt);
                     await sleep(backoffMs);
                 }
             }
@@ -136,10 +137,7 @@ class RetryableRegistryError extends Error {
     }
 }
 async function createRequester(cwd) {
-    const registryConfig = await loadRegistryConfig(cwd ?? process.cwd());
-    const undiciRequester = await tryCreateUndiciRequester(registryConfig);
-    if (undiciRequester)
-        return undiciRequester;
+    const registryConfig = await loadRegistryConfig(cwd ?? getRuntimeCwd());
     return async (packageName, timeoutMs) => {
         const controller = new AbortController();
         const timeout = setTimeout(() => controller.abort(), timeoutMs);
@@ -158,7 +156,9 @@ async function createRequester(cwd) {
                 headers,
                 signal: controller.signal,
             });
-            const data = (await response.json().catch(() => null));
+            const data = (await response
+                .json()
+                .catch(() => null));
             return {
                 status: response.status,
                 data,
@@ -170,74 +170,17 @@ async function createRequester(cwd) {
         }
     };
 }
-async function tryCreateUndiciRequester(registryConfig) {
-    try {
-        const dynamicImport = Function("specifier", "return import(specifier)");
-        const undici = await dynamicImport("undici");
-        return async (packageName, timeoutMs) => {
-            const controller = new AbortController();
-            const timeout = setTimeout(() => controller.abort(), timeoutMs);
-            const registry = resolveRegistryForPackage(packageName, registryConfig);
-            const url = buildRegistryUrl(registry, packageName);
-            const authHeader = resolveAuthHeader(registry, registryConfig);
-            const headers = {
-                accept: "application/json",
-                "user-agent": USER_AGENT,
-            };
-            if (authHeader) {
-                headers.authorization = authHeader;
-            }
-            try {
-                const res = await undici.request(url, {
-                    method: "GET",
-                    headers,
-                    signal: controller.signal,
-                });
-                const bodyText = await res.body.text();
-                let data = null;
-                try {
-                    data = JSON.parse(bodyText);
-                }
-                catch {
-                    data = null;
-                }
-                const retryAfter = (() => {
-                    const header = res.headers["retry-after"];
-                    if (Array.isArray(header))
-                        return header[0] ?? null;
-                    if (typeof header === "string")
-                        return header;
-                    return null;
-                })();
-                return {
-                    status: res.statusCode,
-                    data,
-                    retryAfterMs: parseRetryAfterHeader(retryAfter),
-                };
-            }
-            finally {
-                clearTimeout(timeout);
-            }
-        };
-    }
-    catch {
-        return null;
-    }
-}
 export async function loadRegistryConfig(cwd) {
-    const homeNpmrc = path.join(os.homedir(), ".npmrc");
+    const homeNpmrc = path.join(getHomeDir(), ".npmrc");
     const projectNpmrc = path.join(cwd, ".npmrc");
     const merged = new Map();
     for (const filePath of [homeNpmrc, projectNpmrc]) {
-        try {
-            const content = await fs.readFile(filePath, "utf8");
-            const parsed = parseNpmrc(content);
-            for (const [key, value] of parsed) {
-                merged.set(key, value);
-            }
-        }
-        catch {
-            // ignore missing/unreadable file
+        const content = await readOptionalTextFile(filePath);
+        if (!content)
+            continue;
+        const parsed = parseNpmrc(content);
+        for (const [key, value] of parsed) {
+            merged.set(key, value);
         }
     }
     const defaultRegistry = normalizeRegistryUrl(merged.get("registry") ?? DEFAULT_REGISTRY);
@@ -272,18 +215,33 @@ export async function loadRegistryConfig(cwd) {
         authByRegistry.set(registry, current);
     }
     if (merged.get("always-auth") === "true") {
-        const current = authByRegistry.get(defaultRegistry) ?? { alwaysAuth: false };
+        const current = authByRegistry.get(defaultRegistry) ?? {
+            alwaysAuth: false,
+        };
         current.alwaysAuth = true;
         authByRegistry.set(defaultRegistry, current);
     }
     return { defaultRegistry, scopedRegistries, authByRegistry };
 }
+async function readOptionalTextFile(filePath) {
+    try {
+        const file = Bun.file(filePath);
+        if (!(await file.exists()))
+            return null;
+        return await file.text();
+    }
+    catch {
+        return null;
+    }
+}
 function parseNpmrc(content) {
     const values = new Map();
     const lines = content.split(/\r?\n/);
     for (const line of lines) {
         const trimmed = line.trim();
-        if (trimmed.length === 0 || trimmed.startsWith("#") || trimmed.startsWith(";"))
+        if (trimmed.length === 0 ||
+            trimmed.startsWith("#") ||
+            trimmed.startsWith(";"))
             continue;
         const separator = trimmed.indexOf("=");
         if (separator <= 0)
@@ -297,7 +255,7 @@ function parseNpmrc(content) {
     return values;
 }
 function substituteEnvValue(value) {
-    return value.replace(/\$\{([^}]+)\}/g, (_match, name) => process.env[name] ?? "");
+    return value.replace(/\$\{([^}]+)\}/g, (_match, name) => readEnv(name) ?? "");
 }
 function normalizeRegistryUrl(value) {
     const normalized = value.endsWith("/") ? value : `${value}/`;

package/dist/types/index.d.ts

@@ -1,10 +1,22 @@
 export type DependencyKind = "dependencies" | "devDependencies" | "optionalDependencies" | "peerDependencies";
+export type SupportedPackageManager = "bun" | "npm" | "pnpm" | "yarn";
+export type DetectedPackageManager = SupportedPackageManager | "unknown";
+export type SelectedPackageManager = "auto" | SupportedPackageManager;
 export type TargetLevel = "patch" | "minor" | "major" | "latest";
 export type GroupBy = "none" | "name" | "scope" | "kind" | "risk";
 export type CiProfile = "minimal" | "strict" | "enterprise";
 export type LockfileMode = "preserve" | "update" | "error";
 export type Verdict = "safe" | "review" | "blocked" | "actionable";
 export type RiskLevel = "critical" | "high" | "medium" | "low";
+export type DashboardMode = "check" | "review" | "upgrade";
+export type QueueFocus = "all" | "security" | "risk" | "major" | "blocked" | "workspace";
+export type InteractiveSurface = "dashboard";
+export type VerificationState = "not-run" | "passed" | "failed";
+export type VerificationMode = "none" | "install" | "test" | "install,test";
+export type CiGate = "check" | "doctor" | "review" | "upgrade";
+export type DoctorFindingSeverity = "error" | "warning";
+export type DoctorScoreLabel = "Strong" | "Needs Review" | "Action Needed" | "Blocked / Critical";
+export type DoctorFindingCategory = "Security" | "Compatibility" | "Policy" | "Operational Health" | "Licensing" | "Unused / Cleanup" | "Release Risk" | "Registry / Execution" | "Workspace Integrity";
 export type RiskCategory = "known-vulnerability" | "behavioral-risk" | "operational-health";
 export type MaintainerChurnStatus = "unknown" | "stable" | "elevated-change";
 export type PolicyAction = "allow" | "review" | "block" | "monitor";
@@ -53,13 +65,19 @@ export interface RunOptions {
     interactive: boolean;
     showImpact: boolean;
     showHomepage: boolean;
+    decisionPlanFile?: string;
+    verify: VerificationMode;
+    testCommand?: string;
+    verificationReportFile?: string;
+    ciGate: CiGate;
 }
 export interface CheckOptions extends RunOptions {
 }
 export interface UpgradeOptions extends RunOptions {
     install: boolean;
-    packageManager: "auto" | "npm" | "pnpm";
+    packageManager: SelectedPackageManager;
     sync: boolean;
+    fromPlanFile?: string;
 }
 export interface BaselineOptions {
     cwd: string;
@@ -143,8 +161,51 @@ export interface ArtifactManifest {
         githubOutputFile?: string;
         sarifFile?: string;
         prReportFile?: string;
+        verificationReportFile?: string;
     };
 }
+export interface VerificationCheck {
+    name: "install" | "test";
+    command: string;
+    passed: boolean;
+    exitCode: number;
+    durationMs: number;
+    error?: string;
+}
+export interface VerificationResult {
+    mode: VerificationMode;
+    passed: boolean;
+    checks: VerificationCheck[];
+}
+export interface DecisionPlanItem {
+    packagePath: string;
+    name: string;
+    kind: DependencyKind;
+    fromRange: string;
+    toRange: string;
+    toVersionResolved: string;
+    diffType: TargetLevel;
+    riskLevel?: RiskLevel;
+    riskScore?: number;
+    policyAction?: PolicyAction;
+    decisionState?: DecisionState;
+    selected: boolean;
+}
+export interface DecisionPlan {
+    contractVersion: "1";
+    createdAt: string;
+    sourceCommand: string;
+    mode: DashboardMode;
+    focus: QueueFocus;
+    projectPath: string;
+    target: TargetLevel;
+    interactiveSurface: InteractiveSurface;
+    summary: {
+        totalItems: number;
+        selectedItems: number;
+    };
+    items: DecisionPlanItem[];
+}
 export interface Summary {
     contractVersion: "2";
     scannedPackages: number;
@@ -204,11 +265,23 @@ export interface Summary {
     cacheBackend?: "sqlite" | "file";
     binaryRecommended?: boolean;
     gaReady?: boolean;
+    dependencyHealthScore?: number;
+    findingCountsByCategory?: Partial<Record<DoctorFindingCategory, number>>;
+    findingCountsBySeverity?: Partial<Record<DoctorFindingSeverity, number>>;
+    primaryFindingCode?: string;
+    primaryFindingCategory?: DoctorFindingCategory;
+    nextActionReason?: string;
+    suggestedCommand?: string;
+    decisionPlan?: string;
+    interactiveSurface?: InteractiveSurface;
+    queueFocus?: QueueFocus;
+    verificationState?: VerificationState;
+    verificationFailures?: number;
 }
 export interface CheckResult {
     projectPath: string;
     packagePaths: string[];
-    packageManager: "npm" | "pnpm" | "unknown";
+    packageManager: DetectedPackageManager;
     target: TargetLevel;
     timestamp: string;
     summary: Summary;
@@ -251,7 +324,7 @@ export interface AuditOptions {
     fix: boolean;
     dryRun: boolean;
     commit: boolean;
-    packageManager: "auto" | "npm" | "pnpm" | "bun" | "yarn";
+    packageManager: SelectedPackageManager;
     reportFormat: AuditReportFormat;
     sourceMode: AuditSourceMode;
     jsonFile?: string;
@@ -423,6 +496,7 @@ export interface ReviewResult {
     updates: PackageUpdate[];
     errors: string[];
     warnings: string[];
+    decisionPlan?: DecisionPlan;
 }
 export interface ReviewOptions extends CheckOptions {
     securityOnly: boolean;
@@ -430,17 +504,37 @@ export interface ReviewOptions extends CheckOptions {
     diff?: TargetLevel;
     applySelected: boolean;
     showChangelog?: boolean;
+    queueFocus?: QueueFocus;
 }
 export interface DoctorOptions extends CheckOptions {
     verdictOnly: boolean;
     includeChangelog?: boolean;
+    agentReport?: boolean;
+}
+export interface DoctorFinding {
+    id: string;
+    code: string;
+    category: DoctorFindingCategory;
+    severity: DoctorFindingSeverity;
+    scope: "project" | "package";
+    packageName?: string;
+    workspace?: string;
+    summary: string;
+    details?: string;
+    help?: string;
+    recommendedAction?: string;
+    evidence?: string[];
 }
 export interface DoctorResult {
     verdict: Verdict;
+    score: number;
+    scoreLabel: DoctorScoreLabel;
     summary: Summary;
     review: ReviewResult;
+    findings: DoctorFinding[];
     primaryFindings: string[];
     recommendedCommand: string;
+    nextActionReason: string;
 }
 export interface AnalysisBundle {
     check: CheckResult;
@@ -454,11 +548,16 @@ export interface AnalysisBundle {
 }
 export interface DashboardOptions extends CheckOptions {
     view?: "dependencies" | "security" | "health";
+    mode: DashboardMode;
+    focus: QueueFocus;
+    applySelected: boolean;
 }
 export interface DashboardResult {
     completed: boolean;
     errors: string[];
     warnings: string[];
+    selectedUpdates: number;
+    decisionPlanFile?: string;
 }
 export type UnusedKind = "declared-not-imported" | "imported-not-declared";
 export interface UnusedDependency {
@@ -573,14 +672,14 @@ export interface GaOptions {
     jsonFile?: string;
 }
 export interface GaCheck {
-    name: "package-manager" | "workspace-discovery" | "lockfile" | "cache-backend" | "dist-build" | "benchmark-gates" | "docs-contract";
+    name: "package-manager" | "workspace-discovery" | "lockfile" | "cache-backend" | "dist-build" | "runtime-artifacts" | "benchmark-gates" | "docs-contract";
     status: "pass" | "warn" | "fail";
     detail: string;
 }
 export interface GaResult {
     ready: boolean;
     projectPath: string;
-    packageManager: "npm" | "pnpm" | "unknown";
+    packageManager: DetectedPackageManager;
     workspacePackages: number;
     cacheBackend: "sqlite" | "file";
     checks: GaCheck[];

package/dist/ui/tui.d.ts

@@ -1,2 +1,5 @@
 import type { ReviewItem } from "../types/index.js";
-export declare function runTui(items: ReviewItem[]): Promise<ReviewItem[]>;
+export declare function runTui(items: ReviewItem[], options?: {
+    title?: string;
+    subtitle?: string;
+}): Promise<ReviewItem[]>;

package/dist/ui/tui.js

@@ -22,7 +22,7 @@ const DETAIL_TABS = [
     "health",
     "changelog",
 ];
-function TuiApp({ items, onComplete }) {
+function TuiApp({ items, title, subtitle, onComplete }) {
     const [cursorIndex, setCursorIndex] = useState(0);
     const [filterIndex, setFilterIndex] = useState(0);
     const [sortIndex, setSortIndex] = useState(0);
@@ -137,7 +137,8 @@ function TuiApp({ items, onComplete }) {
             onComplete(items.filter((_, index) => selectedIndices.has(index)));
         }
     });
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Rainy Review Queue" }), _jsx(Text, { color: "gray", children: "Detect with check, summarize with doctor, decide here in review, then apply with upgrade." }), _jsx(Text, { color: "gray", children: "Filters: \u2190/\u2192  Sort: o  Group: g  Tabs: Tab  Search: /  Help: ?  Space: toggle  Enter: confirm" }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsxs(Box, { width: 24, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Filter Rail" }), FILTER_ORDER.map((filter, index) => (_jsxs(Text, { color: index === filterIndex ? "cyan" : "gray", children: [index === filterIndex ? ">" : " ", " ", filter] }, filter))), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Search" }), _jsx(Text, { color: searchMode ? "cyan" : "gray", children: searchMode ? `/${search}` : search ? `/${search}` : "inactive" })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Modes" }), _jsxs(Text, { color: "gray", children: ["sort: ", activeSort] }), _jsxs(Text, { color: "gray", children: ["group: ", activeGroup] }), _jsxs(Text, { color: "gray", children: ["tab: ", activeTab] })] })] }), _jsxs(Box, { marginLeft: 1, width: 82, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Review Queue" }), itemRows.length === 0 ? (_jsx(Text, { color: "gray", children: "No review candidates match this view." })) : (visibleRows.map((row, visibleIndex) => {
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: title ?? "Rainy Dashboard" }), _jsx(Text, { color: "gray", children: subtitle ??
+                    "Check detects, doctor summarizes, dashboard decides, upgrade applies." }), _jsx(Text, { color: "gray", children: "Filters: \u2190/\u2192  Sort: o  Group: g  Tabs: Tab  Search: /  Help: ?  Space: toggle  Enter: confirm" }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsxs(Box, { width: 24, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Filter Rail" }), FILTER_ORDER.map((filter, index) => (_jsxs(Text, { color: index === filterIndex ? "cyan" : "gray", children: [index === filterIndex ? ">" : " ", " ", filter] }, filter))), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Search" }), _jsx(Text, { color: searchMode ? "cyan" : "gray", children: searchMode ? `/${search}` : search ? `/${search}` : "inactive" })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Modes" }), _jsxs(Text, { color: "gray", children: ["sort: ", activeSort] }), _jsxs(Text, { color: "gray", children: ["group: ", activeGroup] }), _jsxs(Text, { color: "gray", children: ["tab: ", activeTab] })] })] }), _jsxs(Box, { marginLeft: 1, width: 82, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Review Queue" }), itemRows.length === 0 ? (_jsx(Text, { color: "gray", children: "No review candidates match this view." })) : (visibleRows.map((row, visibleIndex) => {
                                 if (row.kind === "group") {
                                     return (_jsx(Text, { bold: true, color: "gray", children: row.label }, `group:${row.label}`));
                                 }
@@ -353,9 +354,9 @@ function decisionColor(label) {
             return "green";
     }
 }
-export async function runTui(items) {
+export async function runTui(items, options) {
     return new Promise((resolve) => {
-        const { unmount } = render(_jsx(TuiApp, { items: items, onComplete: (selected) => {
+        const { unmount } = render(_jsx(TuiApp, { items: items, title: options?.title, subtitle: options?.subtitle, onComplete: (selected) => {
                 unmount();
                 resolve(selected);
             } }));

package/dist/utils/io.js

@@ -1,10 +1,9 @@
-import { promises as fs } from "node:fs";
+import { mkdir, rename } from "node:fs/promises";
 import path from "node:path";
-import crypto from "node:crypto";
 export async function writeFileAtomic(filePath, content) {
     const dir = path.dirname(filePath);
-    await fs.mkdir(dir, { recursive: true });
-    const tempPath = path.join(dir, `.tmp-${path.basename(filePath)}-${crypto.randomUUID()}`);
-    await fs.writeFile(tempPath, content, "utf8");
-    await fs.rename(tempPath, filePath);
+    const tempFile = path.join(dir, `.tmp-${path.basename(filePath)}-${crypto.randomUUID()}`);
+    await mkdir(dir, { recursive: true });
+    await Bun.write(tempFile, content);
+    await rename(tempFile, filePath);
 }