CLI: streamline startup paths and env parsing

Add shared parseBooleanValue()/isTruthyEnvValue() and apply across CLI, gateway, memory, and live-test flags for consistent env handling.
Introduce route-first fast paths, lazy subcommand registration, and deferred plugin loading to reduce CLI startup overhead.
Centralize config validation via ensureConfigReady() and add config caching/deferred shell env fallback for fewer IO passes.
Harden logger initialization/imports and add focused tests for argv, boolean parsing, frontmatter, and CLI subcommands.
This commit is contained in:
Gustavo Madeira Santana
2026-01-18 15:56:24 -05:00
committed by Peter Steinberger
parent 97531f174f
commit acb523de86
58 changed files with 1274 additions and 500 deletions

42
src/utils/boolean.test.ts Normal file
View File

@@ -0,0 +1,42 @@
import { describe, expect, it } from "vitest";
import { parseBooleanValue } from "./boolean.js";
describe("parseBooleanValue", () => {
it("handles boolean inputs", () => {
expect(parseBooleanValue(true)).toBe(true);
expect(parseBooleanValue(false)).toBe(false);
});
it("parses default truthy/falsy strings", () => {
expect(parseBooleanValue("true")).toBe(true);
expect(parseBooleanValue("1")).toBe(true);
expect(parseBooleanValue("yes")).toBe(true);
expect(parseBooleanValue("on")).toBe(true);
expect(parseBooleanValue("false")).toBe(false);
expect(parseBooleanValue("0")).toBe(false);
expect(parseBooleanValue("no")).toBe(false);
expect(parseBooleanValue("off")).toBe(false);
});
it("respects custom truthy/falsy lists", () => {
expect(
parseBooleanValue("on", {
truthy: ["true"],
falsy: ["false"],
}),
).toBeUndefined();
expect(
parseBooleanValue("yes", {
truthy: ["yes"],
falsy: ["no"],
}),
).toBe(true);
});
it("returns undefined for unsupported values", () => {
expect(parseBooleanValue("")).toBeUndefined();
expect(parseBooleanValue("maybe")).toBeUndefined();
expect(parseBooleanValue(1)).toBeUndefined();
});
});

24
src/utils/boolean.ts Normal file
View File

@@ -0,0 +1,24 @@
export type BooleanParseOptions = {
truthy?: string[];
falsy?: string[];
};
const DEFAULT_TRUTHY = ["true", "1", "yes", "on"] as const;
const DEFAULT_FALSY = ["false", "0", "no", "off"] as const;
export function parseBooleanValue(
value: unknown,
options: BooleanParseOptions = {},
): boolean | undefined {
if (typeof value === "boolean") return value;
if (typeof value !== "string") return undefined;
const normalized = value.trim().toLowerCase();
if (!normalized) return undefined;
const truthy = options.truthy ?? DEFAULT_TRUTHY;
const falsy = options.falsy ?? DEFAULT_FALSY;
const truthySet = new Set<string>(truthy);
const falsySet = new Set<string>(falsy);
if (truthySet.has(normalized)) return true;
if (falsySet.has(normalized)) return false;
return undefined;
}