@axintai/compiler 0.2.1 → 0.3.1

package/README.md

@@ -14,10 +14,11 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/axint"><img src="https://img.shields.io/npm/v/axint?color=f05138&label=npm" alt="npm" /></a>
+  <a href="https://www.npmjs.com/package/@axintai/compiler"><img src="https://img.shields.io/npm/v/@axintai/compiler?color=f05138&label=npm" alt="npm" /></a>
   <a href="https://github.com/agenticempire/axint/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="License" /></a>
-  <a href="https://github.com/agenticempire/axint/actions"><img src="https://img.shields.io/badge/tests-124%20passing-brightgreen" alt="Tests" /></a>
+  <a href="https://github.com/agenticempire/axint/actions/workflows/ci.yml"><img src="https://github.com/agenticempire/axint/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
   <a href="https://axint.ai"><img src="https://img.shields.io/badge/playground-axint.ai-7c3aed" alt="Playground" /></a>
+  <a href="https://axint.ai/wwdc"><img src="https://img.shields.io/badge/WWDC%202026-60%20days-f05138" alt="WWDC 2026" /></a>
 </p>
 
 <p align="center">
@@ -32,7 +33,7 @@
 
 ## The picks and shovels of Agent Siri
 
-WWDC 2026 is weeks away. Apple is fusing **Model Context Protocol with App Intents** on iOS 26.1 and macOS Tahoe 26.1 — Agent Siri runs a 3B-parameter on-device model that invokes App Intents as tools. Every App Intent you ship today automatically becomes an MCP-addressable capability tomorrow.
+WWDC 2026 is weeks away. Apple is expanding **App Intents as the universal action layer** across iOS 26, macOS Tahoe, and Apple Intelligence — every App Intent you ship becomes a capability that Siri, Shortcuts, Spotlight, and on-device AI agents can invoke. The surface area is growing fast.
 
 Axint is the fastest path from an AI coding tool to a shipped App Intent. **One TypeScript definition. Two agent surfaces. Zero Swift required.**
 
@@ -56,16 +57,16 @@ Axint is the fastest path from an AI coding tool to a shipped App Intent. **One
 
 ---
 
-## Why Axint v0.2.0
+## Why Axint
 
 - **Real TypeScript AST parser.** Not regex. Uses the TypeScript compiler API, same as `tsc`, so you get full type fidelity and proper diagnostics with line/column spans.
 - **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.
-- **124 tests.** Parser, validator, generator, and emit paths — 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.
 
 ---
@@ -76,8 +77,8 @@ Axint is the fastest path from an AI coding tool to a shipped App Intent. **One
 # Install globally
 npm install -g @axintai/compiler
 
-# Or use without installing
-npx axint compile my-intent.ts --stdout
+# Or use without installing (runs from npm cache)
+npx -p @axintai/compiler axint compile my-intent.ts --stdout
 ```
 
 Create `my-intent.ts`:
@@ -119,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
@@ -182,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.
 
@@ -271,7 +299,7 @@ axint/
 │   ├── mcp/         # MCP server (scaffold, compile, validate)
 │   ├── cli/         # axint CLI (Commander.js)
 │   └── templates/   # Intent template registry
-├── tests/           # 124 vitest tests
+├── tests/           # 155 vitest tests
 ├── examples/        # Example intent definitions
 └── docs/            # Error reference, contributing, assets
 ```
@@ -299,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] 124-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)