@crossdelta/platform-sdk 0.8.4 → 0.8.21

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

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

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

@@ -10,7 +10,6 @@ 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.
@@ -61,7 +60,8 @@ Always generate **minimal diffs**, never full rewrites.
 When working with specific service types or packages, refer to these detailed guidelines:
 
 ### Service Generation & Architecture
-- [CLI Service Generator](../packages/platform-sdk/docs/generators/service.md) - AI code generation rules
+- [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
 
 ### Key Packages
 - [@crossdelta/cloudevents](../packages/cloudevents/README.md) - Event handling with NATS and CloudEvents

package/install.sh

@@ -11,15 +11,15 @@ NC='\033[0m'
 
 printf "${CYAN}"
 cat << "EOF"
-             ______
+             ______ 
             / ____/
-    ____   / /_
-   / __ \ / __/
-  / /_/ // /
- / .___//_/
-/_/
-
-@crossdelta/platform-sdk installer
+    ____   / /_    
+   / __ \ / __/    
+  / /_/ // /       
+ / .___//_/        
+/_/                
+  
+  @crossdelta/platform-sdk installer
 EOF
 printf "${NC}\n"
 
@@ -44,28 +44,28 @@ detect_or_install_package_manager() {
     echo "npm"
     return 0
   fi
-
+  
   # No package manager found - ask user for permission
   printf "${YELLOW}No package manager found (bun, pnpm, yarn, npm).${NC}\n"
   printf "${YELLOW}To use @crossdelta/platform-sdk, we recommend installing Bun (fast JavaScript runtime).${NC}\n"
   printf "\n"
   read -p "Do you want to install Bun now? (y/n) " -n 1 -r
   printf "\n"
-
+  
   if [[ ! $REPLY =~ ^[Yy]$ ]]; then
     printf "${RED}Installation cancelled. Please install Bun or another package manager manually.${NC}\n"
     printf "${BLUE}Visit: https://bun.sh${NC}\n"
     exit 1
   fi
-
+  
   # Install Bun
   printf "${BLUE}Installing Bun...${NC}\n"
   curl -fsSL https://bun.sh/install | bash
-
+  
   # Load Bun into current shell
   export BUN_INSTALL="$HOME/.bun"
   export PATH="$BUN_INSTALL/bin:$PATH"
-
+  
   printf "${GREEN}✓${NC} Bun installed successfully\n"
   echo "bun"
 }
@@ -117,7 +117,7 @@ if [ $# -eq 0 ]; then
 else
   # Arguments provided: Run pf command directly
   PF_ARGS=()
-
+  
   while [[ $# -gt 0 ]]; do
     case $1 in
       -h|--help)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.8.4",
+  "version": "0.8.21",
   "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/docs/generators/**",
+    "bin/**/instructions/**",
     "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/docs/generators && cp -r docs/generators/* bin/docs/generators/",
+    "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: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",

package/bin/docs/generators/README.md

@@ -1,47 +0,0 @@
-# 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 |