diff --git a/.gitignore b/.gitignore index 25e3f20..c36bfa8 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 fa1751e..9d10696 100644 --- a/README.md +++ b/README.md @@ -176,7 +176,19 @@ 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. + + 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) @@ -233,7 +245,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 +376,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. diff --git a/web/package.json b/web/package.json index 67e6806..e9ea607 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 c59f552..e16a580 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'