Skip to content

Add portable fork workflows and native session creation - #3

Merged
krishhgg merged 6 commits into
mainfrom
feat/portable-fork-core
Sep 24, 2026
Merged

krishhgg merged 6 commits into
mainfrom
feat/portable-fork-core

Conversation

@krishhgg

@krishhgg krishhgg commented Sep 24, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • Add a shared controller for portable attachment, task-specific dynamic context, and actual native Codex/Claude child sessions.
  • Preserve paired public tool evidence, freeze completed boundaries, and disclose omissions. Keep T3 as an optional source adapter.
  • Publish the approved README and diagrams together with their implementation; move historical benchmarks to a separate document.

Verification

  • 56 tests passed on Python 3.12 and Python 3.9, with real Codex and Claude native smoke tests enabled.
  • JavaScript syntax, skill validation, and diff whitespace checks passed.
  • Opus 5.5 at high reviewed the implementation; findings were fixed and its final review approved.

Limits

  • Portable attachment is not a lossless cross-provider clone.
  • Native creation does not create worktrees or register a new T3 UI thread.
  • Dynamic context remains experimental; no generalized speed, cost, or output-quality claim.

This PR includes the documentation preview previously published on docs/readme-preview.

RetriggerConfidence Score: 5/5

The PR appears safe to merge; the prior Node support mismatch is fully resolved and no new actionable issue was identified.

Summary

This PR adds a shared controller for portable conversation attachment, frozen and paginated history snapshots, dynamic context packaging, and native Codex and Claude child-session creation.

  • Adds source-specific history adapters with completed-boundary handling, public tool evidence, omission reporting, and secret-like record screening.
  • Adds verified native fork adapters for Codex app-server and the Claude Agent SDK.
  • Expands automated and opt-in integration coverage across supported Python versions, Node 20, Linux, and macOS.
  • Updates the skill contract, workflow documentation, diagrams, and README while separating historical benchmark results.
  • The previously reported Node compatibility mismatch is fixed consistently across code, lockfile, CI, and documentation.
Diagram
%%{init: {'theme': 'neutral'}}%%
flowchart LR
  ID[Conversation ID] --> Resolve[Resolve source and completed boundary]
  Resolve --> Route{Requested route}
  Route -->|Attach| Snapshot[Create private frozen snapshot]
  Snapshot --> Pages[Read or retrieve verified pages]
  Pages --> Current[Continue in current chat]
  Route -->|Native| Plan[Plan provider-native fork]
  Plan --> Execute[Execute explicit fork request]
  Execute --> Child[Return verified child ID and resume command]
  Route -->|Dynamic| Select[Validate agent-selected records]
  Select --> Bundle[Create recoverable context bundle]
Loading

Reviews (2) · Last reviewed commit: "Require Node 20 for the locked Claude SD..."

Comment thread skills/fork/package.json Outdated
@krishhgg
krishhgg merged commit 87ec5b3 into main Sep 24, 2026
7 checks passed
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