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

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

package/dist/builtin/builtin-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 { 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";
@@ -133,7 +133,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 +177,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 +374,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 +392,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 +428,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 +446,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 +464,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: {

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

@@ -7,9 +7,27 @@ 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  })";
-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_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,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"}
+{"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

@@ -210,6 +210,7 @@ export const COMMON_PATH_SERVICES = `defineKnowledgeEntry({
     scope: ['app'],
     appliesWhen: ['generate-service'],
     content: 'Service classes live in src/services/. One service per file.',
+    metadata: { path: 'src/services' },
   })`;
 export const COMMON_PATH_UTILS = `defineKnowledgeEntry({
     id: 'paths.utils',
@@ -219,6 +220,7 @@ export const COMMON_PATH_UTILS = `defineKnowledgeEntry({
     tags: ['paths', 'utils'],
     appliesWhen: ['generate-utility'],
     content: 'Pure helpers live in src/utils/. One function per file.',
+    metadata: { path: 'src/utils' },
   })`;
 export const COMMON_PATH_TESTS = `defineKnowledgeEntry({
     id: 'paths.tests',
@@ -228,6 +230,220 @@ export const COMMON_PATH_TESTS = `defineKnowledgeEntry({
     tags: ['paths', 'tests'],
     appliesWhen: ['generate-test'],
     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',

package/dist/emit/synthesize-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthesize-files.d.ts","sourceRoot":"","sources":["../../src/emit/synthesize-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,IAAI,EACA,QAAQ,GACR,WAAW,GACX,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,GACP,cAAc,GACd,SAAS,CAAC;CACf;AAsID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7D,GAAG,gBAAgB,EAAE,CAErB"}
+{"version":3,"file":"synthesize-files.d.ts","sourceRoot":"","sources":["../../src/emit/synthesize-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,IAAI,EACA,QAAQ,GACR,WAAW,GACX,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,GACP,cAAc,GACd,SAAS,CAAC;CACf;AAqMD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7D,GAAG,gBAAgB,EAAE,CAErB"}

package/dist/emit/synthesize-files.js

@@ -1,3 +1,62 @@
+// Self-contained preambles for each emitted file kind. Generated files
+// must work in a brand-new downstream repo where no `@shrkcrft/*`
+// packages are installed. The loaders (knowledge / templates / pipelines)
+// are shape-agnostic — they accept any object with the required string
+// fields — so we just need helpers + enum-like constants the snippets
+// reference. See `packages/knowledge/src/load/typescript-knowledge-loader.ts`
+// for the loader contract.
+const KNOWLEDGE_HELPERS = `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+const KnowledgePriority = {
+  Critical: 'critical',
+  High: 'high',
+  Medium: 'medium',
+  Low: 'low',
+} as const;
+
+const KnowledgeType = {
+  Rule: 'rule',
+  Path: 'path',
+  Template: 'template',
+  Architecture: 'architecture',
+  Technical: 'technical',
+  Business: 'business',
+  Command: 'command',
+  Environment: 'environment',
+  Dependency: 'dependency',
+  Feature: 'feature',
+  Task: 'task',
+  Warning: 'warning',
+  Decision: 'decision',
+  Convention: 'convention',
+  Workflow: 'workflow',
+  Testing: 'testing',
+  Security: 'security',
+  Deployment: 'deployment',
+  Integration: 'integration',
+  Custom: 'custom',
+} as const;
+
+function defineKnowledgeEntry<T>(entry: T): T {
+  return entry;
+}
+`;
+const TEMPLATE_HELPERS = `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+function defineTemplate<T>(template: T): T {
+  return template;
+}
+
+function kebab(s: string): string {
+  return s
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .replace(/[^A-Za-z0-9]+/g, '-')
+    .toLowerCase();
+}
+`;
+const PIPELINE_HELPERS = `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+function definePipeline<T>(pipeline: T): T {
+  return pipeline;
+}
+`;
 function recordToMap(v) {
     if (!v)
         return new Map();
@@ -11,48 +70,47 @@ function listBlock(items, indent = '  ') {
     return items.map((expr) => indent + expr.replace(/\n/g, `\n${indent}`)).join(',\n') + ',\n';
 }
 function knowledgeFile(items) {
-    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
-        'const knowledge = [\n' +
+    return (KNOWLEDGE_HELPERS +
+        '\nconst knowledge = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default knowledge;\n');
 }
 function rulesFile(items) {
-    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
-        'const rules = [\n' +
+    return (KNOWLEDGE_HELPERS +
+        '\nconst rules = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default rules;\n');
 }
 function pathsFile(items) {
-    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
-        'const paths = [\n' +
+    return (KNOWLEDGE_HELPERS +
+        '\nconst paths = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default paths;\n');
 }
 function templatesFile(items) {
-    // Inject a small kebab helper so template content() closures can use it.
-    // Generated code is self-contained — no extra runtime dependency required.
-    return ("import { defineTemplate } from '@shrkcrft/templates';\n\n" +
-        'function kebab(s: string): string {\n' +
-        "  return s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/[^A-Za-z0-9]+/g, '-').toLowerCase();\n" +
-        '}\n\n' +
-        'const templates = [\n' +
+    return (TEMPLATE_HELPERS +
+        '\nconst templates = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default templates;\n');
 }
 function pipelinesFile(items) {
-    return ("import { definePipeline } from '@shrkcrft/pipelines';\n\n" +
-        'const pipelines = [\n' +
+    return (PIPELINE_HELPERS +
+        '\nconst pipelines = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default pipelines;\n');
 }
 function configFile(preset) {
     // Generic config that points at the standard knowledge/rules/paths/etc.
-    // files. Consumers can tailor it later.
+    // files. Consumers can tailor it later. Plain default-exported object —
+    // the config loader (packages/config/src/config-loader.ts) validates the
+    // shape via zod and accepts an object literal as well as a
+    // `defineSharkCraftConfig()`-wrapped value, so the generated file does
+    // not need to import anything from `@shrkcrft/*`.
     const filesByKind = inferFiles(preset);
     const knowledgeFiles = filesByKind.has('knowledge.ts') ? ['knowledge.ts'] : [];
     const ruleFiles = filesByKind.has('rules.ts') ? ['rules.ts'] : [];
@@ -67,7 +125,8 @@ function configFile(preset) {
         ? `  surface: { profile: ${JSON.stringify(preset.surfaceProfile)} },\n`
         : '';
     return (`// Generated by \`shrk presets apply ${preset.id}\`.\n` +
-        '// Edit freely. SharkCraft does not regenerate this file.\n\n' +
+        '// Edit freely. SharkCraft does not regenerate this file.\n' +
+        '// Plain default export — no @shrkcrft/* import required.\n\n' +
         'const config = {\n' +
         `  projectName: 'shrk-project',\n` +
         `  description: ${JSON.stringify(preset.description)},\n` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/presets",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.5",
   "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.2",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.2",
-    "@shrkcrft/workspace": "^0.1.0-alpha.2"
+    "@shrkcrft/core": "^0.1.0-alpha.5",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.5",
+    "@shrkcrft/workspace": "^0.1.0-alpha.5"
   },
   "publishConfig": {
     "access": "public"