Skip to content

chore: low-risk technical debt pass#208

Closed
safl wants to merge 2 commits into
mainfrom
chore-techdebt-pass
Closed

chore: low-risk technical debt pass#208
safl wants to merge 2 commits into
mainfrom
chore-techdebt-pass

Conversation

@safl

@safl safl commented Jun 29, 2026

Copy link
Copy Markdown
Collaborator

Summary

Two scoped cleanup commits.

The first drops 22 unused imports flagged by ruff F401 across docs/, src/, and tests/. None of them were API re-exports, confirmed by grepping for each name across the tree before applying ruff --fix. While in the same area, it also fixes an unused state destructuring at src/cijoe/core/scripts/cmdrunner.py:65 (a long-standing pyright warning) and removes a three-line commented-out rmdir in src/cijoe/linux/null_blk.py whose author note had marked it "not useful yet".

The second resolves three leftover references to "workflow" after the recent rename to "task". The Sphinx sidebar pattern in docs/source/conf.py still excluded workflows** against a directory that has since become tasks/. The example task's header had a "GitHUB" casing typo. The bash completion at src/cijoe/core/auxiliary/cijoe-completions only knew the legacy default filename cijoe-workflow.yaml, so step-name completion silently failed once a user moved to cijoe-task.yaml; it now prefers the new name and falls back to the legacy one for users mid-migration.

Items the survey flagged but were intentionally left out: src/cijoe/core/analyser.py (no in-tree callers but possibly external API), the open TODOs in null_blk.py, cli.py, testrunner.py, and the report template, the tomli/tomllib conditional in resources.py (3.10 has neither, so the conditional stays), and every deliberate back-compat shim from the rename.

Test plan

Confirm verify_and_publish is green on this branch and that no test depends on any of the removed imports.

safl added 2 commits June 29, 2026 14:33
Ruff F401 flagged 22 dead imports across docs/, src/, and tests/ that
accumulated over time as code moved around. Cleared the same way ruff
would auto-fix: no exports relied on any of them.

While here, fixed an unused 'state' destructuring at cmdrunner.py:65
that pyright had been warning about, and dropped a 'not useful yet'
commented rmdir at null_blk.py whose author note dates back several
years; git history retains it if anyone wants it back.

Signed-off-by: Simon A. F. Lund <os@safl.dk>
Three leftover spots after the workflow-to-task rename: the sphinx
sidebar pattern at docs/source/conf.py still excluded 'workflows**'
where the renamed directory is 'tasks/'; the example task header in
example_task_default.yaml had a 'GitHUB' casing typo; and the bash
completion's default filename was the legacy 'cijoe-workflow.yaml'
so step-name completion silently failed for users on the new
'cijoe-task.yaml'. Prefer the new name and fall back to the legacy
one so completion still works mid-migration.

Signed-off-by: Simon A. F. Lund <os@safl.dk>
@safl

safl commented Jun 29, 2026

Copy link
Copy Markdown
Collaborator Author

Folded into #207 with the v0.9.60 version bump.

@safl safl closed this Jun 29, 2026
@safl safl deleted the chore-techdebt-pass branch June 29, 2026 12:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant