v0.2.1

Added

• faker --describe (no args) shows full tool self-description for agents
• --format csv output with RFC 4180 compliance (header rows, proper escaping)

Fixed

• --schema with leading whitespace no longer treated as a file path
• Schema errors now show which method failed and suggest --describe
• Extra positional args now warn instead of being silently ignored
• --count capped at 100,000 to prevent unbounded memory/time
• CSV: nested objects serialized as JSON in cells instead of [object Object]
• CSV: header keys with commas/quotes properly escaped

v0.2.0

Added

• Schema mode (--schema) for generating structured JSON objects from templates
• Nested schemas, parenthesized args, literal passthrough
• File-based schemas (--schema schema.json)
• --locale flag with 60+ locales
• --ref-date flag for deterministic date output
• --describe flag for module and method discovery (params, types, examples)
• Module-level descriptions in --list and --describe
• Guided error messages that suggest next actions
• Helpers module: arrayElement, fake, fromRegExp, slugify, shuffle, and more
• --format ndjson for streaming output
• --version flag
• CI workflow (test on PR/push)
• Release workflow (cross-platform binaries, GitHub releases, Homebrew)
• /release slash command for version management
• README with full usage documentation
• Project-specific CLAUDE.md

Changed

• --info renamed to --describe (--info kept as hidden alias)
• --list now shows module descriptions in TTY mode, JSON when piped
• Error messages now guide users to relevant commands

Fixed

• serialize crash on BigInt nested inside objects/arrays
• --locale/--ref-date/--schema silently eating next arg when value missing
• Schema parser accepting malformed parenthesized syntax

v0.1.0

Added

• Core CLI: faker module.method [args] with JSON output to stdout
• Schema mode: --schema for structured object generation from JSON templates
• 27 modules including helpers (arrayElement, fake, fromRegExp, slugify, etc.)
• --describe flag for method/module discovery with params, types, examples
• --list with TTY-aware formatting and module descriptions
• --locale support for 60+ locales
• --seed and --ref-date for fully deterministic output
• --format ndjson for streaming output
• --count for batch generation
• Guided error messages that suggest next actions
• 240 deterministic fixtures, 259-method metadata index
• 66 tests, 378 assertions