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

View File

@@ -1,5 +1,9 @@
import { describe, expect, it } from "vitest";
import { parseFrontmatter, resolveClawdbotMetadata } from "./frontmatter.js";
import {
parseFrontmatter,
resolveClawdbotMetadata,
resolveHookInvocationPolicy,
} from "./frontmatter.js";
describe("parseFrontmatter", () => {
it("parses single-line key-value pairs", () => {
@@ -273,3 +277,14 @@ metadata:
expect(clawdbot?.events).toEqual(["command:new"]);
});
});
describe("resolveHookInvocationPolicy", () => {
it("defaults to enabled when missing", () => {
expect(resolveHookInvocationPolicy({}).enabled).toBe(true);
});
it("parses enabled flag", () => {
expect(resolveHookInvocationPolicy({ enabled: "no" }).enabled).toBe(false);
expect(resolveHookInvocationPolicy({ enabled: "on" }).enabled).toBe(true);
});
});

View File

@@ -1,6 +1,7 @@
import JSON5 from "json5";
import { parseFrontmatterBlock } from "../markdown/frontmatter.js";
import { parseBooleanValue } from "../utils/boolean.js";
import type {
ClawdbotHookMetadata,
HookEntry,
@@ -57,16 +58,8 @@ function getFrontmatterValue(frontmatter: ParsedHookFrontmatter, key: string): s
}
function parseFrontmatterBool(value: string | undefined, fallback: boolean): boolean {
if (!value) return fallback;
const normalized = value.trim().toLowerCase();
if (!normalized) return fallback;
if (normalized === "true" || normalized === "1" || normalized === "yes" || normalized === "on") {
return true;
}
if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "off") {
return false;
}
return fallback;
const parsed = parseBooleanValue(value);
return parsed === undefined ? fallback : parsed;
}
export function resolveClawdbotMetadata(