maybeai-sheet-cli 0.4.1__tar.gz → 0.5.0__tar.gz

{maybeai_sheet_cli-0.4.1 → maybeai_sheet_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maybeai-sheet-cli
-Version: 0.4.1
+Version: 0.5.0
 Summary: CLI for common MaybeAI spreadsheet operations
 Project-URL: Homepage, https://github.com/OmniMCP-AI/maybeai-sheet-cli
 Project-URL: Repository, https://github.com/OmniMCP-AI/maybeai-sheet-cli
@@ -90,8 +90,7 @@ Optional global flags:
 
 ## Quick Start
 
-The examples below follow the target protocol names. The currently shipped
-compatibility aliases are listed in the Implemented Command Tree.
+The examples below follow the target protocol names.
 
 List user-visible workbooks:
 
@@ -99,10 +98,11 @@ List user-visible workbooks:
 mbs workbook list-user-workbooks --limit 20
 ```
 
-Read a bounded range:
+Read a worksheet:
 
 ```bash
-mbs excel-worksheet range read --doc-id abc123 --worksheet-name Sheet1 --range A1:D20
+mbs excel-worksheet read --doc-id abc123 --worksheet-name Sheet1
+mbs excel-worksheet read --doc-id abc123 --worksheet-name Sheet1 --range A1:H1
 ```
 
 List worksheets:
@@ -176,131 +176,13 @@ CLI command names normalize these relationship labels to hyphenated groups:
 `excel_worksheet` becomes `excel-worksheet`, `excel_table` becomes
 `excel-table`, and `db_worksheet(db_table)` becomes `db-table`.
 
-## Implemented Command Tree
-
-This is the current shipped command surface. The full roadmap tree below is
-separate and includes planned or deferred commands.
-
-```text
-mbs
-├── update
-│   └── Update maybeai-sheet-cli from PyPI.
-│
-├── workbook
-│   ├── create             Create a new workbook.
-│   ├── create-from-file   Import an .xlsx file.
-│   ├── import             Preferred alias for create-from-file.
-│   ├── metadata           Inspect workbook profile and routing metadata.
-│   ├── list-user-workbooks
-│   │                      Preferred alias for bounded user workbook listing.
-│   ├── list-worksheets    List worksheets in a workbook.
-│   ├── list               List user workbooks with bounded output.
-│   ├── search             Search user workbooks with bounded output.
-│   ├── manifest           Compatibility alias for metadata.
-│   └── capabilities       Inspect workbook capability/profile metadata.
-│
-├── excel-worksheet
-│   ├── metadata           Inspect worksheet metadata through workbook profile.
-│   └── list-table         List worksheet/table metadata for a workbook.
-│
-├── excel-table
-│   ├── metadata           Resolve a worksheet-backed table from workbook metadata.
-│   ├── schema             Infer schema from a resolved worksheet-backed table range.
-│   ├── sample             Return bounded table sample rows.
-│   ├── read               Read a resolved worksheet-backed table range.
-│   └── insert             Insert row objects into a worksheet-backed table.
-│
-├── db-table
-│   ├── metadata           Resolve PG/SheetTable-backed worksheet metadata.
-│   ├── schema             Infer schema from a bounded PG read.
-│   ├── sample             Return bounded PG table sample rows.
-│   ├── read               Read PG-backed table rows through routed APIs.
-│   └── insert             Insert rows into a PG-backed table.
-│
-├── worksheet
-│   ├── list               List worksheets in a workbook.
-│   ├── create             Create a worksheet, optionally with starter values.
-│   ├── rename             Rename a worksheet.
-│   ├── delete             Delete a worksheet; requires --yes unless --dry-run.
-│   ├── copy               Copy a worksheet.
-│   └── move               Move a worksheet to a zero-based index.
-│
-├── range
-│   ├── read               Read a bounded A1 range.
-│   ├── write              Write a JSON matrix into an A1 range.
-│   ├── clear              Clear an A1 range.
-│   └── search             Search a worksheet with bounded results.
-│
-├── row
-│   ├── insert             Insert rows.
-│   ├── delete             Delete rows; requires --yes unless --dry-run.
-│   └── move               Move rows.
-│
-├── column
-│   ├── insert             Insert columns.
-│   ├── delete             Delete columns; requires --yes unless --dry-run.
-│   ├── move               Move columns.
-│   └── width              Set column width.
-│
-├── formula
-│   ├── read               Read formulas with FORMULA render mode.
-│   ├── set                Set one formula cell.
-│   ├── batch-set          Set formula ranges from a JSON operations file.
-│   ├── recalculate        Recalculate formulas for a worksheet/workbook.
-│   ├── calculate          Calculate one formula cell.
-│   └── lineage            Trace formula lineage for one cell.
-│
-├── style
-│   ├── freeze-panes       Freeze rows/columns using an A1 cell boundary.
-│   ├── auto-filter set    Set worksheet auto-filter range.
-│   ├── auto-filter remove Remove worksheet auto-filter.
-│   ├── columns-width      Set column widths.
-│   └── rows-height        Set row heights.
-│
-├── history
-│   ├── list               List workbook versions with bounded output.
-│   └── read               Read a workbook version.
-│
-├── file
-│   ├── export             Export workbook bytes to --out.
-│   ├── list               List files with bounded output.
-│   └── search             Search files with bounded output.
-│
-├── share
-│   ├── visibility         Set workbook visibility.
-│   ├── grant              Grant a user permission.
-│   ├── permission         Read current permission.
-│   ├── remove             Remove a user's access.
-│   └── list               List sharing entries.
-│
-├── raw
-│   └── post               Low-level POST escape hatch for routed API paths.
-│
-└── sheet                  Legacy compatibility aliases.
-    ├── read
-    ├── read-range
-    ├── read-many
-    ├── named-range
-    ├── headers
-    ├── worksheets
-    ├── formulas
-    ├── write-range
-    ├── clear-range
-    ├── append
-    ├── upsert
-    ├── formula-set
-    ├── formula-batch-set
-    ├── recalculate
-    └── create-worksheet
-```
 
 ## Full Command Tree
 
 The reviewed tree below is the source of truth for the protocol shape. Product
 model labels in this block use underscores; CLI names in examples and future
 router code should normalize them to hyphenated command groups such as
-`excel-worksheet`, `excel-table`, and `db-table`. The older `sheet ...`
-commands remain available as compatibility aliases. This tree includes
+`excel-worksheet`, `excel-table`, and `db-table`. This tree includes
 implemented, planned, deferred, and not-recommended command surfaces.
 
 Status legend for the full tree:
@@ -336,6 +218,7 @@ mbs
 │   └── rename                   API   Rename a stored file.
 │
 ├── excel_worksheet
+│   ├── read                     API   Read the full range of the worksheet.
 │   ├── list-table               API   List worksheets in a workbook.
 │   ├── create                   API   Create a worksheet, optionally with starter values.
 │   ├── update                   API   Update worksheet metadata.
@@ -434,24 +317,6 @@ mbs
 │   ├── create                   API   Create or grant sharing access.
 │   ├── remove                   API   Remove a user's access.
 │   ├── modify                   API   Modify sharing access.
-│
-│
-└── sheet                  Legacy compatibility aliases.
-    ├── read
-    ├── read-range
-    ├── read-many
-    ├── named-range
-    ├── headers
-    ├── worksheets
-    ├── formulas
-    ├── write-range
-    ├── clear-range
-    ├── append
-    ├── upsert
-    ├── formula-set
-    ├── formula-batch-set
-    ├── recalculate
-    └── create-worksheet
 ```
 
 Full tree examples:
@@ -474,13 +339,15 @@ mbs workbook copy --doc-id abc123 --name "Budget Copy"  # API
 mbs workbook delete --doc-id abc123 --dry-run  # API
 
 # excel-worksheet
+mbs excel-worksheet read --doc-id abc123 --worksheet-name Actuals  # API
+mbs excel-worksheet read --doc-id abc123 --worksheet-name Actuals --range A1:D20  # API
 mbs excel-worksheet create --doc-id abc123 --name Actuals  # API
 mbs excel-worksheet update --doc-id abc123 --worksheet-name Actuals --title "Actuals FY26"  # API
 mbs excel-worksheet metadata --doc-id abc123 --worksheet-name Actuals  # API
 mbs excel-worksheet sample --doc-id abc123 --worksheet-name Actuals --range A1:Z5000 --limit 50  # PLAN
 
 # excel-worksheet range
-mbs excel-worksheet range read --doc-id abc123 --worksheet-name Actuals --range A1:D20  # API
+mbs excel-worksheet range read --doc-id abc123 --worksheet-name Actuals --range A1:D20  # API, advanced structured alias
 mbs excel-worksheet range used-range --doc-id abc123 --worksheet-name Actuals  # PLAN
 mbs excel-worksheet range lineage --doc-id abc123 --worksheet-name Model --cell E2 --format tree  # API
 
@@ -535,9 +402,6 @@ mbs version restore --doc-id abc123 --version-id v42 --dry-run  # PLAN
 
 # share
 mbs share create --doc-id abc123 --email teammate@example.com --role viewer  # API
-
-# sheet
-mbs sheet read --doc-id abc123 --worksheet-name Sheet1 --range A1:D20
 ```
 
 Refactor planning is tracked separately from this README:
@@ -561,8 +425,8 @@ dependency graph beyond cell lineage             PLAN
 Relationship guide:
 
 - Use `workbook` for file-level creation, upload/import, and manifest checks.
-- Use `excel-worksheet` for Excel tab lifecycle operations and worksheet/range
-  inspection.
+- Use `excel-worksheet read` for full worksheet used-range inspection.
+- Use `excel-worksheet` for Excel tab lifecycle operations.
 - Use `excel-worksheet range` for coordinate-based reads, writes, formulas, and
   cell lineage.
 - Use `excel-table` for worksheet-backed table views. One Excel worksheet can
@@ -597,7 +461,7 @@ Targeting notes:
   from workbook metadata, for example `--table-id 1`, and maps internally to
   table metadata such as `worksheet_name` and `range`.
 - Use `--name` or backend ids when operating on a `db-table`.
-- Use `--gid` only for legacy gid-specific compatibility aliases.
+- Use `--gid` only when a route specifically requires gid targeting.
 
 ## Input Rules
 

{maybeai_sheet_cli-0.4.1 → maybeai_sheet_cli-0.5.0}/README.md

@@ -66,8 +66,7 @@ Optional global flags:
 
 ## Quick Start
 
-The examples below follow the target protocol names. The currently shipped
-compatibility aliases are listed in the Implemented Command Tree.
+The examples below follow the target protocol names.
 
 List user-visible workbooks:
 
@@ -75,10 +74,11 @@ List user-visible workbooks:
 mbs workbook list-user-workbooks --limit 20
 ```
 
-Read a bounded range:
+Read a worksheet:
 
 ```bash
-mbs excel-worksheet range read --doc-id abc123 --worksheet-name Sheet1 --range A1:D20
+mbs excel-worksheet read --doc-id abc123 --worksheet-name Sheet1
+mbs excel-worksheet read --doc-id abc123 --worksheet-name Sheet1 --range A1:H1
 ```
 
 List worksheets:
@@ -152,131 +152,13 @@ CLI command names normalize these relationship labels to hyphenated groups:
 `excel_worksheet` becomes `excel-worksheet`, `excel_table` becomes
 `excel-table`, and `db_worksheet(db_table)` becomes `db-table`.
 
-## Implemented Command Tree
-
-This is the current shipped command surface. The full roadmap tree below is
-separate and includes planned or deferred commands.
-
-```text
-mbs
-├── update
-│   └── Update maybeai-sheet-cli from PyPI.
-│
-├── workbook
-│   ├── create             Create a new workbook.
-│   ├── create-from-file   Import an .xlsx file.
-│   ├── import             Preferred alias for create-from-file.
-│   ├── metadata           Inspect workbook profile and routing metadata.
-│   ├── list-user-workbooks
-│   │                      Preferred alias for bounded user workbook listing.
-│   ├── list-worksheets    List worksheets in a workbook.
-│   ├── list               List user workbooks with bounded output.
-│   ├── search             Search user workbooks with bounded output.
-│   ├── manifest           Compatibility alias for metadata.
-│   └── capabilities       Inspect workbook capability/profile metadata.
-│
-├── excel-worksheet
-│   ├── metadata           Inspect worksheet metadata through workbook profile.
-│   └── list-table         List worksheet/table metadata for a workbook.
-│
-├── excel-table
-│   ├── metadata           Resolve a worksheet-backed table from workbook metadata.
-│   ├── schema             Infer schema from a resolved worksheet-backed table range.
-│   ├── sample             Return bounded table sample rows.
-│   ├── read               Read a resolved worksheet-backed table range.
-│   └── insert             Insert row objects into a worksheet-backed table.
-│
-├── db-table
-│   ├── metadata           Resolve PG/SheetTable-backed worksheet metadata.
-│   ├── schema             Infer schema from a bounded PG read.
-│   ├── sample             Return bounded PG table sample rows.
-│   ├── read               Read PG-backed table rows through routed APIs.
-│   └── insert             Insert rows into a PG-backed table.
-│
-├── worksheet
-│   ├── list               List worksheets in a workbook.
-│   ├── create             Create a worksheet, optionally with starter values.
-│   ├── rename             Rename a worksheet.
-│   ├── delete             Delete a worksheet; requires --yes unless --dry-run.
-│   ├── copy               Copy a worksheet.
-│   └── move               Move a worksheet to a zero-based index.
-│
-├── range
-│   ├── read               Read a bounded A1 range.
-│   ├── write              Write a JSON matrix into an A1 range.
-│   ├── clear              Clear an A1 range.
-│   └── search             Search a worksheet with bounded results.
-│
-├── row
-│   ├── insert             Insert rows.
-│   ├── delete             Delete rows; requires --yes unless --dry-run.
-│   └── move               Move rows.
-│
-├── column
-│   ├── insert             Insert columns.
-│   ├── delete             Delete columns; requires --yes unless --dry-run.
-│   ├── move               Move columns.
-│   └── width              Set column width.
-│
-├── formula
-│   ├── read               Read formulas with FORMULA render mode.
-│   ├── set                Set one formula cell.
-│   ├── batch-set          Set formula ranges from a JSON operations file.
-│   ├── recalculate        Recalculate formulas for a worksheet/workbook.
-│   ├── calculate          Calculate one formula cell.
-│   └── lineage            Trace formula lineage for one cell.
-│
-├── style
-│   ├── freeze-panes       Freeze rows/columns using an A1 cell boundary.
-│   ├── auto-filter set    Set worksheet auto-filter range.
-│   ├── auto-filter remove Remove worksheet auto-filter.
-│   ├── columns-width      Set column widths.
-│   └── rows-height        Set row heights.
-│
-├── history
-│   ├── list               List workbook versions with bounded output.
-│   └── read               Read a workbook version.
-│
-├── file
-│   ├── export             Export workbook bytes to --out.
-│   ├── list               List files with bounded output.
-│   └── search             Search files with bounded output.
-│
-├── share
-│   ├── visibility         Set workbook visibility.
-│   ├── grant              Grant a user permission.
-│   ├── permission         Read current permission.
-│   ├── remove             Remove a user's access.
-│   └── list               List sharing entries.
-│
-├── raw
-│   └── post               Low-level POST escape hatch for routed API paths.
-│
-└── sheet                  Legacy compatibility aliases.
-    ├── read
-    ├── read-range
-    ├── read-many
-    ├── named-range
-    ├── headers
-    ├── worksheets
-    ├── formulas
-    ├── write-range
-    ├── clear-range
-    ├── append
-    ├── upsert
-    ├── formula-set
-    ├── formula-batch-set
-    ├── recalculate
-    └── create-worksheet
-```
 
 ## Full Command Tree
 
 The reviewed tree below is the source of truth for the protocol shape. Product
 model labels in this block use underscores; CLI names in examples and future
 router code should normalize them to hyphenated command groups such as
-`excel-worksheet`, `excel-table`, and `db-table`. The older `sheet ...`
-commands remain available as compatibility aliases. This tree includes
+`excel-worksheet`, `excel-table`, and `db-table`. This tree includes
 implemented, planned, deferred, and not-recommended command surfaces.
 
 Status legend for the full tree:
@@ -312,6 +194,7 @@ mbs
 │   └── rename                   API   Rename a stored file.
 │
 ├── excel_worksheet
+│   ├── read                     API   Read the full range of the worksheet.
 │   ├── list-table               API   List worksheets in a workbook.
 │   ├── create                   API   Create a worksheet, optionally with starter values.
 │   ├── update                   API   Update worksheet metadata.
@@ -410,24 +293,6 @@ mbs
 │   ├── create                   API   Create or grant sharing access.
 │   ├── remove                   API   Remove a user's access.
 │   ├── modify                   API   Modify sharing access.
-│
-│
-└── sheet                  Legacy compatibility aliases.
-    ├── read
-    ├── read-range
-    ├── read-many
-    ├── named-range
-    ├── headers
-    ├── worksheets
-    ├── formulas
-    ├── write-range
-    ├── clear-range
-    ├── append
-    ├── upsert
-    ├── formula-set
-    ├── formula-batch-set
-    ├── recalculate
-    └── create-worksheet
 ```
 
 Full tree examples:
@@ -450,13 +315,15 @@ mbs workbook copy --doc-id abc123 --name "Budget Copy"  # API
 mbs workbook delete --doc-id abc123 --dry-run  # API
 
 # excel-worksheet
+mbs excel-worksheet read --doc-id abc123 --worksheet-name Actuals  # API
+mbs excel-worksheet read --doc-id abc123 --worksheet-name Actuals --range A1:D20  # API
 mbs excel-worksheet create --doc-id abc123 --name Actuals  # API
 mbs excel-worksheet update --doc-id abc123 --worksheet-name Actuals --title "Actuals FY26"  # API
 mbs excel-worksheet metadata --doc-id abc123 --worksheet-name Actuals  # API
 mbs excel-worksheet sample --doc-id abc123 --worksheet-name Actuals --range A1:Z5000 --limit 50  # PLAN
 
 # excel-worksheet range
-mbs excel-worksheet range read --doc-id abc123 --worksheet-name Actuals --range A1:D20  # API
+mbs excel-worksheet range read --doc-id abc123 --worksheet-name Actuals --range A1:D20  # API, advanced structured alias
 mbs excel-worksheet range used-range --doc-id abc123 --worksheet-name Actuals  # PLAN
 mbs excel-worksheet range lineage --doc-id abc123 --worksheet-name Model --cell E2 --format tree  # API
 
@@ -511,9 +378,6 @@ mbs version restore --doc-id abc123 --version-id v42 --dry-run  # PLAN
 
 # share
 mbs share create --doc-id abc123 --email teammate@example.com --role viewer  # API
-
-# sheet
-mbs sheet read --doc-id abc123 --worksheet-name Sheet1 --range A1:D20
 ```
 
 Refactor planning is tracked separately from this README:
@@ -537,8 +401,8 @@ dependency graph beyond cell lineage             PLAN
 Relationship guide:
 
 - Use `workbook` for file-level creation, upload/import, and manifest checks.
-- Use `excel-worksheet` for Excel tab lifecycle operations and worksheet/range
-  inspection.
+- Use `excel-worksheet read` for full worksheet used-range inspection.
+- Use `excel-worksheet` for Excel tab lifecycle operations.
 - Use `excel-worksheet range` for coordinate-based reads, writes, formulas, and
   cell lineage.
 - Use `excel-table` for worksheet-backed table views. One Excel worksheet can
@@ -573,7 +437,7 @@ Targeting notes:
   from workbook metadata, for example `--table-id 1`, and maps internally to
   table metadata such as `worksheet_name` and `range`.
 - Use `--name` or backend ids when operating on a `db-table`.
-- Use `--gid` only for legacy gid-specific compatibility aliases.
+- Use `--gid` only when a route specifically requires gid targeting.
 
 ## Input Rules
 

{maybeai_sheet_cli-0.4.1 → maybeai_sheet_cli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "maybeai-sheet-cli"
-version = "0.4.1"
+version = "0.5.0"
 description = "CLI for common MaybeAI spreadsheet operations"
 readme = "README.md"
 requires-python = ">=3.10"

{maybeai_sheet_cli-0.4.1 → maybeai_sheet_cli-0.5.0}/src/maybeai_sheet/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.4.1"
+__version__ = "0.5.0"

{maybeai_sheet_cli-0.4.1 → maybeai_sheet_cli-0.5.0}/src/maybeai_sheet/cli.py

@@ -20,7 +20,6 @@ from .commands.share import app as share_app
 from .commands.sheet import app as sheet_app
 from .commands.style import app as style_app
 from .commands.workbook import app as workbook_app
-from .commands.worksheet import app as worksheet_app
 from .config import CLIContext
 from .formatters import handle_cli_error
 from .update import run_update
@@ -149,9 +148,9 @@ def update_cli(
 
 app.add_typer(workbook_app, name="workbook")
 app.add_typer(excel_worksheet_app, name="excel-worksheet")
+app.add_typer(excel_worksheet_app, name="excel_worksheet", hidden=True)
 app.add_typer(excel_table_app, name="excel-table")
 app.add_typer(db_table_app, name="db-table")
-app.add_typer(worksheet_app, name="worksheet")
 app.add_typer(range_app, name="range")
 app.add_typer(row_app, name="row")
 app.add_typer(column_app, name="column")