Skip to content

Deduplicate artifact, evidence, and runtime-reference helpers #377

Description

@chubes4

Goal

Put artifact/evidence/reference concepts in their right places so callers do not need to learn several near-duplicate helper families.

Current Problem

The cleanup introduced clearer modules, but artifact bundle, evidence, manifest, runtime reference, and CLI evidence helpers still span CLI, runtime-core, and runtime-playground. Some concepts overlap and need a crisp ownership map.

Target Shape

  • Runtime-core owns portable contracts and generic helpers.
  • Runtime-playground owns Playground-specific capture/build behavior.
  • CLI owns presentation, recipe evidence orchestration, and command output only.
  • Shared hashing/manifest helpers have one owner.

Acceptance Criteria

  • Identify duplicated helper shapes and consolidate high-confidence duplicates.
  • Do not create vague utils.ts dumping grounds.
  • Preserve artifact formats and verifier behavior.
  • Build, artifact contract, artifact bundle verifier, package distribution, and relevant recipe evidence smokes pass.

AI assistance

  • AI assistance: Yes
  • Tool(s): OpenCode (openai/gpt-5.5)
  • Used for: Drafting this tracker from the current architecture cleanup state.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions