refactor: agent cli advanced grouping

[ankitranjan7]

Description

This change makes the CLI help surface agent-first by moving operator-oriented commands into a dedicated advanced subgroup and extracting their implementations into a separate module.

It introduces authsome advanced ... for commands such as daemon, doctor, log, profile, register, rekey, remove, and ui, while keeping the legacy top-level command paths available as hidden aliases for backward compatibility. It also shortens main.py by moving all advanced command definitions into src/authsome/cli/advanced.py.

Motivation and Context

The top-level CLI had grown noisy and mixed agent-facing workflows with operator/debugging flows. That made authsome --help harder to scan and pushed more cognitive load onto agents learning the tool.

This change solves that by:

• keeping the top-level surface focused on the core agent workflow
• grouping advanced/human-oriented commands under one explicit place
• reducing the size and responsibility of src/authsome/cli/main.py

Related context: this is part of the broader agent-first CLI work and the audit of top-level commands.

How Has This Been Tested?

Tested with:

• uv run authsome --help
• uv run authsome advanced --help
• uv run pytest
• uv run ruff check src/ tests/
• uv run ty check src/
• uv run --with pre-commit pre-commit run --all-files

Additional regression coverage was added for:

• top-level help hiding advanced commands
• advanced --help listing advanced commands
• hidden legacy aliases continuing to work
• daemon/register tests updated to patch the new advanced module locations

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

• My code follows the code style of this project.
• I have read the CONTRIBUTING document.
• All new and existing tests passed.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
agentr	🟢 Ready	View Preview	May 22, 2026, 12:08 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.