@shrkcrft/presets 0.1.0-alpha.1

package/dist/builtin/r26-snippets.js

@@ -0,0 +1,257 @@
+// Reusable rule / knowledge expression strings for the Modern Angular preset library.
+// These are embedded verbatim into the synthesized sharkcraft/*.ts files,
+// using `defineKnowledgeEntry` from @shrkcrft/knowledge.
+export function ruleSnippet(opts) {
+    const prio = opts.priority.charAt(0).toUpperCase() + opts.priority.slice(1);
+    return `defineKnowledgeEntry({
+    id: ${JSON.stringify(opts.id)},
+    title: ${JSON.stringify(opts.title)},
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.${prio},
+    tags: ${JSON.stringify(opts.tags)},
+    appliesWhen: ${JSON.stringify(opts.appliesWhen)},
+    content: ${JSON.stringify(opts.content)},
+  })`;
+}
+// ─── Strict TypeScript rules ───────────────────────────────────────────────
+export const TS_NO_ANY = ruleSnippet({
+    id: 'ts.no-any',
+    title: 'Avoid `any` in public surfaces',
+    priority: 'critical',
+    tags: ['typescript', 'safety'],
+    appliesWhen: ['generate-code', 'refactor', 'review'],
+    content: 'Avoid `any` unless isolated and justified. Prefer `unknown` for external input and narrow it explicitly. Use type assertions only when no other option exists.',
+});
+export const TS_PREFER_SATISFIES = ruleSnippet({
+    id: 'ts.prefer-satisfies',
+    title: 'Prefer `satisfies` over object casts',
+    priority: 'high',
+    tags: ['typescript'],
+    appliesWhen: ['generate-code', 'refactor'],
+    content: 'Use `satisfies` for object-shape validation to preserve narrowed literal types instead of `as` casts.',
+});
+export const TS_DISCRIMINATED_UNIONS = ruleSnippet({
+    id: 'ts.discriminated-unions',
+    title: 'Use discriminated unions for state machines',
+    priority: 'high',
+    tags: ['typescript', 'state'],
+    appliesWhen: ['generate-code'],
+    content: 'Model finite-state shapes as discriminated unions (`type T = { kind: "a"; … } | { kind: "b"; … }`), not booleans + optional fields.',
+});
+export const TS_READONLY_DEFAULT = ruleSnippet({
+    id: 'ts.readonly-default',
+    title: 'Prefer `readonly` for immutable data',
+    priority: 'medium',
+    tags: ['typescript'],
+    appliesWhen: ['generate-code'],
+    content: 'Use `readonly` arrays/properties whenever mutation is not part of the contract — it documents intent and unlocks safer call sites.',
+});
+export const TS_PUBLIC_RETURN_TYPES = ruleSnippet({
+    id: 'ts.public-return-types',
+    title: 'Annotate public function return types',
+    priority: 'high',
+    tags: ['typescript', 'api'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Public/exported functions must declare an explicit return type — TS infers internally, but the signature is part of the contract.',
+});
+export const TS_NO_FLOATING_PROMISES = ruleSnippet({
+    id: 'ts.no-floating-promises',
+    title: 'Never let a Promise float',
+    priority: 'critical',
+    tags: ['typescript', 'async'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Always `await` or explicitly `.catch()` rejected promises. Floating promises hide errors and produce nondeterministic ordering.',
+});
+export const TS_ERROR_HANDLING = ruleSnippet({
+    id: 'ts.error-handling',
+    title: 'Model expected failures, do not swallow errors',
+    priority: 'critical',
+    tags: ['typescript', 'errors'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Throw typed errors (or use Result types) for expected failure paths. Preserve `cause` when wrapping. Never `catch (e) { /* ignore */ }`.',
+});
+export const TS_NO_DEEP_IMPORTS = ruleSnippet({
+    id: 'ts.no-deep-imports',
+    title: 'No deep imports across package boundaries',
+    priority: 'critical',
+    tags: ['typescript', 'monorepo'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Import only from a package\'s public entrypoint (`@scope/pkg`), never from internal files (`@scope/pkg/src/internal/...`).',
+});
+export const TS_VALIDATE_BOUNDARY_INPUT = ruleSnippet({
+    id: 'ts.validate-boundary-input',
+    title: 'Validate untrusted input at boundaries',
+    priority: 'high',
+    tags: ['typescript', 'safety'],
+    appliesWhen: ['generate-code'],
+    content: 'External payloads (HTTP, IPC, files) must be parsed/validated (e.g. zod, custom guard) before crossing into the typed domain.',
+});
+export const TS_BRANDED_IDS = ruleSnippet({
+    id: 'ts.branded-ids',
+    title: 'Brand critical identifiers',
+    priority: 'medium',
+    tags: ['typescript', 'modeling'],
+    appliesWhen: ['generate-code'],
+    content: 'For ids that travel widely (UserId, OrderId, etc.) use branded types so they cannot be accidentally swapped with raw strings/numbers.',
+});
+export const TS_NO_CIRCULAR_IMPORTS = ruleSnippet({
+    id: 'ts.no-circular-imports',
+    title: 'No circular imports',
+    priority: 'critical',
+    tags: ['typescript', 'monorepo'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Cycles produce unpredictable initialisation order. If you need bidirectional knowledge, split into a shared types module both sides depend on.',
+});
+export const TS_AGENT_SMALL_DIFFS = ruleSnippet({
+    id: 'ts.agent.small-diffs',
+    title: 'Prefer small incremental changes',
+    priority: 'high',
+    tags: ['typescript', 'agent'],
+    appliesWhen: ['generate-code', 'refactor'],
+    content: 'AI agents must inspect existing patterns before generating. Prefer minimal, targeted changes; do not rewrite architecture without an explicit instruction.',
+});
+// ─── Modern Angular rules ──────────────────────────────────────────────────
+export const NG_STANDALONE_COMPONENTS = ruleSnippet({
+    id: 'angular.standalone-components',
+    title: 'Prefer standalone components',
+    priority: 'high',
+    tags: ['angular', 'architecture'],
+    appliesWhen: ['generate-code'],
+    content: 'New components, directives and pipes should be standalone unless an existing NgModule contract requires otherwise.',
+});
+export const NG_ON_PUSH = ruleSnippet({
+    id: 'angular.on-push',
+    title: 'Use OnPush change detection',
+    priority: 'high',
+    tags: ['angular', 'performance'],
+    appliesWhen: ['generate-code'],
+    content: 'Components default to `ChangeDetectionStrategy.OnPush` unless they intentionally rely on default CD. Combine with signals/observables for explicit reactivity.',
+});
+export const NG_SIGNALS_FIRST = ruleSnippet({
+    id: 'angular.signals-first',
+    title: 'Prefer signals for local reactive state',
+    priority: 'high',
+    tags: ['angular', 'signals'],
+    appliesWhen: ['generate-code'],
+    content: 'Use `signal()` for local state and `computed()` for derived values. Use `effect()` only for side effects (DOM/I/O). Do not write to signals inside effects.',
+});
+export const NG_RXJS_NO_NESTED_SUBSCRIBE = ruleSnippet({
+    id: 'angular.rxjs.no-nested-subscribe',
+    title: 'No nested `subscribe`',
+    priority: 'critical',
+    tags: ['angular', 'rxjs'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Use `switchMap` / `concatMap` / `mergeMap` / `exhaustMap` deliberately to compose streams. A second `.subscribe()` inside a `.subscribe()` body is almost always a bug.',
+});
+export const NG_LIFECYCLE_SAFE_CLEANUP = ruleSnippet({
+    id: 'angular.rxjs.lifecycle-cleanup',
+    title: 'Use lifecycle-safe cleanup for subscriptions',
+    priority: 'high',
+    tags: ['angular', 'rxjs'],
+    appliesWhen: ['generate-code'],
+    content: 'Wire subscriptions through `takeUntilDestroyed()` (Angular 16+) or a destroy `Subject` so observables tear down with the component.',
+});
+export const NG_TRACK_BY = ruleSnippet({
+    id: 'angular.track-by',
+    title: 'Use `trackBy` / `@for track`',
+    priority: 'high',
+    tags: ['angular', 'performance'],
+    appliesWhen: ['generate-code'],
+    content: 'Always supply a `trackBy` function (or `track` expression in the new control flow) for lists to avoid full DOM re-rendering on every change.',
+});
+export const NG_NO_BUSINESS_LOGIC_IN_TEMPLATE = ruleSnippet({
+    id: 'angular.no-business-logic-in-template',
+    title: 'Keep business logic out of templates',
+    priority: 'medium',
+    tags: ['angular', 'components'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Templates should bind to fields, signals, getters and pipes. Complex predicates or transformations belong in the component class or a pure pipe.',
+});
+export const NG_TYPED_REACTIVE_FORMS = ruleSnippet({
+    id: 'angular.typed-reactive-forms',
+    title: 'Use typed reactive forms',
+    priority: 'high',
+    tags: ['angular', 'forms'],
+    appliesWhen: ['generate-code'],
+    content: 'Prefer typed `FormGroup<T>` / `FormControl<T>` so the form value matches the domain model. Avoid `any` form values.',
+});
+export const NG_LAZY_ROUTES = ruleSnippet({
+    id: 'angular.lazy-routes',
+    title: 'Lazy-load feature routes',
+    priority: 'high',
+    tags: ['angular', 'routing', 'performance'],
+    appliesWhen: ['generate-code'],
+    content: 'Use `loadComponent` / `loadChildren` for feature routes so the initial bundle stays small. Heavy components should not be eager-loaded.',
+});
+export const NG_GUARDS_SMALL = ruleSnippet({
+    id: 'angular.guards-small',
+    title: 'Keep guards / resolvers small',
+    priority: 'medium',
+    tags: ['angular', 'routing'],
+    appliesWhen: ['generate-code'],
+    content: 'Guards/resolvers should make a decision quickly. Business logic belongs in a service called by the guard, not inline.',
+});
+export const NG_NO_DEEP_LIB_IMPORTS = ruleSnippet({
+    id: 'angular.no-deep-lib-imports',
+    title: 'No deep imports across libraries',
+    priority: 'critical',
+    tags: ['angular', 'monorepo'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Import from a library\'s `index.ts` barrel only. Deep paths break Nx boundaries and the public API contract.',
+});
+export const NG_FEATURE_FOLDERS = ruleSnippet({
+    id: 'angular.feature-folders',
+    title: 'Prefer feature-oriented folders',
+    priority: 'medium',
+    tags: ['angular', 'architecture'],
+    appliesWhen: ['generate-code'],
+    content: 'Group component + service + tests by feature, not by file kind. Avoid `components/`, `services/`, etc. as top-level grab-bags.',
+});
+export const NG_NO_GOD_SERVICES = ruleSnippet({
+    id: 'angular.no-god-services',
+    title: 'Avoid god services',
+    priority: 'high',
+    tags: ['angular', 'services'],
+    appliesWhen: ['generate-code'],
+    content: 'A service should own a focused concern. If a service mixes UI state, API calls, and business rules, split it.',
+});
+export const NG_DOMAIN_NO_UI_IMPORTS = ruleSnippet({
+    id: 'angular.domain.no-ui-imports',
+    title: 'Domain services must not import UI',
+    priority: 'critical',
+    tags: ['angular', 'boundaries'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Domain / data services live below the UI layer. They must not import components, templates, or anything from `@angular/animations`/`@angular/router`.',
+});
+export const NG_ACCESSIBLE = ruleSnippet({
+    id: 'angular.accessible',
+    title: 'Semantic HTML + keyboard support',
+    priority: 'high',
+    tags: ['angular', 'a11y'],
+    appliesWhen: ['generate-code', 'review'],
+    content: 'Interactive elements must be reachable by keyboard, have visible focus, and use semantic HTML. Use ARIA only where semantic HTML is insufficient.',
+});
+export const NG_AVOID_BYPASS_SECURITY = ruleSnippet({
+    id: 'angular.security.no-bypass',
+    title: 'Avoid `bypassSecurityTrust*`',
+    priority: 'critical',
+    tags: ['angular', 'security'],
+    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

@@ -0,0 +1,7 @@
+import type { IPreset } from '../model/preset.js';
+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 R45_PRESETS: readonly IPreset[];
+//# sourceMappingURL=r45-presets.d.ts.map

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

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

package/dist/builtin/r45-presets.js

@@ -0,0 +1,186 @@
+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";
+// 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
+// that an unrelated team cannot use as-is.
+export const NEXT_APP_PRESET = definePreset({
+    id: 'next-app',
+    title: 'Next.js app',
+    description: 'Next.js app baseline (app-router-first): server components by default, route-group conventions, no business logic in pages, typed search params.',
+    tags: ['next', 'react', 'frontend'],
+    appliesTo: [WorkspaceProfile.HasNext, WorkspaceProfile.HasReact, WorkspaceProfile.IsFrontend],
+    weight: 8,
+    composes: ['strict-typescript', 'react-app'],
+    includes: {
+        knowledge: [
+            COMMON_AGENT_BRIEFING,
+            `defineKnowledgeEntry({
+    id: 'next.app-router',
+    title: 'Prefer the Next.js App Router for new routes',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['next', 'routing'],
+    appliesWhen: ['generate-code'],
+    content: 'New routes live under app/. The pages/ router is legacy; do not introduce new pages/ routes unless explicitly migrating.',
+  })`,
+            `defineKnowledgeEntry({
+    id: 'next.no-business-logic-in-page',
+    title: 'Keep business logic out of page.tsx / layout.tsx',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['next', 'architecture'],
+    appliesWhen: ['generate-code', 'refactor'],
+    content: 'Page and layout components compose. Domain logic, data fetching, and validation live in colocated modules under app/.../_lib or feature folders.',
+  })`,
+        ],
+        rules: [COMMON_SAFETY_RULE, COMMON_RULE_ONE_EXPORT],
+        paths: [COMMON_PATH_TESTS],
+        templates: [],
+        pipelines: [COMMON_PIPELINE_CONTEXT_ONLY, COMMON_PIPELINE_FEATURE_DEV],
+        docs: {
+            'overview.md': OVERVIEW_DOC('Next.js app', 'App Router by default. Server components for data fetching. Client components only at the leaves. Pages are thin composition; business logic stays in colocated modules.'),
+        },
+    },
+    recommendedNextCommands: [
+        'shrk doctor',
+        'shrk task "<task>"',
+        'shrk gen typescript.utility <name> --dry-run',
+    ],
+});
+export const TURBOREPO_PRESET = definePreset({
+    id: 'turborepo',
+    title: 'Turborepo monorepo',
+    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,
+    composes: ['strict-typescript'],
+    includes: {
+        knowledge: [
+            COMMON_AGENT_BRIEFING,
+            `defineKnowledgeEntry({
+    id: 'turborepo.affected-tasks',
+    title: 'Use turbo run for affected tasks; avoid blanket rebuilds',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['turborepo', 'ci'],
+    appliesWhen: ['generate-code', 'fix-build'],
+    content: 'Prefer \`turbo run <task> --filter=...\` over running every package. Wire CI to the affected task graph so unrelated packages stay green.',
+  })`,
+            `defineKnowledgeEntry({
+    id: 'turborepo.public-entrypoints',
+    title: 'Cross-package imports go through the public entry point',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['turborepo', 'imports'],
+    appliesWhen: ['generate-code'],
+    content: 'Import via the package name (matches package.json exports / main). Avoid reaching into src/.',
+  })`,
+        ],
+        rules: [COMMON_SAFETY_RULE, COMMON_RULE_INTERFACE_PREFIX, COMMON_RULE_ONE_EXPORT],
+        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('Turborepo monorepo', 'apps/ + packages/ layout. turbo.json drives the task graph. CI runs affected tasks only.'),
+        },
+    },
+    recommendedNextCommands: [
+        'shrk doctor',
+        'shrk ci scaffold github-actions --quickstart',
+        'shrk task "<task>"',
+    ],
+});
+export const PACKAGE_WORKSPACE_PRESET = definePreset({
+    id: 'package-workspace',
+    title: 'Package workspace monorepo',
+    description: 'Generic npm / pnpm / yarn workspaces monorepo (no Nx, no Turborepo). Layer / boundary conventions + safe-codegen baseline.',
+    tags: ['workspaces', 'monorepo'],
+    appliesTo: [WorkspaceProfile.HasPackageWorkspaces, WorkspaceProfile.IsMonorepo],
+    notAppropriateFor: [WorkspaceProfile.HasNx, WorkspaceProfile.HasTurborepo],
+    weight: 6,
+    composes: ['strict-typescript'],
+    includes: {
+        knowledge: [
+            COMMON_AGENT_BRIEFING,
+            `defineKnowledgeEntry({
+    id: 'workspaces.public-entrypoints',
+    title: 'Cross-package imports use the package name',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['workspaces', 'imports'],
+    appliesWhen: ['generate-code'],
+    content: 'Import other workspace packages by name (package.json exports / main). No relative imports across package boundaries.',
+  })`,
+        ],
+        rules: [COMMON_SAFETY_RULE, COMMON_RULE_INTERFACE_PREFIX, COMMON_RULE_ONE_EXPORT],
+        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('Package workspace', 'Plain workspaces (npm / pnpm / yarn). Each package has a stable public entry. Cross-package boundary checks are enforced by `shrk check boundaries`.'),
+        },
+    },
+    recommendedNextCommands: [
+        'shrk doctor',
+        'shrk check boundaries',
+        'shrk task "<task>"',
+    ],
+});
+export const CLEAN_ARCHITECTURE_TS_PRESET = definePreset({
+    id: 'clean-architecture-ts',
+    title: 'Clean Architecture (TypeScript)',
+    description: 'Layered TypeScript convention: domain (no deps), application (depends on domain), infrastructure (depends on application + domain), presentation (depends on application). No reverse imports.',
+    tags: ['typescript', 'architecture', 'clean-architecture'],
+    appliesTo: [WorkspaceProfile.HasTypeScript],
+    weight: 6,
+    composes: ['strict-typescript'],
+    includes: {
+        knowledge: [
+            COMMON_AGENT_BRIEFING,
+            `defineKnowledgeEntry({
+    id: 'clean-arch.layer-order',
+    title: 'Clean Architecture layers: domain → application → infrastructure / presentation',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.Critical,
+    tags: ['architecture'],
+    appliesWhen: ['generate-code', 'refactor'],
+    content: 'Lower layers know nothing about higher ones. Domain has no dependencies on other layers. Application depends only on domain. Infrastructure and presentation are at the edges.',
+  })`,
+            `defineKnowledgeEntry({
+    id: 'clean-arch.boundary-ports',
+    title: 'Cross-layer access uses ports / interfaces, not concrete types',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['architecture', 'imports'],
+    appliesWhen: ['generate-code'],
+    content: 'Application defines interfaces (ports). Infrastructure implements them (adapters). Presentation depends on application interfaces, never on infrastructure directly.',
+  })`,
+        ],
+        rules: [
+            COMMON_SAFETY_RULE,
+            COMMON_RULE_INTERFACE_PREFIX,
+            COMMON_RULE_ONE_EXPORT,
+            COMMON_RULE_NO_LOGIC_CONSTRUCTORS,
+        ],
+        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('Clean Architecture (TypeScript)', 'Layers: domain / application / infrastructure / presentation. Lower layers know nothing about higher ones. Wire boundaries through ports + adapters; enforce with `shrk check boundaries`.'),
+        },
+    },
+    recommendedNextCommands: [
+        'shrk doctor',
+        'shrk check boundaries',
+        'shrk task "<task>"',
+    ],
+});
+export const R45_PRESETS = Object.freeze([
+    NEXT_APP_PRESET,
+    TURBOREPO_PRESET,
+    PACKAGE_WORKSPACE_PRESET,
+    CLEAN_ARCHITECTURE_TS_PRESET,
+]);

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

@@ -0,0 +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 R47_PRESETS: readonly IPreset[];
+//# sourceMappingURL=r47-presets.d.ts.map

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

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

package/dist/builtin/r47-presets.js

@@ -0,0 +1,65 @@
+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";
+// Universal adoption (top 5) — canonical-id aliases.
+//
+// Why: canonical preset ids are `nest-service` and `angular-app`. The
+// engine also ships `nestjs-service` and 12 angular variants
+// (`modern-angular`, `angular-signals-first`, …). New users type the
+// canonical id and expect it to work. These aliases compose the
+// existing presets so users get the *same* asset set as before.
+//
+// Weight is bumped by 1 above the composed preset so the recommender
+// picks the canonical alias when both match the same profiles.
+export const NEST_SERVICE_PRESET = definePreset({
+    id: 'nest-service',
+    title: 'NestJS service',
+    description: 'Canonical alias for the NestJS service preset. Composes the `nestjs-service` baseline: typed controllers, providers under a module, DTO validation pipes, e2e tests under `test/`.',
+    tags: ['nest', 'nestjs', 'service', 'backend'],
+    appliesTo: [WorkspaceProfile.HasNestJS, WorkspaceProfile.IsBackend, WorkspaceProfile.IsService],
+    weight: 9,
+    composes: ['nestjs-service'],
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [COMMON_SAFETY_RULE],
+        paths: [],
+        templates: [],
+        pipelines: [],
+        docs: {
+            'overview.md': OVERVIEW_DOC('NestJS service', 'Controllers stay thin; business logic lives in providers under a module. DTOs validate at the boundary. e2e tests live under `test/`.'),
+        },
+    },
+    recommendedNextCommands: [
+        'shrk doctor',
+        'shrk ci scaffold github-actions --quickstart',
+        'shrk task "<task>"',
+    ],
+});
+export const ANGULAR_APP_PRESET = definePreset({
+    id: 'angular-app',
+    title: 'Angular app',
+    description: 'Canonical alias for a modern Angular app. Composes `modern-angular` (signals-first, OnPush, standalone components, RxJS disciplined). Use the more specific `angular-*` variants only if you want a narrower subset.',
+    tags: ['angular', 'app', 'frontend'],
+    appliesTo: [WorkspaceProfile.HasAngular, WorkspaceProfile.IsFrontend],
+    weight: 10,
+    composes: ['modern-angular'],
+    includes: {
+        knowledge: [COMMON_AGENT_BRIEFING],
+        rules: [COMMON_SAFETY_RULE],
+        paths: [],
+        templates: [],
+        pipelines: [],
+        docs: {
+            'overview.md': OVERVIEW_DOC('Angular app', 'Modern Angular baseline: signals-first reactivity, OnPush change detection, standalone components, RxJS used deliberately, accessible templates.'),
+        },
+    },
+    recommendedNextCommands: [
+        'shrk doctor',
+        'shrk ci scaffold github-actions --quickstart',
+        'shrk task "<task>"',
+    ],
+});
+export const R47_PRESETS = Object.freeze([
+    NEST_SERVICE_PRESET,
+    ANGULAR_APP_PRESET,
+]);

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

@@ -0,0 +1,17 @@
+export declare const COMMON_AGENT_BRIEFING = "defineKnowledgeEntry({\n    id: 'agent.briefing',\n    title: 'Agent briefing',\n    type: KnowledgeType.Rule,\n    priority: KnowledgePriority.Critical,\n    tags: ['agent', 'safety'],\n    appliesWhen: ['generate-code', 'refactor', 'fix-bug'],\n    content: `This repo uses SharkCraft. Use shrk CLI or the MCP server to read\ncontext. Do not write files through MCP \u2014 use shrk apply on the CLI.`,\n    actionHints: {\n      commands: [\n        { command: 'shrk doctor' },\n        { command: 'shrk context --task \"<task>\"' },\n        { command: 'shrk gen <template> <name> --dry-run --save-plan <plan.json>' },\n      ],\n      mcpTools: ['get_relevant_context', 'get_action_hints', 'create_generation_plan'],\n      forbiddenActions: [\n        'Do not write files through MCP.',\n        'Do not skip dry-run when generating new files.',\n      ],\n      verificationCommands: ['shrk doctor', 'bun x tsc --noEmit'],\n      writePolicy: 'cli-only',\n    },\n  })";
+export declare const COMMON_SAFETY_RULE = "defineKnowledgeEntry({\n    id: 'generation.dry-run-by-default',\n    title: 'shrk gen is dry-run by default',\n    type: KnowledgeType.Rule,\n    priority: KnowledgePriority.Critical,\n    tags: ['safety', 'generator'],\n    appliesWhen: ['generate-code'],\n    content: `Always run shrk gen <id> <name> --dry-run first. Apply with\n--write only after the plan is conflict-free. AI agents must call\ncreate_generation_plan through MCP \u2014 they cannot write through MCP.`,\n    actionHints: {\n      commands: [\n        { command: 'shrk gen <id> <name> --dry-run --save-plan <plan.json>' },\n        { command: 'shrk apply <plan.json> --verify-signature' },\n      ],\n      mcpTools: ['create_generation_plan', 'explain_generation_target'],\n      forbiddenActions: ['Do not bypass dry-run.', 'Do not write through MCP.'],\n      verificationCommands: ['shrk doctor'],\n      writePolicy: 'cli-only',\n    },\n  })";
+export declare const COMMON_PIPELINE_FEATURE_DEV = "definePipeline({\n    id: 'feature-dev',\n    title: 'Feature development flow',\n    description: 'Gather context \u2192 plan \u2192 dry-run gen \u2192 human review \u2192 apply.',\n    tags: ['feature', 'generation'],\n    inputs: [\n      { name: 'task', required: true, description: 'Plain-English task description.' },\n    ],\n    steps: [\n      {\n        id: 'context',\n        type: 'context',\n        description: 'Pull relevant rules, paths, templates for the task.',\n        cliCommands: ['shrk context --task \"<task>\" --max-tokens 3500'],\n        mcpTools: ['get_relevant_context'],\n      },\n      {\n        id: 'rules',\n        type: 'mcp-tool',\n        description: 'Confirm the rules that apply.',\n        mcpTools: ['get_relevant_rules'],\n      },\n      {\n        id: 'plan',\n        type: 'generation-plan',\n        description: 'Build a dry-run plan and save it for review.',\n        cliCommands: [\n          'shrk gen <template> <name> --dry-run --save-plan <plan.json>',\n        ],\n        humanReview: true,\n      },\n      {\n        id: 'apply',\n        type: 'apply-plan',\n        description: 'Human applies the reviewed plan via CLI.',\n        cliCommands: ['shrk apply <plan.json> --verify-signature'],\n        humanReview: true,\n      },\n      {\n        id: 'verify',\n        type: 'command',\n        description: 'Run verification commands.',\n        cliCommands: ['shrk doctor', 'bun x tsc --noEmit'],\n      },\n    ],\n  })";
+export declare const COMMON_PIPELINE_CONTEXT_ONLY = "definePipeline({\n    id: 'context-only',\n    title: 'Context-only flow',\n    description: 'Retrieve the relevant slice without generating anything.',\n    tags: ['safe', 'context'],\n    inputs: [\n      { name: 'task', required: true, description: 'Plain-English task description.' },\n    ],\n    steps: [\n      {\n        id: 'overview',\n        type: 'mcp-tool',\n        description: 'Project overview + readiness.',\n        mcpTools: ['get_project_overview', 'get_ai_readiness_report'],\n      },\n      {\n        id: 'context',\n        type: 'context',\n        description: 'Token-budgeted context for the task.',\n        cliCommands: ['shrk context --task \"<task>\"'],\n        mcpTools: ['get_relevant_context'],\n      },\n      {\n        id: 'hints',\n        type: 'mcp-tool',\n        description: 'Per-task action hints.',\n        mcpTools: ['get_action_hints'],\n      },\n    ],\n  })";
+export declare const COMMON_PIPELINE_UNIT_TEST = "definePipeline({\n    id: 'unit-test',\n    title: 'Unit test verification',\n    description: 'Run the project test suite as a verification step.',\n    tags: ['test'],\n    steps: [\n      {\n        id: 'test',\n        type: 'command',\n        description: 'Run unit tests.',\n        cliCommands: ['bun test'],\n      },\n    ],\n  })";
+export declare const COMMON_TEMPLATE_SERVICE = "defineTemplate({\n    id: 'typescript.service',\n    name: 'typescript-service',\n    description: 'A minimal TypeScript service class with an init() method.',\n    tags: ['typescript', 'service'],\n    scope: ['app'],\n    appliesWhen: ['generate-service'],\n    variables: [\n      {\n        name: 'className',\n        required: true,\n        description: 'PascalCase class name (e.g. ProfileService).',\n        pattern: /^[A-Z][A-Za-z0-9]+$/,\n      },\n    ],\n    targetPath: (v) => `src/services/${kebab(v.className)}.service.ts`,\n    content: (v) => `export class ${v.className} {\\n  init(): void {}\\n}\\n`,\n    postGenerationNotes: ['Wire the new service into your composition root when ready.'],\n  })";
+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  })";
+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  })";
+export declare const OVERVIEW_DOC: (title: string, body: string) => string;
+//# sourceMappingURL=shared-snippets.d.ts.map

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

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