scaffold: dependency reconciliation is silent — no diff shown, unlike enhance/upgrade
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 68/100
Research direction
Trace the dependency reconciliation performed by scaffold create, then compare it with the existing summary behavior in scaffold enhance and scaffold upgrade. Use the generated pyproject.toml and terminal output to verify that additions and changes are reported against the template's declared dependencies.
Written by the indexing model from the issue text.
Description
Is your feature request related to a problem? Please describe.
scaffold create -a <remote-template> reconciles a third-party template's declared extra_dependencies against the base adk template's current floor at scaffold time ("Ensuring base template 'adk' dependencies..."). I hit this directly: my own remote template (MisterTK/keel/packaging/agents-cli-template) had pinned google-adk[gcp]>=2.0.0,<3.0.0, and the CLI silently upgraded it to google-adk[gcp,otel-gcp]>=2.6.0,<3.0.0 plus added three dependencies my manifest never listed (google-cloud-logging, opentelemetry-resourcedetector-gcp, gcsfs) — with no indication in the terminal output that anything had changed from what the template declared.
This is a genuinely useful safety net (it kept a stale third-party template from producing a broken project), but it's invisible. A template author has no way to know their pinned versions are out of date until they diff the generated pyproject.toml by hand against their own manifest.
Compare this to scaffold enhance/scaffold upgrade, which both print a clear summary before applying anything:
Dependency changes:
+ Add: google-cloud-aiplatform[evaluation]>=1.156.0
...
✓ Keep (yours): keelrun>=0.2.0
Describe the solution you'd like
Print the same kind of "Dependency changes" summary during scaffold create's reconciliation step, so a template author (or anyone reading the terminal output) can see exactly what got added/changed versus what the template itself declared — the same UX enhance/upgrade already have, just applied to the initial create path too.
Describe alternatives you've considered
Diffing the generated pyproject.toml against the template's own manifest by hand after every scaffold create run — works, but easy to miss and not something a template consumer would think to do.
- Dominant language
- Python
- Stars
- 6k
- Forks
- 670
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from google/agents-cli
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 92/100
google/agents-cli#86 ·
-
google/agents-cli#89 · 1 assignee ·
-
google/agents-cli#87 · 1 comment · 1 assignee ·
-
Difficulty 3/5 1-2 days Newbie friendliness 68/100
google/agents-cli#84 · 1 comment ·
-
Difficulty 3/5 1-2 days Newbie friendliness 72/100
google/agents-cli#83 · 2 comments · 1 reaction ·
All issues in google/agents-cli
Similar issues
-
Add: hunch Open
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
AbdelStark/awesome-typesafe#104 ·
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
DiamondLightSource/dodal#2211 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
openml/openml-python#1749 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
sipyourdrink-ltd/bernstein#6191 ·