@happyvertical/smrt-dev-mcp 0.47.2 → 0.49.0

package/dist/{knowledge-CY6sQzpj.js → knowledge-BOsSAdPo.js}

@@ -1,3 +1,4 @@
+import { n as TOOLS } from "./tool-catalog-Zl-bcimC.js";
 import { existsSync, lstatSync, opendirSync, readFileSync, readdirSync, realpathSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, matchesGlob, relative, resolve, sep } from "node:path";
 import { createHash } from "node:crypto";
@@ -5,708 +6,6 @@ import { execFileSync } from "node:child_process";
 import { AGENT_SURFACE_HASH_PREFIX, MODULE_DOC_HASH_PREFIX, discoverScopedPackageDirectories, readAgentModuleDocs, readPackageAgentDoc, resolveAgentModuleDocPaths } from "@happyvertical/smrt-core/knowledge";
 import { toSnakeCase } from "@happyvertical/smrt-core/utils";
 import { ManifestAdapter, OxcScanner, isAgentSurfaceSourcePath, isPrunedAgentSurfacePath, lintNumericPrecision, mergeAgentSurfaces, parseSource, scanSvelteAgentSurface, sourceMayContainNumericPrecisionIssue, sourceMayDeclareAgentSurface } from "@happyvertical/smrt-scanner";
-//#region src/tool-catalog.ts
-var REVIEW_SKILL_NAME = "smrt-code-review";
-var JSON_SCHEMA_2020_12 = "https://json-schema.org/draft/2020-12/schema";
-function compareToolNames(left, right) {
-	return left < right ? -1 : left > right ? 1 : 0;
-}
-/**
-* Stable success/error envelope for development tools. `data` preserves each
-* tool's existing payload exactly; coverage/diagnostics are promoted only when
-* the underlying result actually reports them.
-*/
-var DEV_MCP_OUTPUT_SCHEMA = {
-	$schema: JSON_SCHEMA_2020_12,
-	type: "object",
-	additionalProperties: false,
-	required: [
-		"ok",
-		"coverage",
-		"diagnostics",
-		"data"
-	],
-	properties: {
-		ok: { type: "boolean" },
-		coverage: {
-			type: ["object", "null"],
-			additionalProperties: true
-		},
-		diagnostics: {
-			type: "array",
-			items: {
-				type: "object",
-				additionalProperties: true
-			}
-		},
-		data: {}
-	}
-};
-var KNOWLEDGE_DETAIL_DESCRIPTION = "summary: authored package docs are listed by path to stay inside tool-result budgets. full: embed package docs and matching modules with structural object facts. complete: embed all modules and return full package records.";
-var DATABASE_URL_PROPERTY = {
-	type: "string",
-	description: "Optional dev database URL override (read-only diagnostics); prefer SMRT_DEV_DB_URL or cli.database config"
-};
-var DATABASE_TYPE_PROPERTY = {
-	type: "string",
-	enum: [
-		"sqlite",
-		"postgres",
-		"duckdb"
-	],
-	description: "Optional engine hint for dbUrl or the environment connection (sqlite, postgres, duckdb); inferred from the URL scheme when omitted"
-};
-var PROJECT_PATH_PROPERTY = {
-	type: "string",
-	description: "Project root to boot manifests from (default: the server working directory; ignored by the HTTP host, which boots once)"
-};
-var LIMIT_PROPERTY = {
-	type: "number",
-	description: "Row budget for result lists (default 50, capped at 500)"
-};
-var TOOLS = [
-	{
-		name: "generate-smrt-class",
-		description: "Generate a complete SMRT class with @smrt() decorator",
-		inputSchema: {
-			type: "object",
-			properties: {
-				className: {
-					type: "string",
-					description: "Name of the class (PascalCase)"
-				},
-				properties: {
-					type: "array",
-					description: "Array of property definitions",
-					items: {
-						type: "object",
-						properties: {
-							name: { type: "string" },
-							type: {
-								type: "string",
-								enum: [
-									"text",
-									"integer",
-									"decimal",
-									"boolean",
-									"datetime",
-									"json"
-								]
-							},
-							required: { type: "boolean" },
-							nullable: { type: "boolean" },
-							description: { type: "string" },
-							defaultValue: { oneOf: [
-								{ type: "string" },
-								{ type: "number" },
-								{ type: "boolean" },
-								{ type: "object" },
-								{ type: "null" }
-							] }
-						},
-						required: ["name", "type"]
-					}
-				},
-				baseClass: {
-					type: "string",
-					enum: ["SmrtObject", "SmrtCollection"],
-					default: "SmrtObject"
-				},
-				template: {
-					type: "string",
-					enum: [
-						"basic",
-						"global-catalog",
-						"optional-catalog",
-						"tenant-project-object",
-						"tenant-event-log-object",
-						"cross-package-reference"
-					],
-					default: "basic"
-				},
-				tableName: { type: "string" },
-				conflictColumns: {
-					type: "array",
-					items: { type: "string" }
-				},
-				tenantScoped: { oneOf: [{ type: "boolean" }, {
-					type: "object",
-					properties: {
-						mode: {
-							type: "string",
-							enum: ["required", "optional"]
-						},
-						field: { type: "string" },
-						autoFilter: { type: "boolean" },
-						autoPopulate: { type: "boolean" },
-						allowSuperAdminBypass: { type: "boolean" }
-					}
-				}] },
-				includeTenantIdField: { type: "boolean" },
-				relationships: {
-					type: "array",
-					items: {
-						type: "object",
-						properties: {
-							name: { type: "string" },
-							type: {
-								type: "string",
-								enum: [
-									"foreignKey",
-									"crossPackageRef",
-									"oneToMany",
-									"manyToMany"
-								]
-							},
-							related: { type: "string" },
-							required: { type: "boolean" },
-							nullable: { type: "boolean" },
-							description: { type: "string" },
-							validate: { type: "boolean" },
-							foreignKey: { type: "string" },
-							through: { type: "string" },
-							sourceKey: { type: "string" },
-							targetKey: { type: "string" }
-						},
-						required: [
-							"name",
-							"type",
-							"related"
-						]
-					}
-				},
-				includeCompanionSnippets: {
-					type: "boolean",
-					default: false
-				},
-				includeApiConfig: {
-					type: "boolean",
-					default: true
-				},
-				includeMcpConfig: {
-					type: "boolean",
-					default: true
-				},
-				includeCliConfig: {
-					type: "boolean",
-					default: true
-				}
-			},
-			required: ["className", "properties"]
-		}
-	},
-	{
-		name: "introspect-project",
-		description: "Scan a directory for SMRT objects. Returns a compact summary by default; pass detail: \"full\" for field, schema, and method details.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				directory: {
-					type: "string",
-					description: "Project directory (default: cwd)"
-				},
-				manifestPath: {
-					type: "string",
-					description: "Optional manifest path. Defaults to .smrt/manifest.json, dist/manifest.json, then source scanning."
-				},
-				detail: {
-					type: "string",
-					enum: ["summary", "full"],
-					default: "summary",
-					description: "summary: one compact record per object. full: complete field/schema/method detail (large)."
-				},
-				maxChars: {
-					type: "number",
-					description: "Character budget for the `objects` payload. Objects past the budget are omitted and reported under `truncated`. Project metadata and diagnostics are always returned in full, so the serialized response is somewhat larger than this budget."
-				},
-				includeFields: {
-					type: "boolean",
-					description: "Include field details (detail: \"full\" only)"
-				},
-				includeRelationships: {
-					type: "boolean",
-					description: "Analyze relationships (detail: \"full\" only)"
-				},
-				includeMethods: {
-					type: "boolean",
-					description: "Include public method details (detail: \"full\" only)"
-				}
-			}
-		}
-	},
-	{
-		name: "review-smrt-project",
-		description: "Advisory ecosystem alignment review for downstream SMRT projects",
-		inputSchema: {
-			type: "object",
-			properties: {
-				directory: {
-					type: "string",
-					description: "Project directory (default: cwd)"
-				},
-				rootDir: {
-					type: "string",
-					description: "Compatibility alias for directory"
-				},
-				includeSourceEvidence: {
-					type: "boolean",
-					description: "Include file and line evidence in findings",
-					default: true
-				},
-				maxFindings: {
-					type: "number",
-					description: "Optional maximum number of findings to return"
-				}
-			}
-		}
-	},
-	{
-		name: "reflect-knowledge",
-		description: "Report deterministic SMRT + HappyVertical SDK knowledge coverage and freshness",
-		inputSchema: {
-			type: "object",
-			properties: { rootDir: {
-				type: "string",
-				description: "Project root directory (default: cwd)"
-			} }
-		}
-	},
-	{
-		name: "reflect-domain-knowledge",
-		description: "Report domain-scoped SMRT knowledge artifacts, SDK packages, and freshness",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				scope: {
-					type: "string",
-					enum: [
-						"project",
-						"local",
-						"package",
-						"sdk",
-						"installed"
-					],
-					default: "project"
-				},
-				package: { type: "string" }
-			}
-		}
-	},
-	{
-		name: "check-knowledge-freshness",
-		description: "Run deterministic freshness checks for SMRT agent knowledge",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				changed: {
-					type: "boolean",
-					description: "Limit stale-pattern checks to changed files"
-				},
-				strict: {
-					type: "boolean",
-					description: "Treat stale-pattern findings as errors"
-				}
-			}
-		}
-	},
-	{
-		name: "check-domain-knowledge",
-		description: "Run deterministic freshness checks for domain knowledge artifacts",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				changed: { type: "boolean" },
-				strict: { type: "boolean" },
-				scope: {
-					type: "string",
-					enum: [
-						"project",
-						"local",
-						"package",
-						"sdk",
-						"installed"
-					],
-					default: "project"
-				},
-				package: { type: "string" }
-			}
-		}
-	},
-	{
-		name: "build-review-context",
-		description: "Build model-ready SMRT review context from changed files and optional focus text",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				changedFiles: {
-					type: "array",
-					items: { type: "string" }
-				},
-				focus: { type: "string" },
-				documentation: { type: "string" },
-				detail: {
-					type: "string",
-					enum: [
-						"summary",
-						"full",
-						"complete"
-					],
-					default: "summary",
-					description: KNOWLEDGE_DETAIL_DESCRIPTION
-				}
-			}
-		}
-	},
-	{
-		name: "build-domain-review-context",
-		description: "Build domain-scoped model-ready SMRT review context and prompt bundle",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				changedFiles: {
-					type: "array",
-					items: { type: "string" }
-				},
-				focus: { type: "string" },
-				documentation: { type: "string" },
-				scope: {
-					type: "string",
-					enum: [
-						"project",
-						"local",
-						"package",
-						"sdk",
-						"installed"
-					],
-					default: "project"
-				},
-				package: { type: "string" },
-				detail: {
-					type: "string",
-					enum: [
-						"summary",
-						"full",
-						"complete"
-					],
-					default: "summary",
-					description: KNOWLEDGE_DETAIL_DESCRIPTION
-				}
-			}
-		}
-	},
-	{
-		name: "smrt-review",
-		description: "Return deterministic review findings and/or a reusable model prompt bundle. For a formal downstream review, first call get-agent-skill with { \"name\": \"smrt-code-review\" } or load the smrt-code-review MCP prompt/resource.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				changedFiles: {
-					type: "array",
-					items: { type: "string" }
-				},
-				focus: { type: "string" },
-				documentation: { type: "string" },
-				mode: {
-					type: "string",
-					enum: [
-						"findings",
-						"prompt-bundle",
-						"both"
-					],
-					default: "both"
-				},
-				detail: {
-					type: "string",
-					enum: [
-						"summary",
-						"full",
-						"complete"
-					],
-					default: "summary",
-					description: KNOWLEDGE_DETAIL_DESCRIPTION
-				}
-			}
-		}
-	},
-	{
-		name: "build-architecture-context",
-		description: "Build model-ready SMRT architecture context from an idea or documentation",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				idea: { type: "string" },
-				documentation: { type: "string" },
-				focus: { type: "string" },
-				detail: {
-					type: "string",
-					enum: [
-						"summary",
-						"full",
-						"complete"
-					],
-					default: "summary",
-					description: KNOWLEDGE_DETAIL_DESCRIPTION
-				}
-			}
-		}
-	},
-	{
-		name: "build-package-specialist-context",
-		description: "Build deterministic package specialist context for the SMRT workbench",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				package: {
-					type: "string",
-					description: "Package name or short package query, e.g. @happyvertical/smrt-content or content"
-				},
-				focus: { type: "string" }
-			},
-			required: ["package"]
-		}
-	},
-	{
-		name: "build-domain-architecture-context",
-		description: "Build domain-scoped model-ready SMRT architecture context and prompt bundle",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				idea: { type: "string" },
-				documentation: { type: "string" },
-				focus: { type: "string" },
-				scope: {
-					type: "string",
-					enum: [
-						"project",
-						"local",
-						"package",
-						"sdk",
-						"installed"
-					],
-					default: "project"
-				},
-				package: { type: "string" },
-				detail: {
-					type: "string",
-					enum: [
-						"summary",
-						"full",
-						"complete"
-					],
-					default: "summary",
-					description: KNOWLEDGE_DETAIL_DESCRIPTION
-				}
-			}
-		}
-	},
-	{
-		name: "smrt-architecture",
-		description: "Suggest SMRT and HappyVertical SDK packages and return an architecture prompt bundle",
-		inputSchema: {
-			type: "object",
-			properties: {
-				rootDir: { type: "string" },
-				idea: { type: "string" },
-				documentation: { type: "string" },
-				focus: { type: "string" },
-				detail: {
-					type: "string",
-					enum: [
-						"summary",
-						"full",
-						"complete"
-					],
-					default: "summary",
-					description: KNOWLEDGE_DETAIL_DESCRIPTION
-				}
-			}
-		}
-	},
-	{
-		name: "list-agent-skills",
-		description: "List bundled harness-agnostic agent skills shipped with smrt-dev-mcp",
-		inputSchema: {
-			type: "object",
-			properties: {}
-		}
-	},
-	{
-		name: "get-agent-skill",
-		description: "Return a bundled harness-agnostic agent skill as Markdown plus optional references",
-		inputSchema: {
-			type: "object",
-			properties: {
-				name: {
-					type: "string",
-					enum: [REVIEW_SKILL_NAME],
-					description: "Bundled agent skill name"
-				},
-				includeReferences: {
-					type: "boolean",
-					default: true,
-					description: "Include referenced files with the skill bundle"
-				}
-			},
-			required: ["name"]
-		}
-	},
-	{
-		name: "migration-status",
-		description: "Live migration status from the _smrt_schema_migrations system table (runtime provenance; read-only)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				dbUrl: DATABASE_URL_PROPERTY,
-				dbType: DATABASE_TYPE_PROPERTY,
-				limit: LIMIT_PROPERTY
-			}
-		}
-	},
-	{
-		name: "job-health",
-		description: "Live job queue health from the _smrt_jobs/_smrt_workers system tables (runtime provenance; read-only)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				dbUrl: DATABASE_URL_PROPERTY,
-				dbType: DATABASE_TYPE_PROPERTY,
-				limit: LIMIT_PROPERTY
-			}
-		}
-	},
-	{
-		name: "schedule-health",
-		description: "Live agent schedule health from the _smrt_agent_schedules system table (runtime provenance; read-only; sensitive agentConfig never read)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				dbUrl: DATABASE_URL_PROPERTY,
-				dbType: DATABASE_TYPE_PROPERTY,
-				limit: LIMIT_PROPERTY
-			}
-		}
-	},
-	{
-		name: "dispatch-health",
-		description: "Live dispatch health from the _smrt_dispatch/_smrt_dispatch_subscriptions system tables (runtime provenance; read-only; payloads never read)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				dbUrl: DATABASE_URL_PROPERTY,
-				dbType: DATABASE_TYPE_PROPERTY,
-				limit: LIMIT_PROPERTY
-			}
-		}
-	},
-	{
-		name: "recent-changes",
-		description: "Tail of the _smrt_changes change feed (runtime provenance; read-only; filter by table/tenant)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				dbUrl: DATABASE_URL_PROPERTY,
-				dbType: DATABASE_TYPE_PROPERTY,
-				since: {
-					type: "number",
-					description: "Cursor to read after (default 0)"
-				},
-				tables: {
-					type: "array",
-					items: { type: "string" },
-					description: "Restrict to these physical table names"
-				},
-				tenantId: {
-					type: "string",
-					description: "Tenant narrowing filter"
-				},
-				limit: LIMIT_PROPERTY
-			}
-		}
-	},
-	{
-		name: "registry-drift",
-		description: "Registry drift report; _smrt_registry is retired and reported as such, never queried (read-only)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				dbUrl: DATABASE_URL_PROPERTY,
-				dbType: DATABASE_TYPE_PROPERTY
-			}
-		}
-	},
-	{
-		name: "runtime-registry",
-		description: "Sanitized snapshot of the booted ObjectRegistry from the project and installed manifests (booted provenance; read-only; no project code executed)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				projectPath: PROJECT_PATH_PROPERTY,
-				objects: {
-					type: "array",
-					items: { type: "string" },
-					description: "Restrict field/method detail to these simple or qualified object names"
-				},
-				detail: {
-					type: "boolean",
-					description: "Include field and method detail for every object (default: only when objects is given)"
-				}
-			}
-		}
-	},
-	{
-		name: "runtime-object",
-		description: "One booted object: sanitized fields, methods, tenancy, inheritance, and the DDL the registry would generate (booted provenance; read-only)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				projectPath: PROJECT_PATH_PROPERTY,
-				name: {
-					type: "string",
-					description: "Simple or qualified object name"
-				},
-				engine: {
-					type: "string",
-					enum: [
-						"sqlite",
-						"postgres",
-						"duckdb"
-					],
-					description: "Engine for the DDL preview (default: registry default)"
-				}
-			},
-			required: ["name"]
-		}
-	},
-	{
-		name: "runtime-schema-diff",
-		description: "Booted registry schemas versus the live dev database using the db:diff comparer; introspection only, drops/relaxations never proposed (runtime provenance; read-only)",
-		inputSchema: {
-			type: "object",
-			properties: {
-				projectPath: PROJECT_PATH_PROPERTY,
-				dbUrl: DATABASE_URL_PROPERTY,
-				dbType: DATABASE_TYPE_PROPERTY
-			}
-		}
-	}
-].map((tool) => ({
-	...tool,
-	inputSchema: {
-		...tool.inputSchema,
-		$schema: JSON_SCHEMA_2020_12
-	},
-	outputSchema: DEV_MCP_OUTPUT_SCHEMA
-})).sort((left, right) => compareToolNames(left.name, right.name));
-//#endregion
 //#region src/knowledge/mcp-docs.ts
 var PACKAGE_NAME = "@happyvertical/smrt-dev-mcp";
 /**
@@ -1500,10 +799,12 @@ async function buildReviewContext(options = {}) {
 		scope: options.scope,
 		packageName: options.packageName ?? options.package
 	});
+	const reviewFindings = buildReviewFindings(index, changedFiles, selectedPackages);
 	return {
 		selectedPackages,
 		selectedSdkPackages,
-		deterministicFindings: findStalePatternIssues(index.rootDir, changedFiles.length > 0 ? changedFiles : void 0).concat(buildReviewFindings(index, changedFiles, selectedPackages)),
+		deterministicFindings: findStalePatternIssues(index.rootDir, changedFiles.length > 0 ? changedFiles : void 0).concat(reviewFindings.findings),
+		reviewHints: reviewFindings.hints,
 		promptBundle: buildPromptBundle({
 			title: "SMRT code review",
 			task: "Review the changed SMRT code. Prioritize correctness, relationships-v2 invariants, tenancy, SDK usage, prompt/data safety, and stale documentation.",
@@ -1529,7 +830,10 @@ async function smrtReview(options = {}) {
 		mode,
 		selectedPackages: context.selectedPackages,
 		selectedSdkPackages: context.selectedSdkPackages,
-		...mode !== "prompt-bundle" ? { deterministicFindings: context.deterministicFindings } : {},
+		...mode !== "prompt-bundle" ? {
+			deterministicFindings: context.deterministicFindings,
+			reviewHints: context.reviewHints
+		} : {},
 		...mode !== "findings" ? { promptBundle: context.promptBundle } : {},
 		coverage: context.coverage,
 		diagnostics: context.diagnostics
@@ -1598,6 +902,24 @@ async function buildPackageSpecialistContext(options = {}) {
 		})
 	};
 }
+/**
+* The single context entry point (#2780). `task: 'review'` routes changed
+* files and focus text to package experts and returns findings, hints, and a
+* prompt bundle; `task: 'architecture'` ranks packages by the idea text and
+* returns the bundle plus recommendations. Replaces build-review-context,
+* build-domain-review-context, build-architecture-context, and
+* build-domain-architecture-context, which dispatched to the same code.
+*/
+async function buildContext(options) {
+	if (options.task === "architecture") return {
+		task: "architecture",
+		...await smrtArchitecture(options)
+	};
+	return {
+		task: "review",
+		...await smrtReview(options)
+	};
+}
 async function smrtArchitecture(options = {}) {
 	const context = await buildArchitectureContext(options);
 	const ideaText = [
@@ -2726,6 +2048,7 @@ function shouldScanStalePatternFile(rootDir, filePath) {
 }
 function buildReviewFindings(index, changedFiles, selectedPackages) {
 	const issues = [];
+	const hints = [];
 	for (const pkg of selectedPackages) {
 		const changedPackageFiles = changedFiles.filter((file) => packageOwnsFile(pkg, file, index.packages));
 		if (!pkg.agentDoc && pkg.kind === "smrt") issues.push({
@@ -2735,15 +2058,15 @@ function buildReviewFindings(index, changedFiles, selectedPackages) {
 			file: pkg.relativeDirectory,
 			packageName: pkg.name
 		});
-		if (changedPackageFiles.some((file) => file.endsWith(".ts")) && pkg.relationshipFeatures.length > 0) issues.push({
-			severity: "warning",
+		if (changedPackageFiles.some((file) => file.endsWith(".ts")) && pkg.relationshipFeatures.length > 0) hints.push({
+			severity: "info",
 			code: "relationship-sensitive-review",
 			message: `Package uses relationships-v2 features: ${pkg.relationshipFeatures.join(", ")}`,
 			file: changedPackageFiles.find((file) => file.endsWith(".ts")),
 			packageName: pkg.name
 		});
-		if (changedPackageFiles.some((file) => file.endsWith(".ts")) && pkg.mcpTools.length > 0) issues.push({
-			severity: "warning",
+		if (changedPackageFiles.some((file) => file.endsWith(".ts")) && pkg.mcpTools.length > 0) hints.push({
+			severity: "info",
 			code: "mcp-surface-review",
 			message: `Package exposes ${pkg.mcpTools.length} generated MCP tool(s); check public tool compatibility`,
 			file: changedPackageFiles.find((file) => file.endsWith(".ts")),
@@ -2784,7 +2107,10 @@ function buildReviewFindings(index, changedFiles, selectedPackages) {
 			file
 		});
 	}
-	return issues;
+	return {
+		findings: issues,
+		hints
+	};
 }
 /**
 * Joins a package-relative path onto a package's workspace-relative directory.
@@ -2896,9 +2222,14 @@ function selectPackages(index, options) {
 	}
 	for (const pkg of selectPackagesForFiles(index, options.changedFiles ?? [])) if (scopeAllowsPackage(pkg, options.scope)) selected.add(pkg);
 	const text = (options.text ?? "").toLowerCase();
+	const scores = /* @__PURE__ */ new Map();
 	if (text) for (const pkg of domainPackages(index)) {
 		if (!scopeAllowsPackage(pkg, options.scope)) continue;
-		if (includesToken(text, pkg.name.replace("@happyvertical/smrt-", "")) || text.includes(pkg.name.toLowerCase()) || pkg.objects.some((object) => includesToken(text, object.className.toLowerCase()))) selected.add(pkg);
+		const score = scorePackageForText(pkg, text);
+		if (score > 0) {
+			selected.add(pkg);
+			scores.set(pkg, score);
+		}
 	}
 	if (selected.size === 0 && options.scope === "local") for (const pkg of domainPackages(index).filter((item) => scopeAllowsPackage(item, "local"))) selected.add(pkg);
 	if (selected.size === 0 && options.scope !== "sdk") {
@@ -2917,7 +2248,44 @@ function selectPackages(index, options) {
 			for (const pkg of contributing) selected.add(pkg);
 		}
 	}
-	return [...selected].sort((a, b) => a.name.localeCompare(b.name));
+	return [...selected].sort((a, b) => (scores.get(b) ?? 0) - (scores.get(a) ?? 0) || a.name.localeCompare(b.name));
+}
+/** Word tokens (3+ chars) with naive singular/plural variants. */
+function textTokens(text) {
+	const tokens = /* @__PURE__ */ new Set();
+	for (const raw of text.toLowerCase().match(/[a-z][a-z0-9_-]{2,}/g) ?? []) {
+		tokens.add(raw);
+		if (raw.endsWith("ies")) tokens.add(`${raw.slice(0, -3)}y`);
+		else if (raw.endsWith("sses") || raw.endsWith("xes") || raw.endsWith("ches") || raw.endsWith("shes")) tokens.add(raw.slice(0, -2));
+		else if (raw.endsWith("s") && !raw.endsWith("ss")) tokens.add(raw.slice(0, -1));
+		else tokens.add(`${raw}s`);
+	}
+	return tokens;
+}
+/**
+* Score how strongly free text names a package: its short name, its full
+* name, its object class names, and its tables/collections/fields. A
+* request for "newsletter subscription with double opt-in" must rank
+* `smrt-subscriptions` above the framework default list.
+*/
+function scorePackageForText(pkg, text) {
+	const tokens = textTokens(text);
+	let score = 0;
+	const shortName = pkg.name.replace("@happyvertical/smrt-", "").replace("@happyvertical/", "").toLowerCase();
+	if (text.includes(pkg.name.toLowerCase())) score += 5;
+	if (tokens.has(shortName)) score += 4;
+	for (const object of pkg.objects) {
+		const className = object.className.toLowerCase();
+		if (tokens.has(className) || includesToken(text, className)) score += 3;
+		for (const candidate of [object.collection, object.tableName]) if (candidate && tokens.has(candidate.toLowerCase())) score += 1;
+		let fieldHits = 0;
+		for (const field of object.fields) if (tokens.has(field.name.toLowerCase()) && fieldHits < 3) {
+			fieldHits += 1;
+			score += 1;
+		}
+	}
+	for (const tag of pkg.domainKnowledge?.tags ?? []) if (tokens.has(String(tag).toLowerCase())) score += 1;
+	return score;
 }
 function selectSdkPackages(index, selectedPackages, texts, options = {}) {
 	const selected = /* @__PURE__ */ new Set();
@@ -3297,6 +2665,6 @@ function compactKnowledgePackage(pkg) {
 	};
 }
 //#endregion
-export { checkKnowledgeFreshness as a, diffKnowledgeIndex as c, renderKnowledgeIndexMarkdown as d, smrtArchitecture as f, TOOLS as h, buildReviewContext as i, packageDocPaths as l, REVIEW_SKILL_NAME as m, buildKnowledgeIndex as n, checkKnowledgeFreshnessFromIndex as o, smrtReview as p, buildPackageSpecialistContext as r, compactContextResult as s, buildArchitectureContext as t, renderFreshnessResult as u };
+export { buildReviewContext as a, compactContextResult as c, renderFreshnessResult as d, renderKnowledgeIndexMarkdown as f, buildPackageSpecialistContext as i, diffKnowledgeIndex as l, smrtReview as m, buildContext as n, checkKnowledgeFreshness as o, smrtArchitecture as p, buildKnowledgeIndex as r, checkKnowledgeFreshnessFromIndex as s, buildArchitectureContext as t, packageDocPaths as u };
 
-//# sourceMappingURL=knowledge-CY6sQzpj.js.map
+//# sourceMappingURL=knowledge-BOsSAdPo.js.map