@angular/cli 20.1.3 → 20.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/cli",
-  "version": "20.1.3",
+  "version": "20.1.5",
   "description": "CLI tool for Angular",
   "main": "lib/cli/index.js",
   "bin": {
@@ -25,13 +25,13 @@
   },
   "homepage": "https://github.com/angular/angular-cli",
   "dependencies": {
-    "@angular-devkit/architect": "0.2001.3",
-    "@angular-devkit/core": "20.1.3",
-    "@angular-devkit/schematics": "20.1.3",
+    "@angular-devkit/architect": "0.2001.5",
+    "@angular-devkit/core": "20.1.5",
+    "@angular-devkit/schematics": "20.1.5",
     "@inquirer/prompts": "7.6.0",
     "@listr2/prompt-adapter-inquirer": "2.0.22",
     "@modelcontextprotocol/sdk": "1.13.3",
-    "@schematics/angular": "20.1.3",
+    "@schematics/angular": "20.1.5",
     "@yarnpkg/lockfile": "1.1.0",
     "algoliasearch": "5.32.0",
     "ini": "5.0.0",
@@ -48,14 +48,14 @@
   "ng-update": {
     "migrations": "@schematics/angular/migrations/migration-collection.json",
     "packageGroup": {
-      "@angular/cli": "20.1.3",
-      "@angular/build": "20.1.3",
-      "@angular/ssr": "20.1.3",
-      "@angular-devkit/architect": "0.2001.3",
-      "@angular-devkit/build-angular": "20.1.3",
-      "@angular-devkit/build-webpack": "0.2001.3",
-      "@angular-devkit/core": "20.1.3",
-      "@angular-devkit/schematics": "20.1.3"
+      "@angular/cli": "20.1.5",
+      "@angular/build": "20.1.5",
+      "@angular/ssr": "20.1.5",
+      "@angular-devkit/architect": "0.2001.5",
+      "@angular-devkit/build-angular": "20.1.5",
+      "@angular-devkit/build-webpack": "0.2001.5",
+      "@angular-devkit/core": "20.1.5",
+      "@angular-devkit/schematics": "20.1.5"
     }
   },
   "packageManager": "pnpm@9.15.9",

package/src/commands/mcp/cli.js

@@ -18,7 +18,7 @@ To start using the Angular CLI MCP Server, add this configuration to your host:
   "mcpServers": {
     "angular-cli": {
       "command": "npx",
-      "args": ["@angular/cli", "mcp"]
+      "args": ["-y", "@angular/cli", "mcp"]
     }
   }
 }

package/src/commands/mcp/instructions/best-practices.md

@@ -9,10 +9,12 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 ## Angular Best Practices
 
 - Always use standalone components over NgModules
-- Don't use explicit `standalone: true` (it is implied by default)
+- Must NOT set `standalone: true` inside Angular decorators. It's the default.
 - Use signals for state management
 - Implement lazy loading for feature routes
+- Do NOT use the `@HostBinding` and `@HostListener` decorators. Put host bindings inside the `host` object of the `@Component` or `@Directive` decorator instead
 - Use `NgOptimizedImage` for all static images.
+  - `NgOptimizedImage` does not work for inline base64 images.
 
 ## Components
 
@@ -30,6 +32,7 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 - Use signals for local component state
 - Use `computed()` for derived state
 - Keep state transformations pure and predictable
+- Do NOT use `mutate` on signals, use `update` or `set` instead
 
 ## Templates
 
@@ -42,3 +45,8 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 - Design services around a single responsibility
 - Use the `providedIn: 'root'` option for singleton services
 - Use the `inject()` function instead of constructor injection
+
+## Common pitfalls
+
+- Control flow (`@if`):
+  - You cannot use `as` expressions in `@else if (...)`. E.g. invalid code: `@else if (bla(); as x)`.

package/src/commands/mcp/mcp-server.js

@@ -26,6 +26,8 @@ async function createMcpServer(context) {
             resources: {},
             tools: {},
         },
+        instructions: 'For Angular development, this server provides tools to adhere to best practices, search documentation, and find code examples. ' +
+            'When writing or modifying Angular code, use the MCP server and its tools instead of direct shell commands where possible.',
     });
     server.registerResource('instructions', 'instructions://best-practices', {
         title: 'Angular Best Practices and Code Generation Guide',
@@ -39,7 +41,10 @@ async function createMcpServer(context) {
         return { contents: [{ uri: 'instructions://best-practices', text }] };
     });
     (0, best_practices_1.registerBestPracticesTool)(server);
-    (0, projects_1.registerListProjectsTool)(server, context);
+    // If run outside an Angular workspace (e.g., globally) skip the workspace specific tools.
+    if (context.workspace) {
+        (0, projects_1.registerListProjectsTool)(server, context);
+    }
     await (0, doc_search_1.registerDocSearchTool)(server);
     return server;
 }

package/src/commands/mcp/tools/best-practices.js

@@ -14,6 +14,7 @@ exports.registerBestPracticesTool = registerBestPracticesTool;
 const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 function registerBestPracticesTool(server) {
+    let bestPracticesText;
     server.registerTool('get_best_practices', {
         title: 'Get Angular Coding Best Practices Guide',
         description: 'You **MUST** use this tool to retrieve the Angular Best Practices Guide ' +
@@ -26,12 +27,16 @@ function registerBestPracticesTool(server) {
             openWorldHint: false,
         },
     }, async () => {
-        const text = await (0, promises_1.readFile)(node_path_1.default.join(__dirname, '..', 'instructions', 'best-practices.md'), 'utf-8');
+        bestPracticesText ??= await (0, promises_1.readFile)(node_path_1.default.join(__dirname, '..', 'instructions', 'best-practices.md'), 'utf-8');
         return {
             content: [
                 {
                     type: 'text',
-                    text,
+                    text: bestPracticesText,
+                    annotations: {
+                        audience: ['assistant'],
+                        priority: 0.9,
+                    },
                 },
             ],
         };

package/src/utilities/version.js

@@ -22,4 +22,4 @@ class Version {
         this.patch = patch;
     }
 }
-exports.VERSION = new Version('20.1.3');
+exports.VERSION = new Version('20.1.5');