Skip to content

Rearchitect transactional generation and installation#35

Draft
lynnswap wants to merge 74 commits into
mainfrom
codex/privateheaderkit-rearchitecture
Draft

Rearchitect transactional generation and installation#35
lynnswap wants to merge 74 commits into
mainfrom
codex/privateheaderkit-rearchitecture

Conversation

@lynnswap

Copy link
Copy Markdown
Owner

Purpose

Complete the unfinished PrivateHeaderKit rewrite by assigning generation state, artifact publication, process lifecycle, and installation to explicit owners.

The previous implementation split state across JSON files, repositories, generated artifacts, CLI control flow, and mutable install locations. That made interruption recovery, cross-process coordination, and atomic upgrades ambiguous.

Changes

  • Replace the fragmented generation state path with a GRDB-backed actor store and monotonic state sequencing.
  • Publish immutable generations through atomic pointers, with explicit intent and recovery for filesystem and database boundaries.
  • Rebuild the CLI with swift-argument-parser and typed Core results.
  • Replace Foundation.Process wrappers with swift-subprocess, structured process-group teardown, cancellable output draining, and root-owned signal handling.
  • Install immutable version cohorts with atomic current switching, durable legacy migration recovery, release manifests, and checksum verification.
  • Add release build, package, installer rendering, and artifact verification workflows.
  • Remove obsolete state repositories, subprocess helpers, and unused file-operation layers.
  • Document the selected persistence, concurrency, installer, and recovery contracts.

Testing

  • Full Swift test suite: 230 tests across 30 suites passed.
  • Release products built successfully.
  • Release archive, checksum, temporary-prefix installation, active cohort selection, and tamper rejection smoke tests passed.
  • Shell scripts passed syntax validation.
  • GitHub Actions workflow passed actionlint v1.7.12.
  • Final full-diff Codex review reported no actionable findings.

lynnswap added 30 commits June 18, 2026 16:24
Add rewrite requirements, core generation skeleton, source discovery, state/resume contracts, target resolution, and managed artifact cleanup foundations.
lynnswap added 30 commits June 22, 2026 19:56
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