Skip to content

Fix stale docstrings in workspace and execution tests#1982

Merged
Trecek merged 2 commits into
developfrom
fix-stale-docstrings-in-workspace-and-execution-tests/1890
May 6, 2026
Merged

Fix stale docstrings in workspace and execution tests#1982
Trecek merged 2 commits into
developfrom
fix-stale-docstrings-in-workspace-and-execution-tests/1890

Conversation

@Trecek
Copy link
Copy Markdown
Collaborator

@Trecek Trecek commented May 6, 2026

Summary

Two test files contain stale docstrings and assertion messages that reference old names
or misstate what the assertions actually check:

  • C5-2 (tests/workspace/test_skills.py): test_bundled_skills_list_matches_filesystem
    docstring and failure message still say make-script-skill — the skill was renamed to
    write-recipe.
  • C5-5 (tests/execution/test_process_submodules.py): per-symbol test docstrings say
    "exports X" but the assertions verify __module__ (definition origin), not __all__
    membership. Each docstring should say "is defined in X submodule".

Both fixes are pure string edits in test files. No logic changes, no new fixtures, no
isolation concerns.

Implementation Plan

Plan file: /home/talon/projects/autoskillit-runs/impl-20260505-221516-303979/.autoskillit/temp/make-plan/fix_stale_docstrings_workspace_execution_tests_plan_2026-05-05_000000.md

🤖 Generated with Claude Code via AutoSkillit

Token Usage Summary

Step count uncached output cache_read peak_ctx turns cache_write time
plan 1 95 6.6k 330.6k 42.4k 28 32.3k 2m 14s
verify 1 84 6.6k 337.8k 44.3k 26 31.4k 2m 0s
implement 1 250.8k 4.9k 477.3k 26.7k 48 16.0k 2m 5s
prepare_pr 1 43.0k 2.5k 157.2k 26.7k 19 15.2k 59s
compose_pr 1 42.6k 1.3k 157.2k 26.7k 15 15.0k 40s
review_pr 1 124 11.0k 511.6k 45.1k 39 33.3k 2m 48s
resolve_review 1 213 14.4k 1.1M 60.7k 69 48.3k 5m 27s
Total 336.9k 47.3k 3.1M 60.7k 191.5k 16m 14s

Token Efficiency

Step LoC Changed cache_read/LoC cache_write/LoC output/LoC
plan 0
verify 0
implement 16 29828.4 1000.9 303.9
prepare_pr 0
compose_pr 0
review_pr 0
resolve_review 6 185099.5 8048.3 2403.8
Total 22 140101.8 8705.8 2148.5

- C5-2: update make-script-skill → write-recipe in test_skills.py
  (docstring and assertion failure message)
- C5-5: update per-symbol test docstrings in test_process_submodules.py
  to reflect __module__ checks (definition origin) rather than exports

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copy link
Copy Markdown
Collaborator Author

@Trecek Trecek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AutoSkillit PR Review — Verdict: approved_with_comments

Comment thread tests/execution/test_process_submodules.py Outdated
Comment thread tests/execution/test_process_submodules.py Outdated

def test_process_race_exports():
"""_process_race.py exports race coordination types and functions."""
"""Race types/functions are defined in _process_race submodule."""
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[info] cohesion: Docstring for test_process_race_exports uses the vague category label 'Race types/functions' rather than naming specific exported symbols (e.g., 'RaceAccumulator, RaceSignals'). Other docstrings in the same file enumerate specific symbol names.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Acknowledged — minor suggestion noted.

Copy link
Copy Markdown
Collaborator Author

@Trecek Trecek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AutoSkillit review: warning-only findings detected. See inline comments — no blocking changes required.

… and test_process_monitor_exports docstrings

Replace wildcard glob (_jsonl_* helpers) and Latin abbreviation (_heartbeat et al.)
with explicit symbol lists, consistent with the enumeration style used in adjacent
test docstrings in the same file.
@Trecek Trecek added this pull request to the merge queue May 6, 2026
Merged via the queue into develop with commit 5627115 May 6, 2026
2 checks passed
@Trecek Trecek deleted the fix-stale-docstrings-in-workspace-and-execution-tests/1890 branch May 6, 2026 06:01
Trecek added a commit that referenced this pull request May 8, 2026
## Summary

Two test files contain stale docstrings and assertion messages that
reference old names
or misstate what the assertions actually check:

- **C5-2** (`tests/workspace/test_skills.py`):
`test_bundled_skills_list_matches_filesystem`
docstring and failure message still say `make-script-skill` — the skill
was renamed to
  `write-recipe`.
- **C5-5** (`tests/execution/test_process_submodules.py`): per-symbol
test docstrings say
`"exports X"` but the assertions verify `__module__` (definition
origin), not `__all__`
  membership. Each docstring should say `"is defined in X submodule"`.

Both fixes are pure string edits in test files. No logic changes, no new
fixtures, no
isolation concerns.

## Implementation Plan

Plan file:
`/home/talon/projects/autoskillit-runs/impl-20260505-221516-303979/.autoskillit/temp/make-plan/fix_stale_docstrings_workspace_execution_tests_plan_2026-05-05_000000.md`

🤖 Generated with [Claude Code](https://claude.com/claude-code) via
AutoSkillit
<!-- autoskillit:pipeline-signature
steps=prepare_pr,run_arch_lenses,compose_pr,annotate_pr_diff,review_pr
-->

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
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