@shrkcrft/presets 0.1.0-alpha.4 → 0.1.0-alpha.6

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

@@ -0,0 +1,9 @@
+import type { IPreset } from '../model/preset.js';
+export declare const ANGULAR_21_SIGNALS: IPreset;
+export declare const ANGULAR_21_ZONELESS: IPreset;
+export declare const ANGULAR_21_CONTROL_FLOW: IPreset;
+export declare const ANGULAR_21_RESOURCE: IPreset;
+export declare const ANGULAR_21_MODERN_DI: IPreset;
+export declare const ANGULAR_21_MODERN: IPreset;
+export declare const ANGULAR_21_PRESETS: readonly IPreset[];
+//# sourceMappingURL=angular21-presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"angular21-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/angular21-presets.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAmDlD,eAAO,MAAM,kBAAkB,EAAE,OAiC/B,CAAC;AAIH,eAAO,MAAM,mBAAmB,EAAE,OA8BhC,CAAC;AAIH,eAAO,MAAM,uBAAuB,EAAE,OAgCpC,CAAC;AAIH,eAAO,MAAM,mBAAmB,EAAE,OA6BhC,CAAC;AAIH,eAAO,MAAM,oBAAoB,EAAE,OA8BjC,CAAC;AAIH,eAAO,MAAM,iBAAiB,EAAE,OAgD9B,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,SAAS,OAAO,EAO/C,CAAC"}

package/dist/builtin/angular21-presets.js

@@ -0,0 +1,218 @@
+// Modern Angular 18 / 19 / 20 / 21 preset family.
+//
+// Six presets — five focused on a single area of the modernisation surface,
+// one comprehensive that composes the rest. They target Angular workspaces
+// (HasAngular) with `weight` set above `modern-angular` (R26, weight 9) so
+// the recommender prefers them when the workspace shape allows.
+//
+// Each preset's `paths` includes the standard Angular structure
+// (src/app/, src/app/components/, src/app/services/) so the init paths
+// advisory annotator can verify against the live workspace.
+import { WorkspaceProfile } from '@shrkcrft/workspace';
+import { definePreset } from "../define/define-preset.js";
+import { ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES, COMMON_AGENT_BRIEFING, COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST, COMMON_SAFETY_RULE, OVERVIEW_DOC, } from "./shared-snippets.js";
+import { NG21_AFTER_RENDER, NG21_BOOTSTRAP_APPLICATION, NG21_CONTROL_FLOW, NG21_DEFER, NG21_HTTP_RESOURCE, NG21_HYBRID_RENDERING, NG21_INJECT_FN, NG21_LET_TEMPLATE, NG21_LINKED_SIGNAL, NG21_MODEL_TWO_WAY, NG21_NG_OPTIMIZED_IMAGE, NG21_NO_EFFECT_FOR_DERIVED, NG21_NO_NGMODULES, NG21_NO_ZONE_APIS, NG21_PROVIDE_HTTP_FETCH, NG21_PROVIDED_IN_ROOT, NG21_RESOURCE_API, NG21_SELF_CLOSING_TAGS, NG21_SIGNAL_CONTENT_CHILD, NG21_SIGNAL_FORMS_INTEROP, NG21_SIGNAL_INPUTS, NG21_SIGNAL_OUTPUTS, NG21_SIGNAL_STATE, NG21_SIGNAL_VIEW_CHILD, NG21_TEST_NO_DETECT_CHANGES_OUTSIDE, NG21_TEST_SIGNAL_INPUT, NG21_ZONELESS, } from "./angular21-snippets.js";
+const NG21_TAGS = ['angular', 'angular-21', 'modern'];
+const NG21_NEXT_COMMANDS = [
+    'shrk doctor',
+    'shrk task "<task>"',
+    'shrk ci scaffold github-actions --quickstart',
+];
+// ─── 1) Signals — state, queries, inputs, outputs, model ─────────────────
+export const ANGULAR_21_SIGNALS = definePreset({
+    id: 'angular-21-signals',
+    title: 'Angular 21 — signal-everything',
+    description: 'Signal-based local state, queries (viewChild / viewChildren / contentChild / contentChildren as functions), inputs (input() / input.required()), outputs (output()), and two-way bindings (model()). Replaces every @Input/@Output/@ViewChild decorator with its signal-era counterpart.',
+    tags: [...NG21_TAGS, 'signals'],
+    appliesTo: [WorkspaceProfile.HasAngular],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NG21_SIGNAL_STATE,
+            NG21_LINKED_SIGNAL,
+            NG21_NO_EFFECT_FOR_DERIVED,
+            NG21_SIGNAL_VIEW_CHILD,
+            NG21_SIGNAL_CONTENT_CHILD,
+            NG21_SIGNAL_INPUTS,
+            NG21_SIGNAL_OUTPUTS,
+            NG21_MODEL_TWO_WAY,
+            NG21_SIGNAL_FORMS_INTEROP,
+        ],
+        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('Angular 21 signals', 'No @Input, no @Output, no @ViewChild, no EventEmitter. Local state in signal(), derived in computed()/linkedSignal(), side effects in effect(), queries via viewChild()/contentChild(), I/O via input()/output()/model().'),
+        },
+    },
+    recommendedNextCommands: NG21_NEXT_COMMANDS,
+});
+// ─── 2) Zoneless ──────────────────────────────────────────────────────────
+export const ANGULAR_21_ZONELESS = definePreset({
+    id: 'angular-21-zoneless',
+    title: 'Angular 21 — zoneless change detection',
+    description: 'Bootstrap with provideZonelessChangeDetection() and remove zone.js entirely. Codifies the "no NgZone APIs, signals drive CD" posture, plus the migration hints (signal-first state, afterNextRender for DOM-aware work).',
+    tags: [...NG21_TAGS, 'zoneless', 'performance'],
+    appliesTo: [WorkspaceProfile.HasAngular],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NG21_ZONELESS,
+            NG21_NO_ZONE_APIS,
+            NG21_SIGNAL_STATE,
+            NG21_AFTER_RENDER,
+            NG21_BOOTSTRAP_APPLICATION,
+            NG21_PROVIDE_HTTP_FETCH,
+        ],
+        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('Angular 21 zoneless', 'CD runs when signals change, inputs update, or events fire — not on every microtask. No NgZone.run / runOutsideAngular. DOM-aware code uses afterNextRender(). HttpClient uses the fetch backend.'),
+        },
+    },
+    recommendedNextCommands: NG21_NEXT_COMMANDS,
+});
+// ─── 3) Modern control flow + template ergonomics ────────────────────────
+export const ANGULAR_21_CONTROL_FLOW = definePreset({
+    id: 'angular-21-control-flow',
+    title: 'Angular 21 — modern template control flow',
+    description: 'Built-in @if / @for / @switch / @defer / @let blocks instead of *ngIf / *ngFor / [ngSwitch], self-closing component tags, NgOptimizedImage. Includes the migration guidance for legacy templates.',
+    tags: [...NG21_TAGS, 'templates', 'control-flow'],
+    appliesTo: [WorkspaceProfile.HasAngular],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NG21_CONTROL_FLOW,
+            NG21_DEFER,
+            NG21_LET_TEMPLATE,
+            NG21_SELF_CLOSING_TAGS,
+            NG21_NG_OPTIMIZED_IMAGE,
+        ],
+        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('Angular 21 control flow', '@if / @for (track is REQUIRED) / @switch / @defer / @let. Self-closing tags for content-less components. NgOptimizedImage with explicit width/height for every raster image.'),
+        },
+    },
+    recommendedNextCommands: [
+        ...NG21_NEXT_COMMANDS,
+        'ng generate @angular/core:control-flow',
+    ],
+});
+// ─── 4) Resource API — declarative async (signal-native) ─────────────────
+export const ANGULAR_21_RESOURCE = definePreset({
+    id: 'angular-21-resource',
+    title: 'Angular 21 — resource() / httpResource() / linkedSignal',
+    description: 'Declarative async state via resource() and httpResource(). Replaces the hand-rolled subscribe+loading+error triplet with a typed state machine driven by signals. Includes the linkedSignal pattern for writable derived values.',
+    tags: [...NG21_TAGS, 'async', 'resource'],
+    appliesTo: [WorkspaceProfile.HasAngular],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NG21_RESOURCE_API,
+            NG21_HTTP_RESOURCE,
+            NG21_LINKED_SIGNAL,
+            NG21_PROVIDE_HTTP_FETCH,
+            NG21_SIGNAL_STATE,
+        ],
+        paths: [ANGULAR_PATH_SERVICES, ANGULAR_PATH_APP],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('Angular 21 resource API', 'resource({ request, loader }) is the canonical async primitive — exposes value()/status()/error()/reload() as signals. httpResource(() => `/api/...`) for read endpoints. linkedSignal for writable state that follows a source.'),
+        },
+    },
+    recommendedNextCommands: NG21_NEXT_COMMANDS,
+});
+// ─── 5) Modern DI + lifecycle + bootstrap ────────────────────────────────
+export const ANGULAR_21_MODERN_DI = definePreset({
+    id: 'angular-21-modern-di',
+    title: 'Angular 21 — inject(), no NgModules, bootstrap modern',
+    description: 'inject() function over constructor parameters, providedIn root for tree-shakeable services, no new NgModules, bootstrapApplication() with the provideX() function family, afterNextRender() for DOM-aware lifecycle.',
+    tags: [...NG21_TAGS, 'di', 'lifecycle', 'bootstrap'],
+    appliesTo: [WorkspaceProfile.HasAngular],
+    weight: 11,
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            NG21_INJECT_FN,
+            NG21_PROVIDED_IN_ROOT,
+            NG21_NO_NGMODULES,
+            NG21_BOOTSTRAP_APPLICATION,
+            NG21_AFTER_RENDER,
+            NG21_PROVIDE_HTTP_FETCH,
+        ],
+        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_SERVICES],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('Angular 21 modern DI + bootstrap', 'inject() over constructor injection. @Injectable({ providedIn: "root" }) for tree-shakeable services. No new @NgModule. main.ts uses bootstrapApplication(AppComponent, { providers: [provideRouter, provideHttpClient(withFetch()), provideZonelessChangeDetection(), provideAnimationsAsync()] }).'),
+        },
+    },
+    recommendedNextCommands: NG21_NEXT_COMMANDS,
+});
+// ─── 6) The whole stack — composes all of the above ──────────────────────
+export const ANGULAR_21_MODERN = definePreset({
+    id: 'angular-21-modern',
+    title: 'Angular 21 — modern stack (signals + zoneless + control-flow + resource + DI)',
+    description: 'The canonical preset for a new Angular 21 app. Composes signals-everything, zoneless CD, modern control flow, resource() async, and inject()-based DI — plus the testing rules for signal inputs and SSR-safe HTTP. Use this unless you specifically want a narrower slice.',
+    tags: [...NG21_TAGS, 'comprehensive'],
+    appliesTo: [WorkspaceProfile.HasAngular, WorkspaceProfile.IsFrontend],
+    weight: 12,
+    composes: [
+        'angular-21-signals',
+        'angular-21-zoneless',
+        'angular-21-control-flow',
+        'angular-21-resource',
+        'angular-21-modern-di',
+    ],
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [
+            COMMON_SAFETY_RULE,
+            // Extras that don't fit into any single focused preset:
+            NG21_HYBRID_RENDERING,
+            NG21_TEST_SIGNAL_INPUT,
+            NG21_TEST_NO_DETECT_CHANGES_OUTSIDE,
+        ],
+        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES],
+        templates: [],
+        pipelines: [
+            COMMON_PIPELINE_CONTEXT_ONLY,
+            COMMON_PIPELINE_FEATURE_DEV,
+            COMMON_PIPELINE_UNIT_TEST,
+        ],
+        docs: {
+            'overview.md': OVERVIEW_DOC('Angular 21 modern stack', 'No decorators where a signal-era function exists. Zoneless CD. @if/@for/@defer/@let templates. resource() and httpResource() for async. inject() everywhere. bootstrapApplication with provideX functions — no NgModules. SSR via per-route RenderMode tags. Test signal inputs via fixture.componentRef.setInput().'),
+        },
+    },
+    recommendedNextCommands: [
+        'shrk doctor',
+        'shrk surface list',
+        'shrk task "<task>"',
+        'ng generate @angular/core:control-flow',
+        'ng generate @angular/core:signal-input-migration',
+        'ng generate @angular/core:signal-queries-migration',
+        'ng generate @angular/core:output-migration',
+    ],
+    surfaceProfile: 'small-app',
+});
+export const ANGULAR_21_PRESETS = Object.freeze([
+    ANGULAR_21_SIGNALS,
+    ANGULAR_21_ZONELESS,
+    ANGULAR_21_CONTROL_FLOW,
+    ANGULAR_21_RESOURCE,
+    ANGULAR_21_MODERN_DI,
+    ANGULAR_21_MODERN,
+]);

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

@@ -0,0 +1,28 @@
+export declare const NG21_SIGNAL_STATE: string;
+export declare const NG21_LINKED_SIGNAL: string;
+export declare const NG21_NO_EFFECT_FOR_DERIVED: string;
+export declare const NG21_SIGNAL_VIEW_CHILD: string;
+export declare const NG21_SIGNAL_CONTENT_CHILD: string;
+export declare const NG21_SIGNAL_INPUTS: string;
+export declare const NG21_SIGNAL_OUTPUTS: string;
+export declare const NG21_MODEL_TWO_WAY: string;
+export declare const NG21_ZONELESS: string;
+export declare const NG21_NO_ZONE_APIS: string;
+export declare const NG21_CONTROL_FLOW: string;
+export declare const NG21_DEFER: string;
+export declare const NG21_LET_TEMPLATE: string;
+export declare const NG21_SELF_CLOSING_TAGS: string;
+export declare const NG21_NG_OPTIMIZED_IMAGE: string;
+export declare const NG21_INJECT_FN: string;
+export declare const NG21_AFTER_RENDER: string;
+export declare const NG21_PROVIDED_IN_ROOT: string;
+export declare const NG21_NO_NGMODULES: string;
+export declare const NG21_BOOTSTRAP_APPLICATION: string;
+export declare const NG21_RESOURCE_API: string;
+export declare const NG21_HTTP_RESOURCE: string;
+export declare const NG21_HYBRID_RENDERING: string;
+export declare const NG21_PROVIDE_HTTP_FETCH: string;
+export declare const NG21_SIGNAL_FORMS_INTEROP: string;
+export declare const NG21_TEST_SIGNAL_INPUT: string;
+export declare const NG21_TEST_NO_DETECT_CHANGES_OUTSIDE: string;
+//# sourceMappingURL=angular21-snippets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"angular21-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/angular21-snippets.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,iBAAiB,QAQ5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAQ7B,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAIH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAQpC,CAAC;AAIH,eAAO,MAAM,kBAAkB,QAQ7B,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAQ9B,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAQ7B,CAAC;AAIH,eAAO,MAAM,aAAa,QAQxB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAQ5B,CAAC;AAIH,eAAO,MAAM,iBAAiB,QAQ5B,CAAC;AAEH,eAAO,MAAM,UAAU,QAQrB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAQ5B,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAQlC,CAAC;AAIH,eAAO,MAAM,cAAc,QAQzB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAQ5B,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAQhC,CAAC;AAIH,eAAO,MAAM,iBAAiB,QAQ5B,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAQrC,CAAC;AAIH,eAAO,MAAM,iBAAiB,QAQ5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAQ7B,CAAC;AAIH,eAAO,MAAM,qBAAqB,QAQhC,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAQlC,CAAC;AAIH,eAAO,MAAM,yBAAyB,QAQpC,CAAC;AAIH,eAAO,MAAM,sBAAsB,QAQjC,CAAC;AAEH,eAAO,MAAM,mCAAmC,QAQ9C,CAAC"}

package/dist/builtin/angular21-snippets.js

@@ -0,0 +1,243 @@
+// 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/builtin-presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/builtin-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA6iBlD,eAAO,MAAM,eAAe,EAAE,SAAS,OAAO,EA0B5C,CAAC"}
+{"version":3,"file":"builtin-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/builtin-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA4jBlD,eAAO,MAAM,eAAe,EAAE,SAAS,OAAO,EA+B5C,CAAC"}

package/dist/builtin/builtin-presets.js

@@ -1,9 +1,10 @@
 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 { 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 { R26_PRESETS } from "./r26-presets.js";
 import { R45_PRESETS } from "./r45-presets.js";
 import { R47_PRESETS } from "./r47-presets.js";
+import { ANGULAR_21_PRESETS } from "./angular21-presets.js";
 const GENERIC = definePreset({
     id: 'generic',
     title: 'Generic SharkCraft setup',
@@ -133,7 +134,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: {
@@ -177,11 +178,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 +375,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 +393,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 +429,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 +447,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 +465,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: {
@@ -517,4 +518,9 @@ export const BUILTIN_PRESETS = Object.freeze([
     ...R45_PRESETS,
     // Universal adoption top-5: nest-service, angular-app canonical aliases
     ...R47_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,
 ]);

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

@@ -1 +1 @@
-{"version":3,"file":"r26-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/r26-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA+ClD,eAAO,MAAM,iBAAiB,EAAE,OAe9B,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,OAgBtC,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,OAoBpC,CAAC;AAIH,eAAO,MAAM,iBAAiB,EAAE,OAgC9B,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,OAiBzB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,OAiBxB,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,OAmC3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,OAelC,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,OAerC,CAAC;AAEH,eAAO,MAAM,6BAA6B,EAAE,OAe1C,CAAC;AAEH,eAAO,MAAM,+BAA+B,EAAE,OAe5C,CAAC;AAEH,eAAO,MAAM,mBAAmB,EAAE,OAehC,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAe5B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,OAelC,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,OAe7B,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,OAepC,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,OASnC,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAS5B,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,OAStC,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,OAQ3B,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,OAQzB,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,OAO/B,CAAC;AAIH,eAAO,MAAM,gBAAgB,EAAE,OAS7B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,OAS3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,OAQlC,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,OAS3B,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAS5B,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAS5B,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EA6BxC,CAAC"}
+{"version":3,"file":"r26-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/r26-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAoDlD,eAAO,MAAM,iBAAiB,EAAE,OAe9B,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,OAgBtC,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,OAoBpC,CAAC;AAIH,eAAO,MAAM,iBAAiB,EAAE,OAgC9B,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,OAiBzB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,OAiBxB,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,OAmC3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,OAelC,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,OAerC,CAAC;AAEH,eAAO,MAAM,6BAA6B,EAAE,OAe1C,CAAC;AAEH,eAAO,MAAM,+BAA+B,EAAE,OAe5C,CAAC;AAEH,eAAO,MAAM,mBAAmB,EAAE,OAehC,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAe5B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,OAelC,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,OAe7B,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,OAepC,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,OASnC,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAS5B,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,OAStC,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,OAQ3B,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,OAQzB,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,OAO/B,CAAC;AAIH,eAAO,MAAM,gBAAgB,EAAE,OAS7B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,OAS3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,OAQlC,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,OAS3B,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAS5B,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAS5B,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EA6BxC,CAAC"}

package/dist/builtin/r26-presets.js

@@ -1,6 +1,6 @@
 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_RULE_INTERFACE_PREFIX, COMMON_RULE_NO_LOGIC_CONSTRUCTORS, COMMON_RULE_ONE_EXPORT, COMMON_SAFETY_RULE, OVERVIEW_DOC, } from "./shared-snippets.js";
+import { ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES, COMMON_AGENT_BRIEFING, 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, NEST_PATH_E2E, NEST_PATH_SRC, OVERVIEW_DOC, } from "./shared-snippets.js";
 import { NG_ACCESSIBLE, NG_AVOID_BYPASS_SECURITY, NG_DOMAIN_NO_UI_IMPORTS, NG_FEATURE_FOLDERS, NG_GUARDS_SMALL, NG_LAZY_ROUTES, NG_LIFECYCLE_SAFE_CLEANUP, NG_NO_BUSINESS_LOGIC_IN_TEMPLATE, NG_NO_DEEP_LIB_IMPORTS, NG_NO_GOD_SERVICES, NG_ON_PUSH, NG_PLUGIN_NO_DEEP_IMPORTS, NG_PLUGIN_STABLE_CONTRACT, NG_RXJS_NO_NESTED_SUBSCRIBE, NG_SIGNALS_FIRST, NG_STANDALONE_COMPONENTS, NG_TRACK_BY, NG_TYPED_REACTIVE_FORMS, TS_AGENT_SMALL_DIFFS, TS_BRANDED_IDS, TS_DISCRIMINATED_UNIONS, TS_ERROR_HANDLING, TS_NO_ANY, TS_NO_CIRCULAR_IMPORTS, TS_NO_DEEP_IMPORTS, TS_NO_FLOATING_PROMISES, TS_PREFER_SATISFIES, TS_PUBLIC_RETURN_TYPES, TS_READONLY_DEFAULT, TS_VALIDATE_BOUNDARY_INPUT, } from "./r26-snippets.js";
 // ─── Core ──────────────────────────────────────────────────────────────────
 export const GENERIC_SAFE_REPO = definePreset({
@@ -156,7 +156,7 @@ export const MODERN_ANGULAR = definePreset({
             NG_ACCESSIBLE,
             NG_AVOID_BYPASS_SECURITY,
         ],
-        paths: [],
+        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES],
         templates: [],
         pipelines: [COMMON_PIPELINE_FEATURE_DEV],
         docs: { 'overview.md': OVERVIEW_DOC('Modern Angular', 'Signals-first reactivity, RxJS used deliberately, standalone components, OnPush CD, lazy routes, typed forms, Nx-style boundaries.') },
@@ -404,7 +404,7 @@ export const NESTJS_SERVICE = definePreset({
     appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend],
     weight: 7,
     composes: ['node-service'],
-    includes: { knowledge: [], rules: [TS_VALIDATE_BOUNDARY_INPUT], paths: [], templates: [], pipelines: [], docs: { 'overview.md': OVERVIEW_DOC('NestJS service', 'Validate DTOs at controllers. Keep services thin. Use modules to enforce layers.') } },
+    includes: { knowledge: [], rules: [TS_VALIDATE_BOUNDARY_INPUT], paths: [NEST_PATH_SRC, NEST_PATH_E2E], templates: [], pipelines: [], docs: { 'overview.md': OVERVIEW_DOC('NestJS service', 'Validate DTOs at controllers. Keep services thin. Use modules to enforce layers.') } },
 });
 export const EXPRESS_SERVICE = definePreset({
     id: 'express-service',

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

@@ -1 +1 @@
-{"version":3,"file":"r45-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/r45-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAwBlD,eAAO,MAAM,eAAe,EAAE,OA+C5B,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,OA+C7B,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,OAuCrC,CAAC;AAEH,eAAO,MAAM,4BAA4B,EAAE,OAoDzC,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EAKxC,CAAC"}
+{"version":3,"file":"r45-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/r45-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA0BlD,eAAO,MAAM,eAAe,EAAE,OA+C5B,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,OA+C7B,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,OAuCrC,CAAC;AAEH,eAAO,MAAM,4BAA4B,EAAE,OAoDzC,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EAKxC,CAAC"}

package/dist/builtin/r45-presets.js

@@ -1,6 +1,6 @@
 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 { 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, WORKSPACE_PATH_APPS, WORKSPACE_PATH_PACKAGES, } from "./shared-snippets.js";
 // Universal adoption — fills four Phase-1 preset gaps:
 //   next-app, turborepo, package-workspace, clean-architecture-ts.
 // Each preset is generic — no project-specific anchors, no per-stack jargon
@@ -80,7 +80,7 @@ export const TURBOREPO_PRESET = definePreset({
   })`,
         ],
         rules: [COMMON_SAFETY_RULE, COMMON_RULE_INTERFACE_PREFIX, COMMON_RULE_ONE_EXPORT],
-        paths: [COMMON_PATH_SERVICES, COMMON_PATH_UTILS, COMMON_PATH_TESTS],
+        paths: [WORKSPACE_PATH_APPS, WORKSPACE_PATH_PACKAGES],
         templates: [COMMON_TEMPLATE_SERVICE, COMMON_TEMPLATE_UTILITY, COMMON_TEMPLATE_TEST],
         pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST],
         docs: {
@@ -116,7 +116,7 @@ export const PACKAGE_WORKSPACE_PRESET = definePreset({
   })`,
         ],
         rules: [COMMON_SAFETY_RULE, COMMON_RULE_INTERFACE_PREFIX, COMMON_RULE_ONE_EXPORT],
-        paths: [COMMON_PATH_SERVICES, COMMON_PATH_UTILS, COMMON_PATH_TESTS],
+        paths: [WORKSPACE_PATH_PACKAGES],
         templates: [COMMON_TEMPLATE_SERVICE, COMMON_TEMPLATE_UTILITY, COMMON_TEMPLATE_TEST],
         pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST],
         docs: {

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

@@ -1 +1 @@
-{"version":3,"file":"r47-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/r47-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAclD,eAAO,MAAM,mBAAmB,EAAE,OA2BhC,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,OA2B/B,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EAGxC,CAAC"}
+{"version":3,"file":"r47-presets.d.ts","sourceRoot":"","sources":["../../src/builtin/r47-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAuBlD,eAAO,MAAM,mBAAmB,EAAE,OA2BhC,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,OA2B/B,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EAGxC,CAAC"}

package/dist/builtin/r47-presets.js

@@ -1,6 +1,6 @@
 import { WorkspaceProfile } from '@shrkcrft/workspace';
 import { definePreset } from "../define/define-preset.js";
-import { COMMON_AGENT_BRIEFING, COMMON_SAFETY_RULE, OVERVIEW_DOC } from "./shared-snippets.js";
+import { ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES, COMMON_AGENT_BRIEFING, COMMON_SAFETY_RULE, NEST_PATH_E2E, NEST_PATH_SRC, OVERVIEW_DOC, } from "./shared-snippets.js";
 // Universal adoption (top 5) — canonical-id aliases.
 //
 // Why: canonical preset ids are `nest-service` and `angular-app`. The
@@ -22,7 +22,7 @@ export const NEST_SERVICE_PRESET = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE],
-        paths: [],
+        paths: [NEST_PATH_SRC, NEST_PATH_E2E],
         templates: [],
         pipelines: [],
         docs: {
@@ -46,7 +46,7 @@ export const ANGULAR_APP_PRESET = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE],
-        paths: [],
+        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES],
         templates: [],
         pipelines: [],
         docs: {

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

@@ -10,6 +10,24 @@ export declare const TEMPLATE_HELPERS = "function kebab(s: string): string {\n
 export declare const COMMON_PATH_SERVICES = "defineKnowledgeEntry({\n    id: 'paths.services',\n    title: 'Services live in src/services/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'services'],\n    scope: ['app'],\n    appliesWhen: ['generate-service'],\n    content: 'Service classes live in src/services/. One service per file.',\n    metadata: { path: 'src/services' },\n  })";
 export declare const COMMON_PATH_UTILS = "defineKnowledgeEntry({\n    id: 'paths.utils',\n    title: 'Utilities live in src/utils/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'utils'],\n    appliesWhen: ['generate-utility'],\n    content: 'Pure helpers live in src/utils/. One function per file.',\n    metadata: { path: 'src/utils' },\n  })";
 export declare const COMMON_PATH_TESTS = "defineKnowledgeEntry({\n    id: 'paths.tests',\n    title: 'Tests live in tests/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'tests'],\n    appliesWhen: ['generate-test'],\n    content: 'Unit tests live under tests/, mirroring src/. Use *.spec.ts.',\n    metadata: { path: 'tests' },\n  })";
+export declare const NX_PATH_LIBS = "defineKnowledgeEntry({\n    id: 'paths.nx.libs',\n    title: 'Nx libs root',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'nx', 'libs'],\n    scope: ['nx', 'monorepo'],\n    appliesWhen: ['generate-service', 'generate-utility', 'create-feature'],\n    content: 'Shared library code lives under libs/<area>/src/lib/. Each lib has a public index.ts; cross-lib imports go through the package name, never relative paths into src/.',\n    metadata: { path: 'libs' },\n  })";
+export declare const NX_PATH_APPS = "defineKnowledgeEntry({\n    id: 'paths.nx.apps',\n    title: 'Nx apps root',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'nx', 'apps'],\n    scope: ['nx', 'monorepo'],\n    appliesWhen: ['create-feature', 'create-app'],\n    content: 'Applications live under apps/<app>/. Frontends use apps/<app>/src/app/; backends use apps/<app>/src/. Keep app-specific code here and shared code in libs/.',\n    metadata: { path: 'apps' },\n  })";
+export declare const WORKSPACE_PATH_PACKAGES = "defineKnowledgeEntry({\n    id: 'paths.workspace.packages',\n    title: 'Workspace packages root',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'workspaces', 'monorepo'],\n    scope: ['monorepo', 'turborepo', 'workspaces'],\n    appliesWhen: ['generate-code', 'create-feature'],\n    content: 'Shared packages live under packages/<name>/. Each package exposes a stable public entry (package.json main/exports); cross-package imports go through the package name, never relative paths into src/.',\n    metadata: { path: 'packages' },\n  })";
+export declare const WORKSPACE_PATH_APPS = "defineKnowledgeEntry({\n    id: 'paths.workspace.apps',\n    title: 'Workspace apps root',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'workspaces', 'monorepo'],\n    scope: ['monorepo', 'turborepo', 'workspaces'],\n    appliesWhen: ['create-feature', 'create-app'],\n    content: 'Applications live under apps/<app>/. Each app has its own src/ root and depends on shared packages by name.',\n    metadata: { path: 'apps' },\n  })";
+export declare const ANGULAR_PATH_APP = "defineKnowledgeEntry({\n    id: 'paths.angular.app',\n    title: 'Angular app root',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Critical,\n    tags: ['paths', 'angular', 'app'],\n    scope: ['angular'],\n    appliesWhen: ['create-feature', 'generate-code'],\n    content: 'Angular workspace source lives under src/app/. Components, services, pipes and modules sit under here. Tests are co-located as *.spec.ts beside the unit under test.',\n    metadata: { path: 'src/app' },\n  })";
+export declare const ANGULAR_PATH_COMPONENTS = "defineKnowledgeEntry({\n    id: 'paths.angular.components',\n    title: 'Angular components',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'angular', 'components'],\n    scope: ['angular'],\n    appliesWhen: ['generate-component'],\n    content: 'Components live under src/app/components/ or src/app/<feature>/. Use the .component.ts suffix. Pair each component with a co-located *.spec.ts test.',\n    metadata: { path: 'src/app/components' },\n  })";
+export declare const ANGULAR_PATH_SERVICES = "defineKnowledgeEntry({\n    id: 'paths.angular.services',\n    title: 'Angular services',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'angular', 'services'],\n    scope: ['angular'],\n    appliesWhen: ['generate-service'],\n    content: 'Injectable services live under src/app/services/ (or alongside their feature folder). Use the .service.ts suffix. Provide via providedIn root unless feature-scoped.',\n    metadata: { path: 'src/app/services' },\n  })";
+export declare const NEST_PATH_SRC = "defineKnowledgeEntry({\n    id: 'paths.nest.src',\n    title: 'Nest module roots',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Critical,\n    tags: ['paths', 'nest', 'modules'],\n    scope: ['nestjs'],\n    appliesWhen: ['create-feature', 'generate-service', 'generate-code'],\n    content: 'Nest source lives under src/. Each feature gets a folder src/<feature>/ containing controller, service, module, and DTOs (one construct per file). Controllers stay thin; business logic lives in services.',\n    metadata: { path: 'src' },\n  })";
+export declare const NEST_PATH_E2E = "defineKnowledgeEntry({\n    id: 'paths.nest.e2e',\n    title: 'Nest e2e tests',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'nest', 'testing'],\n    scope: ['nestjs'],\n    appliesWhen: ['generate-test'],\n    content: 'End-to-end tests live under test/ (Nest convention, not tests/). Unit tests can be co-located as *.spec.ts next to the unit.',\n    metadata: { path: 'test' },\n  })";
+export declare const JAVA_MAVEN_PATH_MAIN = "defineKnowledgeEntry({\n    id: 'paths.java.maven.main',\n    title: 'Java Maven main source',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Critical,\n    tags: ['paths', 'java', 'maven'],\n    scope: ['java', 'maven'],\n    appliesWhen: ['generate-code'],\n    content: 'Main Java source lives under src/main/java/<package>/. Resources under src/main/resources/. Mirror tests under src/test/java/.',\n    metadata: { path: 'src/main/java' },\n  })";
+export declare const JAVA_MAVEN_PATH_TESTS = "defineKnowledgeEntry({\n    id: 'paths.java.maven.tests',\n    title: 'Java Maven tests',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'java', 'maven', 'tests'],\n    scope: ['java', 'maven'],\n    appliesWhen: ['generate-test'],\n    content: 'JUnit / Spring tests live under src/test/java/. Run via mvn test.',\n    metadata: { path: 'src/test/java' },\n  })";
+export declare const PYTHON_PATH_SRC = "defineKnowledgeEntry({\n    id: 'paths.python.src',\n    title: 'Python source root',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Critical,\n    tags: ['paths', 'python'],\n    scope: ['python'],\n    appliesWhen: ['generate-code'],\n    content: 'Source lives under src/<package>/ (PEP 517 src layout) or directly under <package>/ at the repo root. Pick one and stay consistent.',\n    metadata: { path: 'src' },\n  })";
+export declare const PYTHON_PATH_TESTS = "defineKnowledgeEntry({\n    id: 'paths.python.tests',\n    title: 'Python tests',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'python', 'tests'],\n    scope: ['python'],\n    appliesWhen: ['generate-test'],\n    content: 'Pytest tests live under tests/. Each test_*.py mirrors a module under src/.',\n    metadata: { path: 'tests' },\n  })";
+export declare const GO_PATH_CMD = "defineKnowledgeEntry({\n    id: 'paths.go.cmd',\n    title: 'Go entry points',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'go'],\n    scope: ['go'],\n    appliesWhen: ['create-app'],\n    content: 'Binary entry points live under cmd/<name>/main.go. Shared library code under pkg/ (public) or internal/ (module-private).',\n    metadata: { path: 'cmd' },\n  })";
+export declare const GO_PATH_PKG = "defineKnowledgeEntry({\n    id: 'paths.go.pkg',\n    title: 'Go shared packages',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'go'],\n    scope: ['go'],\n    appliesWhen: ['generate-code'],\n    content: 'Public packages live under pkg/<name>/. Tests are co-located as <name>_test.go. Run via go test ./...',\n    metadata: { path: 'pkg' },\n  })";
+export declare const GO_PATH_INTERNAL = "defineKnowledgeEntry({\n    id: 'paths.go.internal',\n    title: 'Go internal packages',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'go'],\n    scope: ['go'],\n    appliesWhen: ['generate-code'],\n    content: 'Module-private packages live under internal/<name>/. The Go compiler enforces that only the parent module can import these.',\n    metadata: { path: 'internal' },\n  })";
+export declare const RUST_PATH_SRC = "defineKnowledgeEntry({\n    id: 'paths.rust.src',\n    title: 'Rust crate source',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Critical,\n    tags: ['paths', 'rust'],\n    scope: ['rust'],\n    appliesWhen: ['generate-code'],\n    content: 'Crate source lives under src/. The entry point is src/lib.rs (library) or src/main.rs (binary). Modules nest as src/<mod>/mod.rs or src/<mod>.rs.',\n    metadata: { path: 'src' },\n  })";
+export declare const RUST_PATH_TESTS = "defineKnowledgeEntry({\n    id: 'paths.rust.tests',\n    title: 'Rust integration tests',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'rust', 'tests'],\n    scope: ['rust'],\n    appliesWhen: ['generate-test'],\n    content: 'Integration tests live under tests/<name>.rs. Unit tests live inline with #[cfg(test)] modules inside src/. Run via cargo test.',\n    metadata: { path: 'tests' },\n  })";
 export declare const COMMON_RULE_INTERFACE_PREFIX = "defineKnowledgeEntry({\n    id: 'typescript.interfaces.i-prefix',\n    title: 'Prefix interfaces with I',\n    type: KnowledgeType.Rule,\n    priority: KnowledgePriority.High,\n    tags: ['typescript', 'naming'],\n    appliesWhen: ['generate-code', 'refactor'],\n    content: 'Interfaces use an I-prefix (IUser, IConfig). Enums are preferred over unions for closed sets.',\n  })";
 export declare const COMMON_RULE_ONE_EXPORT = "defineKnowledgeEntry({\n    id: 'typescript.files.one-export',\n    title: 'One exported construct per file',\n    type: KnowledgeType.Rule,\n    priority: KnowledgePriority.High,\n    tags: ['typescript', 'structure'],\n    appliesWhen: ['generate-code'],\n    content: 'Each TypeScript file exports exactly one top-level construct. Helpers live in their own file.',\n  })";
 export declare const COMMON_RULE_NO_LOGIC_CONSTRUCTORS = "defineKnowledgeEntry({\n    id: 'typescript.constructors.no-logic',\n    title: 'No business logic in constructors',\n    type: KnowledgeType.Rule,\n    priority: KnowledgePriority.High,\n    tags: ['typescript'],\n    appliesWhen: ['generate-code'],\n    content: 'Constructors wire dependencies only. Initialization belongs in init().',\n  })";

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

@@ -1 +1 @@
-{"version":3,"file":"shared-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/shared-snippets.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,m9BAuB7B,CAAC;AAEN,eAAO,MAAM,kBAAkB,45BAoB1B,CAAC;AAEN,eAAO,MAAM,2BAA2B,s9CA6CnC,CAAC;AAEN,eAAO,MAAM,4BAA4B,s5BA6BpC,CAAC;AAEN,eAAO,MAAM,yBAAyB,yVAajC,CAAC;AAEN,eAAO,MAAM,uBAAuB,mtBAkB/B,CAAC;AAEN,eAAO,MAAM,uBAAuB,8mBAiB/B,CAAC;AAEN,eAAO,MAAM,oBAAoB,ytBAkB5B,CAAC;AAKN,eAAO,MAAM,gBAAgB,8JAK3B,CAAC;AAEH,eAAO,MAAM,oBAAoB,sYAU5B,CAAC;AAEN,eAAO,MAAM,iBAAiB,mWASzB,CAAC;AAEN,eAAO,MAAM,iBAAiB,yVASzB,CAAC;AAEN,eAAO,MAAM,4BAA4B,+XAQpC,CAAC;AAEN,eAAO,MAAM,sBAAsB,0XAQ9B,CAAC;AAEN,eAAO,MAAM,iCAAiC,6VAQzC,CAAC;AAEN,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,KAAG,MAK1D,CAAC"}
+{"version":3,"file":"shared-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/shared-snippets.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,m9BAuB7B,CAAC;AAEN,eAAO,MAAM,kBAAkB,45BAoB1B,CAAC;AAEN,eAAO,MAAM,2BAA2B,s9CA6CnC,CAAC;AAEN,eAAO,MAAM,4BAA4B,s5BA6BpC,CAAC;AAEN,eAAO,MAAM,yBAAyB,yVAajC,CAAC;AAEN,eAAO,MAAM,uBAAuB,mtBAkB/B,CAAC;AAEN,eAAO,MAAM,uBAAuB,8mBAiB/B,CAAC;AAEN,eAAO,MAAM,oBAAoB,ytBAkB5B,CAAC;AAKN,eAAO,MAAM,gBAAgB,8JAK3B,CAAC;AAEH,eAAO,MAAM,oBAAoB,sYAU5B,CAAC;AAEN,eAAO,MAAM,iBAAiB,mWASzB,CAAC;AAEN,eAAO,MAAM,iBAAiB,yVASzB,CAAC;AAaN,eAAO,MAAM,YAAY,sgBAUpB,CAAC;AAEN,eAAO,MAAM,YAAY,meAUpB,CAAC;AAIN,eAAO,MAAM,uBAAuB,6kBAU/B,CAAC;AAEN,eAAO,MAAM,mBAAmB,keAU3B,CAAC;AAGN,eAAO,MAAM,gBAAgB,2fAUxB,CAAC;AAEN,eAAO,MAAM,uBAAuB,qfAU/B,CAAC;AAEN,eAAO,MAAM,qBAAqB,2fAU7B,CAAC;AAGN,eAAO,MAAM,aAAa,gjBAUrB,CAAC;AAEN,eAAO,MAAM,aAAa,ubAUrB,CAAC;AAIN,eAAO,MAAM,oBAAoB,wdAU5B,CAAC;AAEN,eAAO,MAAM,qBAAqB,2ZAU7B,CAAC;AAEN,eAAO,MAAM,eAAe,4bAUvB,CAAC;AAEN,eAAO,MAAM,iBAAiB,uYAUzB,CAAC;AAEN,eAAO,MAAM,WAAW,4ZAUnB,CAAC;AAEN,eAAO,MAAM,WAAW,gZAUnB,CAAC;AAEN,eAAO,MAAM,gBAAgB,kbAUxB,CAAC;AAEN,eAAO,MAAM,aAAa,mcAUrB,CAAC;AAEN,eAAO,MAAM,eAAe,icAUvB,CAAC;AAEN,eAAO,MAAM,4BAA4B,+XAQpC,CAAC;AAEN,eAAO,MAAM,sBAAsB,0XAQ9B,CAAC;AAEN,eAAO,MAAM,iCAAiC,6VAQzC,CAAC;AAEN,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,KAAG,MAK1D,CAAC"}

package/dist/builtin/shared-snippets.js

@@ -232,6 +232,219 @@ export const COMMON_PATH_TESTS = `defineKnowledgeEntry({
     content: 'Unit tests live under tests/, mirroring src/. Use *.spec.ts.',
     metadata: { path: 'tests' },
   })`;
+// ─── Framework-specific path snippets ─────────────────────────────────────
+//
+// Each snippet uses the structured `metadata: { path: '<x>' }` field so
+// the init paths-advisory annotator can verify the path against the live
+// workspace. When an entry is emitted into a fresh repo whose layout
+// doesn't match, the user sees a `⚠️ Workspace-shape advisory` block
+// listing the absent paths.
+// Nx workspaces — `libs/<area>/src/lib/<feature>.service.ts`,
+// `apps/<app>/src/app/`. The exact lib/app folder names are
+// project-specific; we point at the roots.
+export const NX_PATH_LIBS = `defineKnowledgeEntry({
+    id: 'paths.nx.libs',
+    title: 'Nx libs root',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'nx', 'libs'],
+    scope: ['nx', 'monorepo'],
+    appliesWhen: ['generate-service', 'generate-utility', 'create-feature'],
+    content: 'Shared library code lives under libs/<area>/src/lib/. Each lib has a public index.ts; cross-lib imports go through the package name, never relative paths into src/.',
+    metadata: { path: 'libs' },
+  })`;
+export const NX_PATH_APPS = `defineKnowledgeEntry({
+    id: 'paths.nx.apps',
+    title: 'Nx apps root',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'nx', 'apps'],
+    scope: ['nx', 'monorepo'],
+    appliesWhen: ['create-feature', 'create-app'],
+    content: 'Applications live under apps/<app>/. Frontends use apps/<app>/src/app/; backends use apps/<app>/src/. Keep app-specific code here and shared code in libs/.',
+    metadata: { path: 'apps' },
+  })`;
+// Generic workspace monorepo (Turborepo, pnpm/yarn/npm workspaces): the
+// idiomatic layout is `apps/` + `packages/` rather than Nx's `libs/`.
+export const WORKSPACE_PATH_PACKAGES = `defineKnowledgeEntry({
+    id: 'paths.workspace.packages',
+    title: 'Workspace packages root',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'workspaces', 'monorepo'],
+    scope: ['monorepo', 'turborepo', 'workspaces'],
+    appliesWhen: ['generate-code', 'create-feature'],
+    content: 'Shared packages live under packages/<name>/. Each package exposes a stable public entry (package.json main/exports); cross-package imports go through the package name, never relative paths into src/.',
+    metadata: { path: 'packages' },
+  })`;
+export const WORKSPACE_PATH_APPS = `defineKnowledgeEntry({
+    id: 'paths.workspace.apps',
+    title: 'Workspace apps root',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'workspaces', 'monorepo'],
+    scope: ['monorepo', 'turborepo', 'workspaces'],
+    appliesWhen: ['create-feature', 'create-app'],
+    content: 'Applications live under apps/<app>/. Each app has its own src/ root and depends on shared packages by name.',
+    metadata: { path: 'apps' },
+  })`;
+// Single-app Angular workspaces — angular.json + src/app convention.
+export const ANGULAR_PATH_APP = `defineKnowledgeEntry({
+    id: 'paths.angular.app',
+    title: 'Angular app root',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Critical,
+    tags: ['paths', 'angular', 'app'],
+    scope: ['angular'],
+    appliesWhen: ['create-feature', 'generate-code'],
+    content: 'Angular workspace source lives under src/app/. Components, services, pipes and modules sit under here. Tests are co-located as *.spec.ts beside the unit under test.',
+    metadata: { path: 'src/app' },
+  })`;
+export const ANGULAR_PATH_COMPONENTS = `defineKnowledgeEntry({
+    id: 'paths.angular.components',
+    title: 'Angular components',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'angular', 'components'],
+    scope: ['angular'],
+    appliesWhen: ['generate-component'],
+    content: 'Components live under src/app/components/ or src/app/<feature>/. Use the .component.ts suffix. Pair each component with a co-located *.spec.ts test.',
+    metadata: { path: 'src/app/components' },
+  })`;
+export const ANGULAR_PATH_SERVICES = `defineKnowledgeEntry({
+    id: 'paths.angular.services',
+    title: 'Angular services',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'angular', 'services'],
+    scope: ['angular'],
+    appliesWhen: ['generate-service'],
+    content: 'Injectable services live under src/app/services/ (or alongside their feature folder). Use the .service.ts suffix. Provide via providedIn root unless feature-scoped.',
+    metadata: { path: 'src/app/services' },
+  })`;
+// NestJS services — module-per-folder convention; e2e tests in `test/`.
+export const NEST_PATH_SRC = `defineKnowledgeEntry({
+    id: 'paths.nest.src',
+    title: 'Nest module roots',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Critical,
+    tags: ['paths', 'nest', 'modules'],
+    scope: ['nestjs'],
+    appliesWhen: ['create-feature', 'generate-service', 'generate-code'],
+    content: 'Nest source lives under src/. Each feature gets a folder src/<feature>/ containing controller, service, module, and DTOs (one construct per file). Controllers stay thin; business logic lives in services.',
+    metadata: { path: 'src' },
+  })`;
+export const NEST_PATH_E2E = `defineKnowledgeEntry({
+    id: 'paths.nest.e2e',
+    title: 'Nest e2e tests',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Medium,
+    tags: ['paths', 'nest', 'testing'],
+    scope: ['nestjs'],
+    appliesWhen: ['generate-test'],
+    content: 'End-to-end tests live under test/ (Nest convention, not tests/). Unit tests can be co-located as *.spec.ts next to the unit.',
+    metadata: { path: 'test' },
+  })`;
+// ─── Polyglot path snippets ──────────────────────────────────────────────
+export const JAVA_MAVEN_PATH_MAIN = `defineKnowledgeEntry({
+    id: 'paths.java.maven.main',
+    title: 'Java Maven main source',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Critical,
+    tags: ['paths', 'java', 'maven'],
+    scope: ['java', 'maven'],
+    appliesWhen: ['generate-code'],
+    content: 'Main Java source lives under src/main/java/<package>/. Resources under src/main/resources/. Mirror tests under src/test/java/.',
+    metadata: { path: 'src/main/java' },
+  })`;
+export const JAVA_MAVEN_PATH_TESTS = `defineKnowledgeEntry({
+    id: 'paths.java.maven.tests',
+    title: 'Java Maven tests',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'java', 'maven', 'tests'],
+    scope: ['java', 'maven'],
+    appliesWhen: ['generate-test'],
+    content: 'JUnit / Spring tests live under src/test/java/. Run via mvn test.',
+    metadata: { path: 'src/test/java' },
+  })`;
+export const PYTHON_PATH_SRC = `defineKnowledgeEntry({
+    id: 'paths.python.src',
+    title: 'Python source root',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Critical,
+    tags: ['paths', 'python'],
+    scope: ['python'],
+    appliesWhen: ['generate-code'],
+    content: 'Source lives under src/<package>/ (PEP 517 src layout) or directly under <package>/ at the repo root. Pick one and stay consistent.',
+    metadata: { path: 'src' },
+  })`;
+export const PYTHON_PATH_TESTS = `defineKnowledgeEntry({
+    id: 'paths.python.tests',
+    title: 'Python tests',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'python', 'tests'],
+    scope: ['python'],
+    appliesWhen: ['generate-test'],
+    content: 'Pytest tests live under tests/. Each test_*.py mirrors a module under src/.',
+    metadata: { path: 'tests' },
+  })`;
+export const GO_PATH_CMD = `defineKnowledgeEntry({
+    id: 'paths.go.cmd',
+    title: 'Go entry points',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'go'],
+    scope: ['go'],
+    appliesWhen: ['create-app'],
+    content: 'Binary entry points live under cmd/<name>/main.go. Shared library code under pkg/ (public) or internal/ (module-private).',
+    metadata: { path: 'cmd' },
+  })`;
+export const GO_PATH_PKG = `defineKnowledgeEntry({
+    id: 'paths.go.pkg',
+    title: 'Go shared packages',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Medium,
+    tags: ['paths', 'go'],
+    scope: ['go'],
+    appliesWhen: ['generate-code'],
+    content: 'Public packages live under pkg/<name>/. Tests are co-located as <name>_test.go. Run via go test ./...',
+    metadata: { path: 'pkg' },
+  })`;
+export const GO_PATH_INTERNAL = `defineKnowledgeEntry({
+    id: 'paths.go.internal',
+    title: 'Go internal packages',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Medium,
+    tags: ['paths', 'go'],
+    scope: ['go'],
+    appliesWhen: ['generate-code'],
+    content: 'Module-private packages live under internal/<name>/. The Go compiler enforces that only the parent module can import these.',
+    metadata: { path: 'internal' },
+  })`;
+export const RUST_PATH_SRC = `defineKnowledgeEntry({
+    id: 'paths.rust.src',
+    title: 'Rust crate source',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Critical,
+    tags: ['paths', 'rust'],
+    scope: ['rust'],
+    appliesWhen: ['generate-code'],
+    content: 'Crate source lives under src/. The entry point is src/lib.rs (library) or src/main.rs (binary). Modules nest as src/<mod>/mod.rs or src/<mod>.rs.',
+    metadata: { path: 'src' },
+  })`;
+export const RUST_PATH_TESTS = `defineKnowledgeEntry({
+    id: 'paths.rust.tests',
+    title: 'Rust integration tests',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Medium,
+    tags: ['paths', 'rust', 'tests'],
+    scope: ['rust'],
+    appliesWhen: ['generate-test'],
+    content: 'Integration tests live under tests/<name>.rs. Unit tests live inline with #[cfg(test)] modules inside src/. Run via cargo test.',
+    metadata: { path: 'tests' },
+  })`;
 export const COMMON_RULE_INTERFACE_PREFIX = `defineKnowledgeEntry({
     id: 'typescript.interfaces.i-prefix',
     title: 'Prefix interfaces with I',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/presets",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.6",
   "description": "SharkCraft presets: reusable project setups (knowledge/rules/paths/templates/pipelines/docs) that can be applied to a target repo through the CLI.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -42,9 +42,9 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.4",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.4",
-    "@shrkcrft/workspace": "^0.1.0-alpha.4"
+    "@shrkcrft/core": "^0.1.0-alpha.6",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.6",
+    "@shrkcrft/workspace": "^0.1.0-alpha.6"
   },
   "publishConfig": {
     "access": "public"