From dbd02b8861840273cc97de3db11727923e4e19c1 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Thu, 22 Oct 2026 11:59:04 +0200 Subject: [PATCH 01/16] Add 30-day npm min-release-age to TS template Mirror the uv exclude-newer setting from the Python template so new npm releases are only accepted after 30 days. Co-Authored-By: Claude Opus 5.5 --- .agents/skills/get-started/SKILL.md | 2 +- README.md | 3 ++- templates/ts/.npmrc | 1 + 3 files changed, 4 insertions(+), 2 deletions(-) create mode 100644 templates/ts/.npmrc diff --git a/.agents/skills/get-started/SKILL.md b/.agents/skills/get-started/SKILL.md index 5ab26d5..17d3483 100644 --- a/.agents/skills/get-started/SKILL.md +++ b/.agents/skills/get-started/SKILL.md @@ -43,7 +43,7 @@ Handle template scaffolding based on the chosen project language: - Move `templates/py/.pre-commit-config.yaml`, `templates/py/.gitignore`, and `templates/py/pyproject.toml` to the repo root. - Delete `templates/ts/` and any TS-only template files. - If the project is **TypeScript**: - - Move `templates/ts/package.json`, `templates/ts/.gitignore`, `templates/ts/tsconfig.json`, `templates/ts/eslint.config.mjs`, `templates/ts/secretlint.config.mjs`, and `templates/ts/.husky/` to the repo root. + - Move `templates/ts/package.json`, `templates/ts/.npmrc`, `templates/ts/.gitignore`, `templates/ts/tsconfig.json`, `templates/ts/eslint.config.mjs`, `templates/ts/secretlint.config.mjs`, and `templates/ts/.husky/` to the repo root. - Delete `templates/py/` and any Python-only template files. - If the project is **neither Python nor TypeScript**: - Create equivalent starter files for the selected stack in the repo root. diff --git a/README.md b/README.md index f2751eb..d107386 100644 --- a/README.md +++ b/README.md @@ -90,6 +90,7 @@ Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, #### `ts/` - `package.json` +- `.npmrc` - `.gitignore` - `tsconfig.json` - `eslint.config.mjs` @@ -98,4 +99,4 @@ Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, - `.husky/pre-push` - `.husky/_/husky.sh` -Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. +Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. The `.npmrc` config waits 30 days before accepting new package releases. diff --git a/templates/ts/.npmrc b/templates/ts/.npmrc new file mode 100644 index 0000000..8f0a88c --- /dev/null +++ b/templates/ts/.npmrc @@ -0,0 +1 @@ +min-release-age=30 From 1819961329488aa2ef81058ddcce95919c770564 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Thu, 22 Oct 2026 12:03:51 +0200 Subject: [PATCH 02/16] Require patched Node and release-age delay for npm and pnpm Set engines.node to >=26.12.1 (October 2026 security release) and engine-strict for npm. Add pnpm minimumReleaseAge (30 days) next to the npm min-release-age setting, and document both in the README. Co-Authored-By: Claude Opus 5.5 --- .agents/skills/get-started/SKILL.md | 2 +- README.md | 3 ++- templates/ts/.npmrc | 1 + templates/ts/package.json | 3 +++ templates/ts/pnpm-workspace.yaml | 1 + 5 files changed, 8 insertions(+), 2 deletions(-) create mode 100644 templates/ts/pnpm-workspace.yaml diff --git a/.agents/skills/get-started/SKILL.md b/.agents/skills/get-started/SKILL.md index 17d3483..3aee31a 100644 --- a/.agents/skills/get-started/SKILL.md +++ b/.agents/skills/get-started/SKILL.md @@ -43,7 +43,7 @@ Handle template scaffolding based on the chosen project language: - Move `templates/py/.pre-commit-config.yaml`, `templates/py/.gitignore`, and `templates/py/pyproject.toml` to the repo root. - Delete `templates/ts/` and any TS-only template files. - If the project is **TypeScript**: - - Move `templates/ts/package.json`, `templates/ts/.npmrc`, `templates/ts/.gitignore`, `templates/ts/tsconfig.json`, `templates/ts/eslint.config.mjs`, `templates/ts/secretlint.config.mjs`, and `templates/ts/.husky/` to the repo root. + - Move `templates/ts/package.json`, `templates/ts/.npmrc`, `templates/ts/pnpm-workspace.yaml`, `templates/ts/.gitignore`, `templates/ts/tsconfig.json`, `templates/ts/eslint.config.mjs`, `templates/ts/secretlint.config.mjs`, and `templates/ts/.husky/` to the repo root. - Delete `templates/py/` and any Python-only template files. - If the project is **neither Python nor TypeScript**: - Create equivalent starter files for the selected stack in the repo root. diff --git a/README.md b/README.md index d107386..4c432d7 100644 --- a/README.md +++ b/README.md @@ -91,6 +91,7 @@ Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, - `package.json` - `.npmrc` +- `pnpm-workspace.yaml` - `.gitignore` - `tsconfig.json` - `eslint.config.mjs` @@ -99,4 +100,4 @@ Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, - `.husky/pre-push` - `.husky/_/husky.sh` -Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. The `.npmrc` config waits 30 days before accepting new package releases. +Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. Both npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`) wait 30 days before accepting new package releases. `package.json` requires Node.js 26.12.1 or later, which includes the October 2026 security fixes, and both package managers refuse to install on an older version. diff --git a/templates/ts/.npmrc b/templates/ts/.npmrc index 8f0a88c..2abba24 100644 --- a/templates/ts/.npmrc +++ b/templates/ts/.npmrc @@ -1 +1,2 @@ +engine-strict=true min-release-age=30 diff --git a/templates/ts/package.json b/templates/ts/package.json index 89265cf..da4abb1 100644 --- a/templates/ts/package.json +++ b/templates/ts/package.json @@ -1,6 +1,9 @@ { "$schema": "https://json.schemastore.org/package.json", "packageManager": "pnpm@10", + "engines": { + "node": ">=26.12.1" + }, "scripts": { "prepare": "husky", "lint": "eslint . --max-warnings=0", diff --git a/templates/ts/pnpm-workspace.yaml b/templates/ts/pnpm-workspace.yaml new file mode 100644 index 0000000..4dddacf --- /dev/null +++ b/templates/ts/pnpm-workspace.yaml @@ -0,0 +1 @@ +minimumReleaseAge: 43200 From 4639895a5a81053ba7d1aef17d93a11c0758d387 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Thu, 22 Oct 2026 14:30:43 +0200 Subject: [PATCH 03/16] Pin template tooling and add security version floors TS: pin pnpm and all devDependencies to exact versions that are at least 30 days old, within their current major versions. Python: require uv >= 0.13.4 (eMudhra/emSign CA incident), exempt certifi from exclude-newer, and update pre-commit-hooks to v6.0.0. Document how to exempt urgent security fixes from the release delay. Co-Authored-By: Claude Opus 5.5 --- README.md | 4 ++-- templates/.DS_Store | Bin 0 -> 6148 bytes templates/py/.pre-commit-config.yaml | 2 +- templates/py/pyproject.toml | 2 ++ templates/ts/package.json | 30 +++++++++++++-------------- 5 files changed, 20 insertions(+), 18 deletions(-) create mode 100644 templates/.DS_Store diff --git a/README.md b/README.md index 4c432d7..9191510 100644 --- a/README.md +++ b/README.md @@ -85,7 +85,7 @@ It is inspired by the concept of "Agent Readiness" by Factory.AI: https://factor - `.gitignore` - `pyproject.toml` -Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, and secret scanning because they are fast, easy for agents to run locally. The `uv` config waits 30 days before accepting new package releases. +Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, and secret scanning because they are fast, easy for agents to run locally. The `uv` config waits 30 days before accepting new package releases and requires uv 0.13.4 or later, which no longer trusts the compromised eMudhra/emSign CA certificates. `certifi` is exempt from the 30-day wait, so CA certificate fixes install immediately. To let another urgent security fix through, add the package to `exclude-newer-package`. #### `ts/` @@ -100,4 +100,4 @@ Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, - `.husky/pre-push` - `.husky/_/husky.sh` -Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. Both npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`) wait 30 days before accepting new package releases. `package.json` requires Node.js 26.12.1 or later, which includes the October 2026 security fixes, and both package managers refuse to install on an older version. +Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. All dependencies, and pnpm itself, are pinned to exact versions. Both npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`) wait 30 days before accepting new package releases. To let an urgent security fix through, add the package to `min-release-age-exclude` in `.npmrc` and to `minimumReleaseAgeExclude` in `pnpm-workspace.yaml`. `package.json` requires Node.js 26.12.1 or later, which includes the October 2026 security fixes, and both package managers refuse to install on an older version. diff --git a/templates/.DS_Store b/templates/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..f27730d6ba2d0d2df2a51f758ac185249970b975 GIT binary patch literal 6148 zcmeHLO-~a+7@jFbwji=Vi%2xt*oz57t5%~ihP7a{dVsJ5i-2`^JCv1WrrF(6k&yJP zi9f&};1BS`(Thi~9=!MmJb3b|?|d|TY2wKknKzkv-g!S}`ab(HJ4FcLQnPj$Arm2F zK;xM1h3*%^{k$EKl(KXKVm^l#G7oeBl-my&7>?;|1o3On!$6j4jyZ>n1G$4)I@OtVu>rnm28|EU3U zaAJry@(LHRF8t%%<5`PlFB}Pv1$&)e#F9Xmc>C5FuJ%L1Ht8lY?SFL zgB3S{+?fV<#S0{g0gvQV7TqXvX`Pg|RzlY!;S4RYBw-solFtT(%tnOIB-VBst{>2P ze)5}SFmKOxlnYWZQC=#rOJqBmLY#k3q&iO-C7Dd#eyCgq8b^1~1LUAJ)IzV(8}t_K zq7UdZ`ij2eG#{1F5E{a``kXe(?>6t52G#1Q~64Q3&r z^Ur^tV=1&1wk3iG1j|%FnTpjB1Iu)yhI4UTZ;n3XKboYfBU< l(5dZMD10j(g(d`i7FPgmg>8vo0nr}=26.12.1" }, @@ -25,19 +25,19 @@ ] }, "devDependencies": { - "@eslint/js": "^10.0.1", - "@secretlint/secretlint-rule-preset-recommend": "^12.2.0", - "@types/node": "^25.6.0", - "@typescript-eslint/eslint-plugin": "^8.0.0", - "@typescript-eslint/parser": "^8.0.0", - "eslint": "^10.2.1", - "husky": "^9.0.0", - "jscpd": "^4.0.0", - "knip": "^6.6.1", - "lint-staged": "^16.0.0", - "prettier": "^3.0.0", - "secretlint": "^12.2.0", - "typescript-eslint": "^8.0.0", - "typescript": "^6.0.3" + "@eslint/js": "9.39.5", + "@secretlint/secretlint-rule-preset-recommend": "11.7.1", + "@types/node": "26.6.2", + "@typescript-eslint/eslint-plugin": "8.70.1", + "@typescript-eslint/parser": "8.70.1", + "eslint": "9.39.5", + "husky": "9.1.7", + "jscpd": "4.3.0", + "knip": "5.88.1", + "lint-staged": "16.4.0", + "prettier": "3.9.8", + "secretlint": "11.7.1", + "typescript-eslint": "8.70.1", + "typescript": "5.9.3" } } From 6b1e5a8146f804874347df479113523f5d1d190c Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Thu, 22 Oct 2026 14:44:10 +0200 Subject: [PATCH 04/16] Upgrade TS template tooling to latest major versions Move pnpm, ESLint, TypeScript, secretlint, knip, jscpd and lint-staged to the newest major versions that are at least 30 days old. This removes the braces advisory (GHSA-vfj7-8cjw-p6xm) that reached the template through fast-glob. TypeScript stays at 6.0.3 because typescript-eslint 8.x does not support TypeScript 7. Also untrack an accidental .DS_Store. Co-Authored-By: Claude Opus 5.5 --- templates/.DS_Store | Bin 6148 -> 0 bytes templates/ts/package.json | 18 +++++++++--------- 2 files changed, 9 insertions(+), 9 deletions(-) delete mode 100644 templates/.DS_Store diff --git a/templates/.DS_Store b/templates/.DS_Store deleted file mode 100644 index f27730d6ba2d0d2df2a51f758ac185249970b975..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6148 zcmeHLO-~a+7@jFbwji=Vi%2xt*oz57t5%~ihP7a{dVsJ5i-2`^JCv1WrrF(6k&yJP zi9f&};1BS`(Thi~9=!MmJb3b|?|d|TY2wKknKzkv-g!S}`ab(HJ4FcLQnPj$Arm2F zK;xM1h3*%^{k$EKl(KXKVm^l#G7oeBl-my&7>?;|1o3On!$6j4jyZ>n1G$4)I@OtVu>rnm28|EU3U zaAJry@(LHRF8t%%<5`PlFB}Pv1$&)e#F9Xmc>C5FuJ%L1Ht8lY?SFL zgB3S{+?fV<#S0{g0gvQV7TqXvX`Pg|RzlY!;S4RYBw-solFtT(%tnOIB-VBst{>2P ze)5}SFmKOxlnYWZQC=#rOJqBmLY#k3q&iO-C7Dd#eyCgq8b^1~1LUAJ)IzV(8}t_K zq7UdZ`ij2eG#{1F5E{a``kXe(?>6t52G#1Q~64Q3&r z^Ur^tV=1&1wk3iG1j|%FnTpjB1Iu)yhI4UTZ;n3XKboYfBU< l(5dZMD10j(g(d`i7FPgmg>8vo0nr}=26.12.1" }, @@ -25,19 +25,19 @@ ] }, "devDependencies": { - "@eslint/js": "9.39.5", - "@secretlint/secretlint-rule-preset-recommend": "11.7.1", + "@eslint/js": "10.0.1", + "@secretlint/secretlint-rule-preset-recommend": "13.0.5", "@types/node": "26.6.2", "@typescript-eslint/eslint-plugin": "8.70.1", "@typescript-eslint/parser": "8.70.1", - "eslint": "9.39.5", + "eslint": "10.11.0", "husky": "9.1.7", - "jscpd": "4.3.0", - "knip": "5.88.1", - "lint-staged": "16.4.0", + "jscpd": "5.3.1", + "knip": "6.37.0", + "lint-staged": "17.5.1", "prettier": "3.9.8", - "secretlint": "11.7.1", + "secretlint": "13.0.5", "typescript-eslint": "8.70.1", - "typescript": "5.9.3" + "typescript": "6.0.3" } } From 0a0cc2613bb52afbf95005f46442275eb3ae1562 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Thu, 22 Oct 2026 14:53:42 +0200 Subject: [PATCH 05/16] Fix TS template checks that failed on a new project - secretlint: replace secretlint.config.mjs, which secretlint never loads, with .secretlintrc.json. - ESLint: use defineConfig from eslint/config instead of the deprecated tseslint.config, and disable type-aware rules for .mjs config files. - Knip: drop the redundant @typescript-eslint/parser and eslint-plugin packages (typescript-eslint provides them) and declare the secretlint preset, which only the rc file references. - Prettier: ignore the generated pnpm-lock.yaml and format the configs. Co-Authored-By: Claude Opus 5.5 --- .agents/skills/get-started/SKILL.md | 2 +- README.md | 3 +- templates/ts/.prettierignore | 1 + templates/ts/.secretlintrc.json | 3 ++ templates/ts/eslint.config.mjs | 48 ++++++++++++++++++----------- templates/ts/package.json | 7 +++-- templates/ts/secretlint.config.mjs | 7 ----- 7 files changed, 42 insertions(+), 29 deletions(-) create mode 100644 templates/ts/.prettierignore create mode 100644 templates/ts/.secretlintrc.json delete mode 100644 templates/ts/secretlint.config.mjs diff --git a/.agents/skills/get-started/SKILL.md b/.agents/skills/get-started/SKILL.md index 3aee31a..ad84fce 100644 --- a/.agents/skills/get-started/SKILL.md +++ b/.agents/skills/get-started/SKILL.md @@ -43,7 +43,7 @@ Handle template scaffolding based on the chosen project language: - Move `templates/py/.pre-commit-config.yaml`, `templates/py/.gitignore`, and `templates/py/pyproject.toml` to the repo root. - Delete `templates/ts/` and any TS-only template files. - If the project is **TypeScript**: - - Move `templates/ts/package.json`, `templates/ts/.npmrc`, `templates/ts/pnpm-workspace.yaml`, `templates/ts/.gitignore`, `templates/ts/tsconfig.json`, `templates/ts/eslint.config.mjs`, `templates/ts/secretlint.config.mjs`, and `templates/ts/.husky/` to the repo root. + - Move `templates/ts/package.json`, `templates/ts/.npmrc`, `templates/ts/pnpm-workspace.yaml`, `templates/ts/.gitignore`, `templates/ts/tsconfig.json`, `templates/ts/eslint.config.mjs`, `templates/ts/.secretlintrc.json`, `templates/ts/.prettierignore`, and `templates/ts/.husky/` to the repo root. - Delete `templates/py/` and any Python-only template files. - If the project is **neither Python nor TypeScript**: - Create equivalent starter files for the selected stack in the repo root. diff --git a/README.md b/README.md index 9191510..a646161 100644 --- a/README.md +++ b/README.md @@ -95,7 +95,8 @@ Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, - `.gitignore` - `tsconfig.json` - `eslint.config.mjs` -- `secretlint.config.mjs` +- `.secretlintrc.json` +- `.prettierignore` - `.husky/pre-commit` - `.husky/pre-push` - `.husky/_/husky.sh` diff --git a/templates/ts/.prettierignore b/templates/ts/.prettierignore new file mode 100644 index 0000000..bd5535a --- /dev/null +++ b/templates/ts/.prettierignore @@ -0,0 +1 @@ +pnpm-lock.yaml diff --git a/templates/ts/.secretlintrc.json b/templates/ts/.secretlintrc.json new file mode 100644 index 0000000..3a6a79a --- /dev/null +++ b/templates/ts/.secretlintrc.json @@ -0,0 +1,3 @@ +{ + "rules": [{ "id": "@secretlint/secretlint-rule-preset-recommend" }] +} diff --git a/templates/ts/eslint.config.mjs b/templates/ts/eslint.config.mjs index f8dcf83..bf68c36 100644 --- a/templates/ts/eslint.config.mjs +++ b/templates/ts/eslint.config.mjs @@ -1,38 +1,50 @@ import js from "@eslint/js"; +import { defineConfig } from "eslint/config"; import tseslint from "typescript-eslint"; -export default tseslint.config( +export default defineConfig( js.configs.recommended, - ...tseslint.configs.strictTypeChecked, - ...tseslint.configs.stylisticTypeChecked, + tseslint.configs.strictTypeChecked, + tseslint.configs.stylisticTypeChecked, { languageOptions: { parserOptions: { projectService: true, - tsconfigRootDir: import.meta.dirname - } + tsconfigRootDir: import.meta.dirname, + }, }, rules: { "@typescript-eslint/consistent-type-imports": "error", "@typescript-eslint/no-floating-promises": "error", "@typescript-eslint/no-misused-promises": "error", - "complexity": ["error", 10], - "max-lines": ["error", { "max": 300, "skipBlankLines": true, "skipComments": true }], - "max-lines-per-function": ["error", { "max": 50, "skipBlankLines": true, "skipComments": true }], + complexity: ["error", 10], + "max-lines": [ + "error", + { max: 300, skipBlankLines: true, skipComments: true }, + ], + "max-lines-per-function": [ + "error", + { max: 50, skipBlankLines: true, skipComments: true }, + ], "no-restricted-imports": [ "error", { - "patterns": [ + patterns: [ { - "group": ["**/internal/**", "**/_*/**"], - "message": "Import through the module's public boundary instead of private internals." - } - ] - } - ] - } + group: ["**/internal/**", "**/_*/**"], + message: + "Import through the module's public boundary instead of private internals.", + }, + ], + }, + ], + }, }, { - ignores: ["dist/**", "build/**", "coverage/**", "node_modules/**"] - } + files: ["**/*.mjs"], + extends: [tseslint.configs.disableTypeChecked], + }, + { + ignores: ["dist/**", "build/**", "coverage/**", "node_modules/**"], + }, ); diff --git a/templates/ts/package.json b/templates/ts/package.json index c97c968..6b0e826 100644 --- a/templates/ts/package.json +++ b/templates/ts/package.json @@ -28,8 +28,6 @@ "@eslint/js": "10.0.1", "@secretlint/secretlint-rule-preset-recommend": "13.0.5", "@types/node": "26.6.2", - "@typescript-eslint/eslint-plugin": "8.70.1", - "@typescript-eslint/parser": "8.70.1", "eslint": "10.11.0", "husky": "9.1.7", "jscpd": "5.3.1", @@ -39,5 +37,10 @@ "secretlint": "13.0.5", "typescript-eslint": "8.70.1", "typescript": "6.0.3" + }, + "knip": { + "ignoreDependencies": [ + "@secretlint/secretlint-rule-preset-recommend" + ] } } diff --git a/templates/ts/secretlint.config.mjs b/templates/ts/secretlint.config.mjs deleted file mode 100644 index f91fdaa..0000000 --- a/templates/ts/secretlint.config.mjs +++ /dev/null @@ -1,7 +0,0 @@ -export default { - rules: [ - { - id: "@secretlint/secretlint-rule-preset-recommend" - } - ] -}; From 8403cb96935427b2946e7a27f3df62a9f1eeb02d Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Thu, 22 Oct 2026 15:05:46 +0200 Subject: [PATCH 06/16] Keep README security notes independent of specific releases Co-Authored-By: Claude Opus 5.5 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a646161..d55f913 100644 --- a/README.md +++ b/README.md @@ -85,7 +85,7 @@ It is inspired by the concept of "Agent Readiness" by Factory.AI: https://factor - `.gitignore` - `pyproject.toml` -Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, and secret scanning because they are fast, easy for agents to run locally. The `uv` config waits 30 days before accepting new package releases and requires uv 0.13.4 or later, which no longer trusts the compromised eMudhra/emSign CA certificates. `certifi` is exempt from the 30-day wait, so CA certificate fixes install immediately. To let another urgent security fix through, add the package to `exclude-newer-package`. +Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, and secret scanning because they are fast, easy for agents to run locally. The `uv` config waits 30 days before accepting new package releases and sets a minimum `uv` version (`required-version`) that blocks releases with known vulnerabilities. Raise it when `uv` publishes a security release. `certifi`, the CA certificate bundle, is exempt from the 30-day wait, so certificate revocations install immediately. To let another urgent security fix through, add the package to `exclude-newer-package`. #### `ts/` @@ -101,4 +101,4 @@ Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, - `.husky/pre-push` - `.husky/_/husky.sh` -Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. All dependencies, and pnpm itself, are pinned to exact versions. Both npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`) wait 30 days before accepting new package releases. To let an urgent security fix through, add the package to `min-release-age-exclude` in `.npmrc` and to `minimumReleaseAgeExclude` in `pnpm-workspace.yaml`. `package.json` requires Node.js 26.12.1 or later, which includes the October 2026 security fixes, and both package managers refuse to install on an older version. +Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. All dependencies, and pnpm itself, are pinned to exact versions. Both npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`) wait 30 days before accepting new package releases. To let an urgent security fix through, add the package to `min-release-age-exclude` in `.npmrc` and to `minimumReleaseAgeExclude` in `pnpm-workspace.yaml`. `package.json` sets a minimum Node.js version (`engines.node`) that blocks releases with known vulnerabilities, and both package managers refuse to install on an older version. Raise it when Node.js publishes a security release. From 9628b5f28081e0d2cfbb93be487a5e8bd3ccb266 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz <32169272+jvdgoltz@users.noreply.github.com> Date: Fri, 23 Oct 2026 11:20:30 +0200 Subject: [PATCH 07/16] Apply batched suggestions from code review Mainly to allow Node 24 Co-authored-by: sannewielinga-kai --- README.md | 2 +- templates/py/pyproject.toml | 4 ++-- templates/ts/package.json | 4 ++-- templates/ts/pnpm-workspace.yaml | 1 + 4 files changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index d55f913..bccced8 100644 --- a/README.md +++ b/README.md @@ -101,4 +101,4 @@ Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, - `.husky/pre-push` - `.husky/_/husky.sh` -Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. All dependencies, and pnpm itself, are pinned to exact versions. Both npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`) wait 30 days before accepting new package releases. To let an urgent security fix through, add the package to `min-release-age-exclude` in `.npmrc` and to `minimumReleaseAgeExclude` in `pnpm-workspace.yaml`. `package.json` sets a minimum Node.js version (`engines.node`) that blocks releases with known vulnerabilities, and both package managers refuse to install on an older version. Raise it when Node.js publishes a security release. +Use this set for TypeScript projects. It uses Husky and lint-staged, while CI can still run the full validation script. ESLint, TypeScript, Knip, jscpd, and secretlint cover linting, strict typing, dead code, duplicate code, and secrets. All direct dependencies, and pnpm itself, are pinned to exact versions. Both npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`) wait 30 days before accepting new package releases. To let an urgent security fix through, add the package to `min-release-age-exclude` in `.npmrc` and to `minimumReleaseAgeExclude` in `pnpm-workspace.yaml`. `package.json` sets a patched minimum version for each supported Node.js line (`engines.node`), and both package managers refuse to install on an older version. Raise these minimums when Node.js publishes a security release. In CI, set `check-latest: true` on `actions/setup-node`, because runner images can lag behind a security release. diff --git a/templates/py/pyproject.toml b/templates/py/pyproject.toml index 0000517..4543ce0 100644 --- a/templates/py/pyproject.toml +++ b/templates/py/pyproject.toml @@ -31,6 +31,6 @@ exclude = [".venv", "venv", "build", "dist"] respect-type-ignore-comments = true [tool.uv] -required-version = ">=0.13.4" +required-version = ">=0.13.5" exclude-newer = "30 days" -exclude-newer-package = { certifi = false } +exclude-newer-package = { certifi = "2 days" } diff --git a/templates/ts/package.json b/templates/ts/package.json index 6b0e826..37780dc 100644 --- a/templates/ts/package.json +++ b/templates/ts/package.json @@ -2,7 +2,7 @@ "$schema": "https://json.schemastore.org/package.json", "packageManager": "pnpm@12.5.1", "engines": { - "node": ">=26.12.1" + "node": "^24.22.1 || >=26.12.1" }, "scripts": { "prepare": "husky", @@ -27,7 +27,7 @@ "devDependencies": { "@eslint/js": "10.0.1", "@secretlint/secretlint-rule-preset-recommend": "13.0.5", - "@types/node": "26.6.2", + "@types/node": "24.13.6", "eslint": "10.11.0", "husky": "9.1.7", "jscpd": "5.3.1", diff --git a/templates/ts/pnpm-workspace.yaml b/templates/ts/pnpm-workspace.yaml index 4dddacf..5ff67a4 100644 --- a/templates/ts/pnpm-workspace.yaml +++ b/templates/ts/pnpm-workspace.yaml @@ -1 +1,2 @@ minimumReleaseAge: 43200 +savePrefix: "" From 53340ccb6aaa2420d9fa4999c21947e338536c7f Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Fri, 23 Oct 2026 11:23:59 +0200 Subject: [PATCH 08/16] Point Dependabot at the repo root and type-check root config files - get-started: after moving the template files, keep only the chosen stack's Dependabot entry and set its directory to /. - TS template: include *.config.ts in tsconfig.json so typed linting works for root config files such as vitest.config.ts. Co-Authored-By: Claude Opus 5.5 --- .agents/skills/get-started/SKILL.md | 1 + templates/ts/tsconfig.json | 8 +++++++- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/.agents/skills/get-started/SKILL.md b/.agents/skills/get-started/SKILL.md index ad84fce..1dd1d73 100644 --- a/.agents/skills/get-started/SKILL.md +++ b/.agents/skills/get-started/SKILL.md @@ -48,6 +48,7 @@ Handle template scaffolding based on the chosen project language: - If the project is **neither Python nor TypeScript**: - Create equivalent starter files for the selected stack in the repo root. - Remove both `templates/py/` and `templates/ts/` so only relevant files remain. +- In `.github/dependabot.yml`, keep only the entry for the chosen stack and set its `directory` to `/`. For other stacks, replace the entries with one for the stack's package ecosystem. Execute the plan. Make sure to keep the developer in the loop and explain what you are doing. Before handoff, validate that the configured repo works: - Run the smallest relevant install/setup command for the chosen stack. diff --git a/templates/ts/tsconfig.json b/templates/ts/tsconfig.json index 5e8de69..2a26b9c 100644 --- a/templates/ts/tsconfig.json +++ b/templates/ts/tsconfig.json @@ -15,6 +15,12 @@ "strict": true, "target": "ES2022" }, - "include": ["src/**/*.ts", "src/**/*.tsx", "tests/**/*.ts", "tests/**/*.tsx"], + "include": [ + "src/**/*.ts", + "src/**/*.tsx", + "tests/**/*.ts", + "tests/**/*.tsx", + "*.config.ts" + ], "exclude": ["node_modules", "dist", "build", "coverage"] } From 44a83fa1ba4f0d78e40380e71b1eacc1bf20d0bd Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Tue, 27 Oct 2026 09:40:35 +0100 Subject: [PATCH 09/16] Add pre-commit workflow, changelog and template versions - Add a GitHub workflow that runs the Python and TypeScript template checks. Actions are pinned to commit SHAs. - Add CHANGELOG.md for 0.1.0 and 0.2.0, and a rule in AGENTS.md to keep it current. - Add version 0.2.0 to the Python and TypeScript templates. - get-started: adapt the workflow to the project, set the project name and reset the version to 0.1.0 with an empty changelog. - Fix missing final newlines and trailing whitespace found by the hooks. --- .agents/skills/get-started/SKILL.md | 4 ++- .github/workflows/pre-commit.yml | 48 +++++++++++++++++++++++++++++ AGENTS.md | 4 ++- CHANGELOG.md | 46 +++++++++++++++++++++++++++ CLAUDE.md | 2 +- templates/py/pyproject.toml | 5 +++ templates/ts/package.json | 2 ++ 7 files changed, 108 insertions(+), 3 deletions(-) create mode 100644 .github/workflows/pre-commit.yml create mode 100644 CHANGELOG.md diff --git a/.agents/skills/get-started/SKILL.md b/.agents/skills/get-started/SKILL.md index 1dd1d73..f838dd9 100644 --- a/.agents/skills/get-started/SKILL.md +++ b/.agents/skills/get-started/SKILL.md @@ -20,7 +20,7 @@ Ask targeted questions interview-style, one question at a time, to find out what - ... (any other question that helps you create an implementation plan and learn about the developer and the project) ## 2. Plan -Make a plan for the execution of the initial project. Be sure to keep the developer involved in writing the plan. +Make a plan for the execution of the initial project. Be sure to keep the developer involved in writing the plan. Present the plan to the developer. Finally, save the plan in `docs/plans/active/YYYY-MM-DD-get-started.md`. Keep open follow-up items in a `## TODOs` section at the bottom of that plan file using markdown checkboxes. @@ -48,6 +48,8 @@ Handle template scaffolding based on the chosen project language: - If the project is **neither Python nor TypeScript**: - Create equivalent starter files for the selected stack in the repo root. - Remove both `templates/py/` and `templates/ts/` so only relevant files remain. +- In `pyproject.toml` or `package.json`, set the project `name` and reset `version` to `0.1.0`. Replace `CHANGELOG.md` with an empty one for the new project. +- In `.github/workflows/pre-commit.yml`, keep only the job for the chosen stack and adapt it to the project: run it from the repo root, remove the template-only steps and settings (the placeholder source file and the `SKIP: deptry` setting), and use `pnpm install --frozen-lockfile` once a lockfile exists. For other stacks, replace the jobs with ones that run the stack's checks. - In `.github/dependabot.yml`, keep only the entry for the chosen stack and set its `directory` to `/`. For other stacks, replace the entries with one for the stack's package ecosystem. Execute the plan. Make sure to keep the developer in the loop and explain what you are doing. Before handoff, validate that the configured repo works: diff --git a/.github/workflows/pre-commit.yml b/.github/workflows/pre-commit.yml new file mode 100644 index 0000000..4fc6269 --- /dev/null +++ b/.github/workflows/pre-commit.yml @@ -0,0 +1,48 @@ +name: pre-commit + +on: + pull_request: + push: + branches: [main] + +permissions: + contents: read + +jobs: + python: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + persist-credentials: false + - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0 + with: + working-directory: templates/py + # deptry needs a [project] section, which only exists after get-started. + - run: uvx pre-commit@4.6.2 run --all-files --show-diff-on-failure --config templates/py/.pre-commit-config.yaml + env: + SKIP: deptry + + typescript: + runs-on: ubuntu-latest + defaults: + run: + working-directory: templates/ts + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + persist-credentials: false + - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0 + with: + package_json_file: templates/ts/package.json + - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0 + with: + node-version: 26 + check-latest: true + - run: pnpm install + # The template has no source files; add one so tsc and knip have input. + - run: | + mkdir -p src + printf '/** Add two numbers. */\nexport function add(a: number, b: number): number {\n return a + b;\n}\n' > src/index.ts + - run: pnpm validate + - run: pnpm format:check diff --git a/AGENTS.md b/AGENTS.md index 1ea8478..6ae4daf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -48,6 +48,8 @@ ## Documentation & Memory - Avoid overdocumenting (e.g. README.md in every folder, excessive comments in the code). +- Keep `CHANGELOG.md` up to date. Record each user-visible change under the next version, in the same change that makes it. + When you release a version, update the version in `pyproject.toml` or `package.json` to match. - Keep session-spanning plans in state-specific folders: - `docs/plans/active/YYYY-MM-DD-{plan-name}.md` for plans currently being worked - `docs/plans/pending/YYYY-MM-DD-{plan-name}.md` for approved plans that are not currently active @@ -59,4 +61,4 @@ - [ ] pending todo - [x] todo completed - Do not remove completed TODOs from plan files; keep them for historical context. -- When searching through plans and decisions and past todos, use targeted keyword search rather than loading all the files into context. \ No newline at end of file +- When searching through plans and decisions and past todos, use targeted keyword search rather than loading all the files into context. diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..4e0cffd --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,46 @@ +# Changelog + +All notable changes to this project are recorded in this file. +The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses [Semantic Versioning](https://semver.org/). + +## [0.2.0] - Unreleased + +Pull request: [#8](https://github.com/Kickstart-AI/agent-ready-template/pull/8) + +### Added +- A GitHub workflow (`.github/workflows/pre-commit.yml`) that runs the Python and TypeScript template checks. +- A version in `templates/py/pyproject.toml` and `templates/ts/package.json`, and this changelog. +- A 30-day release delay for npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`). This matches the `uv` delay. +- Minimum versions for Node.js (`engines.node`) and `uv` (`required-version`) that block releases with known vulnerabilities. +- An exemption from the `uv` release delay for `certifi`, so that certificate revocations install quickly. +- `get-started` steps that adapt the workflow, the Dependabot configuration, and the version to the new project. + +### Changed +- The TypeScript template pins all direct dependencies and pnpm to exact versions. +- The TypeScript template uses the newest major versions of its tools that are at least 30 days old. +- The ESLint configuration uses `defineConfig` and does not use type-aware rules on `.mjs` files. +- `tsconfig.json` includes root `*.config.ts` files, so typed linting works for them. +- The Python template uses `pre-commit-hooks` v6.0.0. + +### Fixed +- secretlint did not find its configuration. It now uses `.secretlintrc.json`. +- Knip, ESLint, and Prettier failed on a new TypeScript project. +- Missing final newlines and trailing whitespace in the agent instruction files. + +### Removed +- The redundant `@typescript-eslint/parser` and `@typescript-eslint/eslint-plugin` packages. `typescript-eslint` supplies them. + +## [0.1.0] - 2026-05-22 + +### Added +- Agent instructions (`AGENTS.md`, `CLAUDE.md`) with coding, security, communication, and documentation rules. +- The `get-started` and `wrap-up` agent skills. +- A documentation structure for plans, decisions, and TODOs. +- Python and TypeScript starter templates with linting, type checks, dead-code and duplicate-code detection, and secret scanning. +- A Dependabot configuration for the template dependencies, with a 30-day cooldown and grouped updates. + +### Changed +- Dependency updates from Dependabot ([#6](https://github.com/Kickstart-AI/agent-ready-template/pull/6)). + +[0.2.0]: https://github.com/Kickstart-AI/agent-ready-template/pull/8 +[0.1.0]: https://github.com/Kickstart-AI/agent-ready-template/commits/main diff --git a/CLAUDE.md b/CLAUDE.md index eef4bd2..43c994c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1 +1 @@ -@AGENTS.md \ No newline at end of file +@AGENTS.md diff --git a/templates/py/pyproject.toml b/templates/py/pyproject.toml index 4543ce0..7d022a6 100644 --- a/templates/py/pyproject.toml +++ b/templates/py/pyproject.toml @@ -1,3 +1,8 @@ +[project] +name = "agent-ready-template" +version = "0.2.0" +requires-python = ">=3.11" + [tool.ruff] line-length = 100 target-version = "py311" diff --git a/templates/ts/package.json b/templates/ts/package.json index 37780dc..c6ccdbc 100644 --- a/templates/ts/package.json +++ b/templates/ts/package.json @@ -1,5 +1,7 @@ { "$schema": "https://json.schemastore.org/package.json", + "name": "agent-ready-template", + "version": "0.2.0", "packageManager": "pnpm@12.5.1", "engines": { "node": "^24.22.1 || >=26.12.1" From 613cf013594fd3e1b92208259766a918c34df174 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Tue, 27 Oct 2026 09:41:05 +0100 Subject: [PATCH 10/16] Rename workflow to validate and add the required validate check Branch protection requires a check named validate. Add a validate job that fails when the python or typescript job fails, is cancelled or is skipped. --- .agents/skills/get-started/SKILL.md | 2 +- .github/workflows/{pre-commit.yml => validate.yml} | 11 ++++++++++- CHANGELOG.md | 2 +- 3 files changed, 12 insertions(+), 3 deletions(-) rename .github/workflows/{pre-commit.yml => validate.yml} (82%) diff --git a/.agents/skills/get-started/SKILL.md b/.agents/skills/get-started/SKILL.md index f838dd9..f7612c9 100644 --- a/.agents/skills/get-started/SKILL.md +++ b/.agents/skills/get-started/SKILL.md @@ -49,7 +49,7 @@ Handle template scaffolding based on the chosen project language: - Create equivalent starter files for the selected stack in the repo root. - Remove both `templates/py/` and `templates/ts/` so only relevant files remain. - In `pyproject.toml` or `package.json`, set the project `name` and reset `version` to `0.1.0`. Replace `CHANGELOG.md` with an empty one for the new project. -- In `.github/workflows/pre-commit.yml`, keep only the job for the chosen stack and adapt it to the project: run it from the repo root, remove the template-only steps and settings (the placeholder source file and the `SKIP: deptry` setting), and use `pnpm install --frozen-lockfile` once a lockfile exists. For other stacks, replace the jobs with ones that run the stack's checks. +- In `.github/workflows/validate.yml`, keep only the job for the chosen stack and the `validate` job, update the `needs` list of `validate`, and adapt the stack job to the project: run it from the repo root, remove the template-only steps and settings (the placeholder source file and the `SKIP: deptry` setting), and use `pnpm install --frozen-lockfile` once a lockfile exists. For other stacks, replace the jobs with ones that run the stack's checks. - In `.github/dependabot.yml`, keep only the entry for the chosen stack and set its `directory` to `/`. For other stacks, replace the entries with one for the stack's package ecosystem. Execute the plan. Make sure to keep the developer in the loop and explain what you are doing. Before handoff, validate that the configured repo works: diff --git a/.github/workflows/pre-commit.yml b/.github/workflows/validate.yml similarity index 82% rename from .github/workflows/pre-commit.yml rename to .github/workflows/validate.yml index 4fc6269..7ed8350 100644 --- a/.github/workflows/pre-commit.yml +++ b/.github/workflows/validate.yml @@ -1,4 +1,4 @@ -name: pre-commit +name: validate on: pull_request: @@ -46,3 +46,12 @@ jobs: printf '/** Add two numbers. */\nexport function add(a: number, b: number): number {\n return a + b;\n}\n' > src/index.ts - run: pnpm validate - run: pnpm format:check + + # Single required status check for branch protection. + validate: + needs: [python, typescript] + if: always() + runs-on: ubuntu-latest + steps: + - if: contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled') || contains(needs.*.result, 'skipped') + run: exit 1 diff --git a/CHANGELOG.md b/CHANGELOG.md index 4e0cffd..9c2b556 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,7 +8,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and Pull request: [#8](https://github.com/Kickstart-AI/agent-ready-template/pull/8) ### Added -- A GitHub workflow (`.github/workflows/pre-commit.yml`) that runs the Python and TypeScript template checks. +- A GitHub workflow (`.github/workflows/validate.yml`) that runs the Python and TypeScript template checks. - A version in `templates/py/pyproject.toml` and `templates/ts/package.json`, and this changelog. - A 30-day release delay for npm (`.npmrc`) and pnpm (`pnpm-workspace.yaml`). This matches the `uv` delay. - Minimum versions for Node.js (`engines.node`) and `uv` (`required-version`) that block releases with known vulnerabilities. From df9814e3ee06c15a18fbc73999e41d795640a2e4 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Tue, 27 Oct 2026 09:45:08 +0100 Subject: [PATCH 11/16] Remove the validate gate job The protect-main ruleset now requires the python and typescript checks directly. --- .agents/skills/get-started/SKILL.md | 2 +- .github/workflows/validate.yml | 9 --------- 2 files changed, 1 insertion(+), 10 deletions(-) diff --git a/.agents/skills/get-started/SKILL.md b/.agents/skills/get-started/SKILL.md index f7612c9..1b52858 100644 --- a/.agents/skills/get-started/SKILL.md +++ b/.agents/skills/get-started/SKILL.md @@ -49,7 +49,7 @@ Handle template scaffolding based on the chosen project language: - Create equivalent starter files for the selected stack in the repo root. - Remove both `templates/py/` and `templates/ts/` so only relevant files remain. - In `pyproject.toml` or `package.json`, set the project `name` and reset `version` to `0.1.0`. Replace `CHANGELOG.md` with an empty one for the new project. -- In `.github/workflows/validate.yml`, keep only the job for the chosen stack and the `validate` job, update the `needs` list of `validate`, and adapt the stack job to the project: run it from the repo root, remove the template-only steps and settings (the placeholder source file and the `SKIP: deptry` setting), and use `pnpm install --frozen-lockfile` once a lockfile exists. For other stacks, replace the jobs with ones that run the stack's checks. +- In `.github/workflows/validate.yml`, keep only the job for the chosen stack and adapt it to the project: run it from the repo root, remove the template-only steps and settings (the placeholder source file and the `SKIP: deptry` setting), and use `pnpm install --frozen-lockfile` once a lockfile exists. For other stacks, replace the jobs with ones that run the stack's checks. - In `.github/dependabot.yml`, keep only the entry for the chosen stack and set its `directory` to `/`. For other stacks, replace the entries with one for the stack's package ecosystem. Execute the plan. Make sure to keep the developer in the loop and explain what you are doing. Before handoff, validate that the configured repo works: diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml index 7ed8350..114ac51 100644 --- a/.github/workflows/validate.yml +++ b/.github/workflows/validate.yml @@ -46,12 +46,3 @@ jobs: printf '/** Add two numbers. */\nexport function add(a: number, b: number): number {\n return a + b;\n}\n' > src/index.ts - run: pnpm validate - run: pnpm format:check - - # Single required status check for branch protection. - validate: - needs: [python, typescript] - if: always() - runs-on: ubuntu-latest - steps: - - if: contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled') || contains(needs.*.result, 'skipped') - run: exit 1 From 28b4a133e97f3e88a7efb3c71365778f70bdf8a2 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Tue, 27 Oct 2026 09:46:31 +0100 Subject: [PATCH 12/16] Date the 0.2.0 changelog entry and link the security disclosures --- CHANGELOG.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9c2b556..c022678 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,10 +3,17 @@ All notable changes to this project are recorded in this file. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses [Semantic Versioning](https://semver.org/). -## [0.2.0] - Unreleased +## [0.2.0] - 2026-10-27 Pull request: [#8](https://github.com/Kickstart-AI/agent-ready-template/pull/8) +This release protects the templates against recent vulnerabilities and supply-chain attacks. It blocks tool versions with known vulnerabilities, delays new package releases, and pins all dependencies. + +### Security +- Require patched Node.js versions. See the [Node.js October 2026 security releases](https://nodejs.org/en/blog/vulnerability/october-2026-security-releases). +- Require a `uv` version that does not trust the compromised eMudhra/emSign CA certificates. See the [Python announcement on the eMudhra/emSign CA certificate incident](https://discuss.python.org/t/information-for-python-users-regarding-emudhra-emsign-ca-certificate-security-incident/109576). +- Remove the `braces` vulnerability ([GHSA-vfj7-8cjw-p6xm](https://github.com/advisories/GHSA-vfj7-8cjw-p6xm)) from the TypeScript template tools. + ### Added - A GitHub workflow (`.github/workflows/validate.yml`) that runs the Python and TypeScript template checks. - A version in `templates/py/pyproject.toml` and `templates/ts/package.json`, and this changelog. From 9115412a03fba980a711cd73a775424d841c8195 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Tue, 27 Oct 2026 10:02:54 +0100 Subject: [PATCH 13/16] Exempt patched zod and fast-uri from the release delay npm audit reported GHSA-mrhx-c7xc-m3w5 (zod, via knip) and GHSA-w74x-v6f9-j3xg (fast-uri, via ajv). The fixed versions are newer than 30 days. pnpm exempts the exact fixed versions; npm only supports package names. AGENTS.md now says to remove such exemptions once the fixed version is older than the delay. --- AGENTS.md | 2 ++ CHANGELOG.md | 1 + templates/ts/.npmrc | 2 ++ templates/ts/pnpm-workspace.yaml | 3 +++ 4 files changed, 8 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 6ae4daf..51898ad 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -19,6 +19,8 @@ - When installing or updating dependencies, verify before installation that the selected version has no known supply-chain compromise reports or critical CVEs. - Always pin dependencies to exact versions in manifests or lockfiles instead of using floating version ranges. +- Only exempt a package from the release-age delay (`exclude-newer-package`, `min-release-age-exclude`, `minimumReleaseAgeExclude`) + to install a security fix. Remove the exemption once the fixed version is older than the delay. - Do not install anything known or suspected to be a security risk. - Never hardcode secrets, API keys, passwords, or tokens in code. Use environment variables or secure vault services. - Do not log or expose sensitive information like credentials, PII, or authentication tokens. diff --git a/CHANGELOG.md b/CHANGELOG.md index c022678..ad37d61 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,7 @@ This release protects the templates against recent vulnerabilities and supply-ch ### Security - Require patched Node.js versions. See the [Node.js October 2026 security releases](https://nodejs.org/en/blog/vulnerability/october-2026-security-releases). - Require a `uv` version that does not trust the compromised eMudhra/emSign CA certificates. See the [Python announcement on the eMudhra/emSign CA certificate incident](https://discuss.python.org/t/information-for-python-users-regarding-emudhra-emsign-ca-certificate-security-incident/109576). +- Exempt the patched `zod` 4.6.6 ([GHSA-mrhx-c7xc-m3w5](https://github.com/advisories/GHSA-mrhx-c7xc-m3w5)) and `fast-uri` 3.1.9 ([GHSA-w74x-v6f9-j3xg](https://github.com/advisories/GHSA-w74x-v6f9-j3xg)) from the 30-day release delay in the TypeScript template. - Remove the `braces` vulnerability ([GHSA-vfj7-8cjw-p6xm](https://github.com/advisories/GHSA-vfj7-8cjw-p6xm)) from the TypeScript template tools. ### Added diff --git a/templates/ts/.npmrc b/templates/ts/.npmrc index 2abba24..55e21a3 100644 --- a/templates/ts/.npmrc +++ b/templates/ts/.npmrc @@ -1,2 +1,4 @@ engine-strict=true min-release-age=30 +min-release-age-exclude[]=zod +min-release-age-exclude[]=fast-uri diff --git a/templates/ts/pnpm-workspace.yaml b/templates/ts/pnpm-workspace.yaml index 5ff67a4..6c61949 100644 --- a/templates/ts/pnpm-workspace.yaml +++ b/templates/ts/pnpm-workspace.yaml @@ -1,2 +1,5 @@ minimumReleaseAge: 43200 savePrefix: "" +minimumReleaseAgeExclude: + - zod@4.6.6 + - fast-uri@3.1.9 From 99e9a61e4bb534f430fe8f1ccc90dd06fa261bf4 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Tue, 27 Oct 2026 10:10:08 +0100 Subject: [PATCH 14/16] Check release-age exemptions at the start of a session --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/AGENTS.md b/AGENTS.md index 51898ad..05da0a2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -34,6 +34,7 @@ ## Approach - Check `docs/` for plans and their embedded TODO sections that are relevant to the current session. +- At the start of a session, check the release-age exemptions. If an exempted fixed version is now older than the delay, remove the exemption. - Do not rely on your internal knowledge about APIs, libraries, and tools. Assume that it might be outdated. Use web search and web fetch to retrieve relevant documentation. - Implement the basic happy path of any functionality or feature first. Only after confirmation from the user, implement the edge cases. - Only implement features and functionality that the user asked for. From 35a62e29d499d2e2c3b07a4e6ee5e75af679a472 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Tue, 27 Oct 2026 10:14:19 +0100 Subject: [PATCH 15/16] Mark the certifi delay as permanent certifi releases are trust-store fixes, so the short delay stays. The AGENTS.md rules now apply only to temporary exemptions. --- AGENTS.md | 5 +++-- templates/py/pyproject.toml | 1 + 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 05da0a2..22317c1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -20,7 +20,8 @@ supply-chain compromise reports or critical CVEs. - Always pin dependencies to exact versions in manifests or lockfiles instead of using floating version ranges. - Only exempt a package from the release-age delay (`exclude-newer-package`, `min-release-age-exclude`, `minimumReleaseAgeExclude`) - to install a security fix. Remove the exemption once the fixed version is older than the delay. + to install a security fix. Remove the exemption once the fixed version is older than the delay. Permanent settings + that have a comment saying so (for example the `certifi` delay in `pyproject.toml`) stay. - Do not install anything known or suspected to be a security risk. - Never hardcode secrets, API keys, passwords, or tokens in code. Use environment variables or secure vault services. - Do not log or expose sensitive information like credentials, PII, or authentication tokens. @@ -34,7 +35,7 @@ ## Approach - Check `docs/` for plans and their embedded TODO sections that are relevant to the current session. -- At the start of a session, check the release-age exemptions. If an exempted fixed version is now older than the delay, remove the exemption. +- At the start of a session, check the temporary release-age exemptions. If an exempted fixed version is now older than the delay, remove the exemption. - Do not rely on your internal knowledge about APIs, libraries, and tools. Assume that it might be outdated. Use web search and web fetch to retrieve relevant documentation. - Implement the basic happy path of any functionality or feature first. Only after confirmation from the user, implement the edge cases. - Only implement features and functionality that the user asked for. diff --git a/templates/py/pyproject.toml b/templates/py/pyproject.toml index 7d022a6..7b06a3a 100644 --- a/templates/py/pyproject.toml +++ b/templates/py/pyproject.toml @@ -38,4 +38,5 @@ respect-type-ignore-comments = true [tool.uv] required-version = ">=0.13.5" exclude-newer = "30 days" +# certifi releases are trust-store fixes. Keep this short delay permanently. exclude-newer-package = { certifi = "2 days" } From af2c70cdec589b07993c33a67ae1a2f97fec01d3 Mon Sep 17 00:00:00 2001 From: Julian von der Goltz Date: Tue, 27 Oct 2026 10:43:00 +0100 Subject: [PATCH 16/16] Correct the README description of the certifi delay --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bccced8..8eb6f65 100644 --- a/README.md +++ b/README.md @@ -85,7 +85,7 @@ It is inspired by the concept of "Agent Readiness" by Factory.AI: https://factor - `.gitignore` - `pyproject.toml` -Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, and secret scanning because they are fast, easy for agents to run locally. The `uv` config waits 30 days before accepting new package releases and sets a minimum `uv` version (`required-version`) that blocks releases with known vulnerabilities. Raise it when `uv` publishes a security release. `certifi`, the CA certificate bundle, is exempt from the 30-day wait, so certificate revocations install immediately. To let another urgent security fix through, add the package to `exclude-newer-package`. +Use this set for Python projects. It uses `uv`, `ruff`, `ty`, pre-commit checks, and secret scanning because they are fast, easy for agents to run locally. The `uv` config waits 30 days before accepting new package releases and sets a minimum `uv` version (`required-version`) that blocks releases with known vulnerabilities. Raise it when `uv` publishes a security release. `certifi`, the CA certificate bundle, has a short permanent delay of 2 days instead, so certificate revocations install quickly. To let another urgent security fix through, add the package to `exclude-newer-package`. #### `ts/`