Skip to content

Align the AI install contract with an actually published artifact #12

Description

@rmcdaniel

Status Summary

At main commit e2fee66bb83d01b9df54f436a753e524895130f3, the README calls 2.0.0-rc.9 the current release and tells consumers to require it. Package metadata also names the 2.0.0-rc.9 product train, while the Composer resolver smoke assigns that version to the checkout through a path-repository alias. Public Git tags and Packagist currently stop at 2.0.0-rc.8, so a new consumer cannot resolve the documented 2.0.0-rc.9 command. The Sample App consequently consumes dev-main, leaving the first-party examples with conflicting distribution guidance.

How to fix

Establish one truthful public distribution contract. If AI remains a versioned Composer package, publish the intended sequential prerelease and verify the documented command from a fresh stable-default Composer root against the normal public repository. If AI is intentionally source-only for this phase, update the README, package metadata, changelog, and resolver smoke to advertise and exercise that public source constraint without assigning a nonexistent release version. Keep Sample App guidance aligned with the selected contract.

The resolver check must exercise the same public constraint users copy; a path repository with a synthetic version is useful for compatibility testing but is not publication evidence.

Acceptance Criteria

  • The documented AI install command resolves from a fresh stable-default Composer root using public package metadata.
  • The semantic resolver check does not treat a checkout-only path alias as proof that a release is published.
  • README release statements, Composer product-train metadata, changelog state, and Sample App consumption describe one consistent distribution model.
  • Verification records the resolved public source reference for the advertised constraint.

Delete when

Delete this item when a fresh consumer can run the documented install command, resolve the advertised AI artifact to the expected public commit, and no first-party documentation or CI check claims an unpublished version is current.

Metadata

Metadata

Assignees

No one assigned

    Labels

    authority:githubGitHub is the authoritative lifecycle record for this workbeta:compatibleMay be completed without changing the frozen beta contractkind:defectA public product behavior is incorrectpriority:P2Normal-priority product workrepo:aiOwned by the AI repositorystatus:readyReady for implementation

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions