Skip to content

JGC-473 - Add AI-agent help text to artifactory commands#455

Open
ehl-jf wants to merge 1 commit into
jfrog:mainfrom
ehl-jf:JGC-473-ai-context-help
Open

JGC-473 - Add AI-agent help text to artifactory commands#455
ehl-jf wants to merge 1 commit into
jfrog:mainfrom
ehl-jf:JGC-473-ai-context-help

Conversation

@ehl-jf
Copy link
Copy Markdown
Contributor

@ehl-jf ehl-jf commented May 21, 2026

Summary

Adds AIDescription to artifactory's 50 commands across 4 namespaces so they render agent-oriented help when JFROG_CLI_AI_HELP is truthy or an AI agent is auto-detected. Empty AIDescription falls back to Description; human-mode output is unchanged.

Scope: 36 help.go files + 50 components.Command literals across:

  • artifactory/cli/cli.go (33 commands)
  • distribution/cli/cli.go (5 commands)
  • lifecycle/cli.go (11 commands)
  • ide/cli/cli.go (1 command)

Hidden commands (build-scan, docker-push, docker-pull, and the entire skills namespace) were intentionally skipped per the JGC-473 plan.

TEMPORARY go.mod pin — DO NOT MERGE UNTIL RE-PINNED

go.mod require for github.com/jfrog/jfrog-cli-core/v2 points at `JGC-473-devbase` (commit `d507b5c6`). See linked core PR. Re-pin to merged jfrog-cli-core master pseudo-version before merge.

Linked

Note: yarn-coordination caveat (unrelated to JGC-473 content)

Currently jfrog-cli-core master removed yarn.IsVersionSupported and IsInstalledYarnVersionSupported (RTECO-1035), but this repo's artifactory/commands/yarn/yarn.go:183,307 still calls them. The temporary core pin to `JGC-473-devbase` (which retains the old yarn API) sidesteps this for the PR build, but the underlying coordination needs to be resolved upstream before this PR — or any downstream consumer — can pick up merged jfrog-cli-core master.

Test plan

  • go build ./... clean
  • go test ./... 1642 passed, 25 pre-existing environmental failures (require local pnpm/dotnet toolchains)

Populate components.Command.AIDescription on commands. The new field
(added in jfrog-cli-core JGC-473) makes the conversion layer render
agent-oriented text when JFROG_CLI_AI_HELP is truthy or an AI agent is
auto-detected. Empty AIDescription falls back to Description, so
command output is unchanged in human mode.

Scope: 36 help.go files + 50 components.Command literals across artifactory/cli/cli.go, distribution/cli/cli.go, lifecycle/cli.go, ide/cli/cli.go.

TEMPORARY go.mod pin: the require for github.com/jfrog/jfrog-cli-core/v2
points at JGC-473-devbase (commit d507b5c6) - a coordination branch
that cherry-picks JGC-473 onto core's pinned commit 908527b4 (the last
commit before core master removed yarn.IsVersionSupported and
IsInstalledYarnVersionSupported, which downstream callers in
jfrog-cli-artifactory still depend on). This require MUST be updated to
the merged master commit's pseudo-version after the jfrog-cli-core
JGC-473 PR merges. Do not merge this PR until the require is re-pinned.
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