jscpd-rs 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+## 0.1.0 - 2026-05-31
+
+First release candidate for `jscpd-rs`, a native Rust clone of upstream
+`jscpd`.
+
+### Added
+
+- Native `jscpd` CLI binary with upstream-compatible command name and help
+  shape.
+- Native `jscpd-server` binary exposing `/`, `/api/health`, `/api/stats`,
+  `/api/check`, `/api/recheck`, and `/mcp`.
+- Coverage-first compatibility gates against the upstream `jscpd` submodule.
+- CLI/config support for the main upstream option surface, including Commander
+  edge cases covered by compatibility scripts.
+- Native file discovery with `.gitignore`, global Git excludes, symlink policy,
+  shebang detection, max size, max line, custom extension, and custom filename
+  handling.
+- Upstream-synchronized format registry with 223 formats and 206 extension
+  mappings.
+- Native Oxc-backed JavaScript, TypeScript, JSX, and TSX token processing.
+- Native generic tokenization for long-tail formats, plus block handling for
+  Markdown, markup, Vue, Svelte, Astro, Apex, and TAP where needed for current
+  coverage gates.
+- Built-in native reporters: `ai`, `console`, `consoleFull`, `csv`, `html`,
+  `json`, `markdown`, `silent`, `sarif`, `threshold`, `xcode`, `xml`, and
+  `badge`.
+- Native `git blame -w` support in reports.
+- Native Rust API for path-based detection, in-memory `SourceFile` detection,
+  an embeddable argv runner, native tokenizer map generation, native
+  `Detector`/`Statistic`/`MemoryStore` counterparts, upstream-style default
+  options, argv option parsing, supported format listing, format lookup, and
+  both `detect_clones_and_statistic` and
+  `detect_clones_and_statistics` spellings.
+- Source-build npm package metadata and bin shims for `npx jscpd-rs`,
+  `jscpd`, and `jscpd-server`.
+- Public benchmark suite on pinned React, Next.js, and Prometheus revisions.
+
+### Compatibility And Performance
+
+The first release is intentionally coverage-first: Rust must not miss duplicated
+upstream lines on the same inputs/options. Additional Rust findings are allowed
+while compatibility converges and remain visible in comparison output.
+
+Recorded release-candidate public benchmark measurements from
+`scripts/release-candidate.sh`:
+
+| Case | Commit | Format | Rust avg | Upstream avg | Speedup | Compat |
+| --- | --- | --- | ---: | ---: | ---: | --- |
+| React | `f0dfee3` | JavaScript | 0.199097s | 10.079214s | 50.62x | pass |
+| Next.js | `2bbb67b9` | TypeScript | 0.262433s | 14.715736s | 56.07x | pass |
+| Prometheus | `a0524ee` | Go | 0.085239s | 4.642435s | 54.46x | pass |
+
+### Known First-Release Deviations
+
+- Dynamic npm reporters, stores, listeners, and plugins are not loaded.
+- External reporter and store names keep upstream-style warning/fallback
+  behavior where upstream continues.
+- Exact clone pair ordering, token totals, and fragment boundaries remain
+  diagnostic as long as upstream duplicated lines are covered.
+- HTML output is self-contained and practically compatible, not pixel-perfect.
+- The Rust crate exposes a native Rust API, not the upstream JavaScript package
+  API.
+- The npm package currently builds native binaries from source during install;
+  prebuilt platform packages are planned as a later publication improvement.
+- Full Prism grammar parity for every long-tail format is not attempted in this
+  release. Formats should be promoted from generic tokenization when concrete
+  coverage gates show missed upstream lines.