@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/stacks/node-nestjs/src/common/filters/problem-details.filter.ts

@@ -1,38 +1,38 @@
-import {
-  ArgumentsHost,
-  Catch,
-  ExceptionFilter,
-  HttpException,
-  HttpStatus,
-} from '@nestjs/common';
-import type { Request, Response } from 'express';
-
-/**
- * RFC 7807 Problem Details — uniform error shape across the API.
- */
-@Catch()
-export class ProblemDetailsFilter implements ExceptionFilter {
-  catch(exception: unknown, host: ArgumentsHost): void {
-    const ctx = host.switchToHttp();
-    const res = ctx.getResponse<Response>();
-    const req = ctx.getRequest<Request>();
-
-    const status =
-      exception instanceof HttpException
-        ? exception.getStatus()
-        : HttpStatus.INTERNAL_SERVER_ERROR;
-
-    const body =
-      exception instanceof HttpException
-        ? (exception.getResponse() as Record<string, unknown>)
-        : { message: 'Internal server error' };
-
-    res.status(status).json({
-      type: `urn:problem:${status}`,
-      title: typeof body.error === 'string' ? body.error : body.message,
-      status,
-      detail: Array.isArray(body.message) ? body.message.join('; ') : body.message,
-      instance: req.url,
-    });
-  }
-}
+import {
+  ArgumentsHost,
+  Catch,
+  ExceptionFilter,
+  HttpException,
+  HttpStatus,
+} from '@nestjs/common';
+import type { Request, Response } from 'express';
+
+/**
+ * RFC 7807 Problem Details — uniform error shape across the API.
+ */
+@Catch()
+export class ProblemDetailsFilter implements ExceptionFilter {
+  catch(exception: unknown, host: ArgumentsHost): void {
+    const ctx = host.switchToHttp();
+    const res = ctx.getResponse<Response>();
+    const req = ctx.getRequest<Request>();
+
+    const status =
+      exception instanceof HttpException
+        ? exception.getStatus()
+        : HttpStatus.INTERNAL_SERVER_ERROR;
+
+    const body =
+      exception instanceof HttpException
+        ? (exception.getResponse() as Record<string, unknown>)
+        : { message: 'Internal server error' };
+
+    res.status(status).json({
+      type: `urn:problem:${status}`,
+      title: typeof body.error === 'string' ? body.error : body.message,
+      status,
+      detail: Array.isArray(body.message) ? body.message.join('; ') : body.message,
+      instance: req.url,
+    });
+  }
+}

package/templates/stacks/node-nestjs/src/common/interceptors/json-response.interceptor.ts

@@ -1,13 +1,13 @@
-import { CallHandler, ExecutionContext, Injectable, NestInterceptor } from '@nestjs/common';
-import { Observable } from 'rxjs';
-
-/**
- * No-op interceptor placeholder. Reserved for cross-cutting JSON envelope work
- * (correlation ids, timing, etc.) — currently passthrough.
- */
-@Injectable()
-export class JsonResponseInterceptor implements NestInterceptor {
-  intercept(_ctx: ExecutionContext, next: CallHandler): Observable<unknown> {
-    return next.handle();
-  }
-}
+import { CallHandler, ExecutionContext, Injectable, NestInterceptor } from '@nestjs/common';
+import { Observable } from 'rxjs';
+
+/**
+ * No-op interceptor placeholder. Reserved for cross-cutting JSON envelope work
+ * (correlation ids, timing, etc.) — currently passthrough.
+ */
+@Injectable()
+export class JsonResponseInterceptor implements NestInterceptor {
+  intercept(_ctx: ExecutionContext, next: CallHandler): Observable<unknown> {
+    return next.handle();
+  }
+}

package/templates/stacks/node-nestjs/src/main.ts.hbs

@@ -1,44 +1,44 @@
-import { NestFactory } from '@nestjs/core';
-import { ValidationPipe } from '@nestjs/common';
-import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
-import { Logger } from 'nestjs-pino';
-import { writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { AppModule } from './app.module.js';
-import { ProblemDetailsFilter } from './common/filters/problem-details.filter.js';
-
-async function bootstrap(): Promise<void> {
-  const app = await NestFactory.create(AppModule, { bufferLogs: true });
-  app.useLogger(app.get(Logger));
-
-  app.useGlobalPipes(
-    new ValidationPipe({
-      whitelist: true,
-      forbidNonWhitelisted: true,
-      transform: true,
-    }),
-  );
-  app.useGlobalFilters(new ProblemDetailsFilter());
-
-  const config = new DocumentBuilder()
-    .setTitle('{{projectName}}')
-    .setDescription('DARE-shaped NestJS API')
-    .setVersion('0.1.0')
-    .addBearerAuth()
-    .build();
-  const doc = SwaggerModule.createDocument(app, config);
-  SwaggerModule.setup('api', app, doc);
-
-  // Persist openapi.json so M-02 (machine-readable surface) is met without
-  // requiring the server to be running.
-  try {
-    writeFileSync(join(process.cwd(), 'openapi.json'), JSON.stringify(doc, null, 2));
-  } catch {
-    /* non-fatal */
-  }
-
-  const port = Number(process.env.PORT ?? 3000);
-  await app.listen(port);
-}
-
-void bootstrap();
+import { NestFactory } from '@nestjs/core';
+import { ValidationPipe } from '@nestjs/common';
+import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
+import { Logger } from 'nestjs-pino';
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { AppModule } from './app.module.js';
+import { ProblemDetailsFilter } from './common/filters/problem-details.filter.js';
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule, { bufferLogs: true });
+  app.useLogger(app.get(Logger));
+
+  app.useGlobalPipes(
+    new ValidationPipe({
+      whitelist: true,
+      forbidNonWhitelisted: true,
+      transform: true,
+    }),
+  );
+  app.useGlobalFilters(new ProblemDetailsFilter());
+
+  const config = new DocumentBuilder()
+    .setTitle('{{projectName}}')
+    .setDescription('DARE-shaped NestJS API')
+    .setVersion('0.1.0')
+    .addBearerAuth()
+    .build();
+  const doc = SwaggerModule.createDocument(app, config);
+  SwaggerModule.setup('api', app, doc);
+
+  // Persist openapi.json so M-02 (machine-readable surface) is met without
+  // requiring the server to be running.
+  try {
+    writeFileSync(join(process.cwd(), 'openapi.json'), JSON.stringify(doc, null, 2));
+  } catch {
+    /* non-fatal */
+  }
+
+  const port = Number(process.env.PORT ?? 3000);
+  await app.listen(port);
+}
+
+void bootstrap();

package/templates/stacks/node-nestjs/src/prisma/prisma.module.ts

@@ -1,9 +1,9 @@
-import { Global, Module } from '@nestjs/common';
-import { PrismaService } from './prisma.service.js';
-
-@Global()
-@Module({
-  providers: [PrismaService],
-  exports: [PrismaService],
-})
-export class PrismaModule {}
+import { Global, Module } from '@nestjs/common';
+import { PrismaService } from './prisma.service.js';
+
+@Global()
+@Module({
+  providers: [PrismaService],
+  exports: [PrismaService],
+})
+export class PrismaModule {}

package/templates/stacks/node-nestjs/src/prisma/prisma.service.ts

@@ -1,9 +1,9 @@
-import { Injectable, OnModuleInit } from '@nestjs/common';
-import { PrismaClient } from '@prisma/client';
-
-@Injectable()
-export class PrismaService extends PrismaClient implements OnModuleInit {
-  async onModuleInit(): Promise<void> {
-    await this.$connect();
-  }
-}
+import { Injectable, OnModuleInit } from '@nestjs/common';
+import { PrismaClient } from '@prisma/client';
+
+@Injectable()
+export class PrismaService extends PrismaClient implements OnModuleInit {
+  async onModuleInit(): Promise<void> {
+    await this.$connect();
+  }
+}

package/templates/stacks/node-nestjs/src/users/dto/create-user.dto.ts

@@ -1,22 +1,22 @@
-import { ApiProperty } from '@nestjs/swagger';
-import { IsEmail, IsEnum, IsOptional, IsString, Matches, MinLength } from 'class-validator';
-import { Transform } from 'class-transformer';
-
-export class CreateUserDto {
-  @ApiProperty()
-  @Transform(({ value }) => (typeof value === 'string' ? value.trim().toLowerCase() : value))
-  @IsEmail()
-  email!: string;
-
-  @ApiProperty()
-  @IsString()
-  @MinLength(8)
-  @Matches(/[A-Z]/)
-  @Matches(/[0-9]/)
-  password!: string;
-
-  @ApiProperty({ enum: ['USER', 'ADMIN'], required: false, default: 'USER' })
-  @IsOptional()
-  @IsEnum(['USER', 'ADMIN'])
-  role?: 'USER' | 'ADMIN';
-}
+import { ApiProperty } from '@nestjs/swagger';
+import { IsEmail, IsEnum, IsOptional, IsString, Matches, MinLength } from 'class-validator';
+import { Transform } from 'class-transformer';
+
+export class CreateUserDto {
+  @ApiProperty()
+  @Transform(({ value }) => (typeof value === 'string' ? value.trim().toLowerCase() : value))
+  @IsEmail()
+  email!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(8)
+  @Matches(/[A-Z]/)
+  @Matches(/[0-9]/)
+  password!: string;
+
+  @ApiProperty({ enum: ['USER', 'ADMIN'], required: false, default: 'USER' })
+  @IsOptional()
+  @IsEnum(['USER', 'ADMIN'])
+  role?: 'USER' | 'ADMIN';
+}

package/templates/stacks/node-nestjs/src/users/dto/user.dto.ts

@@ -1,15 +1,15 @@
-import { ApiProperty } from '@nestjs/swagger';
-
-export class UserDto {
-  @ApiProperty()
-  id!: string;
-
-  @ApiProperty()
-  email!: string;
-
-  @ApiProperty({ enum: ['USER', 'ADMIN'] })
-  role!: string;
-
-  @ApiProperty({ description: 'ISO-8601 timestamp' })
-  createdAt!: string;
-}
+import { ApiProperty } from '@nestjs/swagger';
+
+export class UserDto {
+  @ApiProperty()
+  id!: string;
+
+  @ApiProperty()
+  email!: string;
+
+  @ApiProperty({ enum: ['USER', 'ADMIN'] })
+  role!: string;
+
+  @ApiProperty({ description: 'ISO-8601 timestamp' })
+  createdAt!: string;
+}

package/templates/stacks/node-nestjs/src/users/users.controller.ts

@@ -1,41 +1,41 @@
-import {
-  Body,
-  Controller,
-  ForbiddenException,
-  Get,
-  Post,
-  Query,
-  Req,
-  UseGuards,
-} from '@nestjs/common';
-import { AuthGuard } from '@nestjs/passport';
-import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
-import type { Request } from 'express';
-import { UsersService } from './users.service.js';
-import { UserDto } from './dto/user.dto.js';
-import { CreateUserDto } from './dto/create-user.dto.js';
-
-@ApiTags('users')
-@ApiBearerAuth()
-@UseGuards(AuthGuard('jwt'))
-@Controller('users')
-export class UsersController {
-  constructor(private readonly users: UsersService) {}
-
-  @Get()
-  list(
-    @Query('page') page = '1',
-    @Query('limit') limit = '20',
-  ): Promise<{ items: UserDto[]; total: number; page: number }> {
-    return this.users.list(Number(page), Number(limit));
-  }
-
-  @Post()
-  create(@Req() req: Request, @Body() dto: CreateUserDto): Promise<UserDto> {
-    const caller = req.user as { role: string } | undefined;
-    if (!caller || caller.role !== 'ADMIN') {
-      throw new ForbiddenException('admin role required');
-    }
-    return this.users.create(dto);
-  }
-}
+import {
+  Body,
+  Controller,
+  ForbiddenException,
+  Get,
+  Post,
+  Query,
+  Req,
+  UseGuards,
+} from '@nestjs/common';
+import { AuthGuard } from '@nestjs/passport';
+import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
+import type { Request } from 'express';
+import { UsersService } from './users.service.js';
+import { UserDto } from './dto/user.dto.js';
+import { CreateUserDto } from './dto/create-user.dto.js';
+
+@ApiTags('users')
+@ApiBearerAuth()
+@UseGuards(AuthGuard('jwt'))
+@Controller('users')
+export class UsersController {
+  constructor(private readonly users: UsersService) {}
+
+  @Get()
+  list(
+    @Query('page') page = '1',
+    @Query('limit') limit = '20',
+  ): Promise<{ items: UserDto[]; total: number; page: number }> {
+    return this.users.list(Number(page), Number(limit));
+  }
+
+  @Post()
+  create(@Req() req: Request, @Body() dto: CreateUserDto): Promise<UserDto> {
+    const caller = req.user as { role: string } | undefined;
+    if (!caller || caller.role !== 'ADMIN') {
+      throw new ForbiddenException('admin role required');
+    }
+    return this.users.create(dto);
+  }
+}

package/templates/stacks/node-nestjs/src/users/users.module.ts

@@ -1,11 +1,11 @@
-import { Module } from '@nestjs/common';
-import { UsersController } from './users.controller.js';
-import { UsersService } from './users.service.js';
-import { UsersRepository } from './users.repository.js';
-
-@Module({
-  controllers: [UsersController],
-  providers: [UsersService, UsersRepository],
-  exports: [UsersRepository, UsersService],
-})
-export class UsersModule {}
+import { Module } from '@nestjs/common';
+import { UsersController } from './users.controller.js';
+import { UsersService } from './users.service.js';
+import { UsersRepository } from './users.repository.js';
+
+@Module({
+  controllers: [UsersController],
+  providers: [UsersService, UsersRepository],
+  exports: [UsersRepository, UsersService],
+})
+export class UsersModule {}

package/templates/stacks/node-nestjs/src/users/users.repository.ts

@@ -1,38 +1,38 @@
-import { Injectable } from '@nestjs/common';
-import { PrismaService } from '../prisma/prisma.service.js';
-
-interface UserRow {
-  id: string;
-  email: string;
-  password: string;
-  role: string;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-@Injectable()
-export class UsersRepository {
-  constructor(private readonly prisma: PrismaService) {}
-
-  findByEmail(email: string): Promise<UserRow | null> {
-    return this.prisma.user.findUnique({ where: { email } });
-  }
-
-  async findPage(page: number, limit: number): Promise<{ items: UserRow[]; total: number }> {
-    const [items, total] = await Promise.all([
-      this.prisma.user.findMany({
-        skip: (page - 1) * limit,
-        take: limit,
-        orderBy: { createdAt: 'desc' },
-      }),
-      this.prisma.user.count(),
-    ]);
-    return { items, total };
-  }
-
-  create(data: { email: string; password: string; role: 'USER' | 'ADMIN' }): Promise<UserRow> {
-    return this.prisma.user.create({
-      data: { email: data.email, password: data.password, role: data.role },
-    });
-  }
-}
+import { Injectable } from '@nestjs/common';
+import { PrismaService } from '../prisma/prisma.service.js';
+
+interface UserRow {
+  id: string;
+  email: string;
+  password: string;
+  role: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+@Injectable()
+export class UsersRepository {
+  constructor(private readonly prisma: PrismaService) {}
+
+  findByEmail(email: string): Promise<UserRow | null> {
+    return this.prisma.user.findUnique({ where: { email } });
+  }
+
+  async findPage(page: number, limit: number): Promise<{ items: UserRow[]; total: number }> {
+    const [items, total] = await Promise.all([
+      this.prisma.user.findMany({
+        skip: (page - 1) * limit,
+        take: limit,
+        orderBy: { createdAt: 'desc' },
+      }),
+      this.prisma.user.count(),
+    ]);
+    return { items, total };
+  }
+
+  create(data: { email: string; password: string; role: 'USER' | 'ADMIN' }): Promise<UserRow> {
+    return this.prisma.user.create({
+      data: { email: data.email, password: data.password, role: data.role },
+    });
+  }
+}

package/templates/stacks/node-nestjs/src/users/users.service.ts

@@ -1,38 +1,38 @@
-import { ConflictException, Injectable } from '@nestjs/common';
-import { ConfigService } from '@nestjs/config';
-import * as bcrypt from 'bcrypt';
-import { UsersRepository } from './users.repository.js';
-import { UserDto } from './dto/user.dto.js';
-import { CreateUserDto } from './dto/create-user.dto.js';
-
-@Injectable()
-export class UsersService {
-  constructor(
-    private readonly repo: UsersRepository,
-    private readonly config: ConfigService,
-  ) {}
-
-  async list(page = 1, limit = 20): Promise<{ items: UserDto[]; total: number; page: number }> {
-    const safePage = Math.max(1, page);
-    const safeLimit = Math.min(100, Math.max(1, limit));
-    const { items, total } = await this.repo.findPage(safePage, safeLimit);
-    return { items: items.map(toDto), total, page: safePage };
-  }
-
-  async create(input: CreateUserDto): Promise<UserDto> {
-    const existing = await this.repo.findByEmail(input.email);
-    if (existing) throw new ConflictException('email already in use');
-    const cost = Number(this.config.get<string>('BCRYPT_COST', '12'));
-    const hash = await bcrypt.hash(input.password, cost);
-    const created = await this.repo.create({
-      email: input.email,
-      password: hash,
-      role: input.role ?? 'USER',
-    });
-    return toDto(created);
-  }
-}
-
-function toDto(u: { id: string; email: string; role: string; createdAt: Date }): UserDto {
-  return { id: u.id, email: u.email, role: u.role, createdAt: u.createdAt.toISOString() };
-}
+import { ConflictException, Injectable } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import * as bcrypt from 'bcrypt';
+import { UsersRepository } from './users.repository.js';
+import { UserDto } from './dto/user.dto.js';
+import { CreateUserDto } from './dto/create-user.dto.js';
+
+@Injectable()
+export class UsersService {
+  constructor(
+    private readonly repo: UsersRepository,
+    private readonly config: ConfigService,
+  ) {}
+
+  async list(page = 1, limit = 20): Promise<{ items: UserDto[]; total: number; page: number }> {
+    const safePage = Math.max(1, page);
+    const safeLimit = Math.min(100, Math.max(1, limit));
+    const { items, total } = await this.repo.findPage(safePage, safeLimit);
+    return { items: items.map(toDto), total, page: safePage };
+  }
+
+  async create(input: CreateUserDto): Promise<UserDto> {
+    const existing = await this.repo.findByEmail(input.email);
+    if (existing) throw new ConflictException('email already in use');
+    const cost = Number(this.config.get<string>('BCRYPT_COST', '12'));
+    const hash = await bcrypt.hash(input.password, cost);
+    const created = await this.repo.create({
+      email: input.email,
+      password: hash,
+      role: input.role ?? 'USER',
+    });
+    return toDto(created);
+  }
+}
+
+function toDto(u: { id: string; email: string; role: string; createdAt: Date }): UserDto {
+  return { id: u.id, email: u.email, role: u.role, createdAt: u.createdAt.toISOString() };
+}

package/templates/stacks/node-nestjs/tsconfig.build.json

@@ -1,4 +1,4 @@
-{
-  "extends": "./tsconfig.json",
-  "exclude": ["node_modules", "test", "dist", "**/*.spec.ts"]
-}
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*.spec.ts"]
+}

package/templates/stacks/node-nestjs/tsconfig.json

@@ -1,28 +1,28 @@
-{
-  "compilerOptions": {
-    "module": "commonjs",
-    "declaration": true,
-    "removeComments": true,
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "allowSyntheticDefaultImports": true,
-    "target": "ES2022",
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "baseUrl": "./",
-    "incremental": true,
-    "skipLibCheck": true,
-    "strictNullChecks": true,
-    "noImplicitAny": true,
-    "strictBindCallApply": true,
-    "forceConsistentCasingInFileNames": true,
-    "noFallthroughCasesInSwitch": true,
-    "esModuleInterop": true,
-    "resolveJsonModule": true,
-    "paths": {
-      "@/*": ["src/*"]
-    }
-  },
-  "include": ["src/**/*"]
-}
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2022",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "noImplicitAny": true,
+    "strictBindCallApply": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src/**/*"]
+}

package/templates/stacks/php-laravel/.dare/skills.yml

@@ -1,11 +1,11 @@
-version: 1
-skills:
-  - id: skill-laravel-api
-    source: skill-laravel-api
-    description: Laravel 11 + Sanctum + Reverb + Pail + Layered Design
-  - id: dare-ax
-    source: dare-ax
-    description: Agent eXperience invariants (llms.txt, OpenAPI, --json, rate limit)
-  - id: dare-layered-design
-    source: dare-layered-design
-    description: Controller → Service → Repository → Model 4-layer architecture
+version: 1
+skills:
+  - id: skill-laravel-api
+    source: skill-laravel-api
+    description: Laravel 11 + Sanctum + Reverb + Pail + Layered Design
+  - id: dare-ax
+    source: dare-ax
+    description: Agent eXperience invariants (llms.txt, OpenAPI, --json, rate limit)
+  - id: dare-layered-design
+    source: dare-layered-design
+    description: Controller → Service → Repository → Model 4-layer architecture