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

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>;

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

@@ -0,0 +1,192 @@
+"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.setupRuntimeExamples = setupRuntimeExamples;
+const node_path_1 = require("node:path");
+const zod_1 = require("zod");
+/**
+ * A simple YAML front matter parser.
+ *
+ * This function extracts the YAML block enclosed by `---` at the beginning of a string
+ * and parses it into a JavaScript object. It is not a full YAML parser and only
+ * supports simple key-value pairs and string arrays.
+ *
+ * @param content The string content to parse.
+ * @returns A record containing the parsed front matter data.
+ */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n(.*?)\r?\n---/s);
+    if (!match) {
+        return {};
+    }
+    const frontmatter = match[1];
+    const data = {};
+    const lines = frontmatter.split(/\r?\n/);
+    let currentKey = '';
+    let isArray = false;
+    const arrayValues = [];
+    for (const line of lines) {
+        const keyValueMatch = line.match(/^([^:]+):\s*(.*)/);
+        if (keyValueMatch) {
+            if (currentKey && isArray) {
+                data[currentKey] = arrayValues.slice();
+                arrayValues.length = 0;
+            }
+            const [, key, value] = keyValueMatch;
+            currentKey = key.trim();
+            isArray = value.trim() === '';
+            if (!isArray) {
+                const trimmedValue = value.trim();
+                if (trimmedValue === 'true') {
+                    data[currentKey] = true;
+                }
+                else if (trimmedValue === 'false') {
+                    data[currentKey] = false;
+                }
+                else {
+                    data[currentKey] = trimmedValue;
+                }
+            }
+        }
+        else {
+            const arrayItemMatch = line.match(/^\s*-\s*(.*)/);
+            if (arrayItemMatch && currentKey && isArray) {
+                let value = arrayItemMatch[1].trim();
+                // Unquote if the value is quoted.
+                if ((value.startsWith("'") && value.endsWith("'")) ||
+                    (value.startsWith('"') && value.endsWith('"'))) {
+                    value = value.slice(1, -1);
+                }
+                arrayValues.push(value);
+            }
+        }
+    }
+    if (currentKey && isArray) {
+        data[currentKey] = arrayValues;
+    }
+    return data;
+}
+async function setupRuntimeExamples(examplesPath, host) {
+    const { DatabaseSync } = await Promise.resolve().then(() => __importStar(require('node:sqlite')));
+    const db = new DatabaseSync(':memory:');
+    // Create a relational table to store the structured example data.
+    db.exec(`
+    CREATE TABLE metadata (
+      key TEXT PRIMARY KEY NOT NULL,
+      value TEXT NOT NULL
+    );
+  `);
+    db.exec(`
+    INSERT INTO metadata (key, value) VALUES
+      ('schema_version', '1'),
+      ('created_at', '${new Date().toISOString()}');
+  `);
+    db.exec(`
+    CREATE TABLE examples (
+      id INTEGER PRIMARY KEY,
+      title TEXT NOT NULL,
+      summary TEXT NOT NULL,
+      keywords TEXT,
+      required_packages TEXT,
+      related_concepts TEXT,
+      related_tools TEXT,
+      experimental INTEGER NOT NULL DEFAULT 0,
+      content TEXT NOT NULL
+    );
+  `);
+    // Create an FTS5 virtual table to provide full-text search capabilities.
+    db.exec(`
+    CREATE VIRTUAL TABLE examples_fts USING fts5(
+      title,
+      summary,
+      keywords,
+      required_packages,
+      related_concepts,
+      related_tools,
+      content,
+      content='examples',
+      content_rowid='id',
+      tokenize = 'porter ascii'
+    );
+  `);
+    // Create triggers to keep the FTS table synchronized with the examples table.
+    db.exec(`
+    CREATE TRIGGER examples_after_insert AFTER INSERT ON examples BEGIN
+      INSERT INTO examples_fts(rowid, title, summary, keywords, required_packages, related_concepts, related_tools, content)
+      VALUES (
+        new.id, new.title, new.summary, new.keywords, new.required_packages, new.related_concepts,
+        new.related_tools, new.content
+      );
+    END;
+  `);
+    const insertStatement = db.prepare('INSERT INTO examples(' +
+        'title, summary, keywords, required_packages, related_concepts, related_tools, experimental, content' +
+        ') VALUES(?, ?, ?, ?, ?, ?, ?, ?);');
+    const frontmatterSchema = zod_1.z.object({
+        title: zod_1.z.string(),
+        summary: zod_1.z.string(),
+        keywords: zod_1.z.array(zod_1.z.string()).optional(),
+        required_packages: zod_1.z.array(zod_1.z.string()).optional(),
+        related_concepts: zod_1.z.array(zod_1.z.string()).optional(),
+        related_tools: zod_1.z.array(zod_1.z.string()).optional(),
+        experimental: zod_1.z.boolean().optional(),
+    });
+    db.exec('BEGIN TRANSACTION');
+    for await (const entry of host.glob('**/*.md', { cwd: examplesPath })) {
+        if (!entry.isFile()) {
+            continue;
+        }
+        const content = await host.readFile((0, node_path_1.join)(entry.parentPath, entry.name), 'utf-8');
+        const frontmatter = parseFrontmatter(content);
+        const validation = frontmatterSchema.safeParse(frontmatter);
+        if (!validation.success) {
+            // eslint-disable-next-line no-console
+            console.warn(`Skipping invalid example file ${entry.name}:`, validation.error.issues);
+            continue;
+        }
+        const { title, summary, keywords, required_packages, related_concepts, related_tools, experimental, } = validation.data;
+        insertStatement.run(title, summary, JSON.stringify(keywords ?? []), JSON.stringify(required_packages ?? []), JSON.stringify(related_concepts ?? []), JSON.stringify(related_tools ?? []), experimental ? 1 : 0, content);
+    }
+    db.exec('END TRANSACTION');
+    return db;
+}
+//# sourceMappingURL=runtime-database.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * @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 { z } from 'zod';
+export declare const findExampleInputSchema: z.ZodObject<{
+    workspacePath: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    required_packages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    related_concepts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    includeExperimental: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type FindExampleInput = z.infer<typeof findExampleInputSchema>;
+export declare const findExampleOutputSchema: z.ZodObject<{
+    examples: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        summary: z.ZodString;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        required_packages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        related_concepts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        related_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        content: z.ZodString;
+        snippet: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;