@shrkcrft/presets 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/builtin/builtin-presets.js

@@ -1,9 +1,12 @@
 import { WorkspaceProfile } from '@shrkcrft/workspace';
 import { definePreset } from "../define/define-preset.js";
-import { COMMON_AGENT_BRIEFING, COMMON_PATH_SERVICES, COMMON_PATH_TESTS, COMMON_PATH_UTILS, COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST, COMMON_RULE_INTERFACE_PREFIX, COMMON_RULE_NO_LOGIC_CONSTRUCTORS, COMMON_RULE_ONE_EXPORT, COMMON_SAFETY_RULE, COMMON_TEMPLATE_SERVICE, COMMON_TEMPLATE_TEST, COMMON_TEMPLATE_UTILITY, OVERVIEW_DOC, } from "./shared-snippets.js";
-import { R26_PRESETS } from "./r26-presets.js";
-import { R45_PRESETS } from "./r45-presets.js";
-import { R47_PRESETS } from "./r47-presets.js";
+import { ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES, COMMON_AGENT_BRIEFING, COMMON_PATH_SERVICES, COMMON_PATH_TESTS, COMMON_PATH_UTILS, COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST, COMMON_RULE_INTERFACE_PREFIX, COMMON_RULE_NO_LOGIC_CONSTRUCTORS, COMMON_RULE_ONE_EXPORT, COMMON_SAFETY_RULE, COMMON_TEMPLATE_SERVICE, COMMON_TEMPLATE_TEST, COMMON_TEMPLATE_UTILITY, GO_PATH_CMD, GO_PATH_INTERNAL, GO_PATH_PKG, JAVA_MAVEN_PATH_MAIN, JAVA_MAVEN_PATH_TESTS, NX_PATH_APPS, NX_PATH_LIBS, OVERVIEW_DOC, PYTHON_PATH_SRC, PYTHON_PATH_TESTS, RUST_PATH_SRC, RUST_PATH_TESTS, } from "./shared-snippets.js";
+import { MULTI_STACK_PRESETS } from "./r26-presets.js";
+import { UNIVERSAL_ADOPTION_PRESETS } from "./r45-presets.js";
+import { CANONICAL_ALIAS_PRESETS } from "./r47-presets.js";
+import { ANGULAR_21_PRESETS } from "./angular21-presets.js";
+import { NEST_11_PRESETS } from "./nest11-presets.js";
+import { REACT_19_PRESETS } from "./react19-presets.js";
 const GENERIC = definePreset({
     id: 'generic',
     title: 'Generic SharkCraft setup',
@@ -133,7 +136,7 @@ const ANGULAR_APP = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE, COMMON_RULE_ONE_EXPORT],
-        paths: [COMMON_PATH_UTILS, COMMON_PATH_TESTS],
+        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES],
         templates: [COMMON_TEMPLATE_UTILITY, COMMON_TEMPLATE_TEST],
         pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
         docs: {
@@ -150,7 +153,7 @@ const ANGULAR_APP = definePreset({
 const NX_MONOREPO = definePreset({
     id: 'nx-monorepo',
     title: 'Nx monorepo',
-    description: 'Conventions for Nx workspaces: layer order, public entrypoints, no relative cross-lib imports, affected build/test commands.',
+    description: 'Conventions for Nx workspaces: public entrypoints, no relative cross-lib imports, affected build/test commands.',
     tags: ['nx', 'monorepo'],
     appliesTo: [WorkspaceProfile.HasNx, WorkspaceProfile.IsMonorepo],
     weight: 8,
@@ -158,13 +161,13 @@ const NX_MONOREPO = definePreset({
         knowledge: [
             COMMON_AGENT_BRIEFING,
             `defineKnowledgeEntry({
-    id: 'nx.layer-order',
-    title: 'Nx layers: lower layers do not import higher',
+    id: 'nx.boundary-tags',
+    title: 'Respect Nx boundary tags',
     type: KnowledgeType.Rule,
     priority: KnowledgePriority.Critical,
     tags: ['nx', 'architecture'],
     appliesWhen: ['generate-code', 'refactor'],
-    content: 'Respect the documented layer order. Lower layers must never import higher ones.',
+    content: 'Respect the boundary tags declared on each project (scope, type). The enforce-module-boundaries lint rule must stay green.',
   })`,
             `defineKnowledgeEntry({
     id: 'nx.public-entrypoints',
@@ -177,11 +180,11 @@ const NX_MONOREPO = definePreset({
   })`,
         ],
         rules: [COMMON_SAFETY_RULE, COMMON_RULE_INTERFACE_PREFIX, COMMON_RULE_ONE_EXPORT],
-        paths: [COMMON_PATH_SERVICES, COMMON_PATH_UTILS, COMMON_PATH_TESTS],
+        paths: [NX_PATH_LIBS, NX_PATH_APPS],
         templates: [COMMON_TEMPLATE_SERVICE, COMMON_TEMPLATE_UTILITY, COMMON_TEMPLATE_TEST],
         pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST],
         docs: {
-            'overview.md': OVERVIEW_DOC('Nx monorepo', 'Many libraries. Layer order is enforced.'),
+            'overview.md': OVERVIEW_DOC('Nx monorepo', 'Many libraries. Layer order is enforced. Code lives under libs/<area>/src/lib/; apps under apps/<app>/.'),
         },
     },
     recommendedNextCommands: [
@@ -374,7 +377,7 @@ const JAVA_MAVEN_SERVICE = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE],
-        paths: [],
+        paths: [JAVA_MAVEN_PATH_MAIN, JAVA_MAVEN_PATH_TESTS],
         templates: [],
         pipelines: [],
         docs: {
@@ -392,7 +395,7 @@ const JAVA_GRADLE_SERVICE = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE],
-        paths: [],
+        paths: [JAVA_MAVEN_PATH_MAIN, JAVA_MAVEN_PATH_TESTS],
         templates: [],
         pipelines: [],
         docs: {
@@ -428,7 +431,7 @@ const PYTHON_SERVICE = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE],
-        paths: [],
+        paths: [PYTHON_PATH_SRC, PYTHON_PATH_TESTS],
         templates: [],
         pipelines: [],
         docs: {
@@ -446,7 +449,7 @@ const GO_MODULE = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE],
-        paths: [],
+        paths: [GO_PATH_CMD, GO_PATH_PKG, GO_PATH_INTERNAL],
         templates: [],
         pipelines: [],
         docs: {
@@ -464,7 +467,7 @@ const RUST_CRATE = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE],
-        paths: [],
+        paths: [RUST_PATH_SRC, RUST_PATH_TESTS],
         templates: [],
         pipelines: [],
         docs: {
@@ -512,9 +515,27 @@ export const BUILTIN_PRESETS = Object.freeze([
     RUST_CRATE,
     POLYGLOT_MONOREPO,
     // Modern Angular, strict TypeScript, frontend/backend/testing variants
-    ...R26_PRESETS,
+    ...MULTI_STACK_PRESETS,
     // Universal adoption: next-app, turborepo, package-workspace, clean-architecture-ts
-    ...R45_PRESETS,
+    ...UNIVERSAL_ADOPTION_PRESETS,
     // Universal adoption top-5: nest-service, angular-app canonical aliases
-    ...R47_PRESETS,
+    ...CANONICAL_ALIAS_PRESETS,
+    // Angular 18 / 19 / 20 / 21 — signal queries, signal I/O, zoneless,
+    // @if/@for/@defer/@let, resource() / httpResource(), inject(), no
+    // NgModules. Weight 11-12 so the recommender prefers these over
+    // R26 `modern-angular` (weight 9) when the workspace is Angular.
+    ...ANGULAR_21_PRESETS,
+    // NestJS 11+ — thin controllers, global ValidationPipe + class-validator,
+    // async lifecycle, Fastify + cache + throttler, helmet + JWT guards,
+    // structured logging + terminus health, TestingModule + supertest e2e.
+    // Weight 11-12 so the recommender prefers these over R26 `nestjs-service`
+    // (weight 7) and R47 `nest-service` (weight 9) when the workspace is Nest.
+    ...NEST_11_PRESETS,
+    // React 19+ — function components + ref-as-prop, hooks discipline,
+    // Actions / useActionState / useOptimistic, TanStack Query for server
+    // state, React Compiler + lazy + virtualization, useTransition /
+    // Suspense, Vitest + RTL + userEvent + MSW, RSC + 'use client' +
+    // Server Actions. Weight 11-12 so the recommender prefers these over
+    // the legacy `frontend-app` (weight 6) when the workspace is React.
+    ...REACT_19_PRESETS,
 ]);

package/dist/builtin/nest11-presets.d.ts

@@ -0,0 +1,11 @@
+import type { IPreset } from '../model/preset.js';
+export declare const NEST_11_ARCHITECTURE: IPreset;
+export declare const NEST_11_VALIDATION: IPreset;
+export declare const NEST_11_ASYNC_LIFECYCLE: IPreset;
+export declare const NEST_11_PERFORMANCE: IPreset;
+export declare const NEST_11_SECURITY: IPreset;
+export declare const NEST_11_OBSERVABILITY: IPreset;
+export declare const NEST_11_TESTING: IPreset;
+export declare const NEST_11_MODERN: IPreset;
+export declare const NEST_11_PRESETS: readonly IPreset[];
+//# sourceMappingURL=nest11-presets.d.ts.map

package/dist/builtin/nest11-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest11-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/nest11-presets.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsDlD,eAAO,MAAM,oBAAoB,EAAE,OA+BjC,CAAC;AAIH,eAAO,MAAM,kBAAkB,EAAE,OA6B/B,CAAC;AAIH,eAAO,MAAM,uBAAuB,EAAE,OA2BpC,CAAC;AAIH,eAAO,MAAM,mBAAmB,EAAE,OA4BhC,CAAC;AAIH,eAAO,MAAM,gBAAgB,EAAE,OA8B7B,CAAC;AAIH,eAAO,MAAM,qBAAqB,EAAE,OA4BlC,CAAC;AAIH,eAAO,MAAM,eAAe,EAAE,OA2B5B,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,OA4C3B,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,SAAS,OAAO,EAS5C,CAAC"}

package/dist/builtin/nest11-presets.js

@@ -0,0 +1,257 @@
+// NestJS 11+ preset family.
+//
+// Seven focused presets covering modern Nest practice — architecture,
+// validation, async lifecycle, performance, security, observability,
+// testing — plus one comprehensive `nest-11-modern` that composes them.
+// Targets HasNestJS workspaces with weight set above the legacy R26
+// `nestjs-service` (weight 7) and R47 `nest-service` canonical alias
+// (weight 9), so the recommender prefers these when the workspace
+// declares HasNestJS.
+import { WorkspaceProfile } from '@shrkcrft/workspace';
+import { definePreset } from "../define/define-preset.js";
+import { COMMON_AGENT_BRIEFING, COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST, COMMON_SAFETY_RULE, NEST_PATH_E2E, NEST_PATH_SRC, OVERVIEW_DOC, } from "./shared-snippets.js";
+import { NEST11_API_VERSIONING, NEST11_ASYNC_PROVIDERS, NEST11_CACHE_MANAGER, NEST11_CLASS_VALIDATOR_DTO, NEST11_DTO_AT_BOUNDARY, NEST11_E2E_SUPERTEST, NEST11_ENABLE_SHUTDOWN_HOOKS, NEST11_EXPLICIT_CORS, NEST11_FASTIFY_ADAPTER, NEST11_GLOBAL_VALIDATION_PIPE, NEST11_HELMET, NEST11_JWT_GUARDS, NEST11_LIFECYCLE_HOOKS, NEST11_LOGGER_WITH_CONTEXT, NEST11_MODULE_PER_FEATURE, NEST11_MODULE_PUBLIC_API, NEST11_NO_CIRCULAR_MODULES, NEST11_NO_LOG_SECRETS, NEST11_NO_QUERY_IN_CONTROLLER, NEST11_NO_SECRETS_IN_CODE, NEST11_PAGINATION_BY_DEFAULT, NEST11_REQUEST_RESPONSE_DTOS, NEST11_SERVICE_OWNS_DOMAIN, NEST11_STRUCTURED_LOGS, NEST11_SWAGGER_DECORATORS, NEST11_TERMINUS_HEALTH, NEST11_TEST_FILE_LAYOUT, NEST11_TESTING_MODULE, NEST11_THIN_CONTROLLERS, NEST11_THROTTLER, NEST11_TRUST_PROXY_AWARE, } from "./nest11-snippets.js";
+const NEST11_TAGS = ['nestjs', 'nest-11', 'backend'];
+const NEST11_NEXT_COMMANDS = [
+    'shrk doctor',
+    'shrk task "<task>"',
+    'shrk ci scaffold github-actions --quickstart',
+];
+// ─── 1) Architecture — modules, controllers, services, repos ─────────────
+export const NEST_11_ARCHITECTURE = definePreset({
+    id: 'nest-11-architecture',
+    title: 'NestJS 11 — module + controller + service architecture',
+    description: 'Module-per-feature, thin controllers (validate + delegate, nothing more), services own domain logic, repositories abstract data access, DTOs at every HTTP boundary, no circular module dependencies. The structural backbone of a maintainable Nest service.',
+    tags: [...NEST11_TAGS, 'architecture'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NEST11_THIN_CONTROLLERS,
+            NEST11_SERVICE_OWNS_DOMAIN,
+            NEST11_MODULE_PER_FEATURE,
+            NEST11_MODULE_PUBLIC_API,
+            NEST11_NO_CIRCULAR_MODULES,
+            NEST11_DTO_AT_BOUNDARY,
+            NEST11_NO_QUERY_IN_CONTROLLER,
+        ],
+        paths: [NEST_PATH_SRC, NEST_PATH_E2E],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS 11 architecture', 'Module per feature under src/<feature>/. Controllers parse + delegate. Services own domain logic; data access goes through repositories. Modules export only their public providers. DTOs at every boundary; entities never leave the service layer.'),
+        },
+    },
+    recommendedNextCommands: NEST11_NEXT_COMMANDS,
+});
+// ─── 2) Validation — ValidationPipe + class-validator + DTOs ─────────────
+export const NEST_11_VALIDATION = definePreset({
+    id: 'nest-11-validation',
+    title: 'NestJS 11 — strict validation at the boundary',
+    description: 'Global ValidationPipe with whitelist + forbidNonWhitelisted + transform, class-validator decorators on every DTO field, separated request and response DTOs, @ApiProperty annotations for the OpenAPI contract.',
+    tags: [...NEST11_TAGS, 'validation'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NEST11_GLOBAL_VALIDATION_PIPE,
+            NEST11_CLASS_VALIDATOR_DTO,
+            NEST11_REQUEST_RESPONSE_DTOS,
+            NEST11_DTO_AT_BOUNDARY,
+            NEST11_SWAGGER_DECORATORS,
+        ],
+        paths: [NEST_PATH_SRC],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS 11 validation', 'ValidationPipe is registered globally with strict options. Every DTO is a class with class-validator decorators; @Type() wires nested objects through class-transformer. Request and response DTOs are separate classes — input is whitelisted, output is projected.'),
+        },
+    },
+    recommendedNextCommands: NEST11_NEXT_COMMANDS,
+});
+// ─── 3) Async lifecycle + graceful shutdown ──────────────────────────────
+export const NEST_11_ASYNC_LIFECYCLE = definePreset({
+    id: 'nest-11-async-lifecycle',
+    title: 'NestJS 11 — async providers + graceful shutdown',
+    description: 'Async configuration providers via useFactory, OnModuleInit / OnApplicationBootstrap / OnModuleDestroy / OnApplicationShutdown lifecycle hooks, enableShutdownHooks() at bootstrap so SIGTERM cleanly tears down DB pools and message clients.',
+    tags: [...NEST11_TAGS, 'lifecycle'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NEST11_LIFECYCLE_HOOKS,
+            NEST11_ENABLE_SHUTDOWN_HOOKS,
+            NEST11_ASYNC_PROVIDERS,
+        ],
+        paths: [NEST_PATH_SRC],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS 11 lifecycle', 'enableShutdownHooks() in main.ts so the OnModuleDestroy / OnApplicationShutdown hooks fire on SIGTERM. Configuration that must resolve at boot uses { useFactory } async providers — not lazy init from inside a service.'),
+        },
+    },
+    recommendedNextCommands: NEST11_NEXT_COMMANDS,
+});
+// ─── 4) Performance — Fastify, cache, throttler, pagination ──────────────
+export const NEST_11_PERFORMANCE = definePreset({
+    id: 'nest-11-performance',
+    title: 'NestJS 11 — Fastify, caching, throttling, pagination',
+    description: 'NestFastifyApplication adapter for ~2× throughput vs. Express, @nestjs/cache-manager for hot reads, @nestjs/throttler for per-IP rate limiting, mandatory pagination on every list endpoint.',
+    tags: [...NEST11_TAGS, 'performance'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NEST11_FASTIFY_ADAPTER,
+            NEST11_CACHE_MANAGER,
+            NEST11_THROTTLER,
+            NEST11_PAGINATION_BY_DEFAULT,
+        ],
+        paths: [NEST_PATH_SRC],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS 11 performance', 'Fastify adapter for high-throughput HTTP. Idempotent GETs cached via CacheInterceptor with explicit per-route TTLs. Global ThrottlerModule with sane defaults (60 req/min/IP); per-route overrides via @Throttle. List endpoints paginate by default; pageSize is capped server-side.'),
+        },
+    },
+    recommendedNextCommands: NEST11_NEXT_COMMANDS,
+});
+// ─── 5) Security — helmet, CORS, auth, secrets, trust-proxy ──────────────
+export const NEST_11_SECURITY = definePreset({
+    id: 'nest-11-security',
+    title: 'NestJS 11 — security baseline',
+    description: 'helmet middleware for HTTP security headers, explicit CORS allowlist (never `origin: true`), JWT auth via @nestjs/passport guards, no-secrets-in-source enforcement, trust-proxy configured for load-balanced deployments, throttler for abuse protection.',
+    tags: [...NEST11_TAGS, 'security'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NEST11_HELMET,
+            NEST11_EXPLICIT_CORS,
+            NEST11_JWT_GUARDS,
+            NEST11_NO_SECRETS_IN_CODE,
+            NEST11_TRUST_PROXY_AWARE,
+            NEST11_THROTTLER,
+        ],
+        paths: [NEST_PATH_SRC],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS 11 security', 'helmet registered before any route. CORS allowlist explicit. Authentication runs through Guards (JwtAuthGuard + @UseGuards), not middleware. Secrets come from ConfigService.get only. trust-proxy configured. Throttler in place.'),
+        },
+    },
+    recommendedNextCommands: NEST11_NEXT_COMMANDS,
+});
+// ─── 6) Observability — Logger, structured logs, terminus ────────────────
+export const NEST_11_OBSERVABILITY = definePreset({
+    id: 'nest-11-observability',
+    title: 'NestJS 11 — structured logging + health checks',
+    description: 'Per-provider Logger instances with context names, structured JSON logs in production (pino / nest-winston), redact-list for secrets and PII, @nestjs/terminus health checks with separated liveness and readiness endpoints.',
+    tags: [...NEST11_TAGS, 'observability'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NEST11_LOGGER_WITH_CONTEXT,
+            NEST11_STRUCTURED_LOGS,
+            NEST11_NO_LOG_SECRETS,
+            NEST11_TERMINUS_HEALTH,
+        ],
+        paths: [NEST_PATH_SRC],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS 11 observability', 'Each provider holds its own Logger(MyService.name). Production logger is structured JSON via pino or nest-winston with a redact list for tokens / passwords / PII. /health/liveness and /health/readiness are separate endpoints; readiness fails 503 when a critical dep is down.'),
+        },
+    },
+    recommendedNextCommands: NEST11_NEXT_COMMANDS,
+});
+// ─── 7) Testing — TestingModule + e2e ───────────────────────────────────
+export const NEST_11_TESTING = definePreset({
+    id: 'nest-11-testing',
+    title: 'NestJS 11 — TestingModule + supertest e2e',
+    description: 'Unit tests via Test.createTestingModule + overrideProvider for slow deps, co-located *.spec.ts files; e2e under test/*.e2e-spec.ts driving the real AppModule through supertest with the validation pipeline live.',
+    tags: [...NEST11_TAGS, 'testing'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NEST11_TESTING_MODULE,
+            NEST11_E2E_SUPERTEST,
+            NEST11_TEST_FILE_LAYOUT,
+        ],
+        paths: [NEST_PATH_SRC, NEST_PATH_E2E],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_UNIT_TEST],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS 11 testing', 'Unit specs are co-located beside their unit; they use Test.createTestingModule + overrideProvider to fake the expensive deps. E2E specs live under test/, drive AppModule through supertest, and keep the real validation pipeline + guards + interceptors active — that is the contract being tested.'),
+        },
+    },
+    recommendedNextCommands: NEST11_NEXT_COMMANDS,
+});
+// ─── 8) The whole stack — composes 1-7 ──────────────────────────────────
+export const NEST_11_MODERN = definePreset({
+    id: 'nest-11-modern',
+    title: 'NestJS 11 — modern stack (architecture + validation + lifecycle + perf + security + obs + testing)',
+    description: 'The canonical preset for a new NestJS 11+ service. Composes the seven focused presets, then layers on API versioning. Use this unless you specifically want a narrower slice.',
+    tags: [...NEST11_TAGS, 'comprehensive'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend, WorkspaceProfile.IsService],
+    weight: 12,
+    composes: [
+        'nest-11-architecture',
+        'nest-11-validation',
+        'nest-11-async-lifecycle',
+        'nest-11-performance',
+        'nest-11-security',
+        'nest-11-observability',
+        'nest-11-testing',
+    ],
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            // Extras that don't fit any single focused preset:
+            NEST11_API_VERSIONING,
+        ],
+        paths: [NEST_PATH_SRC, NEST_PATH_E2E],
+        templates: [],
+        pipelines: [
+            COMMON_PIPELINE_CONTEXT_ONLY,
+            COMMON_PIPELINE_FEATURE_DEV,
+            COMMON_PIPELINE_UNIT_TEST,
+        ],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS 11 modern stack', 'Module-per-feature architecture. Thin controllers, services own domain, repositories abstract data. Global ValidationPipe + class-validator. Fastify adapter, cache-manager, throttler, mandatory pagination. helmet + CORS allowlist + JWT guards + no-secrets. Per-provider Logger + structured JSON logs + terminus health. TestingModule unit specs + supertest e2e. URI versioning when the API has external consumers.'),
+        },
+    },
+    recommendedNextCommands: [
+        'shrk doctor',
+        'shrk task "<task>"',
+        'shrk ci scaffold github-actions --quickstart',
+        'nest g resource <feature>',
+    ],
+});
+export const NEST_11_PRESETS = Object.freeze([
+    NEST_11_ARCHITECTURE,
+    NEST_11_VALIDATION,
+    NEST_11_ASYNC_LIFECYCLE,
+    NEST_11_PERFORMANCE,
+    NEST_11_SECURITY,
+    NEST_11_OBSERVABILITY,
+    NEST_11_TESTING,
+    NEST_11_MODERN,
+]);

package/dist/builtin/nest11-snippets.d.ts

@@ -0,0 +1,32 @@
+export declare const NEST11_THIN_CONTROLLERS: string;
+export declare const NEST11_SERVICE_OWNS_DOMAIN: string;
+export declare const NEST11_MODULE_PER_FEATURE: string;
+export declare const NEST11_MODULE_PUBLIC_API: string;
+export declare const NEST11_NO_CIRCULAR_MODULES: string;
+export declare const NEST11_DTO_AT_BOUNDARY: string;
+export declare const NEST11_GLOBAL_VALIDATION_PIPE: string;
+export declare const NEST11_CLASS_VALIDATOR_DTO: string;
+export declare const NEST11_REQUEST_RESPONSE_DTOS: string;
+export declare const NEST11_SWAGGER_DECORATORS: string;
+export declare const NEST11_LIFECYCLE_HOOKS: string;
+export declare const NEST11_ENABLE_SHUTDOWN_HOOKS: string;
+export declare const NEST11_ASYNC_PROVIDERS: string;
+export declare const NEST11_FASTIFY_ADAPTER: string;
+export declare const NEST11_CACHE_MANAGER: string;
+export declare const NEST11_THROTTLER: string;
+export declare const NEST11_PAGINATION_BY_DEFAULT: string;
+export declare const NEST11_HELMET: string;
+export declare const NEST11_EXPLICIT_CORS: string;
+export declare const NEST11_JWT_GUARDS: string;
+export declare const NEST11_NO_SECRETS_IN_CODE: string;
+export declare const NEST11_TRUST_PROXY_AWARE: string;
+export declare const NEST11_LOGGER_WITH_CONTEXT: string;
+export declare const NEST11_STRUCTURED_LOGS: string;
+export declare const NEST11_NO_LOG_SECRETS: string;
+export declare const NEST11_TERMINUS_HEALTH: string;
+export declare const NEST11_TESTING_MODULE: string;
+export declare const NEST11_E2E_SUPERTEST: string;
+export declare const NEST11_TEST_FILE_LAYOUT: string;
+export declare const NEST11_API_VERSIONING: string;
+export declare const NEST11_NO_QUERY_IN_CONTROLLER: string;
+//# sourceMappingURL=nest11-snippets.d.ts.map

package/dist/builtin/nest11-snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest11-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/nest11-snippets.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,uBAAuB,QAQlC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAQpC,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAQnC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAIH,eAAO,MAAM,6BAA6B,QAQxC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAEH,eAAO,MAAM,4BAA4B,QAQvC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAQpC,CAAC;AAIH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,4BAA4B,QAQvC,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAIH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAQ/B,CAAC;AAEH,eAAO,MAAM,gBAAgB,QAQ3B,CAAC;AAEH,eAAO,MAAM,4BAA4B,QAQvC,CAAC;AAIH,eAAO,MAAM,aAAa,QAQxB,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAQ/B,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAQ5B,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAQpC,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAQnC,CAAC;AAIH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAQhC,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAIH,eAAO,MAAM,qBAAqB,QAQhC,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAQ/B,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAQlC,CAAC;AAIH,eAAO,MAAM,qBAAqB,QAQhC,CAAC;AAEH,eAAO,MAAM,6BAA6B,QAQxC,CAAC"}