Skip to content

agents: refine Starlark data serialization, docstring, and WORKSPACE rules - #4364

Merged
rickeylev merged 1 commit into
bazel-contrib:mainfrom
rickeylev:agents_uv_workspace_learnings
Oct 27, 2026
Merged

rickeylev merged 1 commit into
bazel-contrib:mainfrom
rickeylev:agents_uv_workspace_learnings

Conversation

@rickeylev

Copy link
Copy Markdown
Collaborator

Capture review feedback from #4360 in the workspace agent rules so
future Starlark and WORKSPACE implementations follow the same patterns:

  • Direct repository rules to serialize JSON-compatible data constants in
    generated .bzl files with json.encode_indent() instead of custom
    render.* helpers.
  • Keep .bzl API docstrings brief and place multi-scenario examples and
    setup guides in narrative docs/ pages linked via {ref} or {obj}.
  • Require WORKSPACE macros to match Bzlmod extension defaults, tag
    schemas, and single-hub multi-version structure, splitting manifest
    downloads into a manifest repo rule and a bound registration macro.

…rules

Capture review feedback from bazel-contrib#4360 in the workspace agent rules so
future Starlark and WORKSPACE implementations follow the same patterns:

- Direct repository rules to serialize JSON-compatible data constants in
  generated `.bzl` files with `json.encode_indent()` instead of custom
  `render.*` helpers.
- Keep `.bzl` API docstrings brief and place multi-scenario examples and
  setup guides in narrative `docs/` pages linked via `{ref}` or `{obj}`.
- Require `WORKSPACE` macros to match Bzlmod extension defaults, tag
  schemas, and single-hub multi-version structure, splitting manifest
  downloads into a manifest repo rule and a bound registration macro.
@rickeylev

Copy link
Copy Markdown
Collaborator Author

AI Disclosure

  • Oversight level: semi-autonomous (human-directed and human-reviewed).
  • Comment handling: The human author reviews and approves any agent responses before posting, or handles review comments directly.

This is an automatically generated agent comment.

@rickeylev
rickeylev merged commit 21d36f3 into bazel-contrib:main Oct 27, 2026
10 of 12 checks passed
@rickeylev
rickeylev deleted the agents_uv_workspace_learnings branch October 27, 2026 06:40
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