@angular/cli 21.1.0-next.0 → 21.1.0-next.1

package/src/commands/mcp/tools/devserver/wait-for-devserver-build.d.ts

@@ -14,24 +14,18 @@ export declare const WATCH_DELAY = 1000;
 declare const waitForDevserverBuildToolInputSchema: z.ZodObject<{
     project: z.ZodOptional<z.ZodString>;
     timeout: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    timeout: number;
-    project?: string | undefined;
-}, {
-    project?: string | undefined;
-    timeout?: number | undefined;
-}>;
+}, z.core.$strip>;
 export type WaitForDevserverBuildToolInput = z.infer<typeof waitForDevserverBuildToolInputSchema>;
 declare const waitForDevserverBuildToolOutputSchema: z.ZodObject<{
-    status: z.ZodEnum<["success", "failure", "unknown", "timeout", "no_devserver_found"]>;
-    logs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    status: "success" | "timeout" | "failure" | "unknown" | "no_devserver_found";
-    logs?: string[] | undefined;
-}, {
-    status: "success" | "timeout" | "failure" | "unknown" | "no_devserver_found";
-    logs?: string[] | undefined;
-}>;
+    status: z.ZodEnum<{
+        success: "success";
+        timeout: "timeout";
+        failure: "failure";
+        unknown: "unknown";
+        no_devserver_found: "no_devserver_found";
+    }>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
 export type WaitForDevserverBuildToolOutput = z.infer<typeof waitForDevserverBuildToolOutputSchema>;
 export declare function waitForDevserverBuild(input: WaitForDevserverBuildToolInput, context: McpToolContext): Promise<{
     content: {

package/src/commands/mcp/tools/doc-search.d.ts

@@ -17,15 +17,5 @@ export declare const DOC_SEARCH_TOOL: import("./tool-registry").McpToolDeclarati
         breadcrumb: z.ZodString;
         url: z.ZodString;
         content: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        title: string;
-        breadcrumb: string;
-        url: string;
-        content?: string | undefined;
-    }, {
-        title: string;
-        breadcrumb: string;
-        url: string;
-        content?: string | undefined;
-    }>, "many">;
+    }, z.core.$strip>>;
 }>;

package/src/commands/mcp/tools/examples/database-discovery.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import type { McpToolContext } from '../tool-registry';
+/**
+ * Attempts to find version-specific example databases from the user's installed
+ * versions of known Angular packages. It looks for a custom `angular` metadata property in each
+ * package's `package.json` to locate the database.
+ *
+ * @example A sample `package.json` `angular` field:
+ * ```json
+ * {
+ *   "angular": {
+ *     "examples": {
+ *       "format": "sqlite",
+ *       "path": "./resources/code-examples.db"
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @param workspacePath The absolute path to the user's `angular.json` file.
+ * @param logger The MCP tool context logger for reporting warnings.
+ * @param host The host interface for file system and module resolution operations.
+ * @returns A promise that resolves to an array of objects, each containing a database path and source.
+ */
+export declare function getVersionSpecificExampleDatabases(workspacePath: string, logger: McpToolContext['logger'], host: McpToolContext['host']): Promise<{
+    dbPath: string;
+    source: string;
+}[]>;

package/src/commands/mcp/tools/examples/database-discovery.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersionSpecificExampleDatabases = getVersionSpecificExampleDatabases;
+const node_path_1 = require("node:path");
+/**
+ * A list of known Angular packages that may contain example databases.
+ * The tool will attempt to resolve and load example databases from these packages.
+ */
+const KNOWN_EXAMPLE_PACKAGES = ['@angular/core', '@angular/aria', '@angular/forms'];
+/**
+ * Attempts to find version-specific example databases from the user's installed
+ * versions of known Angular packages. It looks for a custom `angular` metadata property in each
+ * package's `package.json` to locate the database.
+ *
+ * @example A sample `package.json` `angular` field:
+ * ```json
+ * {
+ *   "angular": {
+ *     "examples": {
+ *       "format": "sqlite",
+ *       "path": "./resources/code-examples.db"
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @param workspacePath The absolute path to the user's `angular.json` file.
+ * @param logger The MCP tool context logger for reporting warnings.
+ * @param host The host interface for file system and module resolution operations.
+ * @returns A promise that resolves to an array of objects, each containing a database path and source.
+ */
+async function getVersionSpecificExampleDatabases(workspacePath, logger, host) {
+    const databases = [];
+    for (const packageName of KNOWN_EXAMPLE_PACKAGES) {
+        // 1. Resolve the path to package.json
+        let pkgJsonPath;
+        try {
+            pkgJsonPath = host.resolveModule(`${packageName}/package.json`, workspacePath);
+        }
+        catch (e) {
+            // This is not a warning because the user may not have all known packages installed.
+            continue;
+        }
+        // 2. Read and parse package.json, then find the database.
+        try {
+            const pkgJsonContent = await host.readFile(pkgJsonPath, 'utf-8');
+            const pkgJson = JSON.parse(pkgJsonContent);
+            const examplesInfo = pkgJson['angular']?.examples;
+            if (examplesInfo &&
+                examplesInfo.format === 'sqlite' &&
+                typeof examplesInfo.path === 'string') {
+                const packageDirectory = (0, node_path_1.dirname)(pkgJsonPath);
+                const dbPath = (0, node_path_1.resolve)(packageDirectory, examplesInfo.path);
+                // Ensure the resolved database path is within the package boundary.
+                const relativePath = (0, node_path_1.relative)(packageDirectory, dbPath);
+                if (relativePath.startsWith('..') || (0, node_path_1.isAbsolute)(relativePath)) {
+                    logger.warn(`Detected a potential path traversal attempt in '${pkgJsonPath}'. ` +
+                        `The path '${examplesInfo.path}' escapes the package boundary. ` +
+                        'This database will be skipped.');
+                    continue;
+                }
+                // Check the file size to prevent reading a very large file.
+                const stats = await host.stat(dbPath);
+                if (stats.size > 10 * 1024 * 1024) {
+                    // 10MB
+                    logger.warn(`The example database at '${dbPath}' is larger than 10MB (${stats.size} bytes). ` +
+                        'This is unexpected and the file will not be used.');
+                    continue;
+                }
+                const source = `package ${packageName}@${pkgJson.version}`;
+                databases.push({ dbPath, source });
+            }
+        }
+        catch (e) {
+            logger.warn(`Failed to read or parse version-specific examples metadata referenced in '${pkgJsonPath}': ${e instanceof Error ? e.message : e}.`);
+        }
+    }
+    return databases;
+}
+//# sourceMappingURL=database-discovery.js.map

package/src/commands/mcp/tools/examples/database-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-discovery.js","sourceRoot":"","sources":["database-discovery.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiCH,gFAkEC;AAjGD,yCAAmE;AAGnE;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,kCAAkC,CACtD,aAAqB,EACrB,MAAgC,EAChC,IAA4B;IAE5B,MAAM,SAAS,GAAyC,EAAE,CAAC;IAE3D,KAAK,MAAM,WAAW,IAAI,sBAAsB,EAAE,CAAC;QACjD,sCAAsC;QACtC,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,WAAW,eAAe,EAAE,aAAa,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oFAAoF;YACpF,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;YAElD,IACE,YAAY;gBACZ,YAAY,CAAC,MAAM,KAAK,QAAQ;gBAChC,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,EACrC,CAAC;gBACD,MAAM,gBAAgB,GAAG,IAAA,mBAAO,EAAC,WAAW,CAAC,CAAC;gBAC9C,MAAM,MAAM,GAAG,IAAA,mBAAO,EAAC,gBAAgB,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;gBAE5D,oEAAoE;gBACpE,MAAM,YAAY,GAAG,IAAA,oBAAQ,EAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;gBACxD,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAA,sBAAU,EAAC,YAAY,CAAC,EAAE,CAAC;oBAC9D,MAAM,CAAC,IAAI,CACT,mDAAmD,WAAW,KAAK;wBACjE,aAAa,YAAY,CAAC,IAAI,kCAAkC;wBAChE,gCAAgC,CACnC,CAAC;oBACF,SAAS;gBACX,CAAC;gBAED,4DAA4D;gBAC5D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACtC,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;oBAClC,OAAO;oBACP,MAAM,CAAC,IAAI,CACT,4BAA4B,MAAM,0BAA0B,KAAK,CAAC,IAAI,WAAW;wBAC/E,mDAAmD,CACtD,CAAC;oBACF,SAAS;gBACX,CAAC;gBAED,MAAM,MAAM,GAAG,WAAW,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC3D,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CACT,6EAA6E,WAAW,MACtF,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACnC,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/src/commands/mcp/tools/examples/database.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { FindExampleInput } from './schemas';
+/**
+ * Validates the schema version of the example database.
+ *
+ * @param db The database connection to validate.
+ * @param dbSource A string identifying the source of the database (e.g., 'bundled' or a version number).
+ * @throws An error if the schema version is missing or incompatible.
+ */
+export declare function validateDatabaseSchema(db: DatabaseSync, dbSource: string): void;
+export declare function queryDatabase(dbs: DatabaseSync[], input: FindExampleInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        examples: {
+            title: string;
+            summary: string;
+            keywords: string[];
+            required_packages: string[];
+            related_concepts: string[];
+            related_tools: string[];
+            content: string;
+            snippet: string;
+        }[];
+    };
+};

package/src/commands/mcp/tools/examples/database.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDatabaseSchema = validateDatabaseSchema;
+exports.queryDatabase = queryDatabase;
+const query_escaper_1 = require("./query-escaper");
+const EXPECTED_SCHEMA_VERSION = 1;
+/**
+ * Validates the schema version of the example database.
+ *
+ * @param db The database connection to validate.
+ * @param dbSource A string identifying the source of the database (e.g., 'bundled' or a version number).
+ * @throws An error if the schema version is missing or incompatible.
+ */
+function validateDatabaseSchema(db, dbSource) {
+    const schemaVersionResult = db
+        .prepare('SELECT value FROM metadata WHERE key = ?')
+        .get('schema_version');
+    const actualSchemaVersion = schemaVersionResult ? Number(schemaVersionResult.value) : undefined;
+    if (actualSchemaVersion !== EXPECTED_SCHEMA_VERSION) {
+        db.close();
+        let errorMessage;
+        if (actualSchemaVersion === undefined) {
+            errorMessage = 'The example database is missing a schema version and cannot be used.';
+        }
+        else if (actualSchemaVersion > EXPECTED_SCHEMA_VERSION) {
+            errorMessage =
+                `This project's example database (version ${actualSchemaVersion})` +
+                    ` is newer than what this version of the Angular CLI supports (version ${EXPECTED_SCHEMA_VERSION}).` +
+                    ' Please update your `@angular/cli` package to a newer version.';
+        }
+        else {
+            errorMessage =
+                `This version of the Angular CLI (expects schema version ${EXPECTED_SCHEMA_VERSION})` +
+                    ` requires a newer example database than the one found in this project (version ${actualSchemaVersion}).`;
+        }
+        throw new Error(`Incompatible example database schema from source '${dbSource}':\n${errorMessage}`);
+    }
+}
+function queryDatabase(dbs, input) {
+    const { query, keywords, required_packages, related_concepts, includeExperimental } = input;
+    // Build the query dynamically
+    const params = [];
+    let sql = `SELECT e.title, e.summary, e.keywords, e.required_packages, e.related_concepts, e.related_tools, e.content, ` +
+        // The `snippet` function generates a contextual snippet of the matched text.
+        // Column 6 is the `content` column. We highlight matches with asterisks and limit the snippet size.
+        "snippet(examples_fts, 6, '**', '**', '...', 15) AS snippet, " +
+        // The `bm25` function returns the relevance score of the match. The weights
+        // assigned to each column boost the ranking of documents where the search
+        // term appears in a more important field.
+        // Column order: title, summary, keywords, required_packages, related_concepts, related_tools, content
+        'bm25(examples_fts, 10.0, 5.0, 5.0, 1.0, 2.0, 1.0, 1.0) AS rank ' +
+        'FROM examples e JOIN examples_fts ON e.id = examples_fts.rowid';
+    const whereClauses = [];
+    // FTS query
+    if (query) {
+        whereClauses.push('examples_fts MATCH ?');
+        params.push((0, query_escaper_1.escapeSearchQuery)(query));
+    }
+    // JSON array filters
+    const addJsonFilter = (column, values) => {
+        if (values?.length) {
+            for (const value of values) {
+                whereClauses.push(`e.${column} LIKE ?`);
+                params.push(`%"${value}"%`);
+            }
+        }
+    };
+    addJsonFilter('keywords', keywords);
+    addJsonFilter('required_packages', required_packages);
+    addJsonFilter('related_concepts', related_concepts);
+    if (!includeExperimental) {
+        whereClauses.push('e.experimental = 0');
+    }
+    if (whereClauses.length > 0) {
+        sql += ` WHERE ${whereClauses.join(' AND ')}`;
+    }
+    // Query database and return results
+    const examples = [];
+    const textContent = [];
+    for (const db of dbs) {
+        const queryStatement = db.prepare(sql);
+        for (const exampleRecord of queryStatement.all(...params)) {
+            const record = exampleRecord;
+            const example = {
+                title: record['title'],
+                summary: record['summary'],
+                keywords: JSON.parse(record['keywords'] || '[]'),
+                required_packages: JSON.parse(record['required_packages'] || '[]'),
+                related_concepts: JSON.parse(record['related_concepts'] || '[]'),
+                related_tools: JSON.parse(record['related_tools'] || '[]'),
+                content: record['content'],
+                snippet: record['snippet'],
+                rank: record['rank'],
+            };
+            examples.push(example);
+        }
+    }
+    // Order the combined results by relevance.
+    // The `bm25` algorithm returns a smaller number for a more relevant match.
+    examples.sort((a, b) => a.rank - b.rank);
+    // The `rank` field is an internal implementation detail for sorting and should not be
+    // returned to the user. We create a new array of examples without the `rank`.
+    const finalExamples = examples.map(({ rank, ...rest }) => rest);
+    for (const example of finalExamples) {
+        // Also create a more structured text output
+        let text = `## Example: ${example.title}\n**Summary:** ${example.summary}`;
+        if (example.snippet) {
+            text += `\n**Snippet:** ${example.snippet}`;
+        }
+        text += `\n\n---\n\n${example.content}`;
+        textContent.push({ type: 'text', text });
+    }
+    return {
+        content: textContent,
+        structuredContent: { examples: finalExamples },
+    };
+}
+//# sourceMappingURL=database.js.map

package/src/commands/mcp/tools/examples/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["database.ts"],"names":[],"mappings":"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"}

package/src/commands/mcp/tools/examples/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+export declare const FIND_EXAMPLE_TOOL: import("../tool-registry").McpToolDeclaration<{
+    workspacePath: import("zod").ZodOptional<import("zod").ZodString>;
+    query: import("zod").ZodString;
+    keywords: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    required_packages: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    related_concepts: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    includeExperimental: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+}, {
+    examples: import("zod").ZodArray<import("zod").ZodObject<{
+        title: import("zod").ZodString;
+        summary: import("zod").ZodString;
+        keywords: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        required_packages: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        related_concepts: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        related_tools: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        content: import("zod").ZodString;
+        snippet: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}>;

package/src/commands/mcp/tools/examples/index.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIND_EXAMPLE_TOOL = void 0;
+const tool_registry_1 = require("../tool-registry");
+const database_1 = require("./database");
+const database_discovery_1 = require("./database-discovery");
+const runtime_database_1 = require("./runtime-database");
+const schemas_1 = require("./schemas");
+const utils_1 = require("./utils");
+exports.FIND_EXAMPLE_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'find_examples',
+    title: 'Find Angular Code Examples',
+    description: `
+<Purpose>
+Augments your knowledge base with a curated database of official, best-practice code examples,
+focusing on **modern, new, and recently updated** Angular features. This tool acts as a RAG
+(Retrieval-Augmented Generation) source, providing ground-truth information on the latest Angular
+APIs and patterns. You **MUST** use it to understand and apply current standards when working with
+new or evolving features.
+</Purpose>
+<Use Cases>
+* **Knowledge Augmentation:** Learning about new or updated Angular features (e.g., query: 'signal input' or 'deferrable views').
+* **Modern Implementation:** Finding the correct modern syntax for features
+  (e.g., query: 'functional route guard' or 'http client with fetch').
+* **Refactoring to Modern Patterns:** Upgrading older code by finding examples of new syntax
+  (e.g., query: 'built-in control flow' to replace "*ngIf").
+* **Advanced Filtering:** Combining a full-text search with filters to narrow results.
+  (e.g., query: 'forms', required_packages: ['@angular/forms'], keywords: ['validation'])
+</Use Cases>
+<Operational Notes>
+* **Project-Specific Use (Recommended):** For tasks inside a user's project, you **MUST** provide the
+  \`workspacePath\` argument to get examples that match the project's Angular version. Get this
+  path from \`list_projects\`.
+* **General Use:** If no project context is available (e.g., for general questions or learning),
+  you can call the tool without the \`workspacePath\` argument. It will return the latest
+  generic examples.
+* **Tool Selection:** This database primarily contains examples for new and recently updated Angular
+  features. For established, core features, the main documentation (via the
+  \`search_documentation\` tool) may be a better source of information.
+* The examples in this database are the single source of truth for modern Angular coding patterns.
+* The search query uses a powerful full-text search syntax (FTS5). Refer to the 'query'
+  parameter description for detailed syntax rules and examples.
+* You can combine the main 'query' with optional filters like 'keywords', 'required_packages',
+  and 'related_concepts' to create highly specific searches.
+</Operational Notes>`,
+    inputSchema: schemas_1.findExampleInputSchema.shape,
+    outputSchema: schemas_1.findExampleOutputSchema.shape,
+    isReadOnly: true,
+    isLocalOnly: true,
+    shouldRegister: ({ logger }) => {
+        // sqlite database support requires Node.js 22.16+
+        const [nodeMajor, nodeMinor] = process.versions.node.split('.', 2).map(Number);
+        if (nodeMajor < 22 || (nodeMajor === 22 && nodeMinor < 16)) {
+            logger.warn(`MCP tool 'find_examples' requires Node.js 22.16 (or higher). ` +
+                ' Registration of this tool has been skipped.');
+            return false;
+        }
+        return true;
+    },
+    factory: createFindExampleHandler,
+});
+async function createFindExampleHandler({ logger, exampleDatabasePath, host }) {
+    const runtimeDb = process.env['NG_MCP_EXAMPLES_DIR']
+        ? await (0, runtime_database_1.setupRuntimeExamples)(process.env['NG_MCP_EXAMPLES_DIR'], host)
+        : undefined;
+    (0, utils_1.suppressSqliteWarning)();
+    return async (input) => {
+        // If the dev-time override is present, use it and bypass all other logic.
+        if (runtimeDb) {
+            return (0, database_1.queryDatabase)([runtimeDb], input);
+        }
+        const resolvedDbs = [];
+        // First, try to get all available version-specific guides.
+        if (input.workspacePath) {
+            const versionSpecificDbs = await (0, database_discovery_1.getVersionSpecificExampleDatabases)(input.workspacePath, logger, host);
+            for (const db of versionSpecificDbs) {
+                resolvedDbs.push({ path: db.dbPath, source: db.source });
+            }
+        }
+        // If no version-specific guides were found for any reason, fall back to the bundled version.
+        if (resolvedDbs.length === 0 && exampleDatabasePath) {
+            resolvedDbs.push({ path: exampleDatabasePath, source: 'bundled' });
+        }
+        if (resolvedDbs.length === 0) {
+            // This should be prevented by the registration logic in mcp-server.ts
+            throw new Error('No example databases are available.');
+        }
+        const { DatabaseSync } = await Promise.resolve().then(() => __importStar(require('node:sqlite')));
+        const dbConnections = [];
+        for (const { path, source } of resolvedDbs) {
+            const db = new DatabaseSync(path, { readOnly: true });
+            try {
+                (0, database_1.validateDatabaseSchema)(db, source);
+                dbConnections.push(db);
+            }
+            catch (e) {
+                logger.warn(e.message);
+                // If a database is invalid, we should not query it, but we should not fail the whole tool.
+                // We will just skip this database and try to use the others.
+                continue;
+            }
+        }
+        if (dbConnections.length === 0) {
+            throw new Error('All available example databases were invalid. Cannot perform query.');
+        }
+        return (0, database_1.queryDatabase)(dbConnections, input);
+    };
+}
+//# sourceMappingURL=index.js.map

package/src/commands/mcp/tools/examples/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/src/commands/mcp/tools/examples/query-escaper.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+/**
+ * Escapes a search query for FTS5 by tokenizing and quoting terms.
+ *
+ * This function processes a raw search string and prepares it for an FTS5 full-text search.
+ * It correctly handles quoted phrases, logical operators (AND, OR, NOT), parentheses,
+ * and prefix searches (ending with an asterisk), ensuring that individual search
+ * terms are properly quoted to be treated as literals by the search engine.
+ * This is primarily intended to avoid unintentional usage of FTS5 query syntax by consumers.
+ *
+ * @param query The raw search query string.
+ * @returns A sanitized query string suitable for FTS5.
+ */
+export declare function escapeSearchQuery(query: string): string;

package/src/commands/mcp/tools/examples/query-escaper.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeSearchQuery = escapeSearchQuery;
+/**
+ * Escapes a search query for FTS5 by tokenizing and quoting terms.
+ *
+ * This function processes a raw search string and prepares it for an FTS5 full-text search.
+ * It correctly handles quoted phrases, logical operators (AND, OR, NOT), parentheses,
+ * and prefix searches (ending with an asterisk), ensuring that individual search
+ * terms are properly quoted to be treated as literals by the search engine.
+ * This is primarily intended to avoid unintentional usage of FTS5 query syntax by consumers.
+ *
+ * @param query The raw search query string.
+ * @returns A sanitized query string suitable for FTS5.
+ */
+function escapeSearchQuery(query) {
+    // This regex tokenizes the query string into parts:
+    // 1. Quoted phrases (e.g., "foo bar")
+    // 2. Parentheses ( and )
+    // 3. FTS5 operators (AND, OR, NOT, NEAR)
+    // 4. Words, which can include a trailing asterisk for prefix search (e.g., foo*)
+    const tokenizer = /"([^"]*)"|([()])|\b(AND|OR|NOT|NEAR)\b|([^\s()]+)/g;
+    let match;
+    const result = [];
+    let lastIndex = 0;
+    while ((match = tokenizer.exec(query)) !== null) {
+        // Add any whitespace or other characters between tokens
+        if (match.index > lastIndex) {
+            result.push(query.substring(lastIndex, match.index));
+        }
+        const [, quoted, parenthesis, operator, term] = match;
+        if (quoted !== undefined) {
+            // It's a quoted phrase, keep it as is.
+            result.push(`"${quoted}"`);
+        }
+        else if (parenthesis) {
+            // It's a parenthesis, keep it as is.
+            result.push(parenthesis);
+        }
+        else if (operator) {
+            // It's an operator, keep it as is.
+            result.push(operator);
+        }
+        else if (term) {
+            // It's a term that needs to be quoted.
+            if (term.endsWith('*')) {
+                result.push(`"${term.slice(0, -1)}"*`);
+            }
+            else {
+                result.push(`"${term}"`);
+            }
+        }
+        lastIndex = tokenizer.lastIndex;
+    }
+    // Add any remaining part of the string
+    if (lastIndex < query.length) {
+        result.push(query.substring(lastIndex));
+    }
+    return result.join('');
+}
+//# sourceMappingURL=query-escaper.js.map

package/src/commands/mcp/tools/examples/query-escaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-escaper.js","sourceRoot":"","sources":["query-escaper.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAcH,8CA6CC;AAzDD;;;;;;;;;;;GAWG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,oDAAoD;IACpD,sCAAsC;IACtC,yBAAyB;IACzB,yCAAyC;IACzC,iFAAiF;IACjF,MAAM,SAAS,GAAG,oDAAoD,CAAC;IACvE,IAAI,KAAK,CAAC;IACV,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,wDAAwD;QACxD,IAAI,KAAK,CAAC,KAAK,GAAG,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;QAEtD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,uCAAuC;YACvC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,WAAW,EAAE,CAAC;YACvB,qCAAqC;YACrC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,QAAQ,EAAE,CAAC;YACpB,mCAAmC;YACnC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,IAAI,EAAE,CAAC;YAChB,uCAAuC;YACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,uCAAuC;IACvC,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC"}

package/src/commands/mcp/tools/examples/runtime-database.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { McpToolContext } from '../tool-registry';
+export declare function setupRuntimeExamples(examplesPath: string, host: McpToolContext['host']): Promise<DatabaseSync>;