Skip to content

Add AI-agent help text to application commands#81

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

Add AI-agent help text to application commands#81
ehl-jf wants to merge 2 commits 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 AI-agent-oriented help text (AIDescription) so commands render richer 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: 13 components.Command literals across apptrust/commands/* + 1 namespace in cli/cli.go.

Dependency on jfrog-cli-core

jfrog-cli-core's JGC-473 PR (#1563) has MERGED. This PR's go.mod now requires the merged core master pseudo-version v2.60.1-0.20260601130310-8d52a530da18 directly — no temporary replace directive. Ready to merge on its own.

Linked

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: 13 components.Command literals across apptrust/commands/{system,version,package,application}/ + 1 namespace in 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.
@ehl-jf ehl-jf force-pushed the JGC-473-ai-context-help branch from 5ae7420 to 2b10f4d Compare June 1, 2026 13:06
@ehl-jf ehl-jf changed the title JGC-473 - Add AI-agent help text to application commands Add AI-agent help text to application commands Jun 1, 2026
Run gofumpt across apptrust/ and cli/ to fix struct-field alignment in the
new AIDescription literals.

Note: the repo's Static-Check also fails independently of this change because
golangci-lint-action@v6 installs golangci-lint v1.64.8 (built with go1.24),
which cannot load a go.mod targeting go 1.25.5. That CI-infra mismatch
predates this PR and needs a separate fix (bump the action to v9 + migrate
.golangci.yml to v2 format, as already done in jfrog-cli-platform-services).
@ehl-jf ehl-jf force-pushed the JGC-473-ai-context-help branch from 1677d56 to 384beb1 Compare June 1, 2026 14:24
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