feat(fmodata): add fmodata CLI binary

[chriscors]

Summary

Adds a non-interactive fmodata CLI binary to @proofkit/fmodata, making every OData operation scriptable from the shell — useful for CI pipelines, automation, and quick one-off database operations.

• No new package — ships inside the existing packages/fmodata package
• Zero interactive prompts — pure flags/args, fully scriptable
• Safe by default — destructive schema mutations require an explicit --confirm flag; without it they dry-run
• Flexible auth — API key or username/password, all via env vars or flags

Commands

Command	Description
fmodata query list	List records (--top, --skip, --select, --where, --order-by)
fmodata query insert	Insert a record (--data <json>)
fmodata query update	Update records (--data, --where)
fmodata query delete	Delete records (--where)
fmodata script run <name>	Run a FileMaker script (--param)
fmodata webhook list/get/add/remove	Full webhook lifecycle
fmodata metadata get	OData metadata (JSON or XML)
fmodata metadata tables	List table names
fmodata schema list-tables	List tables
fmodata schema create-table	Create a table (dry-run unless --confirm)
fmodata schema add-fields	Add fields to a table (dry-run unless --confirm)

Connection

All commands share the same global flags with env var fallbacks:

--server    FM_SERVER
--database  FM_DATABASE
--username  FM_USERNAME
--password  FM_PASSWORD
--api-key   OTTO_API_KEY

API key takes precedence over username/password when both are provided.

Output

• JSON by default (stdout)
• --table flag renders an ASCII table via cli-table3
• Errors → stderr, exit code 1

Implementation details

Files added

packages/fmodata/
  tsdown.config.ts              # CLI-only bundle (entry: src/cli/index.ts → dist/cli/)
  src/cli/
    index.ts                    # Commander root, global options, exit handler
    utils/connection.ts         # Build FMServerConnection from flags + env vars
    utils/output.ts             # JSON / cli-table3 renderer
    utils/errors.ts             # stderr + exit 1
    commands/
      query.ts                  # list / insert / update / delete
      script.ts                 # run
      webhook.ts                # list / get / add / remove
      metadata.ts               # get / tables
      schema.ts                 # list-tables / create-table / add-fields
  tests/cli/
    unit/connection.test.ts
    unit/output.test.ts
    commands/{query,script,webhook,metadata,schema}.test.ts
    integration/binary.test.ts  # verifies built binary + --help
    e2e/                        # excluded from default runs; run with test:cli:e2e
apps/docs/content/docs/fmodata/
  cli.mdx                       # Full CLI reference documentation

package.json changes

• Added "bin": { "fmodata": "dist/cli/index.js" }
• Build script: tsc && vite build && tsdown && publint --strict
• Added test:cli:e2e script for E2E tests against a real FM server
• Added commander to dependencies; tsdown and cli-table3 to devDependencies

vitest.config.ts change

• tests/cli/e2e/** added to the exclude list (run separately via test:cli:e2e)

Testing

# All unit + command + integration tests (859 passing, 0 type errors)
pnpm --filter @proofkit/fmodata test

# Build and smoke-test the binary
pnpm --filter @proofkit/fmodata build
node packages/fmodata/dist/cli/index.js --help
node packages/fmodata/dist/cli/index.js query --help

# E2E (requires a real FM server via Doppler)
pnpm --filter @proofkit/fmodata test:cli:e2e

Documentation

Full reference docs added at apps/docs/content/docs/fmodata/cli.mdx, covering:

• Installation
• Connection options table
• All commands with option tables and usage examples
• CI integration examples (GitHub Actions, shell scripts)
• Dry-run behaviour for schema commands

🤖 Generated with Claude Code

[vercel]

@chriscors is attempting to deploy a commit to the Proof Geist Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
proofkit-docs	Ready	Preview	Mar 9, 2026 11:05pm