@aws/nx-plugin-mcp 1.0.0-rc.5 → 1.0.0-rc.7

package/bin/aws-nx-mcp.js

@@ -19413,26 +19413,6 @@ const buildGeneratorInfoList = (baseDir) => Object.entries(generators$1).map(([i
 	..."guidePages" in info && info.guidePages ? { guidePages: info.guidePages } : {}
 }));
 //#endregion
-//#region ../nx-plugin/src/mcp-server/schema.ts
-/**
-* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-* SPDX-License-Identifier: Apache-2.0
-*/
-const PACKAGE_MANAGERS = [
-	"pnpm",
-	"yarn",
-	"npm",
-	"bun"
-];
-const PackageManagerSchema = _enum(PACKAGE_MANAGERS);
-//#endregion
-//#region ../nx-plugin/src/utils/iac-providers.ts
-/**
-* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-* SPDX-License-Identifier: Apache-2.0
-*/
-const IAC_PROVIDERS = ["cdk", "terraform"];
-//#endregion
 //#region ../nx-plugin/src/utils/commands.ts
 const PACKAGE_MANAGER_COMMANDS = {
 	npm: {
@@ -19502,6 +19482,26 @@ const buildCreateNxWorkspaceCommand = (pm, workspace, iac, tag) => {
 	].join(" ");
 };
 //#endregion
+//#region ../nx-plugin/src/utils/iac-providers.ts
+/**
+* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+* SPDX-License-Identifier: Apache-2.0
+*/
+const IAC_PROVIDERS = ["cdk", "terraform"];
+//#endregion
+//#region ../nx-plugin/src/mcp-server/schema.ts
+/**
+* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+* SPDX-License-Identifier: Apache-2.0
+*/
+const PACKAGE_MANAGERS = [
+	"pnpm",
+	"yarn",
+	"npm",
+	"bun"
+];
+const PackageManagerSchema = _enum(PACKAGE_MANAGERS);
+//#endregion
 //#region ../nx-plugin/src/mcp-server/tools/create-workspace-command.ts
 /**
 * Add a tool which tells a model how to create an Nx workspace
@@ -20546,88 +20546,6 @@ const kebabCase = (str) => {
 	return (0, import_lodash_deburr.default)(str).replace(/[^a-zA-Z0-9]+/g, "-").replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase().replace(/^-+|-+$/g, "");
 };
 //#endregion
-//#region ../nx-plugin/src/mcp-server/option-filter.ts
-/**
-* Turn the `data.estree` of an `MdxJsxAttributeValueExpression` into a
-* `Predicate`. The estree is a Program wrapping a single ObjectExpression.
-*/
-const parseWhenExpression = (estree) => {
-	const expression = unwrapProgram(estree);
-	if (expression.type !== "ObjectExpression") throw new Error(`[option-filter] Expected object literal in 'when' prop, got ${expression.type}`);
-	const result = {};
-	for (const prop of expression.properties) {
-		if (prop.type !== "Property") throw new Error(`[option-filter] Unsupported entry type '${prop.type}' in 'when' prop`);
-		result[extractKey(prop)] = extractValues(prop.value);
-	}
-	return result;
-};
-/**
-* AND across keys, OR within a key's values, `not` negates. A key not
-* present in `options` is "no opinion". A predicate whose keys have no
-* intersection with `options` short-circuits to true.
-*/
-const evaluatePredicate = (predicate, not, options) => {
-	let matched = true;
-	let anyKeyTested = false;
-	for (const [key, values] of Object.entries(predicate)) {
-		const selected = options[key];
-		if (selected === void 0) continue;
-		anyKeyTested = true;
-		if (!values.includes(selected)) {
-			matched = false;
-			break;
-		}
-	}
-	if (!anyKeyTested) return true;
-	return not ? !matched : matched;
-};
-/** Short human label used on the docs pill and in the `> [!NOTE] Only when …` marker. */
-const describePredicate = (predicate, not) => {
-	const parts = Object.entries(predicate).map(([k, vs]) => `${k} = ${vs.join(" | ")}`);
-	return `${not ? "Not when " : "Only when "}${parts.join(", ")}`;
-};
-const unwrapProgram = (estree) => {
-	if (estree.type !== "Program") return estree;
-	const program = estree;
-	if (program.body.length !== 1) return estree;
-	const stmt = program.body[0];
-	return stmt.type === "ExpressionStatement" ? stmt.expression : estree;
-};
-const extractKey = (prop) => {
-	const k = prop.key;
-	if (k.type === "Identifier") return k.name;
-	if (k.type === "Literal" && typeof k.value === "string") return k.value;
-	throw new Error(`[option-filter] Unsupported key type '${k.type}' in 'when' prop`);
-};
-const extractValues = (value) => {
-	if (value.type === "ArrayExpression") return value.elements.map((el) => {
-		if (el === null || el.type === "SpreadElement") throw new Error(`[option-filter] Unsupported array element in 'when' prop`);
-		return extractScalar(el);
-	});
-	return [extractScalar(value)];
-};
-/**
-* Extract a `string[]` from the estree of an attribute-value expression
-* like `{['a', 'b']}`. Used by JSX attribute readers (e.g. the
-* `commands={[...]}` prop on <NxCommands>). Throws if anything other than
-* string / number / boolean literal array elements are encountered.
-*/
-const extractStringArrayExpression = (estree) => {
-	const expression = unwrapProgram(estree);
-	if (expression.type !== "ArrayExpression") throw new Error(`[option-filter] Expected array literal, got ${expression.type}`);
-	return expression.elements.map((el) => {
-		if (el === null || el.type === "SpreadElement") throw new Error(`[option-filter] Unsupported array element`);
-		return extractScalar(el);
-	});
-};
-const extractScalar = (node) => {
-	if (node.type === "Literal") {
-		const lit = node;
-		if (typeof lit.value === "string" || typeof lit.value === "number" || typeof lit.value === "boolean") return String(lit.value);
-	}
-	throw new Error(`[option-filter] Unsupported value type '${node.type}' in 'when' prop. Use string, number, boolean literals or arrays of them.`);
-};
-//#endregion
 //#region ../nx-plugin/src/mcp-server/guide-render.ts
 /**
 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
@@ -22995,7 +22913,93 @@ var import_js_yaml = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((ex
 var { Type, Schema, FAILSAFE_SCHEMA, JSON_SCHEMA, CORE_SCHEMA, DEFAULT_SCHEMA, load, loadAll, dump, YAMLException, types: types$2, safeLoad, safeLoadAll, safeDump } = import_js_yaml.default;
 var index_vite_proxy_tmp_default = import_js_yaml.default;
 //#endregion
+//#region ../nx-plugin/src/mcp-server/option-filter.ts
+/**
+* Turn the `data.estree` of an `MdxJsxAttributeValueExpression` into a
+* `Predicate`. The estree is a Program wrapping a single ObjectExpression.
+*/
+const parseWhenExpression = (estree) => {
+	const expression = unwrapProgram(estree);
+	if (expression.type !== "ObjectExpression") throw new Error(`[option-filter] Expected object literal in 'when' prop, got ${expression.type}`);
+	const result = {};
+	for (const prop of expression.properties) {
+		if (prop.type !== "Property") throw new Error(`[option-filter] Unsupported entry type '${prop.type}' in 'when' prop`);
+		result[extractKey(prop)] = extractValues(prop.value);
+	}
+	return result;
+};
+/**
+* AND across keys, OR within a key's values, `not` negates. A key not
+* present in `options` is "no opinion". A predicate whose keys have no
+* intersection with `options` short-circuits to true.
+*/
+const evaluatePredicate = (predicate, not, options) => {
+	let matched = true;
+	let anyKeyTested = false;
+	for (const [key, values] of Object.entries(predicate)) {
+		const selected = options[key];
+		if (selected === void 0) continue;
+		anyKeyTested = true;
+		if (!values.includes(selected)) {
+			matched = false;
+			break;
+		}
+	}
+	if (!anyKeyTested) return true;
+	return not ? !matched : matched;
+};
+/** Short human label used on the docs pill and in the `> [!NOTE] Only when …` marker. */
+const describePredicate = (predicate, not) => {
+	const parts = Object.entries(predicate).map(([k, vs]) => `${k} = ${vs.join(" | ")}`);
+	return `${not ? "Not when " : "Only when "}${parts.join(", ")}`;
+};
+const unwrapProgram = (estree) => {
+	if (estree.type !== "Program") return estree;
+	const program = estree;
+	if (program.body.length !== 1) return estree;
+	const stmt = program.body[0];
+	return stmt.type === "ExpressionStatement" ? stmt.expression : estree;
+};
+const extractKey = (prop) => {
+	const k = prop.key;
+	if (k.type === "Identifier") return k.name;
+	if (k.type === "Literal" && typeof k.value === "string") return k.value;
+	throw new Error(`[option-filter] Unsupported key type '${k.type}' in 'when' prop`);
+};
+const extractValues = (value) => {
+	if (value.type === "ArrayExpression") return value.elements.map((el) => {
+		if (el === null || el.type === "SpreadElement") throw new Error(`[option-filter] Unsupported array element in 'when' prop`);
+		return extractScalar(el);
+	});
+	return [extractScalar(value)];
+};
+/**
+* Extract a `string[]` from the estree of an attribute-value expression
+* like `{['a', 'b']}`. Used by JSX attribute readers (e.g. the
+* `commands={[...]}` prop on <NxCommands>). Throws if anything other than
+* string / number / boolean literal array elements are encountered.
+*/
+const extractStringArrayExpression = (estree) => {
+	const expression = unwrapProgram(estree);
+	if (expression.type !== "ArrayExpression") throw new Error(`[option-filter] Expected array literal, got ${expression.type}`);
+	return expression.elements.map((el) => {
+		if (el === null || el.type === "SpreadElement") throw new Error(`[option-filter] Unsupported array element`);
+		return extractScalar(el);
+	});
+};
+const extractScalar = (node) => {
+	if (node.type === "Literal") {
+		const lit = node;
+		if (typeof lit.value === "string" || typeof lit.value === "number" || typeof lit.value === "boolean") return String(lit.value);
+	}
+	throw new Error(`[option-filter] Unsupported value type '${node.type}' in 'when' prop. Use string, number, boolean literals or arrays of them.`);
+};
+//#endregion
 //#region ../nx-plugin/src/mcp-server/mdx-ast.ts
+/**
+* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+* SPDX-License-Identifier: Apache-2.0
+*/
 const isJsxElement = (node) => node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement";
 const findAttr = (node, name) => node.attributes.find((a) => a.type === "mdxJsxAttribute" && a.name === name);
 const readStringAttr = (node, name) => {
@@ -52525,6 +52529,10 @@ var init_remark_frontmatter = __esmMin((() => {
 }));
 //#endregion
 //#region ../nx-plugin/src/mcp-server/guide-pipeline.ts
+/**
+* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+* SPDX-License-Identifier: Apache-2.0
+*/
 let depsPromise;
 const loadRemarkDeps = () => {
 	if (!depsPromise) depsPromise = (async () => ({

package/docs/guides/nx-generator.mdx

@@ -395,6 +395,10 @@ import { formatFilesInSubtree } from '@aws/nx-plugin/sdk/utils/format';
 await formatFilesInSubtree(tree, 'optional/path/to/format');
 ```
 
+:::note
+`formatFilesInSubtree` formats TypeScript, JavaScript, JSON and CSS files with [Biome](https://biomejs.dev/), and Python files with [Ruff](https://docs.astral.sh/ruff/). When the workspace already has a `biome.json` on disk, it uses your workspace's installed version of Biome and its configuration. Otherwise it falls back to a bundled Biome, applying any `biome.json` present in the virtual tree.
+:::
+
 #### Reading and Updating JSON Files
 
 ```typescript

package/docs/guides/typescript-project.mdx

@@ -11,7 +11,7 @@ import NxCommands from '@components/nx-commands.astro';
 import PackageManagerShortCommand from '@components/package-manager-short-command.astro';
 import Link from '@components/link.astro';
 
-The TypeScript project generator can be used to create a modern [TypeScript](https://www.typescriptlang.org/) library or application configured with best practices such as [ECMAScript Modules (ESM)](https://www.typescriptlang.org/docs/handbook/modules/reference.html), TypeScript [project references](https://www.typescriptlang.org/docs/handbook/project-references.html), [Vitest](https://vitest.dev/) for running tests and [ESLint](https://eslint.org/) for static analysis.
+The TypeScript project generator can be used to create a modern [TypeScript](https://www.typescriptlang.org/) library or application configured with best practices such as [ECMAScript Modules (ESM)](https://www.typescriptlang.org/docs/handbook/modules/reference.html), TypeScript [project references](https://www.typescriptlang.org/docs/handbook/project-references.html), [Vitest](https://vitest.dev/) for running tests and [Biome](https://biomejs.dev/) for linting and formatting.
 
 ## Usage
 
@@ -38,7 +38,6 @@ The generator will create the following project structure in the `<directory>/<n
   - tsconfig.lib.json TypeScript configuration for your library (your runtime or packaged source)
   - tsconfig.spec.json TypeScript configuration for your tests
   - vitest.config.mts Configuration for Vitest
-  - eslint.config.mjs Configuration for ESLint
 
 </FileTree>
 
@@ -198,7 +197,7 @@ If you're building an AWS Lambda function, check out the <Link path="/guides/ts-
 
 If you are publishing your TypeScript project to NPM, you must create a `package.json` file for it.
 
-This must declare the dependencies that your project references. Since at build time your project will resolve dependencies installed via the workspace root `package.json`, it's recommended to configure the [Nx Dependency Checks ESLint Plugin](https://nx.dev/nx-api/eslint-plugin/documents/dependency-checks) to ensure that your published project's `package.json` includes all dependencies you use in your project.
+This must declare the dependencies that your project references. Since at build time your project will resolve dependencies installed via the workspace root `package.json`, Biome's `noUndeclaredDependencies` rule will warn you if your project imports a package that isn't listed in its `package.json`.
 
 ### Building
 
@@ -269,11 +268,7 @@ If you are a VSCode user, we recommend installing the [Vitest Runner for VSCode
 
 ## Linting
 
-TypeScript projects use [ESLint](https://eslint.org/) for linting, along with [Prettier](https://prettier.io/) for formatting.
-
-We recommend configuring ESLint in the workspace root `eslint.config.mjs` file, as changes to this will apply to all TypeScript projects in your workspace and ensure consistency.
-
-Likewise, you can configure Prettier in the root `.prettierrc` file.
+TypeScript projects use [Biome](https://biomejs.dev/) for linting and formatting. Biome is configured in the workspace root `biome.json` file — changes to this apply to all TypeScript projects in your workspace and ensure consistency.
 
 ### Running the Linter
 
@@ -283,7 +278,7 @@ To invoke the linter to check your project, you can run the `lint` target.
 
 ### Fixing Lint Issues
 
-The majority of linting or formatting issues can be fixed automatically. You can tell ESLint to fix lint issues by running with the `--configuration=fix` argument.
+The majority of linting or formatting issues can be fixed automatically by running with the `--configuration=fix` argument.
 
 <NxCommands commands={["lint <project-name> --configuration=fix"]} />
 
@@ -303,7 +298,7 @@ To avoid linting issues slowing you down during development (particularly if you
 
 <NxCommands commands={["run-many --target build --configuration=skip-lint"]} />
 
-This will still run ESLint as part of the build, but the lint target will always be considered successful.
+This skips the lint target entirely during build.
 
 :::tip[Shorthand Command]
 This has a shorthand command from the root of your workspace:

package/docs/guides/workspace.mdx

@@ -134,7 +134,7 @@ This will run the chosen target as well as the targets it depends on.
 
 ### Linting
 
-New workspaces are configured with [ESLint](https://eslint.org/) for static analysis and [Prettier](https://prettier.io/) for code formatting. Running `lint` applies both to all projects.
+New workspaces are configured with [Biome](https://biomejs.dev/) for static analysis and code formatting. Running `lint` checks all projects for issues, and `lint --configuration=fix` auto-fixes them.
 
 ### Git Secrets
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws/nx-plugin-mcp",
-  "version": "1.0.0-rc.5",
+  "version": "1.0.0-rc.7",
   "repository": {
     "type": "git",
     "url": "https://github.com/awslabs/nx-plugin-for-aws.git",