@defai.digital/cli 13.4.4 → 13.4.5

package/bundled/templates/monorepo/contract-index.ts.hbs

@@ -0,0 +1,7 @@
+/**
+ * {{pascalCase domainName}} Contracts v1
+ *
+ * @module {{scope}}/contracts/{{domainName}}/v1
+ */
+
+export * from './schema.js';

package/bundled/templates/monorepo/contract-test.ts.hbs

@@ -0,0 +1,130 @@
+/**
+ * {{pascalCase domainName}} Contract Tests
+ *
+ * Tests schema validation and invariant enforcement.
+ */
+
+import { describe, it, expect } from 'vitest';
+import {
+  {{pascalCase domainName}}Schema,
+  {{pascalCase domainName}}IdSchema,
+  {{pascalCase domainName}}StatusSchema,
+  {{pascalCase domainName}}EventSchema,
+  validate{{pascalCase domainName}},
+} from '{{scope}}/contracts/{{domainName}}';
+
+describe('{{pascalCase domainName}} Contracts', () => {
+  // ==========================================================================
+  // INV-{{upperCase (substring domainName 0 3)}}-001: Valid ID Format
+  // ==========================================================================
+  describe('INV-{{upperCase (substring domainName 0 3)}}-001: Valid ID Format', () => {
+    it('accepts valid UUID v4', () => {
+      const validId = '550e8400-e29b-41d4-a716-446655440000';
+      expect({{pascalCase domainName}}IdSchema.safeParse(validId).success).toBe(true);
+    });
+
+    it('rejects invalid UUID', () => {
+      const invalidIds = ['', 'not-a-uuid', '12345', null, undefined];
+      for (const id of invalidIds) {
+        expect({{pascalCase domainName}}IdSchema.safeParse(id).success).toBe(false);
+      }
+    });
+  });
+
+  // ==========================================================================
+  // INV-{{upperCase (substring domainName 0 3)}}-002: Valid Status
+  // ==========================================================================
+  describe('INV-{{upperCase (substring domainName 0 3)}}-002: Valid Status', () => {
+    it('accepts valid status values', () => {
+      const validStatuses = ['draft', 'active', 'completed', 'cancelled'];
+      for (const status of validStatuses) {
+        expect({{pascalCase domainName}}StatusSchema.safeParse(status).success).toBe(true);
+      }
+    });
+
+    it('rejects invalid status', () => {
+      const invalidStatuses = ['', 'pending', 'done', 'ACTIVE', null];
+      for (const status of invalidStatuses) {
+        expect({{pascalCase domainName}}StatusSchema.safeParse(status).success).toBe(false);
+      }
+    });
+  });
+
+  // ==========================================================================
+  // Schema Validation
+  // ==========================================================================
+  describe('{{pascalCase domainName}}Schema', () => {
+    const validEntity = {
+      id: '550e8400-e29b-41d4-a716-446655440000',
+      status: 'draft',
+      createdAt: '2024-01-01T00:00:00.000Z',
+      updatedAt: '2024-01-01T00:00:00.000Z',
+    };
+
+    it('accepts valid entity', () => {
+      expect({{pascalCase domainName}}Schema.safeParse(validEntity).success).toBe(true);
+    });
+
+    it('rejects entity with missing required fields', () => {
+      const { id, ...withoutId } = validEntity;
+      expect({{pascalCase domainName}}Schema.safeParse(withoutId).success).toBe(false);
+    });
+
+    it('rejects entity with invalid datetime', () => {
+      const invalidEntity = { ...validEntity, createdAt: 'not-a-date' };
+      expect({{pascalCase domainName}}Schema.safeParse(invalidEntity).success).toBe(false);
+    });
+  });
+
+  // ==========================================================================
+  // Event Schema Validation
+  // ==========================================================================
+  describe('{{pascalCase domainName}}EventSchema', () => {
+    it('accepts created event', () => {
+      const event = {
+        type: '{{domainName}}.created',
+        {{domainName}}Id: '550e8400-e29b-41d4-a716-446655440000',
+        occurredAt: '2024-01-01T00:00:00.000Z',
+      };
+      expect({{pascalCase domainName}}EventSchema.safeParse(event).success).toBe(true);
+    });
+
+    it('accepts updated event', () => {
+      const event = {
+        type: '{{domainName}}.updated',
+        {{domainName}}Id: '550e8400-e29b-41d4-a716-446655440000',
+        occurredAt: '2024-01-01T00:00:00.000Z',
+      };
+      expect({{pascalCase domainName}}EventSchema.safeParse(event).success).toBe(true);
+    });
+
+    it('rejects unknown event type', () => {
+      const event = {
+        type: '{{domainName}}.deleted',
+        {{domainName}}Id: '550e8400-e29b-41d4-a716-446655440000',
+        occurredAt: '2024-01-01T00:00:00.000Z',
+      };
+      expect({{pascalCase domainName}}EventSchema.safeParse(event).success).toBe(false);
+    });
+  });
+
+  // ==========================================================================
+  // Validate Function
+  // ==========================================================================
+  describe('validate{{pascalCase domainName}}', () => {
+    it('returns parsed entity for valid data', () => {
+      const data = {
+        id: '550e8400-e29b-41d4-a716-446655440000',
+        status: 'active',
+        createdAt: '2024-01-01T00:00:00.000Z',
+        updatedAt: '2024-01-02T00:00:00.000Z',
+      };
+      const result = validate{{pascalCase domainName}}(data);
+      expect(result).toEqual(data);
+    });
+
+    it('throws ZodError for invalid data', () => {
+      expect(() => validate{{pascalCase domainName}}({})).toThrow();
+    });
+  });
+});

package/bundled/templates/monorepo/contracts-package.json.hbs

@@ -0,0 +1,29 @@
+{
+  "name": "{{scope}}/contracts",
+  "version": "1.0.0",
+  "description": "Contract schemas for {{projectName}}",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./{{domainName}}": {
+      "import": "./dist/{{domainName}}/v1/index.js",
+      "types": "./dist/{{domainName}}/v1/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  }
+}

package/bundled/templates/monorepo/domain-index.ts.hbs

@@ -0,0 +1,115 @@
+/**
+ * {{pascalCase domainName}} Domain Implementation
+ *
+ * @module {{scope}}/{{domainName}}-domain
+ */
+
+import {
+  type {{pascalCase domainName}},
+  type {{pascalCase domainName}}Id,
+  type {{pascalCase domainName}}Status,
+  {{pascalCase domainName}}Schema,
+  {{pascalCase domainName}}ErrorCode,
+} from '{{scope}}/contracts/{{domainName}}';
+
+// ============================================================================
+// Repository Interface
+// ============================================================================
+
+export interface {{pascalCase domainName}}Repository {
+  findById(id: {{pascalCase domainName}}Id): Promise<{{pascalCase domainName}} | null>;
+  save(entity: {{pascalCase domainName}}): Promise<void>;
+  delete(id: {{pascalCase domainName}}Id): Promise<boolean>;
+}
+
+// ============================================================================
+// Service Implementation
+// ============================================================================
+
+export class {{pascalCase domainName}}Service {
+  constructor(private readonly repository: {{pascalCase domainName}}Repository) {}
+
+  async getById(id: {{pascalCase domainName}}Id): Promise<{{pascalCase domainName}}> {
+    const entity = await this.repository.findById(id);
+    if (!entity) {
+      throw new {{pascalCase domainName}}NotFoundError(id);
+    }
+    return entity;
+  }
+
+  async create(data: Omit<{{pascalCase domainName}}, 'id' | 'createdAt' | 'updatedAt'>): Promise<{{pascalCase domainName}}> {
+    const now = new Date().toISOString();
+    const entity: {{pascalCase domainName}} = {
+      ...data,
+      id: crypto.randomUUID(),
+      createdAt: now,
+      updatedAt: now,
+    };
+
+    // Validate against schema
+    {{pascalCase domainName}}Schema.parse(entity);
+
+    await this.repository.save(entity);
+    return entity;
+  }
+
+  async updateStatus(id: {{pascalCase domainName}}Id, newStatus: {{pascalCase domainName}}Status): Promise<{{pascalCase domainName}}> {
+    const entity = await this.getById(id);
+
+    // INV-{{upperCase (substring domainName 0 3)}}-101: Validate status transition
+    this.validateStatusTransition(entity.status, newStatus);
+
+    const updated: {{pascalCase domainName}} = {
+      ...entity,
+      status: newStatus,
+      updatedAt: new Date().toISOString(),
+    };
+
+    await this.repository.save(updated);
+    return updated;
+  }
+
+  private validateStatusTransition(
+    currentStatus: {{pascalCase domainName}}Status,
+    newStatus: {{pascalCase domainName}}Status
+  ): void {
+    const validTransitions: Record<{{pascalCase domainName}}Status, {{pascalCase domainName}}Status[]> = {
+      draft: ['active', 'cancelled'],
+      active: ['completed', 'cancelled'],
+      completed: [],
+      cancelled: [],
+    };
+
+    if (!validTransitions[currentStatus].includes(newStatus)) {
+      throw new {{pascalCase domainName}}InvalidStatusError(currentStatus, newStatus);
+    }
+  }
+}
+
+// ============================================================================
+// Domain Errors
+// ============================================================================
+
+export class {{pascalCase domainName}}NotFoundError extends Error {
+  readonly code = {{pascalCase domainName}}ErrorCode.NOT_FOUND;
+
+  constructor(id: {{pascalCase domainName}}Id) {
+    super(`{{pascalCase domainName}} not found: ${id}`);
+    this.name = '{{pascalCase domainName}}NotFoundError';
+  }
+}
+
+export class {{pascalCase domainName}}InvalidStatusError extends Error {
+  readonly code = {{pascalCase domainName}}ErrorCode.INVALID_STATUS;
+
+  constructor(currentStatus: {{pascalCase domainName}}Status, newStatus: {{pascalCase domainName}}Status) {
+    super(`Invalid status transition: ${currentStatus} → ${newStatus}`);
+    this.name = '{{pascalCase domainName}}InvalidStatusError';
+  }
+}
+
+// ============================================================================
+// Re-exports
+// ============================================================================
+
+export type { {{pascalCase domainName}}, {{pascalCase domainName}}Id, {{pascalCase domainName}}Status };

package/bundled/templates/monorepo/domain-package.json.hbs

@@ -0,0 +1,27 @@
+{
+  "name": "{{scope}}/{{domainName}}-domain",
+  "version": "1.0.0",
+  "description": "{{pascalCase domainName}} domain implementation for {{projectName}}",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "{{scope}}/contracts": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}

package/bundled/templates/monorepo/gitignore.hbs

@@ -0,0 +1,32 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+*.tsbuildinfo
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# Test coverage
+coverage/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# AutomatosX data
+.automatosx/

package/bundled/templates/monorepo/invariants.md.hbs

@@ -0,0 +1,43 @@
+# {{pascalCase domainName}} Domain Invariants
+
+## Overview
+
+This document defines the behavioral invariants for the {{pascalCase domainName}} domain.
+
+## Schema Invariants
+
+### INV-{{upperCase (substring domainName 0 3)}}-001: Valid ID Format
+{{pascalCase domainName}} ID MUST be a valid UUID v4.
+- **Enforcement**: schema
+- **Test**: `z.string().uuid()` rejects invalid UUIDs
+
+### INV-{{upperCase (substring domainName 0 3)}}-002: Valid Status
+Status MUST be one of the defined enum values.
+- **Enforcement**: schema
+- **Test**: `z.enum([...])` rejects invalid values
+
+## Runtime Invariants
+
+### INV-{{upperCase (substring domainName 0 3)}}-101: Status Transitions
+Status transitions MUST follow the defined state machine.
+- **Enforcement**: runtime
+- **Valid Transitions**:
+  ```
+  draft     → active, cancelled
+  active    → completed, cancelled
+  completed → (terminal)
+  cancelled → (terminal)
+  ```
+
+### INV-{{upperCase (substring domainName 0 3)}}-102: Timestamp Consistency
+UpdatedAt MUST be >= CreatedAt.
+- **Enforcement**: runtime
+- **Test**: Update with earlier timestamp → error
+
+## Business Invariants
+
+### INV-{{upperCase (substring domainName 0 3)}}-201: [Business Rule]
+[Description]
+- **Enforcement**: [schema|runtime|test]
+- **Test**: [Verification method]
+- **Owner**: [Team]

package/bundled/templates/monorepo/package.json.hbs

@@ -0,0 +1,28 @@
+{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "description": "Contract-first monorepo for {{domainName}} domain",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@8.15.0",
+  {{#if author}}
+  "author": "{{author}}",
+  {{/if}}
+  "scripts": {
+    "build": "pnpm -r build",
+    "clean": "pnpm -r clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "pnpm -r typecheck",
+    "lint": "eslint . --ext .ts,.tsx",
+    "lint:fix": "eslint . --ext .ts,.tsx --fix"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0",
+    "eslint": "^8.55.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0"
+  }
+}

package/bundled/templates/monorepo/pnpm-workspace.yaml.hbs

@@ -0,0 +1,5 @@
+packages:
+  - 'packages/*'
+  - 'packages/contracts'
+  - 'packages/core/*'
+  - 'packages/adapters/*'

package/bundled/templates/monorepo/schema.ts.hbs

@@ -0,0 +1,82 @@
+/**
+ * {{pascalCase domainName}} Domain Contracts v1
+ *
+ * @module {{scope}}/contracts/{{domainName}}/v1
+ */
+
+import { z } from 'zod';
+
+// ============================================================================
+// Value Objects
+// ============================================================================
+
+export const {{pascalCase domainName}}IdSchema = z.string().uuid();
+export type {{pascalCase domainName}}Id = z.infer<typeof {{pascalCase domainName}}IdSchema>;
+
+// ============================================================================
+// Enums
+// ============================================================================
+
+export const {{pascalCase domainName}}StatusSchema = z.enum([
+  'draft',
+  'active',
+  'completed',
+  'cancelled',
+]);
+export type {{pascalCase domainName}}Status = z.infer<typeof {{pascalCase domainName}}StatusSchema>;
+
+// ============================================================================
+// Entities
+// ============================================================================
+
+/**
+ * {{pascalCase domainName}} entity - Aggregate Root
+ *
+ * Invariants:
+ * - INV-{{upperCase (substring domainName 0 3)}}-001: ID must be valid UUID
+ * - INV-{{upperCase (substring domainName 0 3)}}-002: Status must be valid
+ */
+export const {{pascalCase domainName}}Schema = z.object({
+  id: {{pascalCase domainName}}IdSchema,
+  status: {{pascalCase domainName}}StatusSchema,
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+});
+
+export type {{pascalCase domainName}} = z.infer<typeof {{pascalCase domainName}}Schema>;
+
+// ============================================================================
+// Domain Events
+// ============================================================================
+
+export const {{pascalCase domainName}}EventSchema = z.discriminatedUnion('type', [
+  z.object({
+    type: z.literal('{{domainName}}.created'),
+    {{domainName}}Id: {{pascalCase domainName}}IdSchema,
+    occurredAt: z.string().datetime(),
+  }),
+  z.object({
+    type: z.literal('{{domainName}}.updated'),
+    {{domainName}}Id: {{pascalCase domainName}}IdSchema,
+    occurredAt: z.string().datetime(),
+  }),
+]);
+
+export type {{pascalCase domainName}}Event = z.infer<typeof {{pascalCase domainName}}EventSchema>;
+
+// ============================================================================
+// Validation
+// ============================================================================
+
+export function validate{{pascalCase domainName}}(data: unknown): {{pascalCase domainName}} {
+  return {{pascalCase domainName}}Schema.parse(data);
+}
+
+// ============================================================================
+// Error Codes
+// ============================================================================
+
+export const {{pascalCase domainName}}ErrorCode = {
+  NOT_FOUND: '{{upperCase (substring domainName 0 3)}}_NOT_FOUND',
+  INVALID_STATUS: '{{upperCase (substring domainName 0 3)}}_INVALID_STATUS',
+} as const;

package/bundled/templates/monorepo/template.json

@@ -0,0 +1,106 @@
+{
+  "name": "monorepo",
+  "displayName": "Contract-First Monorepo",
+  "description": "A monorepo structure with contracts, core domains, and adapters",
+  "version": "1.0.0",
+  "category": "project",
+  "variables": {
+    "projectName": {
+      "type": "string",
+      "description": "Project name (kebab-case)",
+      "required": true,
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "scope": {
+      "type": "string",
+      "description": "NPM package scope",
+      "default": "@myorg"
+    },
+    "domainName": {
+      "type": "string",
+      "description": "Initial domain name",
+      "required": true
+    },
+    "author": {
+      "type": "string",
+      "description": "Author name",
+      "default": ""
+    }
+  },
+  "structure": [
+    {
+      "type": "directory",
+      "path": "packages/contracts/src/{{domainName}}/v1"
+    },
+    {
+      "type": "directory",
+      "path": "packages/core/{{domainName}}-domain/src"
+    },
+    {
+      "type": "directory",
+      "path": "packages/adapters"
+    },
+    {
+      "type": "directory",
+      "path": "tests/contract"
+    },
+    {
+      "type": "directory",
+      "path": "tests/core"
+    },
+    {
+      "type": "file",
+      "path": "package.json",
+      "template": "package.json.hbs"
+    },
+    {
+      "type": "file",
+      "path": "pnpm-workspace.yaml",
+      "template": "pnpm-workspace.yaml.hbs"
+    },
+    {
+      "type": "file",
+      "path": "tsconfig.json",
+      "template": "tsconfig.json.hbs"
+    },
+    {
+      "type": "file",
+      "path": "packages/contracts/package.json",
+      "template": "contracts-package.json.hbs"
+    },
+    {
+      "type": "file",
+      "path": "packages/contracts/src/{{domainName}}/v1/schema.ts",
+      "template": "schema.ts.hbs"
+    },
+    {
+      "type": "file",
+      "path": "packages/contracts/src/{{domainName}}/v1/invariants.md",
+      "template": "invariants.md.hbs"
+    },
+    {
+      "type": "file",
+      "path": "packages/contracts/src/{{domainName}}/v1/index.ts",
+      "template": "contract-index.ts.hbs"
+    },
+    {
+      "type": "file",
+      "path": "packages/core/{{domainName}}-domain/package.json",
+      "template": "domain-package.json.hbs"
+    },
+    {
+      "type": "file",
+      "path": "packages/core/{{domainName}}-domain/src/index.ts",
+      "template": "domain-index.ts.hbs"
+    },
+    {
+      "type": "file",
+      "path": "tests/contract/{{domainName}}.test.ts",
+      "template": "contract-test.ts.hbs"
+    }
+  ],
+  "postCreate": [
+    "pnpm install",
+    "pnpm build"
+  ]
+}

package/bundled/templates/monorepo/tsconfig.json.hbs

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "composite": true,
+    "incremental": true,
+    "resolveJsonModule": true
+  },
+  "references": [
+    { "path": "./packages/contracts" },
+    { "path": "./packages/core/{{domainName}}-domain" }
+  ]
+}

package/bundled/templates/standalone/contract-index.ts.hbs

@@ -0,0 +1,5 @@
+/**
+ * {{pascalCase domainName}} Contracts
+ */
+
+export * from './schema.js';