Skip to content

Add 1.0.0 roadmap#46

Merged
Korijn merged 1 commit into
masterfrom
claude/patchdiff-1-0-0-plan-powfen
Jul 10, 2026
Merged

Add 1.0.0 roadmap#46
Korijn merged 1 commit into
masterfrom
claude/patchdiff-1-0-0-plan-powfen

Conversation

@Korijn

@Korijn Korijn commented Jul 10, 2026

Copy link
Copy Markdown
Collaborator

Adds ROADMAP.md: the PR-by-PR program to take patchdiff from 0.3.x to its first stable release, mirroring the series that took observ to 1.0.0 (observ #175–#197).

The program

14 PRs across 5 tracks:

  • Track A — CI & benchmark infrastructure: modernize workflows (port of observ #182), replace the single-run 5% benchmark gate with observ's noise-robust interleaved guard at a 25% tripwire threshold (ports of observ #181 + #187).
  • Track B — Documentation: MkDocs Material site with mkdocstrings API reference on GitHub Pages (port of observ #176), an Internals section (#179), a README rewrite (#180).
  • Track C — Typing: runtime cleanups (#184) then full modern type hints with Operation TypedDicts, py.typed, and ty enforced in CI (#185), stacked.
  • Track D — Test hardening: Hypothesis-based round-trip property tests plus the json-patch-tests RFC 6902 corpus (deliberate divergences skipped with reasons).
  • Track E — Optimizations: two foundational passes (Myers O(ND) list diff to replace the O(m·n) DP; a produce() hot-path design pass) and three micro passes (diff/pointer, apply/iapply, proxy traps), each benchmark-verified against the new guard.
  • Release: the 1.0.0 bump with release notes and before/after benchmark tables (#197).

Ordering is encoded in the roadmap: the benchmark guard lands before any optimization PR, and typing + property tests land before them as the safety net. 100% coverage stays enforced throughout.

🤖 Generated with Claude Code

https://claude.ai/code/session_016Mu9vEBwU4fQLi8ZgkgdS2


Generated by Claude Code

…ion passes

Lays out the PR-by-PR program to take patchdiff to its first stable
release, mirroring the series that took observ to 1.0.0 (#175-#197):
modernized CI and a noise-robust benchmark guard, a MkDocs docs site
with internals section and a README rewrite, full modern typing checked
with ty, property-based round-trip tests plus an RFC 6902 corpus, two
foundational and three micro optimization passes, and the 1.0.0 release.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016Mu9vEBwU4fQLi8ZgkgdS2
@Korijn Korijn merged commit c37a6bf into master Jul 10, 2026
9 checks passed
@Korijn Korijn deleted the claude/patchdiff-1-0-0-plan-powfen branch July 10, 2026 21:04
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.

2 participants