Add agent signup and improve config-resolution diagnostics

[const-cloudinary]

Summary

Adds the cld agent signup command: for AI agents, it creates a Free-plan Cloudinary account on behalf of a human, saves the returned product environment as a named config, and detects duplicate signups both locally (from saved configs) and server-side.

cld agent signup <email> <agent_framework> <agent_llm_model> <agent_goal>

Flags: --name, --set-default, --no-save, --sdk-framework, --json. Credentials are inert until the human completes the emailed verification.

Also improves config-resolution UX slightly: unconfigured/no-default/incomplete states now report the true situation with clearer guidance, and commands that need no config no longer print the "no configuration found" banner.

Docs

README: added agent signup to the important-commands list and a dedicated section documenting syntax, example, and flags.

Testing

• pytest test/ --ignore=test/test_modules → 332 passed, 21 skipped.
• pyflakes clean on all touched files.
• The test/test_modules/* collection error is pre-existing (those modules need real credentials at import) and unrelated to this change.

Manual checks

Isolate the config dir and clear Cloudinary env first so nothing touches a real account:

export CLOUDINARY_HOME="$(mktemp -d)/.cloudinary-cli"
for v in $(env | grep -o '^CLOUDINARY_URL'); do unset "$v"; done

# real signup (rate-limited, sends a verification email, creates a real Free account)
cld agent signup you+test@example.com claude-code claude-fable-5 "smoke test"
cld agent signup you+test@example.com claude-code claude-fable-5 "goal" --json     # raw JSON contract
cld agent signup you+test@example.com claude-code claude-fable-5 "goal" --no-save  # show creds, don't save

# input validation (no API call)
cld agent signup "" claude-code claude-fable-5 "goal"                     # empty email -> exit 2
cld agent signup you+t@example.com claude-code claude-fable-5 "goal" --name __default__  # reserved -> exit 2

# config-resolution UX
cld config -ls                        # empty -> guidance (incl. agent signup), not an empty table
cld url sample                        # unconfigured -> clean banner, no "warning:" prefix
cld -c not-a-url admin usage          # -> "expects a CLOUDINARY_URL" (exit 2)

Note: agent signup was exercised via mocked tests; the live provisioning API path (which creates real accounts and sends verification emails) was not run in CI.

🤖 Generated with Claude Code