feat(zero-swift): build the CLI on incur (#5)

codegen gets an option per config key; the schema module option is
--schema-file because incur reserves --schema, and --schema <path> still
works. Errors are a code and a message. Documents the config keys.

Amp-Thread-ID: https://ampcode.com/threads/T-c513a037-a257-45e0-b9a9-15c15edfe859

Co-authored-by: Amp <amp@ampcode.com>

Author: tmm

.changeset/cli-incur.md

@@ -0,0 +1,5 @@
+---
+'zero-swift': minor
+---
+
+The CLI is built on [incur](https://github.com/wevm/incur). Errors print a code and a message and exit 1. `--json` prints results as JSON, `--llms` prints a manifest for coding agents, and `skills add` installs the commands as an agent skill. `codegen` has an option for every config key, such as `--type-prefix` and `--access`. The schema module option is now `--schema-file`, because incur reserves `--schema`; `--schema <path>` still works. The config keys are now documented in the README.

packages/zero-swift-cli/README.md

@@ -37,7 +37,28 @@ npx zero-swift codegen --check    # fails when the output is out of date
 `Int`; it must then hold integers. For a `json<T>()` column whose `T` is a
 plain object or a literal union, the tool generates a `Codable` type.
 
-`--schema`, `--out`, and `--config` override the config file.
+Every key is optional:
+
+| Key                           | Default             | Meaning                                   |
+| ----------------------------- | ------------------- | ----------------------------------------- |
+| `schema`                      | `schema.ts`         | The TypeScript schema module              |
+| `export`                      | `schema`            | The module export that holds the schema   |
+| `output`                      | `Schema.swift`      | The Swift file to write                   |
+| `schemaName`                  | `app`               | The `ZeroSchema` static, `ZeroSchema.app` |
+| `zql`                         | `zql`               | The global query builder, of type `ZQL`   |
+| `typePrefix`                  | none                | Prepended to every generated type name    |
+| `access`                      | `public`            | `public` or `internal`                    |
+| `tables.<t>.type`             | `<t>` in PascalCase | The row struct's name                     |
+| `tables.<t>.columns.<c>.type` | from the schema     | `int` or `double`                         |
+
+Rename a row struct whose name clashes with a type you use. A table named
+`list` generates `struct List`, which hides SwiftUI's `List`; set
+`tables.list.type` to `NoteList`, or set a `typePrefix`.
+
+Each config key has an option, such as `--schema-file`, `--out`,
+`--type-prefix`, and `--access`, that overrides it. `--config` picks the
+config file. Run `npx zero-swift codegen --help` for the full list.
+`--schema <path>` from 0.1.0 still works, as `--schema-file`.
 
 ## `zero-swift drift record`
 
@@ -60,3 +81,11 @@ The samples module's default export holds:
 
 Record again whenever either side changes. `--check` fails when the recorded
 file is out of date.
+
+## Output and agents
+
+The CLI is built on [incur](https://github.com/wevm/incur). Errors print a
+code and a message and exit 1, with no stack trace. `--json` (or `--format`)
+prints the result as JSON, for scripts and CI. `--llms` prints a manifest of
+the commands for a coding agent, and `npx zero-swift skills add` installs
+them as an agent skill.

packages/zero-swift-cli/package.json

@@ -21,7 +21,7 @@
     }
   },
   "scripts": {
-    "build": "esbuild src/bin.ts --bundle --platform=node --format=esm --target=node22 --splitting --outdir=dist --external:@rocicorp/zero --external:typescript",
+    "build": "esbuild src/bin.ts --bundle --platform=node --format=esm --target=node22 --splitting --outdir=dist --external:@rocicorp/zero --external:typescript --external:incur",
     "test": "vitest run",
     "generate": "UPDATE_GENERATED=1 vitest run",
     "check-types": "tsc",
@@ -31,6 +31,7 @@
     "version-packages": "cd ../.. && pnpm dlx @changesets/cli@3.0.3 version && jq -r .version packages/zero-swift-cli/package.json > swift/VERSION"
   },
   "dependencies": {
+    "incur": "0.7.1",
     "typescript": "6.0.3"
   },
   "devDependencies": {

packages/zero-swift-cli/src/bin.ts

@@ -1,12 +1,4 @@
 #!/usr/bin/env node
-import {main, UsageError} from './cli.ts';
+import {cli, legacyArgv} from './cli.ts';
 
-try {
-  process.exitCode = await main(process.argv.slice(2));
-} catch (e) {
-  if (!(e instanceof UsageError)) {
-    throw e;
-  }
-  process.stderr.write(`zero-swift: ${e.message}\n`);
-  process.exitCode = 1;
-}
+await cli.serve(legacyArgv(process.argv.slice(2)));