@aws/nx-plugin 1.0.0-rc.9 → 1.0.0-rc.90

package/src/utils/version-upgrade-migration/sync-lambda-runtimes.js

@@ -0,0 +1,148 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { visitNotIgnoredFiles } from "@nx/devkit";
+import { applyGritQL, captureAllGritQLVariable } from "../ast.js";
+import { cdkLambdaRuntime, LAMBDA_RUNTIME_VERSIONS, terraformLambdaRuntime } from "../versions.js";
+import { isVendedUpgrade } from "./vended-upgrade.js";
+/**
+ * GritQL binding the value of a `runtime` assignment.
+ *
+ * Structure is matched here and nowhere else: the binding is the runtime alone, so
+ * no caller re-derives the assignment around it, and a `runtime` that isn't a real
+ * property or attribute — inside a comment, say — never matches.
+ */ const RUNTIME_ASSIGNMENT = {
+    cdk: '`runtime: $value`',
+    terraform: 'language hcl\n`runtime = $value`'
+};
+/** `NODEJS_22_X` -> `22`, `PYTHON_3_14` -> `3.14`; undefined for an alias. */ const cdkMemberVersion = (member)=>/^NODEJS_(\d+)_X$/.exec(member)?.[1] ?? /^PYTHON_(\d+)_(\d+)$/.exec(member)?.slice(1).join('.');
+/**
+ * Read a bound CDK runtime, or undefined when the value is not a versioned managed
+ * runtime.
+ *
+ * GritQL has already established this is a `runtime` property and isolated its
+ * value, so the regex only reads that scalar.
+ */ const readCdkRuntime = (value)=>{
+    const member = /^(?:lambda\.)?Runtime\.((?:NODEJS|PYTHON)_[A-Z0-9_]+)$/.exec(value.trim())?.[1];
+    if (!member) {
+        return undefined;
+    }
+    return {
+        value: value.trim(),
+        language: member.startsWith('NODEJS') ? 'node' : 'python',
+        version: cdkMemberVersion(member)
+    };
+};
+/** Read a bound Terraform runtime, or undefined for a non-runtime value. */ const readTerraformRuntime = (value)=>{
+    const identifier = /^"((?:nodejs|python)[0-9][^"]*)"$/.exec(value.trim())?.[1];
+    if (!identifier) {
+        return undefined;
+    }
+    return {
+        value: value.trim(),
+        language: identifier.startsWith('nodejs') ? 'node' : 'python',
+        version: /^nodejs([\d.]+?)\.x$/.exec(identifier)?.[1] ?? /^python([\d.]+)$/.exec(identifier)?.[1]
+    };
+};
+/**
+ * Every runtime a vended file assigns, or undefined when the pattern could not be
+ * applied to it.
+ *
+ * The two are distinguished so a file the parser rejected is reported rather than
+ * mistaken for one with nothing to do, which would make this a silent no-op.
+ */ const declaredRuntimes = async (tree, path, iac)=>{
+    const values = await captureAllGritQLVariable(tree, path, RUNTIME_ASSIGNMENT[iac], 'value');
+    if (values === undefined) {
+        return undefined;
+    }
+    const read = iac === 'terraform' ? readTerraformRuntime : readCdkRuntime;
+    return values.flatMap((value)=>{
+        const runtime = read(value);
+        return runtime ? [
+            runtime
+        ] : [];
+    });
+};
+/**
+ * The runtime this release vends, written the way the declared one was.
+ *
+ * A namespace-imported construct writes `lambda.Runtime.X`, so the prefix on the
+ * declared value is carried over rather than dropped.
+ */ const vendedRuntime = (iac, declared)=>{
+    if (iac === 'terraform') {
+        return `"${terraformLambdaRuntime(declared.language)}"`;
+    }
+    const namespace = declared.value.startsWith('lambda.') ? 'lambda.' : '';
+    return `${namespace}${cdkLambdaRuntime(declared.language)}`;
+};
+/**
+ * Sync the Lambda runtimes in the directories this plugin owns.
+ *
+ * A runtime below the pin is ours to move, as is a `_LATEST` alias — its value is
+ * decided by `aws-cdk-lib`, which is the drift this closes. A runtime at or ahead
+ * of the pin is the user's and is left, as is any Lambda outside these
+ * directories. One the rewrite cannot reach is reported instead.
+ *
+ * @returns the files changed, and the owned files still holding an older runtime
+ */ export const syncLambdaRuntimes = async (tree, dirs)=>{
+    const updated = [];
+    const diverged = [];
+    for (const [iac, dir] of Object.entries(dirs)){
+        if (!tree.exists(dir)) {
+            continue;
+        }
+        const extension = iac === 'terraform' ? '.tf' : '.ts';
+        const files = [];
+        // Started at the owned directory, so the provider follows from where a file
+        // sits rather than being inferred from it.
+        visitNotIgnoredFiles(tree, dir, (path)=>{
+            if (path.endsWith(extension)) {
+                files.push(path);
+            }
+        });
+        for (const path of files){
+            const declared = await declaredRuntimes(tree, path, iac);
+            if (declared === undefined) {
+                diverged.push(path);
+                continue;
+            }
+            let changed = false;
+            let stale = false;
+            // Deduped: one rewrite covers every occurrence of the same value.
+            const seen = new Set();
+            for (const runtime of declared){
+                if (seen.has(runtime.value)) {
+                    continue;
+                }
+                seen.add(runtime.value);
+                const vended = vendedRuntime(iac, runtime);
+                if (runtime.value === vended) {
+                    continue;
+                }
+                // An alias carries no version to compare, and is always ours to pin.
+                if (runtime.version !== undefined && !isVendedUpgrade(LAMBDA_RUNTIME_VERSIONS[runtime.language], runtime.version)) {
+                    continue;
+                }
+                const assignment = iac === 'terraform' ? 'runtime = ' : 'runtime: ';
+                const prefix = iac === 'terraform' ? 'language hcl\n' : '';
+                if (await applyGritQL(tree, path, `${prefix}\`${assignment}${runtime.value}\` => \`${assignment}${vended}\``)) {
+                    changed = true;
+                } else {
+                    stale = true;
+                }
+            }
+            if (changed) {
+                updated.push(path);
+            }
+            if (stale) {
+                diverged.push(path);
+            }
+        }
+    }
+    return {
+        updated,
+        diverged
+    };
+};
+
+//# sourceMappingURL=sync-lambda-runtimes.js.map

package/src/utils/version-upgrade-migration/sync-lambda-runtimes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/utils/version-upgrade-migration/sync-lambda-runtimes.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { type Tree, visitNotIgnoredFiles } from '@nx/devkit';\nimport { applyGritQL, captureAllGritQLVariable } from '../ast.js';\nimport {\n  cdkLambdaRuntime,\n  type ILambdaRuntime,\n  LAMBDA_RUNTIME_VERSIONS,\n  terraformLambdaRuntime,\n} from '../versions.js';\nimport { isVendedUpgrade } from './vended-upgrade.js';\n\n/**\n * Sync the Lambda runtimes vended into the projects this plugin owns.\n *\n * The runtimes present are read from each file rather than compared against a\n * list of what past releases vended, which would need maintaining by hand for the\n * same reason the pin itself does.\n */\n\n/** The IaC provider a vended file belongs to, decided by the directory it sits in. */\nexport type VendedIac = 'cdk' | 'terraform';\n\n/** A Lambda runtime a vended file declares. */\ninterface DeclaredRuntime {\n  /** The runtime as written, e.g. `lambda.Runtime.NODEJS_22_X` or `\"nodejs22.x\"`. */\n  readonly value: string;\n  readonly language: ILambdaRuntime;\n  /**\n   * Version the runtime names, or undefined for an alias like `NODEJS_LATEST`\n   * whose value `aws-cdk-lib` decides rather than this repo.\n   */\n  readonly version?: string;\n}\n\n/**\n * GritQL binding the value of a `runtime` assignment.\n *\n * Structure is matched here and nowhere else: the binding is the runtime alone, so\n * no caller re-derives the assignment around it, and a `runtime` that isn't a real\n * property or attribute — inside a comment, say — never matches.\n */\nconst RUNTIME_ASSIGNMENT: Record<VendedIac, string> = {\n  cdk: '`runtime: $value`',\n  terraform: 'language hcl\\n`runtime = $value`',\n};\n\n/** `NODEJS_22_X` -> `22`, `PYTHON_3_14` -> `3.14`; undefined for an alias. */\nconst cdkMemberVersion = (member: string): string | undefined =>\n  /^NODEJS_(\\d+)_X$/.exec(member)?.[1] ??\n  /^PYTHON_(\\d+)_(\\d+)$/.exec(member)?.slice(1).join('.');\n\n/**\n * Read a bound CDK runtime, or undefined when the value is not a versioned managed\n * runtime.\n *\n * GritQL has already established this is a `runtime` property and isolated its\n * value, so the regex only reads that scalar.\n */\nconst readCdkRuntime = (value: string): DeclaredRuntime | undefined => {\n  const member = /^(?:lambda\\.)?Runtime\\.((?:NODEJS|PYTHON)_[A-Z0-9_]+)$/.exec(\n    value.trim(),\n  )?.[1];\n  if (!member) {\n    return undefined;\n  }\n  return {\n    value: value.trim(),\n    language: member.startsWith('NODEJS') ? 'node' : 'python',\n    version: cdkMemberVersion(member),\n  };\n};\n\n/** Read a bound Terraform runtime, or undefined for a non-runtime value. */\nconst readTerraformRuntime = (value: string): DeclaredRuntime | undefined => {\n  const identifier = /^\"((?:nodejs|python)[0-9][^\"]*)\"$/.exec(\n    value.trim(),\n  )?.[1];\n  if (!identifier) {\n    return undefined;\n  }\n  return {\n    value: value.trim(),\n    language: identifier.startsWith('nodejs') ? 'node' : 'python',\n    version:\n      /^nodejs([\\d.]+?)\\.x$/.exec(identifier)?.[1] ??\n      /^python([\\d.]+)$/.exec(identifier)?.[1],\n  };\n};\n\n/**\n * Every runtime a vended file assigns, or undefined when the pattern could not be\n * applied to it.\n *\n * The two are distinguished so a file the parser rejected is reported rather than\n * mistaken for one with nothing to do, which would make this a silent no-op.\n */\nconst declaredRuntimes = async (\n  tree: Tree,\n  path: string,\n  iac: VendedIac,\n): Promise<DeclaredRuntime[] | undefined> => {\n  const values = await captureAllGritQLVariable(\n    tree,\n    path,\n    RUNTIME_ASSIGNMENT[iac],\n    'value',\n  );\n  if (values === undefined) {\n    return undefined;\n  }\n\n  const read = iac === 'terraform' ? readTerraformRuntime : readCdkRuntime;\n  return values.flatMap((value) => {\n    const runtime = read(value);\n    return runtime ? [runtime] : [];\n  });\n};\n\n/**\n * The runtime this release vends, written the way the declared one was.\n *\n * A namespace-imported construct writes `lambda.Runtime.X`, so the prefix on the\n * declared value is carried over rather than dropped.\n */\nconst vendedRuntime = (iac: VendedIac, declared: DeclaredRuntime): string => {\n  if (iac === 'terraform') {\n    return `\"${terraformLambdaRuntime(declared.language)}\"`;\n  }\n  const namespace = declared.value.startsWith('lambda.') ? 'lambda.' : '';\n  return `${namespace}${cdkLambdaRuntime(declared.language)}`;\n};\n\n/**\n * Sync the Lambda runtimes in the directories this plugin owns.\n *\n * A runtime below the pin is ours to move, as is a `_LATEST` alias — its value is\n * decided by `aws-cdk-lib`, which is the drift this closes. A runtime at or ahead\n * of the pin is the user's and is left, as is any Lambda outside these\n * directories. One the rewrite cannot reach is reported instead.\n *\n * @returns the files changed, and the owned files still holding an older runtime\n */\nexport const syncLambdaRuntimes = async (\n  tree: Tree,\n  dirs: Readonly<Record<VendedIac, string>>,\n): Promise<{ updated: string[]; diverged: string[] }> => {\n  const updated: string[] = [];\n  const diverged: string[] = [];\n\n  for (const [iac, dir] of Object.entries(dirs) as [VendedIac, string][]) {\n    if (!tree.exists(dir)) {\n      continue;\n    }\n    const extension = iac === 'terraform' ? '.tf' : '.ts';\n    const files: string[] = [];\n    // Started at the owned directory, so the provider follows from where a file\n    // sits rather than being inferred from it.\n    visitNotIgnoredFiles(tree, dir, (path) => {\n      if (path.endsWith(extension)) {\n        files.push(path);\n      }\n    });\n\n    for (const path of files) {\n      const declared = await declaredRuntimes(tree, path, iac);\n      if (declared === undefined) {\n        diverged.push(path);\n        continue;\n      }\n\n      let changed = false;\n      let stale = false;\n\n      // Deduped: one rewrite covers every occurrence of the same value.\n      const seen = new Set<string>();\n      for (const runtime of declared) {\n        if (seen.has(runtime.value)) {\n          continue;\n        }\n        seen.add(runtime.value);\n\n        const vended = vendedRuntime(iac, runtime);\n        if (runtime.value === vended) {\n          continue;\n        }\n        // An alias carries no version to compare, and is always ours to pin.\n        if (\n          runtime.version !== undefined &&\n          !isVendedUpgrade(\n            LAMBDA_RUNTIME_VERSIONS[runtime.language],\n            runtime.version,\n          )\n        ) {\n          continue;\n        }\n\n        const assignment = iac === 'terraform' ? 'runtime = ' : 'runtime: ';\n        const prefix = iac === 'terraform' ? 'language hcl\\n' : '';\n        if (\n          await applyGritQL(\n            tree,\n            path,\n            `${prefix}\\`${assignment}${runtime.value}\\` => \\`${assignment}${vended}\\``,\n          )\n        ) {\n          changed = true;\n        } else {\n          stale = true;\n        }\n      }\n\n      if (changed) {\n        updated.push(path);\n      }\n      if (stale) {\n        diverged.push(path);\n      }\n    }\n  }\n\n  return { updated, diverged };\n};\n"],"names":["visitNotIgnoredFiles","applyGritQL","captureAllGritQLVariable","cdkLambdaRuntime","LAMBDA_RUNTIME_VERSIONS","terraformLambdaRuntime","isVendedUpgrade","RUNTIME_ASSIGNMENT","cdk","terraform","cdkMemberVersion","member","exec","slice","join","readCdkRuntime","value","trim","undefined","language","startsWith","version","readTerraformRuntime","identifier","declaredRuntimes","tree","path","iac","values","read","flatMap","runtime","vendedRuntime","declared","namespace","syncLambdaRuntimes","dirs","updated","diverged","dir","Object","entries","exists","extension","files","endsWith","push","changed","stale","seen","Set","has","add","vended","assignment","prefix"],"mappings":"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"}

package/src/utils/version-upgrade-migration/sync-metrics-version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Tree } from '@nx/devkit';
+/**
+ * Sync the plugin version the metrics files report, so usage is attributed to
+ * the release the workspace actually runs. The metric id and tags are owned by
+ * the generators and left alone.
+ *
+ * @returns the metrics files that changed
+ */
+export declare const syncMetricsVersion: (tree: Tree) => Promise<string[]>;

package/src/utils/version-upgrade-migration/sync-metrics-version.js

@@ -0,0 +1,33 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { applyGritQL } from "../ast.js";
+import { METRICS_ASPECT_FILE_PATH, TERRAFORM_METRICS_FILE_PATH } from "../metrics.js";
+import { getPackageVersion } from "../nx.js";
+/**
+ * Sync the plugin version the metrics files report, so usage is attributed to
+ * the release the workspace actually runs. The metric id and tags are owned by
+ * the generators and left alone.
+ *
+ * @returns the metrics files that changed
+ */ export const syncMetricsVersion = async (tree)=>{
+    const version = getPackageVersion();
+    const updated = [];
+    if (tree.exists(METRICS_ASPECT_FILE_PATH)) {
+        const changed = await applyGritQL(tree, METRICS_ASPECT_FILE_PATH, `\`const version = $old\` => \`const version = '${version}'\`` + ' where { $old <: within `class MetricsAspect implements $_ { $_ }` }');
+        if (changed) {
+            updated.push(METRICS_ASPECT_FILE_PATH);
+        }
+    }
+    if (tree.exists(TERRAFORM_METRICS_FILE_PATH)) {
+        // GritQL's HCL grammar rejects `within locals { ... }`, so the match is
+        // narrowed to a string value to skip interpolated mentions.
+        const changed = await applyGritQL(tree, TERRAFORM_METRICS_FILE_PATH, `\`metric_version = $old\` => \`metric_version = "${version}"\`` + ' where { $old <: string() }');
+        if (changed) {
+            updated.push(TERRAFORM_METRICS_FILE_PATH);
+        }
+    }
+    return updated;
+};
+
+//# sourceMappingURL=sync-metrics-version.js.map

package/src/utils/version-upgrade-migration/sync-metrics-version.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/utils/version-upgrade-migration/sync-metrics-version.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { Tree } from '@nx/devkit';\nimport { applyGritQL } from '../ast.js';\nimport {\n  METRICS_ASPECT_FILE_PATH,\n  TERRAFORM_METRICS_FILE_PATH,\n} from '../metrics.js';\nimport { getPackageVersion } from '../nx.js';\n\n/**\n * Sync the plugin version the metrics files report, so usage is attributed to\n * the release the workspace actually runs. The metric id and tags are owned by\n * the generators and left alone.\n *\n * @returns the metrics files that changed\n */\nexport const syncMetricsVersion = async (tree: Tree): Promise<string[]> => {\n  const version = getPackageVersion();\n  const updated: string[] = [];\n\n  if (tree.exists(METRICS_ASPECT_FILE_PATH)) {\n    const changed = await applyGritQL(\n      tree,\n      METRICS_ASPECT_FILE_PATH,\n      `\\`const version = $old\\` => \\`const version = '${version}'\\`` +\n        ' where { $old <: within `class MetricsAspect implements $_ { $_ }` }',\n    );\n    if (changed) {\n      updated.push(METRICS_ASPECT_FILE_PATH);\n    }\n  }\n\n  if (tree.exists(TERRAFORM_METRICS_FILE_PATH)) {\n    // GritQL's HCL grammar rejects `within locals { ... }`, so the match is\n    // narrowed to a string value to skip interpolated mentions.\n    const changed = await applyGritQL(\n      tree,\n      TERRAFORM_METRICS_FILE_PATH,\n      `\\`metric_version = $old\\` => \\`metric_version = \"${version}\"\\`` +\n        ' where { $old <: string() }',\n    );\n    if (changed) {\n      updated.push(TERRAFORM_METRICS_FILE_PATH);\n    }\n  }\n\n  return updated;\n};\n"],"names":["applyGritQL","METRICS_ASPECT_FILE_PATH","TERRAFORM_METRICS_FILE_PATH","getPackageVersion","syncMetricsVersion","tree","version","updated","exists","changed","push"],"mappings":"AAAA;;;CAGC,GAED,SAASA,WAAW,QAAQ,YAAY;AACxC,SACEC,wBAAwB,EACxBC,2BAA2B,QACtB,gBAAgB;AACvB,SAASC,iBAAiB,QAAQ,WAAW;AAE7C;;;;;;CAMC,GACD,OAAO,MAAMC,qBAAqB,OAAOC;IACvC,MAAMC,UAAUH;IAChB,MAAMI,UAAoB,EAAE;IAE5B,IAAIF,KAAKG,MAAM,CAACP,2BAA2B;QACzC,MAAMQ,UAAU,MAAMT,YACpBK,MACAJ,0BACA,CAAC,+CAA+C,EAAEK,QAAQ,GAAG,CAAC,GAC5D;QAEJ,IAAIG,SAAS;YACXF,QAAQG,IAAI,CAACT;QACf;IACF;IAEA,IAAII,KAAKG,MAAM,CAACN,8BAA8B;QAC5C,wEAAwE;QACxE,4DAA4D;QAC5D,MAAMO,UAAU,MAAMT,YACpBK,MACAH,6BACA,CAAC,iDAAiD,EAAEI,QAAQ,GAAG,CAAC,GAC9D;QAEJ,IAAIG,SAAS;YACXF,QAAQG,IAAI,CAACR;QACf;IACF;IAEA,OAAOK;AACT,EAAE"}

package/src/utils/version-upgrade-migration/sync-python-language-version.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Tree } from '@nx/devkit';
+/**
+ * Sync the Python language version a generated workspace builds and lints against
+ * to the Lambda Python runtime it deploys onto.
+ *
+ * These are workspace-wide rather than scoped to the infrastructure projects: uv
+ * writes a `.python-version` per Python project wherever it sits, and a bundle
+ * target lives in the project it belongs to.
+ */
+/**
+ * Sync the interpreter a uv project pins to the Lambda Python runtime.
+ *
+ * `.python-version` holds the interpreter and `[project].requires-python` its
+ * lower bound; Ruff's `target-version` is derived from the latter, so leaving
+ * these behind lints against a different version than the function runs on. Only
+ * moved forward, and only from a value this plugin vended.
+ */
+export declare const syncProjectPythonVersion: (tree: Tree) => string[];
+/**
+ * Sync the Python version a `bundle` target resolves wheels against.
+ *
+ * The target pins `--python-platform` but earlier releases pinned no
+ * `--python-version`, so wheels resolved against whichever interpreter the build
+ * machine had rather than the Lambda runtime. Both the missing flag and a stale
+ * one are corrected, keyed on the `uv pip install` the generators write.
+ */
+export declare const syncPythonBundleVersion: (tree: Tree) => string[];

package/src/utils/version-upgrade-migration/sync-python-language-version.js

@@ -0,0 +1,110 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { updateJson, visitNotIgnoredFiles } from "@nx/devkit";
+import { updateToml } from "../toml.js";
+import { LAMBDA_RUNTIME_VERSIONS, pyenvPythonVersion, pyprojectPythonDependency } from "../versions.js";
+import { isVendedUpgrade } from "./vended-upgrade.js";
+/**
+ * Sync the Python language version a generated workspace builds and lints against
+ * to the Lambda Python runtime it deploys onto.
+ *
+ * These are workspace-wide rather than scoped to the infrastructure projects: uv
+ * writes a `.python-version` per Python project wherever it sits, and a bundle
+ * target lives in the project it belongs to.
+ */ /**
+ * Sync the interpreter a uv project pins to the Lambda Python runtime.
+ *
+ * `.python-version` holds the interpreter and `[project].requires-python` its
+ * lower bound; Ruff's `target-version` is derived from the latter, so leaving
+ * these behind lints against a different version than the function runs on. Only
+ * moved forward, and only from a value this plugin vended.
+ */ export const syncProjectPythonVersion = (tree)=>{
+    const updated = [];
+    const vendedInterpreter = pyenvPythonVersion();
+    const vendedRequires = pyprojectPythonDependency();
+    // Every `.python-version`, not just the root: uv writes one per project too,
+    // and a project left behind resolves a different interpreter than it deploys on.
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (path !== '.python-version' && !path.endsWith('/.python-version')) {
+            return;
+        }
+        const declared = (tree.read(path, 'utf-8') ?? '').trim();
+        if (declared && isVendedUpgrade(vendedInterpreter, declared)) {
+            tree.write(path, `${vendedInterpreter}\n`);
+            updated.push(path);
+        }
+    });
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (!path.endsWith('pyproject.toml')) {
+            return;
+        }
+        let changed = false;
+        updateToml(tree, path, (toml)=>{
+            const project = toml.project;
+            const declared = project?.['requires-python'];
+            if (typeof declared !== 'string') {
+                return toml;
+            }
+            // Only the `>=<major>.<minor>` shape the generators write, so a specifier
+            // the user tightened or widened is theirs to keep.
+            const lower = /^>=\s*(\d+\.\d+)$/.exec(declared.trim());
+            if (lower && isVendedUpgrade(LAMBDA_RUNTIME_VERSIONS.python, lower[1])) {
+                project['requires-python'] = vendedRequires;
+                changed = true;
+            }
+            return toml;
+        });
+        if (changed) {
+            updated.push(path);
+        }
+    });
+    return updated;
+};
+/**
+ * Sync the Python version a `bundle` target resolves wheels against.
+ *
+ * The target pins `--python-platform` but earlier releases pinned no
+ * `--python-version`, so wheels resolved against whichever interpreter the build
+ * machine had rather than the Lambda runtime. Both the missing flag and a stale
+ * one are corrected, keyed on the `uv pip install` the generators write.
+ */ export const syncPythonBundleVersion = (tree)=>{
+    const updated = [];
+    const vended = LAMBDA_RUNTIME_VERSIONS.python;
+    visitNotIgnoredFiles(tree, '.', (path)=>{
+        if (!path.endsWith('project.json')) {
+            return;
+        }
+        let changed = false;
+        updateJson(tree, path, (json)=>{
+            for (const target of Object.values(json.targets ?? {})){
+                const options = target.options;
+                if (!Array.isArray(options?.commands)) {
+                    continue;
+                }
+                options.commands = options.commands.map((command)=>{
+                    if (typeof command !== 'string' || !command.includes('uv pip install') || !command.includes('--python-platform')) {
+                        return command;
+                    }
+                    const declared = /--python-version (\S+)/.exec(command);
+                    if (!declared) {
+                        changed = true;
+                        return command.replace(/(--python-platform \S+)/, `$1 --python-version ${vended}`);
+                    }
+                    if (isVendedUpgrade(vended, declared[1])) {
+                        changed = true;
+                        return command.replace(/--python-version \S+/, `--python-version ${vended}`);
+                    }
+                    return command;
+                });
+            }
+            return json;
+        });
+        if (changed) {
+            updated.push(path);
+        }
+    });
+    return updated;
+};
+
+//# sourceMappingURL=sync-python-language-version.js.map

package/src/utils/version-upgrade-migration/sync-python-language-version.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/utils/version-upgrade-migration/sync-python-language-version.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { type Tree, updateJson, visitNotIgnoredFiles } from '@nx/devkit';\nimport { updateToml } from '../toml.js';\nimport {\n  LAMBDA_RUNTIME_VERSIONS,\n  pyenvPythonVersion,\n  pyprojectPythonDependency,\n} from '../versions.js';\nimport { isVendedUpgrade } from './vended-upgrade.js';\n\n/**\n * Sync the Python language version a generated workspace builds and lints against\n * to the Lambda Python runtime it deploys onto.\n *\n * These are workspace-wide rather than scoped to the infrastructure projects: uv\n * writes a `.python-version` per Python project wherever it sits, and a bundle\n * target lives in the project it belongs to.\n */\n\n/**\n * Sync the interpreter a uv project pins to the Lambda Python runtime.\n *\n * `.python-version` holds the interpreter and `[project].requires-python` its\n * lower bound; Ruff's `target-version` is derived from the latter, so leaving\n * these behind lints against a different version than the function runs on. Only\n * moved forward, and only from a value this plugin vended.\n */\nexport const syncProjectPythonVersion = (tree: Tree): string[] => {\n  const updated: string[] = [];\n  const vendedInterpreter = pyenvPythonVersion();\n  const vendedRequires = pyprojectPythonDependency();\n\n  // Every `.python-version`, not just the root: uv writes one per project too,\n  // and a project left behind resolves a different interpreter than it deploys on.\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (path !== '.python-version' && !path.endsWith('/.python-version')) {\n      return;\n    }\n    const declared = (tree.read(path, 'utf-8') ?? '').trim();\n    if (declared && isVendedUpgrade(vendedInterpreter, declared)) {\n      tree.write(path, `${vendedInterpreter}\\n`);\n      updated.push(path);\n    }\n  });\n\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (!path.endsWith('pyproject.toml')) {\n      return;\n    }\n    let changed = false;\n    updateToml(tree, path, (toml) => {\n      const project = toml.project as Record<string, unknown> | undefined;\n      const declared = project?.['requires-python'];\n      if (typeof declared !== 'string') {\n        return toml;\n      }\n      // Only the `>=<major>.<minor>` shape the generators write, so a specifier\n      // the user tightened or widened is theirs to keep.\n      const lower = /^>=\\s*(\\d+\\.\\d+)$/.exec(declared.trim());\n      if (lower && isVendedUpgrade(LAMBDA_RUNTIME_VERSIONS.python, lower[1])) {\n        project!['requires-python'] = vendedRequires;\n        changed = true;\n      }\n      return toml;\n    });\n    if (changed) {\n      updated.push(path);\n    }\n  });\n\n  return updated;\n};\n\n/**\n * Sync the Python version a `bundle` target resolves wheels against.\n *\n * The target pins `--python-platform` but earlier releases pinned no\n * `--python-version`, so wheels resolved against whichever interpreter the build\n * machine had rather than the Lambda runtime. Both the missing flag and a stale\n * one are corrected, keyed on the `uv pip install` the generators write.\n */\nexport const syncPythonBundleVersion = (tree: Tree): string[] => {\n  const updated: string[] = [];\n  const vended = LAMBDA_RUNTIME_VERSIONS.python;\n\n  visitNotIgnoredFiles(tree, '.', (path) => {\n    if (!path.endsWith('project.json')) {\n      return;\n    }\n    let changed = false;\n    updateJson(tree, path, (json) => {\n      for (const target of Object.values(\n        (json.targets ?? {}) as Record<string, { options?: unknown }>,\n      )) {\n        const options = target.options as { commands?: unknown[] } | undefined;\n        if (!Array.isArray(options?.commands)) {\n          continue;\n        }\n        options.commands = options.commands.map((command) => {\n          if (\n            typeof command !== 'string' ||\n            !command.includes('uv pip install') ||\n            !command.includes('--python-platform')\n          ) {\n            return command;\n          }\n          const declared = /--python-version (\\S+)/.exec(command);\n          if (!declared) {\n            changed = true;\n            return command.replace(\n              /(--python-platform \\S+)/,\n              `$1 --python-version ${vended}`,\n            );\n          }\n          if (isVendedUpgrade(vended, declared[1])) {\n            changed = true;\n            return command.replace(\n              /--python-version \\S+/,\n              `--python-version ${vended}`,\n            );\n          }\n          return command;\n        });\n      }\n      return json;\n    });\n    if (changed) {\n      updated.push(path);\n    }\n  });\n\n  return updated;\n};\n"],"names":["updateJson","visitNotIgnoredFiles","updateToml","LAMBDA_RUNTIME_VERSIONS","pyenvPythonVersion","pyprojectPythonDependency","isVendedUpgrade","syncProjectPythonVersion","tree","updated","vendedInterpreter","vendedRequires","path","endsWith","declared","read","trim","write","push","changed","toml","project","lower","exec","python","syncPythonBundleVersion","vended","json","target","Object","values","targets","options","Array","isArray","commands","map","command","includes","replace"],"mappings":"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"}

package/src/utils/version-upgrade-migration/sync-vended-versions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type MigrationReturnObject, type Tree } from '@nx/devkit';
+/**
+ * Sync the versions this release vends, for the dependencies the workspace's
+ * generators own.
+ */
+export declare const syncVendedVersions: (tree: Tree) => Promise<MigrationReturnObject>;