[Bug]: help subcommand doesn't work

[jurisevo]

I have done the following

• I have searched the existing issues
• If possible, I've reproduced the issue using the 'main' branch of this project

Steps to reproduce

CLI interface suggest to use container help ... for detailed help of subcommands, for instance:

$ container image        
OVERVIEW: Manage images

USAGE: container image [--debug] <subcommand>

OPTIONS:
  --debug                 Enable debug output [environment: CONTAINER_DEBUG]
  --version               Show the version.
  -h, --help              Show help information.

SUBCOMMANDS:
  delete, rm              Delete one or more images
  inspect                 Display information about one or more images
  list, ls                List images
  load                    Load images from an OCI compatible tar archive
  prune                   Remove all dangling images. If -a is specified, also remove all images not referenced by any container.
  pull                    Pull an image
  push                    Push an image
  save                    Save one or more images as an OCI compatible tar archive
  tag                     Create a new reference for an existing image

  See 'container help image <subcommand>' for detailed help.

The very last line suggests to use container help image <subcommand>, let's try this:

$ container help image delete
Error: 2 unexpected arguments: 'image', 'delete'
Usage: container help
  See 'container help --help' for more information.

$ container help image pull  
Error: 2 unexpected arguments: 'image', 'pull'
Usage: container help
  See 'container help --help' for more information.

$ container help run       
Error: Unexpected argument 'run'
Usage: container help
  See 'container help --help' for more information.

This is a repeating pattern across commands (did not try all).

Problem description

Help system should be working as advertised by CLI interface.

Environment

- OS: macOS: 26.4.1 (25E253) 
- Container: container CLI version 0.12.3 (build: release, commit: f989901) (installed from pkg)

Code of Conduct

• I agree to follow this project's Code of Conduct

[jglogan]

@jurisevo Thanks for pointing this out! I can reproduce, and I can see with a different swift-argument-parser command (bin/cctl help rootfs if you build the containerization project locally) that it works as expected.

Root cause is probably related to all the stuff we do to handle plugin dispatch.

[PaleSkinnySwede]

The command "help" is not recognised. The string should simply say:

See 'container image <subcommand> --help' for detailed help.

[jurisevo]

As @PaleSkinnySwede pointed out, it may be enough to change the "helpful" string which mentions the use of help instead of --help. This will eliminate the confusion.