fix(ci): repair broken .nox/typecheck/bin/python3 symlink to restore typecheck CI job #10083

New issue

Open

opened 2026-04-16 22:16:43 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-16 22:16:43 +00:00

Owner

Metadata

Commit Message: fix(ci): repair broken .nox/typecheck/bin/python3 symlink to restore typecheck CI job
Branch: fix/nox-typecheck-broken-symlink

Background and Context

The .nox/typecheck virtual environment has a broken Python interpreter symlink at .nox/typecheck/bin/python3. This causes the nox -s typecheck session to fail immediately with a "No such file or directory" or "bad interpreter" error before Pyright can run.

typecheck is one of the 5 required checks for merge in the CI pipeline:

lint
typecheck ← currently broken
security
unit_tests
coverage (≥ 97%)

With the typecheck job failing, no PRs can pass all required checks and be merged. This is a critical blocker for the project reaching production-ready state.

Root Cause

The .nox/typecheck/bin/python3 symlink points to a Python interpreter that no longer exists at the expected path. This typically happens when:

The Python version was updated but the nox environment was not recreated
The nox environment was created with a different Python installation that was later removed
The symlink target path changed due to system updates

Expected Behavior

nox -s typecheck should run successfully, executing pyright --project pyproject.toml in strict mode and reporting type errors.

Acceptance Criteria

The .nox/typecheck virtual environment is recreated with a valid Python 3.13 interpreter
nox -s typecheck runs successfully and Pyright strict mode type checking completes
The typecheck CI job passes on the next PR run
The fix is documented so future contributors know how to recreate the environment if needed

Subtasks

Delete the broken .nox/typecheck directory: rm -rf .nox/typecheck
Recreate the typecheck environment: nox -s typecheck --reuse-existing-virtualenvs false
Verify the symlink is valid: ls -la .nox/typecheck/bin/python3
Run nox -s typecheck and confirm it passes
Add a CI step or documentation note to recreate nox environments when Python version changes
Verify coverage ≥ 97% via nox -s coverage_report

Definition of Done

This issue is complete when:

All subtasks above are completed and checked off.
A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional lines providing relevant details about the implementation.
The commit is pushed to the remote on the branch matching the Branch in Metadata exactly.
The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.

Duplicate Check

Searched open and closed issues for the following terms before filing this issue:

Search Term	Result
"typecheck"	Found #9783 (CI timing analysis), #9767 (CI reliability), #9697 (quality gates) — none mention broken symlink
"symlink"	No matches found in open or closed issues
".nox/typecheck"	No matches found
"venv"	No matches found for typecheck venv specifically
"python3 interpreter"	No matches found
"broken interpreter"	No matches found

Conclusion: No existing issue tracks the broken .nox/typecheck/bin/python3 symlink. This is a new, unique issue.

Automated by CleverAgents Bot
Agent: new-issue-creator

## Metadata - **Commit Message:** `fix(ci): repair broken .nox/typecheck/bin/python3 symlink to restore typecheck CI job` - **Branch:** `fix/nox-typecheck-broken-symlink` ## Background and Context The `.nox/typecheck` virtual environment has a broken Python interpreter symlink at `.nox/typecheck/bin/python3`. This causes the `nox -s typecheck` session to fail immediately with a "No such file or directory" or "bad interpreter" error before Pyright can run. `typecheck` is one of the **5 required checks for merge** in the CI pipeline: 1. `lint` 2. **`typecheck`** ← currently broken 3. `security` 4. `unit_tests` 5. `coverage` (≥ 97%) With the typecheck job failing, no PRs can pass all required checks and be merged. This is a critical blocker for the project reaching production-ready state. ## Root Cause The `.nox/typecheck/bin/python3` symlink points to a Python interpreter that no longer exists at the expected path. This typically happens when: 1. The Python version was updated but the nox environment was not recreated 2. The nox environment was created with a different Python installation that was later removed 3. The symlink target path changed due to system updates ## Expected Behavior `nox -s typecheck` should run successfully, executing `pyright --project pyproject.toml` in strict mode and reporting type errors. ## Acceptance Criteria - [ ] The `.nox/typecheck` virtual environment is recreated with a valid Python 3.13 interpreter - [ ] `nox -s typecheck` runs successfully and Pyright strict mode type checking completes - [ ] The `typecheck` CI job passes on the next PR run - [ ] The fix is documented so future contributors know how to recreate the environment if needed ## Subtasks - [ ] Delete the broken `.nox/typecheck` directory: `rm -rf .nox/typecheck` - [ ] Recreate the typecheck environment: `nox -s typecheck --reuse-existing-virtualenvs false` - [ ] Verify the symlink is valid: `ls -la .nox/typecheck/bin/python3` - [ ] Run `nox -s typecheck` and confirm it passes - [ ] Add a CI step or documentation note to recreate nox environments when Python version changes - [ ] Verify coverage ≥ 97% via `nox -s coverage_report` ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional lines providing relevant details about the implementation. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly. - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done. ### Duplicate Check Searched open and closed issues for the following terms before filing this issue: | Search Term | Result | |-------------|--------| | "typecheck" | Found #9783 (CI timing analysis), #9767 (CI reliability), #9697 (quality gates) — none mention broken symlink | | "symlink" | No matches found in open or closed issues | | ".nox/typecheck" | No matches found | | "venv" | No matches found for typecheck venv specifically | | "python3 interpreter" | No matches found | | "broken interpreter" | No matches found | **Conclusion:** No existing issue tracks the broken `.nox/typecheck/bin/python3` symlink. This is a new, unique issue. --- **Automated by CleverAgents Bot** Agent: new-issue-creator

HAL9000 added the

labels

2026-04-16 22:22:37 +00:00

HAL9000 referenced this issue