Release v0.12.0

[lchoquel]

Release v0.12.0

Bumps version from 0.11.0 to 0.12.0. Promotes dev → main.

Changelog

Added

• locate_artifacts and ArtifactLocation: pipelex_sdk.artifacts.locate_artifacts(value) is the artifact walk with its paths — every pipelex-storage:// reference in a JSON value, deduplicated in discovery order exactly as collect_artifacts returns them, each as an ArtifactLocation whose found_at lists every $-rooted path at which it sits ($.rooms[3].staged_photo.url, $.items[0].url, $["a key"].url), written the way @pipelex/sdk's locateArtifacts writes them.

Changed

• download_artifacts names each file after the field it fills, and artifact_filename takes a location (Breaking): a saved file is named after the first path at which its reference sits — $.rooms[3].staged_photo.url is saved as rooms-3-staged_photo.png, and an output that is one image as main_stuff.png — instead of after the last segment of its storage key, which now supplies only the extension, so the same run saves under the same names from either SDK. artifact_filename(location, content_type, scope) replaces artifact_filename(uri, content_type, index) and raises ArtifactOperationError for anything but an ArtifactLocation whose first path is in the walk's notation; a field whose name Windows reserves for a device (aux, nul, com1 and the like) is saved with a trailing _ (aux_.png); the full rule is on docs/artifact-download.md.
• DownloadedArtifact carries a required found_at (Breaking): every item of a download_artifacts verdict carries its reference's found_at, on the saved arm and the error arm alike, so a file that was not saved still says which field it would have filled. DownloadedArtifact is now an ArtifactLocation, so artifact_filename takes a verdict item as it is, and code that builds DownloadedArtifact values — a test fake standing in for download_artifacts — must now supply the field.
• Requires mthds 0.15.0 (Breaking): the exact pin moves from 0.14.0, so pipelex-sdk can again be installed beside pipelex, which has pinned mthds==0.15.0 exactly since its 0.60.0. Nothing in this client's own surface changes: the release's breaking cut to ConceptAbstract and StuffAbstract sits in protocol models this SDK does not build on, and parse_method_files / serialize_method_files stay beside the canonical mthds.protocol.method_files for the reason docs/architecture.md gives.

Closes L-260924-a14bbb

🤖 Generated with Claude Code

---

Summary by cubic

Bumps the version from 0.11.0 to 0.12.0 and promotes dev to main. The release changes how downloaded artifact files are named and moves the exact mthds pin.

New Features

• locate_artifacts walks a JSON value and returns every pipelex-storage:// reference with every $-rooted path where it sits ($.rooms[3].staged_photo.url), in discovery order matching collect_artifacts.

Migrations

• download_artifacts now names each saved file after the field its reference fills (first path) instead of the storage key's last segment, which now only supplies the extension.
• artifact_filename(location, content_type, scope) replaces the URI-based signature and raises ArtifactOperationError for invalid input.
• DownloadedArtifact now extends ArtifactLocation and requires found_at, so test fakes standing in for download_artifacts must supply it.
• Moves the exact mthds pin from 0.14.0 to 0.15.0 so pipelex-sdk installs beside pipelex again; nothing in the client surface changes.

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