@bi-analytics/arness-back 0.0.0-stage → 0.2.0

package/harness/skills/nest-base/templates/monitor/widgets/endpoints-total.widget.spec.ts

@@ -0,0 +1,51 @@
+// Plantilla del harness → src/common/monitor/widgets/endpoints-total.widget.spec.ts
+import { Controller, Get, Post } from '@nestjs/common';
+import { DiscoveryModule } from '@nestjs/core';
+import { Test } from '@nestjs/testing';
+import { EndpointsTotalWidget } from './endpoints-total.widget';
+
+@Controller('cartera/resumen')
+class CarteraController {
+  @Get()
+  list(): void {}
+
+  @Get(['detalle', 'detalle-v2'])
+  detail(): void {}
+
+  helper(): void {}
+}
+
+@Controller()
+class RecaudoController {
+  @Get('recaudo/diario')
+  daily(): void {}
+}
+
+@Controller('auth')
+class AuthController {
+  @Post('login')
+  login(): void {}
+}
+
+@Controller('health')
+class HealthController {
+  @Get()
+  check(): void {}
+}
+
+describe('EndpointsTotalWidget', () => {
+  it('counts routes by module segment and skips auth, health and monitor', async () => {
+    const moduleRef = await Test.createTestingModule({
+      imports: [DiscoveryModule],
+      controllers: [CarteraController, RecaudoController, AuthController, HealthController],
+      providers: [EndpointsTotalWidget],
+    }).compile();
+    await expect(moduleRef.get(EndpointsTotalWidget).collect()).resolves.toEqual({
+      value: 4,
+      detail: [
+        { label: 'cartera', value: 3 },
+        { label: 'recaudo', value: 1 },
+      ],
+    });
+  });
+});

package/harness/skills/nest-base/templates/monitor/widgets/endpoints-total.widget.ts

@@ -0,0 +1,53 @@
+// Plantilla del harness → src/common/monitor/widgets/endpoints-total.widget.ts
+import { Injectable } from '@nestjs/common';
+import { PATH_METADATA, METHOD_METADATA } from '@nestjs/common/constants';
+import { DiscoveryService, MetadataScanner, Reflector } from '@nestjs/core';
+import { MONITOR_EXCLUDED_SEGMENTS } from '../monitor.constants';
+import { MonitorValue, MonitorWidget } from '../monitor-widget.interface';
+
+const toPaths = (value: string | string[] | undefined): string[] =>
+  (Array.isArray(value) ? value : [value ?? '']).map((path) => path.replace(/^\/+|\/+$/g, ''));
+
+/** Counts the HTTP routes of the API (excluding monitor, health and auth), grouped by module segment. */
+@Injectable()
+export class EndpointsTotalWidget implements MonitorWidget {
+  readonly id = 'endpoints-total';
+  readonly title = 'Endpoints de la API';
+  readonly order = 10;
+
+  constructor(
+    private readonly discovery: DiscoveryService,
+    private readonly scanner: MetadataScanner,
+    private readonly reflector: Reflector,
+  ) {}
+
+  collect(): Promise<MonitorValue> {
+    const byModule = new Map<string, number>();
+    for (const { metatype, instance } of this.discovery.getControllers()) {
+      if (!metatype || !instance) continue;
+      const prefixes = toPaths(
+        this.reflector.get<string | string[] | undefined>(PATH_METADATA, metatype),
+      );
+      const prototype = Object.getPrototypeOf(instance) as Record<string, unknown>;
+      for (const name of this.scanner.getAllMethodNames(prototype)) {
+        const handler = prototype[name];
+        if (typeof handler !== 'function') continue;
+        if (this.reflector.get<number | undefined>(METHOD_METADATA, handler) === undefined)
+          continue;
+        for (const prefix of prefixes) {
+          for (const path of toPaths(
+            this.reflector.get<string | string[] | undefined>(PATH_METADATA, handler),
+          )) {
+            const segment = [prefix, path].filter(Boolean).join('/').split('/')[0] || '/';
+            if (MONITOR_EXCLUDED_SEGMENTS.has(segment)) continue;
+            byModule.set(segment, (byModule.get(segment) ?? 0) + 1);
+          }
+        }
+      }
+    }
+    const detail = [...byModule.entries()]
+      .sort(([a], [b]) => a.localeCompare(b))
+      .map(([label, value]) => ({ label, value }));
+    return Promise.resolve({ value: detail.reduce((sum, item) => sum + item.value, 0), detail });
+  }
+}

package/harness/skills/nest-base/templates/prettierignore

@@ -0,0 +1,6 @@
+dist
+coverage
+node_modules
+pnpm-lock.yaml
+postman
+harness

package/harness/skills/nest-base/templates/prettierrc.json

@@ -0,0 +1,8 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "semi": true,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@bi-analytics/arness-back",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Harness de agentes IA (Claude Code, Codex, Gemini CLI, Cursor) para backends NestJS de analítica",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bi-analytics-linktic/harness-back.git"
+  },
+  "type": "module",
+  "homepage": "https://github.com/bi-analytics-linktic/harness-back#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bin": {
+    "arness": "bin/arness.mjs"
+  },
+  "files": [
+    "bin/",
+    "harness/",
+    "!harness/progress.md",
+    "!harness/.arness.json",
+    "!harness/arness.config.json",
+    "!harness/.arness-backup/",
+    "!harness/decisiones/[0-9]*.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "harness",
+    "agents",
+    "claude-code",
+    "codex",
+    "nestjs"
+  ],
+  "license": "UNLICENSED",
+  "devDependencies": {
+    "eslint": "^9.39.5"
+  },
+  "scripts": {
+    "test": "node --test",
+    "verify": "./harness/init.sh",
+    "pack:check": "pnpm pack --dry-run"
+  }
 }