guardian-framework 0.1.22 → 0.1.23

package/dist/cli.js

@@ -1335,7 +1335,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.22", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.23", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {
@@ -1571,7 +1571,7 @@ var init_templates = __esm(() => {
   TEMPLATE_DIR = findTemplateDir();
   PI_TEMPLATE_DIR = path4.join(TEMPLATE_DIR, "pi");
   LANGUAGES_DIR = path4.join(TEMPLATE_DIR, "languages");
-  SUPPORTED_LANGUAGES = ["typescript", "rust", "python", "go", "java"];
+  SUPPORTED_LANGUAGES = ["typescript", "rust", "python", "go", "java", "nextjs", "angular"];
   AVAILABLE_VALIDATORS = [
     "ci",
     "tests",
@@ -1677,6 +1677,30 @@ var init_templates = __esm(() => {
       tracingPattern: "Micrometer Observation / SLF4j MDC",
       cancellationPattern: "Reactive Streams cancellation / @Async CompletableFuture",
       atomicWritePattern: "Spring Data CrudRepository.save()"
+    },
+    nextjs: {
+      buildCommand: "npm run build",
+      testCommand: "npm test",
+      lintCommand: "next lint",
+      formatCommand: "prettier --write .",
+      formatCheckCommand: "prettier --check .",
+      securityAuditCommand: "npm audit",
+      errorHandlingPattern: "Result type pattern (ok/error)",
+      tracingPattern: "Structured JSON logging with pino",
+      cancellationPattern: "AbortController pattern",
+      atomicWritePattern: "Write-rename with .tmp file"
+    },
+    angular: {
+      buildCommand: "ng build",
+      testCommand: "ng test --browsers ChromeHeadless --watch=false",
+      lintCommand: "ng lint",
+      formatCommand: "npx prettier --write .",
+      formatCheckCommand: "npx prettier --check .",
+      securityAuditCommand: "npm audit",
+      errorHandlingPattern: "HttpErrorResponse with typed error classes",
+      tracingPattern: "Angular HttpInterceptor with structured logging",
+      cancellationPattern: "RxJS Subscription.unsubscribe() / takeUntil",
+      atomicWritePattern: "Write-rename with .tmp file"
     }
   };
   GRADLE_COMMANDS = {
@@ -11030,6 +11054,8 @@ async function runInitPrompts() {
     message: "Select programming language",
     options: [
       { value: "typescript", label: "TypeScript/JavaScript (Bun)" },
+      { value: "nextjs", label: "Next.js (React)" },
+      { value: "angular", label: "Angular" },
       { value: "rust", label: "Rust" },
       { value: "python", label: "Python" },
       { value: "go", label: "Go" },

package/dist/exports.js

@@ -995,7 +995,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.22", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.23", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {
@@ -1231,7 +1231,7 @@ var init_templates = __esm(() => {
   TEMPLATE_DIR = findTemplateDir();
   PI_TEMPLATE_DIR = path2.join(TEMPLATE_DIR, "pi");
   LANGUAGES_DIR = path2.join(TEMPLATE_DIR, "languages");
-  SUPPORTED_LANGUAGES = ["typescript", "rust", "python", "go", "java"];
+  SUPPORTED_LANGUAGES = ["typescript", "rust", "python", "go", "java", "nextjs", "angular"];
   AVAILABLE_VALIDATORS = [
     "ci",
     "tests",
@@ -1337,6 +1337,30 @@ var init_templates = __esm(() => {
       tracingPattern: "Micrometer Observation / SLF4j MDC",
       cancellationPattern: "Reactive Streams cancellation / @Async CompletableFuture",
       atomicWritePattern: "Spring Data CrudRepository.save()"
+    },
+    nextjs: {
+      buildCommand: "npm run build",
+      testCommand: "npm test",
+      lintCommand: "next lint",
+      formatCommand: "prettier --write .",
+      formatCheckCommand: "prettier --check .",
+      securityAuditCommand: "npm audit",
+      errorHandlingPattern: "Result type pattern (ok/error)",
+      tracingPattern: "Structured JSON logging with pino",
+      cancellationPattern: "AbortController pattern",
+      atomicWritePattern: "Write-rename with .tmp file"
+    },
+    angular: {
+      buildCommand: "ng build",
+      testCommand: "ng test --browsers ChromeHeadless --watch=false",
+      lintCommand: "ng lint",
+      formatCommand: "npx prettier --write .",
+      formatCheckCommand: "npx prettier --check .",
+      securityAuditCommand: "npm audit",
+      errorHandlingPattern: "HttpErrorResponse with typed error classes",
+      tracingPattern: "Angular HttpInterceptor with structured logging",
+      cancellationPattern: "RxJS Subscription.unsubscribe() / takeUntil",
+      atomicWritePattern: "Write-rename with .tmp file"
     }
   };
   GRADLE_COMMANDS = {
@@ -9793,6 +9817,8 @@ async function runInitPrompts() {
     message: "Select programming language",
     options: [
       { value: "typescript", label: "TypeScript/JavaScript (Bun)" },
+      { value: "nextjs", label: "Next.js (React)" },
+      { value: "angular", label: "Angular" },
       { value: "rust", label: "Rust" },
       { value: "python", label: "Python" },
       { value: "go", label: "Go" },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.22",
+	"version": "0.1.23",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

package/templates/languages/angular-patterns.md

@@ -0,0 +1,38 @@
+# Angular Code Patterns
+
+> **Purpose:** Reusable Angular patterns for Guardian projects.
+> **Source:** Guardian DDD + Angular 18+ conventions.
+> **Framework:** Angular 18+ with standalone components.
+
+---
+
+## DDD Module Structure
+
+```
+module/
+├── domain/              # Pure business logic (framework-free)
+│   ├── entity.ts
+│   ├── value.ts
+│   └── errors.ts
+├── application/         # State stores, services, use cases
+│   ├── store.ts         # Signal-based store
+│   ├── service.ts       # Injectable service
+│   └── dto.ts
+├── infrastructure/      # External adapters
+│   ├── api-client.ts    # HTTP client wrapper
+│   └── storage.ts       # localStorage wrapper
+└── interfaces/          # UI Components
+    ├── component.ts     # Standalone component
+    └── page.component.ts
+```
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `ng serve` | Dev server |
+| `ng build` | Production build |
+| `ng test --watch=false` | Run tests (headless) |
+| `ng lint` | Lint |
+| `prettier --write .` | Format |
+| `npm audit` | Security audit |

package/templates/languages/nextjs-patterns.md

@@ -0,0 +1,39 @@
+# Next.js Code Patterns
+
+> **Purpose:** Reusable Next.js patterns for Guardian projects.
+> **Source:** Guardian DDD + Next.js App Router conventions.
+> **Framework:** Next.js 14+ with App Router.
+
+---
+
+## DDD Module Structure
+
+```
+module/
+├── domain/              # Pure business logic (framework-free)
+│   ├── entity.ts
+│   ├── value.ts
+│   └── errors.ts
+├── application/         # Server actions, state stores
+│   ├── store.ts         # Zustand store
+│   ├── actions.ts       # Server actions
+│   └── dto.ts
+├── infrastructure/      # External adapters
+│   ├── api-client.ts    # API calls (fetch, tRPC)
+│   └── storage.ts       # localStorage / cookies
+└── interfaces/          # UI Components
+    ├── page.tsx         # Next.js page
+    ├── component.tsx    # React component
+    └── layout.tsx       # Layout wrapper
+```
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `npm run dev` | Dev server |
+| `npm run build` | Production build |
+| `npm test` | Run tests |
+| `next lint` | Lint |
+| `prettier --write .` | Format |
+| `npm audit` | Security audit |

package/templates/pi/extensions/architect-lib/helpers.ts

@@ -238,6 +238,8 @@ export function codegenSkillName(language: string): string {
         "python": "python-codegen",
         "typescript": "typescript-codegen",
         "java": "java-codegen",
+        "nextjs": "nextjs-codegen",
+        "angular": "angular-codegen",
     };
     return map[language] || "typescript-codegen";
 }

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-03T07:30:24Z",
+  "timestamp": "2026-07-03T07:41:28Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/pi/scripts/ci/check_ddd_structure.sh

@@ -80,7 +80,9 @@ get_source_extensions() {
         typescript) echo "ts" ;;
         python) echo "py" ;;
         java) echo "java" ;;
-        *) echo "rs go ts py java" ;;
+        nextjs) echo "ts tsx" ;;
+        angular) echo "ts" ;;
+        *) echo "rs go ts py java tsx" ;;
     esac
 }
 

package/templates/pi/skills/agents/angular-codegen.md

@@ -0,0 +1,36 @@
+---
+name: angular-codegen
+description: Minimal skill for Angular code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Angular modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Angular Code Generation — DDD + Clean Architecture Patterns
+
+> Full reference: `.pi/skills/angular-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD for Angular |
+| Domain entities | Section 2 — Pure business logic, no Angular |
+| Application layer | Section 3 — Injectable services, Signal stores |
+| Infrastructure | Section 4 — HttpClient wrappers |
+| UI Components | Section 5 — Standalone components, control flow |
+| Testing | Section 6 — TestBed patterns |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (no Angular imports) |
+| `application/` | Services, stores | `domain/` |
+| `infrastructure/` | HTTP clients, adapters | `domain/` + `application/` |
+| `interfaces/` | Components, pages | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Domain layer has ZERO Angular imports
+- Use `inject()` for DI, never constructor injection
+- Use `signal()` over BehaviorSubject for state

package/templates/pi/skills/agents/nextjs-codegen.md

@@ -0,0 +1,34 @@
+---
+name: nextjs-codegen
+description: Minimal skill for Next.js code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Next.js modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Next.js Code Generation — DDD + Clean Architecture Patterns
+
+> Full reference: `.pi/skills/nextjs-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD for Next.js |
+| Domain entities | Section 2 — Pure business logic, no framework |
+| Application layer | Section 3 — Server actions, Zustand stores |
+| Infrastructure | Section 4 — API clients, storage adapters |
+| UI Components | Section 5 — App Router pages, client components |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (no Next.js imports) |
+| `application/` | Server actions, stores | `domain/` |
+| `infrastructure/` | API clients, adapters | `domain/` + `application/` |
+| `interfaces/` | Pages, components | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Domain layer has ZERO Next.js/React imports
+- Use `'use client'` only in interfaces/ layer

package/templates/pi/skills/angular-enterprise-codegen.md

@@ -0,0 +1,158 @@
+---
+name: angular-enterprise-codegen
+description: Full reference for Angular enterprise code generation with DDD + Clean Architecture. Covers module structure, services, Signal stores, standalone components, RxJS patterns, and testing. Loaded on-demand via agents/angular-codegen.md skill.
+---
+
+# Angular Enterprise Code Generation — DDD + Clean Architecture
+
+> Canonical skill for generating production-grade Angular code with DDD patterns.
+> All code MUST follow these patterns. Validators enforce compliance.
+
+---
+
+## 1. Project Structure
+
+```
+module/
+├── domain/              # Pure business logic, no Angular imports
+│   ├── entity.ts
+│   ├── value.ts
+│   └── errors.ts
+├── application/         # Injectable services, Signal stores
+│   ├── store.ts         # Signal-based state
+│   ├── service.ts       # @Injectable use case service
+│   └── dto.ts
+├── infrastructure/      # HTTP clients, localStorage adapters
+│   ├── api-client.ts    # HttpClient wrapper
+│   └── storage.ts
+└── interfaces/          # UI Components (standalone)
+    ├── component.ts
+    └── page.component.ts
+```
+
+### Dependency Rule
+```
+domain → application → infrastructure → interfaces
+```
+
+---
+
+## 2. Domain Layer
+
+```typescript
+// domain/entity.ts — No Angular imports
+export class Order {
+  private readonly _id: string;
+  private _status: OrderStatus = OrderStatus.PENDING;
+
+  constructor(id?: string) {
+    this._id = id ?? crypto.randomUUID();
+  }
+
+  get id(): string { return this._id; }
+  get status(): OrderStatus { return this._status; }
+
+  confirm(): void {
+    if (this._status !== OrderStatus.PENDING) {
+      throw new DomainError('INVALID_STATE', 'Only pending orders can be confirmed');
+    }
+    this._status = OrderStatus.CONFIRMED;
+  }
+}
+```
+
+---
+
+## 3. Application Layer
+
+```typescript
+// application/service.ts
+import { Injectable, signal } from '@angular/core';
+import { Order } from '../domain/entity';
+
+@Injectable({ providedIn: 'root' })
+export class OrderService {
+  private readonly orders = signal<Order[]>([]);
+  readonly orders$ = this.orders.asReadonly();
+
+  confirmOrder(id: string): void {
+    this.orders.update(items => {
+      const order = items.find(o => o.id === id);
+      if (!order) throw new DomainError('NOT_FOUND', 'Order not found');
+      order.confirm();
+      return [...items];
+    });
+  }
+}
+```
+
+---
+
+## 4. Infrastructure Layer
+
+```typescript
+// infrastructure/api-client.ts
+import { HttpClient } from '@angular/common/http';
+import { Injectable, inject } from '@angular/core';
+
+@Injectable({ providedIn: 'root' })
+export class OrderApiClient {
+  private readonly http = inject(HttpClient);
+
+  fetchOrders() {
+    return this.http.get<Order[]>('/api/orders');
+  }
+}
+```
+
+---
+
+## 5. Interfaces Layer (Components)
+
+```typescript
+// interfaces/order-list.component.ts
+import { Component, inject } from '@angular/core';
+import { OrderService } from '../application/service';
+
+@Component({
+  selector: 'app-order-list',
+  standalone: true,
+  template: `
+    <div>
+      @for (order of service.orders$(); track order.id) {
+        <div>{{ order.id }} - {{ order.status }}</div>
+      }
+    </div>
+  `,
+})
+export class OrderListComponent {
+  readonly service = inject(OrderService);
+}
+```
+
+---
+
+## 6. Testing
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { OrderService } from './service';
+
+describe('OrderService', () => {
+  let service: OrderService;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({});
+    service = TestBed.inject(OrderService);
+  });
+
+  it('should confirm order', () => {
+    // ... test using service.orders$()
+  });
+});
+```
+
+---
+
+*Version: 1.0.0*
+*Last updated: 2026-07-03*

package/templates/pi/skills/nextjs-enterprise-codegen.md

@@ -0,0 +1,138 @@
+---
+name: nextjs-enterprise-codegen
+description: Full reference for Next.js enterprise code generation with DDD + Clean Architecture. Covers module structure, server actions, Zustand stores, React components, and testing patterns. Loaded on-demand via agents/nextjs-codegen.md skill.
+---
+
+# Next.js Enterprise Code Generation — DDD + Clean Architecture
+
+> Canonical skill for generating production-grade Next.js code with DDD patterns.
+> All code MUST follow these patterns. Validators enforce compliance.
+
+---
+
+## 1. Project Structure
+
+```
+module/
+├── domain/              # Pure business logic, no framework dependencies
+│   ├── entity.ts
+│   ├── value.ts
+│   └── errors.ts
+├── application/         # Server actions, state stores, use cases
+│   ├── store.ts         # Zustand store (client state)
+│   ├── actions.ts       # Server Actions (Next.js 14+)
+│   └── dto.ts
+├── infrastructure/      # API clients, localStorage adapters
+│   ├── api-client.ts
+│   └── storage.ts
+└── interfaces/          # UI Components (Next.js App Router)
+    ├── page.tsx
+    ├── component.tsx
+    └── layout.tsx
+```
+
+### Dependency Rule
+```
+domain → application → infrastructure → interfaces
+```
+
+---
+
+## 2. Domain Layer
+
+```typescript
+// domain/entity.ts — Pure business logic, no React/Next.js imports
+export class Cart {
+  private readonly _id: string;
+  private _items: CartItem[] = [];
+
+  constructor(id?: string) {
+    this._id = id ?? crypto.randomUUID();
+  }
+
+  get id(): string { return this._id; }
+  get items(): readonly CartItem[] { return this._items; }
+  get total(): Money { return this._items.reduce((sum, i) => sum.add(i.subtotal), Money.ZERO); }
+
+  addItem(product: Product, quantity: number): void {
+    const existing = this._items.find(i => i.productId === product.id);
+    if (existing) {
+      existing.increaseQuantity(quantity);
+    } else {
+      this._items.push(new CartItem(product, quantity));
+    }
+  }
+}
+```
+
+---
+
+## 3. Application Layer
+
+```typescript
+// application/store.ts — Zustand store
+import { create } from 'zustand';
+import { Cart } from '../domain/entity';
+
+interface CartStore {
+  cart: Cart | null;
+  isLoading: boolean;
+  addItem: (productId: string, quantity: number) => Promise<void>;
+}
+
+export const useCartStore = create<CartStore>((set) => ({
+  cart: null,
+  isLoading: false,
+  addItem: async (productId, quantity) => {
+    set({ isLoading: true });
+    // ... domain logic
+    set({ isLoading: false });
+  },
+}));
+```
+
+---
+
+## 4. Infrastructure Layer
+
+```typescript
+// infrastructure/api-client.ts
+export class CartApiClient {
+  async fetchCart(cartId: string): Promise<Cart> {
+    const res = await fetch(`/api/cart/${cartId}`);
+    if (!res.ok) throw new ApiError('Failed to fetch cart', res.status);
+    return res.json();
+  }
+}
+```
+
+---
+
+## 5. Interfaces Layer (Components)
+
+```typescript
+// interfaces/cart-page.tsx
+'use client';
+import { useCartStore } from '../application/store';
+
+export default function CartPage() {
+  const { cart, isLoading } = useCartStore();
+
+  if (isLoading) return <div>Loading...</div>;
+  if (!cart) return <div>Cart is empty</div>;
+
+  return (
+    <div>
+      <h1>Shopping Cart</h1>
+      {cart.items.map(item => (
+        <CartItem key={item.id} item={item} />
+      ))}
+    </div>
+  );
+}
+```
+
+---
+
+*Version: 1.0.0*
+*Last updated: 2026-07-03*