Zero-to-Receipt showcase, planning-state hygiene, and Windows fork fixes (#268) - #269
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Cherry-picked onto current
mainand integrated with v1.3.5:docs/SHOWCASE.md, the canonical Zero-to-Receipt Operation Fork journey, written against the exact shipped CLI contract (fork start|status|resume|compare|select|land plan|land apply|receipt verify --input|replay --output);docs/archive/; internal.planning/state local-only; packaging aligned with the governed release policy.-c windows.sandbox=elevatedinjected on win32 so forked Codex branches regain workspace-write;platformInvocationso.cmdshims (npm) spawn shell-free;FORK_LANDING_EMPTYblocks landings whose selected branch tip equals the base revision.Review blockers addressed
resolveEntrypointandnodePath, making it deterministic on every CI OS (same pattern as the existing codex shim fixture).citadel fork --helpexactly, including normalized fork ids, two-profile executor requirement, single-line objective title, revision-bound selection, clean-target landing tokens, and offline receipt verification flags. The interruption section states the real contract: interrupted branches are permanently blocked (RUNTIME_EFFECT_AMBIGUOUS) and recovery is a new fork — resume is containment, not continuation. The agent-commit boundary andFORK_LANDING_EMPTYare documented as a current limitation with the design question linked.Verification (rerun on this branch)
complete_gridgate remains honestly open pending the linux/darwin legs produced by this PR's CI matrix.docs/FINDINGS-run-2026-08-22.md) — first comparable run ended in a preserved tie with offline-verified receipts.Remaining (tracked in #268)
Commit-in-isolation design so agent work can actually land: Citadel-managed post-run commit step or worktree-local git metadata.