v0.1.1

v0.1.1 Release Notes

Status: published as v0.1.1
Target: stability, recovery, animation workflow, and public-facing polish after v0.1.0

Image Cockpit for Codex Workflows v0.1.1 is a stabilization and workflow expansion release. It keeps the project local-first and Codex-oriented, while making the image and animation cockpit easier to recover when local browser state, Codex jobs, or returned artifacts get messy.

Feature scope for this draft is the current main stabilization range after v0.1.0, including the Cockpit health repair supervisor and bronze-candidate duplicate import prevention merged before the v0.1.1 release-prep main integration.

Highlights

• Added a safe local recovery mode at http://127.0.0.1:<port>/?safe=1 so the app can start without loading heavy saved browser state.
• Added a static local reset page at http://127.0.0.1:<port>/reset-local-state.html for clearing Image Cockpit browser-side state without deleting repository files or codex-handoff/outbox artifacts.
• Added Cockpit health diagnostics and fixed local repair actions for API/Vite target mismatches.
• Added result recovery and Local Inbox dedupe controls so returned artifacts can be re-imported without manually inspecting ports or processes.
• Moved large history and frame state toward IndexedDB-backed persistence with lightweight localStorage summaries to reduce Out of Memory risk.
• Added a recovery screen and storage preflight for oversized local state.
• Improved Image Editing source-image fitting, annotation coordinates, and full-body / no-crop handoff prompts.
• Raised Codex generation concurrency to 3 active jobs.
• Increased the visible Codex log cards to match the 3-job concurrency limit and improved latest-line following.
• Added fullscreen Codex log viewing.
• Hardened completed Codex job imports so failed imports do not stay stuck as running jobs.
• Added retryable import failure handling for Codex handoff results.
• Hardened direction-split animation artifact staging with verified publish behavior.
• Excluded temporary, staging, contact-sheet, debug, and QA artifacts from normal Local Inbox imports.
• Added public launch materials, refreshed README screenshots, and updated the demo GIF for the current UI.

Animation Workflow

• Added direction-split animation generation with 5-direction previews.
• Added GIF-first animation previews in the main preview area.
• Added selected-result-aware downloads for still images and animation artifacts.
• Added local animation library pack import/export foundations.
• Added official animation preset sheets and QA artifacts.
• Expanded official preset coverage to 16 sample sheets, including idle, walk, run, talk, death/downed, basic attack, hurt reaction, spell cast, jump/hop, guard/block, victory cheer, interact/pickup, ranged attack, item use, knockback, and skill release.
• Improved transparency and chroma-key handling for official animation samples.
• Added transparency audits, mechanical QA artifacts, direction GIFs, and QA galleries for official animation presets.
• Improved walk/run alignment and direction clarity in preset samples.

Pixel Art And Prompt Examples

• Added a prompt examples modal with preview images and downloads.
• Added basic character prompt examples.
• Added profession-oriented character prompt examples.
• Added monster prompt examples.
• Added generated preview assets for prompt example cards.
• Added public-facing docs and assets for X/Twitter launch.

UI And UX

• Removed the guided-start screen so the app opens directly into the working cockpit.
• Simplified workflow controls and reduced low-priority visual clutter.
• Improved selected result preview behavior.
• Restored and tightened preview toolbar layout.
• Moved Codex job status above the results list for better scanning.
• Improved static result preview fit.
• Kept animation final artifacts from being accidentally treated as editable image sources.
• Unified preview and download behavior across workflows.
• Added broader locale coverage beyond the initial Japanese/English baseline.

Reliability And Local Workflow

• Job completion detection now uses exact job IDs to avoid importing unrelated results.
• Auto-import behavior for Codex results is stricter about matching the active job.
• Stale Codex runner jobs are handled more gracefully.
• Direction-split imports now wait for usable manifest and verified artifacts instead of treating partial files as complete.
• Partial, staging, temporary, work, and QA files are filtered out from normal result import paths.
• A loopback-only dev supervisor can diagnose and repair local API/Vite alignment without accepting arbitrary browser commands.
• Local Inbox imports now use stable import keys and exact duplicate cleanup so unchanged bronze-candidate snapshots do not grow history repeatedly.
• Recover Results can import eligible unimported formal PNG outbox results while preserving outbox files.
• Browser-based smoke coverage was expanded for workspace tabs, prompt examples, animation presets, language switching, download flows, and local state recovery.
• Real-imagegen and real-Codex smoke documentation was added where supported by the local environment.

Documentation

• Refreshed README screenshots for Pixel Art Generation, Prompt Examples, Image Editing, and Animation Generation.
• Updated demo GIF capture tooling with npm run capture:readme.
• Added QA documentation for job concurrency, Codex log behavior, generation reliability, artifact staging, storage recovery, image edit full-body fitting, temporary artifact filtering, Cockpit health repair, Local Inbox dedupe, and v0.1.1 release prep.
• Added release-audit coverage for the newer public-facing assets and workflow checks.

Local-First Boundary

The app still does not call OpenAI APIs directly and does not require an API key. It writes local handoff files for Codex, the user, or another local workflow to process.

No model weights, API keys, tokens, generated handoff folders, or license-unclear sample assets are included in the repository.

Recovery Notes

If the app becomes slow, fails to load, or Chrome reports Out of Memory after many generated results:

http://127.0.0.1:<port>/?safe=1

Use safe mode to start without loading heavy saved Image Cockpit state.

http://127.0.0.1:<port>/reset-local-state.html

Use the reset page to clear Image Cockpit's browser-side local state.

These recovery routes do not delete generated PNG files, repository files, or codex-handoff/outbox artifacts.

Known Limitations

• Image generation still depends on the local Codex/imagegen environment available to the user.
• Direct OpenAI API, ComfyUI, AUTOMATIC1111, Replicate, and other provider adapters are still not part of the shipped baseline.
• Advanced game-engine exporters, full background removal, and deeper sprite QC remain future work.
• The dev supervisor is limited to local development repair operations and is not part of packaged builds.

Verification

Expected release verification path:

npm run verify
npm run ui:smoke

Recommended local review path on machines with a runnable Codex CLI:

npm run review:local

Pre-tag verification completed:

• package.json version is 0.1.1.
• package-lock.json version is 0.1.1.
• npm run verify passes.
• npm run ui:smoke passes.
• http://127.0.0.1:<port>/?safe=1 opens the safe recovery path.
• http://127.0.0.1:<port>/reset-local-state.html opens the reset page.
• The GitHub release text matches the actual commit being tagged.

v0.1.0

v0.1.0 Release Notes

Status: approved for v0.1.0 release
Target: first public release

Image Cockpit for Codex Workflows is an unofficial, local-first image production cockpit for Codex-era workflows. It focuses on four clear workflows:

1. Image generation
2. Image editing
3. Sprite sheet generation
4. Sprite sheet editing

Highlights

• Guided Start opens the app with one of the four primary workflows selected.
• Local Codex Handoff writes JSON jobs to codex-handoff/inbox/ and copies selected source images to codex-handoff/assets/.
• Local Inbox imports returned PNG, WebP, JPEG, or GIF files from codex-handoff/outbox/.
• The simplified workflow screen keeps Import Latest visible for manual handoff returns.
• Local-file workflows avoid duplicate import actions in the simplified control row.
• Desktop and mobile QA screenshots cover the simplified image generation screen with Import Latest visible.
• Manual handoff Browser QA covers a Codex runner unavailable state, a returned outbox image, and successful Import Latest import.
• Orphaned pending Codex jobs with missing runner status unlock instead of leaving the job button waiting forever.
• Optional codex exec autorun can launch the locally installed Codex command when the environment allows it.
• The default Codex runner command uses the current CLI shape: codex exec -c approval_policy="<approval>" --sandbox <sandbox> -.
• Optional JSON arg overrides support wrapper commands while preserving the same runner preflight and exec lifecycle.
• On Windows, the runner diagnostics report the requested command, selected launch command, and resolved paths, preferring the terminal-runnable %LOCALAPPDATA%\OpenAI\Codex\bin\...\codex.exe CLI when the WindowsApps desktop shim is also present.
• A real no-image runner smoke confirms the installed Codex CLI can complete a local handoff job and write a Markdown sidecar to outbox.
• Image generation jobs are prompt-focused and do not accidentally include edit source assets or annotations.
• Image editing jobs include the selected source image, edit notes, and canvas annotations.
• Sprite generation and sprite editing jobs preserve grid, action, and frame count context in handoff payloads.
• Sprite sheet tools cover grid split, timeline ordering, frame sizing, anchor editing, chroma key cleanup, and PNG / ZIP / GIF / metadata export.
• Japanese and English language selection is available from the global header, and the core workflow labels, canvas controls, sprite controls, and export actions follow the selected language.
• npm run verify runs the full local release-check path with one command.
• npm run ui:smoke runs a local browser smoke for Guided Start, the four workflow routes, action buttons, language switching, and sprite-edit controls.
• npm run codex:smoke can re-run the no-image installed-Codex runner completion check on local machines with a runnable Codex CLI.
• npm run review:local runs npm run verify, npm run ui:smoke, and npm run codex:smoke as one owner-review sweep on Codex-installed machines.
• npm run doctor checks the local setup, handoff folder writability, and Codex command availability.
• Manual handoff guide documents the inbox / assets / outbox workflow for environments where codex exec is unavailable.
• Acceptance evidence maps the four primary workflows, local-first boundary, manual handoff path, and release gates to concrete verification artifacts.
• Owner review guide gives the short path through review:local, manual workflow checks, and approval gates.
• Final audit maps the completion definition and explicit user requirements to evidence, while keeping merge, public visibility, tag, and release approval gates separate.
• Owner decision record separates private-MVP acceptance from the merge, public visibility, tag, and release approval gates.
• Release audit and smoke scripts check the local-first boundary, required docs, workflow IDs, handoff payloads, and Local Inbox imports.
• Smoke also checks a mock autorun runner reaching ready, running, completed, writing a PNG to the outbox, and importing that PNG.

Local-First Boundary

The app itself does not call OpenAI APIs directly and does not require an API key. It writes local handoff files for Codex, the user, or another local workflow to process.

No model weights, API keys, tokens, generated handoff folders, or license-unclear sample assets are included in the repository.

Known Limitations

• The real runner smoke is no-image only; image generation and image editing availability still depend on the user's Codex environment.
• Mock autorun smoke verifies Image Cockpit's runner lifecycle wiring, but it is not proof that the installed Codex executable itself can complete on a given machine.
• When Codex cannot be launched from the local server, the app falls back to manual handoff: create the job, process it externally, place image results in codex-handoff/outbox/, then import through Local Inbox.
• The first release intentionally avoids external adapters such as ComfyUI, AUTOMATIC1111, Replicate, or direct OpenAI API integrations.
• IndexedDB persistence, game-engine-specific exporters, advanced QC, and background removal are planned later and are not part of v0.1.0.

Verification

The release candidate is expected to pass:

npm run verify

Expanded verification path:

npm run doctor
npm run typecheck
npm test
npm run build
npm run smoke
npm run release:audit

See docs/release/v0.1.0-runbook.md and docs/release/v0.1.0-owner-decision.md for the confirmation-gated release procedure.