@shrkcrft/presets 0.1.0-alpha.7 → 0.1.0-alpha.9

package/dist/builtin/angular21-snippets.js

@@ -1,243 +0,0 @@
-// Modern Angular 18 / 19 / 20 / 21 rule snippets.
-//
-// Covers the post-decorators wave: signal-based reactivity, signal-based
-// queries (`viewChild()` / `contentChild()` etc.), signal-based I/O
-// (`input()` / `output()` / `model()`), zoneless change detection, the new
-// template control flow (`@if` / `@for` / `@switch` / `@defer` / `@let`),
-// `inject()` over constructor DI, `afterRender` / `afterNextRender`,
-// `resource()` / `httpResource()`, `linkedSignal`, `NgOptimizedImage`,
-// self-closing component tags, and the no-NgModules / hybrid-rendering
-// posture.
-//
-// Each snippet is a string injected verbatim into a generated
-// `sharkcraft/*.ts` file; `defineKnowledgeEntry`, `KnowledgeType`, and
-// `KnowledgePriority` are provided by the local-mirror preamble the
-// synthesizer prepends.
-import { ruleSnippet } from "./r26-snippets.js";
-// ─── Signal-based reactivity (Angular 16+, fully baked by 19/20) ──────────
-export const NG21_SIGNAL_STATE = ruleSnippet({
-    id: 'angular21.signal-state',
-    title: 'Local component state lives in signals',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'signals'],
-    appliesWhen: ['generate-component', 'generate-code'],
-    content: 'Use signal() for every piece of component-local mutable state. Derive read-only values with computed(). Reserve effect() for side effects only (DOM imperative code, logging, external I/O) — never write to a signal from inside an effect.',
-});
-export const NG21_LINKED_SIGNAL = ruleSnippet({
-    id: 'angular21.linked-signal',
-    title: 'Use linkedSignal for writable derived state',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'signals'],
-    appliesWhen: ['generate-component', 'refactor'],
-    content: 'When you need a writable signal that resets whenever a source signal changes (e.g. a selection that follows a filtered list), use linkedSignal({ source, computation }) instead of an effect that pokes a writable signal — that pattern is officially discouraged.',
-});
-export const NG21_NO_EFFECT_FOR_DERIVED = ruleSnippet({
-    id: 'angular21.no-effect-for-derived',
-    title: 'Never derive state inside an effect()',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'signals'],
-    appliesWhen: ['generate-code', 'review'],
-    content: 'If you find yourself writing effect(() => mySignal.set(compute(otherSignal()))), switch to computed() or linkedSignal(). Writing inside effects breaks single-source-of-truth and reintroduces the very glitches signals were designed to remove.',
-});
-// ─── Signal-based queries (Angular 17.2+) ─────────────────────────────────
-export const NG21_SIGNAL_VIEW_CHILD = ruleSnippet({
-    id: 'angular21.signal-view-child',
-    title: 'Use viewChild() / viewChildren() functions, not @ViewChild',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'queries', 'signals'],
-    appliesWhen: ['generate-component', 'refactor'],
-    content: 'Replace @ViewChild and @ViewChildren with the viewChild() / viewChildren() functions. The signal form is reactive (you can pipe it through computed()/effect()), avoids the "expression has changed after it was checked" class of bug, and integrates with OnPush + zoneless out of the box. Use viewChild.required<ElementRef>("name") when the element is guaranteed.',
-});
-export const NG21_SIGNAL_CONTENT_CHILD = ruleSnippet({
-    id: 'angular21.signal-content-child',
-    title: 'Use contentChild() / contentChildren() functions, not @ContentChild',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'queries', 'signals'],
-    appliesWhen: ['generate-component', 'refactor'],
-    content: 'Replace @ContentChild and @ContentChildren with the contentChild() / contentChildren() functions. Same reactivity story as viewChild — and contentChild() resolves at the same lifecycle moment regardless of static/dynamic, so you no longer need the {static: true} workaround.',
-});
-// ─── Signal-based inputs / outputs (Angular 17.1+ / 17.3+) ───────────────
-export const NG21_SIGNAL_INPUTS = ruleSnippet({
-    id: 'angular21.signal-inputs',
-    title: 'Use input() and input.required(), not @Input()',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'inputs', 'signals'],
-    appliesWhen: ['generate-component', 'refactor'],
-    content: 'Declare inputs as `readonly user = input<User>()` or `readonly id = input.required<string>()` instead of @Input(). Signal inputs are read-only signals — call them as a function in the template (`{{ user() }}`) or pipe them through computed() in the class. Use the transform option for coerced inputs: `input(false, { transform: booleanAttribute })`.',
-});
-export const NG21_SIGNAL_OUTPUTS = ruleSnippet({
-    id: 'angular21.signal-outputs',
-    title: 'Use output(), not @Output() EventEmitter',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'outputs', 'signals'],
-    appliesWhen: ['generate-component', 'refactor'],
-    content: 'Declare outputs as `readonly select = output<UserId>()` instead of `@Output() select = new EventEmitter<UserId>()`. The output() helper drops the RxJS dependency, is fully typed, and emits via `this.select.emit(id)`. It still composes with `outputToObservable()` when a stream is needed.',
-});
-export const NG21_MODEL_TWO_WAY = ruleSnippet({
-    id: 'angular21.model-two-way',
-    title: 'Use model() for two-way bindings',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'inputs', 'outputs', 'signals'],
-    appliesWhen: ['generate-component'],
-    content: 'For components that own a piece of state the parent wants to bind two-way, use `readonly value = model<string>("")`. Banana-in-a-box syntax (`[(value)]="x"`) wires up automatically — no manual @Input + @Output pair, no `valueChange` EventEmitter.',
-});
-// ─── Zoneless change detection (stable in Angular 21) ─────────────────────
-export const NG21_ZONELESS = ruleSnippet({
-    id: 'angular21.zoneless',
-    title: 'Configure zoneless change detection',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'zoneless', 'performance'],
-    appliesWhen: ['bootstrap', 'configure'],
-    content: 'Bootstrap with provideZonelessChangeDetection() and remove `zone.js` from polyfills + angular.json. Once zoneless, change detection runs only when a signal changes, an input updates, an event handler fires, or a marked component opts in via markForCheck(). Verify by reading the platform: ApplicationRef.componentTypes should not include any zone-aware regressions.',
-});
-export const NG21_NO_ZONE_APIS = ruleSnippet({
-    id: 'angular21.no-zone-apis',
-    title: 'Do not call NgZone APIs in zoneless code',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'zoneless'],
-    appliesWhen: ['generate-code', 'review'],
-    content: 'In zoneless apps NgZone.run / runOutsideAngular are no-ops. Replace them with explicit ChangeDetectorRef.markForCheck() (rare), afterNextRender() for DOM-aware logic, or simply let the signal graph propagate.',
-});
-// ─── New template control flow (Angular 17+) ──────────────────────────────
-export const NG21_CONTROL_FLOW = ruleSnippet({
-    id: 'angular21.control-flow',
-    title: 'Use @if / @for / @switch, not *ngIf / *ngFor / [ngSwitch]',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'templates'],
-    appliesWhen: ['generate-template', 'refactor'],
-    content: 'Built-in control flow is the canonical form. `@if`, `@else if`, `@else`; `@for (item of items; track item.id)` — track is REQUIRED, not optional; `@switch (x) { @case (\'a\') { … } @default { … } }`. Migrate legacy structural directives with `ng generate @angular/core:control-flow`.',
-});
-export const NG21_DEFER = ruleSnippet({
-    id: 'angular21.defer',
-    title: 'Use @defer for non-critical UI',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'templates', 'performance'],
-    appliesWhen: ['generate-template', 'optimize-bundle'],
-    content: 'Wrap heavy, below-the-fold, or interaction-gated UI in `@defer (on viewport)` / `(on hover)` / `(on idle)` / `(when condition())`. Pair with `@placeholder`, `@loading`, and `@error` blocks. Each @defer block is its own lazy-loaded chunk — no manual `loadComponent` plumbing needed.',
-});
-export const NG21_LET_TEMPLATE = ruleSnippet({
-    id: 'angular21.let-template',
-    title: 'Use @let for template-local values',
-    priority: 'medium',
-    tags: ['angular', 'angular-21', 'templates'],
-    appliesWhen: ['generate-template'],
-    content: 'Introduce template-scoped names with `@let total = items().reduce(...)`. This replaces the `*ngIf="x as y"` aliasing trick — works anywhere in the template, no implicit-element baggage.',
-});
-export const NG21_SELF_CLOSING_TAGS = ruleSnippet({
-    id: 'angular21.self-closing-tags',
-    title: 'Self-close components with no content children',
-    priority: 'low',
-    tags: ['angular', 'angular-21', 'templates'],
-    appliesWhen: ['generate-template'],
-    content: 'Components / directives that take no projected content should be written `<app-foo [x]="y" />`, not `<app-foo …></app-foo>`. Saves a token and matches modern Angular / JSX conventions.',
-});
-export const NG21_NG_OPTIMIZED_IMAGE = ruleSnippet({
-    id: 'angular21.ng-optimized-image',
-    title: 'Use NgOptimizedImage for raster images',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'performance', 'a11y'],
-    appliesWhen: ['generate-template'],
-    content: 'Replace `<img src="...">` with `<img ngSrc="..." width="…" height="…" priority? />`. NgOptimizedImage adds automatic responsive `srcset`, lazy-loads non-priority images, sets fetchpriority on LCP images, and enforces explicit dimensions to prevent layout shift.',
-});
-// ─── inject(), afterRender, modern lifecycle (Angular 14+ / 16+) ──────────
-export const NG21_INJECT_FN = ruleSnippet({
-    id: 'angular21.inject-fn',
-    title: 'Use inject(), not constructor parameters',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'di'],
-    appliesWhen: ['generate-component', 'generate-service', 'refactor'],
-    content: 'Default to `private readonly users = inject(UsersService)` over constructor-parameter injection. Required for functional guards / interceptors, makes inheritance straightforward, and removes the need for `@Self()` / `@SkipSelf()` / `@Optional()` decorator stacks (use the options bag instead).',
-});
-export const NG21_AFTER_RENDER = ruleSnippet({
-    id: 'angular21.after-render',
-    title: 'Use afterNextRender / afterRender for DOM-aware logic',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'lifecycle'],
-    appliesWhen: ['generate-component'],
-    content: 'For code that needs the DOM (measuring, focusing, third-party libs): use afterNextRender(() => …) for one-shot setup or afterRender(() => …) for every CD pass. Both run only in the browser, so they\'re SSR-safe by construction — replacing the ngAfterViewInit + isPlatformBrowser dance.',
-});
-export const NG21_PROVIDED_IN_ROOT = ruleSnippet({
-    id: 'angular21.provided-in-root',
-    title: 'Services use providedIn: \'root\' (tree-shakeable)',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'di', 'services'],
-    appliesWhen: ['generate-service'],
-    content: 'Inject services via `@Injectable({ providedIn: "root" })` so unused services tree-shake out. Only override with component / route providers when you need a fresh instance per consumer.',
-});
-// ─── No NgModules / standalone-only ───────────────────────────────────────
-export const NG21_NO_NGMODULES = ruleSnippet({
-    id: 'angular21.no-ngmodules',
-    title: 'Do not create new NgModules',
-    priority: 'critical',
-    tags: ['angular', 'angular-21', 'architecture'],
-    appliesWhen: ['generate-code', 'create-feature'],
-    content: 'Angular 21 starter apps are NgModule-free. Components, directives, and pipes are standalone by default (the `standalone: true` flag is the default since v19). Configure providers via `provideX()` functions in bootstrapApplication() or route data, never with @NgModule. If you find yourself writing @NgModule, you are working against the grain.',
-});
-export const NG21_BOOTSTRAP_APPLICATION = ruleSnippet({
-    id: 'angular21.bootstrap-application',
-    title: 'bootstrap via bootstrapApplication + provideX functions',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'bootstrap'],
-    appliesWhen: ['bootstrap'],
-    content: 'main.ts uses bootstrapApplication(AppComponent, { providers: [provideRouter(routes), provideHttpClient(withFetch()), provideZonelessChangeDetection(), provideAnimationsAsync()] }). Each capability has a provideX() — no AppModule needed.',
-});
-// ─── Async data: resource() / httpResource() (Angular 19/20+) ────────────
-export const NG21_RESOURCE_API = ruleSnippet({
-    id: 'angular21.resource-api',
-    title: 'Model async state with resource()',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'async', 'signals'],
-    appliesWhen: ['generate-component', 'generate-service'],
-    content: 'For "fetch X based on signal Y" patterns, use resource({ request: () => y(), loader: ({ request, abortSignal }) => fetch(...) }). The resource exposes `.value()`, `.status()`, `.error()`, and `.reload()` — a fully-typed state machine driven by signals. Don\'t hand-roll subscription + loading-state + error-state triplets anymore.',
-});
-export const NG21_HTTP_RESOURCE = ruleSnippet({
-    id: 'angular21.http-resource',
-    title: 'Use httpResource() for declarative HTTP',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'http', 'signals'],
-    appliesWhen: ['generate-service'],
-    content: 'For straight reads, `const user = httpResource<User>(() => \\`/api/users/${id()}\\`)` replaces an HttpClient.get + BehaviorSubject + loading flag triple. The signal in the URL closure is tracked; updating it refetches.',
-});
-// ─── Modern SSR / hybrid rendering (Angular 19+) ─────────────────────────
-export const NG21_HYBRID_RENDERING = ruleSnippet({
-    id: 'angular21.hybrid-rendering',
-    title: 'Configure routes with server-rendering modes',
-    priority: 'medium',
-    tags: ['angular', 'angular-21', 'ssr'],
-    appliesWhen: ['configure-routes'],
-    content: 'In app.routes.server.ts, tag each route with a RenderMode: `Prerender` for static, `Server` for per-request SSR, `Client` for CSR-only. The default `provideServerRouting(serverRoutes)` enforces the boundary — no more "did this code accidentally run on the server?" guesswork.',
-});
-export const NG21_PROVIDE_HTTP_FETCH = ruleSnippet({
-    id: 'angular21.provide-http-fetch',
-    title: 'provideHttpClient(withFetch()) — never the XHR backend',
-    priority: 'high',
-    tags: ['angular', 'angular-21', 'http', 'ssr'],
-    appliesWhen: ['configure'],
-    content: 'Provide HttpClient with the fetch backend (`provideHttpClient(withFetch())`). XHR breaks under SSR and pays a startup cost; fetch is universal, supports streaming, and is required for resource transfer between server and client.',
-});
-// ─── Forms — modern signal-compatible patterns ───────────────────────────
-export const NG21_SIGNAL_FORMS_INTEROP = ruleSnippet({
-    id: 'angular21.signal-forms-interop',
-    title: 'Bridge reactive forms into signals with toSignal()',
-    priority: 'medium',
-    tags: ['angular', 'angular-21', 'forms', 'signals'],
-    appliesWhen: ['generate-component'],
-    content: 'When you need a form value as a signal, do `const value = toSignal(form.valueChanges, { initialValue: form.getRawValue() })`. Don\'t mix .subscribe() into a component that otherwise relies on signal-driven CD — that subscription will leak.',
-});
-// ─── Testing — modern flow ───────────────────────────────────────────────
-export const NG21_TEST_SIGNAL_INPUT = ruleSnippet({
-    id: 'angular21.test-signal-input',
-    title: 'Set signal inputs in tests via setInput()',
-    priority: 'medium',
-    tags: ['angular', 'angular-21', 'testing'],
-    appliesWhen: ['generate-test'],
-    content: 'In TestBed, set signal-input values with `fixture.componentRef.setInput("user", u)` — not by assigning `component.user`. Detection runs only when the input signal is updated, and setInput is the supported path that triggers it.',
-});
-export const NG21_TEST_NO_DETECT_CHANGES_OUTSIDE = ruleSnippet({
-    id: 'angular21.test-no-detect-changes-outside',
-    title: 'Let the framework drive CD in tests',
-    priority: 'low',
-    tags: ['angular', 'angular-21', 'testing'],
-    appliesWhen: ['generate-test'],
-    content: 'In zoneless tests, call `fixture.detectChanges()` only at deliberate "settle" points; signal updates inside the test run schedule the next CD automatically. Sprinkling detectChanges() after every assignment masks real reactivity bugs.',
-});

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

@@ -1,11 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,257 +0,0 @@
-// 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

@@ -1,32 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}