fix: preserve verification diagnostics - #10
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
This PR refines workspace-kit verify/doctor diagnostics so buffered output preserves check execution order across stdout/stderr, while also deduplicating repeated validation failures and tightening wiki-catalog rules to allow sources: [] only for generated catalogs.
Changes:
- Buffer and replay
doctor/verifyoutput as an ordered event stream (stdout + stderr), preserving per-check ordering. - Deduplicate repeated registry and wiki-backfill failure messages in
verifyoutput/JSON errors. - Emit
sources: []for empty generated daily-log catalogs and relax wiki lint to allow emptysourcesonly for generatedsources/andtags/catalogs (with Windows path separator normalization).
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| test/cli-commands.test.ts | Adds regression coverage for ordered output replay, generated-catalog sources: [], and deduped verify errors. |
| src/cli.ts | Introduces ordered output events + shared emitter, and dedupes added verify errors to avoid repeats. |
| src/checks/wikiLint.ts | Normalizes Windows separators consistently and permits empty sources only for generated catalogs. |
| src/checks/wikiBackfill.ts | Writes empty daily-log catalog sources as sources: [] instead of self-referencing. |
| docs/convention.md | Updates documentation to reflect authored-vs-generated sources requirements. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
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
Address the three unresolved review findings from #8 without weakening authored wiki-page validation.
Changed
verify.sources: [].sources/andtags/catalogs.Review aids
memory/wiki/index.mdsources: [], accepted only for generated catalogsOriginal review threads:
Risks
Low. The output change preserves the existing buffered CLI contract while retaining event order. Authored wiki pages still require non-empty sources.
Verification
pnpm exec vp test run test/cli-commands.test.ts— 17 passedpnpm exec vp run verify— 136 passed; format, lint, types, coverage, package build, and packed install smoke passedautoreview --mode local— clean after validating and fixing its Windows path findingComplexity
Output event replay and deduplication are linear in the number of emitted messages and validation errors.
Note
Low Risk
CLI output and wiki lint/backfill behavior changes are localized; authored wiki validation is unchanged and covered by new tests.
Overview
doctorandverifynow buffer check output as a single ordered stdout/stderr event stream and replay it in execution order, so an earlier failure is not printed after a later success.verifyalso deduplicates repeated registry and wiki-backfill error lines in JSON and plain stderr.Wiki catalogs: empty daily-log backfill pages emit
sources: []instead of a self-referential index link. Wiki lint allows emptysourcesonly under generatedsources/andtags/paths; authored pages still need non-empty sources. Path handling normalizes Windows backslashes before classifying generated catalogs.docs/convention.mddocuments the authored vs generatedsourcesrule. CLI tests cover combined output ordering, single-shot registry errors, and scaffolddaily-logsources: []lint-green behavior.Reviewed by Cursor Bugbot for commit da9fc70. Bugbot is set up for automated code reviews on this repo. Configure here.
Summary by cubic
Preserves verification diagnostics by keeping output order and removing duplicate errors, and aligns wiki backfill/lint rules for empty generated catalogs. Also fixes Windows path handling for catalog detection.
sources: []only for generatedsources/andtags/catalogs; authored pages still require sources.Written for commit da9fc70. Summary will update on new commits.