feat(cli): align official slugs and add oauthv2

Author: francescobianco

.convcommit

@@ -0,0 +1,76 @@
+# convcommit - Conventional Commit message builder
+# This file is read by the `convcommit` CLI tool to populate
+# the interactive selector menus.
+# Commit this file to share the project's commit vocabulary with the team.
+#
+# FORMAT
+#   type:<value>      — commit type option (e.g. fix, feat, docs)
+#   scope:<value>     — commit scope option
+#   message:<value>   — commit message template
+#
+# SPECIAL PREFIXES
+#   ~<value>          — marks the default selection
+#   _                 — enables free-text manual input (press ".")
+#   [X]<value>        — forces key letter X for this entry (e.g. [B]build, [W]wip)
+#
+# HOW TO USE (interactive)
+#   Run `convcommit` in a git repo. A menu appears for type, scope, message.
+#   Press the letter in brackets [A][B]... or [.] for free-text input.
+#   Stage and push in one shot:
+#     convcommit -a -p
+#
+# HOW TO USE (direct flags — scripts, AI agents)
+#   Bypass the selector entirely with explicit flags:
+#     convcommit --type fix --scope auth --message "fix null pointer" --push
+#     convcommit -t feat -s api -m "add endpoint" -a -p
+#
+# SMART PATTERN — stage specific files and commit in one command
+#   Use --add instead of nested command substitution.
+#   Anti-pattern (avoid):
+#     msg=$(convcommit --type fix --message "fix") && git commit -m "$msg" && git push
+#   Recommended:
+#     convcommit --add src/auth.sh --type fix --scope auth --message "fix null pointer" --push
+#   Stage multiple files:
+#     convcommit --add src/auth.sh --add tests/auth_test.sh -t test -s auth -m "add tests" -p
+#
+# HOW TO USE (pipe / non-interactive)
+#   Pipe selections as lines: one per stage (type, scope, message).
+#   Use the letter shown in the menu, or "." to trigger free-text input.
+#   Examples:
+#     printf "G\n.\nfix null pointer in login\n" | convcommit
+#     printf "F\n\nadd endpoint\n" | convcommit -a -p
+#   Capture just the formatted message:
+#     msg=$(printf "G\n\nfix null pointer\n" | convcommit)
+#
+# OTHER USEFUL FLAGS
+#   --reset   Regenerate this file with the latest defaults
+#   --help    Show all options
+#
+# INSTALLATION
+#   convcommit is a single bash file with no dependencies.
+#   Install it locally in your project:
+#     curl -fsSL https://raw.githubusercontent.com/francescobianco/convcommit/refs/heads/main/bin/convcommit \
+#       -o bin/convcommit && chmod +x bin/convcommit
+#   Or system-wide:
+#     curl -fsSL https://raw.githubusercontent.com/francescobianco/convcommit/refs/heads/main/bin/convcommit \
+#       -o /usr/local/bin/convcommit && chmod +x /usr/local/bin/convcommit
+type:[B]build
+type:~chore
+type:[D]docs
+type:deps
+type:feat
+type:fix
+type:ci
+type:init
+type:merge
+type:perf
+type:refactor
+type:revert
+type:security
+type:style
+type:test
+type:[W]wip
+scope:_
+scope:~
+message:_
+message:~_

CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Renamed CLI service commands and scope aliases to use the official Openapi console slugs from `oas/00-list.txt`.
+- Replaced legacy aliases such as `token`, `sms`, `cadastre`, `certified-email`, `chamber-of-commerce`, `exchange-rate`, `massive-rem`, `paying-bills`, `postal-service`, `real-estate`, `time-stamping`, and `zip-codes` with `oauth`, `smsv2`, `catasto`, `pec`, `visurecamerali`, `exchange`, `pecmassiva`, `bollettini`, `ufficiopostale`, `realestate`, `marchetemporali`, and `cap`.
+
+### Added
+
+- Added `oauthv2` as a separate command for the new OAuth v2 API on `oauth.openapi.com`, alongside the existing `oauth` command on `oauth.openapi.it`.
+
 ---
 
 ## [0.1.1] - 2026-04-02
@@ -16,7 +25,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Scope alias `all`** — passing `--scopes all` when creating a token now expands to every available scope returned by the API. The keyword is case-insensitive (`ALL`, `All`, etc. are all valid).
 
   ```bash
-  openapi token create --scopes all
+  openapi oauth create --scopes all
   ```
 
 - Global `--who` easter egg powered by the external `billy-ray` crate.
@@ -35,7 +44,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - First public release of the Openapi CLI
 - Token management: `create`, `list`, `revoke`, `scopes`, `credit`
 - Scope aliases — use short service names instead of full scope strings when creating tokens
-- Method filtering for scope aliases (`post:sms`, `get:company`, …)
+- Method filtering for scope aliases (`post:smsv2`, `get:company`, …)
 - Sandbox mode via `-S` / `--sandbox` flag
-- Service commands: `ai`, `automotive`, `cadastre`, `certified-email`, `chamber-of-commerce`, `company`, `docuengine`, `domains`, `esignature`, `exchange-rate`, `geocoding`, `invoice`, `massive-rem`, `paying-bills`, `pdf`, `postal-service`, `real-estate`, `risk`, `sdi`, `sms`, `time-stamping`, `trust`, `visengine`, `zip-codes`
+- Service commands: `ai`, `automotive`, `bollettini`, `cap`, `catasto`, `company`, `docuengine`, `domains`, `esignature`, `exchange`, `geocoding`, `invoice`, `marchetemporali`, `oauth`, `pec`, `pecmassiva`, `pdf`, `realestate`, `risk`, `sdi`, `smsv2`, `trust`, `ufficiopostale`, `visengine`, `visurecamerali`
 - `info` command to verify environment variables and token scopes

README.md

@@ -17,7 +17,7 @@
 ## Overview
 
 A command-line client for the APIs available at [Openapi®](https://openapi.com).
-It provides direct terminal access to the Openapi® Marketplace, including token management, scope aliases, and sandbox support.
+It provides direct terminal access to the Openapi® Marketplace, including OAuth and OAuth v2 token management, scope aliases, and sandbox support.
 With this CLI you can quickly interact with hundreds of certified APIs and accelerate your digital transformation projects.
 
 ## Pre-requisites
@@ -76,7 +76,7 @@ The CLI uses two sets of environment variables depending on the type of command.
 
 ### OAuth credentials (for token management)
 
-Used by `openapi token` commands. These are your Openapi.it account credentials (Basic auth).
+Used by `openapi oauth` and `openapi oauthv2` commands. These are your Openapi account credentials (Basic auth).
 
 ```bash
 export OPENAPI_USERNAME="your-username"
@@ -86,7 +86,7 @@ export OPENAPI_SANDBOX_KEY="your-sandbox-key"        # optional
 
 ### Bearer tokens (for service API commands)
 
-Used by all service commands (`sms`, `company`, `risk`, etc.). These are tokens generated via `openapi token create`.
+Used by all service commands (`smsv2`, `company`, `risk`, etc.). These are tokens generated via `openapi oauth create` or `openapi oauthv2 tokens create`.
 
 ```bash
 export OPENAPI_TOKEN="your-bearer-token"
@@ -106,32 +106,38 @@ This shows all 5 environment variables, their status, and the scopes attached to
 Use the `-S` (or `--sandbox`) flag to run against sandbox environments:
 
 ```bash
-openapi -S sms send --to "+391234567890" --message "Test"
-openapi -S token list
+openapi -S smsv2 send --to "+391234567890" --message "Test"
+openapi -S oauth list
 ```
 
 ## Token management
 
 ```bash
 # List active tokens
-openapi token list
+openapi oauth list
 
 # List all available scopes
-openapi token scopes
+openapi oauth scopes
 
 # Create a new token
-openapi token create --scopes "sms"
+openapi oauth create --scopes "smsv2"
 
 # Check credit
-openapi token credit
+openapi oauth credit
 
 # Revoke a token
-openapi token revoke --token "token-id"
+openapi oauth revoke --token "token-id"
+
+# OAuth v2 token creation
+openapi oauthv2 tokens create --scopes "smsv2"
+
+# OAuth v2 scopes
+openapi oauthv2 scopes list
 ```
 
 ## Scope aliases
 
-When creating tokens with `openapi token create --scopes`, you can use **scope aliases** instead of writing full scope strings.
+When creating tokens with `openapi oauth create --scopes`, you can use **scope aliases** instead of writing full scope strings.
 
 ### How it works
 
@@ -142,41 +148,42 @@ Each API service is mapped to an alias name. When you use an alias, it automatic
 | `all` | **All services** _(special keyword)_ | — |
 | `ai` | AI language models | ai.openapi.com |
 | `automotive` | Automotive data | automotive.openapi.com |
-| `cadastre` | Italian cadastral data | catasto.openapi.it |
-| `certified-email` | PEC / Legalmail | pec.openapi.it |
-| `chamber-of-commerce` | Chamber of Commerce | visurecamerali.openapi.it |
+| `bollettini` | Bills payment | ws.pagasubito.it |
+| `cap` | Zip codes and municipalities | cap.openapi.it |
+| `catasto` | Italian cadastral data | catasto.openapi.it |
 | `company` | Company data | company.openapi.com |
 | `docuengine` | Official documents | docuengine.openapi.com |
 | `domains` | .it domain management | domains.altravia.com |
 | `esignature` | Electronic signature | esignature.openapi.com |
-| `exchange-rate` | Currency exchange rates | exchange.altravia.com |
+| `exchange` | Currency exchange rates | exchange.altravia.com |
 | `geocoding` | Geocoding | geocoding.openapi.it |
 | `invoice` | Electronic invoicing | invoice.openapi.com |
-| `massive-rem` | Massive REM | ws.pecmassiva.com |
-| `paying-bills` | Bills payment | ws.pagasubito.it |
+| `marchetemporali` | Time stamping | ws.marchetemporali.com |
+| `oauth` | OAuth token management | oauth.openapi.it |
+| `oauthv2` | OAuth v2 token management | oauth.openapi.com |
+| `pec` | PEC / Legalmail | pec.openapi.it |
+| `pecmassiva` | Massive REM | ws.pecmassiva.com |
 | `pdf` | HTML to PDF | pdf.openapi.it |
-| `postal-service` | Postal mail | ws.ufficiopostale.com |
-| `real-estate` | Real estate valuation | realestate.openapi.com |
+| `realestate` | Real estate valuation | realestate.openapi.com |
 | `risk` | Risk reports and scoring | risk.openapi.com |
 | `sdi` | SDI electronic invoicing | sdi.openapi.it |
-| `sms` | SMS messaging | sms.openapi.com |
-| `time-stamping` | Time stamping | ws.marchetemporali.com |
-| `token` | OAuth token management | oauth.openapi.it |
+| `smsv2` | SMS messaging | sms.openapi.com |
 | `trust` | Trust verification | trust.openapi.com |
+| `ufficiopostale` | Postal mail | ws.ufficiopostale.com |
 | `visengine` | Official documents | visengine2.altravia.com |
-| `zip-codes` | Zip codes and municipalities | cap.openapi.it |
+| `visurecamerali` | Chamber of Commerce | visurecamerali.openapi.it |
 
 ### Examples
 
 ```bash
 # All SMS scopes
-openapi token create --scopes "sms"
+openapi oauth create --scopes "smsv2"
 
 # Multiple services
-openapi token create --scopes "sms,company"
+openapi oauth create --scopes "smsv2,company"
 
 # All available scopes (special keyword)
-openapi token create --scopes "all"
+openapi oauth create --scopes "all"
 ```
 
 ### Method filtering
@@ -185,13 +192,13 @@ Prefix an alias with an HTTP method to include only scopes for that method:
 
 ```bash
 # Only POST scopes for SMS
-openapi token create --scopes "post:sms"
+openapi oauth create --scopes "post:smsv2"
 
 # Only GET scopes for company
-openapi token create --scopes "get:company"
+openapi oauth create --scopes "get:company"
 
 # Mix methods and full aliases
-openapi token create --scopes "post:sms,get:company,geocoding"
+openapi oauth create --scopes "post:smsv2,get:company,geocoding"
 ```
 
 Supported method prefixes: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`.
@@ -201,9 +208,9 @@ Supported method prefixes: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`.
 Aliases and method prefixes are case insensitive:
 
 ```bash
-openapi token create --scopes "SMS"
-openapi token create --scopes "Post:Sms"
-openapi token create --scopes "POST:SMS"
+openapi oauth create --scopes "SMSV2"
+openapi oauth create --scopes "Post:SmsV2"
+openapi oauth create --scopes "POST:SMSV2"
 ```
 
 All of the above are equivalent.
@@ -213,39 +220,40 @@ All of the above are equivalent.
 If a term does not match any alias, it is passed through as a literal scope:
 
 ```bash
-openapi token create --scopes "sms,GET:imprese.openapi.it/base"
+openapi oauth create --scopes "smsv2,GET:imprese.openapi.it/base"
 ```
 
 ## Available commands
 
 | Command | Description |
 |---|---|
 | `info` | Show configuration status and readiness |
-| `token` | OAuth token management |
+| `oauth` | OAuth token management |
 | `ai` | AI language models |
 | `automotive` | Automotive data (vehicles, insurance) |
-| `cadastre` | Italian cadastral data |
-| `certified-email` | Italian certified email (PEC / Legalmail) |
-| `chamber-of-commerce` | Chamber of Commerce documents |
+| `bollettini` | Bills payment |
+| `cap` | Zip codes, municipalities, provinces, regions |
+| `catasto` | Italian cadastral data |
 | `company` | Company data and information |
 | `docuengine` | Official documents (Business Register, Revenue Agency, INPS) |
 | `domains` | .it domain management |
 | `esignature` | Electronic signature |
-| `exchange-rate` | Foreign currency exchange rates |
+| `exchange` | Foreign currency exchange rates |
 | `geocoding` | Geocoding and reverse geocoding |
 | `invoice` | Electronic invoicing |
-| `massive-rem` | Massive Registered Electronic Mail |
-| `paying-bills` | Bills payment |
+| `marchetemporali` | Document time stamping |
+| `pec` | Italian certified email (PEC / Legalmail) |
+| `pecmassiva` | Massive Registered Electronic Mail |
 | `pdf` | HTML to PDF conversion |
-| `postal-service` | Postal mail service |
-| `real-estate` | Real estate valuation data |
+| `realestate` | Real estate valuation data |
 | `risk` | Risk reports and scoring |
 | `sdi` | SDI electronic invoicing |
-| `sms` | SMS messaging (v2) |
-| `time-stamping` | Document time stamping |
+| `smsv2` | SMS messaging (v2) |
+| `oauthv2` | OAuth v2 token management and analytics |
 | `trust` | Trust verification services |
+| `ufficiopostale` | Postal mail service |
 | `visengine` | Official documents (Chamber of Commerce, INPS, Tax Agency) |
-| `zip-codes` | Zip codes, municipalities, provinces, regions |
+| `visurecamerali` | Chamber of Commerce documents |
 
 Run `openapi --help` for the full list, or `openapi <command> --help` for subcommand details.