@crossdelta/platform-sdk 0.7.1 → 0.7.2

package/bin/services/ai/instructions/ai-instructions.md

@@ -2,6 +2,20 @@
 
 These rules define how AI-generated scaffolded services must be structured when produced by CLI tools.
 
+## ⚠️ CRITICAL: Code Quality Guidelines
+
+**NEVER invent APIs, package names, or TypeScript types:**
+- ✅ **Research actual package documentation** before using third-party libraries
+- ✅ **Verify TypeScript types** match the actual library's type definitions
+- ✅ **Check npm registry** to confirm package names exist
+- ❌ **DO NOT hallucinate** API methods, properties, or function signatures
+- ❌ **DO NOT guess** at type structures - look them up or use `any` with a TODO comment
+
+**When unsure:**
+1. Use well-known, battle-tested packages (e.g., `@pusher/push-notifications-server`, not `pusher-beams`)
+2. Keep code simple and explicit
+3. Add TODO comments for unverified APIs: `// TODO: Verify this API signature`
+
 ---
 
 # 1. Commands Block (REQUIRED - MUST BE FIRST)
@@ -61,7 +75,8 @@ Rules:
 - One package per line.
 - No versions.
 - Only packages not included in the scaffold.
-- **CRITICAL:** Only use packages that actually exist on npm. Verify package names are correct (e.g., `@pusher/push-notifications-server` not `pusher-beams`). When unsure, use well-known, established packages.
+- **CRITICAL:** Only use packages that actually exist on npm. **Verify package names on npmjs.com** before using them (e.g., `@pusher/push-notifications-server` not `pusher-beams`).
+- **TypeScript safety:** Ensure your code respects the actual TypeScript types exported by the package. Do not invent properties or methods.
 - **IMPORTANT:** Workspace packages (like `{{scope}}/contracts`) are automatically detected and installed with `workspace:*` protocol. Just list the package name without version.
 
 ### Core Package Names (ALWAYS USE THESE EXACT NAMES)
@@ -195,7 +210,7 @@ Bun.serve({ port, fetch: app.fetch })
 ```ts
 import '@crossdelta/telemetry'
 
-import { consumeJetStreamEvents } from '@crossdelta/cloudevents'
+import { consumeJetStreamEvents, ensureJetStreamStream } from '@crossdelta/cloudevents'
 import { Hono } from 'hono'
 
 const port = Number(process.env.PORT || process.env.MY_SERVICE_PORT) || 4003
@@ -203,17 +218,28 @@ const app = new Hono()
 
 app.get('/health', (c) => c.json({ status: 'ok' }))
 
+Bun.serve({ port, fetch: app.fetch })
+
+// Ensure stream exists (idempotent - safe to call on every start)
+await ensureJetStreamStream({
+  stream: 'ORDERS',
+  subjects: ['orders.>'],
+})
+
 // Start NATS consumer - handlers are auto-discovered
 consumeJetStreamEvents({
   stream: 'ORDERS',
   consumer: 'my-service',
   discover: './src/events/**/*.event.ts',
 })
-
-Bun.serve({ port, fetch: app.fetch })
 ```
 
-**IMPORTANT:** Do NOT include `subjects` parameter in `consumeJetStreamEvents` - it's not supported.
+**CRITICAL:** 
+- MUST call `ensureJetStreamStream()` BEFORE `consumeJetStreamEvents()` 
+- MUST use top-level await (Bun supports this)
+- `ensureJetStreamStream()` uses `subjects` parameter (stream-level: what goes INTO the stream)
+- `consumeJetStreamEvents()` uses `filterSubjects` parameter (consumer-level: what THIS consumer reads)
+- Do NOT confuse `subjects` (stream) with `filterSubjects` (consumer)
 
 ### � HTTP CloudEvent Receiver (Receives CloudEvents via HTTP POST)
 

package/bin/templates/workspace/packages/contracts/package.json.hbs

@@ -9,7 +9,7 @@
     }
   },
   "dependencies": {
-    "@crossdelta/cloudevents": "^0.3.4",
+    "@crossdelta/cloudevents": "^0.4.0",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/install.sh

@@ -83,16 +83,16 @@ if [ $# -eq 0 ]; then
 
   case $PM in
     bun)
-      bun add -g @crossdelta/platform-sdk
+      bun add -g @crossdelta/platform-sdk --silent 2>&1 | grep -v "deprecated\|peer dependencies\|unmet peer" || true
       ;;
     pnpm)
-      pnpm add -g @crossdelta/platform-sdk
+      pnpm add -g @crossdelta/platform-sdk --reporter=silent 2>&1 || true
       ;;
     yarn)
-      yarn global add @crossdelta/platform-sdk
+      yarn global add @crossdelta/platform-sdk --silent 2>&1 || true
       ;;
     npm)
-      npm install -g @crossdelta/platform-sdk
+      npm install -g @crossdelta/platform-sdk --silent 2>&1 || true
       ;;
   esac
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.7.1",
-  "description": "Your AI-powered platform engineer. Scaffold complete Turborepo workspaces, generate microservice boilerplate with natural language, and deploy to the cloud — all from one CLI.",
+  "version": "0.7.2",
+  "description": "Your AI-powered platform engineer. Scaffold complete Turborepo workspaces, generate microservice boilerplate with natural language, and deploy to the cloud — all from one CLI",
   "keywords": [
     "cli",
     "scaffolding",