session-migrate 0.5.1__tar.gz

session_migrate-0.5.1/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.venv/
+build/
+dist/
+*.egg-info/
+
+# Conversion output can contain private conversation data.
+*.session-migrate.json
+fixtures/private/
+scratch/
+

session_migrate-0.5.1/.python-version

@@ -0,0 +1,2 @@
+3.11
+

session_migrate-0.5.1/CHANGELOG.md

@@ -0,0 +1,118 @@
+# Changelog
+
+All notable changes to `session-migrate` are recorded
+here. Native format compatibility is documented separately in
+[`docs/format-compatibility.md`](docs/format-compatibility.md).
+
+## Unreleased
+
+## 0.5.1 - 2026-08-20
+
+- Publish `session-migrate` to PyPI with MIT licensing, complete package
+  metadata, and verified `uv tool install` and `pipx` entry points.
+- Replace the research-heavy README with a concise open-source overview,
+  animated real-CLI demo, practical examples, and a compact compatibility map.
+- Add a standalone one-line shell installer with isolated-venv fallback and
+  no-clobber handling for pre-existing command files.
+- Add and deploy a responsive landing page with an animated migration pipeline,
+  real trajectory video, social card, copyable installs, and native-target
+  matrix.
+
+## 0.5.0 - 2026-08-19
+
+- Rename the project, Python distribution, import package, executable, state
+  directory, environment variables, generated metadata, and documentation to
+  `session-migrate`; add the collision-checked `smigrate` executable alias.
+- Make the rename intentionally breaking: no legacy executable, import,
+  manifest path, state lookup, or compatibility shim remains. Manifests now
+  use schema version 2 and the `migration_version` key.
+- Prepare the repository for public access with a complete current-tree and
+  reachable-history credential/content audit.
+- Document how Pi 0.80.6 separates thinking-level configuration, visible
+  reasoning summaries, and opaque same-provider replay signatures, with
+  synthetic transformation and real-store offline-RPC evidence. The migrator
+  continues to count rather than transfer private reasoning.
+
+## 0.4.0 - 2026-08-18
+
+- Promote Pi 0.80.6 v3 to a first-class detectable source with active-tree
+  parsing, UUID/CWD discovery, direct transfer, catalog indexing/search, and
+  exact conversion into Claude, Codex, OpenCode, and Copilot.
+- Generalize the bounded real-session matrix to Claude, Codex, and Pi sources
+  and every different supported target; preserve same-format rejection and the
+  Antigravity/Cursor fail-closed capability boundary.
+- Add real-source pinned native Claude/Codex resume oracles, generalized Pi and
+  OpenCode native checks, and Codex/Pi-to-Copilot cold-resume/provider replay.
+- Add a disposable actual Pi TUI trajectory that translates existing Codex
+  OAuth only inside a private temporary home, completes two live turns, checks
+  context recall and append-only persistence, and removes copied credentials.
+- Fix Unicode JSON line-separator handling, bounded exhaustive-audit memory,
+  OpenCode tool-result association accounting, Copilot source-text grouping,
+  Copilot excess-result native linkage, and silent Pi nested tool-result and
+  parent-lineage omissions.
+
+## 0.3.0 - 2026-08-18
+
+- Add GitHub Copilot CLI 1.0.70 conversion/import using its public local event
+  schema, content-addressed images, exact UUID resume, and derived-index rebuild.
+- Keep Antigravity CLI 1.1.14 explicitly fail closed after proving that its
+  public CLI/SDK has no arbitrary transcript import despite successful actual
+  two-turn TUI/runtime checks.
+- Add exhaustive 102-session Copilot conversion/reparse/loss validation,
+  10-session native cold-resume/provider-replay validation, and actual
+  two-turn loopback plus authenticated Copilot TUI checks.
+- Document the credential boundary: use target-supported login or BYOK only;
+  never copy or reinterpret Codex OAuth as GitHub/Google/OpenAI credentials.
+
+## 0.2.0 - 2026-08-18
+
+- Add a private, incremental, multi-root Claude/Codex session catalog with
+  metadata-only title/name and UUID search.
+- Inventory Claude nested sidechains, Codex active/archive rollouts,
+  duplicates, missing/corrupt files, and known unsupported history modes
+  without misrepresenting them as convertible.
+- Add bounded project-local root discovery, persistent explicit roots, and
+  exact `transfer --catalog-id` selection.
+- Add native Pi 0.80.6 conversion/import and OpenCode 1.17.20 public-bundle
+  conversion plus official-CLI import. Keep Cursor import explicitly
+  unsupported until it exposes a supported import contract.
+- Add a separate target-format model and explicit `transfer --to`, while
+  preserving legacy Claude-to-Codex and Codex-to-Claude defaults.
+- Harden portable image validation, OpenCode native ID/time ordering,
+  empty-history rejection, target collision handling, private temporary files,
+  and content-free post-import manifests.
+- Pass exhaustive 102-session Claude-to-Pi and Claude-to-OpenCode semantic and
+  loss-accounting validation, 20-session actual-content review per target, and
+  isolated native smoke tests on 10 real conversions per target.
+
+## 0.1.2 - 2026-08-18
+
+- Added complete CLI, troubleshooting, and development/release documentation.
+- Clarified sensitive-data handling, manifest semantics, evidence provenance,
+  Docker reproducibility, and the v0.1.x support boundary.
+- Count non-object and malformed known image/reference blocks in structured
+  tool results instead of silently skipping them, in both conversion
+  directions.
+- Expand quoted `~` consistently in CLI paths and report the actual converted
+  output/manifest locations.
+- Passed 58 tests, the official two-way pinned native-resume probe, package
+  builds, isolated-wheel installation, and a focused 56,758-rollout structured
+  output audit.
+
+## 0.1.1 - 2026-08-18
+
+- Completed exhaustive supported-corpus semantic validation and a 60-session
+  content-level manual audit.
+- Added retained-record warnings for orphan and duplicate tool linkage.
+- Added duplicate-call/result regression coverage in both directions.
+- Published the sanitized thorough-validation report and pinned native-resume
+  evidence.
+
+## 0.1.0 - 2026-08-18
+
+- Released the bidirectional Claude Code/Codex CLI conversion baseline.
+- Added `inspect`, `convert`, `import`, and UUID-based `transfer` workflows.
+- Added bounded parsing, content-free manifests, atomic no-clobber private
+  writes, changing-source detection, and direct native discovery.
+- Validated explicit native resume against Claude Code 2.1.209 and Codex CLI
+  0.144.4 in the pinned Docker image.

session_migrate-0.5.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xhluca
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

session_migrate-0.5.1/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.5
+Name: session-migrate
+Version: 0.5.1
+Summary: Convert Claude, Codex, and Pi sessions to supported native agent targets
+Project-URL: Homepage, https://session-migrate.team-reddy-mila.chatgpt.site
+Project-URL: Repository, https://github.com/xhluca/session-migrate
+Project-URL: Documentation, https://github.com/xhluca/session-migrate/tree/main/docs
+Project-URL: Issues, https://github.com/xhluca/session-migrate/issues
+Author: xhluca
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude,codex,copilot,opencode,pi,session-migration
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+<h1 align="center"><a href="https://session-migrate.team-reddy-mila.chatgpt.site">↝ session-migrate</a></h1>
+
+<p align="center"><strong>Carry the conversation forward.</strong></p>
+
+<p align="center">
+  <a href="https://pypi.org/project/session-migrate/"><img src="https://img.shields.io/pypi/v/session-migrate?style=flat-square&color=b8f94a&label=PyPI" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/session-migrate/"><img src="https://img.shields.io/pypi/pyversions/session-migrate?style=flat-square" alt="Python versions"></a>
+  <a href="https://github.com/xhluca/session-migrate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-8dbdff?style=flat-square" alt="MIT license"></a>
+  <a href="https://session-migrate.team-reddy-mila.chatgpt.site"><img src="https://img.shields.io/badge/website-live-b8f94a?style=flat-square" alt="Project website"></a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/xhluca/session-migrate/main/docs/assets/demo.gif" alt="session-migrate converting a Claude Code session into a native Codex session" width="860">
+</p>
+
+<p align="center">
+  Move local coding-agent sessions between <strong>Claude Code</strong>,
+  <strong>Codex</strong>, <strong>Pi</strong>, <strong>OpenCode</strong>, and
+  <strong>GitHub Copilot CLI</strong>.
+</p>
+
+## Install
+
+```bash
+uv tool install session-migrate
+```
+
+No `uv`? Use the standalone installer:
+
+```bash
+curl -LsSf https://raw.githubusercontent.com/xhluca/session-migrate/main/install.sh | sh
+```
+
+`pipx install session-migrate` works too. Python 3.11+ and Linux are currently
+supported. The full command is `session-migrate`; `smigrate` is the shorthand.
+
+## Quick start
+
+Inspect any native transcript without printing its conversation:
+
+```bash
+smigrate inspect ~/.claude/projects/-work/SESSION.jsonl
+```
+
+Move a Claude session into Codex and resume it from the same project directory:
+
+```bash
+smigrate transfer SESSION_UUID --from claude --to codex --cwd "$PWD"
+codex resume NEW_SESSION_UUID
+```
+
+Or find an older session by title first:
+
+```bash
+smigrate catalog refresh
+smigrate catalog search "authentication refactor"
+smigrate transfer --catalog-id RESULT_ID --to pi
+```
+
+## Compatibility
+
+| Source ↓ / Target → | Claude | Codex | Pi | OpenCode | Copilot |
+| --- | :---: | :---: | :---: | :---: | :---: |
+| Claude Code | — | ✓ | ✓ | ✓ | ✓ |
+| Codex | ✓ | — | ✓ | ✓ | ✓ |
+| Pi | ✓ | ✓ | — | ✓ | ✓ |
+
+Claude, Codex, and Pi are sources and targets. OpenCode and Copilot are
+currently target-only. Same-format migration is intentionally rejected.
+Antigravity and Cursor remain fail-closed until they expose supported transcript
+import APIs.
+
+## What survives
+
+- User and assistant messages, in order
+- Tool calls and their linked results
+- Supported inline images
+- Portable compaction summaries
+- Native session identity, discovery, and resume metadata
+
+Anything target-specific is counted in a content-free migration manifest. The
+source session is never modified.
+
+## How it works
+
+```text
+native session → validated event timeline → native target → resume
+```
+
+Each reader projects a versioned native transcript into a small ordered model.
+Each writer then emits only structures verified against the target CLI. This is
+session migration, not text export: the target receives a discoverable,
+resumable native session.
+
+## More
+
+- [CLI reference](https://github.com/xhluca/session-migrate/blob/main/docs/cli-reference.md)
+- [Session catalog](https://github.com/xhluca/session-migrate/blob/main/docs/session-catalog.md)
+- [Compatibility details](https://github.com/xhluca/session-migrate/blob/main/docs/format-compatibility.md)
+- [Troubleshooting](https://github.com/xhluca/session-migrate/blob/main/docs/troubleshooting.md)
+- [Format research and validation](https://github.com/xhluca/session-migrate/blob/main/docs/validation-report.md)
+- [Data handling and architecture](https://github.com/xhluca/session-migrate/blob/main/docs/architecture.md)
+
+The demo above is generated by the real CLI from synthetic, credential-free
+fixtures. [Watch the MP4](https://github.com/xhluca/session-migrate/raw/main/docs/assets/demo.mp4)
+or [reproduce it](https://github.com/xhluca/session-migrate/blob/main/scripts/render-demo.sh).
+
+<a href="https://session-migrate.team-reddy-mila.chatgpt.site">
+  <img src="https://raw.githubusercontent.com/xhluca/session-migrate/main/docs/assets/landing.png" alt="session-migrate project website" width="860">
+</a>
+
+## Contributing
+
+```bash
+git clone https://github.com/xhluca/session-migrate.git
+cd session-migrate
+uv sync --dev
+uv run pytest
+```
+
+See [the development guide](https://github.com/xhluca/session-migrate/blob/main/docs/development.md)
+before changing a native
+adapter. New formats need sanitized fixtures and a real native-resume oracle.
+
+## License
+
+[MIT](https://github.com/xhluca/session-migrate/blob/main/LICENSE)

session_migrate-0.5.1/README.md

@@ -0,0 +1,127 @@
+<h1 align="center"><a href="https://session-migrate.team-reddy-mila.chatgpt.site">↝ session-migrate</a></h1>
+
+<p align="center"><strong>Carry the conversation forward.</strong></p>
+
+<p align="center">
+  <a href="https://pypi.org/project/session-migrate/"><img src="https://img.shields.io/pypi/v/session-migrate?style=flat-square&color=b8f94a&label=PyPI" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/session-migrate/"><img src="https://img.shields.io/pypi/pyversions/session-migrate?style=flat-square" alt="Python versions"></a>
+  <a href="https://github.com/xhluca/session-migrate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-8dbdff?style=flat-square" alt="MIT license"></a>
+  <a href="https://session-migrate.team-reddy-mila.chatgpt.site"><img src="https://img.shields.io/badge/website-live-b8f94a?style=flat-square" alt="Project website"></a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/xhluca/session-migrate/main/docs/assets/demo.gif" alt="session-migrate converting a Claude Code session into a native Codex session" width="860">
+</p>
+
+<p align="center">
+  Move local coding-agent sessions between <strong>Claude Code</strong>,
+  <strong>Codex</strong>, <strong>Pi</strong>, <strong>OpenCode</strong>, and
+  <strong>GitHub Copilot CLI</strong>.
+</p>
+
+## Install
+
+```bash
+uv tool install session-migrate
+```
+
+No `uv`? Use the standalone installer:
+
+```bash
+curl -LsSf https://raw.githubusercontent.com/xhluca/session-migrate/main/install.sh | sh
+```
+
+`pipx install session-migrate` works too. Python 3.11+ and Linux are currently
+supported. The full command is `session-migrate`; `smigrate` is the shorthand.
+
+## Quick start
+
+Inspect any native transcript without printing its conversation:
+
+```bash
+smigrate inspect ~/.claude/projects/-work/SESSION.jsonl
+```
+
+Move a Claude session into Codex and resume it from the same project directory:
+
+```bash
+smigrate transfer SESSION_UUID --from claude --to codex --cwd "$PWD"
+codex resume NEW_SESSION_UUID
+```
+
+Or find an older session by title first:
+
+```bash
+smigrate catalog refresh
+smigrate catalog search "authentication refactor"
+smigrate transfer --catalog-id RESULT_ID --to pi
+```
+
+## Compatibility
+
+| Source ↓ / Target → | Claude | Codex | Pi | OpenCode | Copilot |
+| --- | :---: | :---: | :---: | :---: | :---: |
+| Claude Code | — | ✓ | ✓ | ✓ | ✓ |
+| Codex | ✓ | — | ✓ | ✓ | ✓ |
+| Pi | ✓ | ✓ | — | ✓ | ✓ |
+
+Claude, Codex, and Pi are sources and targets. OpenCode and Copilot are
+currently target-only. Same-format migration is intentionally rejected.
+Antigravity and Cursor remain fail-closed until they expose supported transcript
+import APIs.
+
+## What survives
+
+- User and assistant messages, in order
+- Tool calls and their linked results
+- Supported inline images
+- Portable compaction summaries
+- Native session identity, discovery, and resume metadata
+
+Anything target-specific is counted in a content-free migration manifest. The
+source session is never modified.
+
+## How it works
+
+```text
+native session → validated event timeline → native target → resume
+```
+
+Each reader projects a versioned native transcript into a small ordered model.
+Each writer then emits only structures verified against the target CLI. This is
+session migration, not text export: the target receives a discoverable,
+resumable native session.
+
+## More
+
+- [CLI reference](https://github.com/xhluca/session-migrate/blob/main/docs/cli-reference.md)
+- [Session catalog](https://github.com/xhluca/session-migrate/blob/main/docs/session-catalog.md)
+- [Compatibility details](https://github.com/xhluca/session-migrate/blob/main/docs/format-compatibility.md)
+- [Troubleshooting](https://github.com/xhluca/session-migrate/blob/main/docs/troubleshooting.md)
+- [Format research and validation](https://github.com/xhluca/session-migrate/blob/main/docs/validation-report.md)
+- [Data handling and architecture](https://github.com/xhluca/session-migrate/blob/main/docs/architecture.md)
+
+The demo above is generated by the real CLI from synthetic, credential-free
+fixtures. [Watch the MP4](https://github.com/xhluca/session-migrate/raw/main/docs/assets/demo.mp4)
+or [reproduce it](https://github.com/xhluca/session-migrate/blob/main/scripts/render-demo.sh).
+
+<a href="https://session-migrate.team-reddy-mila.chatgpt.site">
+  <img src="https://raw.githubusercontent.com/xhluca/session-migrate/main/docs/assets/landing.png" alt="session-migrate project website" width="860">
+</a>
+
+## Contributing
+
+```bash
+git clone https://github.com/xhluca/session-migrate.git
+cd session-migrate
+uv sync --dev
+uv run pytest
+```
+
+See [the development guide](https://github.com/xhluca/session-migrate/blob/main/docs/development.md)
+before changing a native
+adapter. New formats need sanitized fixtures and a real native-resume oracle.
+
+## License
+
+[MIT](https://github.com/xhluca/session-migrate/blob/main/LICENSE)