Skip to content

v0.1.0

Choose a tag to compare

View all tags
@dreiachse-cyber dreiachse-cyber released this 23 Jun 10:23
· 99 commits to main since this release
v0.1.0
0fc7034

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.

Assets 2
Loading