From 40db2d88d0f48a830692ecab74a8c0fd372c2c95 Mon Sep 17 00:00:00 2001 From: saagpatel <269905221+saagpatel@users.noreply.github.com> Date: Tue, 17 Nov 2026 21:39:15 -0800 Subject: [PATCH 1/3] docs(readme): state uv 0.13.0 pin, supported Python range and test command --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index fa1751e6..81eb1138 100644 --- a/README.md +++ b/README.md @@ -176,7 +176,9 @@ demo, benchmark, and direct exporter calls require an explicit overlay argument. ### Prerequisites -- Python 3.12+ +- Python 3.12 to 3.14 (3.15 is not supported yet; pick a supported interpreter, for example `uv python install 3.13`) +- [uv](https://docs.astral.sh/uv/) exactly 0.13.0 for the `make` targets (`make setup`, `make demo`, `make check`). `pyproject.toml` pins `required-version = "==0.13.0"`, so any other uv fails with a version mismatch. Switch with `uv self update 0.13.0`, or install it fresh with `curl -LsSf https://astral.sh/uv/0.13.0/install.sh | sh`. The plain `pip install` paths below do not need uv. +- pnpm and Node (versions pinned in `web/`) for `make setup` and `make check` - A GitHub account (public repos work without a token) - `GITHUB_TOKEN` env var or `gh` CLI authenticated (for private repos and higher rate limits) @@ -233,7 +235,7 @@ output is private operator evidence unless it has been intentionally sanitized. ```bash git clone https://github.com/saagpatel/GithubRepoAuditor.git cd GithubRepoAuditor -pip install -e ".[config]" +uv sync --locked --extra config # requires uv 0.13.0, see Prerequisites make demo ``` @@ -364,7 +366,7 @@ frontend uses Next.js 15 and React 19 with pinned Node and pnpm toolchains. JSON, Markdown, HTML, workbooks, and Notion payloads share the audit model. The canonical local portfolio truth path is `output/portfolio-truth-latest.json`. -For a contributor checkout, run `make setup` and then `make check`. These use +For a contributor checkout, install uv 0.13.0 (see Prerequisites), run `make setup`, then `make check` (this is the test command; Python tests alone: `make check-python`). These use locked dependencies and offline fixtures; semantic-index checks are a separate opt-in lane. See [CONTRIBUTING.md](CONTRIBUTING.md) for focused checks. From 1e948565d9bfe1bb1bcd9bda0eb402f8496ae437 Mon Sep 17 00:00:00 2001 From: saagpatel <269905221+saagpatel@users.noreply.github.com> Date: Tue, 17 Nov 2026 22:46:20 -0800 Subject: [PATCH 2/3] docs(readme): document clone-local uv 0.13.0 install and ignore .uv-tool --- .gitignore | 3 +++ README.md | 10 ++++++++++ 2 files changed, 13 insertions(+) diff --git a/.gitignore b/.gitignore index 25e3f20a..c36bfa88 100644 --- a/.gitignore +++ b/.gitignore @@ -54,3 +54,6 @@ build/ # pytest coverage artifact .coverage + +# Clone-local uv toolchain (see README Prerequisites) +.uv-tool/ diff --git a/README.md b/README.md index 81eb1138..9d10696d 100644 --- a/README.md +++ b/README.md @@ -178,6 +178,16 @@ demo, benchmark, and direct exporter calls require an explicit overlay argument. - Python 3.12 to 3.14 (3.15 is not supported yet; pick a supported interpreter, for example `uv python install 3.13`) - [uv](https://docs.astral.sh/uv/) exactly 0.13.0 for the `make` targets (`make setup`, `make demo`, `make check`). `pyproject.toml` pins `required-version = "==0.13.0"`, so any other uv fails with a version mismatch. Switch with `uv self update 0.13.0`, or install it fresh with `curl -LsSf https://astral.sh/uv/0.13.0/install.sh | sh`. The plain `pip install` paths below do not need uv. + + If you would rather not change your global uv, install 0.13.0 inside the clone (nothing is written outside it) and put it first on `PATH` for the session: + + ```bash + python3 -m venv .uv-tool && .uv-tool/bin/pip install uv==0.13.0 + export PATH="$PWD/.uv-tool/bin:$PATH" + uv --version # uv 0.13.0 + ``` + + `.uv-tool/` is gitignored. The venv only hosts the uv binary; uv picks its own supported project interpreter (see the Python range above). - pnpm and Node (versions pinned in `web/`) for `make setup` and `make check` - A GitHub account (public repos work without a token) - `GITHUB_TOKEN` env var or `gh` CLI authenticated (for private repos and higher rate limits) From 46b16dfc7ea841f217041d114a64556ddd5bd8aa Mon Sep 17 00:00:00 2001 From: saagpatel <269905221+saagpatel@users.noreply.github.com> Date: Tue, 17 Nov 2026 22:58:38 -0800 Subject: [PATCH 3/3] fix(web): bump next and eslint-config-next to 16.4.6 to clear security advisory --- web/package.json | 4 +- web/pnpm-lock.yaml | 107 +++++++++++++++++++++------------------------ 2 files changed, 53 insertions(+), 58 deletions(-) diff --git a/web/package.json b/web/package.json index 67e6806a..e9ea6077 100644 --- a/web/package.json +++ b/web/package.json @@ -12,7 +12,7 @@ "test": "node --experimental-strip-types --test tests/*.test.mjs" }, "dependencies": { - "next": "^16.4.3", + "next": "^16.4.6", "react": "^19.3.1", "react-dom": "^19.3.1" }, @@ -21,7 +21,7 @@ "@types/react": "^19.3.0", "@types/react-dom": "^19.3.0", "eslint": "9.39.5", - "eslint-config-next": "16.4.3", + "eslint-config-next": "16.4.6", "typescript": "^6.0.3" } } diff --git a/web/pnpm-lock.yaml b/web/pnpm-lock.yaml index c59f5525..e16a5805 100644 --- a/web/pnpm-lock.yaml +++ b/web/pnpm-lock.yaml @@ -173,8 +173,8 @@ importers: .: dependencies: next: - specifier: ^16.4.3 - version: 16.4.3(@babel/core@7.29.7(supports-color@7.2.0))(@types/node@26.6.6)(react-dom@19.3.1(react@19.3.1))(react@19.3.1) + specifier: ^16.4.6 + version: 16.4.6(@babel/core@7.29.7(supports-color@7.2.0))(@types/node@26.6.6)(react-dom@19.3.1(react@19.3.1))(react@19.3.1) react: specifier: ^19.3.1 version: 19.3.1 @@ -195,8 +195,8 @@ importers: specifier: 9.39.5 version: 9.39.5(supports-color@7.2.0) eslint-config-next: - specifier: 16.4.3 - version: 16.4.3(@typescript-eslint/parser@8.72.1(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0)(typescript@6.0.3))(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0)(typescript@6.0.3) + specifier: 16.4.6 + version: 16.4.6(@typescript-eslint/parser@8.72.1(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0)(typescript@6.0.3))(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0)(typescript@6.0.3) typescript: specifier: ^6.0.3 version: 6.0.3 @@ -534,60 +534,60 @@ packages: '@emnapi/core': ^1.7.1 || ^2.0.0-alpha.4 '@emnapi/runtime': ^1.7.1 || ^2.0.0-alpha.4 - '@next/env@16.4.3': - resolution: {integrity: sha512-a7tz1QCcWWkwC/rPJcPMJk/UNRu9CFhDd3OHYE5hddbJrs8BqRTalxI6GlKCWEGzRLHN+S/B7a4PAHCtm25aBQ==} + '@next/env@16.4.6': + resolution: {integrity: sha512-SunBjJ6t+oBtecS3dTjdVuMhUogP5wD/vrGL5EVuQYM1iS4O5ilL51HkiJ3sPjMzRHiCChvr4dbaSJbR7F3lxA==} - '@next/eslint-plugin-next@16.4.3': - resolution: {integrity: sha512-oxuC06wt/71h6ACYCV9GbKOfnf5a7VlRe/p80YHTut15TNgDEmynDnaq8t/xhy5rlvk7dhItIPs6H3rvIM4kyw==} + '@next/eslint-plugin-next@16.4.6': + resolution: {integrity: sha512-HdqERVOafOD8JaUSAkwf9aSu/1rsHlkN8C5GcXYBH3C/z1MxBhZFxB5rz/xqMMRiIj7r9tIv8OCLQ9JWUxCvWA==} - '@next/swc-darwin-arm64@16.4.3': - resolution: {integrity: sha512-4yq5EXBt+VDtAZwTyfijaFp5D2C5oz3Ikw5a2kiX2K9nw72vrZX2q5UuAlkPtUMO1tQz6JTKpaKWjS7OOefTDQ==} + '@next/swc-darwin-arm64@16.4.6': + resolution: {integrity: sha512-kJ4VVZkley17xKaJx72QN2IBqjrj7zenCQZaUF0l9ShS/1Mt2kW4+Z5KGG6vgr3L/J562xTOizVyM1iA/u5nlg==} engines: {node: '>= 10'} cpu: [arm64] os: [darwin] - '@next/swc-darwin-x64@16.4.3': - resolution: {integrity: sha512-1Rvkn/LUhnEF8WxnRkOrqGhbwXui1bkWFxONKIbN+r7C+9KHDSZ+iUoj4CzymVMWUyZIyx9szcb9+kbKhD500A==} + '@next/swc-darwin-x64@16.4.6': + resolution: {integrity: sha512-eIPGZIqC+8JKaeZmvnCANJQF4xWkkHqSnAAajtFxgwDMAOnCgxNvP52SeWZ41PyVwoe+Le/NQuZSaQ8j7YshSA==} engines: {node: '>= 10'} cpu: [x64] os: [darwin] - '@next/swc-linux-arm64-gnu@16.4.3': - resolution: {integrity: sha512-dCKpXErGg3abUM6t5JTJV/ottVBTStJB5lRJTbgdUdQaQ+jNHiK56Hsc0YAEg/rinSh42hYG3HWiYmEMdilnxg==} + '@next/swc-linux-arm64-gnu@16.4.6': + resolution: {integrity: sha512-9nI6O8vvczH2D9ZNdMGqb/3NuT15T9ksOZnAmx9/gjF2cOi74+xxyf1Hk96uIMfm14c9y6wHeBq6SH8g6udvcA==} engines: {node: '>= 10'} cpu: [arm64] os: [linux] libc: [glibc] - '@next/swc-linux-arm64-musl@16.4.3': - resolution: {integrity: sha512-WwYbhWkhYBvBtib1K4W0kL8MW2snBD2A5b3SN4vPpqalZbZs5+bQ1yzAdepVoOqrFfEW3dmREy4Zs1MrWcrFbw==} + '@next/swc-linux-arm64-musl@16.4.6': + resolution: {integrity: sha512-7/qPhTxDp2ScluOJOhLuhWmlA17o1yZ0SIgpISBCpBxXgtnK4+KGywBpFkfLPiU1rnSM1faFGzYkH6i7JdTrqA==} engines: {node: '>= 10'} cpu: [arm64] os: [linux] libc: [musl] - '@next/swc-linux-x64-gnu@16.4.3': - resolution: {integrity: sha512-QymWvfUwDEC5/lpJOsxX5VAbyoR2D13+2Jsjz4be7gT4LPqEgdpkeLIR/HFfCLgKzoMhpJbp6I/JnogyNZHcaA==} + '@next/swc-linux-x64-gnu@16.4.6': + resolution: {integrity: sha512-oOpbNa8XOW1qCGd9VvzC4fbkkRxEls7/WI6tz+YHC0xRA7KpV1U7DrAnCPjzVyOk/karzWEepCOcTIDmwK8FwQ==} engines: {node: '>= 10'} cpu: [x64] os: [linux] libc: [glibc] - '@next/swc-linux-x64-musl@16.4.3': - resolution: {integrity: sha512-Vmjd9D7DpA4Vv3cUlr82QWgJD/BQZmns801vtC5VWHg6jCIA4a5vMKpQnfrM2pyCrp2eV0ENdUg4PlN3bAc2Yw==} + '@next/swc-linux-x64-musl@16.4.6': + resolution: {integrity: sha512-aM8CZ+OR2EwXaAYw7KGkW2GDmNDsLBIRe1MMRZCJPTdw/xhTD0IMUVO4sf3KqrzuRouGzwwLZn34+gFeVXiUQA==} engines: {node: '>= 10'} cpu: [x64] os: [linux] libc: [musl] - '@next/swc-win32-arm64-msvc@16.4.3': - resolution: {integrity: sha512-lG1pPdPLk7gTyGb00n5JIMLdBJgjb+UEhSdZvFbhUMg0DyC6z4B7RnpSKF9VCd4imkLObVbXOFA0kFCpw7yFow==} + '@next/swc-win32-arm64-msvc@16.4.6': + resolution: {integrity: sha512-U0p7/tEtqvHX2crhd841CDwKtp5CFkKXVjOhmfccR3Pvp64sj8KBwRqsvltqLOwVBbj0NtkxwXSDpEHYGbxeXQ==} engines: {node: '>= 10'} cpu: [arm64] os: [win32] - '@next/swc-win32-x64-msvc@16.4.3': - resolution: {integrity: sha512-NmQC9RkJdnPXRaMxtkCzobB3teVjqF33oSOnwDfi+XYGWWYpt+xlGK3mtktSKLbdjwaWbJu2OkkMiRFGUUncKg==} + '@next/swc-win32-x64-msvc@16.4.6': + resolution: {integrity: sha512-3ZG15/5WIdlTQsIEvc9sPTTSL5XFrlLklIKmfF4fwsDnoAhu6NcBDXsk3mbGxNyo6aVLEGex+fHCv2MahY7a9g==} engines: {node: '>= 10'} cpu: [x64] os: [win32] @@ -935,9 +935,6 @@ packages: resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==} engines: {node: '>=6'} - caniuse-lite@1.0.30001810: - resolution: {integrity: sha512-TITQPUkaz+aVk5GL6NhOdwk1aEaNTSDPsGFWrTuhKGtjTF70jL/Oht2W4c6rXUe5fu7Ie19VIahAXHIIiWWNeg==} - caniuse-lite@1.0.30001820: resolution: {integrity: sha512-gfWD6MxqVCqAOwmODfZf7DchWvlrA+SRdNX7ceLfg3xRqe5ssjjpF7EgslC/0tiLiNTajdaNN/q8c/5u/7Gz8w==} @@ -1073,8 +1070,8 @@ packages: resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==} engines: {node: '>=10'} - eslint-config-next@16.4.3: - resolution: {integrity: sha512-j9IqBma6abp800frdUURaizYMgXOK+jNGyq6CsYcM9AxpSJs5D/TgMNGeAmRUilZvA7g9V1Tr71gNg9/SVTuMQ==} + eslint-config-next@16.4.6: + resolution: {integrity: sha512-IBGGrVf9E6pL0NGL0hmeicVGeSyv1VEzIWq6IecDqkw+YFByhEtDJS9u1r6s6a1VxK6rssh69KyNFQUgfaacqw==} peerDependencies: eslint: '>=9.0.0' typescript: '>=3.3.1' @@ -1569,8 +1566,8 @@ packages: natural-compare@1.4.0: resolution: {integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==} - next@16.4.3: - resolution: {integrity: sha512-OqxKTGi9u80FydydsMNYNjnuje9Au+kvHlt2GZ//ftdpDHm1dxKqAaENoOOTX5wKzn+9vaKUNIfZeyZUuLhCnA==} + next@16.4.6: + resolution: {integrity: sha512-QZJiYhaZLJMo2KpkQGQIwvmd79WVsAWeYIU554a8d7zArS3si/IRy3lBNV/rtYhE70oLwdLYhPAXLPx8HwcwtA==} engines: {node: '>=20.9.0'} hasBin: true peerDependencies: @@ -2302,37 +2299,37 @@ snapshots: '@tybys/wasm-util': 0.10.4 optional: true - '@next/env@16.4.3': {} + '@next/env@16.4.6': {} - '@next/eslint-plugin-next@16.4.3(eslint@9.39.5(supports-color@7.2.0))': + '@next/eslint-plugin-next@16.4.6(eslint@9.39.5(supports-color@7.2.0))': dependencies: '@eslint-community/eslint-utils': 4.9.1(eslint@9.39.5(supports-color@7.2.0)) fast-glob: 3.3.1 transitivePeerDependencies: - eslint - '@next/swc-darwin-arm64@16.4.3': + '@next/swc-darwin-arm64@16.4.6': optional: true - '@next/swc-darwin-x64@16.4.3': + '@next/swc-darwin-x64@16.4.6': optional: true - '@next/swc-linux-arm64-gnu@16.4.3': + '@next/swc-linux-arm64-gnu@16.4.6': optional: true - '@next/swc-linux-arm64-musl@16.4.3': + '@next/swc-linux-arm64-musl@16.4.6': optional: true - '@next/swc-linux-x64-gnu@16.4.3': + '@next/swc-linux-x64-gnu@16.4.6': optional: true - '@next/swc-linux-x64-musl@16.4.3': + '@next/swc-linux-x64-musl@16.4.6': optional: true - '@next/swc-win32-arm64-msvc@16.4.3': + '@next/swc-win32-arm64-msvc@16.4.6': optional: true - '@next/swc-win32-x64-msvc@16.4.3': + '@next/swc-win32-x64-msvc@16.4.6': optional: true '@nodelib/fs.scandir@2.1.5': @@ -2685,8 +2682,6 @@ snapshots: callsites@3.1.0: {} - caniuse-lite@1.0.30001810: {} - caniuse-lite@1.0.30001820: {} chalk@4.1.2: @@ -2892,9 +2887,9 @@ snapshots: escape-string-regexp@4.0.0: {} - eslint-config-next@16.4.3(@typescript-eslint/parser@8.72.1(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0)(typescript@6.0.3))(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0)(typescript@6.0.3): + eslint-config-next@16.4.6(@typescript-eslint/parser@8.72.1(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0)(typescript@6.0.3))(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0)(typescript@6.0.3): dependencies: - '@next/eslint-plugin-next': 16.4.3(eslint@9.39.5(supports-color@7.2.0)) + '@next/eslint-plugin-next': 16.4.6(eslint@9.39.5(supports-color@7.2.0)) eslint: 9.39.5(supports-color@7.2.0) eslint-import-resolver-node: 0.3.10(supports-color@7.2.0) eslint-import-resolver-typescript: 3.10.1(eslint-plugin-import@2.32.0)(eslint@9.39.5(supports-color@7.2.0))(supports-color@7.2.0) @@ -3466,25 +3461,25 @@ snapshots: natural-compare@1.4.0: {} - next@16.4.3(@babel/core@7.29.7(supports-color@7.2.0))(@types/node@26.6.6)(react-dom@19.3.1(react@19.3.1))(react@19.3.1): + next@16.4.6(@babel/core@7.29.7(supports-color@7.2.0))(@types/node@26.6.6)(react-dom@19.3.1(react@19.3.1))(react@19.3.1): dependencies: - '@next/env': 16.4.3 + '@next/env': 16.4.6 '@swc/helpers': 0.5.23 baseline-browser-mapping: 2.11.34 - caniuse-lite: 1.0.30001810 + caniuse-lite: 1.0.30001820 postcss: 8.5.25 react: 19.3.1 react-dom: 19.3.1(react@19.3.1) styled-jsx: 5.1.6(@babel/core@7.29.7(supports-color@7.2.0))(react@19.3.1) optionalDependencies: - '@next/swc-darwin-arm64': 16.4.3 - '@next/swc-darwin-x64': 16.4.3 - '@next/swc-linux-arm64-gnu': 16.4.3 - '@next/swc-linux-arm64-musl': 16.4.3 - '@next/swc-linux-x64-gnu': 16.4.3 - '@next/swc-linux-x64-musl': 16.4.3 - '@next/swc-win32-arm64-msvc': 16.4.3 - '@next/swc-win32-x64-msvc': 16.4.3 + '@next/swc-darwin-arm64': 16.4.6 + '@next/swc-darwin-x64': 16.4.6 + '@next/swc-linux-arm64-gnu': 16.4.6 + '@next/swc-linux-arm64-musl': 16.4.6 + '@next/swc-linux-x64-gnu': 16.4.6 + '@next/swc-linux-x64-musl': 16.4.6 + '@next/swc-win32-arm64-msvc': 16.4.6 + '@next/swc-win32-x64-msvc': 16.4.6 sharp: 0.35.5(@types/node@26.6.6) transitivePeerDependencies: - '@babel/core'