feat: hello world CLI tool

[jamesrxian]

feat: hello world CLI tool

A simple CLI tool that prints "Hello, !" to stdout. For e2e testing of the spec-to-code issue mode workflow.

Status

• gathering requirements
• research
• design
• plan
• e2e-test-design
• spec-ready

Plan

• Step 1: Create CLI entry point with argument parsing
• Step 2: Add greeting logic and tests
• Step 3: Add --uppercase flag

[jamesrxian]

design.md

1. Overview

A minimal CLI tool (hello) that accepts a name argument and prints a greeting.

2. Components

CLI Entry Point (src/cli.ts)

• Uses commander for argument parsing
• Required positional argument: <name>
• Optional flag: --uppercase / -u (converts greeting to uppercase)

Greeting Module (src/greet.ts)

• greet(name: string, options?: { uppercase?: boolean }): string
• Returns "Hello, <name>!" or "HELLO, <NAME>!" if uppercase is true

3. Acceptance Criteria

• Given name "World", output is "Hello, World!"
• Given name "World" with --uppercase, output is "HELLO, WORLD!"
• Given no name, prints usage help and exits with code 1

[jamesrxian]

plan.md

Implementation Plan: Hello World CLI

Checklist

• Step 1: Create CLI entry point with argument parsing
• Step 2: Add greeting logic and tests
• Step 3: Add --uppercase flag

---

Step 1: Create CLI entry point with argument parsing

Objective: Set up the project with TypeScript, commander, and a basic CLI that accepts a name argument.

Test Requirements: Test that CLI prints usage when no args given (exit code 1).

Implementation Guidance: Create src/cli.ts with commander, positional <name> argument.

Demo: node dist/cli.js World prints "Hello, World!"

---

Step 2: Add greeting logic and tests

Objective: Extract greeting logic to src/greet.ts with unit tests.

Test Requirements: Unit test greet("World") returns "Hello, World!".

Implementation Guidance: Create src/greet.ts with greet() function. CLI calls greet and prints result.

Demo: npm test passes, node dist/cli.js Alice prints "Hello, Alice!"

---

Step 3: Add --uppercase flag

Objective: Add optional --uppercase flag that converts output to uppercase.

Test Requirements: Unit test greet("World", { uppercase: true }) returns "HELLO, WORLD!".

Implementation Guidance: Add -u, --uppercase option to commander. Pass to greet().

Demo: node dist/cli.js World -u prints "HELLO, WORLD!"

[jamesrxian]

[from bot] Starting implementation. Tracking on branch issue-6-hello-world-cli-tool.

[jamesrxian]

[from bot] Step 1/3 complete: Create CLI entry point with argument parsing

• Commit: freematters/freematters@c1e4329
• Files changed: src/cli.ts, src/tests/cli.test.ts, package.json, tsconfig.json, biome.json
• Tests: 2 added, all passing

[jamesrxian]

[from bot] Step 2/3 complete: Add greeting logic and tests

• Commit: freematters/freematters@bb832b2
• Files changed: src/greet.ts, src/tests/greet.test.ts, src/cli.ts
• Tests: 2 added (4 total), all passing

[jamesrxian]

[from bot] Step 3/3 complete: Add --uppercase flag

• Commit: freematters/freematters@b2e19ee
• Files changed: src/greet.ts, src/cli.ts, src/tests/greet.test.ts
• Tests: 2 added (6 total), all passing

[jamesrxian]

[from bot] Implementation complete!

• Branch: issue-6-hello-world-cli-tool
• Steps completed: 3/3
• Total commits: 3
• Tests: 6 tests, all passing

Ready for PR — run /pr to create a pull request.