[codex] ROY-36: Add hello command to CLI

src/args.ts

@@ -6,6 +6,7 @@ export type CliCommand =
 	| { kind: "status"; issueKey: string; projectId: string }
 	| { kind: "projects" }
 	| { kind: "setup"; check: boolean }
+	| { kind: "hello"; name?: string }
 	| { kind: "help" };
 
 export function parseArgs(argv: string[]): CliCommand {
@@ -76,6 +77,12 @@ export function parseArgs(argv: string[]): CliCommand {
 		return { kind: "projects" };
 	}
 
+	if (command === "hello") {
+		const args = rest.slice(1);
+		const name = readFlagValue(args, "--name");
+		return { kind: "hello", name };
+	}
+
 	throw new Error(`Unknown command: ${command}`);
 }
 

src/commands/handlers.ts

@@ -7,7 +7,10 @@ import { runWorkflow } from "../core/workflow";
 import { runCronScheduler } from "../services/cron";
 
 type SetupCommand = Extract<CliCommand, { kind: "setup" }>;
-type RunnableCommand = Exclude<CliCommand, { kind: "help" } | SetupCommand>;
+type RunnableCommand = Exclude<
+	CliCommand,
+	{ kind: "help" } | { kind: "hello" } | SetupCommand
+>;
 
 export async function handleSetupCommand(
 	command: SetupCommand,
@@ -63,6 +66,11 @@ export async function handleCommand(
 	process.stdout.write(`${JSON.stringify(state, null, 2)}\n`);
 }
 
+export function handleHelloCommand(command: { name?: string }): void {
+	const target = command.name ?? "World";
+	process.stdout.write(`Hello, ${target}!\n`);
+}
+
 export function printHelp(): void {
 	process.stdout.write(
 		`${[
@@ -74,6 +82,7 @@ export function printHelp(): void {
 			"  adhd-ai cron [--job <JOB_ID>]",
 			"  adhd-ai status --project <PROJECT_ID> --issue <LINEAR_KEY>",
 			"  adhd-ai projects",
+			"  adhd-ai hello [--name <NAME>]",
 			"  adhd-ai setup [--check]",
 			"  adhd-ai help",
 			"",

src/index.ts

@@ -2,6 +2,7 @@
 import { parseArgs } from "./args";
 import {
 	handleCommand,
+	handleHelloCommand,
 	handleSetupCommand,
 	printHelp,
 } from "./commands/handlers";
@@ -26,6 +27,11 @@ async function main(): Promise<void> {
 		return;
 	}
 
+	if (command.kind === "hello") {
+		handleHelloCommand(command);
+		return;
+	}
+
 	const config = await loadConfig(cwd);
 	await handleCommand(command, config);
 }

tests/args.test.ts

@@ -143,4 +143,20 @@ describe("parseArgs", () => {
 			]),
 		).toThrow("run command cannot use --project with --all-projects");
 	});
+
+	it("parses hello command without name", () => {
+		const parsed = parseArgs(["bun", "adhd-ai", "hello"]);
+		expect(parsed).toEqual({
+			kind: "hello",
+			name: undefined,
+		});
+	});
+
+	it("parses hello command with name", () => {
+		const parsed = parseArgs(["bun", "adhd-ai", "hello", "--name", "Alice"]);
+		expect(parsed).toEqual({
+			kind: "hello",
+			name: "Alice",
+		});
+	});
 });