Skip to content

plans: full pproxy parity roadmap and Track A handoff - #1

Merged
dbowm91 merged 12 commits into
mainfrom
plans/full-pproxy-parity-track-a
Jul 9, 2026
Merged

dbowm91 merged 12 commits into
mainfrom
plans/full-pproxy-parity-track-a

Conversation

@dbowm91

@dbowm91 dbowm91 commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Adds a full pproxy parity roadmap and detailed Track A handoff plans under plans/.

Files added:

  • plans/full_pproxy_parity_roadmap.md
  • plans/track_a_00_canonical_parity_contract.md
  • plans/track_a_01_pproxy_oracle_harness.md
  • plans/track_a_02_cli_drop_in_compatibility.md
  • plans/track_a_03_uri_rule_regex_compatibility.md
  • plans/track_a_04_http_socks_exactness.md
  • plans/track_a_05_status_consistency_and_trojan_closure.md

The roadmap incorporates the fancy_regex compatibility-backend decision for pproxy rulefile/block regex support while documenting remaining Python re semantic gaps as explicit compatibility caveats.

dbowm91 and others added 12 commits July 8, 2026 11:06
- Add crates/eggress-testkit/src/canonical_manifest.rs: Rust validator for
  docs/parity/pproxy_capability_manifest.toml with 13 validation rules
  (tier/layer/evidence vocabulary, drop-in requirements, evidence strength,
  cross-field contradictions, typo detection) and 51 tests.

- Fix 3x egress_behavior -> eggress_behavior typos in canonical manifest.

- Fix stale docs: COMPATIBILITY_EVIDENCE source reference, PARITY_MATRIX
  --rulefile diagnostics entry, PPROXY_PARITY_SPEC CLI flag table for
  Phase 38 changes, diagnostics.rs tier comment, pproxy.py FeatureInfo.tier
  docstring.

- Add deprecation note to legacy tests/compat/pproxy_manifest.toml.

- Update AGENTS.md with canonical manifest validation commands.
Add a standalone pproxy binary target alongside eggress in eggress-cli.
Users can now run pproxy directly (pproxy -l http://:8080 -r socks5://...)
instead of going through the eggress pproxy subcommands.

Changes:
- New binary: crates/eggress-cli/src/pproxy_main.rs (275 lines)
  - Raw arg parsing from env::args_os (not clap)
  - --version, -h/--help with comprehensive flag reference
  - Delegates to PproxyArgs::parse() → translate_pproxy_args()
  - Startup banner with version, listeners, remotes, UDP, TLS, PAC
  - --test spawns eggress upstream test and exits with its status
  - --sys inspects system proxy before starting
- Verbose flag normalization: -v/-vv/-vvv → verbose_level (0-3)
  - Maps to RUST_LOG: 0→info, 1-2→debug, 3+→trace
- 16 integration tests in pproxy_binary.rs
- 5 unit tests for verbose_level in args.rs
- Docs: README, AGENTS.md, .skills/rust-proxy-dev.md updated
Dual regex backend: fast regex + fancy_regex for lookahead/lookbehind/
backreferences. Rulefile loader validates patterns and enforces 10K entry
limit. -b flag patterns validated at parse time. URI ?rules_file= parameter
preserved through translation. New diagnostic codes: RulefileError,
InvalidRegexPattern, FancyRegexBackend, UriPreservedUnsupportedComponent.

Co-Authored-By: opencode <noreply@opencode.ai>
… oracle harness

- Split 6 broad protocol capabilities into 36 granular entries (109→139 total)
  - HTTP CONNECT: 9 sub-caps (ipv4, ipv6, domain, auth_success/failure, refused, half_close, fragmented, timeout)
  - HTTP Forward: 9 sub-caps (get, post, head, chunked, persistent, connection_close, auth, malformed, upstream_close)
  - SOCKS4/4a: 5 sub-caps (connect_ipv4, user_id, refused, malformed, connect_domain)
  - SOCKS5: 8 sub-caps (connect_ipv4/ipv6/domain/refused, auth_success/failure, malformed, half_close)
  - Chain matrix: 4 new entries (socks5_to_http, socks5_to_socks5, http_to_socks5, http_to_http)
- Add chain matrix differential tests (HTTP→SOCKS5, HTTP→HTTP) in pproxy_differential.rs
- Add oracle scenario harness in eggress-testkit (scenario, report modules)
- Update PPROXY_PARITY_REPORT.md, PARITY_MATRIX.md, AGENTS.md, README.md, skills
- Update capability counts across all release docs (109→139)
@dbowm91
dbowm91 merged commit 07e35d6 into main Jul 9, 2026
3 of 19 checks passed
@dbowm91
dbowm91 deleted the plans/full-pproxy-parity-track-a branch July 22, 2026 18:18
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.

1 participant