Code quality cleanup: knip config, type consolidation, ADR, and TODO fixes#71
Open
Code quality cleanup: knip config, type consolidation, ADR, and TODO fixes#71
Conversation
Covers the five bundled cleanups from debrief-future spec 199: knip ignore + pinning, LogPanel prop consolidation, ADR-019 for VS Code type-only cycles, loader plotName fix with regression test, and TODO-to-issue promotion. https://claude.ai/code/session_018BQTrz526CuYqTGQZm5hC8
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Five targeted code-quality improvements bundled into a single PR to reduce reviewer overhead while clearing accumulated technical debt and false positives.
Changes
Knip false-positive silencing: Added root
knip.jsonwithspecs/**ignore pattern to silence 57 false-positive "unused" reports from speckit contracts. Pinnedknipto5.88.1in rootdevDependenciesto eliminate tool-version drift between contributors.LogPanel prop consolidation: Merged
LogTimelinePropsandLogByFeaturePropsinto a singleLogPanelPropsinterface inshared/components/src/LogPanel/types.tsto eliminate interface drift and reduce future review ambiguity.ADR-019 documentation: Documented two accepted
import type-only cycles in the VS Code extension (mapPanel → activityPanelView → calcServiceandactivityPanelView → resultsPanelService) indocs/project_notes/decisions.md. Both cycles are erased at runtime; interface extraction is the eventual fix but deferred as a larger refactor.Loader
plotNamefix: Replaced// TODO: Get actual name from plot listplaceholder inapps/loader/src/renderer/hooks/useLoadWorkflow.tswith proper lookup that threads the plot's display name from the plot list. Added regression test inapps/loader/tests/unit/useLoadWorkflow.test.tswith revert-and-red validation.TODO promotion: Replaced bare
// TODO:markers in the loader withTODO(#472):andTODO(#473):references, linking to newly filed GitHub issues #472 and #473. Added pre-push grep guard to prevent shipping literal placeholders.Cleanup: Removed orphaned
shared/components/diff/staging artifact with zero consumers.Implementation Notes
plotNamefix: revert-and-red sanity check confirmed the test is a real gate, not a tautology.grep -rn "TODO(#NNN)" apps/) enforces TODO promotion discipline at commit time.devDependenciesensurespnpm installon a clean clone resolves to the same binary across all contributors.https://claude.ai/code/session_018BQTrz526CuYqTGQZm5hC8