@mavogel/mvc-projen 0.0.32 → 0.0.34

package/.claude/rules/mvc-projen-toolchain-maintenance.md

@@ -1,6 +1,6 @@
 # Toolchain Maintenance: projen / jsii / typescript
 
-**Last Updated:** 2026-07-21
+**Last Updated:** 2026-09-12
 
 This repo's own build (`.projenrc.ts`, a `cdk.JsiiProject`) pins several versions as literals. These pins exist for specific reasons — don't remove them without understanding why.
 
@@ -9,9 +9,15 @@ This repo's own build (`.projenrc.ts`, a `cdk.JsiiProject`) pins several version
 | Setting | Value | Why pinned |
 |---|---|---|
 | `projenVersion` (const, top of file) | `0.101.17` | Source of truth for `package.json`'s `projen` entry — see below |
-| `jsiiVersion` | `~5.9.0` | Compiler compatibility |
+| `jsiiVersion` | `~6.0.0` | Compiler compatibility |
 | `typescriptVersion` | `^6.0.2` | **Prevents drifting onto TypeScript 7** (see gotcha below) |
 
+## Use Node 24 locally, matching `.nvmrc`
+
+This repo's `.nvmrc` pins Node `24` — the version jsii's compiler actually supports (jsii's supported list: `^24.0.0`, `^22.0.0`, `^20.0.0` [deprecated]). Before running `npx projen`, `npm run build`, `npm install`, or any other repo command, switch to it: `nvm use` (reads `.nvmrc` automatically) or `nvm use 24`.
+
+Running under a newer Node (e.g. Node 26, the current non-LTS release as of this writing) doesn't break the build, but every `jsii`/`jsii-pacmak` invocation prints an "untested node version" warning and clutters output — annoying to read through and easy to mistake for a real problem. If a shell's default Node is already 26+, run `nvm use 24` first rather than ignoring the warning.
+
 ## ⚠️ Gotcha: unpinned `typescript` devDependency drifts onto breaking majors
 
 If `typescriptVersion` is ever removed from the `JsiiProject` options, projen adds `typescript` as a devDependency with **no version range** (`node_modules/projen/lib/typescript/typescript.js` — `tsDep = options.typescriptVersion ? "typescript@${...}" : "typescript"`). npm then resolves it to whatever is latest at synth time.
@@ -22,22 +28,23 @@ This broke the build on 2026-07-21: TypeScript 7.0.2 (the new Go-ported compiler
 
 **Known gap:** `src/projects/cdk-construct.ts` (`MvcCdkConstructLibrary`, what this module scaffolds for *consumers*) does NOT set `typescriptVersion` in its own projen options. Generated consumer projects are exposed to the same drift/break. Worth fixing in `cdk-construct.ts` as a follow-up — not yet done.
 
-## Keeping `projen` itself current
+## Keeping `projen` and `jsii` current
+
+`projenVersion` and `jsiiVersion` are hardcoded literals, not normal devDependency ranges — they're the source of truth that regenerates `package.json`'s `projen`/`jsii`/`jsii-rosetta` entries on every `npx projen` run. This is why `dependabotOptions.groups.default.excludePatterns`/`ignore` exclude `projen`, `jsii`, and `jsii-rosetta`: a Dependabot PR that only edits `package.json` would get silently reverted by the `self_mutation_happened` check in `.github/workflows/build.yml` (`npx projen` would just re-derive the old pinned literal). `typescriptVersion` doesn't need this — it's a caret range, so `npm update`/Dependabot can already advance it within the current major via lockfile-only changes.
 
-`projenVersion` is a hardcoded literal, not a normal devDependency range — it's the source of truth that regenerates `package.json`'s `projen` entry on every `npx projen` run. This is why `dependabotOptions.groups.default.excludePatterns` excludes `projen`: a Dependabot PR that only edits `package.json` would get silently reverted by the `self_mutation_happened` check in `.github/workflows/build.yml` (`npx projen` would just re-derive the old pinned version).
+Two generated workflows automate the literal bumps instead (both weekly cron, Monday 06:00 UTC, + manual `workflow_dispatch`), sharing the `addSelfUpgradeWorkflow()` builder in `.projenrc.ts`:
 
-**`.github/workflows/upgrade-projen.yml`** automates this instead (weekly cron, Monday 06:00 UTC, + manual `workflow_dispatch`):
+- **`.github/workflows/upgrade-projen.yml`**: compares `package.json`'s current `devDependencies.projen` against `npm view projen version`.
+- **`.github/workflows/upgrade-jsii.yml`**: reads the `jsiiVersion` literal out of `.projenrc.ts` and compares it against the latest version *within the current major only* (`npm view jsii@<major>`) — crossing to the next jsii major stays a deliberate, human-reviewed bump, same as the `typescriptVersion` pin.
 
-1. Compares `package.json`'s current `devDependencies.projen` against `npm view projen version`
-2. If different: `sed`-updates the `projenVersion` const in `.projenrc.ts`, runs `npx projen` to re-synth everything, then `npm run build` as a gate
-3. Only if the build passes: commits to a `chore/upgrade-projen-<version>` branch and opens a PR via `gh pr create` (labeled `dependencies`, `auto-approve`)
+Both, if the versions differ: `sed`-update the literal in `.projenrc.ts`, run `npx projen` to re-synth everything, then `npm run build` as a gate. Only if the build passes: commit to a `chore/upgrade-<projen|jsii>-<version>` branch and open a PR via `gh pr create` (labeled `dependencies`, `auto-approve`) — auto-approved by a Mergify rule (since the PR is opened by `mvc-bot` via `PROJEN_GITHUB_TOKEN`, and GitHub rejects a PR review from the same account that authored the PR) and merged once required checks pass.
 
 To bump manually instead of waiting for the cron (or to debug it):
 
 ```bash
-npm view projen version                        # check latest
+npm view projen version                         # check latest
 # edit the `projenVersion` const in .projenrc.ts
-npx projen && npm run build                     # re-synth + verify
+npx projen && npm run build                      # re-synth + verify
 ```
 
 Same procedure applies to bumping `jsiiVersion` or `typescriptVersion` — always re-run the full build afterward; jsii/projen major bumps can change generated file layout (e.g. the 0.99→0.101 bump split `tsconfig.dev.json` into `tsconfig.json` + `test/tsconfig.json` + `projenrc/tsconfig.json`).

package/.jsii

@@ -8,7 +8,7 @@
   },
   "dependencies": {
     "constructs": "^10.5.1",
-    "projen": "^0.103.12"
+    "projen": "^0.103.20"
   },
   "dependencyClosure": {
     "constructs": {
@@ -86,7 +86,7 @@
     "stability": "stable"
   },
   "homepage": "https://github.com/mavogel/mvc-projen",
-  "jsiiVersion": "6.0.5 (build 4738da5)",
+  "jsiiVersion": "6.0.13 (build 5c05d06)",
   "keywords": [
     "aws",
     "cdk",
@@ -100,7 +100,8 @@
         "hasDefaultInterfaces": true
       }
     },
-    "tscRootDir": "/home/runner/work/mvc-projen/mvc-projen/src"
+    "tscOutDir": "lib",
+    "tscRootDir": "src"
   },
   "name": "@mavogel/mvc-projen",
   "readme": {
@@ -223,6 +224,6 @@
       "symbolId": "src/projects/cdk-construct:MvcCdkConstructLibraryOptions"
     }
   },
-  "version": "0.0.32",
-  "fingerprint": "XVWgvIqeIVseRQvbDBuejJkmXUYYuEOxCuRRAtG7cHA="
+  "version": "0.0.34",
+  "fingerprint": "Dvk1lcPJC18w4vWI1Golzm2I1WT0M7k3SlnLaEItpMI="
 }

package/API.md

@@ -1477,6 +1477,7 @@ const mvcCdkConstructLibraryOptions: MvcCdkConstructLibraryOptions = { ... }
 | <code><a href="#@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.bundledDeps">bundledDeps</a></code> | <code>string[]</code> | List of dependencies to bundle into this module. |
 | <code><a href="#@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.bunVersion">bunVersion</a></code> | <code>string</code> | The version of Bun to use if using Bun as a package manager. |
 | <code><a href="#@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.codeArtifactOptions">codeArtifactOptions</a></code> | <code>projen.javascript.CodeArtifactOptions</code> | Options for npm packages using AWS CodeArtifact. |
+| <code><a href="#@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.config">config</a></code> | <code>{[ key: string ]: any}</code> | Configuration values available to package scripts at runtime. |
 | <code><a href="#@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.dedupeDeps">dedupeDeps</a></code> | <code>boolean</code> | Add a `dedupe` task that deduplicates project dependencies. |
 | <code><a href="#@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.deleteOrphanedLockFiles">deleteOrphanedLockFiles</a></code> | <code>boolean</code> | Automatically delete lockfiles from package managers that are not the active one. |
 | <code><a href="#@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.deps">deps</a></code> | <code>string[]</code> | Runtime dependencies of this module. |
@@ -2209,6 +2210,23 @@ This is required if publishing packages to, or installing scoped packages from A
 
 ---
 
+##### `config`<sup>Optional</sup> <a name="config" id="@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.config"></a>
+
+```typescript
+public readonly config: {[ key: string ]: any};
+```
+
+- *Type:* {[ key: string ]: any}
+- *Default:* no package configuration
+
+Configuration values available to package scripts at runtime.
+
+Values should be JSON-serializable.
+
+> [https://docs.npmjs.com/cli/v11/configuring-npm/package-json#config](https://docs.npmjs.com/cli/v11/configuring-npm/package-json#config)
+
+---
+
 ##### `dedupeDeps`<sup>Optional</sup> <a name="dedupeDeps" id="@mavogel/mvc-projen.MvcCdkConstructLibraryOptions.property.dedupeDeps"></a>
 
 ```typescript

package/lib/projects/cdk-construct.js

@@ -57,7 +57,7 @@ const LAST_INTEG_RUNNER_VERSION = '2.203.0';
  * @pjid mvc-awscdk-construct
  */
 class MvcCdkConstructLibrary extends awscdk_1.AwsCdkConstructLibrary {
-    static [JSII_RTTI_SYMBOL_1] = { fqn: "@mavogel/mvc-projen.MvcCdkConstructLibrary", version: "0.0.32" };
+    static [JSII_RTTI_SYMBOL_1] = { fqn: "@mavogel/mvc-projen.MvcCdkConstructLibrary", version: "0.0.34" };
     constructor(options) {
         const baseAssetsDirectory = options.baseAssetsDirectory ?? `${process.cwd()}/node_modules/@mavogel/mvc-projen/assets`;
         const integTestRegions = options.integTestRegions ?? ['eu-west-1', 'eu-west-2'];

package/mavogelmvcprojen/MvcCdkConstructLibraryOptions.go

@@ -266,6 +266,15 @@ type MvcCdkConstructLibraryOptions struct {
 	//
 	// Experimental.
 	CodeArtifactOptions *javascript.CodeArtifactOptions `field:"optional" json:"codeArtifactOptions" yaml:"codeArtifactOptions"`
+	// Configuration values available to package scripts at runtime.
+	//
+	// Values should be JSON-serializable.
+	// See: https://docs.npmjs.com/cli/v11/configuring-npm/package-json#config
+	//
+	// Default: - no package configuration.
+	//
+	// Experimental.
+	Config *map[string]interface{} `field:"optional" json:"config" yaml:"config"`
 	// Add a `dedupe` task that deduplicates project dependencies.
 	//
 	// Deduplication prevents multiple versions of the same package from being

package/mavogelmvcprojen/go.mod

@@ -5,5 +5,5 @@ go 1.25
 require (
 	github.com/aws/jsii-runtime-go v1.139.0
 	github.com/aws/constructs-go/constructs/v10 v10.5.1
-	github.com/projen/projen-go/projen v0.103.12
+	github.com/projen/projen-go/projen v0.103.20
 )

package/mavogelmvcprojen/jsii/jsii.go

@@ -13,7 +13,7 @@ import (
 	projen     "github.com/projen/projen-go/projen/jsii"
 )
 
-//go:embed mavogel-mvc-projen-0.0.31.tgz
+//go:embed mavogel-mvc-projen-0.0.33.tgz
 var tarball []byte
 
 // Initialize loads the necessary packages in the @jsii/kernel to support the enclosing module.
@@ -24,5 +24,5 @@ func Initialize() {
 	projen.Initialize()
 
 	// Load this library into the kernel
-	_jsii_.Load("@mavogel/mvc-projen", "0.0.31", tarball)
+	_jsii_.Load("@mavogel/mvc-projen", "0.0.33", tarball)
 }

package/mavogelmvcprojen/version

@@ -1 +1 @@
-0.0.31
+0.0.33

package/package.json

@@ -57,18 +57,18 @@
     "jsii-docgen": "^10.5.0",
     "jsii-pacmak": "^1.139.0",
     "jsii-rosetta": "~6.0.0",
-    "projen": "0.103.12",
+    "projen": "0.103.20",
     "ts-jest": "^29.4.11",
     "ts-node": "^10",
     "typescript": "^6.0.2"
   },
   "peerDependencies": {
     "constructs": "^10.5.1",
-    "projen": "^0.103.12"
+    "projen": "^0.103.20"
   },
   "dependencies": {
     "constructs": "^10.5.1",
-    "projen": "^0.103.12"
+    "projen": "^0.103.20"
   },
   "keywords": [
     "aws",
@@ -88,7 +88,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.32",
+  "version": "0.0.34",
   "jest": {
     "coverageProvider": "v8",
     "testMatch": [