Skip to content

Reassert the scope of the spk-workspace crate - #1396

Merged
rydrman merged 1 commit into
mainfrom
workspace-scope-cleanup
Jul 30, 2026
Merged

Reassert the scope of the spk-workspace crate#1396
rydrman merged 1 commit into
mainfrom
workspace-scope-cleanup

Conversation

@rydrman

@rydrman rydrman commented Jul 24, 2026

Copy link
Copy Markdown
Collaborator

Summary

The spk-workspace crate had accumulated framing and dependencies that pointed toward a larger, build-orchestration concept (the abandoned "build a network of packages together" direction). This PR tidies the crate down to what it actually does today: discover recipe spec files and resolve them by name, version, or path. It also adds the missing user documentation so workspaces are a clearly-bounded, complete feature that doesn't imply further development.

No behavior change. The version-parameterized recipe support (versions: in workspace.spk.yaml, e.g. the packages/python/python{2,3}.spk.yaml recipes) is intentionally kept, since real specs in this repo rely on it.

Changes

  • Drop the unused spk-solve dependency from spk-workspace (zero code references; it only existed to forward a sentry feature that nothing enabled) along with the orphaned sentry feature and the unused itertools dependency.
  • Reword the crate/module/struct docs that described the unimplemented package build-orchestration vision to describe the crate's actual purpose.
  • Add docs/use/workspaces.md documenting the workspace file, recipe globs, and version-parameterized recipes.

Testing

  • cargo metadata resolves cleanly with the updated manifest.
  • Full compilation / cargo test -p spk-workspace could not be run locally: this is a macOS host, and the spfs stack (pulled in transitively via spk-schema) depends on the Linux-only procfs crate. Relying on CI (Linux) for build/test validation.

@codecov

codecov Bot commented Jul 24, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@rydrman
rydrman marked this pull request as ready for review July 24, 2026 23:55
@cursor

cursor Bot commented Jul 24, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@rydrman rydrman self-assigned this Jul 24, 2026
@rydrman
rydrman requested a review from jrray July 24, 2026 23:55
The workspace crate accumulated framing and dependencies that pointed
toward a larger, build-orchestration concept that is not being pursued.
This tidies the crate down to what it actually does today: discover
recipe spec files and resolve them by name, version, or path.

- drop the unused spk-solve dependency (and the orphaned sentry feature
  that only forwarded to it) and the unused itertools dependency
- reword the crate, module, and struct docs that described the
  unimplemented package build-orchestration vision
- add user documentation for workspaces describing the workspace file,
  recipe globs, and version-parameterized recipes

No behavior change.

Signed-off-by: Ryan Bottriell <ryan@bottriell.ca>
@rydrman
rydrman force-pushed the workspace-scope-cleanup branch from 69ca4d3 to f40a1a9 Compare July 24, 2026 23:57
@rydrman
rydrman requested a review from dcookspi July 24, 2026 23:58
@rydrman
rydrman merged commit 386cfb6 into main Jul 30, 2026
10 checks passed
@rydrman
rydrman deleted the workspace-scope-cleanup branch July 30, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants