@angular/cli 21.0.0-next.0 → 21.0.0-next.10

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

@@ -46,45 +46,143 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FIND_EXAMPLE_TOOL = void 0;
 exports.escapeSearchQuery = escapeSearchQuery;
 const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
 const node_path_1 = __importDefault(require("node:path"));
 const zod_1 = require("zod");
 const tool_registry_1 = require("./tool-registry");
 const findExampleInputSchema = zod_1.z.object({
-    query: zod_1.z.string().describe(`Performs a full-text search using FTS5 syntax. The query should target relevant Angular concepts.
-
-Key Syntax Features (see https://www.sqlite.org/fts5.html for full documentation):
-  - AND (default): Space-separated terms are combined with AND.
-    - Example: 'standalone component' (finds results with both "standalone" and "component")
-  - OR: Use the OR operator to find results with either term.
-    - Example: 'validation OR validator'
-  - NOT: Use the NOT operator to exclude terms.
-    - Example: 'forms NOT reactive'
-  - Grouping: Use parentheses () to group expressions.
-    - Example: '(validation OR validator) AND forms'
-  - Phrase Search: Use double quotes "" for exact phrases.
-    - Example: '"template-driven forms"'
-  - Prefix Search: Use an asterisk * for prefix matching.
-    - Example: 'rout*' (matches "route", "router", "routing")
-
-Examples of queries:
-  - Find standalone components: 'standalone component'
-  - Find ngFor with trackBy: 'ngFor trackBy'
-  - Find signal inputs: 'signal input'
-  - Find lazy loading a route: 'lazy load route'
-  - Find forms with validation: 'form AND (validation OR validator)'`),
+    workspacePath: zod_1.z
+        .string()
+        .optional()
+        .describe('The absolute path to the `angular.json` file for the workspace. This is used to find the ' +
+        'version-specific code examples that correspond to the installed version of the ' +
+        'Angular framework. You **MUST** get this path from the `list_projects` tool. If omitted, ' +
+        'the tool will search the generic code examples bundled with the CLI.'),
+    query: zod_1.z
+        .string()
+        .describe(`The primary, conceptual search query. This should capture the user's main goal or question ` +
+        `(e.g., 'lazy loading a route' or 'how to use signal inputs'). The query will be processed ` +
+        'by a powerful full-text search engine.\n\n' +
+        'Key Syntax Features (see https://www.sqlite.org/fts5.html for full documentation):\n' +
+        '  - AND (default): Space-separated terms are combined with AND.\n' +
+        '    - Example: \'standalone component\' (finds results with both "standalone" and "component")\n' +
+        '  - OR: Use the OR operator to find results with either term.\n' +
+        "    - Example: 'validation OR validator'\n" +
+        '  - NOT: Use the NOT operator to exclude terms.\n' +
+        "    - Example: 'forms NOT reactive'\n" +
+        '  - Grouping: Use parentheses () to group expressions.\n' +
+        "    - Example: '(validation OR validator) AND forms'\n" +
+        '  - Phrase Search: Use double quotes "" for exact phrases.\n' +
+        '    - Example: \'"template-driven forms"\'\n' +
+        '  - Prefix Search: Use an asterisk * for prefix matching.\n' +
+        '    - Example: \'rout*\' (matches "route", "router", "routing")'),
+    keywords: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('A list of specific, exact keywords to narrow the search. Use this for precise terms like ' +
+        'API names, function names, or decorators (e.g., `ngFor`, `trackBy`, `inject`).'),
+    required_packages: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe("A list of NPM packages that an example must use. Use this when the user's request is " +
+        'specific to a feature within a certain package (e.g., if the user asks about `ngModel`, ' +
+        'you should filter by `@angular/forms`).'),
+    related_concepts: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('A list of high-level concepts to filter by. Use this to find examples related to broader ' +
+        'architectural ideas or patterns (e.g., `signals`, `dependency injection`, `routing`).'),
+    includeExperimental: zod_1.z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('By default, this tool returns only production-safe examples. Set this to `true` **only if** ' +
+        'the user explicitly asks for a bleeding-edge feature or if a stable solution to their ' +
+        'problem cannot be found. If you set this to `true`, you **MUST** preface your answer by ' +
+        'warning the user that the example uses experimental APIs that are not suitable for production.'),
+});
+const findExampleOutputSchema = zod_1.z.object({
+    examples: zod_1.z.array(zod_1.z.object({
+        title: zod_1.z
+            .string()
+            .describe('The title of the example. Use this as a heading when presenting the example to the user.'),
+        summary: zod_1.z
+            .string()
+            .describe("A one-sentence summary of the example's purpose. Use this to help the user decide " +
+            'if the example is relevant to them.'),
+        keywords: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('A list of keywords for the example. You can use these to explain why this example ' +
+            "was a good match for the user's query."),
+        required_packages: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('A list of NPM packages required for the example to work. Before presenting the code, ' +
+            'you should inform the user if any of these packages need to be installed.'),
+        related_concepts: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('A list of related concepts. You can suggest these to the user as topics for ' +
+            'follow-up questions.'),
+        related_tools: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('A list of related MCP tools. You can suggest these as potential next steps for the user.'),
+        content: zod_1.z
+            .string()
+            .describe('A complete, self-contained Angular code example in Markdown format. This should be ' +
+            'presented to the user inside a markdown code block.'),
+        snippet: zod_1.z
+            .string()
+            .optional()
+            .describe('A contextual snippet from the content showing the matched search term. This field is ' +
+            'critical for efficiently evaluating a result`s relevance. It enables two primary ' +
+            'workflows:\n\n' +
+            '1. For direct questions: You can internally review snippets to select the single best ' +
+            'result before generating a comprehensive answer from its full `content`.\n' +
+            '2. For ambiguous or exploratory questions: You can present a summary of titles and ' +
+            'snippets to the user, allowing them to guide the next step.'),
+    })),
 });
 exports.FIND_EXAMPLE_TOOL = (0, tool_registry_1.declareTool)({
     name: 'find_examples',
     title: 'Find Angular Code Examples',
-    description: 'Before writing or modifying any Angular code including templates, ' +
-        '**ALWAYS** use this tool to find current best-practice examples. ' +
-        'This is critical for ensuring code quality and adherence to modern Angular standards. ' +
-        'This tool searches a curated database of approved Angular code examples and returns the most relevant results for your query. ' +
-        'Example Use Cases: ' +
-        "1) Creating new components, directives, or services (e.g., query: 'standalone component' or 'signal input'). " +
-        "2) Implementing core features (e.g., query: 'lazy load route', 'httpinterceptor', or 'route guard'). " +
-        "3) Refactoring existing code to use modern patterns (e.g., query: 'ngfor trackby' or 'form validation').",
+    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: findExampleInputSchema.shape,
+    outputSchema: findExampleOutputSchema.shape,
     isReadOnly: true,
     isLocalOnly: true,
     shouldRegister: ({ logger }) => {
@@ -99,34 +197,174 @@ exports.FIND_EXAMPLE_TOOL = (0, tool_registry_1.declareTool)({
     },
     factory: createFindExampleHandler,
 });
-async function createFindExampleHandler({ exampleDatabasePath }) {
-    let db;
-    let queryStatement;
-    if (process.env['NG_MCP_EXAMPLES_DIR']) {
-        db = await setupRuntimeExamples(process.env['NG_MCP_EXAMPLES_DIR']);
+/**
+ * Attempts to find a version-specific example database from the user's installed
+ * version of `@angular/core`. It looks for a custom `angular` metadata property in the
+ * framework'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.
+ * @returns A promise that resolves to an object containing the database path and source,
+ *     or `undefined` if the database could not be resolved.
+ */
+async function getVersionSpecificExampleDatabase(workspacePath, logger) {
+    // 1. Resolve the path to package.json
+    let pkgJsonPath;
+    try {
+        const workspaceRequire = (0, node_module_1.createRequire)(workspacePath);
+        pkgJsonPath = workspaceRequire.resolve('@angular/core/package.json');
+    }
+    catch (e) {
+        logger.warn(`Could not resolve '@angular/core/package.json' from '${workspacePath}'. ` +
+            'Is Angular installed in this project? Falling back to the bundled examples.');
+        return undefined;
+    }
+    // 2. Read and parse package.json, then find the database.
+    try {
+        const pkgJsonContent = await (0, promises_1.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 = node_path_1.default.dirname(pkgJsonPath);
+            const dbPath = node_path_1.default.resolve(packageDirectory, examplesInfo.path);
+            // Ensure the resolved database path is within the package boundary.
+            const relativePath = node_path_1.default.relative(packageDirectory, dbPath);
+            if (relativePath.startsWith('..') || node_path_1.default.isAbsolute(relativePath)) {
+                logger.warn(`Detected a potential path traversal attempt in '${pkgJsonPath}'. ` +
+                    `The path '${examplesInfo.path}' escapes the package boundary. ` +
+                    'Falling back to the bundled examples.');
+                return undefined;
+            }
+            // Check the file size to prevent reading a very large file.
+            const stats = await (0, promises_1.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. Falling back to the bundled examples.');
+                return undefined;
+            }
+            const source = `framework version ${pkgJson.version}`;
+            return { dbPath, source };
+        }
+        else {
+            logger.warn(`Did not find valid 'angular.examples' metadata in '${pkgJsonPath}'. ` +
+                'Falling back to the bundled examples.');
+        }
+    }
+    catch (e) {
+        logger.warn(`Failed to read or parse version-specific examples metadata referenced in '${pkgJsonPath}': ${e instanceof Error ? e.message : e}. Falling back to the bundled examples.`);
     }
+    return undefined;
+}
+async function createFindExampleHandler({ logger, exampleDatabasePath }) {
+    const runtimeDb = process.env['NG_MCP_EXAMPLES_DIR']
+        ? await setupRuntimeExamples(process.env['NG_MCP_EXAMPLES_DIR'])
+        : undefined;
     suppressSqliteWarning();
-    return async ({ query }) => {
-        if (!db) {
-            if (!exampleDatabasePath) {
-                // This should be prevented by the registration logic in mcp-server.ts
-                throw new Error('Example database path is not available.');
+    return async (input) => {
+        // If the dev-time override is present, use it and bypass all other logic.
+        if (runtimeDb) {
+            return queryDatabase(runtimeDb, input);
+        }
+        let dbPath;
+        // First, try to get the version-specific guide.
+        if (input.workspacePath) {
+            const versionSpecific = await getVersionSpecificExampleDatabase(input.workspacePath, logger);
+            if (versionSpecific) {
+                dbPath = versionSpecific.dbPath;
             }
-            const { DatabaseSync } = await Promise.resolve().then(() => __importStar(require('node:sqlite')));
-            db = new DatabaseSync(exampleDatabasePath, { readOnly: true });
         }
-        if (!queryStatement) {
-            queryStatement = db.prepare('SELECT * from examples WHERE examples MATCH ? ORDER BY rank;');
+        // If the version-specific guide was not found for any reason, fall back to the bundled version.
+        if (!dbPath) {
+            dbPath = exampleDatabasePath;
+        }
+        if (!dbPath) {
+            // This should be prevented by the registration logic in mcp-server.ts
+            throw new Error('Example database path is not available.');
         }
-        const sanitizedQuery = escapeSearchQuery(query);
-        // Query database and return results as text content
-        const content = [];
-        for (const exampleRecord of queryStatement.all(sanitizedQuery)) {
-            content.push({ type: 'text', text: exampleRecord['content'] });
+        const { DatabaseSync } = await Promise.resolve().then(() => __importStar(require('node:sqlite')));
+        const db = new DatabaseSync(dbPath, { readOnly: true });
+        return queryDatabase(db, input);
+    };
+}
+function queryDatabase(db, 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 " +
+        '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(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}"%`);
+            }
         }
-        return {
-            content,
+    };
+    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 ')}`;
+    }
+    // Order the results by relevance using the BM25 algorithm.
+    // 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
+    sql += ' ORDER BY bm25(examples_fts, 10.0, 5.0, 5.0, 1.0, 2.0, 1.0, 1.0);';
+    const queryStatement = db.prepare(sql);
+    // Query database and return results
+    const examples = [];
+    const textContent = [];
+    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'],
         };
+        examples.push(example);
+        // 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 },
     };
 }
 /**
@@ -206,19 +444,139 @@ function suppressSqliteWarning() {
         return originalProcessEmit.apply(process, arguments);
     };
 }
+/**
+ * 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) {
     const { DatabaseSync } = await Promise.resolve().then(() => __importStar(require('node:sqlite')));
     const db = new DatabaseSync(':memory:');
-    db.exec(`CREATE VIRTUAL TABLE examples USING fts5(content, tokenize = 'porter ascii');`);
-    const insertStatement = db.prepare('INSERT INTO examples(content) VALUES(?);');
+    // Create a relational table to store the structured example data.
+    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 (0, promises_1.glob)('*.md', { cwd: examplesPath, withFileTypes: true })) {
+    for await (const entry of (0, promises_1.glob)('**/*.md', { cwd: examplesPath, withFileTypes: true })) {
         if (!entry.isFile()) {
             continue;
         }
-        const example = await (0, promises_1.readFile)(node_path_1.default.join(entry.parentPath, entry.name), 'utf-8');
-        insertStatement.run(example);
+        const content = await (0, promises_1.readFile)(node_path_1.default.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=examples.js.map

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

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

package/src/commands/mcp/tools/modernize.js

@@ -22,11 +22,6 @@ const TRANSFORMATIONS = [
         description: 'Converts tags for elements with no content to be self-closing (e.g., `<app-foo></app-foo>` becomes `<app-foo />`).',
         documentationUrl: 'https://angular.dev/reference/migrations/self-closing-tags',
     },
-    {
-        name: 'test-bed-get',
-        description: 'Updates `TestBed.get` to the preferred and type-safe `TestBed.inject` in TypeScript test files.',
-        documentationUrl: 'https://angular.dev/guide/testing/dependency-injection',
-    },
     {
         name: 'inject',
         description: 'Converts usages of constructor-based injection to the inject() function.',
@@ -59,17 +54,14 @@ const TRANSFORMATIONS = [
             '3. Run `ng g @angular/core:standalone` and select "Bootstrap the project using standalone APIs"',
         documentationUrl: 'https://angular.dev/reference/migrations/standalone',
     },
-    {
-        name: 'zoneless',
-        description: 'Migrates the application to be zoneless.',
-        documentationUrl: 'https://angular.dev/guide/zoneless',
-    },
 ];
 const modernizeInputSchema = zod_1.z.object({
     // Casting to [string, ...string[]] since the enum definition requires a nonempty array.
     transformations: zod_1.z
         .array(zod_1.z.enum(TRANSFORMATIONS.map((t) => t.name)))
-        .optional(),
+        .optional()
+        .describe('A list of specific transformations to get instructions for. ' +
+        'If omitted, general guidance is provided.'),
 });
 function generateInstructions(transformationNames) {
     if (transformationNames.length === 0) {
@@ -107,29 +99,39 @@ async function runModernization(input) {
 exports.MODERNIZE_TOOL = (0, tool_registry_1.declareTool)({
     name: 'modernize',
     title: 'Modernize Angular Code',
-    description: '<Purpose>\n' +
-        'This tool modernizes Angular code by applying the latest best practices and syntax improvements, ' +
-        'ensuring it is idiomatic, readable, and maintainable.\n\n' +
-        '</Purpose>\n' +
-        '<Use Cases>\n' +
-        '* After generating new code: Run this tool immediately after creating new Angular components, directives, ' +
-        'or services to ensure they adhere to modern standards.\n' +
-        '* On existing code: Apply to existing TypeScript files (.ts) and Angular templates (.html) to update ' +
-        'them with the latest features, such as the new built-in control flow syntax.\n\n' +
-        '* When the user asks for a specific transformation: When the transformation list is populated, ' +
-        'these specific ones will be ran on the inputs.\n' +
-        '</Use Cases>\n' +
-        '<Transformations>\n' +
-        TRANSFORMATIONS.map((t) => `* ${t.name}: ${t.description}`).join('\n') +
-        '\n</Transformations>\n',
+    description: `
+<Purpose>
+Provides instructions and commands for modernizing Angular code to align with the latest best
+practices and syntax. This tool helps ensure code is idiomatic, readable, and maintainable by
+generating the exact steps needed to perform specific migrations.
+</Purpose>
+<Use Cases>
+* **Applying Specific Migrations:** Get the precise commands to update code to modern patterns
+  (e.g., selecting 'control-flow-migration' to replace *ngIf with @if).
+* **Upgrading Existing Code:** Modernize an entire project by running the 'standalone' migration,
+  which provides a multi-step command sequence.
+* **Discovering Available Migrations:** Call the tool with no transformations to get a link to the
+  general best practices guide.
+</Use Cases>
+<Operational Notes>
+* **Execution:** This tool **provides instructions**, which you **MUST** then execute as shell commands.
+  It does not modify code directly.
+* **Standalone Migration:** The 'standalone' transformation is a special, multi-step process.
+  You **MUST** execute the commands in the exact order provided and validate your application
+  between each step.
+* **Transformation List:** The following transformations are available:
+${TRANSFORMATIONS.map((t) => `  * ${t.name}: ${t.description}`).join('\n')}
+</Operational Notes>`,
     inputSchema: modernizeInputSchema.shape,
     outputSchema: {
         instructions: zod_1.z
             .array(zod_1.z.string())
             .optional()
-            .describe('A list of instructions on how to run the migrations.'),
+            .describe('A list of instructions and shell commands to run the requested modernizations. ' +
+            'Each string in the array is a separate step or command.'),
     },
     isLocalOnly: true,
     isReadOnly: true,
     factory: () => (input) => runModernization(input),
 });
+//# sourceMappingURL=modernize.js.map

package/src/commands/mcp/tools/modernize.js.map

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