Skip to content

Finalize 0.3.0 task syntax and GitRepo workspace handles#40

Merged
dcx merged 5 commits into
mainfrom
export/030-clean-task-syntax
Jul 8, 2026
Merged

Finalize 0.3.0 task syntax and GitRepo workspace handles#40
dcx merged 5 commits into
mainfrom
export/030-clean-task-syntax

Conversation

@dcx

@dcx dcx commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Allow task arguments to be passed directly as keywords to Workspace.run(...) and WorkspaceTask.run(...), with args={...} retained for explicit mappings and reserved-name escape hatches.
  • Make repo: sp.GitRepo the clean writable workspace-handle spelling for tasks, while preserving explicit narrower grants such as sp.May[sp.GitRepo, sp.ReadOnly].
  • Stop treating unannotated repo parameters as implicit workspace handles; they now behave like ordinary value parameters unless annotated.
  • Align generated task modules, quickstart templates, workspace-handle examples, visual artifact examples, tests, and changelog entries with the 0.3.0 syntax.

Testing

  • uv sync --offline
  • uv run ruff check .
  • uv run ruff format . --check
  • uv run pytest shepherd/packages/dialect/tests/test_run_kwargs_sugar.py shepherd/packages/dialect/tests/test_register_ceiling_derivation.py shepherd/packages/dialect/tests/test_workspace_context_manager.py shepherd/packages/dialect/tests/test_workspace_control_core_loop.py shepherd/packages/dialect/tests/test_workspace_control_run_output_wrappers.py — 130 passed
  • make release-evidence-beat0 — 71 passed; executed-evidence sentinel green for 19 required ids
  • make release-evidence-lane-c — 10 passed; executed-evidence sentinel green for 10 required ids, 7 jailed ids skip-free

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying shepherd-agents-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6bd1c00
Status: ✅  Deploy successful!
Preview URL: https://2cd55bb4.shepherd-agents-docs.pages.dev
Branch Preview URL: https://export-030-clean-task-syntax.shepherd-agents-docs.pages.dev

View logs

@dcx dcx merged commit cb4ace1 into main Jul 8, 2026
5 checks passed
@dcx dcx deleted the export/030-clean-task-syntax branch July 8, 2026 14:41
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.

1 participant