API Overview

This page summarizes internal module boundaries. Detailed API docs are split per source file.

Entry points

• taskdb.ts: executable entrypoint (#!/usr/bin/env bun), calls run(process.argv.slice(2)).
• src/cli.ts: creates Commander program and runs argument parsing.

CLI layer

• createProgram(output?): builds configured Commander instance and registers commands.
• run(args, output?): runs CLI and returns process-like exit code.

Output formatting behavior

Command output rendering is centralized in src/commands/helpers.ts:

• formatTask(task, output): terse single-line output (#<id>: <title> - (<Status>) - [labels]).
• formatFullTask(task, output): multi-line task details (used by view --format plain).
• formatTaskJSON(task, output): single task JSON output.
• formatTaskList(tasks, output): terse list output.
• formatTaskListJSON(tasks, output): list JSON output.

Command registration

• src/commands/index.ts: registerAllCommands(program, output)
• Commands: init, create, update, view, complete, delete, comment, list, search.

Detailed module API docs

• Constants API (src/constants.ts)
• Task Model API (src/models/task.ts)
• Project Model API (src/models/project.ts)
• Datetime Utility API (src/utils/datetime.ts)
• Env Utility API (src/utils/env.ts)
• Slug Utility API (src/utils/slug.ts)
• Strings Utility API (src/utils/strings.ts)