typescript-decompiler/docs/phase-docs/phase-overview.md

Phase overview

Use this document as the top-level index for the current release-oriented recovery pipeline.

Repository model

• repo root is the canonical editable deobfuscated tree
• runs/ keeps local current and previous upstream snapshot artifacts
• stable/ keeps long-lived metadata reused across snapshots
• releases/ stores machine-readable manifests for published deobfuscated versions
• upstream bundles are stored as release assets, not committed into git

Release model

• an upstream “release” is any snapshot you decide to ingest
• your published versions use your own versioning, e.g. 0.y.z
• y changes when the upstream snapshot changes
• z changes when only maintained transforms or packaging change
• publish with both Git tags/Gitea Releases and the package registry

Cross-phase invariants

• do not rewrite semantics during relabeling
• do not depend on LLM output for splitting or diffing
• only send changed or new segments to the LLM on upgrade
• keep maintained changes replayable as transforms, preferably jscodeshift codemods
• keep normal git commits as the human audit log for maintained changes
• emit compact upstream summary manifests instead of line-by-line historical ledgers
• surface low-confidence transform replays as conflicts instead of auto-applying them

Phases

1. Phase 1 — deterministic ingest
2. Phase 2 — dependency identification and externalization
3. Phase 3 — context extraction
4. Phase 4 — run-to-run diffing and upstream summary
5. Phase 5 — iterative relabel queue planning and batching
6. Phase 6 — relabel API execution and wave scheduling
7. Phase 7 — iterative relabel evaluation, application, and queue feedback
8. Phase 8 — deterministic codebase regularization
9. Phase 9 — derive and replay maintained transforms
10. Phase 10 — build and publish release artifacts