questionnaire-cli

name	questionnaire-cli
description	How to drive the questionnaire data access layer from the shell via the `apps/console` CLI. Use this skill whenever the user wants to create, list, inspect, update, soft-delete questionnaires, view aggregated results, or submit/list answers from a terminal.

questionnaire CLI

apps/console is a thin JSON-in / JSON-out wrapper around @questionnaires/lib. All business logic lives in the lib; the CLI only parses argv, reads/writes JSON, and maps errors to exit codes.

See docs/console-cli.md for design notes (thin-wrapper invariant, output contract, how to add a command).

Invocation

From the repo root:

pnpm console <group> <subcommand> [flags]

pnpm 10 forwards trailing args verbatim, so no -- separator is needed. Inside apps/console, you can also run pnpm start <args>.

Discovering commands and flags

Commander generates --help (-h) for every level — use it as the live reference instead of guessing flags:

pnpm console --help                  # top-level groups
pnpm console questionnaire --help    # subcommands of a group
pnpm console db sample -h            # leaf-command flags

Global flag

--db <url> — optional. Resolution order: this flag → $DATABASE_URL env → <invoking-cwd>/questionnaire.db (anchored to $INIT_CWD when run via pnpm/npm scripts, otherwise process.cwd()). The DB is created and migrated automatically on first use.

Commands

All commands write a single JSON document to stdout on success (exit 0). On failure, an error envelope goes to stderr with a non-zero exit (see "Error shape" below).