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

package/README.md

@@ -2,7 +2,7 @@
 
 SharkCraft presets: reusable project setups (knowledge/rules/paths/templates/pipelines/docs) that can be applied to a target repo through the CLI.
 
-Part of [SharkCraft](https://github.com/shrkcrft/sharkcraft) — a deterministic, local-first toolkit that gives AI coding agents durable project context. See the main repo for documentation, examples, and the `shrk` CLI.
+Part of [SharkCraft](https://github.com/sharkcraft/sharkcraft) — a deterministic, local-first toolkit that gives AI coding agents durable project context. See the main repo for documentation, examples, and the `shrk` CLI.
 
 ## Install
 

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;AA8jBlD,eAAO,MAAM,eAAe,EAAE,SAAS,OAAO,EA4C5C,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;AA6iBlD,eAAO,MAAM,eAAe,EAAE,SAAS,OAAO,EA0B5C,CAAC"}

package/dist/builtin/builtin-presets.js

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

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

@@ -14,8 +14,10 @@ export declare const ANGULAR_PERFORMANCE: IPreset;
 export declare const ANGULAR_TESTING: IPreset;
 export declare const ANGULAR_ACCESSIBILITY: IPreset;
 export declare const ANGULAR_SECURITY: IPreset;
+export declare const ANGULAR_PLUGIN_PLATFORM: IPreset;
 export declare const ANGULAR_ENTERPRISE_APP: IPreset;
 export declare const ANGULAR_LIBRARY: IPreset;
+export declare const ANGULAR_SMART_UI_PLATFORM: IPreset;
 export declare const VITEST_FOCUSED: IPreset;
 export declare const JEST_FOCUSED: IPreset;
 export declare const PLAYWRIGHT_FOCUSED: IPreset;
@@ -25,5 +27,5 @@ export declare const WEB_COMPONENT_LIBRARY: IPreset;
 export declare const NESTJS_SERVICE: IPreset;
 export declare const EXPRESS_SERVICE: IPreset;
 export declare const FASTIFY_SERVICE: IPreset;
-export declare const MULTI_STACK_PRESETS: readonly IPreset[];
+export declare const R26_PRESETS: readonly IPreset[];
 //# sourceMappingURL=r26-presets.d.ts.map

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;AAkDlD,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,sBAAsB,EAAE,OASnC,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,OAS5B,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,mBAAmB,EAAE,SAAS,OAAO,EA2BhD,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;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"}

package/dist/builtin/r26-presets.js

@@ -1,7 +1,7 @@
 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_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_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";
+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 { 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({
     id: 'generic-safe-repo',
@@ -156,7 +156,7 @@ export const MODERN_ANGULAR = definePreset({
             NG_ACCESSIBLE,
             NG_AVOID_BYPASS_SECURITY,
         ],
-        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES],
+        paths: [],
         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.') },
@@ -292,6 +292,22 @@ export const ANGULAR_SECURITY = definePreset({
         docs: { 'overview.md': OVERVIEW_DOC('Angular security', 'Avoid bypassSecurityTrust*. Sanitize user HTML. Validate route params.') },
     },
 });
+export const ANGULAR_PLUGIN_PLATFORM = definePreset({
+    id: 'angular-plugin-platform',
+    title: 'Angular — plugin platform',
+    description: 'Plugin contracts, lifecycle, capability tokens, isolation.',
+    tags: ['angular', 'plugins'],
+    appliesTo: [WorkspaceProfile.HasAngular],
+    weight: 5,
+    includes: {
+        knowledge: [],
+        rules: [NG_PLUGIN_STABLE_CONTRACT, NG_PLUGIN_NO_DEEP_IMPORTS],
+        paths: [],
+        templates: [],
+        pipelines: [],
+        docs: { 'overview.md': OVERVIEW_DOC('Angular plugin platform', 'Plugin contracts are stable. No plugin-to-plugin deep imports. Lifecycle is deterministic.') },
+    },
+});
 export const ANGULAR_ENTERPRISE_APP = definePreset({
     id: 'angular-enterprise-app',
     title: 'Angular enterprise app',
@@ -312,6 +328,16 @@ export const ANGULAR_LIBRARY = definePreset({
     composes: ['modern-angular', 'npm-package'],
     includes: { knowledge: [], rules: [], paths: [], templates: [], pipelines: [], docs: {} },
 });
+export const ANGULAR_SMART_UI_PLATFORM = definePreset({
+    id: 'angular-smart-ui-platform',
+    title: 'Angular smart UI platform',
+    description: 'Smart/dumb component split, deliberate state ownership, large-app organisation.',
+    tags: ['angular', 'ui-platform'],
+    appliesTo: [WorkspaceProfile.HasAngular],
+    weight: 6,
+    composes: ['modern-angular'],
+    includes: { knowledge: [], rules: [], paths: [], templates: [], pipelines: [], docs: {} },
+});
 // ─── Testing presets ───────────────────────────────────────────────────────
 export const VITEST_FOCUSED = definePreset({
     id: 'vitest-focused',
@@ -378,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: [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.') } },
+    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.') } },
 });
 export const EXPRESS_SERVICE = definePreset({
     id: 'express-service',
@@ -400,7 +426,7 @@ export const FASTIFY_SERVICE = definePreset({
     composes: ['node-service'],
     includes: { knowledge: [], rules: [], paths: [], templates: [], pipelines: [], docs: { 'overview.md': OVERVIEW_DOC('Fastify service', 'Schema-validate routes. Encapsulate features as plugins. Keep startup ordering deterministic.') } },
 });
-export const MULTI_STACK_PRESETS = Object.freeze([
+export const R26_PRESETS = Object.freeze([
     GENERIC_SAFE_REPO,
     AI_AGENT_SAFE_DEVELOPMENT,
     ENTERPRISE_REVIEW_GATED,
@@ -416,8 +442,10 @@ export const MULTI_STACK_PRESETS = Object.freeze([
     ANGULAR_TESTING,
     ANGULAR_ACCESSIBILITY,
     ANGULAR_SECURITY,
+    ANGULAR_PLUGIN_PLATFORM,
     ANGULAR_ENTERPRISE_APP,
     ANGULAR_LIBRARY,
+    ANGULAR_SMART_UI_PLATFORM,
     VITEST_FOCUSED,
     JEST_FOCUSED,
     PLAYWRIGHT_FOCUSED,

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

@@ -34,4 +34,6 @@ export declare const NG_NO_GOD_SERVICES: string;
 export declare const NG_DOMAIN_NO_UI_IMPORTS: string;
 export declare const NG_ACCESSIBLE: string;
 export declare const NG_AVOID_BYPASS_SECURITY: string;
+export declare const NG_PLUGIN_STABLE_CONTRACT: string;
+export declare const NG_PLUGIN_NO_DEEP_IMPORTS: string;
 //# sourceMappingURL=r26-snippets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"r26-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/r26-snippets.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAWT;AAID,eAAO,MAAM,SAAS,QAOpB,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAO9B,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAOlC,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAO9B,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAOjC,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAOlC,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAO5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAO7B,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAOrC,CAAC;AAEH,eAAO,MAAM,cAAc,QAOzB,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAOjC,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAO/B,CAAC;AAIH,eAAO,MAAM,wBAAwB,QAOnC,CAAC;AAEH,eAAO,MAAM,UAAU,QAOrB,CAAC;AAEH,eAAO,MAAM,gBAAgB,QAO3B,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAOtC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAOpC,CAAC;AAEH,eAAO,MAAM,WAAW,QAOtB,CAAC;AAEH,eAAO,MAAM,gCAAgC,QAO3C,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAOlC,CAAC;AAEH,eAAO,MAAM,cAAc,QAOzB,CAAC;AAEH,eAAO,MAAM,eAAe,QAO1B,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAOjC,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAO7B,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAO7B,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAOlC,CAAC;AAEH,eAAO,MAAM,aAAa,QAOxB,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAOnC,CAAC"}
+{"version":3,"file":"r26-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/r26-snippets.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAWT;AAID,eAAO,MAAM,SAAS,QAOpB,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAO9B,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAOlC,CAAC;AAEH,eAAO,MAAM,mBAAmB,QAO9B,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAOjC,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAOlC,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAO5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAO7B,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAOrC,CAAC;AAEH,eAAO,MAAM,cAAc,QAOzB,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAOjC,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAO/B,CAAC;AAIH,eAAO,MAAM,wBAAwB,QAOnC,CAAC;AAEH,eAAO,MAAM,UAAU,QAOrB,CAAC;AAEH,eAAO,MAAM,gBAAgB,QAO3B,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAOtC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAOpC,CAAC;AAEH,eAAO,MAAM,WAAW,QAOtB,CAAC;AAEH,eAAO,MAAM,gCAAgC,QAO3C,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAOlC,CAAC;AAEH,eAAO,MAAM,cAAc,QAOzB,CAAC;AAEH,eAAO,MAAM,eAAe,QAO1B,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAOjC,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAO7B,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAO7B,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAOlC,CAAC;AAEH,eAAO,MAAM,aAAa,QAOxB,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAOnC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAOpC,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAOpC,CAAC"}

package/dist/builtin/r26-snippets.js

@@ -239,3 +239,19 @@ export const NG_AVOID_BYPASS_SECURITY = ruleSnippet({
     appliesWhen: ['generate-code', 'review'],
     content: '`DomSanitizer.bypassSecurityTrust*` opens an XSS hole. Only use it with reviewed, trusted inputs — sanitize otherwise.',
 });
+export const NG_PLUGIN_STABLE_CONTRACT = ruleSnippet({
+    id: 'angular.plugin.stable-contract',
+    title: 'Plugin contracts are stable',
+    priority: 'critical',
+    tags: ['angular', 'plugins'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Plugin manifests, lifecycle hooks, and capability tokens are public API. Breaking changes require a migration note and a major-version bump.',
+});
+export const NG_PLUGIN_NO_DEEP_IMPORTS = ruleSnippet({
+    id: 'angular.plugin.no-deep-imports',
+    title: 'Plugins cannot deep-import each other',
+    priority: 'critical',
+    tags: ['angular', 'plugins', 'boundaries'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Plugin-to-plugin communication must use the documented event/token contract. Direct imports between plugin packages are forbidden.',
+});

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

@@ -3,5 +3,5 @@ export declare const NEXT_APP_PRESET: IPreset;
 export declare const TURBOREPO_PRESET: IPreset;
 export declare const PACKAGE_WORKSPACE_PRESET: IPreset;
 export declare const CLEAN_ARCHITECTURE_TS_PRESET: IPreset;
-export declare const UNIVERSAL_ADOPTION_PRESETS: readonly IPreset[];
+export declare const R45_PRESETS: readonly IPreset[];
 //# sourceMappingURL=r45-presets.d.ts.map

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;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,0BAA0B,EAAE,SAAS,OAAO,EAKvD,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;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"}

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, WORKSPACE_PATH_APPS, WORKSPACE_PATH_PACKAGES, } 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, } 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
@@ -52,7 +52,7 @@ export const NEXT_APP_PRESET = definePreset({
 export const TURBOREPO_PRESET = definePreset({
     id: 'turborepo',
     title: 'Turborepo monorepo',
-    description: 'Conventions for Turborepo workspaces: public entry points, no relative cross-package imports, run via the affected task graph.',
+    description: 'Conventions for Turborepo workspaces: package layer order, public entry points, no relative cross-package imports, run via the affected task graph.',
     tags: ['turborepo', 'monorepo'],
     appliesTo: [WorkspaceProfile.HasTurborepo, WorkspaceProfile.IsMonorepo],
     weight: 8,
@@ -80,7 +80,7 @@ export const TURBOREPO_PRESET = definePreset({
   })`,
         ],
         rules: [COMMON_SAFETY_RULE, COMMON_RULE_INTERFACE_PREFIX, COMMON_RULE_ONE_EXPORT],
-        paths: [WORKSPACE_PATH_APPS, WORKSPACE_PATH_PACKAGES],
+        paths: [COMMON_PATH_SERVICES, COMMON_PATH_UTILS, COMMON_PATH_TESTS],
         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: [WORKSPACE_PATH_PACKAGES],
+        paths: [COMMON_PATH_SERVICES, COMMON_PATH_UTILS, COMMON_PATH_TESTS],
         templates: [COMMON_TEMPLATE_SERVICE, COMMON_TEMPLATE_UTILITY, COMMON_TEMPLATE_TEST],
         pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV, COMMON_PIPELINE_UNIT_TEST],
         docs: {
@@ -178,7 +178,7 @@ export const CLEAN_ARCHITECTURE_TS_PRESET = definePreset({
         'shrk task "<task>"',
     ],
 });
-export const UNIVERSAL_ADOPTION_PRESETS = Object.freeze([
+export const R45_PRESETS = Object.freeze([
     NEXT_APP_PRESET,
     TURBOREPO_PRESET,
     PACKAGE_WORKSPACE_PRESET,

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

@@ -1,5 +1,5 @@
 import type { IPreset } from '../model/preset.js';
 export declare const NEST_SERVICE_PRESET: IPreset;
 export declare const ANGULAR_APP_PRESET: IPreset;
-export declare const CANONICAL_ALIAS_PRESETS: readonly IPreset[];
+export declare const R47_PRESETS: readonly IPreset[];
 //# sourceMappingURL=r47-presets.d.ts.map

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;AAuBlD,eAAO,MAAM,mBAAmB,EAAE,OA2BhC,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,OA2B/B,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,SAAS,OAAO,EAGpD,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;AAclD,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 { 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";
+import { COMMON_AGENT_BRIEFING, COMMON_SAFETY_RULE, 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: [NEST_PATH_SRC, NEST_PATH_E2E],
+        paths: [],
         templates: [],
         pipelines: [],
         docs: {
@@ -46,7 +46,7 @@ export const ANGULAR_APP_PRESET = definePreset({
     includes: {
         knowledge: [COMMON_AGENT_BRIEFING],
         rules: [COMMON_SAFETY_RULE],
-        paths: [ANGULAR_PATH_APP, ANGULAR_PATH_COMPONENTS, ANGULAR_PATH_SERVICES],
+        paths: [],
         templates: [],
         pipelines: [],
         docs: {
@@ -59,7 +59,7 @@ export const ANGULAR_APP_PRESET = definePreset({
         'shrk task "<task>"',
     ],
 });
-export const CANONICAL_ALIAS_PRESETS = Object.freeze([
+export const R47_PRESETS = Object.freeze([
     NEST_SERVICE_PRESET,
     ANGULAR_APP_PRESET,
 ]);

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

@@ -7,31 +7,9 @@ export declare const COMMON_TEMPLATE_SERVICE = "defineTemplate({\n    id: 'types
 export declare const COMMON_TEMPLATE_UTILITY = "defineTemplate({\n    id: 'typescript.utility',\n    name: 'typescript-utility',\n    description: 'A pure utility module (one exported function per file).',\n    tags: ['typescript', 'utility'],\n    scope: ['app'],\n    appliesWhen: ['generate-utility'],\n    variables: [\n      {\n        name: 'functionName',\n        required: true,\n        description: 'camelCase function name (e.g. formatDate).',\n        pattern: /^[a-z][A-Za-z0-9]+$/,\n      },\n    ],\n    targetPath: (v) => `src/utils/${v.functionName}.ts`,\n    content: (v) => `export function ${v.functionName}(): void {\\n  // TODO\\n}\\n`,\n  })";
 export declare const COMMON_TEMPLATE_TEST = "defineTemplate({\n    id: 'typescript.unit-test',\n    name: 'typescript-unit-test',\n    description: 'A bun:test unit-test skeleton for an existing module.',\n    tags: ['typescript', 'testing'],\n    scope: ['app'],\n    appliesWhen: ['generate-test'],\n    variables: [\n      {\n        name: 'subject',\n        required: true,\n        description: 'Subject name (used in describe + filename).',\n        pattern: /^[A-Za-z][A-Za-z0-9]+$/,\n      },\n    ],\n    targetPath: (v) => `tests/${v.subject}.spec.ts`,\n    content: (v) =>\n      `import { describe, expect, test } from 'bun:test';\\n\\ndescribe('${v.subject}', () => {\\n  test('placeholder', () => {\\n    expect(true).toBe(true);\\n  });\\n});\\n`,\n  })";
 export declare const TEMPLATE_HELPERS = "function kebab(s: string): string {\n  return s\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/[^A-Za-z0-9]+/g, '-')\n    .toLowerCase();\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 REACT_PATH_COMPONENTS = "defineKnowledgeEntry({\n    id: 'paths.react.components',\n    title: 'React components',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'react', 'components'],\n    scope: ['react'],\n    appliesWhen: ['generate-component'],\n    content: 'Components live under src/components/ (cross-feature shared) or under their feature folder. Keep each component in its own file; pair with a co-located *.test.tsx beside it.',\n    metadata: { path: 'src/components' },\n  })";
-export declare const REACT_PATH_HOOKS = "defineKnowledgeEntry({\n    id: 'paths.react.hooks',\n    title: 'React custom hooks',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'react', 'hooks'],\n    scope: ['react'],\n    appliesWhen: ['generate-hook'],\n    content: 'Custom hooks live under src/hooks/ (cross-feature) or under their feature folder. File and exported function are both named useX. Co-locate the test as useX.test.ts beside the hook.',\n    metadata: { path: 'src/hooks' },\n  })";
-export declare const REACT_PATH_PAGES = "defineKnowledgeEntry({\n    id: 'paths.react.pages',\n    title: 'React route / page components',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'react', 'pages', 'routing'],\n    scope: ['react'],\n    appliesWhen: ['create-feature', 'add-route'],\n    content: 'Top-level route components live under src/pages/ (React Router / TanStack Router convention) or under src/routes/. For Next.js app router, see src/app/<segment>/page.tsx instead \u2014 adjust this entry if your project uses that layout.',\n    metadata: { path: 'src/pages' },\n  })";
-export declare const REACT_PATH_LIB = "defineKnowledgeEntry({\n    id: 'paths.react.lib',\n    title: 'React app utilities + clients',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'react', 'lib'],\n    scope: ['react'],\n    appliesWhen: ['generate-utility', 'generate-code'],\n    content: 'Framework-agnostic helpers (formatters, validators, API clients) live under src/lib/. Keep them pure \u2014 no React imports unless the helper is a hook (in which case it belongs under src/hooks/).',\n    metadata: { path: 'src/lib' },\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_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  })";
+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  })";
+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  })";
 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;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;AAQN,eAAO,MAAM,qBAAqB,kgBAU7B,CAAC;AAEN,eAAO,MAAM,gBAAgB,wfAUxB,CAAC;AAEN,eAAO,MAAM,gBAAgB,qlBAUxB,CAAC;AAEN,eAAO,MAAM,cAAc,miBAUtB,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"}
+{"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,6VAS5B,CAAC;AAEN,eAAO,MAAM,iBAAiB,6TAQzB,CAAC;AAEN,eAAO,MAAM,iBAAiB,uTAQzB,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"}