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

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,269 @@ 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' },
+  })`;
+// React workspaces — many flavors (Vite SPA, Next.js, Remix). The
+// snippets below cover the most common SPA layout (src/components,
+// src/hooks, src/pages, src/lib). Frameworks that follow a different
+// convention (e.g. Next.js app router under app/) will trigger the
+// init paths-advisory; the user is expected to swap them at that point.
+export const REACT_PATH_COMPONENTS = `defineKnowledgeEntry({
+    id: 'paths.react.components',
+    title: 'React components',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'react', 'components'],
+    scope: ['react'],
+    appliesWhen: ['generate-component'],
+    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.',
+    metadata: { path: 'src/components' },
+  })`;
+export const REACT_PATH_HOOKS = `defineKnowledgeEntry({
+    id: 'paths.react.hooks',
+    title: 'React custom hooks',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'react', 'hooks'],
+    scope: ['react'],
+    appliesWhen: ['generate-hook'],
+    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.',
+    metadata: { path: 'src/hooks' },
+  })`;
+export const REACT_PATH_PAGES = `defineKnowledgeEntry({
+    id: 'paths.react.pages',
+    title: 'React route / page components',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Medium,
+    tags: ['paths', 'react', 'pages', 'routing'],
+    scope: ['react'],
+    appliesWhen: ['create-feature', 'add-route'],
+    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 — adjust this entry if your project uses that layout.',
+    metadata: { path: 'src/pages' },
+  })`;
+export const REACT_PATH_LIB = `defineKnowledgeEntry({
+    id: 'paths.react.lib',
+    title: 'React app utilities + clients',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Medium,
+    tags: ['paths', 'react', 'lib'],
+    scope: ['react'],
+    appliesWhen: ['generate-utility', 'generate-code'],
+    content: 'Framework-agnostic helpers (formatters, validators, API clients) live under src/lib/. Keep them pure — no React imports unless the helper is a hook (in which case it belongs under src/hooks/).',
+    metadata: { path: 'src/lib' },
+  })`;
+// 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/dist/registry/recommend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../src/registry/recommend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,OAAO,EAAE,iBAAiB,GACzB,qBAAqB,EAAE,CA2CzB"}
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../src/registry/recommend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,OAAO,EAAE,iBAAiB,GACzB,qBAAqB,EAAE,CA8CzB"}

package/dist/registry/recommend.js

@@ -44,14 +44,18 @@ export function recommendPresets(presets, options) {
         }
         if (dq)
             continue;
+        // A targeted preset (it declares `appliesTo` requirements) that matched
+        // NONE of them is not a recommendation. Without this guard a vanilla JS
+        // repo gets every Angular preset, each "recommended" with the sole reason
+        // `missing profile: has-angular` — the agent then adopts framework
+        // conventions that don't apply. Universal presets (no `appliesTo`) survive.
+        if ((preset.appliesTo?.length ?? 0) > 0 && matchedCount === 0)
+            continue;
         if ((preset.appliesTo?.length ?? 0) === 0 && reasons.length === 0) {
             reasons.push('universal preset');
         }
         const confidence = score >= 15 ? 'high' : score >= 9 ? 'medium' : 'low';
         out.push({ preset, score, confidence, reasons });
-        // matchedCount is reserved for future tie-breaking; surface in reasons
-        // for now so the explanation captures it.
-        void matchedCount;
     }
     out.sort((a, b) => b.score - a.score);
     const limit = options.limit ?? 5;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shrkcrft/presets",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.20",
   "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",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -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.20",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.20",
+    "@shrkcrft/workspace": "^0.1.0-alpha.20"
   },
   "publishConfig": {
     "access": "public"