Skip to content

Add direct Compilation output - #29

Merged
raghubetina merged 3 commits into
mainfrom
codex/compile-output-directory
Aug 28, 2026
Merged

Add direct Compilation output#29
raghubetina merged 3 commits into
mainfrom
codex/compile-output-directory

Conversation

@raghubetina

@raghubetina raghubetina commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add firstdraft plan compile --output <absent-directory> as a direct local materialization mode
  • preserve the existing no-flag GitHub Publication journey and URL-only stdout
  • reuse the verified artifact parser and atomic materializer without adding .git, formatting, repair, overwrite, or merge behavior
  • prepare backward-compatible CLI candidate 0.2.1 because published 0.2.0 is immutable

Contract

  • preflight the explicit absent destination before Plan mutation and check it again after Analysis
  • recheck exact local Plan bytes and saved Head state before one bodyless, conditional Compilation POST
  • never retry an ambiguous Compilation start; classify validated 408 and 5xx responses as outcome unknown
  • after a validated 202, include the last validated retained Compilation in every recoverable status, artifact, authentication, or materialization failure
  • recover through compilation status and compilation download; after a wait timeout, check current.compilation.id with the read-only status command rather than rerunning Compile
  • pin retained identity, transitions, provenance, artifact, bytes, and modes
  • keep --output . and automatic design-file relocation outside this packet

Verification

  • npm run check
  • 167 unit and protocol tests passed
  • npm audit --audit-level=low reports zero vulnerabilities
  • packed-package smoke proves no-flag Compile makes one Publication and zero direct Compilation starts, while output mode makes one direct Compilation start and no additional Publication

Exact candidate

  • base a251df7870491d5b9bdc390c27373933563f99fd
  • base tree cdc2bd1eaf4b6d1ccb3b701fa295afee672a723b
  • initial reviewed head f5e6641f982ffa2b6eb1f50d5230847b86b59ced
  • recovery amendment 12637857836ad0edd184fe636846bfa807bdb26b
  • head 89ca49b3046ae86e540886868887eb0e60970ad5
  • head tree e62ee3ff1fb6d188c5d2c5a6e5e0efd50b40245f

Let agents materialize the exact reviewed Compilation into an absent local directory without requiring GitHub publication. Preserve the existing no-flag publication journey and make ambiguous Compilation starts non-retryable.
@raghubetina
raghubetina marked this pull request as ready for review August 28, 2026 17:29
@raghubetina
raghubetina merged commit d38ef3e into main Aug 28, 2026
4 checks passed
@raghubetina
raghubetina deleted the codex/compile-output-directory branch August 28, 2026 17:29
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