release: Codex Exporter 0.2.0

[lowestprime]

Summary

Publishes Codex Exporter 0.2.0 as a fidelity-oriented,
automation-first exporter for local Codex session JSONL data, with
optional native dialogs and terminal browsing.

Major changes

• Persistent export directories and filename templates.
• Native Windows folder and Save As dialogs.
• Mode-aware, collision-safe, batch-safe filenames.
• Complete PowerShell and POSIX helper APIs.
• Exact-for-encoding tiktoken metadata with explicit regex fallback.
• Last-N-turn export and deterministic batch input.
• Project-aware terminal session browsing.
• Reconstructed live-context mode with explicit approximation semantics.
• Optional recorded reasoning-summary inclusion; raw private reasoning is
  never reconstructed.
• Recognized, ignored, and unknown event accounting in sibling manifests.
• Narrow repair of invalid Windows-path backslashes in otherwise-valid JSON.
• Explicit source-runtime versus exporter-side truncation accounting.
• Deterministic UTF-8 stdout and stderr for Windows redirects, browser output,
  and machine-readable JSON.
• Python package metadata and the codex-export console entry point.
• Expanded regression fixtures and tests.
• Compatibility, integrity, security, upgrade, and release documentation.
• Idempotent custom-path Windows and POSIX installers.
• GitHub Actions validation and release-artifact automation.

Windows UTF-8 regression addressed

Windows redirected Python streams can inherit a legacy code page such as
CP1252. The browser uses Unicode typography, and JSON output may contain
arbitrary Unicode session data.

The CLI now reconfigures stdout and stderr to UTF-8 at process startup. The
browser regression deliberately forces PYTHONIOENCODING=cp1252 on every CI
platform and verifies that the browser heading and final JSON result remain
valid UTF-8.

Privacy and fixture policy

• Ignored personal archives and local configuration are not scanned or staged.
• Personal profiles, machine-specific audit outputs, private source-session
  exports, and local session identifiers are excluded.
• Synthetic JSONL regression fixtures are permitted only beneath
  tests/fixtures/.
• Any staged JSONL file outside that fixture subtree is rejected.
• Generated wheels, source archives, bytecode, caches, and build directories
  are excluded from the commit.

Distribution hygiene

• MANIFEST.in excludes .pyc, .pyo, and __pycache__ content.
• Both wheel and source-distribution archives are inspected.
• CI and release workflows fail if generated Python bytecode enters either
  artifact.

Local validation completed

• All three CLI mirrors are byte-identical.
• Python compilation passes.
• Full pytest suite passes: 17 passed and 1 environment-gated clipboard test
  skipped.
• The forced-CP1252 browser/JSON UTF-8 regression passes.
• The sdist and wheel build successfully.
• The built wheel installs successfully.
• codex-export --version reports codex-export 0.2.0.
• Publishable PowerShell files parse successfully.
• git diff --check passes.
• Distribution archives contain no generated Python bytecode.
• The staged privacy and generated-file audit passes.

Review focus

Please pay particular attention to:

1. chronological-history versus reconstructed-live-context semantics;
2. event classification and unknown-event reporting;
3. source-truncation versus exporter-side shortening annotations;
4. Windows UTF-8 and native-dialog behavior;
5. installer idempotency and custom-path handling;
6. package and release-artifact integrity.

Merge and release

Use squash merge.

Tag v0.2.0 only after:

1. every required CI check is green;
2. the merged main branch installs successfully on Windows;
3. a real local session exports successfully in thread mode;
4. the generated Markdown and sibling manifest pass manual inspection.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.