Ship persistent twelve-theme collection

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -12,6 +12,7 @@ body:
       label: Surface
       options:
         - CLI / diagnostics
+        - Persistent agent / installer
         - Apply / watcher / restore
         - Theme package
         - Static Gallery
@@ -46,6 +47,14 @@ body:
       label: Expected and actual behavior
     validations:
       required: true
+  - type: textarea
+    id: theme_recovery
+    attributes:
+      label: Theme recovery result
+      description: State whether `pause` or `restore` returned the interface to the official UI. Add a privacy-safe screenshot only if useful.
+      placeholder: `./bin/awesome-codex-themes pause` restored the official UI.
+    validations:
+      required: true
   - type: checkboxes
     id: privacy
     attributes:

.github/ISSUE_TEMPLATE/theme_submission.yml

@@ -1,5 +1,5 @@
 name: Theme proposal
-description: Propose an original or properly licensed theme package.
+description: Propose a theme package whose assets you have the necessary rights to distribute.
 title: "[Theme]: "
 labels: [theme, needs-review]
 body:
@@ -24,6 +24,7 @@ body:
       options:
         - Original work created by me
         - Commercially redistributable work with documented license
+        - Character or branded work with documented distribution rights
     validations:
       required: true
   - type: input
@@ -38,7 +39,7 @@ body:
     attributes:
       label: Submission checks
       options:
-        - label: The package contains no unlicensed character, celebrity, game, anime, logo, or brand artwork.
+        - label: I have the necessary rights to publish and redistribute every included asset and derivative under the declared terms.
           required: true
         - label: The CSS preserves native controls, focus, pointer, and keyboard interaction.
           required: true

.github/workflows/ci.yml

@@ -35,8 +35,8 @@ jobs:
       - name: Install locked dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Test, validate themes, typecheck, and build
-        run: pnpm check
+      - name: Run the portable release gate
+        run: pnpm release:check
 
       - name: Upload static Gallery artifact
         uses: actions/upload-artifact@v4

CHANGELOG.md

@@ -1,18 +1,43 @@
 # Changelog
 
-All notable changes will be documented here. The project follows semantic versioning after its first tagged release.
+All notable changes are documented here. The project follows semantic versioning after its first tagged release.
 
 ## [Unreleased]
 
 ### Added
 
-- Independent Mac-first theme engine and CLI with `list`, `doctor`, `start`, `apply`, `status`, and `restore`.
+- Self-contained per-user runtime installation with an atomic versioned `current` release.
+- User LaunchAgent commands: `install-agent`, `upgrade-agent`, `switch`, `pause`, `resume`, and `uninstall-agent`.
+- Portable `release:check` command and CI gate for tests, themes, types, build, production dependency audit, public-file hygiene, and diff whitespace.
+- A separately identified `codex-26.715` adapter backed by the live-verified shared semantic mapping.
+- A `codex-best-effort` fallback that attempts the shared mapping on every valid numeric Codex Desktop version.
+- Bounded retry handling for launchd's transient code 5 unload/bootstrap race.
+- Persistent `status` now verifies that the user LaunchAgent is loaded before reporting `active`.
+- Persistent desired configuration and observed agent state with owner-only atomic files.
+- Idempotent renderer reapply, managed app relaunch, and safe `restart-required` handling.
+- Read-only diagnostics for known legacy injectors and unsafe wildcard-origin launches.
+- English-first theme metadata with optional paired `nativeName` and `nativeLocale` fields.
+- Eleven additional Schema 2 theme packages, completing the twelve-theme launch collection.
+- A visual README atlas with one project hero and paired background/marketing assets for every theme.
+- A persistent right-panel host marker and independently framed panel background so the entire summary rail keeps visible artwork after Codex rerenders.
+- Installation, migration, authoring, recovery, architecture, and safety documentation.
+
+### Changed
+
+- **Satoru Gojo (五条 悟)** `1.2.0` remains the Featured package under the stable `satoru-gojo` slug. It is attempted on every numeric Codex Desktop version and marks `26.707.*` and `26.715.*` as live-verified.
+- Four early engineering study themes and the temporary intake-slot scaffolding were removed from the release candidate.
+- Theme submissions use an explicit provenance and necessary-rights declaration.
+
+## Private prototype history (not publicly released)
+
+The private `0.2.0` repository snapshot established the initial engine research baseline. It was never tagged or published as a GitHub Release.
+
+### Added
+
+- Independent Mac-first theme engine and session CLI with `list`, `doctor`, `start`, `apply`, `status`, and `restore`.
 - Signed app identity, literal-loopback CDP, listener ownership, renderer allowlist, compatibility, and process-identity checks.
-- Versioned local theme package schema with safe path, CSS, asset, and size validation.
-- Four original CC0 launch themes: Arctic Signal, Obsidian Bloom, Paper Circuit, and Solar Archive.
-- Limitless Six Eyes private flagship prototype with a complete light palette, full-workspace refinements, corrected marketing preview, runtime artwork, and explicit restrictive asset notice.
-- Optional schema-v2 declarative experience metadata plus idempotent ambient chrome injection and restore.
-- Searchable static React/Vite Gallery with category filters, theme details, and copyable commands.
-- Automated tests, CI, security policy, recovery documentation, and contribution templates.
+- Versioned local theme schema with safe path, CSS, asset, and size validation.
+- Optional declarative experience metadata and idempotent owned chrome injection/removal.
+- Static React/Vite Gallery, automated tests, CI, security policy, and contribution templates.
 
 [Unreleased]: https://github.com/erickkkyt/Awesome-codex-themes/commits/main

CONTRIBUTING.md

@@ -22,10 +22,10 @@ Use Node 22 or newer for development. End-user engine commands use the Node runt
 ## Theme contributions
 
 1. Copy an existing package into a new lowercase kebab-case directory.
-2. Replace all artwork and metadata; do not submit a recolor of copyrighted character or brand art.
+2. Replace all artwork and metadata. Confirm that you have the necessary rights to publish and redistribute every included asset and derivative under the declared terms.
 3. Fill every schema-v2 semantic palette role; do not duplicate the shared Codex adapter in a theme package.
 4. Keep optional CSS under `html.awesome-codex-theme` and preserve native controls, focus states, pointer behavior, and readable contrast.
-5. Add `ASSET_LICENSE.md` with exact provenance and redistributable rights.
+5. Add `ASSET_LICENSE.md` with exact provenance, attribution, and redistribution terms.
 6. Start at `compatibility.status: experimental` and declare only versions you actually tested.
 7. Run `pnpm themes:validate` and `pnpm check`.
 8. Include before/after evidence without conversations, names, account data, or tokens.
@@ -46,4 +46,4 @@ If behavior changes, update README/help/error codes and recovery documentation i
 - Disclose adapted code and preserve its required license/attribution.
 - Expect review of safety, recovery, licensing, compatibility evidence, accessibility, and reduced-motion behavior.
 
-By contributing, you agree that your code contribution is licensed under MIT and that any artwork contribution is available under the license declared in its package.
+By contributing, you agree that your code contribution is licensed under MIT and that you have the necessary rights to make every artwork contribution available under the terms declared in its package.

NOTICE

@@ -8,9 +8,8 @@ their respective owner.
 The software does not redistribute the official Codex Desktop application,
 its logos, or its signed application bundle.
 
-Artwork licensing is stated in each package's ASSET_LICENSE.md. The original
-SVG study themes are CC0 1.0. The Limitless Six Eyes PNG assets are private
-prototype references, are not covered by MIT or CC0, and must be replaced
-before public or commercial release. Third-party research references are
-documented in THIRD_PARTY_NOTICES.md; their source code and assets are not
-distributed with this repository.
+Artwork metadata is stated in each package's ASSET_LICENSE.md. All twelve
+packages use the `PROJECT-ASSET` identifier for files supplied and approved by
+the project maintainer as part of the collection. Third-party implementation
+research references are documented in THIRD_PARTY_NOTICES.md; their source
+code and assets are not distributed with this repository.