Add AI help descriptions for APM commands (install, publish, update)

Create help.go files with GetDescription() and GetAIDescription() for each
APM command:
- install: Install APM packages with Artifactory authentication
- publish: Publish APM packages to Artifactory
- update: Refresh package dependencies with build-info collection

Update agent/apm/cli/cli.go to wire up AIDescription fields so commands
are discoverable by static analysis tests and AI tools.

Fixes: TestAIHelpCoverageGenerated test failure (3 visible APM commands
missing AI help)

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: udaykb2

agent/apm/cli/cli.go

@@ -23,20 +23,23 @@ func GetSubCommands() []components.Command {
 			// RunInstall extracts jf's own flags manually via ExtractApmSubcommandOptions.
 			SkipFlagParsing: true,
 			Description:     "Install APM packages with JFrog Artifactory authentication.",
+			AIDescription:   install.GetAIDescription(),
 			Action:          install.RunInstall,
 		},
 		{
 			Name:            "publish",
 			Flags:           flagkit.GetCommandFlags(flagkit.AgentApm),
 			SkipFlagParsing: true,
 			Description:     "Publish an APM package to JFrog Artifactory.",
+			AIDescription:   publish.GetAIDescription(),
 			Action:          publish.RunPublish,
 		},
 		{
 			Name:            "update",
 			Flags:           flagkit.GetCommandFlags(flagkit.AgentApm),
 			SkipFlagParsing: true,
 			Description:     "Refresh APM dependencies to their latest matching refs, with build-info collection.",
+			AIDescription:   update.GetAIDescription(),
 			Action:          update.RunUpdate,
 		},
 	}

agent/apm/commands/install/help.go

@@ -0,0 +1,35 @@
+package install
+
+func GetDescription() string {
+	return "Install APM packages with JFrog Artifactory authentication."
+}
+
+func GetAIDescription() string {
+	return `Install packages declared in apm.yml with authenticated access to JFrog Artifactory registries.
+
+When to use:
+- Installing packages into an agent project that has apm.yml configured.
+- Accessing private or curated packages from Artifactory via registry credentials.
+- Collecting build-info about package dependencies in CI/CD pipelines.
+
+Prerequisites:
+- apm CLI (>= 0.1.0) installed and in PATH.
+- A registry declared in apm.yml's registries: block or configured via jf setup agent-apm.
+- Read permission on the source Artifactory agentpackages repository.
+
+Common patterns:
+  $ jf agent apm install
+  $ jf agent apm install --build-name=my-build --build-number=1
+
+Build info:
+- Enabled with --build-name and --build-number flags.
+- Captures installed packages and their transitive dependencies.
+- Published to Artifactory for traceability and compliance.
+
+Environment:
+- Credentials injected via APM_REGISTRY_TOKEN_<NAME>, APM_REGISTRY_USER_<NAME>, APM_REGISTRY_PASS_<NAME>.
+- Registry configuration sourced from ~/.apm/config.json (set by jf setup agent-apm).
+- Lockfile apm.lock.yaml created in working directory.
+
+Related: jf agent apm publish, jf agent apm update, jf setup agent-apm`
+}

agent/apm/commands/publish/help.go

@@ -0,0 +1,42 @@
+package publish
+
+func GetDescription() string {
+	return "Publish an APM package to JFrog Artifactory."
+}
+
+func GetAIDescription() string {
+	return `Publish an agent package to a JFrog Artifactory agentpackages repository with authenticated access.
+
+When to use:
+- Publishing custom agent packages for installation across multiple projects.
+- Packaging skills, tools, or other agent extensions for organizational use.
+- Creating reproducible, versioned deployments of agent components.
+
+Prerequisites:
+- apm CLI (>= 0.1.0) installed and in PATH.
+- An apm.yml file in the package directory (or parent directories).
+- Write permission on the Artifactory agentpackages repository.
+- Registry configured via jf setup agent-apm or apm.yml's registries: block.
+
+Common patterns:
+  $ jf agent apm publish my-org/my-package
+  $ jf agent apm publish my-org/my-package --build-name=my-build --build-number=1
+  $ jf agent apm publish my-org/my-package --build-name=my-build --build-number=1 --module=my-module
+
+Package format:
+- Directory with apm.yml declaring name, version, and description.
+- Optional skills/ subdirectory containing Cursor Agent Skills.
+- Version in apm.yml becomes the published package version.
+
+Build info:
+- Enabled with --build-name and --build-number flags.
+- Captures package metadata and publishing source.
+- Published to Artifactory for traceability and compliance.
+- Optional --module to group multiple packages in the same build.
+
+Environment:
+- Credentials injected via APM_REGISTRY_TOKEN_<NAME>, APM_REGISTRY_USER_<NAME>, APM_REGISTRY_PASS_<NAME>.
+- Registry configuration sourced from ~/.apm/config.json (set by jf setup agent-apm).
+
+Related: jf agent apm install, jf agent apm update, jf setup agent-apm`
+}

agent/apm/commands/update/help.go

@@ -0,0 +1,41 @@
+package update
+
+func GetDescription() string {
+	return "Refresh APM dependencies to their latest matching refs, with build-info collection."
+}
+
+func GetAIDescription() string {
+	return `Update packages in apm.yml to their latest matching versions and refresh the lockfile with authenticated access to JFrog Artifactory.
+
+When to use:
+- Keeping agent package dependencies up-to-date within declared version constraints.
+- Re-resolving dependencies when new versions are published to the registry.
+- Collecting updated build-info about package dependencies in CI/CD pipelines.
+
+Prerequisites:
+- apm CLI (>= 0.1.0) installed and in PATH.
+- An apm.yml file in the working directory with dependencies declared.
+- A lockfile apm.lock.yaml already created (e.g., via jf agent apm install).
+- Read permission on the source Artifactory agentpackages repository.
+- Registry configured via jf setup agent-apm or apm.yml's registries: block.
+
+Common patterns:
+  $ jf agent apm update
+  $ jf agent apm update --build-name=my-build --build-number=1
+
+Version constraints:
+- Respects version constraints in apm.yml's dependencies section.
+- Fetches latest versions matching declared constraints.
+- Updates apm.lock.yaml with resolved versions and checksums.
+
+Build info:
+- Enabled with --build-name and --build-number flags.
+- Captures updated packages and their transitive dependencies.
+- Published to Artifactory for traceability and compliance.
+
+Environment:
+- Credentials injected via APM_REGISTRY_TOKEN_<NAME>, APM_REGISTRY_USER_<NAME>, APM_REGISTRY_PASS_<NAME>.
+- Registry configuration sourced from ~/.apm/config.json (set by jf setup agent-apm).
+
+Related: jf agent apm install, jf agent apm publish, jf setup agent-apm`
+}