feat(scenario): run logs, lint/format tooling, CONTRIBUTING

- add ScenarioRunLogEntity to persist step script output to DB
- stepLogger dual-writes to NestJS logger and DB (fire-and-forget)
- add GET /scenarios/:id/run/:runId returning run, stepRuns and logs
- add POST /scenarios/:id/run/:runId/wait (polls until terminal state)
- 9 new integration tests for the two endpoints (136 total)
- add eslint with typescript-eslint and eslint-config-prettier
- add npm scripts: format, lint, lint:fix
- resolve all lint errors across src and test (no any types)
- add CONTRIBUTING.md covering dev workflow

src/scenario/dto/create-scenario-step.dto.ts

@@ -1,29 +1,43 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsIn, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
-import { StepType } from '../scenario-step.entity';
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import {
+  IsIn,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Min,
+} from "class-validator";
+import { StepType } from "../scenario-step.entity";
 
 export class CreateScenarioStepDto {
-  @ApiProperty({ example: 0, description: 'Execution order (ascending)' })
+  @ApiProperty({ example: 0, description: "Execution order (ascending)" })
   @IsInt()
   @Min(0)
   order: number;
 
-  @ApiProperty({ enum: ['login', 'exec', 'sign'], example: 'exec' })
-  @IsIn(['login', 'exec', 'sign'])
+  @ApiProperty({ enum: ["login", "exec", "sign"], example: "exec" })
+  @IsIn(["login", "exec", "sign"])
   type: StepType;
 
-  @ApiProperty({ description: 'Session name used by this step. login steps create it; exec steps consume it.', example: 'my-session' })
+  @ApiProperty({
+    description:
+      "Session name used by this step. login steps create it; exec steps consume it.",
+    example: "my-session",
+  })
   @IsString()
   @IsNotEmpty()
   sessionName: string;
 
-  @ApiPropertyOptional({ example: 'return await page.title();' })
+  @ApiPropertyOptional({ example: "return await page.title();" })
   @IsOptional()
   @IsString()
   @IsNotEmpty()
   execCode?: string;
 
-  @ApiPropertyOptional({ example: 'return { success: result !== null, description: "title present" };' })
+  @ApiPropertyOptional({
+    example:
+      'return { success: result !== null, description: "title present" };',
+  })
   @IsOptional()
   @IsString()
   @IsNotEmpty()

src/scenario/dto/create-scenario.dto.ts

@@ -1,8 +1,8 @@
-import { ApiProperty } from '@nestjs/swagger';
-import { IsNotEmpty, IsString } from 'class-validator';
+import { ApiProperty } from "@nestjs/swagger";
+import { IsNotEmpty, IsString } from "class-validator";
 
 export class CreateScenarioDto {
-  @ApiProperty({ example: 'Login and verify cabinet' })
+  @ApiProperty({ example: "Login and verify cabinet" })
   @IsString()
   @IsNotEmpty()
   name: string;

src/scenario/dto/pagination-query.dto.ts

@@ -1 +1 @@
-export { PaginationQueryDto } from '../../common/dto/pagination.dto';
+export { PaginationQueryDto } from "../../common/dto/pagination.dto";

src/scenario/dto/runs-query.dto.ts

@@ -1,7 +1,7 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { Type } from 'class-transformer';
-import { IsIn, IsInt, IsOptional, Min } from 'class-validator';
-import { RunStatus } from '../scenario-run.entity';
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import { IsIn, IsInt, IsOptional, Min } from "class-validator";
+import { RunStatus } from "../scenario-run.entity";
 
 export class RunsQueryDto {
   @ApiPropertyOptional({ example: 1, default: 1 })
@@ -19,10 +19,10 @@ export class RunsQueryDto {
   limit?: number = 20;
 
   @ApiPropertyOptional({
-    enum: ['pending', 'in_progress', 'pass', 'fail'],
-    description: 'Filter by run status',
+    enum: ["pending", "in_progress", "pass", "fail"],
+    description: "Filter by run status",
   })
   @IsOptional()
-  @IsIn(['pending', 'in_progress', 'pass', 'fail'])
+  @IsIn(["pending", "in_progress", "pass", "fail"])
   status?: RunStatus;
 }

src/scenario/dto/scenario-export.dto.ts

@@ -1,5 +1,5 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { Type } from 'class-transformer';
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
 import {
   IsArray,
   IsIn,
@@ -9,8 +9,8 @@ import {
   IsString,
   Min,
   ValidateNested,
-} from 'class-validator';
-import { StepType } from '../scenario-step.entity';
+} from "class-validator";
+import { StepType } from "../scenario-step.entity";
 
 export class ScenarioStepExportDto {
   @ApiProperty()
@@ -18,8 +18,8 @@ export class ScenarioStepExportDto {
   @Min(0)
   order: number;
 
-  @ApiProperty({ enum: ['login', 'exec', 'sign'] })
-  @IsIn(['login', 'exec', 'sign'])
+  @ApiProperty({ enum: ["login", "exec", "sign"] })
+  @IsIn(["login", "exec", "sign"])
   type: StepType;
 
   @ApiProperty()

src/scenario/dto/update-scenario-step.dto.ts

@@ -1,6 +1,13 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsIn, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
-import { StepType } from '../scenario-step.entity';
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import {
+  IsIn,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Min,
+} from "class-validator";
+import { StepType } from "../scenario-step.entity";
 
 export class UpdateScenarioStepDto {
   @ApiPropertyOptional({ example: 0 })
@@ -9,9 +16,9 @@ export class UpdateScenarioStepDto {
   @Min(0)
   order?: number;
 
-  @ApiPropertyOptional({ enum: ['login', 'exec', 'sign'] })
+  @ApiPropertyOptional({ enum: ["login", "exec", "sign"] })
   @IsOptional()
-  @IsIn(['login', 'exec', 'sign'])
+  @IsIn(["login", "exec", "sign"])
   type?: StepType;
 
   @ApiPropertyOptional()

src/scenario/dto/update-scenario.dto.ts

@@ -1,8 +1,8 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsOptional, IsString, IsNotEmpty } from 'class-validator';
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import { IsOptional, IsString, IsNotEmpty } from "class-validator";
 
 export class UpdateScenarioDto {
-  @ApiPropertyOptional({ example: 'Updated scenario name' })
+  @ApiPropertyOptional({ example: "Updated scenario name" })
   @IsOptional()
   @IsString()
   @IsNotEmpty()