import { describe, expect, it } from "vitest"; import { buildParseArgv, getFlagValue, getCommandPath, getPrimaryCommand, getPositiveIntFlagValue, getVerboseFlag, hasHelpOrVersion, hasFlag, shouldMigrateState, shouldMigrateStateFromPath, } from "./argv.js"; describe("argv helpers", () => { it("detects help/version flags", () => { expect(hasHelpOrVersion(["node", "clawdbot", "--help"])).toBe(true); expect(hasHelpOrVersion(["node", "clawdbot", "-V"])).toBe(true); expect(hasHelpOrVersion(["node", "clawdbot", "status"])).toBe(false); }); it("extracts command path ignoring flags and terminator", () => { expect(getCommandPath(["node", "clawdbot", "status", "--json"], 2)).toEqual(["status"]); expect(getCommandPath(["node", "clawdbot", "agents", "list"], 2)).toEqual(["agents", "list"]); expect(getCommandPath(["node", "clawdbot", "status", "--", "ignored"], 2)).toEqual(["status"]); }); it("returns primary command", () => { expect(getPrimaryCommand(["node", "clawdbot", "agents", "list"])).toBe("agents"); expect(getPrimaryCommand(["node", "clawdbot"])).toBeNull(); }); it("parses boolean flags and ignores terminator", () => { expect(hasFlag(["node", "clawdbot", "status", "--json"], "--json")).toBe(true); expect(hasFlag(["node", "clawdbot", "--", "--json"], "--json")).toBe(false); }); it("extracts flag values with equals and missing values", () => { expect(getFlagValue(["node", "clawdbot", "status", "--timeout", "5000"], "--timeout")).toBe( "5000", ); expect(getFlagValue(["node", "clawdbot", "status", "--timeout=2500"], "--timeout")).toBe( "2500", ); expect(getFlagValue(["node", "clawdbot", "status", "--timeout"], "--timeout")).toBeNull(); expect(getFlagValue(["node", "clawdbot", "status", "--timeout", "--json"], "--timeout")).toBe( null, ); expect(getFlagValue(["node", "clawdbot", "--", "--timeout=99"], "--timeout")).toBeUndefined(); }); it("parses verbose flags", () => { expect(getVerboseFlag(["node", "clawdbot", "status", "--verbose"])).toBe(true); expect(getVerboseFlag(["node", "clawdbot", "status", "--debug"])).toBe(false); expect(getVerboseFlag(["node", "clawdbot", "status", "--debug"], { includeDebug: true })).toBe( true, ); }); it("parses positive integer flag values", () => { expect(getPositiveIntFlagValue(["node", "clawdbot", "status"], "--timeout")).toBeUndefined(); expect( getPositiveIntFlagValue(["node", "clawdbot", "status", "--timeout"], "--timeout"), ).toBeNull(); expect( getPositiveIntFlagValue(["node", "clawdbot", "status", "--timeout", "5000"], "--timeout"), ).toBe(5000); expect( getPositiveIntFlagValue(["node", "clawdbot", "status", "--timeout", "nope"], "--timeout"), ).toBeUndefined(); }); it("builds parse argv from raw args", () => { const nodeArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["node", "clawdbot", "status"], }); expect(nodeArgv).toEqual(["node", "clawdbot", "status"]); const versionedNodeArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["node-22", "clawdbot", "status"], }); expect(versionedNodeArgv).toEqual(["node-22", "clawdbot", "status"]); const versionedNodeWindowsArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["node-22.2.0.exe", "clawdbot", "status"], }); expect(versionedNodeWindowsArgv).toEqual(["node-22.2.0.exe", "clawdbot", "status"]); const versionedNodePatchlessArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["node-22.2", "clawdbot", "status"], }); expect(versionedNodePatchlessArgv).toEqual(["node-22.2", "clawdbot", "status"]); const versionedNodeWindowsPatchlessArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["node-22.2.exe", "clawdbot", "status"], }); expect(versionedNodeWindowsPatchlessArgv).toEqual(["node-22.2.exe", "clawdbot", "status"]); const versionedNodeWithPathArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["/usr/bin/node-22.2.0", "clawdbot", "status"], }); expect(versionedNodeWithPathArgv).toEqual(["/usr/bin/node-22.2.0", "clawdbot", "status"]); const nodejsArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["nodejs", "clawdbot", "status"], }); expect(nodejsArgv).toEqual(["nodejs", "clawdbot", "status"]); const nonVersionedNodeArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["node-dev", "clawdbot", "status"], }); expect(nonVersionedNodeArgv).toEqual(["node", "clawdbot", "node-dev", "clawdbot", "status"]); const directArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["clawdbot", "status"], }); expect(directArgv).toEqual(["node", "clawdbot", "status"]); const bunArgv = buildParseArgv({ programName: "clawdbot", rawArgs: ["bun", "src/entry.ts", "status"], }); expect(bunArgv).toEqual(["bun", "src/entry.ts", "status"]); }); it("builds parse argv from fallback args", () => { const fallbackArgv = buildParseArgv({ programName: "clawdbot", fallbackArgv: ["status"], }); expect(fallbackArgv).toEqual(["node", "clawdbot", "status"]); }); it("decides when to migrate state", () => { expect(shouldMigrateState(["node", "clawdbot", "status"])).toBe(false); expect(shouldMigrateState(["node", "clawdbot", "health"])).toBe(false); expect(shouldMigrateState(["node", "clawdbot", "sessions"])).toBe(false); expect(shouldMigrateState(["node", "clawdbot", "memory", "status"])).toBe(false); expect(shouldMigrateState(["node", "clawdbot", "agent", "--message", "hi"])).toBe(false); expect(shouldMigrateState(["node", "clawdbot", "agents", "list"])).toBe(true); expect(shouldMigrateState(["node", "clawdbot", "message", "send"])).toBe(true); }); it("reuses command path for migrate state decisions", () => { expect(shouldMigrateStateFromPath(["status"])).toBe(false); expect(shouldMigrateStateFromPath(["agents", "list"])).toBe(true); }); });