feat(guides): generate npm migration and best-practice artifacts - #82
Draft
harlan-zw wants to merge 5 commits into
Draft
feat(guides): generate npm migration and best-practice artifacts#82harlan-zw wants to merge 5 commits into
harlan-zw wants to merge 5 commits into
Conversation
…ntal pipeline - semverMajor + scope guides to one major (v3→v4 window); previousMajorAnchor for 'from'. - Per-version buckets (VersionBuckets) surfaced for the site's from-version selector. - Detect [**BREAKING**]/**BREAKING** markers (jest/babel monorepo changelogs). - version.ts stamps (BUCKET_RULES/RUNBOOK_PROMPT/PIPELINE_VERSION); runbook synthesis cached by hash(synthInput)+promptVersion; batch skips current-stamp guides → incremental.
…0-beta) Pad major.minor[-pre] release tags so they're valid semver and land in the right major. Note: TS v6 migration notes live in excluded prerelease releases — capturing those needs selectReleases to include same-major prereleases for migration guides.
…d + cached) Second pillar alongside migration guides: synthesises a 'how to use <pkg>' skill from cached docs/README (stable latest version), with the same stamp + synthesis-cache machinery. Validated on zod (Setup/Core API/Idioms/Mistakes/Example).
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
1 participant
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.
🔗 Linked issue
None.
❓ Type of change
📚 Description
Adds a local pipeline that turns npm release notes into version-scoped migration runbooks and package documentation into best-practice skills. Deterministic bucketing handles structured changelogs; an LLM handles formats the parser cannot classify. Pipeline stamps and content hashes make batch regeneration incremental.
✅ Validation
pnpm lintpnpm typecheckpnpm buildThe full suite currently has eight unrelated live-resolution failures involving React, motion-v, and the prompt fixture.