feat(fmodata): add fmodata CLI binary#135
Closed
eluce2 wants to merge 7 commits into03-13-feat_add_tanstack_intent_skills_for_all_packagesfrom
Closed
feat(fmodata): add fmodata CLI binary#135eluce2 wants to merge 7 commits into03-13-feat_add_tanstack_intent_skills_for_all_packagesfrom
eluce2 wants to merge 7 commits into03-13-feat_add_tanstack_intent_skills_for_all_packagesfrom
Conversation
Adds a non-interactive CLI (`fmodata`) to the @proofkit/fmodata package, making every OData operation available from the shell for use in scripts, CI pipelines, and one-off database tasks. - New `fmodata` binary entry in package.json → `dist/cli/index.js` - `tsdown.config.ts` for bundling the CLI separately from the library - Build script updated: `tsc && vite build && tsdown && publint --strict` - `query list/insert/update/delete` — CRUD via raw OData requests with `--top`, `--skip`, `--select`, `--where`, `--order-by` options - `script run <name>` — execute FileMaker scripts with optional `--param` - `webhook list/get/add/remove` — full webhook lifecycle management - `metadata get/tables` — retrieve OData metadata (JSON or XML) - `schema list-tables/create-table/add-fields` — DDL operations with a `--confirm` flag; without it the command is a safe dry-run - All commands accept `--server`, `--database`, `--username`, `--password`, `--api-key` flags with automatic env var fallbacks (`FM_SERVER`, `FM_DATABASE`, `FM_USERNAME`, `FM_PASSWORD`, `OTTO_API_KEY`) - API key takes precedence over username/password when both are set - JSON by default; `--table` flag renders results as ASCII table via cli-table3 - Errors go to stderr; non-zero exit code on failure - `tests/cli/unit/` — connection env-var resolution and output formatting - `tests/cli/commands/` — per-command happy-path and error tests - `tests/cli/integration/` — verifies built binary and `--help` output - `tests/cli/e2e/` excluded from default runs; run with `test:cli:e2e` - New `apps/docs/content/docs/fmodata/cli.mdx` with full command reference, connection options table, CI integration examples, and dry-run guidance - Added to fmodata nav under a new `---CLI---` section Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Global output flag renamed from --table to --pretty to avoid ambiguity - Table name option on query/webhook/schema commands simplified from --table-name back to --table (no longer conflicts with output flag) - OutputOptions interface updated: table → pretty - All command handlers and tests updated accordingly - Docs updated to reflect new flag names Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Covers three integration patterns: - Claude Code: running fmodata commands directly in a conversation - MCP Tool Server: wrapping CLI commands as MCP tools with zod schemas - Giving an agent context: schema description prompt snippet Also includes a safety callout recommending read-only vs write vs schema permission tiers, with a note that --confirm is the natural enforcement point for schema operations. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
`query` implied read-only; `records` better reflects that the command
group covers the full CRUD lifecycle (list, insert, update, delete).
- src/cli/commands/query.ts: makeQueryCommand → makeRecordsCommand,
Command("query") → Command("records")
- src/cli/index.ts: updated import and registration
- tests/cli/integration/binary.test.ts: updated --help assertion
- docs/fmodata/cli.mdx: all usage examples updated to `records *`
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Updated `buildQueryString` to encode query parameters for safety. - Enhanced error handling in `makeRecordsCommand` to use braces for clarity. - Added `cli-table3` dependency to `package.json` for table formatting. These changes ensure that query parameters are properly encoded and improve the readability of error handling in the CLI commands.
- Updated authentication notes to specify that if an API key is present, missing `FM_PASSWORD` does not block authentication. - Added information on URL-encoding for query option values in the CLI documentation. These changes enhance the clarity of authentication behavior and query handling in the CLI documentation.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Collaborator
Author
|
Renaming branch to break Graphite's association with closed PR #128 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Test plan
pnpm testin fmodata package🤖 Generated with Claude Code