Add azpysdk changelog command group wrapping Chronus

[Copilot]

Integrates Chronus changelog management into the azpysdk CLI so developers don't need to use npx chronus directly.

New subcommands

Command	Delegates to	Purpose
azpysdk changelog add [package]	npx chronus add	Add a change entry (interactive or non-interactive)
azpysdk changelog verify	npx chronus verify	Check modified packages have entries
azpysdk changelog create	npx chronus changelog	Generate CHANGELOG.md from entries
azpysdk changelog status	npx chronus status	Show pending changes / version bumps

Commands work from both the repository root and from within a package directory. When running azpysdk changelog add from inside a package folder (e.g. sdk/storage/azure-storage-blob), the package path is detected automatically and passed to chronus. An explicit package argument always takes precedence.

The add subcommand supports --kind (-k) and --message (-m) flags for non-interactive use, including tagging entries as breaking changes. Valid kinds: breaking, feature, deprecation, fix, dependencies, internal. If omitted, chronus falls back to its interactive prompts.

Changes

• azpysdk/changelog.py — New changelog Check subclass. Runs npx chronus <cmd> from repo root with inherited stdio for interactive prompts. Auto-detects package path from CWD when inside an sdk/<service>/<package> directory. Supports --kind and --message flags on add for non-interactive change entry creation (e.g. breaking changes). Errors clearly when Node.js/npx is missing.
• azpysdk/main.py — Import and register the changelog command.
• tests/test_changelog_commands.py — 41 tests covering parser structure, correct argument passthrough, --kind/--message flag forwarding, CWD-based package detection, repo-root cwd, exit code propagation, and npx-missing error handling.

# Example usage — from repo root
azpysdk changelog add sdk/storage/azure-storage-blob
azpysdk changelog add --kind breaking -m "Removed deprecated API"
azpysdk changelog add sdk/core/azure-core -k feature -m "Added new endpoint"
azpysdk changelog verify
azpysdk changelog create

# Example usage — from inside a package directory
cd sdk/storage/azure-storage-blob
azpysdk changelog add    # auto-detects the package
azpysdk changelog add -k fix -m "Fixed upload bug"

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• scanning-api.github.com
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[l0lawrence]

This should also support breaking changes — e.g. a --breaking flag on azpysdk changelog add or a way to tag entries as breaking so Chronus generates the appropriate changelog section and version bump.

[l0lawrence]

This should also support breaking changes — e.g. a --breaking flag on azpysdk changelog add or a way to tag entries as breaking so Chronus generates the appropriate changelog section and version bump.

@copilot

[Copilot]

This should also support breaking changes — e.g. a --breaking flag on azpysdk changelog add or a way to tag entries as breaking so Chronus generates the appropriate changelog section and versi...

Added in f63e08c. azpysdk changelog add now supports --kind (-k) and --message (-m) flags that forward directly to chronus's native options. Valid kinds are: breaking, feature, deprecation, fix, dependencies, internal.

Examples:

azpysdk changelog add --kind breaking -m "Removed deprecated API"
azpysdk changelog add sdk/core/azure-core -k feature -m "Added new endpoint"

If --kind or --message are omitted, chronus falls back to its interactive prompts as before.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• registry.npmjs.org
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/_temp/ghcca-node/node/bin/npx --no chronus add --help (dns block)
• timotheeguerin.github.io
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[l0lawrence]

@copilot There are several issues to fix in this PR:

1. Read _CHANGE_KINDS from .chronus/config.yaml instead of hardcoding

In eng/tools/azure-sdk-tools/azpysdk/changelog.py, the _CHANGE_KINDS list is hardcoded and will silently diverge from .chronus/config.yaml. Instead, read the change kinds dynamically from the config file at module load time (with the hardcoded list as a fallback). Use pyyaml (already available in the repo) to parse .chronus/config.yaml and extract the keys from changeKinds. Add a helper function like:

def _load_change_kinds() -> List[str]:
    config_path = os.path.join(REPO_ROOT, ".chronus", "config.yaml")
    try:
        import yaml
        with open(config_path) as f:
            config = yaml.safe_load(f)
        kinds = list(config.get("changeKinds", {}).keys())
        if kinds:
            return kinds
    except Exception:
        pass
    return ["breaking", "feature", "deprecation", "fix", "dependencies", "internal"]

Then use _CHANGE_KINDS = _load_change_kinds() and add a test that validates the loaded kinds match what's in the config file.

2. Don't auto-install in non-TTY/CI without explicit opt-in

In _ensure_chronus_installed, the current code automatically runs npm install when stdin is not a TTY (CI environments). This is surprising and slow. Instead, require an explicit opt-in via the AZPYSDK_AUTO_INSTALL environment variable. Change the non-interactive branch to:

if not sys.stdin.isatty():
    if not os.environ.get("AZPYSDK_AUTO_INSTALL"):
        logger.error(
            "Chronus is not installed and running in non-interactive mode.\n"
            "Set AZPYSDK_AUTO_INSTALL=1 to allow automatic installation, or run:\n\n"
            f"    cd {REPO_ROOT}\n"
            "    npm install\n"
        )
        raise SystemExit(1)
    logger.info("AZPYSDK_AUTO_INSTALL set - running 'npm install' automatically.")

Update the corresponding tests to check for the env var behavior.

3. Use args.package directly instead of getattr

In _run_add, replace getattr(args, "package", None) with args.package since add_argument always sets the attribute. Same for args.kind and args.message. The getattr pattern is misleading - it suggests the attribute might not exist.

4. Avoid storing parser as private attr on Namespace

In _no_subcommand, accessing args._changelog_parser relies on a private attribute stashed on the Namespace. Instead, store the parser reference as an instance attribute on the changelog class itself (e.g. self._parser = p) and reference self._parser.print_help() in _no_subcommand.

Please make all four fixes and update the tests accordingly.

[Copilot]

@copilot There are several issues to fix in this PR:

1. Read _CHANGE_KINDS from .chronus/config.yaml instead of hardcoding...

All four fixes applied in 358c1c6:

1. Dynamic change kinds — _load_change_kinds() reads .chronus/config.yaml via pyyaml at module load, falls back to _FALLBACK_CHANGE_KINDS if config is missing or unparseable. New test validates loaded kinds match the config file.

2. AZPYSDK_AUTO_INSTALL gate — Non-interactive mode now exits with an actionable error unless AZPYSDK_AUTO_INSTALL=1 is set. Two new tests cover both paths.

3. Direct attribute access — Replaced getattr(args, "package", None) etc. with args.package, args.kind, args.message.

4. Parser on instance — self._parser stores the parser reference; _no_subcommand uses self._parser.print_help() instead of args._changelog_parser.

45 tests passing.

[l0lawrence]

@copilot if the user does not have chronus installed, install it for them and log it

[l0lawrence]

@copilot if the user does not have chronus installed, install it for them and log it

@copilot

[l0lawrence]

[l0lawrence]

installing chronus for user after asking for permissions ^^

[Copilot]

Pull request overview

Adds a new azpysdk changelog command group to wrap Chronus changelog operations from the Azure SDK for Python tooling, along with pinned Chronus Node dependencies and CI/test updates.

Changes:

• Introduces azpysdk changelog subcommands (add, verify, create, status) that invoke a pinned Chronus binary and optionally auto-detect the package from CWD.
• Registers the new command group in the azpysdk CLI and updates the azure-sdk-tools GitHub workflow to exclude it from the “run all checks” dispatcher.
• Adds a comprehensive new test suite for parser shape, argument forwarding, CWD-based package detection, and install gating behavior.

Reviewed changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
eng/tools/azure-sdk-tools/azpysdk/changelog.py	New CLI command group implementing Chronus invocation, install gating, and package resolution.
eng/tools/azure-sdk-tools/azpysdk/main.py	Registers the new changelog command group in the top-level CLI.
eng/tools/azure-sdk-tools/tests/test_changelog_commands.py	Adds unit tests for parser registration, command invocation, and install behavior.
.github/workflows/azure-sdk-tools.yml	Excludes changelog from the auto-discovered “checks” list run by the workflow.
.github/chronus/package.json	Adds pinned Chronus dev dependency for reproducible local execution.
.github/chronus/package-lock.json	Locks Chronus transitive dependency graph for reproducibility and integrity.

Files not reviewed (1)

• .github/chronus/package-lock.json: Language not supported