Skip to content

Correct EventModeling dependency provenance and qualify its kernel image pairing #674

Open

Description

@woksin

Problem

Two EventModeling READMEs describe dependency versions that differ from the versions actually selected by central package management.

At f3234f8effd30adfe457becd790bb68cbf127ba8:

This makes package provenance misleading and leaves the client/kernel pairing unqualified. Different version numbers alone do not prove a runtime failure; none was reproduced.

Expected outcome

Correct both READMEs and clearly distinguish central application packages, local tool pins and the server image. Prefer links to the central source of truth over repeatedly copied version tables. Align the server image with a demonstrated compatible client release, or document evidence for the retained pairing instead of silently treating it as qualified.

Do not downgrade packages to match stale prose or upgrade intentionally pinned generation tools solely because they are old. Historical issue #622 and merged PR #623 establish original delivery, not correction of this current drift.

Activity

  1. self-assigned this
    on Nov 2, 2026
  2. woksin commented on Nov 2, 2026

    @woksin
    CollaboratorAuthor

    Implementation design (rev 1)

    Base: f3234f8 (main, 2026-11-02)
    Status: proposed
    Size / release intent: S · patch
    Reviewed: independent Claude reviewer — README/central/image discrepancies confirmed; no runtime-failure claim

    Problem and root cause

    FromMartenAndWolverine README duplicates stale9.45/6.45 versions instead of central9.49/6.49. ArcRuntimeView similarly describes22.50.4/19.31.10 while central selects22.156.4/19.115.3; its server really remains19.31.10-development.

    Approach

    Make package provenance truthful and make the server pairing explicit. Prefer links to central declarations over duplicated version literals. Do not infer incompatible behavior merely from different version numbers.

    Steps

    1. Drift-check both READMEs, central props, project references and image.
    2. Correct package statements, separating application, tool and server versions.
    3. Either align the server image to a verified compatible release and prove its walkthrough, or explicitly document the retained pairing as unqualified until evidence exists.
    4. Keep intentionally pinned CLI/Screenplay tools unless a separately justified migration is required.

    Files to touch

    EventModeling/FromMartenAndWolverine/README.md, EventModeling/ArcRuntimeView/README.md; ArcRuntimeView Compose only if intentionally qualifying a new image.

    Public API, compatibility, migration

    No intended API change. Any image change is a separate compatibility-affecting part of the same issue, not an incidental prose edit.

    Performance

    None for documentation. Use bounded acceptance waits if image changes.

    Specs to add (red first)

    Check documented provenance against central declarations. An image change requires the relevant startup/event-model walkthrough, not only compilation.

    Gate (exact commands from the repo's CI)

    Documentation-only correction: static comparison to props/project/image and catalog validation yarn samples:validate where applicable. If image/runtime behavior changes, existing build gates include:

    dotnet restore Samples.slnx
    dotnet build Samples.slnx --configuration Debug --no-restore
    dotnet restore Samples.slnx -p:Configuration=Release
    dotnet build Samples.slnx --configuration Release --no-restore -p:CratisProxiesOutputPath=

    These commands do not alone prove the walkthrough against the image; add bounded targeted acceptance when changing the pair. No commands executed for this design.

    Done when

    • Both READMEs accurately distinguish package/tool/server provenance.
    • Server pairing is qualified or explicitly labeled unqualified, not silently assumed.
    • No dependency downgrade or unjustified tool upgrade accompanies prose repair.

    Risks and open questions

    Image publication and runtime compatibility remain unverified; do not label the existing pair broken without reproduction.

    Out of scope

    Generated Shop refresh, broad dependency updates and historical delivery issues.

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

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions