@crossdelta/platform-sdk 0.8.21 → 0.8.32

package/bin/docs/generators/README.md

@@ -0,0 +1,47 @@
+# Generator Documentation
+
+This directory contains AI instructions for code generators.
+
+## Structure
+
+```
+generators/
+├── README.md           # This file
+└── service.md          # Service generator instructions
+```
+
+## How Instructions Are Loaded
+
+The AI service generator loads instructions in priority order (most specific first):
+
+1. **Generator-specific** (`packages/platform-sdk/docs/generators/service.md`)
+   - Detailed rules for the service generator output format
+   - Event consumer/publisher workflows
+   - File structure requirements
+
+2. **Copilot instructions** (`.github/copilot-instructions.md`)
+   - Project-wide coding standards
+   - Code style rules
+   - Package-specific guidelines
+
+3. **Project AI guidelines** (`docs/ai-guidelines.md`)
+   - General architectural principles
+   - Validation patterns
+   - Testing guidelines
+
+## Adding New Generators
+
+To add instructions for a new generator:
+
+1. Create `<generator-name>.md` in this directory
+2. Update `INSTRUCTION_FILES` in `ai-service-generator.ts` if needed
+3. Follow the existing format from `service.md`
+
+## Template Variables
+
+The following variables are replaced at runtime:
+
+| Variable | Description |
+|----------|-------------|
+| `{{scope}}` | Package scope (e.g., `@orderboss`) |
+| `{{AVAILABLE_CONTRACTS}}` | Auto-generated list of existing contracts |

package/bin/{services/ai/instructions/ai-instructions.md → docs/generators/service.md}

@@ -1,4 +1,4 @@
-# AI Generation Rules for CLI Code Output
+# Service Generator Instructions
 
 These rules define how AI-generated scaffolded services must be structured.
 
@@ -88,7 +88,7 @@ consumeJetStreamEvents({
 
 ---
 
-# 1. Commands Block (REQUIRED - MUST BE FIRST)
+## Commands Block (REQUIRED - MUST BE FIRST)
 
 ```commands
 pf new hono-micro services/my-service -y
@@ -99,7 +99,7 @@ pf new hono-micro services/my-service -y
 
 ---
 
-# 2. Post-Generation Commands
+## Post-Generation Commands
 
 For Event Consumer services:
 
@@ -111,7 +111,7 @@ pf event add <event.type> --service services/my-service
 
 ---
 
-# 3. Dependencies Block
+## Dependencies Block
 
 Only include packages not in the scaffold:
 
@@ -124,7 +124,7 @@ zod
 
 ---
 
-# 4. Required Files
+## Required Files
 
 **Event Consumer:**
 ```
@@ -159,16 +159,9 @@ services/my-service/
 
 ---
 
-# 5. Code Style
+## Service Types
 
-- Biome-compatible, strict TS, arrow functions only
-- No semicolons, minimal comments, alphabetized imports
-
----
-
-# 6. Service Types
-
-## 📤 Event Publisher (REST API)
+### 📤 Event Publisher (REST API)
 
 **Keywords:** "publishes", "creates", "manages", "REST API"
 
@@ -189,19 +182,19 @@ app.post('/orders', async (c) => {
 Bun.serve({ port: 4001, fetch: app.fetch })
 ```
 
-## 📥 Event Consumer (NATS)
+### 📥 Event Consumer (NATS)
 
 **Keywords:** "consumes", "listens to", "reacts to", "handles events"
 
-See 4-Step Workflow above.
+See 3-Step Workflow above.
 
-## 🔄 Hybrid (Both)
+### 🔄 Hybrid (Both)
 
 Combines REST endpoints + NATS consumer.
 
 ---
 
-# 7. Use-Case Rules
+## Use-Case Rules
 
 - Live in `src/use-cases/*.use-case.ts`
 - Pure functions, no framework imports
@@ -226,7 +219,7 @@ export const processOrder = async (
 
 ---
 
-# 8. Testing Rules
+## Testing Rules
 
 - Test ONLY use-cases
 - Use `import { describe, expect, it } from 'bun:test'`
@@ -248,7 +241,7 @@ describe('Process Order', () => {
 
 ---
 
-# 9. Absolute Rules
+## Absolute Rules
 
 **DO NOT:**
 - Generate full rewrites

package/bin/templates/workspace/.github/copilot-instructions.md.hbs

@@ -10,6 +10,7 @@ Always generate **minimal diffs**, never full rewrites.
 - Analyze only the opened file unless explicitly asked.
 - Follow existing architecture and naming conventions.
 - Prefer strict typing; avoid `any`.
+- **Reuse existing code**: Before implementing new functionality, search the codebase for existing functions, utilities, or services that can be reused. Avoid duplicating logic.
 
 ## Code Style
 - Single quotes, no semicolons, 2-space indent, trailing commas.
@@ -60,8 +61,7 @@ Always generate **minimal diffs**, never full rewrites.
 When working with specific service types or packages, refer to these detailed guidelines:
 
 ### Service Generation & Architecture
-- [Service Architecture Guidelines](../docs/generators/services/architecture-guidelines.md) - General patterns for all services
-- [Hono Microservice Guidelines](../docs/generators/services/hono-micro-guidelines.md) - Event-driven Hono patterns
+- [CLI Service Generator](../packages/platform-sdk/docs/generators/service.md) - AI code generation rules
 
 ### Key Packages
 - [@crossdelta/cloudevents](../packages/cloudevents/README.md) - Event handling with NATS and CloudEvents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.8.21",
+  "version": "0.8.32",
   "description": "Platform toolkit for event-driven microservices — keeping code and infrastructure in lockstep.",
   "keywords": [
     "cli",
@@ -29,7 +29,7 @@
   "files": [
     "bin/**/*.js",
     "bin/**/templates/**",
-    "bin/**/instructions/**",
+    "bin/docs/generators/**",
     "bin/**/*.json",
     "!bin/**/*.map",
     "dist/",
@@ -51,7 +51,7 @@
   "scripts": {
     "start:dev": "node esbuild.config.mjs --watch",
     "build:cli": "node esbuild.config.mjs",
-    "build:cli:copy": "cp cli/integration.collection.json bin/integration.collection.json && rm -rf bin/templates && mkdir -p bin/templates && cp -r cli/src/commands/create/workspace/templates bin/templates/workspace && cp -r cli/src/commands/create/hono-microservice/templates bin/templates/hono-microservice && cp -r cli/src/commands/create/nest-microservice/templates bin/templates/nest-microservice && mkdir -p bin/services/ai/instructions && cp cli/src/services/ai/instructions/ai-instructions.md bin/services/ai/instructions/",
+    "build:cli:copy": "cp cli/integration.collection.json bin/integration.collection.json && rm -rf bin/templates && mkdir -p bin/templates && cp -r cli/src/commands/create/workspace/templates bin/templates/workspace && cp -r cli/src/commands/create/hono-microservice/templates bin/templates/hono-microservice && cp -r cli/src/commands/create/nest-microservice/templates bin/templates/nest-microservice && mkdir -p bin/docs/generators && cp -r docs/generators/* bin/docs/generators/",
     "build:schematics:transpile": "tsc --project tsconfig.schematics.json",
     "build:schematics:copy": "cp -R schematics/* dist/schematics && find dist/schematics -name '*.ts' -delete",
     "build:schematics": "npm run build:schematics:transpile && npm run build:schematics:copy",