nexu-io/open-design · error · SystemExit

job {job_id} has no {field}

Error message

job {job_id} has no {field}

What it means

manifest_path() requires every completed job to have a non-empty source_path and output_path string in imagegen-jobs.json. The {field} in the message is whichever of source_path or output_path is missing. Without both, finalize cannot locate the files to hash-check provenance.

Source

Thrown at skills/hatch-pet/scripts/finalize_pet_run.py:52

def is_relative_to(path: Path, root: Path) -> bool:
    try:
        path.relative_to(root)
    except ValueError:
        return False
    return True


def default_generated_images_root() -> Path:
    return default_codex_home() / "generated_images"


def default_codex_home() -> Path:
    return Path(os.environ.get("CODEX_HOME") or "~/.codex").expanduser().resolve()


def manifest_path(raw: object, *, run_dir: Path, field: str, job_id: str) -> Path:
    if not isinstance(raw, str) or not raw:
        raise SystemExit(f"job {job_id} has no {field}")
    path = Path(raw).expanduser()
    if not path.is_absolute():
        path = run_dir / path
    return path.resolve()


def validate_hash(job: dict[str, object], *, source: Path, output: Path, job_id: str) -> None:
    expected_hash = job.get("source_sha256")
    if not isinstance(expected_hash, str) or not expected_hash:
        raise SystemExit(
            f"job {job_id} is missing source_sha256; ingest visual outputs with "
            "record_imagegen_result.py instead of editing imagegen-jobs.json"
        )
    if not source.is_file():
        raise SystemExit(f"job {job_id} source image no longer exists: {source}")
    if not output.is_file():
        raise SystemExit(f"job {job_id} decoded output is missing: {output}")
    source_hash = file_sha256(source)

View on GitHub (pinned to 5be4028344)

Solutions

  1. Re-ingest the job with record_imagegen_result.py, which populates source_path and output_path.
  2. If editing manually, ensure both source_path and output_path are non-empty strings (absolute, or relative to run_dir).
  3. Re-run finalize_pet_run.py.

Example fix

// before
{ "id": "idle", "status": "complete", "source_path": "" }
// after
{ "id": "idle", "status": "complete", "source_path": "<generated_images>/ig_xxx.png", "output_path": "decoded/idle.png" }
Defensive patterns

Strategy: type-guard

Validate before calling

import json
from pathlib import Path

manifest = json.loads(Path("<run_dir>/imagegen-jobs.json").read_text())
for job in manifest["jobs"]:
    if job.get("status") == "complete":
        for field in ("source_path", "output_path"):
            assert isinstance(job.get(field), str) and job[field], f"job {job.get('id')} has no {field}"

Type guard

def job_has_paths(job: dict) -> bool:
    return all(isinstance(job.get(f), str) and job[f] for f in ("source_path", "output_path"))

Prevention

When it happens

Trigger: A job whose status is "complete" but whose source_path or output_path is absent, empty, or not a string in the manifest.

Common situations: Hand-editing imagegen-jobs.json instead of using record_imagegen_result.py; a partially-written manifest from a killed ingest; an older manifest format missing output_path.

Related errors


AI-assisted analysis of nexu-io/open-design@5be4028344 (2026-08-12). Data as JSON: /api/errors/1d1fd4212dcefd4e. Report an issue: GitHub.