@crossdelta/platform-sdk 0.25.7 → 0.26.1

package/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to `@crossdelta/platform-sdk` will be documented in this fil
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.26.1] - 2026-10-17
+
+### Fixed
+- **`pf dev` reads a `.env.local` value containing `$` as written.** `generate-env` now writes such a
+  value as `"…\$…"` (`@crossdelta/infrastructure` 0.18.1), and dotenv's `parse` kept the backslash, so
+  the ports and env `pf` hands to the apps carried `\$` instead of `$`. `parseEnvFile` reads with
+  `parseEnvContent` from `@crossdelta/infrastructure/env-file`, the reader that pairs with that writer.
+  It reads what `generate-env` writes and is stricter than dotenv about hand-written lines: spaces
+  around `=`, a key with `.` or `-` and a comment after the value are not read as dotenv read them.
+
+### Removed
+- The `dotenv` dependency, which only `parseEnvFile` used.
+
+## [0.26.0] - 2026-10-11
+
+### Removed
+- **BREAKING: `pf setup ai` and the AI generation path are gone.** `pf setup ai`, the `--ai` and `-d`
+  options of `pf new hono-micro` and `pf new nest-micro`, and the "Use AI?" step of `pf new` no longer
+  exist. Services are generated through the pf MCP server (`@crossdelta/pf-mcp`), which is unchanged.
+  The AI provider code, the events service updater, the NestJS and AST patchers that only it used, the
+  `generatorConfig` block with its `schemas/service-types.schema.json`, and the dependencies `ai`,
+  `@ai-sdk/anthropic`, `@ai-sdk/openai`, `@inquirer/prompts`, `ora` and `ts-morph` went with it.
+  `AI_IMAGE_PROVIDERS` (added in 0.25.0) is removed too; its only user, the demo-seed image script, now holds
+  its one entry itself.
+
+### Changed
+- README: the AI section is replaced by a short section on the pf MCP server, and the commands table
+  lists `pf new workspace` and `pf pulumi`.
+
 ## [0.25.7] - 2026-10-09
 
 ### Fixed

package/README.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <code>pf</code> scaffolds real-world platforms: backend services, event-driven messaging, infrastructure. All wired together and kept in sync. <strong>AI-assisted.</strong>
+  <code>pf</code> scaffolds real-world platforms: backend services, event-driven messaging, infrastructure. All wired together and kept in sync.
 </p>
 
 
@@ -116,74 +116,47 @@ pf cloudevents publish order.created
 
 ---
 
-##  Commands
+## 🧰 Commands
 
 | Command | What it does |
 |:--------|:-------------|
 | `pf dev` | 🚀 Start development infrastructure (NATS) + all services in watch mode |
 | `pf new hono-micro <path>` | ⚡ Create a Hono service (lightweight, Bun-optimized) |
 | `pf new nest-micro <path>` | 🏢 Create a NestJS service (full-featured, decorators) |
+| `pf new workspace [name]` | 🏗️ Create a new workspace with infrastructure setup |
 | `pf cloudevents add <type> --service <path>` | 🔗 Add contract + handler + wire stream |
 | `pf cloudevents list` | 📋 List available events and consumers |
 | `pf cloudevents publish <type>` | 📤 Publish mock event to NATS |
 | `pf setup completion` | 🔧 Install shell autocompletion (zsh/bash) |
-| `pf setup ai` | 🤖 Configure AI provider for code generation |
 | `pf test` | 🧪 Run tests across the monorepo |
 | `pf build` | 📦 Build all packages and services |
 | `pf lint` | ✨ Lint and format with Biome |
 | `pf audit` | 🔒 Run security audit on dependencies |
+| `pf pulumi <args>` | ☁️ Run Pulumi in the workspace's `infra/` directory, e.g. `pf pulumi up` |
 
-> `pf` proxies all commands to Turborepo (works from any subdirectory). Extend via [custom commands and plugins](https://www.npmjs.com/package/@crossdelta/platform-sdk#configuration).
+> Your workspace can add its own commands: an entry under `pf.commands` in the root `package.json` (optionally with `cwd` and `command`), or any root `scripts` entry, runs as `pf <name>`. Plugins listed under `pf.plugins` add command groups, as `@crossdelta/cloudevents` does for `pf cloudevents`. The plugin interface is described in `docs/plugins.md` in the package source.
 
 ---
 
-## 🤖 AI-Assisted Generation
+## 🧩 Works with coding agents
 
-> **Optional but powerful.** Configure once, then use `--ai` with any generator.
+`@crossdelta/pf-mcp` is a [Model Context Protocol](https://github.com/modelcontextprotocol/typescript-sdk) server for the Platform SDK. It exposes four tools:
 
-```bash
-pf setup ai   # OpenAI or Anthropic
-
-pf new hono-micro services/notifications --ai \
-  -d "Send emails when orders are created"
-```
-
-The AI generates **convention-following code** tailored to your platform:
+| Tool | What it does |
+|:-----|:-------------|
+| `scan_workspace` | Scan the workspace for services, contracts, and configuration |
+| `generate_service` | Generate a plan for a new microservice (dry-run by default) |
+| `plan_review` | Validate a generation plan before applying |
+| `apply_changes` | Apply the changes from a generation plan |
 
-<table>
-<tr>
-<td>✅</td>
-<td><strong>Event contracts</strong> with Zod schemas in <code>packages/contracts/</code></td>
-</tr>
-<tr>
-<td>✅</td>
-<td><strong>Event handlers</strong> that auto-discover and consume from NATS</td>
-</tr>
-<tr>
-<td>✅</td>
-<td><strong>Use-cases/Services</strong> with business logic separated from handlers</td>
-</tr>
-<tr>
-<td>✅</td>
-<td><strong>Tests</strong> for use-cases with realistic scenarios</td>
-</tr>
-<tr>
-<td>✅</td>
-<td><strong>Type-safe:</strong> no <code>any</code>, proper imports, strict TypeScript</td>
-</tr>
-<tr>
-<td>✅</td>
-<td><strong>Lint-compliant:</strong> passes Biome formatting out of the box</td>
-</tr>
-</table>
+The server plans the structure; the agent writes the content. A service is created in this order: the agent calls `generate_service` with a prompt, receives a plan with files and a `planHash`, writes the code for those files, optionally calls `plan_review`, asks you to confirm, and then calls `apply_changes` with `expectedPlanHash`.
 
-**What makes it different:**
-- Uses your **existing contracts** when wiring events between services
-- Follows **framework-specific patterns** (Hono use-cases vs. NestJS Services)
-- Generates **only the code you need**, no bloat, no unused abstractions
-- **Hot-reload friendly:** `pf dev` automatically restarts when AI finishes
+```bash
+bun add @crossdelta/pf-mcp
+node ./node_modules/@crossdelta/pf-mcp/dist/cli.js --stdio
+```
 
-Works with OpenAI and Anthropic.
+The server talks over stdio, so the MCP client of your agent has to start that command. It also serves the generator guidelines from `docs/generators/` in the package source as the MCP resource `docs://generators`.
 
 ---