@axintai/compiler 0.3.0 → 0.3.2

package/README.md

@@ -63,10 +63,10 @@ Axint is the fastest path from an AI coding tool to a shipped App Intent. **One
 - **Native type fidelity.** `int → Int`, `double → Double`, `float → Float`, `date → Date`, `url → URL`, `duration → Measurement<UnitDuration>`, `optional<T> → T?`. Default values and optionality are preserved end-to-end.
 - **Return-type-aware `perform()` signatures.** Every generated intent is a drop-in tool for Agent Siri and Shortcuts.
 - **Info.plist and .entitlements emit.** Axint writes the `NSAppIntentsDomains` plist fragment and the App Intents entitlement XML alongside your `.swift` file. Drop all three into Xcode and ship.
-- **MCP-native.** A bundled `axint-mcp` server exposes `axint_scaffold`, `axint_compile`, and `axint_validate` to any MCP client. Your AI coding agent can read your project, draft a TypeScript intent, compile it, and open a PR — without a human touching Xcode.
+- **MCP-native.** A bundled `axint-mcp` server exposes five tools — `axint_scaffold`, `axint_compile`, `axint_validate`, `axint_list_templates`, and `axint_template` — to any MCP client. Your AI coding agent can read your project, draft a TypeScript intent, compile it, and open a PR — without a human touching Xcode.
 - **Rust-grade diagnostics.** 16 diagnostic codes (`AX001`–`AX202`) with fix suggestions and color-coded output.
 - **Sub-millisecond compile.** A typical intent compiles in under a millisecond. The [axint.ai playground](https://axint.ai/#playground) runs the full compiler in your browser with zero server round-trip.
-- **152 tests.** Parser, validator, generator, emit paths, and sandbox — all covered.
+- **155 tests.** Parser, validator, generator, emit paths, watch mode, and sandbox — all covered.
 - **Apache 2.0, no CLA.** Fork it, extend it, ship it.
 
 ---
@@ -120,6 +120,31 @@ ios/Intents/
 
 ---
 
+## Watch mode
+
+For iterative development, `axint watch` recompiles on every save with sub-millisecond rebuilds:
+
+```bash
+# Watch a single file
+axint watch my-intent.ts --out ios/Intents/
+
+# Watch a directory of intents
+axint watch ./intents/ --out ios/Intents/ --emit-info-plist --emit-entitlements
+
+# With swift-format
+axint watch my-intent.ts --out ios/Intents/ --format
+
+# Auto-run swift build after each compile
+axint watch ./intents/ --out ios/Intents/ --swift-build
+
+# Specify the Swift project root (defaults to --out parent)
+axint watch ./intents/ --out ios/Sources/Intents/ --swift-build --swift-project ios/
+```
+
+The watcher runs an initial compile pass, then re-triggers on file changes with a 150ms debounce. Errors are reported inline without killing the process — fix the file and it recompiles automatically. With `--swift-build`, each successful compile triggers `swift build` in the project directory so you get immediate feedback on whether the generated Swift compiles cleanly.
+
+---
+
 ## Compiled Swift output
 
 ```swift
@@ -183,13 +208,15 @@ Axint ships with `axint-mcp`, a Model Context Protocol server that exposes the c
 }
 ```
 
-Three tools are exposed:
+Five tools are exposed:
 
-| Tool              | What it does                                                               |
-| ----------------- | -------------------------------------------------------------------------- |
-| `axint_scaffold`  | Generates a TypeScript intent from a natural-language description          |
-| `axint_compile`   | Runs the full pipeline and returns `.swift` + `.plist` + `.entitlements`   |
-| `axint_validate`  | Dry-run validation with line/column diagnostics                            |
+| Tool                  | What it does                                                               |
+| --------------------- | -------------------------------------------------------------------------- |
+| `axint_scaffold`      | Generates a TypeScript intent from a natural-language description          |
+| `axint_compile`       | Runs the full pipeline and returns `.swift` + `.plist` + `.entitlements`   |
+| `axint_validate`      | Dry-run validation with line/column diagnostics                            |
+| `axint_list_templates`| Lists all bundled intent templates                                         |
+| `axint_template`      | Returns the source of a specific bundled template                          |
 
 Once connected, your AI coding agent can read a Swift project, draft an intent, compile it, and open a PR — without a human touching Xcode.
 
@@ -272,7 +299,7 @@ axint/
 │   ├── mcp/         # MCP server (scaffold, compile, validate)
 │   ├── cli/         # axint CLI (Commander.js)
 │   └── templates/   # Intent template registry
-├── tests/           # 117 vitest tests
+├── tests/           # 155 vitest tests
 ├── examples/        # Example intent definitions
 └── docs/            # Error reference, contributing, assets
 ```
@@ -300,10 +327,11 @@ See [`ROADMAP.md`](ROADMAP.md) for the full plan. Highlights:
 - [x] Info.plist and `.entitlements` emit (v0.2.0)
 - [x] Return-type-aware `perform()` (v0.2.0)
 - [x] MCP scaffold tool (v0.2.0)
-- [x] 152-test suite with snapshot coverage (v0.2.0)
-- [ ] Intent template library (v0.3.0)
-- [ ] `--watch` mode for live Swift preview
-- [ ] Xcode build plugin
+- [x] 155-test suite with snapshot coverage (v0.2.0+)
+- [x] Intent template library with 12+ templates (v0.3.0)
+- [x] `--watch` mode with `--swift-build` for live recompilation (v0.3.0)
+- [x] SPM build plugin — auto-compile during `swift build` (v0.3.0)
+- [x] Registry at registry.axint.ai (v0.3.0)
 - [ ] GitHub template repo (`axint-starter`)
 - [ ] Axint Cloud (hosted compilation)