refactor: dataclasses cleanup — off-wire @dataclass removals, NamedTuple upgrades, frozen DispatchOptions

[lchoquel]

Summary

• Replaces stdlib @dataclass usage on off-wire data shapes with the lowest-churn correct form per site: plain NamedTuple upgrades for simple value tuples, and a frozen pydantic dataclass for DispatchOptions.
• Removes off-wire stdlib @dataclass decorators (Phases 1-4) and converts simple internal contexts (e.g. ReportingManager._EventLogContext) to NamedTuple.
• Migrates DispatchOptions to a frozen pydantic dataclass (Phases 5-6).
• Merges in dev (pathlib.Path refactor refactor: use pathlib.Path for filesystem path handling #948); the single conflict in pipelex/reporting/reporting_manager.py was resolved to combine the runtime Path import + Path(...) call-site wrapping with the _EventLogContext NamedTuple conversion.

Test plan

• make agent-check — ruff, Pyright (0 errors), Mypy (clean)
• make tb — boot/config sanity
• make agent-test — full unit suite passes

🤖 Generated with Claude Code

---

Summary by cubic

Cleans up off‑wire data shapes by removing stdlib @dataclass and making types explicit, and widens Temporal serialization so Pydantic dataclasses round‑trip with type preservation. Also pins kajson to 0.6.0 from PyPI.

• New Features

  • Pydantic dataclasses (incl. optionals/lists) now serialize via BaseModelPayloadConverter through kajson with type preservation.
  • Added regression tests for direct converter calls and an end‑to‑end workflow/activity round‑trip.

• Refactors

  • Replaced bare tuple returns with NamedTuple (StructureNameAndRefine, CrossPackageRef) and converted simple internal contexts to NamedTuple.
  • Migrated DispatchOptions to a frozen Pydantic dataclass; kept temporalio optional by binding RetryPolicy = Any at runtime.
  • Converted ErrorPagesReport and VariableReference to Pydantic dataclasses; CustomClassInfo and RegistrationFailure to frozen BaseModel.
  • Updated dependencies: pin kajson==0.6.0 from PyPI (dropped git source). Added wip/dataclass-refactor-story.html with context on form selection and the converter change.

^{Written for commit e724a17. Summary will update on new commits.}

[greptile-apps]

Greptile Summary

This PR cleans up internal data holder types and broadens Temporal payload conversion. The main changes are:

• Converts simple internal records to NamedTuple, frozen models, or pydantic dataclasses.
• Adds pydantic dataclass routing in the Temporal payload converter.
• Makes DispatchOptions frozen while keeping Temporal optional-dependency importability.
• Adds converter and workflow round-trip coverage for pydantic dataclass payloads.

Confidence Score: 4/5

This is close, but the dependency wiring should be fixed before merging.

• The code changes for the internal type conversions look behavior-preserving.

• The new Temporal dataclass path depends on kajson behavior that is only available through a sibling editable checkout.

• Normal installs can resolve a different kajson version than the one used by the new tests.

• pyproject.toml

• uv.lock

Important Files Changed

Filename	Overview
pipelex/temporal/temporal_data_converter.py	Adds pydantic dataclass detection and kajson-based Temporal serialization.
pipelex/temporal/config_temporal.py	Moves DispatchOptions to a frozen pydantic dataclass with a runtime optional-dependency fallback.
pyproject.toml	Adds an editable local kajson source while the runtime dependency still names kajson 0.5.0.
uv.lock	Locks kajson to an editable sibling checkout instead of a registry artifact.

Prompt To Fix All With AI

Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
pyproject.toml:58
**Avoid local dependency source** This PR adds Temporal support that depends on kajson 0.6.0 behavior, but the committed project metadata still declares `kajson==0.5.0` while overriding it with an editable `../kajson` checkout. A normal checkout of this repo without that sibling directory can fail to sync from the lockfile, and installs that follow the declared dependency can still get kajson 0.5.0, so the new dataclass payload path can run against the old serializer behavior. Please publish/bump the runtime dependency to the required kajson version and avoid committing the repo-local editable source as the way this feature is enabled.

_{Reviews (1): Last reviewed commit: "Merge branch 'dev' into refactor/Datacla..." | Re-trigger Greptile}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5c690f49ce

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[cubic-dev-ai]

1 issue found across 16 files

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>